【正文】 ameStringO電子面單客戶賬號(hào)（與快遞網(wǎng)點(diǎn)申請(qǐng)或通過(guò)快遞鳥官網(wǎng)申請(qǐng)或通過(guò)申請(qǐng)電子面單客戶號(hào)申請(qǐng)）CustomerPwdStringO電子面單密碼SendSiteStringO收件網(wǎng)點(diǎn)標(biāo)識(shí)ShipperCodeStringR快遞公司編碼LogisticCodeStringO快遞單號(hào)ThrOrderCodeStringO第三方訂單號(hào)OrderCodeStringR訂單編號(hào)MonthCodeStringC月結(jié)編碼PayTypeIntR郵費(fèi)支付方式:1現(xiàn)付，2到付，3月結(jié)，4第三方支付ExpTypeStringR快遞類型：1標(biāo)準(zhǔn)快件IsNoticeIntO是否通知快遞員上門攬件：0通知；1不通知；不填則默認(rèn)為1CostDoubleO寄件費(fèi)（運(yùn)費(fèi)）OtherCostDoubleO其他費(fèi)用ReceiverCompanyStringO收件人公司NameStringR收件人TelStringR電話與手機(jī)，必填一個(gè)MobileStringPostCodeStringO收件人郵編ProvinceNameStringR收件?。ㄈ鐝V東省，不要缺少“省”）CityNameStringR收件市（如深圳市，不要缺少“市”）ExpAreaNameStringO收件區(qū)（如福田區(qū)，不要缺少“區(qū)”或“縣”）AddressStringR收件人詳細(xì)地址SenderCompanyStringO發(fā)件人公司NameStringR發(fā)件人TelStringR電話與手機(jī)，必填一個(gè)MobileStringPostCodeStringO發(fā)件人郵編ProvinceNameStringR發(fā)件?。ㄈ鐝V東省，不要缺少“省”）CityNameStringR發(fā)件市（如深圳市，不要缺少“市”）ExpAreaNameStringO發(fā)件區(qū)（如福田區(qū)，不要缺少“區(qū)”或“縣”）AddressStringR發(fā)件詳細(xì)地址StartDateStringO上門取貨時(shí)間段:yyyyMMdd HH:mm:ss格式化，本文中所有時(shí)間格式相同EndDateStringOWeightDoubleO物品總重量kgQuantityIntO件數(shù)/包裹數(shù)VolumeDoubleO物品總體積m3RemarkStringO備注AddServiceNameString0增值服務(wù)名稱ValueString0增值服務(wù)值CustomerIDString0客戶標(biāo)識(shí)(選填)CommodityGoodsNameStringR商品名稱GoodsCodeStringO商品編碼GoodsquantityIntO件數(shù)GoodsPriceDoubleO商品價(jià)格GoodsWeightDoubleO商品重量kgGoodsDescStringO商品描述GoodsVolDoubleO商品體積m3IsReturnPrintTemplateStringO返回電子面單模板：0不需要；1需要IsSendMessageIntO是否訂閱短信0不需要；1需要TemplateSizeStringO模板尺寸EBusinessIDStringR商戶IDRequestTypeStringR請(qǐng)求指令類型：1007DataSignStringR數(shù)據(jù)內(nèi)容簽名DataTypeStringR請(qǐng)求、返回?cái)?shù)據(jù)類型： 2json 返回結(jié)果參數(shù)l 同步返回參數(shù)名稱類型必須要求說(shuō)明EBusinessIDStringR電商用戶IDOrderOrderCodeStringR訂單編號(hào)ShipperCodeStringR快遞公司編碼LogisticCodeStringR快遞單號(hào)MarkDestinationStringO大頭筆OriginCodeStringO始發(fā)地區(qū)域編碼OriginNameStringO始發(fā)地/始發(fā)網(wǎng)點(diǎn)DestinatioCodeStringO目的地區(qū)域編碼DestinatioNameStringO目的地/到達(dá)網(wǎng)點(diǎn)SortingCodeStringO分揀編碼PackageCodeStringO集包編碼SuccessBoolR成功與否ResultCodeStringR錯(cuò)誤編碼ReasonStringO失敗原因UniquerRequestNumberStringR唯一標(biāo)識(shí)PrintTemplateStringO面單打印模板EstimatedDeliveryTimeStringO訂單預(yù)計(jì)到貨時(shí)間yyyymmddCallbackStringO用戶自定義回調(diào)信息SubCountIntO子單數(shù)量SubOrdersStringO子單號(hào)SubPrintTemplatesStringO子單模板ReceiverSafePhoneStringO收件人安全電話SenderSafePhoneString0寄件人安全電話DialPageStringR撥號(hào)頁(yè)面網(wǎng)址（轉(zhuǎn)換成二維碼可掃描撥號(hào)） 電子面單余量查詢接口 功能說(shuō)明用戶查詢客戶號(hào)在快遞公司的單號(hào)剩余量。(3)、目前接口支持了：順豐（SF）、EMS（EMS）、宅急送（ZJS）、圓通（YTO）、百世快遞（HTKY）、中通（ZTO）、韻達(dá)（YD）、申通（STO）、德邦（DBL）、優(yōu)速（UC）、京東（JD）、信豐（XFEX）、全峰（QFKD）、跨越速運(yùn)（KYSY）、安能小包（ANE）、快捷快遞（FAST）、國(guó)通（GTO）、天天快遞（HHTT）、郵政快遞包裹（YZPY），后續(xù)更多的快遞公司正在對(duì)接中。同時(shí)若客戶使用代收貨款服務(wù)，快遞鳥會(huì)將代收貨款的貨款狀態(tài)獨(dú)立推送給用戶。只支持POST請(qǐng)求方式，utf8編碼。}3 下單 預(yù)約取件接口 功能說(shuō)明 預(yù)約取件接口是快遞鳥提供給獨(dú)立電商、倉(cāng)儲(chǔ)管理系統(tǒng)、物流供應(yīng)鏈等物流系統(tǒng)平臺(tái)使用的下單接口，為客戶解決在線發(fā)貨需求，客戶通過(guò)網(wǎng)絡(luò)選擇快遞公司發(fā)送請(qǐng)求通知貴公司有快遞要發(fā)貨，貴公司把數(shù)據(jù)通過(guò)此接口轉(zhuǎn)發(fā)到快遞鳥，由快遞鳥為您提供通知快遞員上門取件的服務(wù)。else ret += (X)。 check = new ()。 (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)。RequestData =%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27SF%27%2c%27LogisticCode%27%3a%27118954907573%27%7d amp。:39。:39。:39。// 通訊協(xié)議使用Http協(xié)議Post請(qǐng)求方式 流程示意圖 網(wǎng)關(guān)地址測(cè)試接口：:8081/Ebusiness/測(cè)試電商ID==1237100，AppKey==518a73d81f7f441ab64433e77b49d846正式接口： 簽名說(shuō)明 關(guān)于簽名快遞鳥和第三方電子商務(wù)公司系統(tǒng)進(jìn)行對(duì)接，有一定的安全機(jī)制。RequestData=jsonStr amp。//字符編碼采用UTF8string jsonStr= {\OrderCode\:\\,\ShipperCode\:\SF\,\LogisticCode\:\118461988807\}。 string keyValue = 56da2cf8c8a244b2b6fa476cd7d1ba17。(1) 開發(fā)服務(wù)開發(fā)自身業(yè)務(wù)的服務(wù)，服務(wù)需遵循接口的定義規(guī)則。按照快遞鳥官網(wǎng)提示進(jìn)行注冊(cè)申請(qǐng)，注冊(cè)成功后登錄用戶管理后臺(tái)，您將得到由快遞鳥提供的一組商戶ID和API Key。 接口規(guī)范及說(shuō)明 報(bào)文及報(bào)文編碼 Json格式。A 81 電子面單模板規(guī)格 81 返回編碼列表 8310 技術(shù)支持 831 前言 快遞鳥API旨在為電商、電商平臺(tái)、物流工具、倉(cāng)儲(chǔ)系統(tǒng)等等系統(tǒng)提供專業(yè)、穩(wěn)定、優(yōu)質(zhì)的物流服務(wù)，為不同的用戶量身定做了專業(yè)的API接口服務(wù)，供不同的用戶各取所需。O可選（Optional）C報(bào)文中該參數(shù)在一定條件下可選（Conditional）1 前言 72 概述 8 用戶使用流程圖 8 接口規(guī)范及說(shuō)明 9 報(bào)文及報(bào)文編碼 9 接入步驟 10 接口數(shù)據(jù)包結(jié)構(gòu) 11 JSON 范例 11 流程示意圖 12 網(wǎng)關(guān)地址 12 簽名說(shuō)明 12 關(guān)于簽名 12 (C)DataSign簽名加密代碼 133 下單 15 預(yù)約取件接口 15 功能說(shuō)明 15 接口規(guī)則 15 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 15 返回結(jié)果參數(shù) 18 Json請(qǐng)求示例 18 Json請(qǐng)求返回示例 19 電子面單 20 功能說(shuō)明 20 接口規(guī)則 20 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 20 返回結(jié)果參數(shù) 24 電子面單余量查詢接口 25 功能說(shuō)明 25 接口規(guī)則 25 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 25 返回結(jié)果參數(shù) 26 JSON請(qǐng)求示例 26 JSON返回示例 26 電子面單單號(hào)取消 27 功能說(shuō)明 27 接口規(guī)則 27 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 27 返回結(jié)果參數(shù) 28 Json請(qǐng)求示例 28 Json請(qǐng)求返回示例 28 申請(qǐng)電子面單客戶號(hào) 28 功能說(shuō)明 28 接口規(guī)則 29 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 29 返回結(jié)果參數(shù) 30 Json請(qǐng)求示例 30 Json請(qǐng)求返回示例 30 申請(qǐng)客戶號(hào)信息推送 31 功能說(shuō)明 31 接口規(guī)則 31 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 31 返回結(jié)果參數(shù) 31 Json請(qǐng)求示例 32 Json請(qǐng)求返回示例 32 增值服務(wù)列表 32 安全號(hào)碼接口 33 功能說(shuō)明 33 接口規(guī)則 33 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 33 返回結(jié)果參數(shù) 35 JSON請(qǐng)求示例 35 JSON請(qǐng)求返回示例 364 軌跡查詢 37 物流軌跡（即時(shí)查詢） 37 功能說(shuō)明 37 接口規(guī)則 37 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 37 返回結(jié)果參數(shù) 37 JSON請(qǐng)求示例 38 JSON返回示例 38 物流軌跡（訂閱查詢） 40 功能說(shuō)明 40 接口規(guī)則 40 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 40 返回結(jié)果參數(shù) 43 JSON請(qǐng)求示例 43 JSON返回示例 445 異步推送（回調(diào)）接口 45 功能說(shuō)明 45 接口規(guī)則 45 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 45 訂閱查詢結(jié)果（RequestType：101） 46 訂閱查詢（增值版）結(jié)果（RequestType：102） 47 貨款狀態(tài)（RequestType：107） 48 返回結(jié)果參數(shù) 49 JSON請(qǐng)求示例 49 JSON返回示例 536 智能服務(wù) 53 53 53 53 54 56 57 59 61 61 61 61 62 63 63 64 65 65 65 65 667 在途監(jiān)控（增值版） 66 物流軌跡（即時(shí)查詢?cè)鲋蛋妫?66 功能說(shuō)明 66 接口規(guī)則 66 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 67 返回結(jié)果參數(shù) 67 JSON請(qǐng)求示例 68 JSON返回示例 68 物流軌跡（訂閱查詢?cè)鲋蛋妫?70 功能說(shuō)明 70 接口規(guī)則 71 系統(tǒng)級(jí)和應(yīng)用級(jí)輸入?yún)?shù) 71 返回結(jié)果參數(shù) 74 JSON請(qǐng)求示例 74 JSON返回示例 758 短信 75 短信發(fā)送 75 功能說(shuō)明 75 接口規(guī)則 75