常用物流快遞單號查詢介面種類及對接方法
目前快遞查詢介面有兩種方式可以對接，一是和順豐、圓通、中通、天天、韻達、德邦這些快遞公司一一對接介面，二是和快遞鳥這樣第三方整合介面一次性對接多家常用快遞。第一種耗費時間長，但是是直接和快遞公司合作，第二種雖然是間接對接，但是對接簡便，對後期的介面維護可以省很多時間和人力成本。
整合介面還有其他公司提供，有其他需要可以去找，快遞鳥其實能滿足電商、ERP系統商這些企業需求了。這裡就以快遞鳥為例說說對接方法。
快遞鳥物流查詢介面有免費和收費版本，對接週期大概在一天左右，他們有寫好的demo，可以直接使用。
一.即時查詢介面（免費）- 介面規則
(1)、查詢介面支援按照運單號查詢(單個查詢，併發不超過10個/S)。
(2)、指定的物流運單號選擇相應的快遞公司編碼，格式不對或則編碼錯誤都會返失敗的資訊。如EMS物流單號應選擇快遞公司編碼（EMS）
(3)、返回的物流跟蹤資訊按照發生的時間升序排列。
(4)、介面指令1002。
(5)、請求地址：快遞鳥
系統級和應用級輸入引數
3.返回結果引數
示例
<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接收介面
這個是使用者在訂閱單號成功且有物流軌跡更新後，快遞鳥的推送 客戶通過下單、訂閱介面，把運單號在快遞鳥系統訂閱。運單物流資訊有更新，快遞鳥通過推送介面把更新的資訊推送給客戶。推送介面由使用者按照快遞鳥規則實現。商戶開放介面，快遞鳥定時將最新的物流軌跡推送到商戶平臺。
優點：客戶不需要關注軌跡變化，一旦有更新，快遞鳥自動推送。
缺點：對客戶的伺服器效能有所要求，快遞鳥定時請求介面，對客戶的伺服器有一定的影響，客戶伺服器異常將接受不到最新資料。 快遞鳥推送介面根據業務不同，會根據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"
}
]
}