淘宝开放平台

登录
文档中心 > API类目 > 千帆计划

千帆计划

qimen.alibaba.logistic.tracking.nodes.query (查询物流轨迹)

查询物流轨迹

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
request TrackingNodeRequest 必须 请求参数
  • └ mailNos
  • String []
  • 必须
  • VL55367325735
  • 物流单号数组 ["4352453","25745335"] 限长20
  • └ traceId
  • String
  • 必须
  • 46366325563244
  • 平台日志id 用于平台排查问题
  • └ providerUserCode
  • String
  • 可选
  • 5463734536345
  • 在非集运场景时候使用，物流服务商的用户编码

响应参数

名称 类型 示例值 描述
data TrackingNodeQueryResponse [] 响应
  • └ platformOrderId
  • String
  • 235232524
  • 平台物流单id
  • nodes
  • TrackingNodeDTO []
  • 物流轨迹节点列表
  • └ nodeCnDesc
  • String
  • 出库成功
  • 节点描述（中文），见nodeCode字段说明 请回传真实文案，可不按照nodeCode枚举，特别是异常的节点，需要详细描述文案
  • └ nodeEnDesc
  • String
  • Delivery succeeded
  • 节点描述（英文），见nodeCode字段说明 请回传真实文案，可不按照nodeCode枚举，特别是异常的节点，需要详细描述文案
  • └ nodeCode
  • Number
  • 500
  • 物流轨迹节点 揽收成功410, 入库成功420, 开始拣货470, 拣货完成475, 出库异常-500, 出库成功500, 退件(国内物流商退，包含库内退件和报关/航空安检退件)-600, 开始清关(境内)610, 清关异常(境内)-611, 清关完成(境内)611, 航班起飞620, 航班落地621, 开始清关(境外)677, 清关异常(境外)-678, 清关完成(境外)678, 货交末端派送商750, 派送中800, 签收异常-850, 签收成功850 请按上面节点回传，可以跳过节点，如果不回传节点mail_node，会把该轨迹node_desc挂在上一个节点mail_node下面作为子文案
  • └ occurTime
  • Number
  • 1642736836269
  • 节点发生的时间戳 ms
  • └ mailNo
  • String
  • VL2472864224
  • 物流单号
success Boolean true 成功失败 true/false
failCode String - 错误码
failMessage String - 错误信息

请求示例

{"request":{"traceId":"46366325563244","providerUserCode":"5463734536345","mailNos":["VL55367325735"],"openUserId":"24352324"}}

响应示例

{
    "data":[
        {
                "platformOrderId":"235232524",
                "nodes":[
                    {
                            "nodeCnDesc":"出库成功",
                            "nodeEnDesc":"Delivery succeeded",
                            "nodeCode":500,
                            "occurTime":1642736836269
                    }
                ],
                "mailNo":"VL2472864224"
        }
    ],
    "success":true,
    "failCode":"-",
    "failMessage":"-"
}

验签示例

{"success":"false","failCode":"sign-check-failure","failMessage":"Illegal request"}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部