开发者文档
轨迹查询

接口说明

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

使用场景

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

请求说明 

URL

http://api.winit.com.cn/ADInterface/api

接口测试

http://erp.sandbox.winit.com.cn/ADInterface/api

验证方式

Token,md5

格式

json

http请求方式

http

请求数限制

默认每分钟300,有需要可以申请加大

参数说明

名称

类型

必填

说明

示例

warehouseID

String()

Y

出库海外仓ID,唯一且可查询。


outboundNum

String(10)

Y

海外仓出库单单号


trackingNum

String(100)

N

下出库单时选用的派送方式对应生成的快递单号



请求示例

{
    "action":"queryTrack",
    "app_key":"rebecca",
    "data":{
        "outboundNum":"16000027",
        "warehouseID":1000069
    }
,
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "timestamp":"2015-06-16 00:19:26",
    "version":"1.0"
}

返回结果示例

{
    "code":0,
    "data":[
        {
            "trackingmess":" DELIVERED ",
            "status":"DLI",
            "scandateTime":"2015-06-15 00:00:00",
            "scanlocation":" TRUCKEE "
        }
,
        {
            "trackingmess":" OUT FOR DELIVERY",
            "status":"DLI",
            "scandateTime":"2015-06-05 00:00:00",
            "scanlocation":" SPARKS"
        }

    ]
,
    "msg":"成功"
}

返回参数说明

正确的返回结果:查询成功。

名称

类型

说明

示例

data

List

轨迹信息,为信息列表,取决于供应商返回的数量。

轨迹状态

描述,时间,状态,地点。


status

String

状态

DLI

scandateTime

String

扫描时间


scanlocation

String

扫描地点


trackingmess

String

轨迹描述信息


 

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