各种电子面单-api接口(顺丰、快递鸟、菜鸟)

术语 电子面单样式 对接接口各家对比 各家合作流程对比 接口定义及说明 oRequest Params 系统级参数公共参数 接口参数 oResponse Params Java 栗子 同类文章 术语 对于一般人，电子面单的意思可能并不是很了解；说白了，就是快递员给你打印的快递单 的电子版。 专业解释： 电子面单是一种通过热敏纸打印输出纸质物流面单的物流服务。通过热感 应显示文字，打印速度比传统针式打印速度提升 46 倍。电子面单以接口 形式嵌入到自己的系统、网站上，可以在自己的平台操作打印电子面单。 电子面单样式 对接接口各家对比 1.快递电子面单接口：快递公司自己开发的电子面单服务， 商家使用必须快递公司 上门做系统对接，使用一家快递则需要对接一次。 2.菜鸟电子面单接口：可一次对接 15 家快递公司， 无需和每一家快递公司做对接。 支持快递有四通一达、EMS、宅急送、德邦、优速、天天、快捷、全峰等 15 家常 用快递公司，其中不包括顺丰。 3.快递鸟电子面单接口：可一次对接 15 家快递公司， 无需和每一家快递公司做对 接。支持快递有四通一达、顺丰、EMS、宅急送、德邦、优速等 15 家快递公司， 对顺丰有电子面单服务需求的可以选择顺丰自有的电子面单或者是快递鸟电子面单。 各家合作流程对比 1. 快递电子面单接口 a. 和多家快递公司申请账号 b.分别进行接口对接 c.电子面单服务用户向快递网点申请开通及确认合作细节 2. 3. 菜鸟电子面单 a.向菜鸟网络提交对接申请 b.和菜鸟进行接口对接 c.电子面单服务用户向菜鸟申请账号 d.电子面单服务用户向快递网点申请开通及确认合作细节 4. 5. 快递鸟电子面单 a. 进入申请账号，获取专属的 ID 和 KEY b.和快递鸟进行接口对接 c.电子面单服务用户向快递网点申请开通及确认合作细节；当然，顺丰电子面单稍 微特殊一点，即：顺丰接入快递鸟立马可以使用，无需注册账号。 6. 接口定义及说明 由于，当前快递鸟支持的电子面单接口相对于其他家的有一定优势；所以以下主要以快递 鸟为例进行展开阐述一一说明。 Request Params Api 接口：http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx 请求方式：POST 编码：UTF-8 系统级参数(公共参数) 参数名称类型说明是 否 必 需 RequestDataString 请求内容需进行 URL(utf-8)编码。请求内容 JSON 格式， 须和 DataType 一致 R 参数名称类型说明是 否 必 需 EBusinessIDString 商户 ID，请在我的服务页面查看 R RequestTypeString 请求指令类型：1007 R DataSignString 数据内容签名：把(请求内容(未编码)+AppKey)进行 MD5 加密，然后 Base64 编码，最后进行 URL(utf-8)编 码。详细过程请查看 Demo R DataTypeString 请求、返回数据类型：只支持 JSON 格式 O 备注：R-必填（Required），O-可选（Optional），C-报文中该参数在 一定条件下可选（Conditional）。 接口参数 参数名称类型说明是否 必需 CallBackString 用户自定义回调信息 O 参数名称类型说明是否 必需 MemberIDString 会员标识 O CustomerNameString 电子面单客户账号（与快递网点申请） O CustomerPwdString 电子面单密码 O SendSiteString 收件网点标识 O ShipperCodeString 快递公司编码 R LogisticCodeString 快递单号 O OrderCodeString 订单编号 R MonthCodeString 月结编码 C PayTypeInt 邮费支付方式:1-现付，2-到付，3-月结，4-第三方 支付 R ExpTypeString 快递类型：1-标准快件 R 参数名称类型说明是否 必需 CostDouble 寄件费（运费） O OtherCostDouble 其他费用 O StartDateString 上门取货时间段:”yyyy-MM-dd HH:mm:ss”格式 化，本文中所有时间格式相同 O EndDateString 上门取货时间段:”yyyy-MM-dd HH:mm:ss”格式 化，本文中所有时间格式相同 O WeightDouble 物品总重量 kg O QuantityInt 件数/包裹数 O VolumeDouble 物品总体积 m3 O RemarkString 备注 O IsReturnPrintTemplateString 返回电子面单模板：0-不需要；1-需要 O ReceiverCompanyString 收件人公司 O NameString 收件人 R TelString 电话与手机，必填一个 R MobileString 电话与手机，必填一个 R PostCodeString 收件人邮编 O ProvinceNameString 收件省（如广东省，不要缺少“省”） R CityNameString 收件市（如深圳市，不要缺少“市”） R ExpAreaNameString 收件区（如福田区，不要缺少“区”或“县”） O AddressString 收件人详细地址 R SenderCompanyString 发件人公司 O NameString 收件人 R TelString 电话与手机，必填一个 R SenderCompanyString 发件人公司 O MobileString 电话与手机，必填一个 R PostCodeString 发件人邮编 O ProvinceNameString 发件省（如广东省，不要缺少“省”） R CityNameString 发件市（如深圳市，不要缺少“市”） R ExpAreaNameString 发件区（如福田区，不要缺少“区”或“县”） O AddressString 发件人详细地址 R AddServices AddServiceNameString 增值服务名称 O ValueString 增值服务值 O CustomerIDString 客户标识（选填） O Commoditys Commoditys CommodityGoodsNameString 商品名称 R GoodsCodeString 商品编码 O GoodsquantityString 商品数量 O GoodsPriceString 商品价格 O GoodsWeightString 商品重量 kg O GoodsDescString 商品描述 O GoodsVolString 商品体积 m3 O Response Params 参数名称类型说明是否必需 EBusinessIDString 用户 ID R SuccessBool 成功与否 R 参数名称类型说明是否必需 ResultCodeString 错误编码 R ReasonString 失败原因 O UniquerRequestNumberString 唯一标识 R PrintTemplateString 面单打印模板 O EstimatedDeliveryTimeString 订单预计到货时间 yyyy-mm-dd O CallbackString 用户自定义回调信息 O OrderOrderCodeString 订单编号 R ShipperCodeString 快递公司编码 R LogisticCodeString 快递单号 R MarkDestinationString 大头笔 O OriginCodeString 始发地区域编码 O OrderOrderCodeString 订单编号 R OriginNameString 始发地/始发网点 O DestinatioCodeString 目的地区域编码 O DestinatioNameString 目的地/到达网点 O SortingCodeString 分拣编码 O PackageCodeString 集包编码 O Java 栗子 注：此栗子仅供参考，如要使用请到官方下载对应语言的 Demo 即可。 import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import java.io.OutputStreamWriter; 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; /* * * 快递鸟电子面单接口 * * 技术 QQ: 4009633321 * 技术 QQ 群: 200121393 * see: /MiandanAPI.aspx * copyright: 深圳市快金数据技术服务有限公司 * * ID 和 Key 请到官网申请：/ServiceApply.aspx */ public class KdGoldAPIDemo /电商 ID private String EBusinessID=“请到快递鸟官网申请 /ServiceApply.aspx“; /电商加密私钥，快递鸟提供，注意保管，不要泄漏 private String AppKey=“请到快递鸟官网申请 /ServiceApply.aspx“; /请求 url, 正式环境地址：http:/api.kdniao.cc/api/Eorderservice private String ReqURL=“http:/testapi.kdniao.cc:8081/api/Eorderservice“; /* * Json 方式 电子面单 * throws Exception */ public String orderOnlineByJson() throws Exception String requestData= “OrderCode: 012657700387,“ + “ShipperCode:EMS,“ + “PayType:1,“ + “ExpType:1,“ + “Cost:1.0,“ + “OtherCost:1.0,“ + “Sender:“ + “ + “Company:LV,Name:Taylor,MobileProvinceName:上 海,CityName:上海,ExpAreaName:青浦区,Address:明珠路 73 号,“ + “Receiver:“ + “ + “Company:GCCUI,Name:Yann,MobileProvinceName: 北京,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, “UTF-8“); params.put(“EBusinessID“, EBusinessID); params.put(“RequestType“, “1007“); String dataSign=encrypt(requestData, AppKey, “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(“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 params) OutputStreamWriter 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“); / 设置通用的请求属性 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.getOutputStream(), “UTF-8“); / 发送请求参数 if (params != null) StringBuilder param = new StringBuilder(); for (Map.Entry entry : params.entr