查询快递运单轨迹
# 接口地址
POST https://api.track123.com/gateway/open-api/tk/v2/track/query
# 接口描述
一次最多可以查询100个运单轨迹信息。响应的结果包含accepted和rejected两个列表,如果有未注册的跟踪号或者订单号,将在rejected列表中返回。
# 请求参数
参数名称 | 参数说明 | 必须 | 数据类型 |
---|---|---|---|
trackNos | 查询的物流单号列表 | false | array |
orderNos | 查询的订单号列表 | false | array |
createTimeStart | 导入物流单号的开始时间 | false | string(date-time) |
createTimeEnd | 导入物流单号的结束时间,这里需要注意: createTimeStart <=查询的时间段 <createTimeEnd | false | string(date-time) |
cursor | 分页查询请求,游标,通过上一页查询结果取得,留空则查询第一页的结果 | false | string |
queryPageSize | 分页查询请求,一页查询条数,默认100,一次最多查询100个 | false | integer(int32) |
# 请求示例
{
"trackNos": [
"304071414818",
"620372231752"
],
"orderNos": [ "" ],
"createTimeStart": "2021-08-01 00:00:00",
"createTimeEnd": "2021-09-28 00:00:00",
"cursor": "",
"queryPageSize": 100
}
# 响应参数
参数名称 | 参数说明 | 类型 |
---|---|---|
code | 业务状态码 | string |
data | 实际返回对象 | object |
accepted | 查询成功的单号 | object |
content | 分页数据列表 | array |
id | 主键 | string |
trackNo | 物流单号 | string |
createTime | 导入时间 | string |
nextUpdateTime | 下次更新时间,如果为null则表示不会再更新了 | string |
orderNo | 包裹的订单号,由商家/平台所产生的订单编号 | string |
customerEmail | 客户邮箱,由商家/平台填写的,订单关联的客户邮箱 | string |
shipFrom | 发件地 简码 | string |
shipTo | 目的地 简码 | string |
trackingStatus | 查询状态 简码 | string |
transitStatus | 运输状态 | string |
transitSubStatus | 运输子状态 | string |
shipTime | 发货时间 | string |
orderTime | 下单时间、第一条轨迹的时间 | string |
receiptTime | 上网时间、首次扫描时间、揽收时间 | string |
deliveredTime | 投递时间、妥投时间 | string |
lastTrackingTime | 最近一条轨迹的时间 | string |
deliveredDays | 投递时效(自然日): 上网时间和投递时间差 | integer |
receiptDays | 上网时效(天): 发货时间和上网时间差 | integer |
transitDays | 运输时效:上网时间和当前时间差,终态不再更新 | integer |
stayDays | 停留时长 = 当前时间 - 最新一条轨迹的更新时间 | integer |
remark | 备注 | string |
destinationLogisticsInfo | 目的地物流信息 | object |
courierCode | 物流商对应的唯一简码 | string |
courierNameCN | 物流商中文名称 | string |
courierNameEN | 物流商英文名称 | string |
courierHomePage | 物流商官网的链接 | string |
trackingDetails | 轨迹明细列表,按照时间倒序排列 | array |
address | 轨迹发生的地址 | string |
eventTime | 轨迹发生的时间 | string |
eventTimeZeroUTC | 当前事件的UTC时间 | string |
timezone | 时区 | string |
eventDetail | 轨迹详情 | string |
lastMileInfo | 尾程物流详情 | LastMileInfo |
lmTrackNo | 尾程物流单号 | String |
openApiWayBillInfo | 尾程轨迹详情 | object |
transitSubStatus | 运输子状态 | string |
localLogisticsInfo | 本地承运物流信息 | object |
courierCode | 物流商对应的唯一简码 | string |
courierNameCN | 物流商中文名称 | string |
courierNameEN | 物流商英文名称 | string |
courierHomePage | 物流商官网的链接 | string |
cursor | 分页游标,查询下一页数据时需要携带上一页的游标 | string |
totalElements | 总数量 | integer |
totalPages | 总页数 | integer |
currentPage | 当前页数 | integer |
rejected | 查询失败的单号 | array |
courierCode | 快递商简码 | string |
expectedDelivery | 快递预计到达时间 | Date |
shipmentType | 运单服务等级号 | string |
error | 失败原因 | object |
code | 错误码 | string |
msg | 错误原因 | string |
trackNo | 快递单号 | string |
msg | 业务状态码对应的描述信息或者其他辅助的描述信息 | string |
# 响应示例
{
"code": "00000",
"data": {
"accepted": {
"content": [
{
"trackNo": "9261290289104300655419",
"createTime": "2022-08-02 20:20:36",
"nextUpdateTime": "2022-08-05 20:20:45",
"orderNo": "",
"customerEmail": "",
"shipFrom": "US",
"shipTo": "US",
"trackingStatus": "001",
"transitStatus": "EXPIRED",
"transitSubStatus": null,
"shipTime": "2022-06-14 18:10:10",
"orderTime": "2022-05-31 14:46:06",
"receiptTime": "2022-06-01 11:17:36",
"deliveredTime": null,
"lastTrackingTime": "2022-06-01 19:50:20",
"receiptDays": 14,
"deliveredDays": null,
"remark": "test-bytedance",
"localLogisticsInfo": {
"courierCode": "parcll",
"courierNameCN": "PARCLL",
"courierNameEN": "PARCLL",
"courierHomePage": "https://www.parcll.com/",
"trackingDetails": [
{
"address": "New York",
"eventTime": "2022-06-01 19:50:20",
"eventTimeZeroUTC": "2022-06-01T11:50:20Z",
"timezone": "+08:00",
"eventDetail": "Departed Facility In processing center",
"transitSubStatus": "IN_TRANSIT_01"
},
{
"address": "",
"eventTime": "2022-06-01 11:47:00",
"eventTimeZeroUTC": "2022-06-01T03:47:00Z",
"timezone": "+08:00",
"eventDetail": "picked up by shipping partner, usps awaiting item",
"transitSubStatus": "INFO_RECEIVED_01"
},
{
"address": "New York",
"eventTime": "2022-06-01 11:17:40",
"eventTimeZeroUTC": "2022-06-01T03:17:40Z",
"timezone": "+08:00",
"eventDetail": "Departed Facility in New York ",
"transitSubStatus": "IN_TRANSIT_01"
},
{
"address": "New York",
"eventTime": "2022-06-01 11:17:36",
"eventTimeZeroUTC": "2022-06-01T03:17:36Z",
"timezone": "+08:00",
"eventDetail": "Arrived at Sort Facility New York ",
"transitSubStatus": "IN_TRANSIT_01"
},
{
"address": "",
"eventTime": "2022-05-31 14:46:06",
"eventTimeZeroUTC": "2022-05-31T06:46:06Z",
"timezone": "+08:00",
"eventDetail": "Shipment information received",
"transitSubStatus": "INFO_RECEIVED_01"
}
]
},
"expectedDelivery": null,
"shipmentType": "",
"lastMileInfo": {
"lmTrackNo": "9261290289104300655419",
"openApiWayBillInfo": {
"courierCode": "usps",
"courierNameCN": "美国邮政",
"courierNameEN": "USPS",
"courierHomePage": "https://www.usps.com/",
"trackingDetails": [
{
"address": "",
"eventTime": "2022-06-01 11:47:00",
"eventTimeZeroUTC": "2022-06-01T17:47:00Z",
"timezone": "-06:00",
"eventDetail": "Picked Up by Shipping Partner, USPS Awaiting Item -> Your item was picked up by a shipping partner at 11:47 am on June 1, 2022. This does not indicate receipt by the USPS or the actual mailing date.",
"transitSubStatus": "INFO_RECEIVED_01"
}
]
}
}
}
],
"totalElements": "1",
"totalPages": "1",
"currentPage": "1",
"cursor": "1659442836095,342401319572631552,2"
},
"rejected": []
},
"msg": "成功"
}