您好,登錄后才能下訂單哦!
目前快遞查詢接口有兩種方式可以對接,一是和順豐、圓通、中通、天天、韻達、德邦這些快遞公司一一對接接口,二是和快遞鳥這樣第三方集成接口一次性對接多家常用快遞。第一種耗費時間長,但是是直接和快遞公司合作,第二種雖然是間接對接,但是對接簡便,對后期的接口維護可以省很多時間和人力成本。
集成接口還有其他公司提供,有其他需要可以去找,快遞鳥其實能滿足電商、ERP系統商這些企業需求了。這里就以快遞鳥為例說說對接方法。
快遞鳥物流查詢接口有免費和收費版本,對接周期大概在一天左右,他們有寫好的demo,可以直接使用。
一.即時查詢接口(免費)
(1)、查詢接口支持按照運單號查詢(單個查詢,并發不超過10個/S)。
(2)、指定的物流運單號選擇相應的快遞公司編碼,格式不對或則編碼錯誤都會返失敗的信息。如EMS物流單號應選擇快遞公司編碼(EMS)
(3)、返回的物流跟蹤信息按照發生的時間升序排列。
(4)、接口指令1002。
(5)、請求地址:快遞鳥
<br>{
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118650888018"
}
//返回示例<br>//沒有物流軌跡的
{
"EBusinessID": "1109259",
"Traces": [],
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"Reason": null
}
//有物流軌跡的
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118461988807",
"Success": true,
"CallBack":"",
"State": ,
"Reason": null,
"Traces": [
{
"AcceptTime": "2014/06/25 08:05:37",
"AcceptStation": "正在派件..(派件人:鄧裕富,電話:18718866310)[深圳 市]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 04:01:28",
"AcceptStation": "快件在 深圳集散中心 ,準備送往下一站 深圳 [深圳市]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 01:41:06",
"AcceptStation": "快件在 深圳集散中心 [深圳市]",
"Remark": null
},
{
"AcceptTime": "2014/06/24 20:18:58",
"AcceptStation": "已收件[深圳市]",
"Remark": null
},
{
"AcceptTime": "2014/06/24 20:55:28",
"AcceptStation": "快件在 深圳 ,準備送往下一站 深圳集散中心 [深圳市]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 10:23:03",
"AcceptStation": "派件已簽收[深圳市]",
"Remark": null
},
{
"AcceptTime": "2014/06/25 10:23:03",
"AcceptStation": "簽收人是:已簽收[深圳市]",
"Remark": null
}
]
}
2.2接收接口
這個是用戶在訂閱單號成功且有物流軌跡更新后,快遞鳥的推送 客戶通過下單、訂閱接口,把運單號在快遞鳥系統訂閱。運單物流信息有更新,快遞鳥通過推送接口把更新的信息推送給客戶。推送接口由用戶按照快遞鳥規則實現。商戶開放接口,快遞鳥定時將最新的物流軌跡推送到商戶平臺。
優點:客戶不需要關注軌跡變化,一旦有更新,快遞鳥自動推送。
缺點:對客戶的服務器性能有所要求,快遞鳥定時請求接口,對客戶的服務器有一定的影響,客戶服務器異常將接受不到最新數據。 快遞鳥推送接口根據業務不同,會根據RequestType的分類推送不同的數據,用戶需對推送的數據進行分類保存。原推送接口無需變化,快遞鳥會根據推送版本進行推送。
(1)、客戶服務器必須穩定,并且有一定的接受數據能力(需要在5S內給快遞鳥返回成功示例,超時會判斷推送失敗)。快遞鳥通過多線程推送物流信息給客戶。
(2)、客戶需要按快遞鳥要求開發接口,保證信息的正常接收。客戶接數據后,存儲并馬上返回接收響應。如果客戶對數據進行處理,再做出響應。這會造成網絡超時,傳輸效率低下。 (3)、主動推送時物流信息接收接口由客戶提供,接口必須按照快遞鳥的要求實現。
(4)、客戶提供接口地址,用戶登陸用戶管理后臺-----調試平臺-----推送接口進行測試---(成功返回示例后)才可以配置。
(5)、接口只支持Json數據格式。
(6)、POST方式請求。
示例:
//快遞鳥請求接收接口示例<br>訂閱查詢結果示例:
{
"EBusinessID": "1109259",
"Count": "2",
"PushTime": "2015-03-11 16:21:06",
"Data": [
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "EMS",
"LogisticCode": "5042260908504",
"Success": true,
"Reason": "",
"State": "2",
"CallBack": "0",
"Traces": [
{
"AcceptTime": "2015-03-06 21:16:58",
"AcceptStation": "深圳市橫崗速遞營銷部已收件,(攬投員姓名:鐘定基;聯系電話:)",
"Remark": ""
},
{
"AcceptTime": "2015-03-07 14:25:00",
"AcceptStation": "離開深圳市 發往廣州市",
"Remark": ""
},
{
"AcceptTime": "2015-03-08 00:17:00",
"AcceptStation": "到達廣東速遞物流公司廣航中心處理中心(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-08 01:15:00",
"AcceptStation": "離開廣州市 發往北京市(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-09 09:01:00",
"AcceptStation": "到達北京黃村轉運站處理中心(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-09 18:39:00",
"AcceptStation": "離開北京市 發往呼和浩特市(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-10 18:06:00",
"AcceptStation": "到達 呼和浩特市 處理中心",
"Remark": ""
},
{
"AcceptTime": "2015-03-11 09:53:48",
"AcceptStation": "呼和浩特市郵政速遞物流分公司金川攬投部安排投遞(投遞員姓名:安長虹;聯系電話:18047140142)",
"Remark": ""
}
]
},
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "EMS",
"LogisticCode": "5042260943004",
"Success": true,
"Reason": "",
"State": "2",
"CallBack": "0",
"Traces": [
{
"AcceptTime": "2015-03-07 15:26:09",
"AcceptStation": "深圳市橫崗速遞營銷部已收件,(攬投員姓名:周宏彪;聯系電話:13689537568)",
"Remark": ""
},
{
"AcceptTime": "2015-03-08 16:32:00",
"AcceptStation": "離開深圳市 發往廣州市",
"Remark": ""
},
{
"AcceptTime": "2015-03-09 00:58:00",
"AcceptStation": "到達廣東速遞物流公司廣航中心處理中心(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-09 01:15:00",
"AcceptStation": "離開廣州市 發往北京市(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-10 05:20:00",
"AcceptStation": "到達北京黃村轉運站處理中心(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-10 11:59:00",
"AcceptStation": "離開北京市 發往廊坊市(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-10 14:23:00",
"AcceptStation": "到達廊坊市處理中心(經轉)",
"Remark": ""
},
{
"AcceptTime": "2015-03-11 08:55:00",
"AcceptStation": "離開廊坊市 發往保定市(經轉)",
"Remark": ""
}
]
}
]
}
貨款狀態:
{
"EBusinessID": "1109259",
"Count": "2",
"PushTime": "2015/3/11 16:21:06",
"Data": [
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "EMS",
"LogisticCode": "5042260908504",
"Success": true,
"Reason": "",
"State": "2",
"CallBack": "0",
"OrderState":"1",
"AccountName":"張三",
"AccountTel":"13800000000",
"AccountNum":"0321"
},
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "EMS",
"LogisticCode": "5042260908522",
"Success": true,
"Reason": "",
"State": "2",
"CallBack": "0",
"OrderState":"1",
"AccountName":"張三",
"AccountTel":"13800000011",
"AccountNum":"0321"
}
]
}
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。