免費(fèi)調(diào)用快遞鳥(niǎo)物流跟蹤軌跡訂閱接口技術(shù)文檔
物流跟蹤由軌跡訂閱接口和軌跡推送接口組成，對(duì)接時(shí)需要對(duì)接以下二個(gè)接口
1.軌跡訂閱接口
1.1?功能說(shuō)明
快遞鳥(niǎo)物流軌跡訂閱接口用于向快遞鳥(niǎo)訂閱物流軌跡信息。將訂單內(nèi)容通過(guò)訂閱接口訂閱到快遞鳥(niǎo)，客戶可自動(dòng)獲取運(yùn)單的軌跡節(jié)點(diǎn)信息。
免費(fèi)試用接口，快遞鳥(niǎo)官網(wǎng)【產(chǎn)品服務(wù)】-【在途監(jiān)控】-【免費(fèi)試用】，?
支持服務(wù)：預(yù)約取件、監(jiān)督賣(mài)家發(fā)貨、物流跟蹤、異常提醒、簽收狀態(tài)等服務(wù)
1.2?基本信息
1.3?接口規(guī)則
（1）接口對(duì)訂閱的數(shù)據(jù)不做判斷和校驗(yàn)，不校驗(yàn)快遞公司編碼和單號(hào)是否匹配，不判斷快遞
單號(hào)是否合法、是否正確、是否重復(fù)訂閱。
（2）接口支持的消息接收方式為 HTTPS POST，請(qǐng)求方法的編碼格式(utf-8)： "application/x-www-form-urlencoded;charset=utf-8"。
（3）軌跡訂閱接口只返回是否訂閱成功的結(jié)果，不返回實(shí)際軌跡信息，需再開(kāi)發(fā)軌跡推送接口用于接收快遞鳥(niǎo)推送的軌跡數(shù)據(jù)。
（4）接口工作原理：用戶將快遞單號(hào)和訂單信息向快遞鳥(niǎo)訂閱成功后，快遞鳥(niǎo)向快遞公司訂
閱軌跡，當(dāng)軌跡有更新時(shí)，快遞公司推送至快遞鳥(niǎo)，快遞鳥(niǎo)再同步推送至用戶, 直到運(yùn) 單簽收
?
1.4?支持情況
主流快遞僅支持申通快遞、圓通速遞、百世快遞、天天快遞 4 家，不支持 EMS、郵政
快遞包裹、順豐速運(yùn)、韻達(dá)速遞、京東快遞、中通快遞；如需查詢所有主流快遞公司，
請(qǐng)選用在途監(jiān)控服務(wù)；
1.5?應(yīng)用場(chǎng)景
電商平臺(tái)、打單工具、查詢工具、ERP 系統(tǒng)、WEB 端、APP 移動(dòng)端、小程序
1.6?應(yīng)用級(jí)參數(shù)
請(qǐng)求示例:
ZTO 請(qǐng)求示例：
{
"ShipperCode":"ZTO",
"OrderCode":"",
"LogisticCode":"3100707578976",
"PayType":"1",
"ExpType":"1",
"CustomerName":"",
"CustomerPwd":"",
"MonthCode":"",
"IsNotice":"0",
"Sender":{
"Name":"1255760",
"Tel":"",
"Mobile":"13700000000",
"ProvinceName":"廣東省",
"CityName":"深圳市",
"ExpAreaName":"福田區(qū)",
"Address":"測(cè)試地址"
},
"Receiver":{
"Name":"1255760",
"Tel":"",
"Mobile":"13800000000",
"ProvinceName":"廣東省",
"CityName":"深圳市",
"ExpAreaName":"龍華新區(qū)",
"Address":"測(cè)試地址 2"
},
"Commodity":[
{
"GoodsName":"書(shū)本"
}
]
}
JD 請(qǐng)求示例：
{
"ShipperCode":"JD",
"OrderCode":"",
52
"CustomerName": "001K12345",
"LogisticCode": "VA00003618100",
"PayType":"1",
"ExpType":"1",
"CustomerName":"",
"CustomerPwd":"",
"MonthCode":"",
"IsNotice":"0",
"Sender":{
"Name":"1255760",
"Tel":"",
"Mobile":"13700000000",
"ProvinceName":"廣東省",
"CityName":"深圳市",
"ExpAreaName":"福田區(qū)",
"Address":"測(cè)試地址"
},
"Receiver":{
"Name":"1255760",
"Tel":"",
"Mobile":"13800000000",
"ProvinceName":"廣東省",
"CityName":"深圳市",
"ExpAreaName":"龍華新區(qū)",
"Address":"測(cè)試地址 2"
},
"Commodity":[
{
"GoodsName":"書(shū)本"
}
]
}
SF 請(qǐng)求示例：
{
"ShipperCode":"SF",
"OrderCode":"",
"CustomerName": "1234",
"LogisticCode": "SF00003618100",
"PayType":"1",
"ExpType":"1",
"CustomerName":"",
"CustomerPwd":"",
"MonthCode":"",
"IsNotice":"0",
"Sender":{
"Name":"1255760",
"Tel":"",
"Mobile":"13700000000",
"ProvinceName":"廣東省",
"CityName":"深圳市",
"ExpAreaName":"福田區(qū)",
"Address":"測(cè)試地址"
},
"Receiver":{
"Name":"1255760",
"Tel":"",
"Mobile":"13800000000",
"ProvinceName":"廣東省",
"CityName":"深圳市",
"ExpAreaName":"龍華新區(qū)",
"Address":"測(cè)試地址 2"
},
"Commodity":[
{
"GoodsName":"書(shū)本"
}
]
}
1.7?返回參數(shù)
?
返回示例:
{
"EBusinessID": "1237100",
"UpdateTime": "2016-08-09 16:42:38",
"Success": true,
"Reason": ""
}
