快遞100-快遞信息查詢訂閱推送/跟蹤API接口案例代碼

一、訂閱接口

1.1 訂閱請求地址

https://poll.kuaidi100.com/poll

1.2 訂閱請求類型

post

1.3 訂閱輸入參數

請求參數（header）

請求參數（body）

1.4 訂閱請求參數示例

schema = json param = { "company": "ems", "number": "1136281381675", "from": "廣東省深圳市南山區", "to": "北京市朝陽區", "key": "XXX ", "parameters": { "callbackurl": "您的回調接口的地址，如http://www.您的域名.com/kuaidi?callbackid=...", "salt": "XXXXXXXXXX", "resultv2": "1", "autoCom": "1", "interCom"： "1", "departureCountry": "CN", "departureCom": "ems", "destinationCountry": "JP", "destinationCom": "japanposten" } }

1.5 訂閱返回信息代碼含義

result: true表示成功，false表示失敗

1.6 訂閱返回示例（JSON格式）

{ "result": true, "returnCode": "200", "message": "提交成功" }

二、推送接口

2.1 推送請求地址

由貴司在訂閱請求中通過callbackurl字段提供

2.2 推送請求類型

post

2.3 推送輸入參數

請求參數（header）

請求參數（body）

2.4 推送輸入參數示例

param = { "status": "polling", "billstatus": "got", "message": "", "autoCheck": "1", "comOld": "yuantong", "comNew": "ems", "lastResult": { "message": "ok", "state": "0", "status": "200", "condition": "F00", "ischeck": "0", "com": "yuantong", "nu": "V030344422", "data": [ { "context": "上海分撥中心/裝件入車掃描 ", "time": "2012-08-28 16:33:19", "ftime": "2012-08-28 16:33:19", "status": "在途", "areaCode": "310000000000", "areaName": "上海市" }, { "context": "上海分撥中心/下車掃描 ", "time": "2012-08-27 23:22:42", "ftime": "2012-08-27 23:22:42", "status": "在途", "areaCode": "310000000000", "areaName": "上海市" } ] }, "destResult": { "message": "ok", "state": "0", "status": "200", "condition": "F00", "ischeck": "0" , "com": "speedpost", "nu": "EX015142583SG", "data": [ { "context": "[01000]Final delivery Delivered to: SLOVESNOV", "time": "2016-05-24 14:00:00", "ftime": "2016-05-24 14:00:00", "status": "簽收", "areaCode": null, "areaName": null } ] } }

2.5 運單簽收狀態服務說明

2.6 推送響應報文及錯誤碼解釋

2.7 推送返回示例

當我方調用貴方的回調接口（callbackurl）時，貴方需要先將我方提交的數據保存至貴方的數據庫，接著向我方返回是否成功接收的響應報文及代碼，即貴公司直接在回調接口的地址的response中填寫如下內容：

{ "result":true, "returnCode":"200", "message":"成功" }

注意：對于status= abort（message中包含“3天查詢無記錄”或者“60天無變化”）的快遞單，也需要返回成功接收的響應報文及代碼。

三、快遞公司編碼

下載表格

四、demo下載

JAVA示例代碼

PHP示例代碼

PYTHON示例代碼

.NET示例代碼

一、快遞信息推送API產品介紹

快遞100信息推送服務提供運單查詢、追蹤的功能，用于企業對寄出的物品進行物流追蹤。

信息推送服務是企業提交快遞單號，快遞100接收到后便對這些運單進行跟蹤，當運單狀態發生變化的時候，快遞100便通過調用回調接口將運單的跟蹤信息推送給貴公司，直到這些運單號的生命周期結束（一般以“已簽收”為準）。對于某個單號，當貴方正確提交訂閱了后，我們一般會在15分鐘左右后進行第一次監控，如果監控到單號本身有了跟蹤信息，即進行第一次推送，否則等待下一次監控。此后我們一般每4小時進行一次監控，并會根據單號的狀態等因素作調整。

二、快遞信息推送API應用場景

讓顧客登錄您的網站、APP、小程序后，直接在“我的訂單”頁面內就能看到訂單的物流狀態。

能開發自動的、批量查單功能，自動篩選出“已簽收”、“疑難件”等狀態的單號，減輕跟單人員的壓力。

改變訂單的狀態與交易流程，例如只要運單號變為“已簽收”，就能讓訂單變更為可以確認退換貨等。

核銷銷售人員，根據“已簽收”的運單數，就能算出銷售人員的業績。

評估與選擇快遞公司，可獲得快遞實際在途時間，評估快遞公司的時效，優化快遞選擇；

助結算運費，找出“已簽收”的單及簽收時間，便能輕松應對貨到付款的結算與對賬。

三、系統結構與流程

四、快遞信息推送API費用結算

1. 收費方式

快遞信息推送接口屬于查詢類接口，企業注冊快遞100賬號后可以在企業管理后臺查看查詢類接口套餐查看查詢類接口套餐并購買。

2. 收費價格

查詢類接口預充值收費套餐：充值即可開通使用，無需合同流程。

查詢類接口按單收費，一個自然月內同一個運單多次查詢只收一次費用。

3. 開具發票

快遞100支持開具增值稅發票，用戶購買完成后可在企業管理后臺-費用中心-支付記錄-請求開票。默認開具電子增值稅普通發票，1000元以上可支持開具增值稅專用發票。

官方源文檔：

https://api.kuaidi100.com/document/5f0ffa7f2977d50a94e1023b.html

https://api.kuaidi100.com/document/5eb9f79186b0df4188313a0d.html

https://api.kuaidi100.com/document/5f0ffa8f2977d50a94e1023c.html

API 智慧物流

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。