安能電子面單接口對(duì)接文檔及模板

1、安能電子面單接口對(duì)接文檔及模板電子面單是一種通過(guò)熱敏紙打印輸出紙質(zhì)物流面單的物流服務(wù)。通過(guò)熱感應(yīng)顯示文字， 打印速度比傳統(tǒng)針式打印速度提升46倍。電子面單以接口形式嵌入到自己的系統(tǒng)、網(wǎng)站上,可以在自己的平臺(tái)操作打印電子面單。接口支持的消息接收方式：HTTP POST請(qǐng)求方法的編碼格式（utf-8） : "application/x-www-form-urlencoded;charset=utf-8"API 地址： http:/api.kd niao.cc/Ebus in ess/Ebus in essOrderHa ndle.aspx電子面單接口接入流程：1、接口秘鑰 2、

2、在官網(wǎng)登錄進(jìn)入用戶管理后臺(tái)，進(jìn)行實(shí)名認(rèn)證，開通接口3、 技術(shù)對(duì)接及聯(lián)調(diào)（登陸官網(wǎng)使用調(diào)試平臺(tái)進(jìn)行測(cè)試。）4、上線1、接口說(shuō)明、只支持Json格式。接口指令1007。（2卜接口平臺(tái)：快遞鳥（3）、測(cè)試地址：http:/testapi.kd niao.cc:8081/api/eorderservice/2、系統(tǒng)級(jí)輸入?yún)?shù)參數(shù)名稱類型必須要求說(shuō)明RequestDataStri ngR請(qǐng)求內(nèi)容，JSON或 XML格式，須和DataType 一致EBus in essIDStri ngR電商IDRequestTypeStri ngR請(qǐng)求指令類型：1007DataSig nStri ngR數(shù)據(jù)內(nèi)容簽名Da

3、taTypeStri ngO請(qǐng)求、返回?cái)?shù)據(jù)類型：1-xml,2-json;默認(rèn)為xml格式3、應(yīng)用級(jí)輸入?yún)?shù)參數(shù)名稱類型是否必須描述CallBackStri ngO用戶自定義回調(diào)信息MemberlDStri ngO會(huì)員標(biāo)識(shí)平臺(tái)方與快遞鳥統(tǒng)一用戶標(biāo)識(shí)的商家IDCustomerNanieStri ngO電子面單客戶賬號(hào)（與快遞網(wǎng)點(diǎn)申請(qǐng)）CustomerPwdStri ngO電子面單密碼Se ndSiteStri ngO收件網(wǎng)點(diǎn)標(biāo)識(shí)ShipperCodeiStri ngR快遞公司編碼LogisticCodeStri ngO快遞單號(hào)OrderCodeStri ngR訂單編號(hào)Mon thCodeStri

4、 ngC月結(jié)編碼IntR郵費(fèi)支付方式：PayType1-現(xiàn)付，2-到付，3-月結(jié)，4-第 二方支付ExpTypeStri ngR快遞類型：1-標(biāo)準(zhǔn)快件IsNoticeIntO是否通知快遞員上門攬件：0-不通知；1-通知；不填則默認(rèn)為 1CostDoubleO寄件費(fèi)（運(yùn)費(fèi)）OtherCostDoubleO其他費(fèi)用Compa nyStri ngO收件人公司NameStri ngR收件人TelStri ngR電話與手機(jī)，必填一個(gè)MobileStri ngReceiverPostCodeStri ngO收件人郵編Provi nceNameStri ngR收件?。ㄈ鐝V東省，不要缺少“省”）CityNam

5、eStri ngR收件市（如深圳市，不要缺少“市”）ExpAreaNameStri ngO收件區(qū)（如福田區(qū)，不要缺少“區(qū)”或“縣”）AddressStri ngR收件人詳細(xì)地址Compa nyStri ngO發(fā)件人公司NameStri ngR發(fā)件人TelStri ngR電話與手機(jī)，必填一個(gè)MobileStri ngPostCodeStri ngO發(fā)件人郵編Stri ngO發(fā)件省（如廣東省，不要缺少“省”）SenderProvi nceNameCityNameStri ngR發(fā)件市（如深圳市，不要缺少“市”）ExpAreaNameStri ngO發(fā)件區(qū)（如福田區(qū)，不要缺少“區(qū)”或“縣”）Addr

6、essStri ngR發(fā)件詳細(xì)地址StartDateStri ngO上門取貨時(shí)間段："yyyy-MM-dd HH:mm:ss"格式化，本文中所有時(shí)間格式相冋En dDateStri ngOWeightDoubleO物品總重量kgQua ntityIntO件數(shù)/包裹數(shù)VolumeDoubleO物品總體積m3RemarkStri ngO備注NameStri ng0增值服務(wù)名稱AddServiceValueStri ng0增值服務(wù)值CustomerIDStri ng0客戶標(biāo)識(shí)（選填）CommodityGoodsNameStri ngR商品名稱GoodsCodeStri ngO商品

7、編碼Goodsqua ntityIntO件數(shù)GoodsPriceDoubleO商品價(jià)格GoodsWeightDoubleO商品重量kgGoodsDescStri ngO商品描述GoodsVolDoubleO商品體積m3IsReturnPri "TemplateStri ngO返回電子面單模板：0-不需要；1-需要4、返回結(jié)果參數(shù)參數(shù)名稱類型必須要求說(shuō)明EBus in essIDStri ngR電商用戶IDOrderCodeStri ngR訂單編號(hào)cShipperCodeStri ngR快遞公司編碼I_ogisticCodeStri ngR快遞單號(hào)MarkDesti natio nSt

8、ri ngO大頭筆Order(Origin CodeStri ngO始發(fā)地區(qū)域編碼(OriginN ameStri ngO始發(fā)地/始發(fā)網(wǎng)點(diǎn)【Destin atioCodeStri ngO目的地區(qū)域編碼【Destin atioNameStri ngO目的地/到達(dá)網(wǎng)點(diǎn)c3ortin gCodeStri ngO分揀編碼fackageCodeStri ngO集包編碼SuccessBoolR成功與否ResultCodeStri ngR錯(cuò)誤編碼ReasonStri ngO失敗原因Uni querRequestNumberStri ngR唯一標(biāo)識(shí)Prin tTemplateStri ngO面單打印模板Est

9、imatedDeliveryTimeStri ngO訂單預(yù)計(jì)到貨時(shí)間 yyyy-mm-ddCallbackStri ngO用戶自定義回調(diào)信息5、JSON請(qǐng)求示例"OrderCode": "012657700387", "ShipperCode": "HTKY","PayType": 1, "ExpType": 1, "Cost": 1.0, "OtherCost": 1.0,"Sender": "Compa

10、 ny": "LV", "Name": "Taylor", "Mobile": "quot;, "Provin ceName":"上海", "CityName":"上海", "ExpAreaName":"青浦區(qū)", "Address":"明珠路 73 號(hào)”,"Receiver": "Compa

11、ny": "GCCUI", "Name": "Ya nn", "Mobile": "quot;, "Provin ceName":"北京", "CityName":"北京", "ExpAreaName":"朝陽(yáng)區(qū)", "Address":"三里屯街道雅秀大廈 ” ,"Commodity":"Go

12、odsName":"鞋子", "Goodsqua ntity": 1, "GoodsWeight": 1.0,"AddService":"Name": "COD", "Value": "1020","Weight": 1.0,"Qua ntity": 1,"Volume": 0.0,"Remark":"小心輕放","I

13、sReturnPri ntTemplate ":1 6、JSON返回示例"EBusi nessID": "1237100","Order": "OrderCode": "012657700387", "ShipperCode": "HTKY", "LogisticCode": "50002498503427", "MarkDestination":" 京-朝陽(yáng)（京-1）&quo

14、t;, "Origi nCode": "200000", "OriginName":"上海分撥中心"， "PackageCode":" 北京","PrintTemplate ":"此處省略打印模板 HTML內(nèi)容","EstimatedDeliveryTime ":"2016-03-06","Callback ":"調(diào)用時(shí)傳入的 Callback","

15、;Success": true,"ResultCode": "100","Reason":"成功”7、JAVA案例import java.io.BufferedReader;import java.i o.I OExcepti on;import java.i o.ln putStreamReader;import java.io.OutputStreamWriter;import java.io. Un supportedE ncodi ngExcepti on;import java .n et.HttpURL

16、C onnection;import java .n et.URL;import java .n et.URLE ncoder;import java.util.HashMap;import java.util.Map;import com.s un .org.apache.xerces.i nternal.impl.dv.util.Base64;import java.security.MessageDigest;public class KdGoldAPIDemo /電商IDprivate String EBusinessID="請(qǐng)到官網(wǎng)申請(qǐng) /電商加密私鑰，注意保管，不要泄漏p

17、rivate String AppKey="請(qǐng)到官網(wǎng)申請(qǐng) / 請(qǐng)求 url,正式環(huán)境地址：http:/api.kdniao.cc/api/Eorderserviceprivate String ReqURL="http:/testapi.kdniao.cc:8081/api/Eorderservice"海','CityName':'上海','ExpAreaName':'青浦區(qū)','Address':'明珠路 73 號(hào)'," + "'R

18、eceiver':" +"'Compa ny':'GCCUI','Name':'Ya nn ','Mobile':'#39;,'Prov in ceName':'北 京','CityName':'北京','ExpAreaName':'朝陽(yáng)區(qū)','Address':'三里屯街道雅秀大廈'," +"'Com

19、modity':" +"" +"'GoodsName':'鞋子','Goodsquantity':1,'GoodsWeight':1.0," +”'Weight':1.0," +"'Qua ntity':1," +”'Volume':0.0," +"'Remark':'小心輕放',"+"'IsReturnPri ntT

20、emplate':1"Map<String, Stringparams = new HashMap<String, String>(); params.put("RequestData", urlE ncoder(requestData, "UTF-8"); params.put("EBus in essID", EBus in essID); params.put("RequestType", "1007");Stri ng dataSig n=en cry

21、pt(requestData, AppKey, "UTF-8"); params.put("DataSign", urlEncoder(dataSign, "UTF-8"); params.put("DataType", "2");String result=se ndPost(ReqURL, params);/根據(jù)公司業(yè)務(wù)處理返回的信息retur n result;* MD5加密* param str 內(nèi)容* param charset 編碼方式* throws Exceptio n*/Sup

22、pressWar nin gs(" unu sed")private String MD5(String str, String charset) throws Exception MessageDigest md = MessageDigest.getl nsta nce("MD5");md.update(str.getBytes(chcirset);byte result = md.digest();Strin gBuffer sb = new Strin gBuffer(32);for (i nt i = 0; i < result .len

23、 gth; i+) 1in t val = resulti & Oxff;if (val <= Oxf) sb.appe nd("0");sb.appe nd(l nteger.toHexStri ng(val); retur n sb.toStri ng().toLowerCase();/* I* base64 編碼*電商Sign簽名生成* param content 內(nèi)容* param keyValue Appkey* param charset 編碼方式* throws Un supportedE ncodi ngExcepti on ,Excepti

24、on* return DataSig n 簽名*/SuppressWar nin gs(" unu sed")private String en crypt (Stri ng content, String keyValue, String charset) throwsUn supportedE ncodi ngExcepti on, Excepti on if (keyValue != n ull)retur n base64(MD5(c ontent, charset), charset); 二*向指定URL發(fā)送POST方法的請(qǐng)求* param url發(fā)送請(qǐng)求的 UR

25、L* param params 請(qǐng)求的參數(shù)集合* return遠(yuǎn)程資源的響應(yīng)結(jié)果*/SuppressWar nin gs(" unu sed")private String sendPost(String url, Map<String, Stringparams) OutputStreamWriter out = n ull;BufferedReader in = nu II;Stri ngBuilder result = new Stri ngBuilder();try URL realUrl = new URL(url);HttpURLC onnection c

26、onn =(HttpURLC onnection) realUrl.ope nConnection();/發(fā)送POST請(qǐng)求必須設(shè)置如下兩行conn. setDoOutput(true);conn. setDo In put(true);/ POST方法conn. setRequestMethod("POST");/設(shè)置通用的請(qǐng)求屬性conn. setRequestProperty("accept", "*/*");conn. setRequestProperty("c onn ecti on", "Keep-Alive");conn. setRequestProperty("user-age nt","MozillaI4.0 (compatible; MSIE 6.0; Win dows NT 5.1;SV1)");conn. setRequestProperty("C onten t-Type","application Ix-www-form-urle ncoded&