云栈电子面单(易单宝)ISV白皮书-v0.4VIP

1、电子面单ISV接入白皮书云栈电子面单(易单宝)ISV白皮书V0.4DateVersionDescriptionAuthor2014.03.130.1全部章节新编写卓陵2014.03.260.21. 增加了CP编码；2. 获取面单号接口增加了division_id；3. 商家更新单号接口中trade_order_info_cols对象内容修正；4. 增加了API调用地址；5. 增加了Q&A卓陵2014.04.160.31. 增加了筛单接口：判断物流地址是否可达；2. 更新了部分物流公司模板3. 更新了面单二维码部分，扫码跳转到物流评价页4. 更新了部分API参数(详见各API)5. 更新了部分F

2、AQ卓陵2014.04.240.41. 增加了快递公司条码生成规则(四.电子面单模板第3部分)卓陵一、前言51. 业务背景52. 名词解释63. 重要说明63.1 云栈易单宝平台所用到编码参考规范63.2 商家开通使用易单宝条件7二、电子面单方案71. 时间计划72. 云栈易单宝平台业务模型73. 商家业务流程83.1 商家的核心业务环节83.2 服务开通申请9三. 核心接口111. 获取电子面单号111.1 应用场景111.2 规则111.3 API内容112. 更新电子面单号142.1 应用场景142.2 规则142.3 API介绍143. 获取发货地&CP开通状态&面单号余额153.1

3、应用场景153.2规则163.3 API介绍164. 筛单接口1：判断收件地址是否可达174.1 应用场景174.2规则174.3 API介绍175. 筛单接口2：查询支持起始地到目的地的物流公司185.1 应用场景185.2规则185.3 API介绍18四、电子面单模板181. 通用电子面单模板182. 各快递公司电子面单模板20五、电子面单二维码21六、FAQ22一、前言1. 业务背景随着电子商务平台和物流服务信息化飞速发展，面单号(或称之为运单号)成为物流服务商串联快递单、订单、商家、商品等各种信息的枢纽。相比之下，传统纸质面单价格高、信息录入效率低、信息安全隐患等方面的劣势已愈发凸显。

4、近一年来，电子面单的普及已是大势所趋。究其原因，是因为电子面单具备的独特优势：a. 效率更高n 打印效率比纸质面单提升60%-90%，每小时可打印数千张；n 对于商家，运单和拣货单可选用一张热敏纸，提高拣选效率；商家甚至在打包完成后的确认环节再去实时打印面单，高速打印确保订单能快速准确完成。b. 成本更低n 面单成本比传统纸质面单降低5倍以上；n 降低快递公司作业成本（例：据顺丰反馈，一个50人的揽收团队，使用电子面单后可降低至10人，人力成本降低5倍以上）；n 可去掉快递录单过程、提高分拨中心的分拣效率，大大提升快递处理效率，使自动分拣等技术含量高的设备投入使用成为可能，为产业升级提供技术基

5、础；n 电商增值业务支持，无需人肉绑定面单（例如：货到付款，预约配送）。c. 消费者隐私信息安全n 通过二维码隐藏收件人的隐私信息，避免消费者个人隐私泄露。2. 名词解释1云栈云栈是菜鸟和聚石塔、开放平台合作推出的一系列物流云服务。包含电子面单，智能筛单，物流推荐，安全物流云环境等，希望能通过云计算和大数据技术，不断提高商家和物流服务商效率、降低成本，提升消费者购物体验。2易单宝易单宝是云栈平台的重要服务，即电子面单服务平台。3电子面单一种新型的快递面单。材料为热敏纸，有成本低、打印快、单号方便获取、管理等特点。4电子面单二维码将收件人的隐私信息隐藏在二维码中，派件员通过可通过手持设备扫码解密

6、；消费者可以扫码进行物流评价。5TMSTransportation Management System 物流管理系统。6WMSWarehouse Management System 仓库管理系统。7TP淘拍档，即优质电子商务服务提供商。他们的产品及服务质量经过淘宝网审核，被授予“淘拍档”称号，拥有“淘拍档”授牌。淘拍档类别包含了工具软件类、运营服务类、研究咨询类等。8CP菜鸟合作伙伴，主要指物流服务商。包括顺丰，EMS，宅急送，三通一达等。3. 重要说明3.1 云栈易单宝平台所用到编码参考规范a. 物流服务商(cp_code) : 顺丰(SF)、EMS(标准快递：EMS；经济快件：EYB)、宅

7、急送(ZJS)、圆通(YTO)、中通(ZTO)、百世汇通(HTKY)、优速(UC)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连接TOP session的u

8、ser_id，和在卖家中心开通服务的账号的user_id一致。二、电子面单方案1. 时间计划 一期于2014年4月中下旬上线.支持直营模式物流服务商：顺丰、EMS、宅急送；加盟物流服务商：百世汇通，优速。 二期计划2014年5月上线。预计支持物流服务商：中通，圆通，韵达，申通。2. 云栈易单宝平台业务模型易单宝将对接各物流服务商，统一向ISV提供包括电子面单在内的一系列服务。除了本期接入的几家物流服务商，未来还会逐步接入更多服务商，而ISV则无需任何改造即可平滑过渡。接入模式如下：3. 商家业务流程3.1 商家的核心业务环节a. 商家申请开通。在卖家中心完成；b. 物流服务商审核。申请后，物流

9、服务商将进行审核，审核结果可以在卖家中心查看；c. 商家使用。审核通过后，商家即可在支持易单宝的ERP或WMS中使用电子面单服务。3.2 服务开通申请商家需要在下图所示的路径开通电子面单服务。特别注意：商家登陆卖家中心后台申请开通电子面单服务的卖家user_id，必须与在ERP中执行申请电子面单等数据交互过程session中的user_id保持一致。开通直营物流服务商(下图以顺丰为例)；需要填入顺丰的月结账号，如果没有可以不填。开通加盟物流服务商，至少填入一个网点信息。三. 核心接口1. 获取电子面单号1.1 应用场景商家根据订单信息，实时、批量获取指定物流服务商的电子面单号。1.2 规则a.

10、 支持淘系和非淘系订单；b. 商家调用API session中的user_id要和卖家中心里开通服务的user_id保持一致；c. 支持批量获取，每次最多获取50个面单号；d. 同一订单号可以重复请求，如果面单号已存在，则返回已分配面单号；如果面单号已回收，则生成新面单号。1.3 API内容基本信息：API地址 taobao.wlb.waybill.get功能描述商家获取物流服务商电子面单号服务调用方TOP输入参数：名称类型是否必填示例值默认值描述cp_codeNumberYesSF物流服务商Codeshipping_addressprovince 非空cityareatown divisio

11、n_id address_detail 非空ObjectYes见下发货地(一次请求只能传同一个发货地)省和详细地址必填；市、区、街道选填。division_id是发货地最细粒度地址IDtrade_order_info_colsprovince 非空cityareatownaddress_detail 非空 consign_name 非空 consign_phone 非空 trade_order_list 非空 order_channels_type 非空 item_name 非空ObjectYes见下订单信息对象。包括：收件人姓名、地址、联系方式，订单来源，店铺名，商品，订单号。trade_o

12、rder_info_cols对象参数解析：consign_name，收件人姓名consignPhone，收件人联系方式tradeOrderList，订单id 可以合单(合单时建议传所有子订单号，至少传一个子订单号)，orderChannelsType，订单来源itemName，商品名称示例值：shipping_address：province:浙江省,city:杭州市,area:余杭区,division_id:330110,address_detail:文一西路969号trade_order_info_cols: consignee_address: address_detail: 朝阳路高井

13、，财满街，财经中心9号楼21单元6013, area: 朝阳区, area_code: 0, city: 北京市, city_code: 0, division_id: 0, province: 北京, province_code: 0, town_code: 0 , consignee_name: 我亮, consignee_phone: 12312312311, item_name: 沙箱测试:集市商品同步测试0001, order_channels_type: TB, trade_order_list: SW-20140403-00654 返回结果：名称类型是否必须示例值描述waybil

14、l_apply_newcolswaybill_codeshort_addressfeaturetrade_order_listorder_channels_typeObjectYes见下面单号集合waybill_apply_newcols对象字段解析：waybill_code，面单号；short_address，大头笔信息；feature，预留可扩展字段示例值：waybill_code 222short_address 浙江杭州feature key1:value2;key2:value2trade_order_list 111，112order_channels_type TB2. 更新电子

15、面单号2.1 应用场景商家更新电子面单号对应的订单信息。2.2 规则a. 支持淘系、非淘系订单；b. 如果是加盟物流服务商，不能更新为发货地为另外一个网点的订单。2.3 API介绍基本信息：API名称taobao.wlb.waybill.update功能描述商家可更新单号的订单绑定关系服务调用方TOP输入参数：名称类型是否必填示例值默认值描述cp_codeNumberYes物流服务商Codewaybill_codeNumberYes需要更新的面单号trade_order_info_cols province 非空cityareatown address_detail 非空 consign_na

16、me非空 consign_phone非空 tradeOrderList 非空 order_channels_type 非空 item_name非空ObjectYes参见获取面单号接口订单信息对象。包括：收件人姓名、地址、联系方式，订单来源，店铺名，商品，订单号。trade_order_info_cols入参示例：consignee_address:address_detail:文三西路100号,area:一区,city:宁波市,division_id:330112,province:浙江省,consignee_name:ykz,consignee_phone:123442311,item_na

17、me:洗衣机,order_channels_type:TB,waybill_code:8000000034013,trade_order_list:1234返回结果：名称类型是否必须示例值描述trade_order_info_cols对象参数解析：见“商家获取面单号”API3. 获取发货地&CP开通状态&面单号余额3.1 应用场景商家可以查询已开通电子面单的物流服务商的面单号余额，以及网点开通状态。3.2规则a. 已开通的加盟型物流公司返回发货地、网点和面单余额，直营型物流公司返回发货地；b. 未开通物流服务商返回失败。3.3 API介绍基本信息：API名称taobao.wlb.waybill

18、.search功能描述商家查询物流服务商的可用单号服务调用方TOP输入参数：名称类型是否必填示例值默认值描述seller_idStringYes100000申请开通易单宝的sellerIDcp_codeNumberYes12345物流服务商Code返回结果：名称类型示例值描述Subscribtionsprovincecityareatownaddress_detail branch_code quantity unshipped_quantityObject见下返回的发货地址、网点以及面单余额；直营快递无单号余额限制，但是易单宝会在服务端控制以避免恶意获取。Subscribtions对象参数解

19、析：branch_code 网点编码；branch_name 网点名称；quantity账户余额；unshipped_quantity 未确认发货的数量。4. 筛单接口1：判断收件地址是否可达(推荐使用)将整合所有物流公司精确到4级的派送能力数据，结合高德的地址解析技术以及物流公司的进一步精准判断能力，为商家提供最有效的是否可达服务。优化后的接口，筛单精准度会从现有的76%提升至90%以上（预计5月底完成）。4.1 应用场景根据输入的目的地地址和选择的物流公司，判断服务是否可达。(支持EMS、汇通、顺丰、天天、圆通、宅急送、中通)4.2规则暂无4.3 API介绍基本信息：API名称taobao

20、.logistics.address.reachable功能描述查询目的地是否可达服务调用方TOP详见TOP页面：5. 筛单接口2：查询支持起始地到目的地的物流公司将整合所有物流公司精确到4级的派送能力数据，结合高德的地址解析技术以及物流公司的进一步精准判断能力，为商家提供最有效的是否可达服务。接口优化后，筛单精准度较将从现在的76%提升至90%以上（预计6月初上线）。5.1 应用场景根据输入的发货地和目的地，判断有哪些物流公司可达。5.2规则暂无5.3 API介绍基本信息：API名称taobao.logistics.partners.get功能描述查询目的地是否可达的物流公司服务调用方TOP

21、详见TOP页面：四、电子面单模板1. 各快递公司电子面单模板商家需要使用快递公司提供的模板打印、发货，否则快递公司可能会拒绝揽收。目前提供电子面单模板的包括：顺丰，EMS，宅急送，圆通，百世汇通，优速。下载地址：提取码：BuEqSt2. 通用电子面单模板对于没有提供电子面单模板的快递公司，可以使用空白热敏纸打印标准模板替代，替换不同快递公司LOGO即可。易单宝联合本期接入的多家物流服务商，共同推出基础的电子面单模板。ISV可遵循以下模板规范提供给商家打印使用。模板样式(以顺丰为例，各快递公司模板将持续更新) 尺寸规范：为保持打印机耗材一致，纸张尺寸要求宽度确定，长度可适当调整：宽度确保在10c

22、m；长度建议15cm，可根据需要自行确定。(12-15用下面15号的字体) 内容规范：每家快递物流服务商对面单内容有个性化要求，易单宝电子面单规范里加入了2个新内容选项：2)，物流服务表达；16)，电子面单二维码。【说明：2，物流服务表达：包含物流服务名称和服务描述。如模板中的：“次日必达”，“2014/3/13，上午必达”】3. 各快递公司面单号生成条码的规则CODE各快递公司的单号生成条码要用128码方式生成，具体CODE规则如下：序号快递公司名称面单码CODE1顺丰128C2宅急送128A3EMS128A4百世汇通128C5中通128B6优速128C必须严格按照此条码生成规则生成条码，否

23、则快递公司巴枪可能无法扫描。五、电子面单二维码说明：物流评价功能还在开发中，预计5月底-6月初发布，电子面单二维码位置建议先留空；物流评价上线后再更新。消费者收到包裹后，可以扫码电子面单上的二维码可以进行物流评价。未来，电子面单可能会隐藏收件人部分个人隐私信息，物流服务商的派件员扫码验证后才能获取，最大限度的保证消费者隐私安全。二维码打印在电子面单的指定区域，具体详见电子面单模板设计。 二维码尺寸长*宽：25mm*25mm 电子面单二维码文案二维码下方显示文字提示用户进行操作，建议文案：“扫码评价” 二维码内容二维码完整内容：由一个固定URL(黄色URL部分还需要调整)和3个参数组成： cpC

24、ode =SF&sellerID=0123456& waybillCode=88917679009- URL和参数说明：名称是否必填示例值描述Yes100000固定URL。用于消费者扫码后，根据 cp_code 跳转到物流评价页面cp_codeYesSF物流服务商CodesellerIDYes0010222订单对应店铺的sellerIDwaybillCodeYes8891面单号 扫码后的页面物流评价页面：六、FAQQ: 商家如何才能使用电子面单服务？A: 商家需要登录：淘宝-卖家中心-物流服务-易单宝，选择物流服务商，申请开通服务。申请通过后即可在ERP中使用(ERP已对接云栈的电子面单平台。)Q: 现在开通了哪些