查询轨迹(库内+派送)
更新时间: 2025-01-02 11:20:47 访问次数:15956
接口说明
卖家或第三方通过该接口可查询海外仓订单轨迹。
若使用的带签收的服务,则可以通过该接口获取POD文件。
暂只提供三个月内订单的POD,每次获取POD的链接有效时长为30分钟,请及时存储
使用场景
当订单开始作业,调用此接口可获取到订单库内操作信息;当订单开始派送,可获取订单派送轨迹信息
当订单派送完成,调用此接口可获取到POD文件
接口名称
tracking.getOrderVerdorTracking
请求说明
| 请求内容 | 说明 |
|---|---|
| URL | https://openapi.winit.com.cn/openapi/service |
| 接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
| 验证方法 | Token,md5 |
| 格式 | json |
| 字符编码 | UTF-8 |
| http请求方式 | http |
| 请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| trackingnos | String() | Y | 跟踪号 支持winit订单号和跟踪号查询, 支持一次查询多个跟踪号,多个跟踪号用半角逗号分隔,最多不超过30个 |
05000196055,05000196086 |
| language | String() | N | 支持三种语言: zh_CN:简体中文 zh_TW:繁体中文 en_US:英文 目前仅支持Winit物流库内轨迹的多语言 物流商返回的轨迹为原始轨迹,暂不支持多语言 |
zh_CN |
请求示例
{"action": "tracking.getOrderVerdorTracking","app_key": "rebecca","client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2","data": {"trackingnos": "WO0000000037"},"format": "json","language": "zh_CN","platform": "OWNERERP","sign": "511AF2B9995E08EC53D9F0558F56B1B8","client_sign":"AC9B73944FC7350A77788D7FE4872135","sign_method": "md5","timestamp": "2016-07-10 23:04:52","version": "1.0"}
返回出参
返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。
| 名称 | 类型 | 必传 | 说明 | 示例 |
|---|---|---|---|---|
| orderNo | String(32) | Y | 订单号 | |
| trackingNo | String(50) | Y | 追踪号 | |
| origin | String(32) | Y | 起始地 | |
| destination | String(32) | Y | 目的地 | |
| carrier | String(64) | Y | 承运人 | |
| pickupMode | String(20) | Y | 揽收方式 | |
| status | String(16) | Y | 订单状态 | |
| trace | Array | Y | 轨迹list | |
| – type | String(10) | Y | 轨迹类型 S:表示库内轨迹 V:表示供应商轨迹 |
|
| – date | String(20) | Y | 日期 注意:库内轨迹为海外当地时间,供应商轨迹为供应商返回时区对应的时间(不同供应商提供时区可能不一致,建议使用时间戳) |
|
| – dateTimestamp | String() | Y | 毫秒级时间戳 | |
| – eventCode | String(10) | N | 轨迹编码 当为库内轨迹S时,请参考出库单状态列表 当为供应商轨迹V时,返回为供应商原始编码 |
|
| – eventDescription | String(100) | Y | 轨迹描述 | |
| – eventStatus | String(100) | N | 轨迹状态 | |
| – location | String(100) | N | 地点 | |
| – lastEvent | String(1) | N | 已停用,最后轨迹(Y/N) Y表示当前订单后续不再有轨迹更新 |
|
| – trackingType | String(100) | N | 轨迹scan类型 Ascan:上网信息 ATTscan:第一次尝试派送 Dscan:妥投派送完成 RDscan:派送失败妥投 Rscan:派送失败 |
|
| podInfoList | Array | N | POD列表 | |
| – podUrl | String(512) | N | POD文件下载链接(有效期30分钟) | |
| – formatType | String(10) | N | POD文件格式 pdf\png\jpg\jpeg |
|
| podInfo | Object | N | 已停用,POD信息 | |
| – podUrl | String(512) | N | 已停用,POD文件下载链接(有效期30分钟) | |
| – formatType | String(10) | N | 已停用,POD文件格式 pdf\png\jpg\jpeg |
已停用字段:
vendorName、occurTime、logisticsStatus、logisticsMess、airLines、flight、expressCompany、carrier、carrierCode、standardCarrier、trackingUrl、isTracked
返回示例
{"code": "0","msg": "操作成功","data": [ {"masterOrderNo": "WO0000000037","orderNo": "WO0000000037A","trackingNo": "Z68223Y0323227683","origin": "US","destination": "United States","pickupMode": null,"status": "派送中","vendorName": null,"trace": [{"type": "S","date": "2019-05-06 18:23:50","dateTimestamp": 1557138230000,"timeZone": null,"location": "USWC Warehouse","countryCode": null,"stateCode": null,"city": null,"postCode": null,"lastEvent": "N","eventCode": "DLI","eventStatus": "Delivering","eventDescription": "派送中","operator": "system","trackingType": null,"subTrackingType": null,"platformType": null,"platformTrackingCode": null,"platformTrackingDesc": null,"platformTrackingStatusCode": null,"mark": null},{"type": "S","date": "2019-05-06 18:23:50","dateTimestamp": 1557138230000,"timeZone": null,"location": "USWC Warehouse","countryCode": null,"stateCode": null,"city": null,"postCode": null,"lastEvent": "N","eventCode": "DIC","eventStatus": null,"eventDescription": "发货完成","operator": "system","trackingType": null,"subTrackingType": null,"platformType": null,"platformTrackingCode": null,"platformTrackingDesc": null,"platformTrackingStatusCode": null,"mark": null},{"type": "S","date": "2019-05-06 18:23:43","dateTimestamp": 1557138223000,"timeZone": null,"location": "USWC Warehouse","countryCode": null,"stateCode": null,"city": null,"postCode": null,"lastEvent": "N","eventCode": "PAC","eventStatus": null,"eventDescription": "打包完成","operator": "la34","trackingType": null,"subTrackingType": null,"platformType": null,"platformTrackingCode": null,"platformTrackingDesc": null,"platformTrackingStatusCode": null,"mark": null},{"type": "S","date": "2019-05-06 18:23:32","dateTimestamp": 1557138212000,"timeZone": null,"location": "USWC Warehouse","countryCode": null,"stateCode": null,"city": null,"postCode": null,"lastEvent": "N","eventCode": "PKC","eventStatus": null,"eventDescription": "拣选完成","operator": "la34","trackingType": null,"subTrackingType": null,"platformType": null,"platformTrackingCode": null,"platformTrackingDesc": null,"platformTrackingStatusCode": null,"mark": null},{"type": "S","date": "2019-05-06 03:18:31","dateTimestamp": 1557083911000,"timeZone": null,"location": "USWC Warehouse","countryCode": null,"stateCode": null,"city": null,"postCode": null,"lastEvent": "N","eventCode": "SO","eventStatus": null,"eventDescription": "提交订单","operator": "rebecca","trackingType": null,"subTrackingType": null,"platformType": null,"platformTrackingCode": null,"platformTrackingDesc": null,"platformTrackingStatusCode": null,"mark": null}],"occurTime": null,"logisticsStatus": null,"logisticsMess": null,"airLines": null,"flight": null,"expressCompany": null,"carrier": null,"carrierCode": null,"standardCarrier": null,"trackingUrl": null,"isTracked": null,"podInfo": {"podUrl": "https://xxxxxx.pdf","formatType": "pdf"},"podInfoList": [{"podUrl": "https://xxxxxx.pdf","formatType": "pdf"},{"podUrl": "https://xxxxxx.pdf","formatType": "pdf"}]}]}
其他返回示例参考
{"code": "0","msg": "操作成功","data": [{"masterOrderNo": "WO1655153080","orderNo": "WO1655153080A","trackingNo": "9205590232843346676480","origin": "US","destination": "United States","pickupMode": null,"status": "派送完成","vendorName": null,"trace": [{"type": "S","date": "2019-05-08 03:08:49","location": "USKY3 Warehouse","lastEvent": "N","eventCode": "SO","eventStatus": null,"eventDescription": "提交订单","operator": "3238372021@qq.com","trackingType": null},{"type": "S","date": "2019-05-08 10:10:42","location": "USKY3 Warehouse","lastEvent": "N","eventCode": "PKC","eventStatus": null,"eventDescription": "拣选完成","operator": "michael.a3","trackingType": null},{"type": "S","date": "2019-05-08 12:11:49","location": "USKY3 Warehouse","lastEvent": "N","eventCode": "PAC","eventStatus": null,"eventDescription": "打包完成","operator": "bertha.b3","trackingType": null},{"type": "S","date": "2019-05-08 16:55:02","location": "USKY3 Warehouse","lastEvent": "N","eventCode": "DIC","eventStatus": null,"eventDescription": "发货完成","operator": "system","trackingType": null},{"type": "S","date": "2019-05-08 16:55:02","location": "USKY3 Warehouse","lastEvent": "N","eventCode": "DLI","eventStatus": "派送中","eventDescription": "派送中","operator": "system","trackingType": null},{"type": "V","date": "2019-05-09 00:00:00","location": " ","lastEvent": "N","eventCode": "MA","eventStatus": null,"eventDescription": "Pre-Shipment Info Sent to USPS, USPS Awaiting Item","operator": null,"trackingType": null},{"type": "V","date": "2019-05-09 23:52:00","location": "DENVER CO NETWORK DISTRIBUTION CENTER","lastEvent": "N","eventCode": "10","eventStatus": null,"eventDescription": "Arrived at USPS Regional Destination Facility","operator": null,"trackingType": "Ascan"},{"type": "V","date": "2019-05-10 05:06:00","location": "DENVER CO NETWORK DISTRIBUTION CENTER","lastEvent": "N","eventCode": "T1","eventStatus": null,"eventDescription": "Departed USPS Regional Facility","operator": null,"trackingType": null},{"type": "V","date": "2019-05-10 06:15:00","location": "DENVER CO DISTRIBUTION CENTER","lastEvent": "N","eventCode": "U1","eventStatus": null,"eventDescription": "Arrived at USPS Regional Facility","operator": null,"trackingType": null},{"type": "V","date": "2019-05-10 07:44:00","location": "DENVER","lastEvent": "N","eventCode": "07","eventStatus": null,"eventDescription": "Arrived at Post Office","operator": null,"trackingType": null},{"type": "V","date": "2019-05-10 09:39:00","location": "DENVER","lastEvent": "N","eventCode": "PC","eventStatus": null,"eventDescription": "Sorting Complete","operator": null,"trackingType": null},{"type": "V","date": "2019-05-10 09:49:00","location": "DENVER","lastEvent": "N","eventCode": "OF","eventStatus": null,"eventDescription": "Out for Delivery","operator": null,"trackingType": null},{"type": "V","date": "2019-05-10 13:24:00","location": "DENVER","lastEvent": "Y","eventCode": "DLC","eventStatus": "派送完成","eventDescription": "派送完成","operator": null,"trackingType": "Dscan"}],"occurTime": null,"logisticsStatus": null,"logisticsMess": null,"airLines": null,"flight": null,"expressCompany": null,"carrier": null,"carrierCode": "United States Postal Service","standardCarrier": "USPS","trackingUrl": "https://www.usps.com","isTracked": "Y"},{"masterOrderNo": "WO1694058642","orderNo": "WO1694058642A","trackingNo": "00340434281410628217","origin": "BE","destination": "Germany","pickupMode": null,"status": "派送中","vendorName": null,"trace": [{"type": "S","date": "2019-05-22 11:28:13","location": "BEMO Warehouse","lastEvent": "N","eventCode": "SO","eventStatus": null,"eventDescription": "提交订单","operator": "20016002@qq.com","trackingType": null},{"type": "S","date": "2019-05-22 13:21:33","location": "BEMO Warehouse","lastEvent": "N","eventCode": "PKC","eventStatus": null,"eventDescription": "拣选完成","operator": "RVA","trackingType": null},{"type": "S","date": "2019-05-22 13:38:00","location": "BEMO Warehouse","lastEvent": "N","eventCode": "PAC","eventStatus": null,"eventDescription": "打包完成","operator": "OPE1","trackingType": null},{"type": "S","date": "2019-05-22 15:04:48","location": "BEMO Warehouse","lastEvent": "N","eventCode": "DIC","eventStatus": null,"eventDescription": "发货完成","operator": "system","trackingType": null},{"type": "S","date": "2019-05-22 15:04:48","location": "BEMO Warehouse","lastEvent": "N","eventCode": "DLI","eventStatus": "派送中","eventDescription": "派送中","operator": "system","trackingType": null}],"occurTime": null,"logisticsStatus": null,"logisticsMess": null,"airLines": null,"flight": null,"expressCompany": null,"carrier": null,"carrierCode": null,"standardCarrier": null,"trackingUrl": null,"isTracked": null},{"masterOrderNo": "WO1693705396","orderNo": "WO1693705396A","trackingNo": "WO01031653362037DE","origin": "DE","destination": "Germany","pickupMode": "供应商揽收","status": "已出库","vendorName": null,"trace": [{"type": "S","date": "2019-05-22 08:58:40","location": "DE Warehouse","lastEvent": "N","eventCode": "SO","eventStatus": null,"eventDescription": "提交订单","operator": "shenzhenxiaohuang@gmail.com","trackingType": null},{"type": "S","date": "2019-05-22 09:17:46","location": "DE Warehouse","lastEvent": "N","eventCode": "PKC","eventStatus": null,"eventDescription": "拣选完成","operator": "ionela","trackingType": null},{"type": "S","date": "2019-05-22 11:12:35","location": "DE Warehouse","lastEvent": "N","eventCode": "PAC","eventStatus": null,"eventDescription": "打包完成","operator": "ilieva","trackingType": null},{"type": "S","date": "2019-05-22 12:52:37","location": "DE Warehouse","lastEvent": "N","eventCode": "DIC","eventStatus": null,"eventDescription": "发货完成","operator": "system","trackingType": null},{"type": "S","date": "2019-05-22 12:52:37","location": "DE Warehouse","lastEvent": "N","eventCode": "DLI","eventStatus": "派送中","eventDescription": "派送中","operator": "system","trackingType": null},{"type": "S","date": "2019-05-22 12:52:37","location": null,"lastEvent": "N","eventCode": "AS","eventStatus": "货物已收到","eventDescription": "货物已收到","operator": null,"trackingType": null},{"type": "S","date": "2019-05-22 12:52:38","location": null,"lastEvent": "Y","eventCode": "GAO","eventStatus": "已出库","eventDescription": "Shipped via [Deutsche Post AG]","operator": null,"trackingType": null}],"occurTime": null,"logisticsStatus": null,"logisticsMess": null,"airLines": null,"flight": null,"expressCompany": null,"carrier": null,"carrierCode": null,"standardCarrier": null,"trackingUrl": null,"isTracked": null},{"masterOrderNo": "WO1686216822","orderNo": "WO1686216822A","trackingNo": "CD841635932DE","origin": "DE","destination": "Lithuania","pickupMode": null,"status": null,"vendorName": null,"trace": [{"type": "S","date": "2019-05-20 06:01:08","location": "DE Warehouse","lastEvent": "N","eventCode": "SO","eventStatus": null,"eventDescription": "提交订单","operator": "hope@dhcoo.com","trackingType": null},{"type": "S","date": "2019-05-20 09:10:56","location": "DE Warehouse","lastEvent": "N","eventCode": "PKC","eventStatus": null,"eventDescription": "拣选完成","operator": "ikov","trackingType": null},{"type": "S","date": "2019-05-20 11:42:56","location": "DE Warehouse","lastEvent": "N","eventCode": "PAC","eventStatus": null,"eventDescription": "打包完成","operator": "florentin","trackingType": null},{"type": "S","date": "2019-05-20 13:44:44","location": "DE Warehouse","lastEvent": "N","eventCode": "DLI","eventStatus": "派送中","eventDescription": "派送中","operator": "system","trackingType": null},{"type": "S","date": "2019-05-20 13:44:44","location": "DE Warehouse","lastEvent": "N","eventCode": "DIC","eventStatus": null,"eventDescription": "发货完成","operator": "system","trackingType": null},{"type": "V","date": "2019-05-20 20:11:00","location": "","lastEvent": "N","eventCode": "PARCV-NRQRD","eventStatus": null,"eventDescription": "The instruction data for this shipment have been provided by the sender to DHL electronically","operator": null,"trackingType": null},{"type": "S","date": "2019-05-20 20:47:43","location": "DE Warehouse","lastEvent": "N","eventCode": "RD","eventStatus": null,"eventDescription": "退货到仓","operator": null,"trackingType": null}],"occurTime": null,"logisticsStatus": null,"logisticsMess": null,"airLines": null,"flight": null,"expressCompany": null,"carrier": null,"carrierCode": "10000552","standardCarrier": "DE DHL","trackingUrl": "https://www.dhl.de/de/privatkunden.html","isTracked": "Y"}]}
