韵达电子面单接口JAVA对接方法

1、韵达电子面单接口JAVA对接方法电商管理后台的物流系统，仓管在处理订单发货时同步订单的发/收件人信息、货物信息，通过接口直接发送到快递公司。并直接打印电子面单。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.请求系统级参数参数名称类型说明必须要求RequestD

2、ataString请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。REBusinessIDString商户ID，请在我的服务页面查看。RRequestTypeString请求指令类型：1007RDataSignString数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。RDataTypeString请求、返回数据类型：只支持JSON格式O备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（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": "青浦区",    "Address": "明珠路73号"  ,  "Receiver":     "Company": "GCC

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

7、 "ExpAreaName": "朝阳区",    "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返回示例失败：    "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内容",  "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请到官网申请： */ public class KdGoldAPIDemo /电商IDprivate String EBusinessID="ID请申请"/电商加密私钥，注意保管，

16、不要泄漏private String AppKey="KEY请申请"/请求url, 正式环境地址：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':'青浦区','Address':'明珠路73号'," + "'Receiver':" + "" + "'C

19、ompany':'GCCUI','Name':'Yann','Mobile':'#39;,'ProvinceName':'北京','CityName':'北京','ExpAreaName':'朝阳区','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);/根据公司业务处理返回的信息.return result;/* * MD5加密 * param str 内容 * 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 内容 * 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 内容 * 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 发送POST方法的请求 * param url 发送请求的 URL * param params 请求的参数集合 * 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(); / 发送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