服务查询
查询可使用的服务
Method POST /shipment/tracking
Query 参数
Body 参数
| 参数 | 说明 | 类型 | 必填 | 默认值 |
|---|---|---|---|---|
| orderNumbers | 订单号组成的数组 | Array |
是 |
Request Example
POST /shipment/tracking
Request Body
{
"orderNumbers": ["U0210208929542"]
}
Response
| 参数 | 说明 | 类型 | 固定参数 |
|---|---|---|---|
| orderNumber | 订单号 | String | 是 |
| waybillNumber | 货运商物流单号 | String | 是 |
| trackingUrl | 货运商查询地址 | String | 是 |
| syncedAt | 最后同步时间 Timestamp | Integer | 是 |
| status | 运单状态 | Integer | 否 |
| carrier | 货运商 | Object | 是 |
| code | 货运商代码 | String | 是 |
| name | 货运商名称 | String | 是 |
| events | 物流事件 | Array | 是 |
| events/context | 内容 | String | 是 |
| events/locaTime | 事件本地时间 | String | 是 |
| event/areaName | 位置 | String | 否 |
| event/areaCode | 位置 | String | 否 |
| event/status | 状态 | Integer | 否 |
运单状态说明
| 状态值 | 名称 | 含义 |
|---|---|---|
| 0 | 在途 | 快件处于运输过程中 |
| 1 | 揽收 | 快件已由快递公司揽收 |
| 2 | 疑难 | 系统无法解析的状态,或者是需要人工介入的状态, 比方说收件人电话错误. |
| 3 | 签收 | 正常签收 |
| 4 | 退签 | 货物退回发货人并签收 |
| 5 | 派件 | 货物正在进行派件 |
| 6 | 退回 | 货物正处于返回发货人的途中 |
| 7 | 转投 | 货物转给其他快递公司邮寄 |
| 10 | 待清关 | 货物等待清关 |
| 11 | 清关中 | 货物正在清关流程中 |
| 12 | 已清关 | 货物已完成清关流程 |
| 13 | 清关异常 | 货物在清关过程中出现异常 |
| 14 | 拒签 | 收件人明确拒收 |
| -1 | 取消 | 运单取消 |
Reponse Example
{
"sucess": true,
"elapsed": "796ms",
"query": {
"id": "7f16f1b0-61bf-11eb-ae75-75abac9d9f41",
"timestamp": "1612826639",
"signature": "bW3wPd7AM5FmGZ/FmW7MjqzFHszTT3+s7uK4APgNLZk=",
"api": "/shipment/tracking"
},
"result": [
{
"orderNumber": "U0210208929542",
"waybillNumber":"1Z9W403F2007517217",
"trackingUrl": null,
"syncedAt": null,
"status":1,
"events": [
{
"context": "Order created",
"localTime": "2021-02-16 13:11:12",
"areaName": "Canada",
"areaCode": "CA"
}
]
}
]
}