API
ISP11-1.ISP轨迹查询
更新时间: 2017-11-22 18:49:22 访问次数:771
接口说明

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

使用场景

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

备注

请求说明
URL http://api.winit.com.cn/ADInterface/api
接口测试 http://erp.sandbox.winit.com.cn/ADInterface/api
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
trackingNOs String() Y 跟踪号 支持一次查询多个跟踪号 多个跟踪号用半角逗号分隔 05000196055,05000196086
请求示例
{
    "action":"tracking.getOrderTracking",
    "app_key":"rebecca",
    "data":{
        "trackingNOs":"05000196055,05000196086"
    },
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "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":"操作成功",
    "data":[
        {
            "orderNo":"ID15000000222323CN",
            "trackingNo":"05000196055",
            "origin":"上海",
            "destination":"US",
            "status":"中邮交航",
            "carrier":"中国邮政速递物流股份有限公司北京市国际快递分公司",
            "pickupMode":"Winit揽收",
            "trace":[
                {
                    "date":"2015-07-25 11:36:41",
                    "eventCode":"WFD",
                    "eventDescription":"备货中",
                    "eventStatus":"Prepare for shipments",
                    "location":"金华市",
                    "lastEvent":"N"
                },
                {
                    "date":"2015-07-25 12:48:03",
                    "eventCode":"WFR",
                    "eventDescription":"等待收件",
                    "eventStatus":"Ready for pick up",
                    "location":"金华市",
                    "lastEvent":"N"
                },
                {
                    "date":"2015-07-28 15:56:54",
                    "eventCode":"CFS",
                    "eventDescription":"揽收成功",
                    "eventStatus":"Pick up completed",
                    "location":"金华市",
                    "lastEvent":"N"
                },
                {
                    "date":"2015-07-28 16:19:59",
                    "eventCode":"YWCK",
                    "eventDescription":"送中邮仓",
                    "eventStatus":"In route to China Post Depot",
                    "location":"金华市",
                    "lastEvent":"N"
                },
                {
                    "date":"2015-07-30 08:29:31",
                    "eventCode":"CCPA",
                    "eventDescription":"中邮收寄",
                    "eventStatus":"China Post Accept",
                    "location":"上海",
                    "lastEvent":"N"
                },
                {
                    "date":"2015-08-02 11:40:14",
                    "eventCode":"CPS",
                    "eventDescription":"直封总包",
                    "eventStatus":"Processing shipment",
                    "location":"上海",
                    "lastEvent":"N"
                },
                {
                    "date":"2015-08-03 13:42:26",
                    "eventCode":"CCPD",
                    "eventDescription":"中邮交航",
                    "eventStatus":"China Post dispatch",
                    "location":"上海",
                    "lastEvent":"Y"
                }
            ]
        },
        {
            "orderNo":"ID15000000222291CN",
            "trackingNo":"05000196086",
            "origin":"上海",
            "destination":"US",
            "status":"等待收件",
            "carrier":"中国邮政速递物流股份有限公司北京市国际快递分公司",
            "pickupMode":"中邮揽收",
            "trace":[
                {
                    "date":"2015-07-25 11:36:40",
                    "eventCode":"WFD",
                    "eventDescription":"备货中",
                    "eventStatus":"Prepare for shipments",
                    "location":"金华市",
                    "lastEvent":"N"
                },
                {
                    "date":"2015-07-25 12:48:03",
                    "eventCode":"WFR",
                    "eventDescription":"等待收件",
                    "eventStatus":"Ready for pick up",
                    "location":"金华市",
                    "lastEvent":"N"
                }
            ]
        }
    ]
}