开发者文档
ISP11-1.ISP轨迹查询

1.接口说明

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

2.使用场景

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

 

3.请求说明

URL

http://openapi.winit.com.cn/openapi/service

接口测试

http://openapi.sandbox.winit.com.cn/openapi/service

请求方法

action:tracking.getOrderTracking

验证方式

Token,md5

格式

json

字符编码UTF-8

http请求方式

http,post

请求数限制


4.请求入参

名称

类型

必填

说明

示例

trackingNOs

String

Y

跟踪号

支持一次查询多个跟踪号

多个跟踪号用半角逗号分隔

05000196055,05000196086

 

 

5、返回出参

名称

类型

说明

示例

orderNo

String(32)

订单号


trackingNo

String(50)

追踪号


origin

String(32)

起始地


destination

String(32)

目的地


carrier

String(64)

承运人


pickupMode

String(20)

揽收方式


status

String(16)

订单状态


trace



 -date

String(20)

日期


 -eventCode

String(10)

轨迹编码


 -eventDescription

String(100)

轨迹描述


 -eventStatus

String(100)

轨迹状态


 -location

String(100)

地点


 -lastEvent

String(1)

最后轨迹(Y/N)

Y表示当前订单后续不再有轨迹更新


 

6、请求示例

{
    "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"
}

返回参数示例:

{
    "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"
                }

            ]

        }

    ]

}

返回参数说明

 

正确的返回结果:返回轨迹信息。

错误的返回结果:错误码,错误信息


错误代码错误信息(中文)错误信息(英文)解决方案
2010250001字段[trackingNos]不能为空The field[trackingNos] can not null填写相应字段值后重新请求
1010250001系统错误System error联系客服或Winit IT处理
1010250002服务访问异常Service access exception稍后重新发起请求,如长时间出现此问题请联系Winit IT