一、接入前準備(to商家業務人員)
1、申請快遞鳥使用者id和api key
1.1登入快遞鳥官網註冊頁面註冊快遞鳥賬號;
1.2登入快遞鳥使用者管理後台,進入「我的會員中心」進行實名認證;
1.3認證成功後,進入「產品服務管理」,開通會員服務(可開通免費**測試)。
3、購買印表機、列印紙
3.1印表機:
電子面單模板對印表機品牌、型號等沒有要求,只要是熱敏印表機即可,常見品牌如:斑馬、得力、快麥、漢印、佳博等。
印表機可由快遞網點提供或者在**京東上購買,安裝印表機及驅動程式聯絡印表機提供方;
3.2列印紙:
申通快遞常用的列印紙是100mm*150mm(切點90/60)、100mm*180mm(切點110/70)、100mm*180mm(切點110/30/40),列印紙可由快遞網點提供或者在**京東上購買,購買時可選擇全白熱敏紙,建議結合自身業務需求和網點實際要求,再選購對應規格的熱敏紙。
3、參照技術文件開發
3.1 關於申通快遞客戶號介面傳值
customername傳值客戶簡稱,
customerpwd傳值客戶密碼,
sendsite傳值網點名稱(純漢字),
上述填寫的資訊,必須是申通快遞網點的梧桐系統裡面的顯示,如下圖標記:
客戶號配置頁需留三個字段(需正確對應以上三個字段)由發貨商家填寫,商家自己開發的系統也建議保留配置頁,萬一賬號更換了呢?
3.2 關於快遞業務型別
申通快遞業務型別如下
快遞型別exptype傳值
普通訂單1
3.3 關於申通增值服務傳值
訂閱物流節點簡訊通知
物流節點簡訊包含:寄件簡訊、派件簡訊、簽收簡訊、問題件簡訊等;
欄位傳值:issendmessage 0-不需要,1-需要
簡訊通知是收費服務,需聯絡商務同事購買會員**或簡訊**後方可使用。
4、電子面單模板樣式
申通模板共4個規格,具體如下
4.1二聯150(templatesize傳值150)
4.2二聯180(預設模板返回,templatesize為空)
4.3新二聯180(templatesize傳值180)
4.4三聯180(templatesize傳值18003)
5、電子面單模板處理
使用者可根據自身的實際情況及未來發展的需要來決定是否需要介面返回模板(引數:isreturnprinttemplate 0-不需要,1-需要),推薦平台/工具/erp類使用者自行開發設計,直接發貨商家使用介面返回的模板,如有特殊需求可自行開發;
5.1 平台性/工具/erp類使用者
因其系統使用商家較多,同一模板無法滿足所有商家需求,推薦根據商家需求自行設計面單模板。
優勢:靈活性高,不受快遞鳥模板變動的影響,商家體驗更好
劣勢:對使用者技術能力有一定要求
5.2 直接發貨商家
a、對模板無要求,快遞鳥介面返回的模板已能滿足的商家,可直接使用。
優勢:接入成本低,方便易用,可使用快遞鳥批量列印功能
劣勢:靈活性不高
b、對模板有一定要求,快遞鳥介面返回的模板無法完全滿足的商家,可對返回的html模板報文進行處理,或自行設計面單模板樣式。
優勢:接入成本較低,方便快捷
劣勢:對使用者技術能力稍有要求
2、介面返回「校驗碼有誤」是什麼原因?
答:快遞公司不支援的特殊字元:' " # & + % \ < >
請確認請求資料(包含收寄方姓名、**、位址、商品名稱等所有訂單資料)中是否含有以上特殊字元;
3、電子面單下單返回結果false,錯誤碼106,訂單號已下單成功?
答:電子面單下單介面訂單號ordercode不能重複使用,重複使用會報錯且返回的面單是此訂單號上次下單的內容;
4、電子面單返回「暫無列印模板」是什麼原因?
答:預設的模板templatesize無需傳值,非預設模板傳對應模板尺寸,不可傳值不存在的模板尺寸**;
5、電子面單生成後可以取消嗎?不發貨的話單號會作廢嗎?
答:快遞公司有單號**機制,未使用的單號會自動**。具體**規則請與快遞公司網點確認;
6、電子面單下單後返回"該客戶沒有開通電子面單服務!"或"密碼不正確!"?
答:電子面單客戶號其中某個數值錯誤導致,務必核實customername客戶簡稱、customerpwd客戶密碼和sendsite所屬網點,是否正確,並且在對應欄位傳值和充值足夠的單號;
python快遞鳥獲取中通面單
import requests import hashlib import base64 import json 請求url 正式位址 url 使用者id,快遞鳥提供,注意保管,不要洩漏 即使用者id,登入快遞鳥官網會員中心獲取 ebusinessid 1311064 api key,快遞鳥提供,注...
快遞鳥列印電子面單資料驗證不通過,非法引數
弄了半天沒弄出個所以然,想了下應該是加密的問題,除錯了下發現getip 獲取到的ip位址既不是本機的內網位址,也不是公司的外網位址,既然官方是判斷簽名後的資料跟傳遞過來的 datasign 是否一致,那有可能就是加密的時候我加密的ip不是外網位址,而快遞鳥加密的ip位址是公司外網位址,所以果斷把這個...
快遞鳥批量列印電子面單介面及控制項安裝
目前支援批量列印電子面單的有快遞鳥 菜鳥和快遞公司。但是快遞公司僅能列印本公司的電子面單,對於電商等發貨商來說不太適用,菜鳥教適合淘系商家,快遞鳥則比較通用,這裡介紹快遞鳥電子面單介面批量列印的方法 對接流程 快遞鳥 申請介面key 對接介面 除錯 上線使用 介面支援 順豐 sf ems ems 宅...