1. 程式人生 > >常用物流快遞單號查詢介面種類及對接方法

常用物流快遞單號查詢介面種類及對接方法

目前快遞查詢介面有兩種方式可以對接,一是和順豐、圓通、中通、天天、韻達、德邦這些快遞公司一一對接介面,二是和快遞鳥這樣第三方整合介面一次性對接多家常用快遞。第一種耗費時間長,但是是直接和快遞公司合作,第二種雖然是間接對接,但是對接簡便,對後期的介面維護可以省很多時間和人力成本。

整合介面還有其他公司提供,有其他需要可以去找,快遞鳥其實能滿足電商、ERP系統商這些企業需求了。這裡就以快遞鳥為例說說對接方法。

快遞鳥物流查詢介面有免費和收費版本,對接週期大概在一天左右,他們有寫好的demo,可以直接使用。

一.即時查詢介面(免費)
  1. 介面規則

(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
    }
]
}
  1. 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"
        }
    ]
}