API
查询轨迹(库内)
更新时间: 2017-11-22 18:32:16 访问次数:2198
接口说明

本接口用于提供给第三方平台或是卖家自有系统集成“获取轨迹”。

接口英文名称

queryTrack

使用场景

卖家可以通过该接口实现按出库单号及快递单号查询运送运送轨迹。结合出库单查询接口可做到轨迹的批量查询。

备注

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
warehouseID String() Y 出库海外仓ID,唯一且可查询
outboundNum String(10) Y 海外仓出库单单号
trackingNum String(100) N 下出库单时选用的派送方式对应生成的快递单号
请求示例
{
    "action":"queryTrack",
    "app_key":"rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"6A57A3AF36DFAD2CBE4662D3A19D73FE",
    "data":{
        "outboundNum":"WO0000001285",
        "warehouseID":"1000069"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"OWNERERP",
    "sign":"890885757E39833CE43BD0AA441386C4",
    "sign_method":"md5",
    "timestamp":"2015-06-16 00:19:26",
    "version":"1.0"
}

                            
返回出参
名称 类型 必填 说明 示例
data List Y 轨迹信息,为信息列表,取决于供应商返回的数量。 轨迹状态 描述,时间,状态,地点。
status String() Y 状态
scandateTime String() Y 扫描时间
scanlocation String() Y 扫描地点
trackingmess String() Y 轨迹描述信息

错误的返回结果:查询失败

返回示例
{
   "code": "0",
   "msg": "操作成功",
   "data": [   {
      "scanlocation": null,
      "scandateTime": "2019-05-28 17:31:46",
      "trackingmess": "提交订单",
      "status": "SO"
   }]
}



其他出参示例:
{
   "code": 0,
   "msg": "操作成功",
   "data":    [
            {
         "scanlocation": null,
         "scandateTime": "2019-05-05 16:00:06",
         "trackingmess": "提交订单",
         "status": "SO"
      },
            {
         "scanlocation": "UK Warehouse",
         "scandateTime": "2019-05-06 14:31:11",
         "trackingmess": "拣选完成",
         "status": "PKC"
      },
            {
         "scanlocation": "UK Warehouse",
         "scandateTime": "2019-05-06 22:39:14",
         "trackingmess": "打包完成",
         "status": "PAC"
      },
            {
         "scanlocation": "UK Warehouse",
         "scandateTime": "2019-05-07 22:52:51",
         "trackingmess": "发货完成",
         "status": "DIC"
      },
            {
         "scanlocation": "UK Warehouse",
         "scandateTime": "2019-05-07 22:52:51",
         "trackingmess": "派送中",
         "status": "DLI"
      },
            {
         "scanlocation": "UK Warehouse",
         "scandateTime": "2019-05-08 16:56:01",
         "trackingmess": "派送完成",
         "status": "DLC"
      }
   ]
}