云栈电子面单二期白皮书

《云栈电子面单二期白皮书》由会员分享，可在线阅读，更多相关《云栈电子面单二期白皮书（40页珍藏版）》请在金锄头文库上搜索。

1、电子面单ISV接入白皮书云栈电子面单二期白皮书_v0.6DateVersionDescriptionAuthor2014.11.250.6全部章节新编写赤蛇，溪行目录一、前言51. 业务背景52. 名词解释63. 编码规范63.1 云栈：物流服务商编码规范s63.2 云栈：订单产生的电商平台编码规范74. 系统设计规范74.1 打单流程设计74.2 流程关键节点规范84.3 系统设计注意点124.4 系统风控校验13二、电子面单方案131. 支持物流商132. 云栈平台业务模型133. 商家业务流程143.1 商家的核心业务环节143.2 服务开通申请15三. 核心接口161. 获取电子面单号

2、161.1 应用场景161.2 规则161.3 API内容173. 获取发货地&CP开通状态&账户的使用情况213.1 应用场景213.2规则213.3 API介绍214. 取消获取的电子面单234.1 应用场景234.2规则234.3 API介绍23取消获取的电子面单235. 打印确认接口245.1 应用场景245.2规则245.3 API介绍25打印确认接口256. 查面单号状态276.1 应用场景276.2规则276.3 API介绍277. 更新电子面单号307.1 应用场景307.2 规则307.3 API介绍308. 筛单接口：判断收件地址是否可达348.1 应用场景348.2 AP

3、I介绍34四、电子面单模板351. 各快递公司电子面单模板352. 各快递公司面单号生成条码的规则CODE35五、电子面单二维码36六、FAQ37一、前言1. 业务背景随着电子商务平台和物流服务信息化飞速发展，面单号(或称之为运单号)成为物流服务商串联快递单、订单、商家、商品等各种信息的枢纽。相比之下，传统纸质面单价格高、信息录入效率低、信息安全隐患等方面的劣势已愈发凸显。近一年来，电子面单的普及已是大势所趋。究其原因，是因为电子面单具备的独特优势：a. 效率更高n 打印效率比纸质面单提升60%-90%，每小时可打印数千张；n 对于商家，运单和拣货单可选用一张热敏纸，提高拣选效率；商家甚至在打

4、包完成后的确认环节再去实时打印面单，高速打印确保订单能快速准确完成。b. 成本更低n 面单成本比传统纸质面单降低5倍以上；n 降低快递公司作业成本（例：据顺丰反馈，一个50人的揽收团队，使用电子面单后可降低至10人，人力成本降低5倍以上）；n 可去掉快递录单过程、提高分拨中心的分拣效率，大大提升快递处理效率，使自动分拣等技术含量高的设备投入使用成为可能，为产业升级提供技术基础；n 电商增值业务支持，无需人肉绑定面单（例如：货到付款，预约配送）。c. 消费者隐私信息安全n 通过二维码隐藏收件人的隐私信息，避免消费者个人隐私泄露。2. 名词解释1云栈云栈是菜鸟和聚石塔、开放平台合作推出的一系列物流

5、云服务。包含电子面单，智能筛单，物流推荐，安全物流云环境等，希望能通过云计算和大数据技术，不断提高商家和物流服务商效率、降低成本，提升消费者购物体验。2电子面单一种新型的快递面单。材料为热敏纸，有成本低、打印快、单号方便获取、管理等特点。3电子面单二维码将收件人的隐私信息隐藏在二维码中，派件员通过可通过手持设备扫码解密；消费者可以扫码进行物流评价。4TMSTransportation Management System 物流管理系统。5WMSWarehouse Management System 仓库管理系统。6TP淘拍档，即优质电子商务服务提供商。他们的产品及服务质量经过淘宝网审核，被授予“

6、淘拍档”称号，拥有“淘拍档”授牌。淘拍档类别包含了工具软件类、运营服务类、研究咨询类等。7ISVERP、WMS等软件开发商8CP菜鸟合作伙伴，主要指物流服务商。包括顺丰，EMS，宅急送，三通一达等。3. 编码规范3.1 云栈：物流服务商编码规范s顺丰(SF)、EMS(标准快递：EMS；经济快件：EYB)、宅急送(ZJS)、圆通(YTO)、中通(ZTO)、百世汇通(HTKY)、优速(UC)、申通(STO)、天天快递(TTKDEX)、全峰(QFKD)、快捷(FAST)、邮政小包(POSTB)、国通(GTO)、韵达(YUNDA)。3.2 云栈：订单产生的电商平台编码规范淘宝(TB)、天猫(TM)、京

7、东(JD)、当当(DD)、拍拍(PP)、易讯(YX)、ebay(EBAY)、QQ网购(QQ)、亚马逊(AMAZON)、苏宁(SN)、国美(GM)、唯品会(WPH)、聚美(JM)、乐蜂(LF)、蘑菇街(MGJ)、聚尚(JS)、拍鞋(PX)、银泰(YT)、1号店(YHD)、凡客(VANCL)、邮乐(YL)、优购(YG)、阿里巴巴(1688)、其他(OTHERS)。4. 系统设计规范4.1 打单流程设计综合前置和后置两种打印流程，建议ERP及其它软件 打单流程如下：前置打单流程后置打单流程4.2 流程关键节点规范4.2.1余额控制（进入ERP等系统 订单审核/search接口）余额预警，需要ERP和

8、云栈双方做校验控制余额整体预警框架如图所示：（ERP余额判断）进入【订单审核】阶段时，调用【查询】接口更新余额，如果过低给出相应提示（云栈余额判断）1. 在调用【申请】接口批量获取单号前，需要在云栈二次判断余额数是否低于请求数（余额是否够用）2. 如果余额不够请求数，不返回面单号，并给出警告信息，提示商家充值余额预警4.2.2 订单审核（字段信息）主要审核订单字段信息（加粗为必须字段）- 买家姓名- 联系方式- 买家昵称- 买家留言- 买家省份- 买家市(州)- 买家-县(区)- 买家-镇(街道) - 收货地址- 邮编- 订单号- 订单备注- 包裹数量- 商品综述- SKU数量- 实付金额-

9、发票信息- 代收货款- 运费- 优惠金额4.2.3 选择物流公司（开通状态）区分标识物流公司电子面单服务开通状态（以颜色区分为例）- 情况1：未接入电子面单服务，只能使用传统面单服务（红）- 情况2：已接入电子面单服务，但未和该ERP在云栈调通，需线下调通（黄）- 情况3：已接入电子面单服务，且已在云栈与该ERP调通，可正常使用（绿）4.2.4 选择物流模板（匹配机制）物流模板规范和匹配机制（物流模板）- ISV锁定模板界面，商家不能修改- 选择好物流公司后，自动匹配模板，保证不会选错模板（设置匹配机制，传统&电子）4.2.5 信息变更（fullupdate和cancel接口）获取电子面单号后

10、，信息变更，更新(fullupdate) 和 取消(cancel) 的具体流程【更新接口】1. 涉及到订单信息（如拆/合单、取消订单等）、修改发货地的逻辑时候，由之前的UPDATE接口操作升级为CANCEL+GET组合操作。一般的面单信息更新可以使用FULLUPDATE接口；2. 已揽件的面单不能再更新，允许打印；3.新的更新操作升级为fullupdate接口(1) 与发货地址修改和拆合单修改不相关的，直接调用fullupdate接口，更新变更字段；(2) 与发货地址修改和拆合单修改相关的，先调用CANCEL接口回收面单号，然后调用GET接口获取新面单号；4. 每次更新信息时，如果面单状态为已

11、打印，则总有效打印面单数-1。【取消接口】1. 每个面单号只能取消1次，且取消后不能复用，统一由云栈回收和传统面单一样，电子面单号的使用为一次性的，获取单号后，一旦【取消】即视为作废，单号进入冻结状态，商家不能复用，但可以查询。2. 记录商家面单取消量取消的面单号不能复用3. 每个订单号只允许取消5次即针对同1个订单，进行了GET+CANCEL操作达5次，则拒绝该订单取号4. 取消的面单号不能打印，5. 已揽件的面单号不能取消7. 每调用1次取消接口，面单余额保持不变4.2.6 打印物流单（PRINT接口）打印前需调用新增的“打印校验(PRINT)”接口，要求ISV必须调用【接口使用规范】1.

12、 每个面单号每次打印前，都要调用校验接口进行信息二次校验2. 打印之后，仍然可以更新字段信息，更新后需要重新打印3. 主要校验的内容(1)面单是否合法 规则约束判断(2)面单是否取消 数据查询判断(2)面单信息是否一致 字段匹配4. 记录并返回打印次数(1) 商家打印面单数（面单）取值范围：0, 1更新机制：每次调用PRINT打印成功之后打印次数+1每次调用UPDATE或CANCEL或FULLUPDATE，判断是否打印，如果是则将面单打印次数-1(2) 单个面单打印次数取值范围：=0更新机制：每次调用CHECK后打印则次数+1每次调用前判断是否已打印，如果已经打印过，返回打印次数和重复打印的提

13、示（ISV做显示）CHECK不通过时，返回的错误信息要具体到字段取消的面单号不允许打印，但目前兼容一期的更新逻辑用Log记录每一次打印时间统一电子面单打印纸（短期较难统一，双11之后规划方案）初步统一计划如下：(1) 打印页完全空白；(2) 贴纸页（撕掉CP留单后显示的页面）打上商家LOGO，驱动商家自行购买打印纸(3) 客户留单（物流服务商logo）【校验接口】说明（元数据）接口提供方：云栈平台接口调用方：ISV支持调用方式：同步接口描述：商家从云栈平台获取完电子面单号后，在打印之前调用此接口可以再次校验订单信息，确保正常打印，避免出现虚假订单、重复发货等错误；要求ISV必须调用 （接口字段

14、说明，请参考接口API文档）4.2.7 举证维权（凭证，走搜索引擎）可打印【电子面单】作为商家维权凭证需要ERP确保，已经发货或揽件的订单，还能再次打印物流单，并且和电子面单信息进行校验，一致时才能做为有效凭证；物流单号物流公司；物流单号；商家接口说明- 订单号- 订单来源- 物流单号- 大头笔- 物流单号状态- 物流公司CP - 网点信息- 发货人姓名- 发货人电话- 使用者ID- 发货-省份- 发货-市(州)- 发货-县(区)- 发货-镇(街道)- 详细发货地址- 收货人姓名- 收货人电话- 收货-省份- 收货-市(州)- 收货-县(区)- 收货-镇(街道)- 详细收货地址- 商品名称- 包裹特征(重量)- 服务类型- 产品类型-二维码定制内容4.3 系统设计注意点1、打单过程中，一些重复单号的打印。需要弹框提醒用户，该单号已打印。2、因为电子面单是用热感敏打印机打印的。为了防止用户混淆。 传统面单模版与电子面单模版最好有区分。一般通过先选模版，再获取单号打印的方式会比较好。3、修改了面单号对应的订单信息，务必要调用更新接口，进行信息更新。举例如：用