快递鸟/菜鸟电子面单接口的申请方法-低调大师

快递鸟/菜鸟电子面单接口的申请方法

2019-09-02 1102

电子面单是一种通过热敏纸打印输出纸质物流面单的物流服务。通过热感应显示文字，打印速度比传统针式打印速度提升4~6倍。电子面单以接口形式嵌入到自己的系统、网站上，可以在自己的平台操作打印电子面单。

一.电子面单接口类型及定义

快递电子面单接口：快递公司自己开发的电子面单服务，商家使用必须快递公司上门做系统对接，使用一家快递则需要对接一次，比较麻烦，而且后期对接成本也较高。

2.菜鸟电子面单接口：可一次对接15家快递公司，无需和每一家快递公司做对接。支持快递有四通一达、EMS、宅急送、德邦、优速、天天、快捷、全峰等15家常用快递公司，其中不包括顺丰。

菜鸟电子面单，是由菜鸟网络和快递公司联合向商家提供的一种通过热敏纸打印输出纸质物流面单的物流服务。商家可在淘宝天猫的卖家中心申请开通服务，菜鸟会把服务申请流转给快递公司，快递公司审核通过后会给商家提供电子面单热敏打印纸；商家再通过发货软件与菜鸟网络系统交互并获得菜鸟生成的面单号（快递面单号段由快递公司提供）等打印信息，并通过热敏打印机（打印机由商家自行购买或与网点协商解决）完成电子面单打印并交付快递公司揽收派送。

3.快递鸟电子面单接口：可一次对接30多家快递公司，无需和每一家快递公司做对接。支持快递有四通一达、顺丰、EMS、宅急送、德邦、优速等30家快递公司，对顺丰有电子面单服务需求的可以选择顺丰自有的电子面单或者是快递鸟电子面单。

电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口，满足客户在线发货需求并提供打印面单的服务，客户通过网络选择物流公司发送请求通知贵公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为您通知对应的快递公司快递员上门取件。

电子面单成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调用客户方推送接收接口。同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给用户。

二.开通使用流程

1.快递电子面单

和多家快递公司申请账号

b.分别进行接口对接

c.电子面单服务用户向快递网点申请开通及确认合作细节

2.菜鸟电子面单

a.向菜鸟提交对接申请

b.和菜鸟进行接口对接

c.电子面单服务用户向菜鸟申请账号

d.电子面单服务用户向快递网点申请开通及确认合作细节

3.快递鸟电子面单

进入申请快递鸟快递接口API_服务申请申请账号，获取专属的ID和KEY

b.和快递鸟进行接口对接

c.电子面单服务用户向快递网点申请开通及确认合作细节

接口类型较多，以下先附上快递鸟电子面单接口调用方式，希望对大家有所帮助。后面将逐个对菜鸟电子面单、顺丰电子面单等接口调用方式做整理说明。

三.电子面单对接案例—快递鸟

1.接口描述

接口支持的消息接收方式：HTTP POST

请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"

API地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx

2.请求系统级参数

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）
java对接源码

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: 快递公司电子面单API接口__快递鸟

* @copyright: 深圳市快金数据技术服务有限公司

*

* ID和Key请到官网申请：申请快递鸟快递接口API_服务申请

*/

public class KdGoldAPIDemo {

//电商ID

private String EBusinessID="请到快递鸟官网申请申请快递鸟快递接口API_服务申请";

//电商加密私钥，快递鸟提供，注意保管，不要泄漏

private String AppKey="请到快递鸟官网申请申请快递鸟快递接口API_服务申请";

//请求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<String, String> params = new HashMap<String, String>();

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 <= 0xf) {

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 UnsupportedEncodingException{

String encoded = Base64.encode(str.getBytes(charset));

return encoded;

}

@SuppressWarnings("unused")

private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{

String result = URLEncoder.encode(str, charset);

return result;

}

/**

* 电商Sign签名生成

* @param content 内容

* @param keyValue Appkey

* @param charset 编码方式

* @throws UnsupportedEncodingException ,Exception

* @return DataSign签名

*/

@SuppressWarnings("unused")

private String encrypt (String content, String keyValue, String charset) throws UnsupportedEncodingException, Exception

{

if (keyValue != null)

{

return base64(MD5(content + keyValue, charset), charset);

}

return base64(MD5(content, charset), charset);

}

/**

* 向指定 URL 发送POST方法的请求

* @param url 发送请求的 URL

* @param params 请求的参数集合

* @return 远程资源的响应结果

*/

@SuppressWarnings("unused")

private String sendPost(String url, Map<String, String> 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<String, String> entry : params.entrySet()) {

if(param.length()>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();

}

}

微信关注我们

原文链接：https://yq.aliyun.com/articles/717096

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

好程序员web前端学习路线分享了解AJAX是什么

好程序员web前端学习路线分享了解AJAX是什么首先是服务器什么是服务器：咱们的页面来源于服务器；实例（在phpnwo上面存放一个页面），咱们把页面放在互联网的服务器上，就有了自己的网站了。 1.异步同步生活中的同步：生活中的异步：在JavaScript语言中，同步和异步的概念刚好相反。这JavaScript中同步就是：你不执行完上面的代码，那么下面的代码你就别执行；一步一步执行，这就是同步。异步就是可以一块执行的代码；进程的概念进程≠程序程序从开始到结束的一次执行过程叫做进程一个进程当中，程序同时运行的多个分支，叫做线程多线程异步执行，可以提高程序的效率 AJAX的重要性在许多数企业看来AJAX的使用熟练程度 === 你的工作经验。 2.什么是AJAX ajax是前后端数据交互的重要手段 Ajax 全称为：“Asynchronous JavaScript and XML”（异步 JavaScript 和 XML），它并不是 JavaScript 的一种单一技术，而是利用了一系列交互式网页应用相关的技术所形成的结合体。使用 Ajax，我们可以无刷新状...

2019-09-03

645

最近在学习springboot，感觉springboot开发后台，提供api接口太方便了。简直是傻瓜式开发，一直都是本地在跑springboot项目。梦想着有一天，项目能在阿里云上跑。只有在阿里云上跑才是真正的java服务器项目。这里就带大家一起把springboot项目部署到阿里云，并且支持https 准备工作阿里云ecs一个域名一个（我的是https://30paotui.com） ca证书一份（用来支持https）本地打包好的springboot项目。我这里用jar不用war ftp客户端一个，用来把jar传到阿里云服务器上，我用的是filezilla客户端，可以百度下载。一，购买阿里云ecs配置安全组规则如果不配置安全组规则，我们将没法访问我们阿里云服务器，下图中的80/80和443/443必须配置，因为只有这里配置了才能支持http和https访问我们的网站配置如下，授权对象哪里最好填0.0.0.0/0 二，买域名至于域名怎么买，我就不啰嗦了，不会的自行百度30paotui.com我买的域名三，通过filezilla连接阿里云服务器，运行项目我在我的服务器...

2019-09-03

585

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。