順豐速運快遞查詢接口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群/快遞鳥官網下載下傳；
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」讓對接更簡單