1、接入前準備（TO商家業務人員）
一、申請快遞鳥用戶ID和API key
1.1登陸快遞鳥官網註冊頁面http://www.kdniao.com/reg註冊快遞鳥帳號；
1.2登陸快遞鳥用戶管理後臺，進入「個人會員中心」進行實名認證；
1.3認證成功後，進入「產品服務管理」，開通會員服務（可開通免費套餐測試）。html
二、韻達速遞申請電子面單客戶號
申請客戶號有如下兩種方式，互不衝突，任選其一便可；（不支持菜鳥、京東、拼多多電子面單客戶號）；
2.1線下與當地韻達網點簽定合做協議，並申請韻達自有電子面單客戶號；
2.2在快遞鳥官網申請，申請路徑：用戶管理後臺——電子面單——申請新的物流服務商——申請韻達快遞——填寫信息後提交，待快遞公司總部審覈經過後（通常在2-3個工做日審覈經過，如長時間未審覈，建議直接聯繫網點催促審覈或進行線下申請），會有短信通知到申請人手機號上，使用前需聯繫網點充值單號。
2.3網點開通客戶號操做流程見下圖：
注：獲取到的電子面單客戶號不須要在快遞鳥官網後臺添加，直接經過接口傳值下單便可；java
三、購買打印機、打印紙
3.1打印機：
電子面單模板對打印機品牌、型號等沒有要求，只要是熱敏打印機便可，常見品牌如：斑馬、得力、快麥、漢印、佳博等。
打印機可由快遞網點提供或者在淘寶京東上購買，安裝打印機及驅動程序聯繫打印機提供方；
3.2打印紙：
韻達快遞使用的打印紙分別是100mm*180mm（切點110/70），100mm*203mm（切點152/51），打印紙可由快遞網點提供或者在淘寶京東上購買，購買時可選擇全白熱敏紙。工具
2、開發接入（TO商家技術開發人員）
一、下載最新快遞鳥技術文檔和對接攻略
在技術QQ羣/快遞鳥官網http://kdniao.com/documents下載；
二、參考技術文檔開發
2.1 關於請求內容
以java爲例：
測試
2.2關於韻達客戶號接口傳值
CustomerName傳值客戶ID
CustomerPwd傳值接口聯調密碼
客戶號配置頁需留兩個欄位（需正確對應以上兩個字段）由發貨商家填寫，商家本身開發的系統也建議保留配置頁，萬一帳號更換了呢？設計
2.3 關於快遞類型
韻達快遞類型以下
快遞類型 ExpType傳值
普通訂單 1htm
2.4關於韻達增值服務傳值
代收貨款（使用代收貨款須要聯繫網點充值代收面單方可以使用）
字段傳值："AddService": [{"Name":"COD","Value":"1000"}]
訂閱物流節點短信通知
物流節點短信包含：寄件短信、派件短信、簽收短信、問題件短信等；
字段傳值：IsSendMessage 0-不須要，1-須要
短信通知是收費服務，需聯繫商務同事購買會員套餐或短信套餐後方可以使用。接口
三、電子面單模板樣式
韻達快遞模板共2個規格，具體以下
二聯203（默認模板，TemplateSize傳值爲空）：
二聯180（TemplateSize傳值180）：
開發
四、電子面單模板處理
用戶可根據自身的實際狀況及將來發展的須要來決定是否須要接口返回模板【參數：IsReturnPrintTemplate 0-不須要，1-須要（默認不返回）】，推薦平臺/工具/ERP類用戶自行開發設計，直接發貨商家使用接口返回的模板，若有特殊需求可自行開發；
4.1 平臺性/工具/ERP類用戶
因其系統使用商家較多，同一模板沒法知足全部商家需求，推薦根據商家需求自行設計面單模板。
優點：靈活性高，不受快遞鳥模板變更的影響，商家體驗更好
劣勢：對用戶技術能力有必定要求
4.2 直接發貨商家
A、對模板無要求，快遞鳥接口返回的模板已能知足的商家，可直接使用。
優點：接入成本低，方便易用，可以使用快遞鳥批量打印功能
劣勢：靈活性不高
B、對模板有必定要求，快遞鳥接口返回的模板沒法徹底知足的商家，可對返回的html模板報文進行處理，或自行設計面單模板樣式。
優點：接入成本較低，方便快捷
劣勢：對用戶技術能力稍有要求文檔
3、接口使用（TO商家系統操做人員）
使用過程當中如遇到問題，先聯繫公司內部技術人員排查，如需快遞鳥協助請讓技術人員聯繫。
可能遇到的問題：
一、接口返回「校驗碼有誤」是什麼緣由？
答：快遞公司不支持的特殊字符：' " # & + % \ < >
請確認請求數據（包含收寄方姓名、電話、地址、商品名稱等全部訂單數據）中是否含有以上特殊字符；產品
二、電子面單下單返回結果false，錯誤碼106，訂單號已下單成功？
答：電子面單下單接口訂單號OrderCode不能重複使用，重複使用會報錯且返回的面單是此訂單號上次下單的內容；
三、電子面單返回「暫無打印模板」是什麼緣由？
答：默認的模板TemplateSize無需傳值，非默認模板傳對應模板尺寸，不可傳值不存在的模板尺寸代碼；
四、電子面單生成後能夠取消嗎？不發貨的話單號會做廢嗎？
答：韻達支持經過電子面單取消接口進行取消，同時快遞公司有單號回收機制，未使用的單號會自動回收。具體回收規則請與快遞公司網點確認；
五、電子面單接口測試環境順豐、韻達的能夠測通，像申通、安能、宅急送等測試報錯是什麼緣由？
答：測試環境是由快遞公司維護，常常調整會不穩定甚至不可用，正式環境能夠正常
使用。測試環境是提供給用戶調通接口的，全部快遞公司的邏輯同樣，只要一家調通
接口就沒有問題了，測試的話您試下順豐、EMS就好哈
六、韻達電子面單接口下單返回「錯誤：合做方ID不存在」或者"錯誤：簽名不正確」是什麼意思？
答：韻達下單報這個錯，是電子面單帳戶異常，須要聯繫網點拿到正確的客戶ID和接口聯調密碼。
正確樣式如：
七、韻達電子面單接口沒法返回集包地或者下單報錯【反序列化】？
答：是您的電子面單帳號配置有問題，用戶若是首次申請帳號時候沒有選擇訂單來源：
快遞鳥，下單不會返回集包地，網點沒法直接從新配置，只能聯繫快遞公司總部去修
改，快遞公司總部聯繫電話：4008209669轉1轉2，改爲明文便可。
八、韻達電子面單下單成功後模板顯示亂碼？ 答：是您的電子面單帳號配置問題，請聯繫網點從新配置，或聯繫快遞公司總部修 改，快遞公司總部聯繫電話：4008209669轉1轉2，改爲明文便可。