物流跟蹤API 快遞單訂閱

為了更好的理解訂閱服務，我們來做個對比，

即時查詢是主動查詢物流軌跡，需要我們主動呼叫介面才能獲得物流軌跡。

快遞單訂閱是被動接收物流軌跡，我們把大量的物流訂單通過介面委託給快遞鳥，

快遞鳥對訂單進行實時監控，當物流軌跡有更新時，快遞鳥通過內部處理，計算運單預計到達時間、全流程的物流狀態，推送到我們指定的介面位址。每一次的物流軌跡更新，快遞鳥就會呼叫一次我們提供的介面位址，直到訂單簽收後才結束訂閱。

有些朋友可能會問，我只要使用即時介面查詢快遞就可以了，為什麼還要使用訂閱服務功能？

目的只有乙個，減少公司開發成本，提公升使用者體驗。

假設我們的電商平台，每天有1000個訂單需要發貨，每天就有1000個運單要查詢物流軌跡，乙個訂單從發貨到簽收週期是3-7天，我們需要查詢所有未簽收的運單軌跡，綜合統計，一天我們可能需要查詢5000千個訂單，如果我們對訂單時效要求非常高，需要實時了解包裹的簽收情況，我們就要反覆呼叫介面，每半小時呼叫一次，乙個單一天要呼叫48次，如果時效要求更高，呼叫更頻繁，5000個訂單需要呼叫24萬次以上，這樣的頻繁呼叫既占用公司伺服器資源，也容易被快遞鳥當中惡意攻擊查封介面。

這個時候訂閱服務的優勢就提現出來了，我們只需要把每天的1000個發貨訂單推送到快遞鳥，讓快遞鳥去做這個比較繁瑣的事情，快遞鳥會監控我們推送過去的所有訂單，只要沒有被簽收，快遞鳥就會提供推送服務，假設目前有5000個訂單還沒被簽收，快遞鳥就會監控這5000個單，其中任何乙個單有新的軌跡或者被簽收了，快遞鳥即時呼叫我們提供的介面，把軌跡推送到我們的伺服器，這樣我們就實現了0延遲，真正做到了即時更新物流軌跡，我們利用這個功能可以實現很多產品服務，比如：簡訊提醒客戶訂單預計簽收時間，統計訂單的簽收情況，計算訂單的發貨時效……

訂閱服務我們已經了解了，接下來說說如何對接。

一、介面描述/說明

1.訂閱介面

（1）此功能為專業定製，為特殊商戶提供訂閱服務，快遞鳥系統會定時推送新的物流資訊到商戶系統。

（2）訂閱快遞號需指定相應的快遞公司編碼，格式不對或則編碼錯誤都會返回失敗的資訊。

請求系統級引數說明：

引數名稱

型別說明

必須要求

requestdata

string

請求內容需進行url(utf-8)編碼。請求內容json格式，須和datatype一致。r

ebusinessid

string

商戶id，請在我的服務頁面檢視。r

requesttype

string

請求指令型別：1008r

datasign

stringr

datatype

string

請求、返回資料型別：2-json；r

備註：r-必填（required），o-可選（optional），c-報文中該引數在一定條件下可選（conditional）

二、介面引數

1.訂閱介面

請求內容字段定義：

引數型別

說明必須要求

callback

string(50)

使用者自定義**資訊o

memberid

string(50)

會員標識(備用字段)o

warehouseid

string(30)

倉庫標識(備用字段)o

customername

string

電子面單客戶賬號(與快遞網點申請)o

customerpwd

string

電子面單密碼o

sendsite

string

收件網點標識(名稱)o

shippercode

string(10)

快遞公司編碼r

logisticcode

string(30)

快遞單號r

ordercode

string(30)

訂單編號o

monthcode

string(20)

月結編號o

paytype

int郵費支付方式:1-現付，2-到付，3-月結，4-第三方支付o

exptype

string(2)

快遞型別：1-標準快件o

cost

double(5)

快遞運費o

othercost

double(5)

其他費用o

receiver

company

string(30)

收件人公司o

name

string(30)

收件人r

telstring(20)

**(**與手機，必填乙個)r

mobile

string(20)手機r

postcode

string(10)

收件人郵編o

provincename

string(20)

收件省（如廣東省，不要缺少「省」）r

cityname

string(20)

收件市（如深圳市，不要缺少「市」）r

expareaname

string(20)

收件區（如福田區，不要缺少「區」或「縣」）r

address

string(100)

收件人詳細位址r

sender

company

string(30)

發件人公司o

name

string(30)

發件人r

telstring(20)

手機與**必填乙個r

mobile

string(20)

發件人手機r

postcode

string

發件人郵編o

provincename

string(20)

發件省（如廣東省，不要缺少「省」）r

cityname

string(20)

發件市（如深圳市，不要缺少「市」）r

expareaname

string(20)

發件區（如福田區，不要缺少「區」或「縣」）r

address

string(100)

發件人詳細位址r

isnotice

int(1)

是否通知快遞員上門攬件：0-通知;1-不通知;預設為1o

startdate

string

上門取貨時間段:"yyyy-mm-dd

hh:mm:ss"格式化，本文中所有時間格式相同o

enddate

stringo

weight

double

包裹總重量kgo

quantity

int(2)

件數/包裹數o

volume

double

物品總體積m3o

remark

string(60)備註o

issendmessage

int(1)

是否訂閱簡訊：0-不需要；1-需要o

addservice(陣列形式)

addservice

name

string(20)

增值服務名稱o

value

string(30)

增值服務值o

customerid

string(30)

客戶標識(選填)o

commodity(陣列形式)

commodity

goodsname

string(100)

商品名稱o

goodscode

string(20)

商品編碼o

goodsquantity

int(5)件數o

goodsprice

double(10)

商品**o

goodsweight

double

商品重量kgo

goodsdesc

string(50)

商品描述o

goodsvol

double

商品體積m3o

返回引數定義：

引數名稱

型別說明

必須要求

ebusinessid

string

使用者idr

updatetime

string

更新時間

yyyy-mm-dd hh24:mm:ssr

success

bool

成功與否：true，falser

reason

string(50)

失敗原因o

estimateddeliverytime

string

訂單預計到貨時間yyyy-mm-dd（即將上線）o

三、示例

訂閱介面

請求示例 json

,"receiver":,

"commodity":}

返回示例 json

演示截圖：

物流跟蹤API 快遞單訂閱

物流快遞行業實名認證API

全國快遞物流查詢快遞單號查詢介面api

中通快遞單api查詢

物流跟蹤API 快遞單訂閱

物流 快遞行業實名認證API

全國快遞物流查詢 快遞單號查詢介面api

中通快遞單api查詢

相關推薦

物流快遞行業實名認證API

全國快遞物流查詢快遞單號查詢介面api