順豐速運快遞查詢接口API和電子面單接口怎麼對接？
除了通過順豐自己的接口對接外，用的最多的就是第三方通過快遞鳥對接了，通過順豐單號和手機號後四位查詢軌跡信息，如果是通過快遞鳥下單獲得的順豐單號，可通過單號直接查詢，具體下載快遞鳥接口技術文檔查看接口說明。ShipperCode爲SF，且快遞單號非快遞鳥渠道返回時，必填，對應收件人/寄件人手機號後四位；ShipperCode爲SF，且快遞單號爲快遞鳥渠道返回時，不填。
一、接入前準備（TO商家業務人員）
1、申請快遞鳥用戶ID和API key
1.1登錄快遞鳥註冊頁面註冊快遞鳥賬號；
1.2登錄快遞鳥用戶管理後臺，進入“我的會員中心”進行實名認證；
1.3認證成功後，進入“產品服務管理”，開通會員服務（可開通免費套餐測試）。
2、申請順豐速運月結賬號
順豐月結賬號需要線下與當地順豐分部簽訂收派合同，簽定後順豐會提供10位數字的順豐月結賬號，用於發貨結算運費；
注：獲取到的月結賬號不需要在快遞鳥官網後臺添加，直接通過接口傳值下單即可；
3、購買打印機、打印紙
3.1打印機：
電子面單模板對打印機品牌、型號等沒有要求，只要是熱敏打印機即可，常見品牌如：斑馬、得力、快麥、漢印、佳博等。
打印機可由快遞網點提供或者在淘寶京東上購買，安裝打印機及驅動程序聯繫打印機提供方；
3.2打印紙：
順豐速運使用的打印紙有100mm150mm（切點90/60）、100mm180mm（切點110/70）、100mm*210mm（切點90/60/60）三種，打印紙可由快遞網點提供或者在淘寶京東上購買，購買時可選擇全白熱敏紙。
二、開發接入（TO商家技術開發人員）
1、下載最新快遞鳥技術文檔和對接攻略
在技術QQ羣/快遞鳥官網http://kdniao.com/documents下載；
2、參照技術文檔開發
2.1 關於請求內容
以java爲例：
免費順豐快遞單號查詢電子面單api接口對接【快遞鳥API】
2.2關於順豐月結賬號接口傳值
MonthCode傳值順豐月結賬號（PayType爲1、2時不填，爲3、4時必填），
PayType傳值付款方式（包含：1-現付，2-到付，3-月結，4-第三方付），
客戶號配置頁需留兩個欄位（需正確對應以上兩個字段）由發貨商家填寫，商家自己開發的系統也建議保留配置頁，萬一賬號更換了呢？
2.3 關於快遞類型
順豐速運快遞類型如下：
快遞類型ExpType傳值
順丰標快1
順豐特惠2
電商特惠3
四日件4
順豐次晨5
順豐即日6
電商速配7
醫藥常溫11
醫藥溫控12
物流普運13
冷運到家14
生鮮速配15
大閘蟹專遞16
汽配吉運17
重貨快運18
行郵專列20
醫藥專運（常溫）21
醫藥專運（溫控）22
電商專配28
即日220034
物資配送35
匯票專送36
證照專遞產品110
順豐空配112
專線普運125
夜配134
重貨包裹154
小票零擔155
醫藥常溫(陸)195
順豐微小件202
醫藥快運203
陸運微小件204
特惠專配208
注：商家的順豐月結賬號是否能發對應的快遞類型，請事先和順豐速運分部人員確認，除1、2、5、6外，其他快遞類型都需單獨再籤協議。
2.4 關於順豐速運增值服務傳值
保價
字段傳值：“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-需要
短信通知是收費服務，需聯繫商務同事購買會員套餐或短信套餐後方可使用。
3、電子面單模板樣式
順豐速運模板共5個規格，具體如下
二聯150(默認模板，TemplateSize傳值爲空)
三聯210(TemplateSize傳值210)
二聯150新(TemplateSize傳值15001)
二聯180新(TemplateSize傳值180)
三聯210(TemplateSize傳值21001)
4、電子面單模板處理
用戶可根據自身的實際情況及未來發展的需要來決定是否需要接口返回模板（參數：IsReturnPrintTemplate 0-不需要，1-需要），推薦平臺/工具/ERP類用戶自行開發設計，直接發貨商家使用接口返回的模板，如有特殊需求可自行開發；
4.1 平臺性/工具/ERP類用戶
因其系統使用商家較多，同一模板無法滿足所有商家需求，推薦根據商家需求自行設計面單模板。
優勢：靈活性高，不受快遞鳥模板變動的影響，商家體驗更好
劣勢：對用戶技術能力有一定要求
4.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內；
順豐快遞單號查詢接口對接指南
目的
便於快遞鳥用戶理解快遞單號查詢接口作用並正確應用到實際場景。
接口作用
軌跡類接口包含：即時查詢接口和物流跟蹤接口。
即時查詢接口：實時查詢某個快遞單號當前的物流狀態；
物流跟蹤接口：監控某個快遞單號完整的物流狀態。
應用場景
可應用於電商平臺、自營商城、ERP、打單工具、樓宇/物業系統、雲打印、微信小程序/公衆號、APP、OA等需要查看物流信息的場景。
接口邏輯
說明：
快遞鳥接口作爲數據中轉站，不對物流信息做處理，不做語言轉換，只對數據字段做轉換，分析物流狀態；
快遞鳥接口返回的物流軌跡信息按照發生時間的升序排列。
應用方法：
接口返回物流信息後直接展示
優勢：方便簡單
劣勢：受網絡影響，響應較慢，用戶體驗欠佳
接口返回物流信息後保存在本地數據庫，當用戶查詢時調用本地數據再做展示
優勢：本地調用響應快，不受網絡影響，用戶體驗好
劣勢：需本地保存
應用實例
類似微信掃一掃查快遞，通過掃一掃功能掃描面單上的條碼跟蹤物流狀態（需結合快遞鳥單號識別接口使用）；——適用即時查詢接口
前端展示單號軌跡框，由用戶填寫單號後查詢對應物流信息（可結合快遞鳥單號識別接口使用）；——適用即時查詢接口
輸入順豐快遞單號，顯示可能屬於的快遞公司列表
選擇順豐快遞公司後，展示詳細的物流信息。
電商平臺、自營商城等展示訂單的物流信息，可監控平臺商家是否按時發貨；——適用物流跟蹤接口
APP上展示訂單流轉路徑；——適用物流跟蹤接口
發送物流節點短信通知；——適用物流跟蹤接口
數據報表；——適用物流跟蹤接口
物流體驗：分析每天快件狀態，統計攬收率、簽收率、問題件率等；——適用物流跟蹤接口
退貨險：平臺根據快件流轉的時間、攬件城市、簽收城市等數據判斷商家是否虛假退貨；——適用物流跟蹤接口
軌跡拼接：轉動公司/平臺，將海外訂單的物流信息和國內清關後的物流信息拼接在一起，方便買家查詢海淘訂單；——適用物流跟蹤接口
對接指南
1、登錄快遞鳥官網註冊頁面註冊快遞鳥賬號
網址：快遞單號查詢接口_電子面單_APIKey授權申請-快遞鳥賬號註冊
2、登錄快遞鳥用戶管理後臺
網址：用戶登錄_快遞鳥API讓物流接口對接更簡單
注：登錄快遞鳥用戶管理後臺後獲得用戶ID和APIKey，此用於保證應用來源的可靠性，避免應用僞造，被不法使用。
3、進入“我的會員中心”進行實名認證
注：
3.1、認證類型、應用類型根據用戶實際情況選擇即可，接口返回數據與選擇結果無關；
3.2、標記爲*的爲必填，要求上傳清晰、jpg格式且小於2M的證件圖片；
3.3、技術對接人信息爲用戶方對接工程師的信息；
3.4、如有其他疑問可進入官網加入商務合作羣進行諮詢。
4、認證成功後，進入“產品服務管理”，開通相關會員服務
注：
4.1、物流查詢（免費版）會員套餐爲免費版，有效期1年結束後，如在近3個月內有數據交互系統會自動免費續期；
4.2、如有其他疑問可進入官網加入商務合作羣進行諮詢。
5、開發對接
5.1、即時查詢（RequestType：1002/8001）
5.1.1、請求接口之前需要先實名認證，開通相關會員服務，否則會請求失敗並返回提示“未申請開通接口”；
5.1.2、接口開發可以下載“快遞鳥接口技術文檔”進行參考；即時查詢，參考技術文檔中的4.1或5.1.1部分；
5.1.3、接口開發可以下載“即時查詢demo”進行參考（僅提供了.NET、Java、PHP三種語言demo）；
5.1.4、查看快遞公司對應快遞鳥的編碼可以下載“2019快遞鳥接口支持快遞公司編碼列表.xlsx”。
5.1.5、接入過程中如有疑問請先參考快遞鳥官網常見問題進行解決（http://www.kdniao.com/help），也可以進入快遞鳥官網加入技術對接羣進行諮詢。
注：快遞鳥官網-幫助與文檔地址（快遞物流api接口文檔下載_電子面單接口文檔-快遞鳥code接口文檔 ）
快遞鳥API接口DEMO下載：快遞鳥「即時查詢DEMO」讓對接更簡單