对于一般人，电子面单的意思可能并不是很了解；说白了，就是快递员给你打印的快递单的电子版。
专业解释：
电子面单是一种通过热敏纸打印输出纸质物流面单的物流服务。通过热感应显示文字，打印速度比传统针式打印速度提升4~6倍。电子面单以接口形式嵌入到自己的系统、网站上，可以在自己的平台操作打印电子面单。
电子面单样式
对接接口各家对比
快递电子面单接口：快递公司自己开发的电子面单服务， 商家使用必须快递公司上门做系统对接，使用一家快递则需要对接一次。：可一次对接15家快递公司， 无需和每一家快递公司做对接。支持快递有四通一达、EMS、宅急送、德邦、优速、天天、快捷、全峰等15家常用快递公司，其中不包括顺丰。：可一次对接15家快递公司， 无需和每一家快递公司做对接。支持快递有四通一达、顺丰、EMS、宅急送、德邦、优速等15家快递公司，对顺丰有电子面单服务需求的可以选择顺丰自有的电子面单或者是快递鸟电子面单。
各家合作流程对比
快递电子面单接口&
a. 和多家快递公司申请账号&
b.分别进行接口对接&
c.电子面单服务用户向快递网点申请开通及确认合作细节
菜鸟电子面单&
a.向提交对接申请&
b.和菜鸟进行接口对接&
c.电子面单服务用户向菜鸟申请账号&
d.电子面单服务用户向快递网点申请开通及确认合作细节
快递鸟电子面单&
a. 进入，获取专属的ID和KEY&
b.和快递鸟进行接口对接&
c.电子面单服务用户向快递网点申请开通及确认合作细节；当然，顺丰电子面单稍微特殊一点，即：顺丰接入快递鸟立马可以使用，无需注册账号。
接口定义及说明
由于，当前快递鸟支持的电子面单接口相对于其他家的有一定优势；所以以下主要以快递鸟为例进行展开阐述一一说明。
Request Params
Api接口：&
请求方式：POST&
编码：UTF-8
系统级参数(公共参数)
RequestData
请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致
EBusinessID
商户ID，请在我的服务页面查看
RequestType
请求指令类型：1007
数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo
请求、返回数据类型：只支持JSON格式
备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。
用户自定义回调信息
CustomerName
电子面单客户账号（与快递网点申请）
CustomerPwd
电子面单密码
收件网点标识
ShipperCode
快递公司编码
LogisticCode
邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付
快递类型：1-标准快件
寄件费（运费）
上门取货时间段:”yyyy-MM-dd HH:mm:ss”格式化，本文中所有时间格式相同
上门取货时间段:”yyyy-MM-dd HH:mm:ss”格式化，本文中所有时间格式相同
物品总重量kg
件数/包裹数
物品总体积m3
IsReturnPrintTemplate
返回电子面单模板：0-不需要；1-需要
收件人公司
电话与手机，必填一个
电话与手机，必填一个
收件人邮编
ProvinceName
收件省（如广东省，不要缺少“省”）
收件市（如深圳市，不要缺少“市”）
ExpAreaName
收件区（如福田区，不要缺少“区”或“县”）
收件人详细地址
发件人公司
电话与手机，必填一个
电话与手机，必填一个
发件人邮编
ProvinceName
发件省（如广东省，不要缺少“省”）
发件市（如深圳市，不要缺少“市”）
ExpAreaName
发件区（如福田区，不要缺少“区”或“县”）
发件人详细地址
AddServices
AddService
增值服务名称
增值服务值
CustomerID
客户标识（选填）
Commoditys
Goodsquantity
GoodsPrice
商品价格
GoodsWeight
商品重量kg
商品体积m3
Response Params
EBusinessID
ResultCode
UniquerRequestNumber
PrintTemplate
面单打印模板
EstimatedDeliveryTime
订单预计到货时间yyyy-mm-dd
用户自定义回调信息
ShipperCode
快递公司编码
LogisticCode
MarkDestination
OriginCode
始发地区域编码
OriginName
始发地/始发网点
DestinatioCode
目的地区域编码
DestinatioName
目的地/到达网点
SortingCode
PackageCode
注：此栗子仅供参考，如要使用请到官方下载对应语言的Demo即可。
import java.io.BufferedR
import java.io.IOE
import java.io.InputStreamR
import java.io.OutputStreamW
import java.io.UnsupportedEncodingE
import java.net.HttpURLC
import java.net.URL;
import java.net.URLE
import java.util.HashM
import java.util.M
import com.sun.org.apache.xerces.internal.impl.dv.util.Base64;
import java.security.MessageD
* 快递鸟电子面单接口
* @技术QQ:
* @技术QQ群:
* @see: /MiandanAPI.aspx
* @copyright: 深圳市快金数据技术服务有限公司
* ID和Key请到官网申请：/ServiceApply.aspx
public class KdGoldAPIDemo {
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': '',& +
&'ShipperCode':'EMS',& +
&'PayType':1,& +
&'ExpType':1,& +
&'Cost':1.0,& +
&'OtherCost':1.0,& +
&'Sender':& +
&'Company':'LV','Name':'Taylor','Mobile':'','ProvinceName':'上海','CityName':'上海','ExpAreaName':'青浦区','Address':'明珠路73号'},& +
&'Receiver':& +
&'Company':'GCCUI','Name':'Yann','Mobile':'','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);
//根据公司业务处理返回的信息......
* @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. i++) {
int val = result[i] & 0
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));
@SuppressWarnings(&unused&)
private String urlEncoder(String str, String charset) throws UnsupportedEncodingException{
String result = URLEncoder.encode(str, charset);
* 电商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 =
BufferedReader in =
StringBuilder result = new StringBuilder();
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 ( 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&));
while ((line = in.readLine()) != null) {
result.append(line);
} catch (Exception e) {
e.printStackTrace();
//使用finally块来关闭输出流、输入流
if(out!=null){
out.close();
if(in!=null){
in.close();
catch(IOException ex){
ex.printStackTrace();
return result.toString();
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204其他Api接口，请转到具体查看相关文档。
&&相关文章推荐
* 以上用户言论只代表其个人观点，不代表CSDN网站的观点或立场
访问：897716次
积分：16354
积分：16354
排名：第584名
原创：728篇
转载：268篇
译文：11篇
评论：186条
文章：10篇
阅读：32773
(36)(51)(46)(69)(73)(48)(47)(22)(12)(22)(53)(48)(56)(57)(218)(101)(7)(1)(13)(22)顺丰菜鸟全面打通数据接口：又能用丰巢了 - 电商 -
顺丰菜鸟全面打通数据接口：又能用丰巢了
【亿邦动力网讯】由国家邮政局出面调停的“顺丰菜鸟之争”又有了实质性进展——丰巢和菜鸟数据端口再次打通。根据一位网友向亿邦动力网提供的截图显示，菜鸟物流配送的商品现已恢复顺丰自提柜提货功能，买家可实时查看货品在丰巢自提柜的物流进度。网友提供的菜鸟物流信息从宣告中止到再度全面重启，这场顺丰菜鸟之争足足用了十余天。6月1日，菜鸟网络发布声明，称顺丰于凌晨突然关闭对自提柜数据信息回传。当日中午，顺丰又进一步关闭整个淘宝平台物流信息回传。顺丰则回应称，是菜鸟先关闭丰巢数据接口，且丰巢需要返回包括非淘系订单在内的所有包裹信息给菜鸟。此外，阿里方面希望顺丰从腾讯云切换至阿里云。双方各执一词，互不相让，这也致使部分淘系平台商家和消费者的相关工作颇受困扰。但事件带来的影响正在持续升级，诸多互联网大佬甚至“选边站队”，让这场原本就火药味浓重的对峙变得更加微妙。而在这之中，国家邮政局的强势介入，起了决定性作用。双方也于6月3日握手言和。按照顺丰发布的公告，在国家邮政局的及时协调下，业务合作和数据传输自6月3日12时便已陆续恢复。但亿邦动力网也于当日询问了几家默认顺丰发货的天猫商家，发现情况略有差别。其中一位称，昨晚店铺已可选择通过顺丰发货，但不能展示物流信息；而另一位则表示，店中只有部分订单的顺丰物流信息恢复了显示，不过系统仍不稳定，消费者下单后如遇物流问题，可以向商家求助。现如今，这场对峙终于尘埃落地，但不可否认的是，此次多方力量参与对峙的核心在于物流大数据的争夺权。一件快递从寄出到签收，中间需要经过收件、分拣、运输、配送等繁多的作业流程。在“最后一公里”的配送方面，从订单入柜到消费者取件的整个流程物流数据涵盖了大量的有价值的信息。对于菜鸟和顺丰而言，掌握“最后一公里”的消费信息，也就意味着掌握了用户（包括C端和B端）最紧密的消费风向。没有人会怀疑这一大数据的商业价值，顺丰和菜鸟更不会。从两方的隔空喊话也能看到一些端倪。菜鸟在回应中曾提到，此事发生前，菜鸟根据安全团队的建议正在对全网物流数据进行信息安全升级，并将加强对海淘、快递柜等物流数据的多重交叉验证，但顺丰及丰巢等出于各种原因并不配合。顺丰则称，菜鸟网络要求丰巢提供与其无关的客户隐私数据，此类信息隶属于客户，丰巢本着“客户第一”的原则，拒绝这一不合理要求。值得一提的是，亿邦动力网也了解到，顺丰现已全面投入使用二维码运单。用户只要扫一扫二维码，输入寄件信息即可。收派员也不需要手动录入用户信息，替代了现有的手写运单工作。传统的快递单，上面会要求填写寄件地、收件地、号、收件人姓名等关键信息，而最新的顺丰快递单上，只有一个简单的二维码，用户的重要信息得到了更大程度的隐蔽。但也有业内人士称，隐私面单目前仍处于初级阶段，成效有待观察。因为如果没有一定的技术和服务支撑，会出现快递员找不到收件人，以及收件人也找不到自己的包裹的尴尬场景。
换一换
& 科技讯版权所有顺丰，与您一起创造双赢
共享顺丰各类服务系统业务接口，实现整体物流供应链一体化，提升作业效
率及用户体验，实现与顺丰的双赢
速递业务接入
已开放接口
办公日 9:30-18:30
技术交流群