Appearance
查询轨迹 Track
接口说明
通过此接口可查询系统运单的轨迹信息。
接口地址: http://tms.gateway.sc-express.cn/api/track
请求方式： POST
请求参数
| 字段名称 | 字段类型 | 字段长度 | 是否必需 | 字段说明 | ||
|---|---|---|---|---|---|---|
| authorization | JSONObject | 接口校验信息 | ||||
| code | String | 5-20 | Y | 客户编码 | ||
| token | String | 50 | Y | API授权码 | ||
| datas | JSONObject | |||||
| waybillnumber | JSONArray | Y | 运单号 或 转单号，与系统单号二选一提交即可 示例值: [ "1Z64104F6795715591", "1Z5VT6220478322140" ] | |||
| systemnumber | JSONArray | Y | 运单号 或 转单号，与系统单号二选一提交即可 示例值: [ "1Z64104F6795715591", "1Z5VT6220478322140" ] | |||
请求报文示例
json
{
"authorization": {
"code": "KJHB",
"token": "c60bf762-01f7-470e-8c8f-acde06c81fed"
},
"datas": {
"waybillnumber": [
"EV00000001790CN",
"5722916732",
]
}
}{
"authorization": {
"code": "KJHB",
"token": "c60bf762-01f7-470e-8c8f-acde06c81fed"
},
"datas": {
"waybillnumber": [
"EV00000001790CN",
"5722916732",
]
}
}响应数据
| 字段名称 | 字段说明 | ||
|---|---|---|---|
| code | 接口请求是否通过 0：表示接口请求通过，其他表示失败 | ||
| msg | 说明信息 | ||
| data | |||
| searchNumber | 查件单号 | ||
| errormsg | 单号错误信息 | ||
| systemnumber | 系统单号 | ||
| waybillnumber | 运单号 | ||
| tracknumber | 转单号 | ||
| orderstatus | 运单状态编码 | ||
| orderstatusName | 运单状态名称 | ||
| trackItems | 主单号轨迹 - JSONArray | ||
| trackdate | 轨迹时间 | ||
| trackdate_utc8 | 轨迹时间（东八区时间 UTC8） | ||
| location | 所在地 | ||
| info | 轨迹说明 | ||
| subOrderList | 子单号数组，仅展示有子单轨迹的子单号 | ||
| subOrderTrackItems | 子单号轨迹 JSONObject对象，key为对应的子单号 | ||
| trackdate | 子单号轨迹时间 | ||
| trackdate_utc8 | 单号轨迹时间（东八区时间 UTC8） | ||
| location | 子单号所在地 | ||
| info | 子单号轨迹说明 | ||
响应数据示例
json
{
"msg": "success",
"code": 0,
"data": [
{
"searchNumber": "EV00000001790CN",
"systemnumber": "SYS211214000024",
"waybillnumber": "EV00000001790CN",
"tracknumber": "1ZXA67480392556190",
"orderstatus": "Sign",
"orderstatusName": "已签收",
"trackItems": [
{
"location": "OXNARD, CA, US",
"trackdate_utc8": "2021-11-16 15:40:00",
"trackdate": "2021-11-16 15:40:00",
"info": "已递送 "
},
{
"location": "Ventura, CA, United States",
"trackdate_utc8": "2021-11-16 02:34:00",
"trackdate": "2021-11-16 02:34:00",
"info": "抵达设施"
},
{
"location": "Ontario, CA, United States",
"trackdate_utc8": "2021-11-15 23:24:00",
"trackdate": "2021-11-15 23:24:00",
"info": "离开设施"
},
{
"location": "Ontario, CA, United States",
"trackdate_utc8": "2021-11-15 14:55:00",
"trackdate": "2021-11-15 14:55:00",
"info": "起运地扫描"
},
{
"location": "United States",
"trackdate_utc8": "2021-10-23 06:54:00",
"trackdate": "2021-10-23 06:54:00",
"info": "发件人已创建标签，但是 UPS 尚未收到包裹。 "
}
],
"subOrderList": [
"1ZXA67480392003410",
"1ZXA67480390054468",
// 存在轨迹的子单号
],
"subOrderTrackItems": {
"1ZXA67480392003410": [
{
"location": "OXNARD, CA, US",
"trackdate_utc8": "2021-11-16 15:40:00",
"trackdate": "2021-11-16 15:40:00",
"info": "已递送 "
}
],
"1ZXA67480390054468": [
{
"location": "OXNARD, CA, US",
"trackdate_utc8": "2021-11-16 15:40:00",
"trackdate": "2021-11-16 15:40:00",
"info": "已递送 "
},
{
"location": "United States",
"trackdate_utc8": "2021-10-23 06:54:00",
"trackdate": "2021-10-23 06:54:00",
"info": "发件人已创建标签，但是 UPS 尚未收到包裹。 "
}
],
// 存在轨迹的子单及其轨迹信息
}
},
{
"waybillnumber": "5722916732",
"searchNumber": "5722916732",
"errormsg": "无效的单号"
}
]
}{
"msg": "success",
"code": 0,
"data": [
{
"searchNumber": "EV00000001790CN",
"systemnumber": "SYS211214000024",
"waybillnumber": "EV00000001790CN",
"tracknumber": "1ZXA67480392556190",
"orderstatus": "Sign",
"orderstatusName": "已签收",
"trackItems": [
{
"location": "OXNARD, CA, US",
"trackdate_utc8": "2021-11-16 15:40:00",
"trackdate": "2021-11-16 15:40:00",
"info": "已递送 "
},
{
"location": "Ventura, CA, United States",
"trackdate_utc8": "2021-11-16 02:34:00",
"trackdate": "2021-11-16 02:34:00",
"info": "抵达设施"
},
{
"location": "Ontario, CA, United States",
"trackdate_utc8": "2021-11-15 23:24:00",
"trackdate": "2021-11-15 23:24:00",
"info": "离开设施"
},
{
"location": "Ontario, CA, United States",
"trackdate_utc8": "2021-11-15 14:55:00",
"trackdate": "2021-11-15 14:55:00",
"info": "起运地扫描"
},
{
"location": "United States",
"trackdate_utc8": "2021-10-23 06:54:00",
"trackdate": "2021-10-23 06:54:00",
"info": "发件人已创建标签，但是 UPS 尚未收到包裹。 "
}
],
"subOrderList": [
"1ZXA67480392003410",
"1ZXA67480390054468",
// 存在轨迹的子单号
],
"subOrderTrackItems": {
"1ZXA67480392003410": [
{
"location": "OXNARD, CA, US",
"trackdate_utc8": "2021-11-16 15:40:00",
"trackdate": "2021-11-16 15:40:00",
"info": "已递送 "
}
],
"1ZXA67480390054468": [
{
"location": "OXNARD, CA, US",
"trackdate_utc8": "2021-11-16 15:40:00",
"trackdate": "2021-11-16 15:40:00",
"info": "已递送 "
},
{
"location": "United States",
"trackdate_utc8": "2021-10-23 06:54:00",
"trackdate": "2021-10-23 06:54:00",
"info": "发件人已创建标签，但是 UPS 尚未收到包裹。 "
}
],
// 存在轨迹的子单及其轨迹信息
}
},
{
"waybillnumber": "5722916732",
"searchNumber": "5722916732",
"errormsg": "无效的单号"
}
]
}