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.   }