《圆通快递电子面单接口对接说明(全)》由会员分享，可在线阅读，更多相关《圆通快递电子面单接口对接说明(全)（14页珍藏版）》请在金锄头文库上搜索。
1、圆通快递电子面单接口对接说明（全）1.接口类型说明接口类型说明 1）接口支持的消息接收方式：HTTP POST 2）请求方法的编码格式(utf-8)：“application/x-www-form-urlencoded;charset=utf-8“ 3）API 地址：http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx 4）接口提供：快递鸟 5）快递编码：YTO 2.请求系统级参数请求系统级参数参数名称类型说明必须要求RequestDataString请求内容需进行 URL(utf-8)编码。请求内容 JSON 格式，须和 DataTy
2、pe一致。REBusinessIDString商户 ID，请在我的服务页面查看。RRequestTypeString请求指令类型：1007RDataSignString数据内容签名：把(请求内容(未编码)+AppKey)进行 MD5 加密，然后Base64 编码，最后进行 URL(utf-8)编码。详细过程请查看 Demo。RDataTypeString请求、返回数据类型：只支持 JSON 格式O备注：R-必填（Required） ，O-可选（Optional） ，C-报文中该参数在一定条件下可选 （Conditional） 。3.接口参数接口参数 1）请求内容字段定义参数名称类型说明是否必须
3、CallBackString用户自定义回调信息OMemberIDString会员标识OCustomerNameString电子面单客户账号（与快递网点申请）OCustomerPwdString电子面单密码OSendSiteString收件网点标识OShipperCodeString快递公司编码RLogisticCodeString快递单号OOrderCodeString订单编号RMonthCodeString月结编码CPayTypeInt邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付RExpTypeString快递类型：1-标准快件RIsNoticeInt是否通知快递员上门揽件：0
4、-通知；1-不通知；不填则默认为 0OCostDouble寄件费（运费）OOtherCostDouble其他费用OCompanyString收件人公司ONameString收件人RTelStringMobileString电话与手机，必填一个RPostCodeString收件人邮编OProvinceName String收件省（如广东省，不要缺少“省”）RCityNameString收件市（如深圳市，不要缺少“市”）RExpAreaNameString收件区（如福田区，不要缺少“区”或“县”）OReceiverAddressString收件人详细地址RCompanyString发件人公司ONa
5、meString发件人RTelStringMobileString电话与手机，必填一个RPostCodeString发件人邮编OProvinceName String发件省（如广东省，不要缺少“省”）RCityNameString发件市（如深圳市，不要缺少“市”）RExpAreaNameString发件区（如福田区，不要缺少“区”或“县”）OSenderAddressString发件人详细地址RStartDateStringOEndDateString上门取货时间段:“yyyy-MM-dd HH:mm:ss“格式化，本文中所有时间格式相同OWeightDouble物品总重量 kgOQuanti
6、tyInt件数/包裹数OVolumeDouble物品总体积 m3ORemarkString备注OAddServicesNameString增值服务名称OValueString增值服务值OAddServiceCustomerIDString客户标识（选填）OCommoditysGoodsNameString商品名称RGoodsCodeString商品编码OGoodsquantity Int商品数量OGoodsPriceDouble商品价格OGoodsWeightDouble商品重量 kgOGoodsDescString商品描述OCommodityGoodsVolDouble商品体积 m3OIsR
7、eturnPrintTemplateString返回电子面单模板：0-不需要；1-需要O2）返回参数定义参数名称类型说明必须要求EBusinessIDString用户 IDROrderCodeString订单编号RShipperCodeString快递公司编码RLogisticCodeString快递单号RMarkDestinationString大头笔OOriginCodeString始发地区域编码OOriginNameString始发地/始发网点ODestinatioCodeString目的地区域编码ODestinatioNameString目的地/到达网点OSortingCodeStri
8、ng分拣编码OOrderPackageCodeString集包编码OSuccessBool成功与否RResultCodeString错误编码RReasonString失败原因OUniquerRequestNumberString唯一标识RPrintTemplateString面单打印模板OEstimatedDeliveryTimeString订单预计到货时间 yyyy-mm-ddOCallbackString用户自定义回调信息O4. 示例示例 1）JSON 请求示例“OrderCode“: “012657700387“,“ShipperCode“: “HTKY“,“PayType“: 1,“E
9、xpType“: 1,“Cost“: 1.0,“OtherCost“: 1.0,“Sender“: “Company“: “LV“,“Name“: “Taylor“,“Mobile“: “15018442396“,“ProvinceName“: “上海“,“CityName“: “上海“,“ExpAreaName“: “青浦区“,“Address“: “明珠路 73 号“,“Receiver“: “Company“: “GCCUI“,“Name“: “Yann“,“Mobile“: “15018442396“,“ProvinceName“: “北京“,“CityName“: “北京“,“Exp
10、AreaName“: “朝阳区“,“Address“: “三里屯街道雅秀大厦“,“Commodity“: “GoodsName“: “鞋子“,“Goodsquantity“: 1,“GoodsWeight“: 1.0,“AddService“: “Name“: “COD“,“Value“: “1020“,“Weight“: 1.0,“Quantity“: 1,“Volume“: 0.0,“Remark“: “小心轻放“,“IsReturnPrintTemplate“:1 2）JSON 返回示例 失败：“EBusinessID“: “1237100“,“ResultCode“: “105“,“R
11、eason“: “订单号已存在，请勿重复操作“，“UniquerRequestNumber“:“5e66486b-8fbc-4131-b875-9b13d2ad1354“ 成功：“EBusinessID“: “1237100“,“Order“: “OrderCode“: “012657700387“,“ShipperCode“: “HTKY“,“LogisticCode“: “50002498503427“,“MarkDestination“: “京-朝阳(京-1)“,“OriginCode“: “200000“,“OriginName“: “上海分拨中心“,“PackageCode“: “北
12、京“,“PrintTemplate“:“此处省略打印模板 HTML 内容“,“EstimatedDeliveryTime“:“2016-03-06“,“Callback“:“调用时传入的 Callback“,“Success“: true,“ResultCode“: “100“,“Reason“: “成功“5.JAVA 对接源码对接源码import java.io.BufferedReader;import java.io.IOException; import java.io.InputStreamReader;import java.io.OutputStreamWriter;import
13、 java.io.UnsupportedEncodingException;import .HttpURLConnection;import .URL;import .URLEncoder;import java.util.HashMap;import java.util.Map;import com.sun.org.apache.xerces.internal.impl.dv.util.Base64;import java.security.MessageDigest; /* ID 和 Key 请到官网申请：http:/ class KdGoldAPIDemo /电商 IDprivate S
14、tring EBusinessID=“ID 请申请“;/电商加密私钥，注意保管，不要泄漏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 request
15、Data= “OrderCode: 118060839871,“ +“ShipperCode:HHTT,“ +“PayType:1,“ +“ExpType:1,“ +“Cost:1.0,“ +“OtherCost:1.0,“ +“Sender:“ +“ +“Company:LV,Name:Taylor,Mobile:15018442396,ProvinceName:上海,CityName:上海,ExpAreaName:青浦区,Address:明珠路 73 号,“ +“Receiver:“ +“ +“Company:GCCUI,Name:Yann,Mobile:15018442396,ProvinceName:北京,CityName:北京,ExpAreaName:朝阳区,Address:三里屯街道雅秀大厦,“ +“Commodity:“ +“ +“GoodsName:鞋子,Goodsquantity:1,GoodsWeight:1.0,“ +“Weight:1.0,“ +“Quantity:1,“ +“Volume:0.0,“ +“Remark:小心轻放,“ +“IsReturnPrintTemplate:1“;Map params = new HashMap();params.put(“RequestData“, urlEncoder(requestData,
