API
查询轨迹
更新时间: 2019-09-11 21:49:22 访问次数:3885
接口说明

卖家或第三方通过该接口可查询ISP订单轨迹。

接口英文名称

tracking.getOrderTracking

使用场景

卖家或第三方通过该接口可查询ISP订单轨迹。

备注

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
trackingNOs String() Y 跟踪号 支持一次查询多个跟踪号 多个跟踪号用半角逗号分隔 0B044518500034109567A
language String() N 支持三种语言:
1.zh_CN:简体中文
2.zh_TW:繁体中文
3.en_US:英文
目前仅支持Winit物流轨迹的多语言,物流商返回的轨迹为原始轨迹,暂不支持多语言
en_US
请求示例
{
    "action":"tracking.getOrderTracking",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"15C17E14FA353FCF2CF2981AD27981C6",
    "data":{
        "trackingNOs":"0B044518500034109567A"
    },
    "format":"json",
    "language":"en_US",
    "platform":"OWNERERP",
    "sign":"3E49BAD6071EB567E7C75FBD8EB2AA70",
    "sign_method":"md5",
    "timestamp":"2015-06-16 00:19:26",
    "version":"1.0"
}

                            
返回出参
名称 类型 必填 说明 示例
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 轨迹,以下为子节点
--|date String(20) 日期
--|eventCode String(10) 轨迹编码
--|eventDescription String(100) 轨迹描述
--|eventStatus String(100) 轨迹状态
--|location String(100) 地点
--|lastEvent String(1) 最后轨迹(Y/N),Y表示当前订单后续不再有轨迹更新

正确的返回结果:返回轨迹信息。 错误的返回结果:错误码,错误信息

返回示例
{
   "code": "0",
   "msg": null,
   "data": [   {
      "masterOrderNo": null,
      "orderNo": "ID15110000000061ZZ",
      "trackingNo": "0B044518500034109567A",
      "origin": "深圳市",
      "destination": "UK",
      "pickupMode": "3rd Party Logistic",
      "status": "Enroute to Carrier's Depot",
      "vendorName": null,
      "trace":       [
                  {
            "type": "S",
            "date": "2019-05-28 11:24:23",
            "location": "Shenzhen",
            "lastEvent": "N",
            "eventCode": "WFD",
            "eventStatus": "Submitted",
            "eventDescription": "Prepare for shipments",
            "operator": null,
            "trackingType": null
         },
                  {
            "type": "S",
            "date": "2019-05-29 14:11:59",
            "location": "Shenzhen",
            "lastEvent": "N",
            "eventCode": "WFR",
            "eventStatus": "Ready for pick-up",
            "eventDescription": "Ready for pick-up",
            "operator": null,
            "trackingType": null
         },
                  {
            "type": "S",
            "date": "2019-05-29 14:12:00",
            "location": "Shenzhen",
            "lastEvent": "Y",
            "eventCode": "GAO",
            "eventStatus": "Enroute to Carrier's Depot",
            "eventDescription": "Enroute to Carrier’s Depot to be shipped via []",
            "operator": null,
            "trackingType": null
         }
      ],
      "occurTime": null,
      "logisticsStatus": null,
      "logisticsMess": null,
      "airLines": null,
      "flight": null,
      "expressCompany": null,
      "carrier": null,
      "carrierCode": "RM Post",
      "standardCarrier": "Royal Mail",
      "trackingUrl": "https://www.royalmail.com/track-your-item",
      "isTracked": "N"
   }]
}