安能電子面單接口對接文檔及模板_第1頁
安能電子面單接口對接文檔及模板_第2頁
安能電子面單接口對接文檔及模板_第3頁
安能電子面單接口對接文檔及模板_第4頁
安能電子面單接口對接文檔及模板_第5頁
已閱讀5頁,還剩8頁未讀, 繼續(xù)免費閱讀

下載本文檔

版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進行舉報或認領(lǐng)

文檔簡介

1、安能電子面單接口對接文檔及模板電子面單是一種通過熱敏紙打印輸出紙質(zhì)物流面單的物流服務(wù)。通過熱感應顯示文字, 打印速度比傳統(tǒng)針式打印速度提升46倍。電子面單以接口形式嵌入到自己的系統(tǒng)、網(wǎng)站上,可以在自己的平臺操作打印電子面單。接口支持的消息接收方式:HTTP POST請求方法的編碼格式(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)登錄進入用戶管理后臺,進行實名認證,開通接口3、 技術(shù)對接及聯(lián)調(diào)(登陸官網(wǎng)使用調(diào)試平臺進行測試。)4、上線1、接口說明、只支持Json格式。接口指令1007。(2卜接口平臺:快遞鳥(3)、測試地址:http:/testapi.kd niao.cc:8081/api/eorderservice/2、系統(tǒng)級輸入?yún)?shù)參數(shù)名稱類型必須要求說明RequestDataStri ngR請求內(nèi)容,JSON或 XML格式,須和DataType 一致EBus in essIDStri ngR電商IDRequestTypeStri ngR請求指令類型:1007DataSig nStri ngR數(shù)據(jù)內(nèi)容簽名Da

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

4、 ngC月結(jié)編碼IntR郵費支付方式:PayType1-現(xiàn)付,2-到付,3-月結(jié),4-第 二方支付ExpTypeStri ngR快遞類型:1-標準快件IsNoticeIntO是否通知快遞員上門攬件:0-不通知;1-通知;不填則默認為 1CostDoubleO寄件費(運費)OtherCostDoubleO其他費用Compa nyStri ngO收件人公司NameStri ngR收件人TelStri ngR電話與手機,必填一個MobileStri ngReceiverPostCodeStri ngO收件人郵編Provi nceNameStri ngR收件省(如廣東省,不要缺少“省”)CityNam

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

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

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

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

9、imatedDeliveryTimeStri ngO訂單預計到貨時間 yyyy-mm-ddCallbackStri ngO用戶自定義回調(diào)信息5、JSON請求示例"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 號”,"Receiver": "Compa

11、ny": "GCCUI", "Name": "Ya nn", "Mobile": "quot;, "Provin ceName":"北京", "CityName":"北京", "ExpAreaName":"朝陽區(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":" 京-朝陽(京-1)&quo

14、t;, "Origi nCode": "200000", "OriginName":"上海分撥中心", "PackageCode":" 北京","PrintTemplate ":"此處省略打印模板 HTML內(nèi)容","EstimatedDeliveryTime ":"2016-03-06","Callback ":"調(diào)用時傳入的 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="請到官網(wǎng)申請 /電商加密私鑰,注意保管,不要泄漏p

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

18、eceiver':" +"'Compa ny':'GCCUI','Name':'Ya nn ','Mobile':'#39;,'Prov in ceName':'北 京','CityName':'北京','ExpAreaName':'朝陽區(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方法的請求* param url發(fā)送請求的 UR

25、L* param params 請求的參數(shù)集合* return遠程資源的響應結(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請求必須設(shè)置如下兩行conn. setDoOutput(true);conn. setDo In put(true);/ POST方法conn. setRequestMethod("POST");/設(shè)置通用的請求屬性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&

溫馨提示

  • 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預覽,若沒有圖紙預覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負責。
  • 6. 下載文件中如有侵權(quán)或不適當內(nèi)容,請與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

評論

0/150

提交評論