一、接入前準備（TO商家業務人員）

1、申請快遞鳥用戶ID和API key

1.1 注冊快遞鳥賬號：http://www.kdniao.com/reg

1.2進入“我的會員中心”進行實名認證；

1.3認證成功后，進入“產品服務管理”，開通服務

2、申請順豐速運月結賬號

順豐月結賬號需要線下與當地順豐分部簽訂收派合同，簽定后順豐會提供10位數字的順豐月結賬號，用于發貨結算運費；

注：快遞鳥官網后臺顯示的信息和狀態（如：“我的物流服務商”頁面不顯示順豐或順豐月結賬號）并不影響接口的客戶，也不需要在后臺添加要使用的客戶號，直接通過接口傳值下單即可；

3、購買打印機、打印紙

打印機：

電子面單模板對打印機品牌、型號等沒有要求，只要是熱敏打印機即可，常見品牌如：斑馬、得力、快麥、漢印、佳博等。

打印機可由快遞網點提供或者在淘寶京東上購買，安裝打印機及驅動程序聯系打印機提供方；

打印紙：

順豐速運使用的打印紙有100mm*150mm（切點90/60）、100mm*180mm（切點110/70）、100mm*210mm（切點90/60/60）三種，打印紙可由快遞網點提供或者在淘寶京東上購買，購買時可選擇全白熱敏紙。

二、開發接入（TO商家技術開發人員）

1、下載最新快遞鳥技術文檔和對接攻略

下載地址：http://kdniao.com/documents

2、參照技術文檔開發

2.1 關于順豐月結賬號接口傳值

MonthCode傳值順豐月結賬號（PayType為1、2時不填，為3、4時必填），

PayType傳值付款方式（包含：1-現付，2-到付，3-月結，4-第三方付），

客戶號配置頁需留兩個欄位（需正確對應以上兩個字段）由發貨商家填寫，商家自己開發的系統也建議保留配置頁，萬一賬號更換了呢？

2.2 關于快遞類型

順豐速運快遞類型如下：

快遞類型	ExpType傳值
順豐標快	1
順豐特惠	2
電商特惠	3
四日件	4
順豐次晨	5
順豐即日	6
電商速配	7
醫藥常溫	11
醫藥溫控	12
物流普運	13
冷運到家	14
生鮮速配	15
大閘蟹專遞	16
汽配吉運	17
重貨快運	18
行郵專列	20
醫藥專運（常溫）	21
醫藥專運（溫控）	22
電商專配	28
即日2200	34
物資配送	35
匯票專送	36
證照專遞產品	110
順豐空配	112
專線普運	125
夜配	134
重貨包裹	154
小票零擔	155
醫藥常溫(陸)	195
醫藥快運	203

注：商家的順豐月結賬號是否能發對應的快遞類型，請事先和順豐速運分部人員確認，除1、2、5、6外，其他快遞類型都需單獨再簽協議。

2.3 關于順豐速運增值服務傳值

保價

字段傳值："AddService": [{"Name":"INSURE ","Value":"1000"}]

代收貨款

字段傳值："AddService":[{"Name":"COD","Value":"1000","CustomerID":"1234567891"}]

子母件

Quantity傳值大于等于2表示子母件，并且會返回對應的SubCount子單數量、SubOrders子單單號、SubPrintTemplates子單html模板；

簽回單

IsReturnSignBill傳1表示需要簽回單，并且會返回對應的SignBillPrintTemplate簽回單html模板，默認為0不需要；

OperateRequire表示回單操作要求(如：簽名、蓋章、身份證復印件等)；

預約快遞員上門

IsNotice表示是否通知快遞員上門攬件，0-通知，1-不通知，默認為1；

關于是否需要預約快遞員上門攬件：

1、如寄件點是全國各地不固定，需要快遞員上門攬件則預約（此類情況務必對預約用戶做限制，必須本人預約，通過手機驗證碼驗證成功后方可預約，不然會造成用戶惡意下單預約，導致順豐速運投訴）；

2、如是固定幾個地點發貨，且每天都需要發貨，可線下與快遞員協商定時定點定人上門攬件，接口上不需要預約；

3、如是固定地點發貨，只是偶爾發幾票，自己打印面單則隨機預約其中一個訂單，如需要快遞員打印則全部預約（快遞員是否能打印取決于順豐速運當地網點）；

注：如出現惡意預約，導致順豐速運向快遞鳥投訴超過3次的，快遞鳥將停用用戶此接口權限；

訂閱物流節點短信通知

物流節點短信包含：寄件短信、派件短信、簽收短信、問題件短信等；

字段傳值：IsSendMessage 0-不需要，1-需要

短信通知是收費服務，需聯系商務同事購買會員套餐或短信套餐后方可使用。

1、電子面單模板樣式

順豐速運模板共5個規格，具體如下

2二聯150(默認模板，TemplateSize傳值為空)

2三聯210(TemplateSize傳值210)

2二聯150新(TemplateSize傳值15001)

2二聯180新(TemplateSize傳值180)

2三聯210(TemplateSize傳值21001)

2、電子面單模板處理

用戶可根據自身的實際情況及未來發展的需要來決定是否需要接口返回模板（參數：IsReturnPrintTemplate 0-不需要，1-需要），推薦平臺/工具/ERP類用戶自行開發設計，直接發貨商家使用接口返回的模板，如有特殊需求可自行開發；

3.1 平臺性/工具/ERP類用戶

因其系統使用商家較多，同一模板無法滿足所有商家需求，推薦根據商家需求自行設計面單模板。

優勢：靈活性高，不受快遞鳥模板變動的影響，商家體驗更好

劣勢：對用戶技術能力有一定要求

3.2 直接發貨商家

A、對模板無要求，快遞鳥接口返回的模板已能滿足的商家，可直接使用。

優勢：接入成本低，方便易用，可使用快遞鳥批量打印功能

劣勢：靈活性不高

B、對模板有一定要求，快遞鳥接口返回的模板無法完全滿足的商家，可對返回的html模板報文進行處理，或自行設計面單模板樣式。

優勢：接入成本較低，方便快捷

劣勢：對用戶技術能力稍有要求

一、接口使用（TO商家系統操作人員）

使用過程中如遇到問題，先聯系公司內部技術人員排查，如需快遞鳥協助請讓技術人員聯系。

可能遇到的問題：

1、接口返回“校驗碼有誤”是什么原因？

答：快遞公司不支持的特殊字符：' " # & + % < >

請確認請求數據（包含收寄方姓名、電話、地址、商品名稱等所有訂單數據）中是否含有以上特殊字符；

2、電子面單下單返回結果false，錯誤碼106，訂單號已下單成功？

答：電子面單下單接口訂單號OrderCode不能重復使用，重復使用會報錯且返回的面單是此訂單號上次下單的內容；

3、電子面單返回“暫無打印模板”是什么原因？

答：默認的模板TemplateSize無需傳值，非默認模板傳對應模板尺寸，不可傳不存在的模板尺寸代碼；

4、電子面單生成后可以取消嗎？不發貨的話單號會作廢嗎？

答：下單成功后如不需要發貨，直接撕掉面單即可，不需要取消（如果一定要取消可對接”電子面單取消接口”），快遞員攬件后才收費，單號不收費；

5、調用電子面單時，接口返回“不可派送”？

答：不可派送表示派件地址不在順豐速運服務范圍，具體收派范圍可在順豐速運官網查看http://www.sf-express.com/cn/sc/dynamic_function/range/，可更換其他快遞發貨；

6、調用電子面單時，接口返回”您的預約超出今日營業時間，無法上門取件。”？

答：順豐速運每個區域每個分部上門取件的服務時間不固定，建議更換時間預約，一般預約9：00—17：00內；

總結

以上是生活随笔為你收集整理的开通电子面单账号 快速对接指南之顺丰速运 调用快递鸟API实现顺丰电子面单打印的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。