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

云栈电子面单(易单宝)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余杭区