韻達電子面單接口JAVA對接方法

1、韻達電子面單接口JAVA對接方法電商管理后臺的物流系統(tǒng)，倉管在處理訂單發(fā)貨時同步訂單的發(fā)/收件人信息、貨物信息，通過接口直接發(fā)送到快遞公司。并直接打印電子面單。1.接口類型說明1）接口支持的消息接收方式：HTTP POST2）請求方法的編碼格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"3）API地址：http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx4）接口提供：快遞鳥5）快遞編碼：YD2.請求系統(tǒng)級參數(shù)參數(shù)名稱類型說明必須要求RequestD

2、ataString請求內(nèi)容需進行URL(utf-8)編碼。請求內(nèi)容JSON格式，須和DataType一致。REBusinessIDString商戶ID，請在我的服務頁面查看。RRequestTypeString請求指令類型：1007RDataSignString數(shù)據(jù)內(nèi)容簽名：把(請求內(nèi)容(未編碼)+AppKey)進行MD5加密，然后Base64編碼，最后進行URL(utf-8)編碼。詳細過程請查看Demo。RDataTypeString請求、返回數(shù)據(jù)類型：只支持JSON格式O備注：R-必填（Required），O-可選（Optional），C-報文中該參數(shù)在一定條件下可選（Conditiona

3、l）。3.示例1）JSON請求示例  "OrderCode": "012657700387",  "ShipperCode": "HTKY",  "PayType": 1,  "ExpType": 1,  "Cost": 1.0,  "OtherCost": 1.0,  &quo

4、t;Sender":     "Company": "LV",    "Name": "Taylor",    "Mobile": "quot;,    "ProvinceName": "上海", 

5、0;  "CityName": "上海",    "ExpAreaName": "青浦區(qū)",    "Address": "明珠路73號"  ,  "Receiver":     "Company": "GCC

6、UI",    "Name": "Yann",    "Mobile": "quot;,    "ProvinceName": "北京",    "CityName": "北京",   

7、 "ExpAreaName": "朝陽區(qū)",    "Address": "三里屯街道雅秀大廈"  ,  "Commodity":           "GoodsName": "鞋子",    &#

8、160; "Goodsquantity": 1,      "GoodsWeight": 1.0      ,  "AddService":           "Name": "COD",    &

9、#160; "Value": "1020"      ,  "Weight": 1.0,  "Quantity": 1,  "Volume": 0.0,  "Remark": "小心輕放",  "IsReturnPrintTemplate":12）J

10、SON返回示例失?。?#160;   "EBusinessID": "1237100",    "ResultCode": "105",    "Reason": "訂單號已存在，請勿重復操作"，    "UniquerRequestNumber":"5e66486b-

11、8fbc-4131-b875-9b13d2ad1354"成功：  "EBusinessID": "1237100",  "Order":     "OrderCode": "012657700387",    "ShipperCode": "HTKY",    

12、;"LogisticCode": "50002498503427",    "MarkDestination": "京-朝陽(京-1)",    "OriginCode": "200000",    "OriginName": "上海分撥中心",   

13、; "PackageCode": "北京"  ,  "PrintTemplate":"此處省略打印模板HTML內(nèi)容",  "EstimatedDeliveryTime":"2016-03-06",  "Callback":"調用時傳入的Callback",  "Success": true

14、,  "ResultCode": "100",  "Reason": "成功"4.JAVA對接源碼import java.io.BufferedReader;import java.io.IOException; import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;import .Http

15、URLConnection;import .URL;import .URLEncoder;import java.util.HashMap;import java.util.Map;import ernal.impl.dv.util.Base64;import java.security.MessageDigest; /* * ID和Key請到官網(wǎng)申請： */ public class KdGoldAPIDemo /電商IDprivate String EBusinessID="ID請申請"/電商加密私鑰，注意保管，

16、不要泄漏private String AppKey="KEY請申請"/請求url, 正式環(huán)境地址：http:/api.kdniao.cc/api/Eorderserviceprivate String ReqURL="http:/testapi.kdniao.cc:8081/api/Eorderservice"/* * Json方式 電子面單 * throws Exception */public String orderOnlineByJson() throws ExceptionString requestData= "'Order

17、Code': '118060839871'," + "'ShipperCode':'YD'," + "'PayType':1," + "'ExpType':1," + "'Cost':1.0," + "'OtherCost':1.0," + "'Sender':" + "" + "'Compan

18、y':'LV','Name':'Taylor','Mobile':'#39;,'ProvinceName':'上海','CityName':'上海','ExpAreaName':'青浦區(qū)','Address':'明珠路73號'," + "'Receiver':" + "" + "'C

19、ompany':'GCCUI','Name':'Yann','Mobile':'#39;,'ProvinceName':'北京','CityName':'北京','ExpAreaName':'朝陽區(qū)','Address':'三里屯街道雅秀大廈'," + "'Commodity':" + "" + &q

20、uot;'GoodsName':'鞋子','Goodsquantity':1,'GoodsWeight':1.0," + "'Weight':1.0," + "'Quantity':1," + "'Volume':0.0," + "'Remark':'小心輕放'," + "'IsReturnPrintTemplate':1"Ma

21、p<String, String> params = new HashMap<String, String>();params.put("RequestData", urlEncoder(requestData, "UTF-8");params.put("EBusinessID", EBusinessID);params.put("RequestType", "1007");String dataSign=encrypt(requestData, AppKey, &quo

22、t;UTF-8");params.put("DataSign", urlEncoder(dataSign, "UTF-8");params.put("DataType", "2");String result=sendPost(ReqURL, params);/根據(jù)公司業(yè)務處理返回的信息.return result;/* * MD5加密 * param str 內(nèi)容 * param charset 編碼方式 * throws Exception */SuppressWarnings("unuse

23、d")private String MD5(String str, String charset) throws Exception MessageDigest md = MessageDigest.getInstance("MD5"); md.update(str.getBytes(charset); byte result = md.digest(); StringBuffer sb = new StringBuffer(32); for (int i = 0; i < result.length; i+) int val = resulti &

24、 0xff; if (val <= 0xf) sb.append("0"); sb.append(Integer.toHexString(val); return sb.toString().toLowerCase();/* * base64編碼 * param str 內(nèi)容 * param charset 編碼方式 * throws UnsupportedEncodingException */private String base64(String str, String charset) throws UnsupportedEncodingExceptionSt

25、ring encoded = Base64.encode(str.getBytes(charset);return encoded; SuppressWarnings("unused")private String urlEncoder(String str, String charset) throws UnsupportedEncodingExceptionString result = URLEncoder.encode(str, charset);return result;/* * 電商Sign簽名生成 * param content 內(nèi)容 * param key

26、Value Appkey * param charset 編碼方式 * throws UnsupportedEncodingException ,Exception * return DataSign簽名 */SuppressWarnings("unused")private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exceptionif (keyValue != null)return base64(MD5(c

27、ontent + keyValue, charset), charset);return base64(MD5(content, charset), charset); /* * 向指定 URL 發(fā)送POST方法的請求 * param url 發(fā)送請求的 URL * param params 請求的參數(shù)集合 * return 遠程資源的響應結果 */SuppressWarnings("unused")private String sendPost(String url, Map<String, String> params) OutputStreamWriter

28、 out = null; BufferedReader in = null; StringBuilder result = new StringBuilder(); try URL realUrl = new URL(url); HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection(); / 發(fā)送POST請求必須設置如下兩行 conn.setDoOutput(true); conn.setDoInput(true); / POST方法 conn.setRequestMethod("POST");

29、 / 設置通用的請求屬性 conn.setRequestProperty("accept", "*/*"); conn.setRequestProperty("connection", "Keep-Alive"); conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)"); conn.setRequestProperty("Content-Type", "application/x-www-form-urlencode