安能电子面单接口对接文档及模板

1、安能电子面单接口对接文档及模板电子面单是一种通过热敏纸打印输出纸质物流面单的物流服务。通过热感应显示文字， 打印速度比传统针式打印速度提升46倍。电子面单以接口形式嵌入到自己的系统、网站上,可以在自己的平台操作打印电子面单。接口支持的消息接收方式：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、在官网登录进入用户管理后台，进行实名认证，开通接口3、 技术对接及联调（登陆官网使用调试平台进行测试。）4、上线1、接口说明、只支持Json格式。接口指令1007。（2卜接口平台：快递鸟（3）、测试地址：http:/testapi.kd niao.cc:8081/api/eorderservice/2、系统级输入参数参数名称类型必须要求说明RequestDataStri ngR请求内容，JSON或 XML格式，须和DataType 一致EBus in essIDStri ngR电商IDRequestTypeStri ngR请求指令类型：1007DataSig nStri ngR数据内容签名Da

3、taTypeStri ngO请求、返回数据类型：1-xml,2-json;默认为xml格式3、应用级输入参数参数名称类型是否必须描述CallBackStri ngO用户自定义回调信息MemberlDStri ngO会员标识平台方与快递鸟统一用户标识的商家IDCustomerNanieStri ngO电子面单客户账号（与快递网点申请）CustomerPwdStri ngO电子面单密码Se ndSiteStri ngO收件网点标识ShipperCodeiStri ngR快递公司编码LogisticCodeStri ngO快递单号OrderCodeStri ngR订单编号Mon thCodeStri

4、 ngC月结编码IntR邮费支付方式：PayType1-现付，2-到付，3-月结，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收件区（如福田区，不要缺少“区”或“县”）AddressStri ngR收件人详细地址Compa nyStri ngO发件人公司NameStri ngR发件人TelStri ngR电话与手机，必填一个MobileStri ngPostCodeStri ngO发件人邮编Stri ngO发件省（如广东省，不要缺少“省”）SenderProvi nceNameCityNameStri ngR发件市（如深圳市，不要缺少“市”）ExpAreaNameStri ngO发件区（如福田区，不要缺少“区”或“县”）Addr

6、essStri ngR发件详细地址StartDateStri ngO上门取货时间段："yyyy-MM-dd HH:mm:ss"格式化，本文中所有时间格式相冋En dDateStri ngOWeightDoubleO物品总重量kgQua ntityIntO件数/包裹数VolumeDoubleO物品总体积m3RemarkStri ngO备注NameStri ng0增值服务名称AddServiceValueStri ng0增值服务值CustomerIDStri ng0客户标识（选填）CommodityGoodsNameStri ngR商品名称GoodsCodeStri ngO商品

7、编码Goodsqua ntityIntO件数GoodsPriceDoubleO商品价格GoodsWeightDoubleO商品重量kgGoodsDescStri ngO商品描述GoodsVolDoubleO商品体积m3IsReturnPri "TemplateStri ngO返回电子面单模板：0-不需要；1-需要4、返回结果参数参数名称类型必须要求说明EBus in essIDStri ngR电商用户IDOrderCodeStri ngR订单编号cShipperCodeStri ngR快递公司编码I_ogisticCodeStri ngR快递单号MarkDesti natio nSt

8、ri ngO大头笔Order(Origin CodeStri ngO始发地区域编码(OriginN ameStri ngO始发地/始发网点【Destin atioCodeStri ngO目的地区域编码【Destin atioNameStri ngO目的地/到达网点c3ortin gCodeStri ngO分拣编码fackageCodeStri ngO集包编码SuccessBoolR成功与否ResultCodeStri ngR错误编码ReasonStri ngO失败原因Uni querRequestNumberStri ngR唯一标识Prin tTemplateStri ngO面单打印模板Est

9、imatedDeliveryTimeStri ngO订单预计到货时间 yyyy-mm-ddCallbackStri ngO用户自定义回调信息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":"青浦区", "Address":"明珠路 73 号”,"Receiver": "Compa

11、ny": "GCCUI", "Name": "Ya nn", "Mobile": "quot;, "Provin ceName":"北京", "CityName":"北京", "ExpAreaName":"朝阳区", "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内容","EstimatedDeliveryTime ":"2016-03-06","Callback ":"调用时传入的 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="请到官网申请 /电商加密私钥，注意保管，不要泄漏p

17、rivate String AppKey="请到官网申请 / 请求 url,正式环境地址：http:/api.kdniao.cc/api/Eorderserviceprivate String ReqURL="http:/testapi.kdniao.cc:8081/api/Eorderservice"海','CityName':'上海','ExpAreaName':'青浦区','Address':'明珠路 73 号'," + "'R

18、eceiver':" +"'Compa ny':'GCCUI','Name':'Ya nn ','Mobile':'#39;,'Prov in ceName':'北 京','CityName':'北京','ExpAreaName':'朝阳区','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);/根据公司业务处理返回的信息retur n result;* MD5加密* param str 内容* 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 内容* 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发送POST方法的请求* param url发送请求的 UR

25、L* param params 请求的参数集合* return远程资源的响应结果*/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();/发送POST请求必须设置如下两行conn. setDoOutput(true);conn. setDo In put(true);/ POST方法conn. setRequestMethod("POST");/设置通用的请求属性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&