快遞鳥電子面單接口應用指南
Joker
來源:快遞鳥 · 2024-11-25 09:46:27
電子面單接口應用指南
一、 文檔目的
便于快遞鳥用戶理解電子面單接口作用并正確應用到實際場景。
二、 接口作用
用于向快遞/快運/物流公司下發訂單并獲取快遞單號,再打單發貨。
三、 應用場景
可應用于電商平臺、自營商城、ERP、打單工具、樓宇/物業收派系統、WMS倉儲系統、云打印、微信小程序/公眾號、APP、OA等需要發貨的場景。
四、 接口邏輯
說明:
1、 快遞鳥接口作為數據中轉站,不對數據內容做處理,只對數據字段做轉換;
2、 電子面單賬號密碼是否正確、地址是否可送達、單號是否充足、省市區詳細地址傳值是否規范等,由快遞公司接口做判斷,快遞鳥負責返回響應的結果(對響應失敗的結果內容做統一處理,返回更為方便理解的描述);
3、 返回的快遞單號號段,取決用戶充值單號時網點分配的單號號段,不需要充值單號的快遞公司,返回的號段由快遞公司自動分配。
五、 應用實例
1、 頁面前端的地址設計:省市區欄,系統上做成選擇項,由用戶選擇,不允許輸入,很大程度上保證地址規范性(省市區街道列表可在網上下載);
針對技術能力較強,希望更好提升客戶體驗的,可對地址做智能識別功能,識別出省市區信息,甚至包含聯系人和手機號碼。
2、 電子面單賬號保存:因各個快遞公司對電子面單賬號的傳值參數及字段數不一致,在用戶配置電子面單賬號密碼數據時,系統上只顯示需配置項,不顯示非配置項;
3、 電子面單模板:各快遞公司模板樣式、尺寸規格不一致,接入時每家快遞公司都需要調試。
間接打單用戶(平臺性/工具類用戶)
因其系統使用商家較多,同一模板無法滿足所有商家需求,推薦根據商家需求自行設計面單模板。
優勢:靈活性高,不受快遞鳥模板修改的影響,對商家體驗更好
劣勢:對用戶技術能力有一定要求
直接打單用戶(直接發貨商家)
A、 對模板無要求,快遞鳥接口返回的模板已能滿足的商家,可直接使用。
優勢:接入成本低,方便易用,可使用快遞鳥批量打印功能
劣勢:靈活性不高
B、 對模板有一定要求,快遞鳥接口返回的模板無法完全滿足的商家,可對返回的模板按自身需求進行處理,或自行設計面單模板。
對返回的模板按自身需求進行處理:
優勢:接入成本較低,方便快捷
劣勢:對用戶技術能力稍有技術要求
4、 打印控件:如果使用快遞鳥接口返回的面單模板,不做任何修改處理,可使用快遞鳥提供的批量打印功能;如果對模板有其他需求,需要處理返回的模板或者自己設計的模板,可使用第三方打印控件打印,如lodop等。
5、 打印機品牌:電子面單模板對打印機品牌、型號等沒有要求,只要是熱敏打印機即可,常見品牌如:斑馬、得力、快麥、漢印、佳博等。
相關產品推薦