一、接入前準(zhǔn)備（TO商家業(yè)務(wù)人員）

1、申請(qǐng)快遞鳥(niǎo)用戶(hù)ID和API key

1.1 注冊(cè)快遞鳥(niǎo)賬號(hào)：http://www.kdniao.com/reg

1.2進(jìn)入“我的會(huì)員中心”進(jìn)行實(shí)名認(rèn)證；

1.3認(rèn)證成功后，進(jìn)入“產(chǎn)品服務(wù)管理”，開(kāi)通服務(wù)

2、申請(qǐng)順豐速運(yùn)月結(jié)賬號(hào)

順豐月結(jié)賬號(hào)需要線下與當(dāng)?shù)仨権S分部簽訂收派合同，簽定后順豐會(huì)提供10位數(shù)字的順豐月結(jié)賬號(hào)，用于發(fā)貨結(jié)算運(yùn)費(fèi)；

注：快遞鳥(niǎo)官網(wǎng)后臺(tái)顯示的信息和狀態(tài)（如：“我的物流服務(wù)商”頁(yè)面不顯示順豐或順豐月結(jié)賬號(hào)）并不影響接口的客戶(hù)，也不需要在后臺(tái)添加要使用的客戶(hù)號(hào)，直接通過(guò)接口傳值下單即可；

3、購(gòu)買(mǎi)打印機(jī)、打印紙

打印機(jī)：

電子面單模板對(duì)打印機(jī)品牌、型號(hào)等沒(méi)有要求，只要是熱敏打印機(jī)即可，常見(jiàn)品牌如：斑馬、得力、快麥、漢印、佳博等。

打印機(jī)可由快遞網(wǎng)點(diǎn)提供或者在淘寶京東上購(gòu)買(mǎi)，安裝打印機(jī)及驅(qū)動(dòng)程序聯(lián)系打印機(jī)提供方；

打印紙：

順豐速運(yùn)使用的打印紙有100mm*150mm（切點(diǎn)90/60）、100mm*180mm（切點(diǎn)110/70）、100mm*210mm（切點(diǎn)90/60/60）三種，打印紙可由快遞網(wǎng)點(diǎn)提供或者在淘寶京東上購(gòu)買(mǎi)，購(gòu)買(mǎi)時(shí)可選擇全白熱敏紙。

二、開(kāi)發(fā)接入（TO商家技術(shù)開(kāi)發(fā)人員）

1、下載最新快遞鳥(niǎo)技術(shù)文檔和對(duì)接攻略

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

2、參照技術(shù)文檔開(kāi)發(fā)

2.1 關(guān)于順豐月結(jié)賬號(hào)接口傳值

MonthCode傳值順豐月結(jié)賬號(hào)（PayType為1、2時(shí)不填，為3、4時(shí)必填），

PayType傳值付款方式（包含：1-現(xiàn)付，2-到付，3-月結(jié)，4-第三方付），

客戶(hù)號(hào)配置頁(yè)需留兩個(gè)欄位（需正確對(duì)應(yīng)以上兩個(gè)字段）由發(fā)貨商家填寫(xiě)，商家自己開(kāi)發(fā)的系統(tǒng)也建議保留配置頁(yè)，萬(wàn)一賬號(hào)更換了呢？

2.2 關(guān)于快遞類(lèi)型

順豐速運(yùn)快遞類(lèi)型如下：

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

注：商家的順豐月結(jié)賬號(hào)是否能發(fā)對(duì)應(yīng)的快遞類(lèi)型，請(qǐng)事先和順豐速運(yùn)分部人員確認(rèn)，除1、2、5、6外，其他快遞類(lèi)型都需單獨(dú)再簽協(xié)議。

2.3 關(guān)于順豐速運(yùn)增值服務(wù)傳值

保價(jià)

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

代收貨款

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

子母件

Quantity傳值大于等于2表示子母件，并且會(huì)返回對(duì)應(yīng)的SubCount子單數(shù)量、SubOrders子單單號(hào)、SubPrintTemplates子單html模板；

簽回單

IsReturnSignBill傳1表示需要簽回單，并且會(huì)返回對(duì)應(yīng)的SignBillPrintTemplate簽回單html模板，默認(rèn)為0不需要；

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

預(yù)約快遞員上門(mén)

IsNotice表示是否通知快遞員上門(mén)攬件，0-通知，1-不通知，默認(rèn)為1；

關(guān)于是否需要預(yù)約快遞員上門(mén)攬件：

1、如寄件點(diǎn)是全國(guó)各地不固定，需要快遞員上門(mén)攬件則預(yù)約（此類(lèi)情況務(wù)必對(duì)預(yù)約用戶(hù)做限制，必須本人預(yù)約，通過(guò)手機(jī)驗(yàn)證碼驗(yàn)證成功后方可預(yù)約，不然會(huì)造成用戶(hù)惡意下單預(yù)約，導(dǎo)致順豐速運(yùn)投訴）；

2、如是固定幾個(gè)地點(diǎn)發(fā)貨，且每天都需要發(fā)貨，可線下與快遞員協(xié)商定時(shí)定點(diǎn)定人上門(mén)攬件，接口上不需要預(yù)約；

3、如是固定地點(diǎn)發(fā)貨，只是偶爾發(fā)幾票，自己打印面單則隨機(jī)預(yù)約其中一個(gè)訂單，如需要快遞員打印則全部預(yù)約（快遞員是否能打印取決于順豐速運(yùn)當(dāng)?shù)鼐W(wǎng)點(diǎn)）；

注：如出現(xiàn)惡意預(yù)約，導(dǎo)致順豐速運(yùn)向快遞鳥(niǎo)投訴超過(guò)3次的，快遞鳥(niǎo)將停用用戶(hù)此接口權(quán)限；

訂閱物流節(jié)點(diǎn)短信通知

物流節(jié)點(diǎn)短信包含：寄件短信、派件短信、簽收短信、問(wèn)題件短信等；

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

短信通知是收費(fèi)服務(wù)，需聯(lián)系商務(wù)同事購(gòu)買(mǎi)會(huì)員套餐或短信套餐后方可使用。

1、電子面單模板樣式

順豐速運(yùn)模板共5個(gè)規(guī)格，具體如下

2二聯(lián)150(默認(rèn)模板，TemplateSize傳值為空)

2三聯(lián)210(TemplateSize傳值210)

2二聯(lián)150新(TemplateSize傳值15001)

2二聯(lián)180新(TemplateSize傳值180)

2三聯(lián)210(TemplateSize傳值21001)

2、電子面單模板處理

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

3.1 平臺(tái)性/工具/ERP類(lèi)用戶(hù)

因其系統(tǒng)使用商家較多，同一模板無(wú)法滿(mǎn)足所有商家需求，推薦根據(jù)商家需求自行設(shè)計(jì)面單模板。

優(yōu)勢(shì)：靈活性高，不受快遞鳥(niǎo)模板變動(dòng)的影響，商家體驗(yàn)更好

劣勢(shì)：對(duì)用戶(hù)技術(shù)能力有一定要求

3.2 直接發(fā)貨商家

A、對(duì)模板無(wú)要求，快遞鳥(niǎo)接口返回的模板已能滿(mǎn)足的商家，可直接使用。

優(yōu)勢(shì)：接入成本低，方便易用，可使用快遞鳥(niǎo)批量打印功能

劣勢(shì)：靈活性不高

B、對(duì)模板有一定要求，快遞鳥(niǎo)接口返回的模板無(wú)法完全滿(mǎn)足的商家，可對(duì)返回的html模板報(bào)文進(jìn)行處理，或自行設(shè)計(jì)面單模板樣式。

優(yōu)勢(shì)：接入成本較低，方便快捷

劣勢(shì)：對(duì)用戶(hù)技術(shù)能力稍有要求

一、接口使用（TO商家系統(tǒng)操作人員）

使用過(guò)程中如遇到問(wèn)題，先聯(lián)系公司內(nèi)部技術(shù)人員排查，如需快遞鳥(niǎo)協(xié)助請(qǐng)讓技術(shù)人員聯(lián)系。

可能遇到的問(wèn)題：

1、接口返回“校驗(yàn)碼有誤”是什么原因？

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

請(qǐng)確認(rèn)請(qǐng)求數(shù)據(jù)（包含收寄方姓名、電話、地址、商品名稱(chēng)等所有訂單數(shù)據(jù)）中是否含有以上特殊字符；

2、電子面單下單返回結(jié)果false，錯(cuò)誤碼106，訂單號(hào)已下單成功？

答：電子面單下單接口訂單號(hào)OrderCode不能重復(fù)使用，重復(fù)使用會(huì)報(bào)錯(cuò)且返回的面單是此訂單號(hào)上次下單的內(nèi)容；

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

答：默認(rèn)的模板TemplateSize無(wú)需傳值，非默認(rèn)模板傳對(duì)應(yīng)模板尺寸，不可傳不存在的模板尺寸代碼；

4、電子面單生成后可以取消嗎？不發(fā)貨的話單號(hào)會(huì)作廢嗎？

答：下單成功后如不需要發(fā)貨，直接撕掉面單即可，不需要取消（如果一定要取消可對(duì)接”電子面單取消接口”），快遞員攬件后才收費(fèi)，單號(hào)不收費(fèi)；

5、調(diào)用電子面單時(shí)，接口返回“不可派送”？

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

6、調(diào)用電子面單時(shí)，接口返回”您的預(yù)約超出今日營(yíng)業(yè)時(shí)間，無(wú)法上門(mén)取件。”？

答：順豐速運(yùn)每個(gè)區(qū)域每個(gè)分部上門(mén)取件的服務(wù)時(shí)間不固定，建議更換時(shí)間預(yù)約，一般預(yù)約9：00—17：00內(nèi)；

總結(jié)

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

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。