物流快递单号查询接口种类及对接方法
目前快遞查詢接口有兩種方式可以對接,一是和順豐、圓通、中通、天天、韻達、德邦這些快遞公司一一對接接口,二是和快遞鳥這樣第三方集成接口一次性對接多家常用快遞。第一種耗費時間長,但是是直接和快遞公司合作,第二種雖然是間接對接,但是對接簡便,對后期的接口維護可以省很多時間和人力成本。
? ?集成接口還有其他公司提供,有其他需要可以去找,快遞鳥其實能滿足電商、ERP系統商這些企業需求了。這里就以快遞鳥為例說說對接方法。
? ?快遞鳥物流查詢接口有免費和收費版本,對接周期大概在一天左右,他們有寫好的demo,可以直接使用。
?? ?一.即時查詢接口(免費)
1. ? 接口規則
(1)、查詢接口支持按照運單號查詢(單個查詢,并發不超過10個/S)。
(2)、指定的物流運單號選擇相應的快遞公司編碼,格式不對或則編碼錯誤都會返失敗的信息。如EMS物流單號應選擇快遞公司編碼(EMS)
(3)、返回的物流跟蹤信息按照發生的時間升序排列。
(4)、接口指令1002。
(5)、請求地址:http://www.kdniao.com/api-track
2. ? 系統級和應用級輸入參數
返回結果參數
示例?
<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. ? 接口規則
(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"}] }
來自 “ ITPUB博客 ” ,鏈接:http://blog.itpub.net/69945342/viewspace-2654328/,如需轉載,請注明出處,否則將追究法律責任。
轉載于:http://blog.itpub.net/69945342/viewspace-2654328/
總結
以上是生活随笔為你收集整理的物流快递单号查询接口种类及对接方法的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 镜头分类与选型
- 下一篇: element ui 火狐_快速Fire