各种电子面单 |
您所在的位置：网站首页 › 菜鸟电子面单打印app下载 › 各种电子面单 |
各种电子面单
|
目录术语电子面单样式对接接口各家对比各家合作流程对比接口定义及说明Request Params系统级参数(公共参数)接口参数Response ParamsJava栗子
术语
对于一般人，电子面单的意思可能并不是很了解；说白了，就是快递员给你打印的快递单的电子版。 专业解释： 电子面单是一种通过热敏纸打印输出纸质物流面单的物流服务。通过热感应显示文字，打印速度比传统针式打印速度提升4~6倍。电子面单以接口形式嵌入到自己的系统、网站上，可以在自己的平台操作打印电子面单。 电子面单样式
快递电子面单接口 a. 和多家快递公司申请账号 b.分别进行接口对接 c.电子面单服务用户向快递网点申请开通及确认合作细节 菜鸟电子面单 a.向菜鸟网络提交对接申请 b.和菜鸟进行接口对接 c.电子面单服务用户向菜鸟申请账号 d.电子面单服务用户向快递网点申请开通及确认合作细节 快递鸟电子面单 a. 进入申请账号，获取专属的ID和KEY b.和快递鸟进行接口对接 c.电子面单服务用户向快递网点申请开通及确认合作细节；当然，顺丰电子面单稍微特殊一点，即：顺丰接入快递鸟立马可以使用，无需注册账号。 接口定义及说明由于，当前快递鸟支持的电子面单接口相对于其他家的有一定优势；所以以下主要以快递鸟为例进行展开阐述一一说明。 Request ParamsApi接口：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx 请求方式：POST 编码：UTF-8 系统级参数(公共参数) 参数名称 类型 说明 是否必需 RequestData String 请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致 R EBusinessID String 商户ID，请在我的服务页面查看 R RequestType String 请求指令类型：1007 R DataSign String 数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo R DataType String 请求、返回数据类型：只支持JSON格式 O备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。 接口参数 参数名称 类型 说明 是否必需 CallBack String 用户自定义回调信息 O MemberID String 会员标识 O CustomerName String 电子面单客户账号（与快递网点申请） O CustomerPwd String 电子面单密码 O SendSite String 收件网点标识 O ShipperCode String 快递公司编码 R LogisticCode String 快递单号 O OrderCode String 订单编号 R MonthCode String 月结编码 C PayType Int 邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付 R ExpType String 快递类型：1-标准快件 R Cost Double 寄件费（运费） O OtherCost Double 其他费用 O StartDate String 上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化，本文中所有时间格式相同 O EndDate String 上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化，本文中所有时间格式相同 O Weight Double 物品总重量kg O Quantity Int 件数/包裹数 O Volume Double 物品总体积m3 O Remark String 备注 O IsReturnPrintTemplate String 返回电子面单模板：0-不需要；1-需要 O Receiver Company String 收件人公司 O Name String 收件人 R Tel String 电话与手机，必填一个 R Mobile String 电话与手机，必填一个 R PostCode String 收件人邮编 O ProvinceName String 收件省（如广东省，不要缺少“省”） R CityName String 收件市（如深圳市，不要缺少“市”） R ExpAreaName String 收件区（如福田区，不要缺少“区”或“县”） O Address String 收件人详细地址 R Sender Company String 发件人公司 O Name String 收件人 R Tel String 电话与手机，必填一个 R Mobile String 电话与手机，必填一个 R PostCode String 发件人邮编 O ProvinceName String 发件省（如广东省，不要缺少“省”） R CityName String 发件市（如深圳市，不要缺少“市”） R ExpAreaName String 发件区（如福田区，不要缺少“区”或“县”） O Address String 发件人详细地址 R AddServices AddService Name String 增值服务名称 O Value String 增值服务值 O CustomerID String 客户标识（选填） O Commoditys Commodity GoodsName String 商品名称 R GoodsCode String 商品编码 O Goodsquantity String 商品数量 O GoodsPrice String 商品价格 O GoodsWeight String 商品重量kg O GoodsDesc String 商品描述 O GoodsVol String 商品体积m3 O Response Params 参数名称 类型 说明 是否必需 EBusinessID String 用户ID R Success Bool 成功与否 R ResultCode String 错误编码 R Reason String 失败原因 O UniquerRequestNumber String 唯一标识 R PrintTemplate String 面单打印模板 O EstimatedDeliveryTime String 订单预计到货时间yyyy-mm-dd O Callback String 用户自定义回调信息 O Order OrderCode String 订单编号 R ShipperCode String 快递公司编码 R LogisticCode String 快递单号 R MarkDestination String 大头笔 O OriginCode String 始发地区域编码 O OriginName String 始发地/始发网点 O DestinatioCode String 目的地区域编码 O DestinatioName String 目的地/到达网点 O SortingCode String 分拣编码 O PackageCode String 集包编码 O Java栗子注：此栗子仅供参考，如要使用请到官方下载对应语言的Demo即可。 import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; import java.io.OutputStreamWriter; import java.io.UnsupportedEncodingException; import java.net.HttpURLConnection; import java.net.URL; import java.net.URLEncoder; import java.util.HashMap; import java.util.Map; import com.sun.org.apache.xerces.internal.impl.dv.util.Base64; import java.security.MessageDigest; /** * * 快递鸟电子面单接口 * * @技术QQ: 4009633321 * @技术QQ群: 200121393 * @see: http://www.kdniao.com/MiandanAPI.aspx * @copyright: 深圳市快金数据技术服务有限公司 * * ID和Key请到官网申请：http://www.kdniao.com/ServiceApply.aspx */ public class KdGoldAPIDemo { //电商ID private String EBusinessID="请到快递鸟官网申请http://www.kdniao.com/ServiceApply.aspx"; //电商加密私钥，快递鸟提供，注意保管，不要泄漏 private String AppKey="请到快递鸟官网申请http://www.kdniao.com/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','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, "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 < result.length; i++) { int val = result[i] & 0xff; if (val 0){ param.append("&"); } param.append(entry.getKey()); param.append("="); param.append(entry.getValue()); System.out.println(entry.getKey()+":"+entry.getValue()); } System.out.println("param:"+param.toString()); out.write(param.toString()); } // flush输出流的缓冲 out.flush(); // 定义BufferedReader输入流来读取URL的响应 in = new BufferedReader( new InputStreamReader(conn.getInputStream(), "UTF-8")); String line; while ((line = in.readLine()) != null) { result.append(line); } } catch (Exception e) { e.printStackTrace(); } //使用finally块来关闭输出流、输入流 finally{ try{ if(out!=null){ out.close(); } if(in!=null){ in.close(); } } catch(IOException ex){ ex.printStackTrace(); } } return result.toString(); } }其他Api接口，请转到快递鸟具体查看相关文档。 ps：Coolspan kdniao |
【本文地址】
今日新闻 |
推荐新闻 |