圆通在线下单接口文档

1、 圆通在线下单接口文档1、功能说明在线下单接口是提供给独立电商、仓储管理系统、物流供应链等物流流系统平台使用的下单接口，为客户解决在线发货需求，客户通过网络选择快递公司发送请求通知有快递要发货。快递在线下单为商家提供快递网上叫快递入口，无需电话通知催单。直接通知快递员上门取件，简单、快捷。2、接口规则 (1)、订单编号(OrderCode)不可重复提交，重复提交系统会返回具体错误代码。 (2)、支持主流快递公司在线下单，请联系技术人员(联系方式请看文档尾部)。(3)、接口只支持Json格式参数，接口指令1001。只支持POST请求方式，utf-8编码。(4)、接口平台：快递鸟 (4)、支持增值

2、服务，保价、代收货款、货款直退、货款垫付等。 (5)、测试地址：http:/testapi.kdniao.cc:8081/api/oorderservice/3、系统级输入参数参数名称类型是否必须描述RequestDataStringR请求内容，JSON或XML格式,须和DataType一致EBusinessIDStringR电商IDRequestTypeStringR请求指令类型：1001 DataSignStringR数据内容签名DataTypeStringO请求、返回数据类型：1-xml,2-json；默认为xml格式(本接口只支持Json格式)4、应用级输入参数参数名称类型是否必须描述

3、WarehouseIDStringO仓库标识(备用字段)WarehouseAddressStringO仓库地址(备用字段)CallBackStringO商户标识(备用字段)MemberIDStringO会员标识(备用字段)ShipperCodeStringR快递公司编码LogisticCodeStringO快递单号OrderCodeStringR订单编号MonthCodeStringC月结编码PayTypeIntR邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付ExpTypeIntR快递类型：1-标准快件CostDoubleO寄件费（运费）OtherCostDoubleO其他费用Re

4、ceiverCompanyStringO收件人公司NameStringR收件人TelStringR电话与手机，必填一个MobileStringPostCodeStringO收件人邮编ProvinceNameStringR收件省（如广东省，不要缺少“省”）CityNameStringR收件市（如深圳市，不要缺少“市”）ExpAreaNameStringO收件区（如福田区，不要缺少“区”或“县”）AddressStringR收件人详细地址SenderCompanyStringO发件人公司NameStringR发件人TelStringR电话与手机，必填一个MobileStringPostCodeSt

5、ringO发件人邮编ProvinceNameStringO发件省（如广东省，不要缺少“省”）CityNameStringR发件市（如深圳市，不要缺少“市”）ExpAreaNameStringO发件区（如福田区，不要缺少“区”或“县”）AddressStringR发件详细地址StartDateStringO上门取货时间段:yyyy-MM-dd HH:mm:ss格式化，本文中所有时间格式相同EndDateStringOWeightDoubleO物品总重量kgQuantityIntO件数/包裹数VolumeDoubleO物品总体积m3RemarkStringO备注AddServiceNameStri

6、ng0增值服务名称ValueString0增值服务值CustomerIDString0客户标识(选填)CommodityGoodsNameStringR商品名称GoodsCodeStringO商品编码GoodsquantityIntO件数GoodsPriceDoubleO商品价格GoodsWeightDoubleO商品重量kgGoodsDescStringO商品描述GoodsVolDoubleO商品体积m35、返回结果参数参数名称类型必须要求说明EBusinessIDStringR电商用户IDOrderOrderCodeStringR订单编号ShipperCodeStringR快递公司编码Lo

7、gisticCodeStringO快递单号SuccessBoolR成功与否ResultCodeStringR结果编码ReasonStringO失败原因UniquerRequestNumberStringR唯一标识6、Json请求示例 OrderCode: 012657018199, ShipperCode: YTO, PayType: 1, MonthCode: 7553045845, ExpType: 1, Cost: 1.0, OtherCost: 1.0, Sender: Company: LV, Name: Taylor, Mobile: ProvinceNa

8、me: 上海, CityName: 上海, ExpAreaName: 青浦区, Address: 明珠路 , Receiver: Company: GCCUI, Name: Yann, Mobile: ProvinceName: 北京, CityName: 北京, ExpAreaName: 朝阳区, Address: 三里屯街道 , Commodity: GoodsName: 鞋子, Goodsquantity: 1, GoodsWeight: 1.0 , AddService: Name: COD, Value: 1020 , Weight: 1.0, Quanti

9、ty: 1, Volume: 0.0, Remark: 小心轻放7、Json请求返回示例 EBusinessID: 1237100, Success: true, Order: OrderCode: 012657018199, ShipperCode : YTO , LogisticCode : , ResultCode: 100, Reason: 8、JAVA对接示例import java.io.BufferedReader;import java.io.IOException; import java.io.InputStreamReader;import java.io.OutputSt

10、reamWriter;import java.io.UnsupportedEncodingException;import .HttpURLConnection;import .URL;import .URLEncoder;import java.util.HashMap;import java.util.Map;import ernal.impl.dv.util.Base64;import java.security.MessageDigest; public class KdGoldAPIDemo /电商IDprivate Stri

11、ng EBusinessID=1237100;/电商加密私钥，快递鸟提供，注意保管，不要泄漏private String AppKey=518a73d8-1f7f-441a-b644-33e77b49d846;/请求urlprivate String ReqURL=http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx;/* * Json方式 在线下单 * throws Exception */public String orderOnlineByJson() throws ExceptionString requestData= Log

12、isticsWeight:2.0,+LogisticsVol:2.0,+HQPOrderDesc:尽快上门收件,+HQPPayType:1,+IsNeedPay:2,+Payment:121.0,+OrderCode:test_1234567890,+StartDate:2015-05-13 21:20:53,+EndDate:2015-05-14 21:20:53,+ShipperCode:LB,+LogisticCode:109932607391,+ToCompany:华为科技,+ToName:张三,+ToAddressArea:深圳市南山区桂庙路555号,+ToTel:,+ToMobil

13、e+OrderType:2,+ToPostCode:518128,+ToProvinceID:广东省,+ToCityID:深圳市,+ToExpAreaID:南山区,+FromCompany:小米科技,+FromName:李四,+FromAddressArea:深圳市福田区华强北路222号,+FromTel:88888888,+FromMobile:,+FromPostCode:529800,+FromProvinceID:广东省,+FromCityID:深圳市,+FromExpAreaID:福田区,+Cost:21.0,+OtherCost:2.0,+Commodit

14、ys:+Goodsquantity:12,+GoodsName:手机屏幕,+GoodsCode:kjyhu878787,+GoodsPrice:121.0,+;Map params = new HashMap();params.put(RequestData, urlEncoder(requestData, UTF-8);params.put(EBusinessID, EBusinessID);params.put(RequestType, 1001);String dataSign=encrypt(requestData, AppKey, UTF-8);params.put(DataSign

15、, urlEncoder(dataSign, UTF-8);params.put(DataType, 2);String result=sendPost(ReqURL, params);/根据公司业务处理返回的信息.return result;/* * XML方式 在线下单 * throws Exception */public String orderOnlineByXml() throws ExceptionString requestData= +1.5+test_123456789+0.5+测试在线下单接口 20150510+1+1+1000+1+2015-05-10 19:36:50

16、+2015-05-11 19:36:50+LB+张三+深圳市南山区南新路2055号广东省+深圳市+南山区+快递鸟科技+李四+深圳市福田区华强北路211号广东省+深圳市+福田区+12+1+惠普显示器+ABCD_123456789+2+850+神州笔记本+QWERT_456456+2+4200+;Map params = new HashMap();params.put(RequestData, urlEncoder(requestData, UTF-8);params.put(EBusinessID, EBusinessID);params.p

17、ut(RequestType, 1001);String dataSign=encrypt(requestData, AppKey, UTF-8);params.put(DataSign, urlEncoder(dataSign, UTF-8);params.put(DataType, 1);String result=sendPost(ReqURL, params);/根据公司业务处理返回的信息.return result;/* * MD5加密 * param str 内容 * param charset 编码方式 * throws Exception */SuppressWarnings(

18、unused)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 & 0xff; if (val = 0xf)

19、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 UnsupportedEncodingExceptionString encoded = Base64.encode(str.getBy

20、tes(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 keyValue Appkey * param charset 编码方式 * throws Unsuppo

21、rtedEncodingException ,Exception * return DataSign签名 */SuppressWarnings(unused)private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exceptionif (keyValue != null)return base64(MD5(content + keyValue, charset), charset);return base64(MD5(conten

22、t, charset), charset); /* * 向指定 URL 发送POST方法的请求 * param url 发送请求的 URL * param params 请求的参数集合 * return 远程资源的响应结果 */SuppressWarnings(unused)private String sendPost(String url, Map params) OutputStreamWriter out = null; BufferedReader in = null; StringBuilder result = new StringBuilder(); try URL realU

23、rl = new URL(url); HttpURLConnection conn =(HttpURLConnection) realUrl.openConnection(); / 发送POST请求必须设置如下两行 conn.setDoOutput(true); conn.setDoInput(true); / POST方法 conn.setRequestMethod(POST); / 设置通用的请求属性 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-urlencoded); conn.connect(); / 获取URLConnection对象对应的输出流 out = new OutputStreamWriter(conn