API
查询轨迹(库内+派送)
更新时间: 2024-10-18 10:30:49 访问次数:13622

接口说明

卖家或第三方通过该接口可查询海外仓订单轨迹。
若使用的带签收的服务,则可以通过该接口获取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

请求示例

  1. {
  2. "action": "tracking.getOrderVerdorTracking",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "data": {
  6. "trackingnos": "WO0000000037"
  7. },
  8. "format": "json",
  9. "language": "zh_CN",
  10. "platform": "OWNERERP",
  11. "sign": "511AF2B9995E08EC53D9F0558F56B1B8",
  12. "client_sign":"AC9B73944FC7350A77788D7FE4872135",
  13. "sign_method": "md5",
  14. "timestamp": "2016-07-10 23:04:52",
  15. "version": "1.0"
  16. }

返回出参

返回参数说明:正确的返回编码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 日期
– 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

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": [ {
  5. "masterOrderNo": "WO0000000037",
  6. "orderNo": "WO0000000037A",
  7. "trackingNo": "Z68223Y0323227683",
  8. "origin": "US",
  9. "destination": "United States",
  10. "pickupMode": null,
  11. "status": "派送中",
  12. "vendorName": null,
  13. "trace": [
  14. {
  15. "type": "S",
  16. "date": "2019-05-06 18:23:50",
  17. "location": "USWC Warehouse",
  18. "lastEvent": "N",
  19. "eventCode": "DLI",
  20. "eventStatus": "派送中",
  21. "eventDescription": "派送中",
  22. "operator": "system",
  23. "trackingType": null
  24. },
  25. {
  26. "type": "S",
  27. "date": "2019-05-06 18:23:50",
  28. "location": "USWC Warehouse",
  29. "lastEvent": "N",
  30. "eventCode": "DIC",
  31. "eventStatus": null,
  32. "eventDescription": "发货完成",
  33. "operator": "system",
  34. "trackingType": null
  35. },
  36. {
  37. "type": "S",
  38. "date": "2019-05-06 18:23:43",
  39. "location": "USWC Warehouse",
  40. "lastEvent": "N",
  41. "eventCode": "PAC",
  42. "eventStatus": null,
  43. "eventDescription": "打包完成",
  44. "operator": "la34",
  45. "trackingType": null
  46. },
  47. {
  48. "type": "S",
  49. "date": "2019-05-06 18:23:32",
  50. "location": "USWC Warehouse",
  51. "lastEvent": "N",
  52. "eventCode": "PKC",
  53. "eventStatus": null,
  54. "eventDescription": "拣选完成",
  55. "operator": "la34",
  56. "trackingType": null
  57. },
  58. {
  59. "type": "S",
  60. "date": "2019-05-06 03:18:31",
  61. "location": "USWC Warehouse",
  62. "lastEvent": "N",
  63. "eventCode": "SO",
  64. "eventStatus": null,
  65. "eventDescription": "提交订单",
  66. "operator": "rebecca",
  67. "trackingType": null
  68. }
  69. ],
  70. "occurTime": null,
  71. "logisticsStatus": null,
  72. "logisticsMess": null,
  73. "airLines": null,
  74. "flight": null,
  75. "expressCompany": null,
  76. "carrier": null,
  77. "carrierCode": null,
  78. "standardCarrier": null,
  79. "trackingUrl": null,
  80. "isTracked": null
  81. "podInfo": {
  82. "podUrl": "https://xxxxxx.pdf",
  83. "formatType": "pdf"
  84. },
  85. "podInfoList": [
  86. {"podUrl": "https://xxxxxx.pdf","formatType": "pdf"},
  87. {"podUrl": "https://xxxxxx.pdf","formatType": "pdf"}
  88. ]
  89. }]
  90. }

其他返回示例参考

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": [
  5. {
  6. "masterOrderNo": "WO1655153080",
  7. "orderNo": "WO1655153080A",
  8. "trackingNo": "9205590232843346676480",
  9. "origin": "US",
  10. "destination": "United States",
  11. "pickupMode": null,
  12. "status": "派送完成",
  13. "vendorName": null,
  14. "trace": [
  15. {
  16. "type": "S",
  17. "date": "2019-05-08 03:08:49",
  18. "location": "USKY3 Warehouse",
  19. "lastEvent": "N",
  20. "eventCode": "SO",
  21. "eventStatus": null,
  22. "eventDescription": "提交订单",
  23. "operator": "3238372021@qq.com",
  24. "trackingType": null
  25. },
  26. {
  27. "type": "S",
  28. "date": "2019-05-08 10:10:42",
  29. "location": "USKY3 Warehouse",
  30. "lastEvent": "N",
  31. "eventCode": "PKC",
  32. "eventStatus": null,
  33. "eventDescription": "拣选完成",
  34. "operator": "michael.a3",
  35. "trackingType": null
  36. },
  37. {
  38. "type": "S",
  39. "date": "2019-05-08 12:11:49",
  40. "location": "USKY3 Warehouse",
  41. "lastEvent": "N",
  42. "eventCode": "PAC",
  43. "eventStatus": null,
  44. "eventDescription": "打包完成",
  45. "operator": "bertha.b3",
  46. "trackingType": null
  47. },
  48. {
  49. "type": "S",
  50. "date": "2019-05-08 16:55:02",
  51. "location": "USKY3 Warehouse",
  52. "lastEvent": "N",
  53. "eventCode": "DIC",
  54. "eventStatus": null,
  55. "eventDescription": "发货完成",
  56. "operator": "system",
  57. "trackingType": null
  58. },
  59. {
  60. "type": "S",
  61. "date": "2019-05-08 16:55:02",
  62. "location": "USKY3 Warehouse",
  63. "lastEvent": "N",
  64. "eventCode": "DLI",
  65. "eventStatus": "派送中",
  66. "eventDescription": "派送中",
  67. "operator": "system",
  68. "trackingType": null
  69. },
  70. {
  71. "type": "V",
  72. "date": "2019-05-09 00:00:00",
  73. "location": " ",
  74. "lastEvent": "N",
  75. "eventCode": "MA",
  76. "eventStatus": null,
  77. "eventDescription": "Pre-Shipment Info Sent to USPS, USPS Awaiting Item",
  78. "operator": null,
  79. "trackingType": null
  80. },
  81. {
  82. "type": "V",
  83. "date": "2019-05-09 23:52:00",
  84. "location": "DENVER CO NETWORK DISTRIBUTION CENTER",
  85. "lastEvent": "N",
  86. "eventCode": "10",
  87. "eventStatus": null,
  88. "eventDescription": "Arrived at USPS Regional Destination Facility",
  89. "operator": null,
  90. "trackingType": "Ascan"
  91. },
  92. {
  93. "type": "V",
  94. "date": "2019-05-10 05:06:00",
  95. "location": "DENVER CO NETWORK DISTRIBUTION CENTER",
  96. "lastEvent": "N",
  97. "eventCode": "T1",
  98. "eventStatus": null,
  99. "eventDescription": "Departed USPS Regional Facility",
  100. "operator": null,
  101. "trackingType": null
  102. },
  103. {
  104. "type": "V",
  105. "date": "2019-05-10 06:15:00",
  106. "location": "DENVER CO DISTRIBUTION CENTER",
  107. "lastEvent": "N",
  108. "eventCode": "U1",
  109. "eventStatus": null,
  110. "eventDescription": "Arrived at USPS Regional Facility",
  111. "operator": null,
  112. "trackingType": null
  113. },
  114. {
  115. "type": "V",
  116. "date": "2019-05-10 07:44:00",
  117. "location": "DENVER",
  118. "lastEvent": "N",
  119. "eventCode": "07",
  120. "eventStatus": null,
  121. "eventDescription": "Arrived at Post Office",
  122. "operator": null,
  123. "trackingType": null
  124. },
  125. {
  126. "type": "V",
  127. "date": "2019-05-10 09:39:00",
  128. "location": "DENVER",
  129. "lastEvent": "N",
  130. "eventCode": "PC",
  131. "eventStatus": null,
  132. "eventDescription": "Sorting Complete",
  133. "operator": null,
  134. "trackingType": null
  135. },
  136. {
  137. "type": "V",
  138. "date": "2019-05-10 09:49:00",
  139. "location": "DENVER",
  140. "lastEvent": "N",
  141. "eventCode": "OF",
  142. "eventStatus": null,
  143. "eventDescription": "Out for Delivery",
  144. "operator": null,
  145. "trackingType": null
  146. },
  147. {
  148. "type": "V",
  149. "date": "2019-05-10 13:24:00",
  150. "location": "DENVER",
  151. "lastEvent": "Y",
  152. "eventCode": "DLC",
  153. "eventStatus": "派送完成",
  154. "eventDescription": "派送完成",
  155. "operator": null,
  156. "trackingType": "Dscan"
  157. }
  158. ],
  159. "occurTime": null,
  160. "logisticsStatus": null,
  161. "logisticsMess": null,
  162. "airLines": null,
  163. "flight": null,
  164. "expressCompany": null,
  165. "carrier": null,
  166. "carrierCode": "United States Postal Service",
  167. "standardCarrier": "USPS",
  168. "trackingUrl": "https://www.usps.com",
  169. "isTracked": "Y"
  170. },
  171. {
  172. "masterOrderNo": "WO1694058642",
  173. "orderNo": "WO1694058642A",
  174. "trackingNo": "00340434281410628217",
  175. "origin": "BE",
  176. "destination": "Germany",
  177. "pickupMode": null,
  178. "status": "派送中",
  179. "vendorName": null,
  180. "trace": [
  181. {
  182. "type": "S",
  183. "date": "2019-05-22 11:28:13",
  184. "location": "BEMO Warehouse",
  185. "lastEvent": "N",
  186. "eventCode": "SO",
  187. "eventStatus": null,
  188. "eventDescription": "提交订单",
  189. "operator": "20016002@qq.com",
  190. "trackingType": null
  191. },
  192. {
  193. "type": "S",
  194. "date": "2019-05-22 13:21:33",
  195. "location": "BEMO Warehouse",
  196. "lastEvent": "N",
  197. "eventCode": "PKC",
  198. "eventStatus": null,
  199. "eventDescription": "拣选完成",
  200. "operator": "RVA",
  201. "trackingType": null
  202. },
  203. {
  204. "type": "S",
  205. "date": "2019-05-22 13:38:00",
  206. "location": "BEMO Warehouse",
  207. "lastEvent": "N",
  208. "eventCode": "PAC",
  209. "eventStatus": null,
  210. "eventDescription": "打包完成",
  211. "operator": "OPE1",
  212. "trackingType": null
  213. },
  214. {
  215. "type": "S",
  216. "date": "2019-05-22 15:04:48",
  217. "location": "BEMO Warehouse",
  218. "lastEvent": "N",
  219. "eventCode": "DIC",
  220. "eventStatus": null,
  221. "eventDescription": "发货完成",
  222. "operator": "system",
  223. "trackingType": null
  224. },
  225. {
  226. "type": "S",
  227. "date": "2019-05-22 15:04:48",
  228. "location": "BEMO Warehouse",
  229. "lastEvent": "N",
  230. "eventCode": "DLI",
  231. "eventStatus": "派送中",
  232. "eventDescription": "派送中",
  233. "operator": "system",
  234. "trackingType": null
  235. }
  236. ],
  237. "occurTime": null,
  238. "logisticsStatus": null,
  239. "logisticsMess": null,
  240. "airLines": null,
  241. "flight": null,
  242. "expressCompany": null,
  243. "carrier": null,
  244. "carrierCode": null,
  245. "standardCarrier": null,
  246. "trackingUrl": null,
  247. "isTracked": null
  248. },
  249. {
  250. "masterOrderNo": "WO1693705396",
  251. "orderNo": "WO1693705396A",
  252. "trackingNo": "WO01031653362037DE",
  253. "origin": "DE",
  254. "destination": "Germany",
  255. "pickupMode": "供应商揽收",
  256. "status": "已出库",
  257. "vendorName": null,
  258. "trace": [
  259. {
  260. "type": "S",
  261. "date": "2019-05-22 08:58:40",
  262. "location": "DE Warehouse",
  263. "lastEvent": "N",
  264. "eventCode": "SO",
  265. "eventStatus": null,
  266. "eventDescription": "提交订单",
  267. "operator": "shenzhenxiaohuang@gmail.com",
  268. "trackingType": null
  269. },
  270. {
  271. "type": "S",
  272. "date": "2019-05-22 09:17:46",
  273. "location": "DE Warehouse",
  274. "lastEvent": "N",
  275. "eventCode": "PKC",
  276. "eventStatus": null,
  277. "eventDescription": "拣选完成",
  278. "operator": "ionela",
  279. "trackingType": null
  280. },
  281. {
  282. "type": "S",
  283. "date": "2019-05-22 11:12:35",
  284. "location": "DE Warehouse",
  285. "lastEvent": "N",
  286. "eventCode": "PAC",
  287. "eventStatus": null,
  288. "eventDescription": "打包完成",
  289. "operator": "ilieva",
  290. "trackingType": null
  291. },
  292. {
  293. "type": "S",
  294. "date": "2019-05-22 12:52:37",
  295. "location": "DE Warehouse",
  296. "lastEvent": "N",
  297. "eventCode": "DIC",
  298. "eventStatus": null,
  299. "eventDescription": "发货完成",
  300. "operator": "system",
  301. "trackingType": null
  302. },
  303. {
  304. "type": "S",
  305. "date": "2019-05-22 12:52:37",
  306. "location": "DE Warehouse",
  307. "lastEvent": "N",
  308. "eventCode": "DLI",
  309. "eventStatus": "派送中",
  310. "eventDescription": "派送中",
  311. "operator": "system",
  312. "trackingType": null
  313. },
  314. {
  315. "type": "S",
  316. "date": "2019-05-22 12:52:37",
  317. "location": null,
  318. "lastEvent": "N",
  319. "eventCode": "AS",
  320. "eventStatus": "货物已收到",
  321. "eventDescription": "货物已收到",
  322. "operator": null,
  323. "trackingType": null
  324. },
  325. {
  326. "type": "S",
  327. "date": "2019-05-22 12:52:38",
  328. "location": null,
  329. "lastEvent": "Y",
  330. "eventCode": "GAO",
  331. "eventStatus": "已出库",
  332. "eventDescription": "Shipped via [Deutsche Post AG]",
  333. "operator": null,
  334. "trackingType": null
  335. }
  336. ],
  337. "occurTime": null,
  338. "logisticsStatus": null,
  339. "logisticsMess": null,
  340. "airLines": null,
  341. "flight": null,
  342. "expressCompany": null,
  343. "carrier": null,
  344. "carrierCode": null,
  345. "standardCarrier": null,
  346. "trackingUrl": null,
  347. "isTracked": null
  348. },
  349. {
  350. "masterOrderNo": "WO1686216822",
  351. "orderNo": "WO1686216822A",
  352. "trackingNo": "CD841635932DE",
  353. "origin": "DE",
  354. "destination": "Lithuania",
  355. "pickupMode": null,
  356. "status": null,
  357. "vendorName": null,
  358. "trace": [
  359. {
  360. "type": "S",
  361. "date": "2019-05-20 06:01:08",
  362. "location": "DE Warehouse",
  363. "lastEvent": "N",
  364. "eventCode": "SO",
  365. "eventStatus": null,
  366. "eventDescription": "提交订单",
  367. "operator": "hope@dhcoo.com",
  368. "trackingType": null
  369. },
  370. {
  371. "type": "S",
  372. "date": "2019-05-20 09:10:56",
  373. "location": "DE Warehouse",
  374. "lastEvent": "N",
  375. "eventCode": "PKC",
  376. "eventStatus": null,
  377. "eventDescription": "拣选完成",
  378. "operator": "ikov",
  379. "trackingType": null
  380. },
  381. {
  382. "type": "S",
  383. "date": "2019-05-20 11:42:56",
  384. "location": "DE Warehouse",
  385. "lastEvent": "N",
  386. "eventCode": "PAC",
  387. "eventStatus": null,
  388. "eventDescription": "打包完成",
  389. "operator": "florentin",
  390. "trackingType": null
  391. },
  392. {
  393. "type": "S",
  394. "date": "2019-05-20 13:44:44",
  395. "location": "DE Warehouse",
  396. "lastEvent": "N",
  397. "eventCode": "DLI",
  398. "eventStatus": "派送中",
  399. "eventDescription": "派送中",
  400. "operator": "system",
  401. "trackingType": null
  402. },
  403. {
  404. "type": "S",
  405. "date": "2019-05-20 13:44:44",
  406. "location": "DE Warehouse",
  407. "lastEvent": "N",
  408. "eventCode": "DIC",
  409. "eventStatus": null,
  410. "eventDescription": "发货完成",
  411. "operator": "system",
  412. "trackingType": null
  413. },
  414. {
  415. "type": "V",
  416. "date": "2019-05-20 20:11:00",
  417. "location": "",
  418. "lastEvent": "N",
  419. "eventCode": "PARCV-NRQRD",
  420. "eventStatus": null,
  421. "eventDescription": "The instruction data for this shipment have been provided by the sender to DHL electronically",
  422. "operator": null,
  423. "trackingType": null
  424. },
  425. {
  426. "type": "S",
  427. "date": "2019-05-20 20:47:43",
  428. "location": "DE Warehouse",
  429. "lastEvent": "N",
  430. "eventCode": "RD",
  431. "eventStatus": null,
  432. "eventDescription": "退货到仓",
  433. "operator": null,
  434. "trackingType": null
  435. }
  436. ],
  437. "occurTime": null,
  438. "logisticsStatus": null,
  439. "logisticsMess": null,
  440. "airLines": null,
  441. "flight": null,
  442. "expressCompany": null,
  443. "carrier": null,
  444. "carrierCode": "10000552",
  445. "standardCarrier": "DE DHL",
  446. "trackingUrl": "https://www.dhl.de/de/privatkunden.html",
  447. "isTracked": "Y"
  448. }
  449. ]
  450. }