【正文】 省”）CityNameStringR收件市（如深圳市，不要缺少“市”）ExpAreaNameStringO收件區(qū)（如福田區(qū)，不要缺少“區(qū)”或“縣”）AddressStringR收件人詳細(xì)地址SenderCompanyStringO發(fā)件人公司NameStringR發(fā)件人TelStringR電話與手機(jī)，必填一個MobileStringPostCodeStringO發(fā)件人郵編ProvinceNameStringO發(fā)件省（如廣東省，不要缺少“省”）CityNameStringR發(fā)件市（如深圳市，不要缺少“市”）ExpAreaNameStringO發(fā)件區(qū)（如福田區(qū)，不要缺少“區(qū)”或“縣”）AddressStringR發(fā)件詳細(xì)地址StartDateStringO上門取貨時間段:yyyyMMdd HH:mm:ss格式化，本文中所有時間格式相同EndDateStringOWeightDoubleO物品總重量kgQuantityIntO件數(shù)/包裹數(shù)VolumeDoubleO物品總體積m3RemarkStringO備注AddServiceNameString0增值服務(wù)名稱ValueString0增值服務(wù)值CustomerIDString0客戶標(biāo)識(選填)CommodityGoodsNameStringR商品名稱GoodsCodeStringO商品編碼GoodsquantityIntO件數(shù)GoodsPriceDoubleO商品價格GoodsWeightDoubleO商品重量kgGoodsDescStringO商品描述GoodsVolDoubleO商品體積m3EBusinessIDStringR電商IDRequestTypeStringR請求指令類型：1001DataSignStringR數(shù)據(jù)內(nèi)容簽名DataTypeStringR請求、返回數(shù)據(jù)類型：2json； 返回結(jié)果參數(shù)參數(shù)名稱類型必須要求說明EBusinessIDStringR電商用戶IDOrderOrderCodeStringR訂單編號ShipperCodeStringR快遞公司編碼LogisticCodeStringO快遞單號SuccessBoolR成功與否ResultCodeStringR結(jié)果編號ReasonStringO失敗原因UniquerRequestNumberStringR唯一標(biāo)識 Json請求示例{ OrderCode: 012657018199, ShipperCode: SF, PayType: 1, MonthCode: 7553045845, ExpType: 1, Cost: , OtherCost: , Sender: { Company: LV, Name: Taylor, Mobile: 15018442396, ProvinceName: 上海, CityName: 上海, ExpAreaName: 青浦區(qū), Address: 明珠路 }, Receiver: { Company: GCCUI, Name: Yann, Mobile: 15018442396, ProvinceName: 北京, CityName: 北京, ExpAreaName: 朝陽區(qū), Address: 三里屯街道 }, Commodity: [ { GoodsName: 鞋子, Goodsquantity: 1, GoodsWeight: } ], AddService: [ { Name: COD, Value: 1020 } ], Weight: , Quantity: 1, Volume: , Remark: 小心輕放} Json請求返回示例{ EBusinessID: 1237100, Success: true, Order: { OrderCode: 012657018199, ShipperCode : SF , LogisticCode : }, ResultCode: 100, Reason: } 電子面單 功能說明電子面單接口是快遞鳥提供給獨立電商、倉儲管理系統(tǒng)、物流供應(yīng)鏈等物流系統(tǒng)平臺使用的下單接口，滿足客戶在線發(fā)貨需求并提供打印面單的服務(wù)，客戶通過網(wǎng)絡(luò)選擇物流公司發(fā)送請求通知貴公司有快遞要發(fā)貨，貴公司把數(shù)據(jù)通過此接口轉(zhuǎn)發(fā)到快遞鳥，由快遞鳥為您通知對應(yīng)的快遞公司快遞員上門取件。只支持POST請求方式，utf8編碼。 (2)、目前預(yù)約取件接口支持了：德邦、EMS、天地華宇、百世快遞、京東、龍邦快遞、順豐快遞、中通速遞、韻達(dá)快遞、圓通速遞、宅急送，后續(xù)更多的快遞公司正在對接中。}3 下單 預(yù)約取件接口 功能說明 預(yù)約取件接口是快遞鳥提供給獨立電商、倉儲管理系統(tǒng)、物流供應(yīng)鏈等物流系統(tǒng)平臺使用的下單接口，為客戶解決在線發(fā)貨需求，客戶通過網(wǎng)絡(luò)選擇快遞公司發(fā)送請求通知貴公司有快遞要發(fā)貨，貴公司把數(shù)據(jù)通過此接口轉(zhuǎn)發(fā)到快遞鳥，由快遞鳥為您提供通知快遞員上門取件的服務(wù)。}catch {throw。else ret += (X)。string ret = 。 check = new ()。}///summary/// 字符串MD5加密////summary///param name=Text要加密的字符串/param///returns密文/returnsPrivate string MD5(string Text, string charset){byte[] buffer = (charset).GetBytes(Text)。 (C)DataSign簽名加密代碼///summary///電商Sign簽名////summary///param name=content內(nèi)容/param///param name=keyValueAppkey/param///param name=charsetURL編碼 /param///returnsDataSign簽名/returnsPublic String Encrypt (String content, String keyValue, String charset){if (keyValue != null){return base64(MD5(content + keyValue, charset), charset)。 DataType=2(c) 接收方收到數(shù)據(jù)后，獲得EBusinessID 和RequestData和DataSign等這幾個數(shù)據(jù)。RequestData =%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d amp。}56da2cf8c8a244b2b6fa476cd7d1ba17，經(jīng)過md5和base64后的內(nèi)容就為OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE=，在經(jīng)過URL(UTF8)編碼的內(nèi)容為OWFhM2I5N2ViM2U2MGRkMjc4YzU2NmVlZWI3ZDk0MmE%3d最終要發(fā)送的數(shù)據(jù)為RequestType=1002amp。:39。,39。:39。,39。:39。注：請勿遺漏或傳遞可能遞增大快遞鳥接口調(diào)用維護(hù)舉例說明：(a) 假設(shè)RequestData (JSON)內(nèi)容為： {“OrderCode”:””,“ShipperCode”:”SF”,”LogisticCode”: 118954907573}經(jīng)過URL(UTF8)編碼的內(nèi)容為%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d， EBusinessID為1109259，AppKey為56da2cf8c8a244b2b6fa476cd7d1ba17(b) 那么DataSign簽名的內(nèi)容為{39。// 通訊協(xié)議使用Http協(xié)議Post請求方式 流程示意圖 網(wǎng)關(guān)地址測試接口：:8081/Ebusiness/測試電商ID==1237100，AppKey==518a73d81f7f441ab64433e77b49d846正式接口： 簽名說明 關(guān)于簽名快遞鳥和第三方電子商務(wù)公司系統(tǒng)進(jìn)行對接，有一定的安全機(jī)制。DataType=DataType。RequestData=jsonStr amp。//把(jsonStr+AppKey)進(jìn)行MD5加密，然后Base64編碼，最后 進(jìn)行URL(utf8)編碼string PostStr = RequestType=1002amp。//字符編碼采用UTF8string jsonStr= {\OrderCode\:\\,\ShipperCode\:\SF\,\LogisticCode\:\118461988807\}。 //請求地址 string DataType = 2。 string keyValue = 56da2cf8c8a244b2b6fa476cd7d1ba17。提交接入處理的相關(guān)代碼如有不明白的地方可與快遞鳥物流技術(shù)接口人協(xié)作開發(fā)。(1) 開發(fā)服務(wù)開發(fā)自身業(yè)務(wù)的服務(wù)，服務(wù)需遵循接口的定義規(guī)則。兩者關(guān)系類似于登錄帳號和密碼，兩者都會在簽名和業(yè)務(wù)參數(shù)中使用。按照快遞鳥官網(wǎng)提示進(jìn)行注冊申請，注冊成功后登錄用戶管理后臺，您將得到由快遞鳥提供的一組商戶ID和API Key。 接入步驟 注冊成為快遞鳥用戶(注：注冊成功后進(jìn)行實名認(rèn)證，申請開通接口，后續(xù)會再對用戶的注冊信息進(jìn)行審批)。 接口規(guī)范及說明 報文及報文編碼 Json格式。2 概述 用戶使用流程圖快遞鳥API全流程服務(wù)（電商）流程圖基于電商現(xiàn)有的服務(wù)流程，快遞鳥為電商、電商平臺、ERP系統(tǒng)、倉儲系統(tǒng)等系統(tǒng)在用戶下單、選擇物流、下單、打單、軌跡跟蹤等關(guān)鍵節(jié)點，均提供了專業(yè)、高效的API接口，方便各個平臺實現(xiàn)一次接入，便可使用國內(nèi)外主流物理公司的服務(wù)。A 81 電子面單模板規(guī)格 81 返回編碼列表 8310 技術(shù)支持 831 前言 快遞鳥API旨在為電商、電商平臺、物流工具、倉儲系統(tǒng)等等系統(tǒng)提供專業(yè)、穩(wěn)定、優(yōu)質(zhì)的物流服務(wù)，為不同的用戶量身定做了專業(yè)的API接口服務(wù)，供不同的用戶各取所需?？爝f鳥接口(API)技術(shù)文檔版本日期版本說明作者20141201重新整理，根據(jù)功能分類，部分有調(diào)整楊文勝20140111對接口的說明進(jìn)行了注釋，提高可讀性楊漢汶20140113新增推送接口楊漢汶20150311新增批量訂閱推送接口，楊文勝20151012新增訂單分發(fā)接口，整理電子面單接口曹強(qiáng)20160119重新調(diào)整在線下單接口曹強(qiáng)20160301增加智選物流接口曹強(qiáng)20160301分發(fā)及訂閱接口更新任海洋20160407推送接口更新任海洋20160511電子面單新增通知快遞員上門字段，推送接口新增貨款狀態(tài)推送詹益?zhèn)?0160701，新增單號識別接口、智選物流接口、更新物流軌跡接口（訂閱查詢）詹益?zhèn)?016926推送接口新增DataSign字段、智選物流接口新增字段胡蕾蕾20161103新增在途監(jiān)控（增值服務(wù)）曹強(qiáng)20161213電子面單新增第三方訂單號ThrOrderCode胡蕾蕾2017110新增隱私快遞胡蕾蕾2017216新增代收貨款業(yè)務(wù)胡蕾蕾2017413即時查詢接口中軌跡狀態(tài)新增0無軌跡 普通回調(diào)接口中刪除201狀態(tài)修改智選物流接口文檔電子面單接口添加特殊字符提示陳愛2017425 新增申請電子面單客戶號接口 新增電