云栈电子面单(易单宝)白皮书

云栈电子面单(易单宝)ISV白皮书
一、前言 (4)
1.业务背景 (4)
2.名词解释 (5)
3.重要说明 (6)
3.1 云栈易单宝平台所用到编码参考规范 (6)
3.2 商家开通使用易单宝条件 (6)
二、电子面单方案 (6)
1.时间计划 (6)
2.云栈易单宝平台业务模型 (6)
3.商家业务流程 (7)
3.1 商家的核心业务环节 (7)
3.2 服务开通申请 (8)
三. 核心接口 (10)
1.商家获取面单号API (10)
2.商家更新面单号API (13)
3.服务商开通状态&面单号余额查询API (14)
四、电子面单标准模板和安全二维码 (15)
1.标准模板 (15)
2.安全二维码 (17)
一、前言
1. 业务背景
随着电子商务平台和物流服务信息化飞速发展，面单号(或称之为运单号)成为物流服务商串联快递单、订单、商家、商品等各种信息的枢纽。

相比之下，传统纸质面单价格高、信息录入效率低、信息安全隐患等方面的劣势已愈发凸显。

近一年来，电子面单的普及已是大势所趋。

究其原因，是因为电子面单具备的独特优势：
a.效率更高
⏹打印效率比纸质面单提升60%-90%，每小时可打印数千张；
⏹对于商家，运单和拣货单可选用一张热敏纸，提高拣选效率；商家甚至在打包完成
后的确认环节再去实时打印面单，高速打印确保订单能快速准确完成。

b.成本更低
⏹面单成本比传统纸质面单降低5倍以上；
⏹降低快递公司作业成本（例：据顺丰反馈，一个50人的揽收团队，使用电子面单
后可降低至10人，人力成本降低5倍以上）；
⏹可去掉快递录单过程、提高分拨中心的分拣效率，大大提升快递处理效率，使自动
分拣等技术含量高的设备投入使用成为可能，为产业升级提供技术基础；
⏹电商增值业务支持，无需人肉绑定面单（例如：货到付款，预约配送）。

c.消费者隐私信息安全
⏹通过二维码隐藏收件人的隐私信息，避免消费者个人隐私泄露。

2. 名词解释
3. 重要说明
3.1 云栈易单宝平台所用到编码参考规范
a.物流服务商(cpCode) (待定):
顺丰、EMS、宅急送、中通、百世汇通、优速；
b.订单来源：订单产生的电商平台
淘宝(TB)、天猫(TM)、京东(JD)、当当(DD)、拍拍(PP)、易讯(YX)、ebay(EBAY)、QQ网购(QQ)、亚马逊(AMAZON)、苏宁(SN)、国美(GM)、唯品会(WPH)、聚美(JM)、乐蜂(LF)、蘑菇街(MGJ)、聚尚(JS)、拍鞋(PX)、银泰(YT)、1号店(YHD)、凡客(VANCL)、邮乐(YL)、优购(YG)、其他(OTHERS)
3.2 商家开通使用易单宝条件
商家要在ERP中使用电子面单服务，必须保证登录到ERP连接TOPsession的user_id，和在卖家中心开通服务的账号的user_id一致。

二、电子面单方案
1. 时间计划
✓一期于2014年4月中下旬上线.支持直营模式物流服务商：顺丰、EMS、宅急送；加盟物流服务商：中通，百世汇通，优速。

✓二期计划2014年5月上线。

预计支持物流服务商：韵达，申通，圆通（待定）。

2. 云栈易单宝平台业务模型
易单宝将对接各物流服务商，统一向ISV提供包括电子面单在内的一系列服务。

除了本期接入的几家物流服务商，未来还会逐步接入更多服务商，而ISV则无需任何改造即可平滑过渡。

接入模式如下：
3. 商家业务流程
3.1 商家的核心业务环节
a. 商家申请开通。

在卖家中心完成；
b. 物流服务商审核。

申请后，物流服务商将进行审核，审核结果可以在卖家中心查看。

c. 商家使用。

审核通过后，商家即可在支持易单宝的ERP或WMS中使用电子面单服务。

3.2 服务开通申请
商家需要在下图所示的路径开通电子面单服务。

特别注意：商家登陆卖家中心后台申请开通电子面单服务的卖家user_id，必须与在ERP 中执行申请电子面单等数据交互过程session中的user_id保持一致。

开通直营物流服务商(下图以顺丰为例)；需要填入顺丰的月结账号，如果没有可以不填。

开通加盟物流服务商，至少填入一个网点信息。

三. 核心接口
1.商家获取面单号API
1.1 应用场景
商家根据订单信息，实时、批量获取指定物流服务商的电子面单号。

1.2 规则
a.支持淘系和非淘系订单；
b.商家调用API session中的user_id要和卖家中心里开通服务的user_id保持一致；
c.支持批量获取，每次最多获取100个面单号；
d.同一订单号可以重复请求，如果面单号已存在，则返回已分配面单号；如果面单号已
回收，则生成新面单号。

1.3 API内容
基本信息：
输入参数：
tradeOrderInfoCols对象参数解析：
consignName，收件人姓名
consignPhone，收件人联系方式
tradeOrderList，订单id可以合单(合单时建议传所有子订单号，至少传一个子订单号)，orderChannelsType，订单来源
shopTitle，店铺名
itemName，商品名称
示例值：
province 浙江省
city 杭州市
area余杭区
addressDetail文一西路969号阿里巴巴淘宝城consignName周大福
consignPhone186********
tradeOrderList 111，112多个订单号用“，”分开orderChannelsTypeTB
shopTitle海尔旗舰店
itemName 洗衣机
返回结果：
waybillApplyNewCols对象字段解析：waybillCode，面单号；
shortAddress，大头笔信息；
feature，预留可扩展字段
示例值：
waybillCode222
shortAddress 浙江杭州
featurekey1:value2;key2:value2 radeOrderList 111，112 orderChannelsType TB
2. 商家更新面单号API
2.1 应用场景
商家更新面单号对应的订单信息。

2.2 规则
a.支持淘系、非淘系订单；
b.如果是加盟物流服务商，不能更新为发货地为另外一个网点的订单。

2.3 API介绍
基本信息：
输入参数：
返回结果：
3.
服务商开通状态&面单号余额查询API 3.1 应用场景
商家可以查询已开通电子面单的物流服务商的面单号余额，以及网点开通状态。

3.2规则
a. 已开通的加盟型物流公司返回发货地、网点和面单余额，直营型物流公司返回发货地；
b. 未开通物流服务商返回失败。

3.3 API 介绍
基本信息：
输入参数：
返回结果：
Subscribtions对象参数解析：
branchCode 网点编码；
branchName网点名称；
quantity账户余额；
unshippedQuantity 未确认发货的数量。

四、电子面单标准模板和安全二维码
1. 标准模板
由于各家物流服务商的电子面单尺寸、规范不尽相同，商家往往需要准备多套打印设备和耗材，这不仅为商家带来额外成本，也降低了作业效率。

易单宝联合本期接入的多家物流服务商，共同
推出基础的电子面单模板。

ISV需遵循以下模板规范提供给商家打印使用。

未来新接入的物流服务商也会逐步统一标准化，不断提升商家的工作效率。

✓模板样式(以顺丰为例，各快递公司模板将持续更新)
✓尺寸规范：
为保持打印机耗材一致，纸张尺寸要求宽度确定，长度可适当调整：宽度确保在10cm；长度建议15cm，可根据需要自行确定。

✓内容规范：
每家快递物流服务商对面单内容有个性化要求，易单宝电子面单规范里加入了2个新内容选项：2，物流服务表达；16，安全二维码。

- 2，物流服务表达：包含物流服务名称和服务描述。

如模板中的：“次日必达”，“2014/3/13，上午必达”
- 16，安全二维码：如下。

2. 安全二维码
安全二维码可以用于一码多扫。

消费者扫码可以关注指定物流服务商的来往公众账号，并便捷获取物流服务。

未来，电子面单可能会隐藏收件人部分个人隐私信息，物流服务商的派件员扫码验证后才能获取，最大限度的保证消费者隐私安全。

二维码打印在电子面单的指定区域，具体详见电子面单模板设计。

✓二维码尺寸
长*宽：25mm*25mm
✓安全二维码文案
ISV可自定义，但要求体现来往和物流服务商，如：顺丰速运.来往
✓二维码内容
- 二维码完整内容：由一个固定URL和3个参数组成
/test/qrcode.htm?cpCode=SF&sellerID=0123456& waybillCode=88917679009 - URL和参数说明：。