双11保障服务商白皮书
业务背景
2014年双十一当天在整个物流发货包裹中，通过云栈电子面单发货的包裹占了重要的比例，经历过双十一的考验之后，电子面单的渗透率也再不断提升，今年云栈将努力为商家提供更加快捷、安全和方便的发货保障。电子面单当前的API接口包含了：
| 接口名称 | 简介 |
|---|---|
| taobao.wlb.waybill.i.cancel | 取消获取的电子面单 |
| taobao.wlb.waybill.i.print | 打印确认接口 |
| taobao.wlb.waybill.i.querydetail | 查面单号状态 |
| taobao.wlb.waybill.i.fullupdate | 面单信息更新接口 |
| taobao.wlb.waybill.i.get | 获取物流服务商电子面单号 |
| taobao.wlb.waybill.i.search | 查询面单号开通及剩余单量情况 |
| taobao.wlb.waybill.i.distributeinfo | 分拣信息获取API |
新功能介绍
统一模板
由于商家、网点等多方根据各自情况的需求，经常出现要求ISV在ERP或打单软件中修改模板的情况，从而使得电子面单模板上的信息出现紊乱，导致CP无法进行分拣，最终引起消费者、卖家、ISV和平台各方处理异常件的时间和人力成本。
总结：
| 现状 | 问题总结（痛点需求） |
|---|---|
| 1.每个快递公司1套模板，模板过多，ISV处理繁琐; 2.模板通过说明文档线下给ISV，更新效率低 3. 商家修改可以随意修改模板，导致物流公司无法分拣 | 1.模板各家不同，商家和ISV管理困难;2.商家修改需求强烈，但修改不规范;3.商家修改后平台和ISV都无感知 |
为了解决以上三个问题，我们分三步进行优化：
- 统一了15家快递公司的电子面单模板，设计了一款通用的统一模板；
- 推出和通用模板配套的官方 “菜鸟打印组件(CaiNiaoPrint)”，并在预留了【商家自定义区】满足商家修改诉求的情况下，完全锁定了物流公司相关的分拣信息，即商家非自定义区；
- 为 “菜鸟打印组件” 建立服务器通信机制，使得商家能通过该打印组件自动更新模板和打印组件。
方案目标如下：
在 “统一模板” 和 “菜鸟打印组件” 的共同作用下，精细化区分了ISV和打印组件的分工：ISV只负责传值，打印组件只负责模板管理（含更新、打印等）。本技术文档用于说明ISV和打印组件如何对接，从而使ISV传的值能准确被打印组件解析，彼此间的对接关系如下图所示。
打印模板改造的变动：
- get?接口的入参?，需要传入oid，需要根据oid识别是否是双11打标，打标的面单会在双11在快递公司那里享受优先；
- get?接口的入参?，需要传入real_user_id，淘系订单需要，将和oid一起在发货的时候做校验，可以通过；
- get?接口的结果?，增加print_config字段，需要将这个字段透传给打印组件。 ?
风控改造
本次技术白皮书需要ISV协助改造的第二个方面是关于 “电子面单号被非法使用” 的问题，伴随着电子面单被越来越广泛的使用，一些商家通过各种非正常手段对电子面单号进行了各种非法使用，给商家、物流公司、ISV和电子面单平台带来了诸如结算、纠纷和客服压力等问题.
一些比较常见的场景如下表所示：
| 序号 | 电子面单号被非法使用的场景 | 问题总结（痛点需求） |
|---|---|---|
| 1 | 单号已取消，但却被用于发货 | 面单号生成的时候，实质是绑定了【商家-订单-面单】的三者关系，而在 “确认发货” 之前，商家都可以随意修改这三者的绑定关系，从而产生非法使用面单号的场景 |
| 2 | 单号已回收，但却被用于发货 | 面单号生成的时候，实质是绑定了【商家-订单-面单】的三者关系，而在 “确认发货” 之前，商家都可以随意修改这三者的绑定关系，从而产生非法使用面单号的场景 |
| 3 | 单号未获取，但却被提前用于发货 | 面单号生成的时候，实质是绑定了【商家-订单-面单】的三者关系，而在 “确认发货” 之前，商家都可以随意修改这三者的绑定关系，从而产生非法使用面单号的场景 |
| 4 | 面单号不真实，直接被用于发货 | 面单号生成的时候，实质是绑定了【商家-订单-面单】的三者关系，而在 “确认发货” 之前，商家都可以随意修改这三者的绑定关系，从而产生非法使用面单号的场景 |
| 5 | 某商家的面单号被另一商家盗用 | 面单号生成的时候，实质是绑定了【商家-订单-面单】的三者关系，而在 “确认发货” 之前，商家都可以随意修改这三者的绑定关系，从而产生非法使用面单号的场景 |
| 6 | 同一个面单号被重复发货多次 | 面单号生成的时候，实质是绑定了【商家-订单-面单】的三者关系，而在 “确认发货” 之前，商家都可以随意修改这三者的绑定关系，从而产生非法使用面单号的场景 |
为了杜绝非法使用单号场景，围绕以上痛点需求，面向 “淘系订单” 推出了【风控改造】，将在【确认发货】接口做强风控管理，校验 “商家-订单-面单” 三者关系，这里需要ISV改造的是：
在get接口取面单号时，【商家id】、【订单号】和【平台】字段必须上传真实且准确，否则将会影响商家发货，或商家发货后无法获取到物流详情，发生商品纠纷。
双11预案
| 问题类别 | 编号 | 问题详述 | 问题级别 | 双11前备战 |
|---|---|---|---|---|
| 商家ERP、打单软件问题 | 1 | 聚石塔云资源环境问题 | P1 | 提前扫描，服务商压测，提前进行弹性升级 |
| 2 | 无法实时获取运单号（延迟、限流） | P1 | 进行服务商压测 | |
| 3 | 双11当天订购审核功能简化，导致软件阻塞 | P1 | 1、双11关闭订购功能;2、运营提前发公告告知双11当天会关闭订购电子面单服务 | |
| 4 | 可用单号余额过少 | P1 | 已经上线余额提醒功能，运营端推动商家去使用并关注余额提醒功能,打印组件异常 | |
| 5 | 无法下载最新模板 | P1 | 1、增加获取商家端打印模板功能，保证商家使用的模板是最新的;2、增加压力监控，保证服务器提供下载功能正常;3、对服务器下载性能进行压测 | |
| 6 | 自定义区无法显示 | P2 | 1、需要进行服务商压测;2、需要服务商进行灾备方案 | |
| 7 | 浏览器兼容性问题 | P3 | 1、增加xp、win8操作系统的测试;2、在白皮书中写明支持的浏览器类型和操作系统版本 | |
| 8 | 参数传递遗漏 | P4 | 1、需要进行服务商压测;2、需要服务商进行灾备方案 |
注：
服务商要提醒商家打印量大的时候，打印机在使用一段时间后，建议更换备用打印机，防止打印机过热?。
另外，对于top商家进行单量10倍预估，点对点提醒商家保证余额充足。 ?
更多内容
更多电子面单内容，请参考:文档
电子面单开发者交流群：250835836
