推送订单运单的物流轨迹
场景说明
推送包裹的物流轨迹信息接口协议,外部api接口必须2秒以内响应返回, 且需要根据物流单号、时间做幂等。 由于运单号物流轨迹更新时,会将此运单所有的轨迹信息再次推送.
请求方式
POST
请求参数
参数名 | 二级参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|---|
shipmentTracks | - | 是 | array | 运单物流轨迹信息 |
-shipmentTracks.orderCode | - | 是 | string | 订单号 |
-shipmentTracks.trackNum | - | 是 | string | 物流单号 |
-shipmentTracks.delivered | - | 是 | boolean | 是否成功送达 |
-shipmentTracks.trackInfos | - | 是 | array | 轨迹信息 |
-shipmentTracks.trackInfos | country | 是 | string | 国家 |
-shipmentTracks.trackInfos | province | 是 | string | 州 |
-shipmentTracks.trackInfos | city | 是 | string | 城市 |
-shipmentTracks.trackInfos | eventTime | 是 | string | 时间 |
-shipmentTracks.trackInfos | station | 是 | string | 状态描述 |
输入示例(body)
[{
"orderCode": "string",
"trackNum": "string",
"delivered": "false",
"trackInfos": [
{
"country": "US",
"province": "TX",
"city": "HOUSTON",
"eventTime": "2025-05-12 22:01:00",
"station": "Shipping Label Created, USPS Awaiting Item"
}
]
}]