ERP对接方案管理
天猫直送业务接入说明
天猫直送业务接入手册
一、业务场景
天猫直送是天猫倡导的高品质物流服务标准，该标准提倡商家向消费者提供更精准、更高品质的物流体验。商家自主选择按照天猫直送标准向消费者做出物流服务承诺，并选择天猫直送提供优质物流服务的，相应的商品将在淘宝、天猫、天猫国际等平台透出“天猫直送”相关服务标示。
1、效果展示
2、上下标逻辑
上下标按照线路和商家的维度，与商品无关。
线路维度：
线路维度由菜鸟自己控制，原则是某线路首次上线需要连续7天全链路达成率≥95%，之后每天监控，连续3天全链路达成率＜95%则线路下线；再次上线需要连续5天全链路达成率≥95%。（我们称为735规则）
全链路达成率= 天猫直送全链路达成订单/天猫直送全链路应达成订单
上下标线路尚未开放界面给商家查询。小二可以在内部系统中进行查询。
商家维度：
推单及时率 98%以上且飞单率3%以下的商家可以加入天猫直送，加入方式如下
入驻形式：商家通过加入白名单的形式，加入天猫直送。初始值默认没有加入。
配置流程：商家向行业小二发起申请，行业小二审批通过后，会在线上进行配置。
商家推单及时率 = 天猫直送订单在应推单时间内推送的订单/天猫直送订单仓配总单量（排除飞单部分）
商家飞单率 = 天猫直送订单通过商家仓发货单量/天猫直送订单总单量
二、业务对接流程
1、对接流程
2、流程说明
2.1 基础配置
2.1.1、协议签订
签约链接：https://zhaoshang.tmall.com/channel/tmzs.htm，签约入口（商家中心——渠道推广管理——天猫直送）
2.1.2、货品推送、组合货品推送
货品推送：上天猫直送的前提是货品已经入仓且有菜鸟仓库存，所以存量货品对应的宝贝要上天猫直送的，可跳过货品推送环节。如果是新品上天猫直送，除必须推送货品外，还需进行货品入库，有菜鸟仓库存后才能进行后续业务流程
组合货品推送：前端宝贝售卖的商品为套装/组合装的，需要通过ERP将组合货品基础信息、组合货品与子品关系推送至菜鸟。完成这步操作是为了实现天猫直送打标时，前端宝贝展示正确的组合套装库存以及时效表达
2.1.3、宝贝货品映射关系创建
从ERP系统将前端宝贝与后端入菜鸟仓货品的匹配关系推送至菜鸟，是上天猫直送的关键操作，ERP需支持批量推送映射关系，也支持批量取消映射关系
2.1.4、预计时效打标
由菜鸟小二操作，结合以上的基础配置，预计时效打标才能生效
2.1.5商家仓优先级配置
默认菜鸟仓优先级高于商家仓，即依据消费者不同收货地址，宝贝端展示从不同发货仓发货，以及对应仓库存和时效表达。如果商家存在特殊需求，要求商家仓优先级高于菜鸟仓的，需提前与菜鸟行业小二沟通
2.2 商品打标
天猫直送打标完成后，商家可验证标记是否正常
通过修改不同收货地址验证以下场景：
A、发货地，根据不同区域收货地址，发货地变更
B、库存展示，根据不同区域收货地址，库存数量不同
C、时效展示，根据不同区域收货地址，承诺送到时间不同
2.3时效订单
天猫直送打标完成后，消费者拍下订单为天猫直送时效订单
商家通过ERP系统识别时效订单与普通订单区别
A、时效标记：当日达、次日达、预约配送、预计送达
B、应推单时间：承诺时效订单自带应推单时间，商家应在该时间之前将订单推送菜鸟
三、业务场景对应API 汇总
| 业务场景分类 | 子场景分类 | 系统接入方式 | 对接接口列表 |
| 商品管理 | 开启&解除商品预计时效 1、商品同步接口升级，设置区域销售标（非必须），设置成可选项 2、商品-宝贝关联关系同步至菜鸟 3、组合品同步，子品组合关系同步 | 通知(商家->菜鸟) | taobao.qimen.itemmapping.create; taobao.qimen.itemmapping.query; taobao.qimen.combineitem.synchronize; taobao.qimen.combineitem.delete; taobao.qimen.combineitem.query; taobao.qimen.singleitem.synchronize; taobao.qimen.singleitem.query |
| 交易单 | 交易订单标记 识别天猫直送时效标，预计时效标，应推单时间、当日达、次日达、多日达、预计时效几种订单的应推单时间 | 通知(ERP交易抓单) | RDS订单推送（交易单，分销采购单）； 或者 API 抓单接口，分销订单获取接口； |
| ERP销售订单 | ERP销售订单（建单，改单） 1、建单环节（合单池逻辑） 2、订单处理（合单，拆单，加赠品时，必须规范交易号/子交易号） 3、订单查看（订单筛选，查看时展示时效标,应推单时间） | 通知(商家->菜鸟) | taobao.qimen.deliveryorder.create |
| ERP推单给菜鸟发货 | ERP订单审核（分仓，推单） 1、智能分仓规则（目前ERP可暂按照原有逻辑执行） 2、推单（淘宝交易号，子交易号规范传入，合法，加赠商品主交易号（随意选取订单1个主交易号或者ERP订单号），子交易号用itemId填充 | 通知(商家->菜鸟) | taobao.qimen.deliveryorder.create； |
四、业务场景描述&业务规则
以下业务场景描述主要针对快消、美妆、服装、生鲜行业商家进行场景说明
4.1、 商家手册
商品管理
商品要在交易端展示时效，就需要能映射到真实仓库的货品，所以做时效表达和天猫直送的商品就必须要做前后端商品映射
4.1.1、 商品映射
商品映射，也称为前后端商品匹配，将前端宝贝与后端货品做映射关系，一个后端货品可以映射多个前端宝贝，前端一个宝贝无法映射多个后端货品
直接使用ASCP发货的商家，可以直接通过ASCP-店铺商品管理模块操作前后端商品映射关系；使用ERP系统对接菜鸟的商家，通过ERP系统以接口对接的方式批量推送前后端商品映射关系至菜鸟。
4.1.2、区域销售
生鲜、重货酒水类商家，商品勾选了区域销售，菜鸟会将商家在菜鸟仓的库存表达前端页面，再通过收货地址，发货仓库，发货仓库覆盖范围，优先级，仓库接单时间，配送线路及时效计算送达时间。
★★★关于区域销售的勾选，商家一定要谨慎操作，以防操作不当导致宝贝下架，关于操作详细步骤，可参考天猫直送操作手册
4.1.2、 组合货品
如果使用组合商品销售，组合商品需要同步至菜鸟，组合商品与子品的构建关系也要同步至菜鸟，组合商品也需要绑定与宝贝的关联关系。
4.2、库存管理
做完商品映射并勾选区域销售，或者做完商品映射并且菜鸟小二开通预计时效，菜鸟将会把仓库的库存全部同步到淘宝交易平台，即菜鸟时时更新库存至交易端。
★★★特别注意事项：
上天猫直送的商家，库存路由方式由后置库存模式转为前置库存模式，为保障订单时效，从订单拍下起即会预占对应菜鸟仓库存，简单理解为该订单ERP还未推单给菜鸟，菜鸟实际已经产生库存占用。如果商家推单不规范，天猫直送时效订单本路由菜鸟仓的，却推送给自己商家仓发货，在交易端未及时发货情况下，货品的菜鸟库存占用量还存在，就会导致其他订单要推送菜鸟发货却提示库存不足的问题。同时，如果ERP系统数据推送不规范，没有按照菜鸟要求正确推送订单交易号和子交易号的，会出现库存双倍占用问题，同样导致实际有库存却推单失败的问题。
★★★ERP推单规范：
A、菜鸟前置路由模式的订单库存预占逻辑，是以交易号&子交易号&货品ID进行库存占用，ERP在抓取到交易订单时，通过发货单创建接口需要正确推送交易号、子交易号、货品ID。部分ERP推单时漏推交易号或者子交易号的，易产生订单推送后菜鸟库存双倍占用问题，请ERP做好传参规范,在原有逻辑上菜鸟对发货单创建接口的交易号、子交易号非空和合法性做了强制校验。
B、ERP抓取到时效订单并添加商品的，添加的商品作为赠品存在订单中， ERP对于赠品的子交易号传参可参考交易号+货品ID格式
4.3、 时效表达
菜鸟参考仓库存出库时间和配送公司的配送时间，计算出送达消费者所有时长，得到送达日期，表达到交易页面。如果商家只使用了预计时效，承诺时效不会显示，表达在页面的只有预计送达时间，商家可在预计时效的基础上，按店铺维度开通天猫直送，可线下向运营小二申请签订天猫直送协议。
非自动流转发货的时效表达，在计算发货链路时长时，将ERP的订单处理时间也包括了进去，消费者下单后，订单进行ERP系统处理，为了确保订单按时送达，商家有责任将订单在指定的时间下发到菜鸟系统。这个最晚时间既是最晚下发时间。
最晚下发时间计算逻辑：
需要当日出库订单，订单的最晚下发时间等于仓库截单时间减去ERP订单处理可以时长，例如，如果当日达的截单时间是10:30，因此当日达的其他时间段的订单需要在11:00前推过来；如果次日达的截单时间是17:30，则次日达的其他时间段的订单需要在18:00前推过来。
非当日出库订单17:00~次日9:30支付的订单，需要在次日10:00前推过来。
| 下单时间 | 前端表达时间 | 应推单时间 |
| 10:00 | 10:30 | 11:00 |
| 10:29 | 10:30 | 11:00 |
| 11:00 | 24:00 | 18:00 |
| 14:00 | 24:00 | 18:00 |
| 18:00 | 24:00 | 次日10:00 |
最晚下发时间是指菜鸟接收订单的最晚时间，考虑到ERP菜鸟系统之间有网络不确定因素，请在处理订理时，要提前最晚时间几分钟操作，避免产生系统纠纷。
4.4、发货管理
4.4.1、 换仓发货
原则上无特殊原因商家需按照菜鸟路由出的仓进行发货，不允许换仓发货，如有换仓发货，导致菜鸟无法履行对消费者的承诺，菜鸟会对消费者进行赔偿，这部分赔偿费用由商家承担。
4.4.2、修改地址
如果发货地址与交易订单的地址不一致，或交易订单有修改地址记录，则判定为有修改地址行为，针对有修改地址的订单，还按最初表达给消费者的时效进行履行，未按时送达的订单，也不主动赔付消费者。
4.4.3、退款订单
消费者发起退款时，ERP推送还未将订单时间在到菜鸟系统，菜鸟会在发货订单进行标记有退款，还按表达给消费者的时效进行履行，未按时送达，不主动赔付。如果消费者发起退款时，ERP已经将订单推送到了菜鸟系统，且订单未取消正常发货，仓将按表达给消费者的时效进行履行，未按时送达，主动赔付消费者。
4.4.4、合单发货时效计算规则
不同服务的订单，不允许合单发货，如果商家将不同服务的订单进行合单，发货时将重新计算表达时效，导致菜鸟无法履行对消费者的承诺，菜鸟会对消费者进行赔偿，这部分赔偿费用由商家承担。
合单发货时ERP需要保留交易号，子交易号规范推单， 多个交易订单合并发货时，读取预计送达时间最早的表达服务表达到发货订单上，如果预计送达时间最早的订单有多条订单时，按当日达>次日达>定日达>预计时效的优先级顺序，表达到发货订单。
示例
以下订单A、B、C、D、E、F、G在交易端表达的时效如下：
| 订单 | 时效服务 | 预计送达时间 |
| A | 当日达 | 8月20日 |
| B | 次日达 | 8月20日 |
| C | 次日达 | 8月19日 |
| D | 定日达 | 8月20日 |
| E | 预计时效 | 8月20日 |
| F | 预计时效 | 8月19日 |
| G | 无时效服务 | 无 |
合单发货后：
| 发货 | 时效服务 | 预计送达时间 |
| A、B | 当日达 | 8月20日 |
| A、C | 次日达 | 8月19日 |
| B、D | 次日达 | 8月20日 |
| A、B、G | 当日达 | 8月20日 |
| A、C、F | 次日达 | 8月19日 |
| A、F | 预计时效 | 8月19日 |
4.5、 菜鸟供应链中台ASCP
此节内容适用于使用菜鸟ASCP工作台发货的商家，如是ERP接入的商家，请查看“ERP对接说明”章节。
4.5.1、 订单列表
可以通过订单标签查询有时效的订单，如果天猫直送订单，在订单列表，有对应的订单标签
4.5.2、 订单规则
4.5.2.1、 拆单
举例一个订单有A和B两个明细
1) 明细A是商家仓，B为菜鸟仓，系统不自动拆单，进入【截停】，由商家人工处理
原则：只要有一个明细为商家仓，订单都进入【截停】
2) 明细A为菜鸟仓，B仓库为空，则系统会优先判断A所在的仓是否满足B，如果满足记录B的仓库，系统不拆单
3) 明细A为菜鸟上海仓，B为菜鸟广州仓，则系统会自动拆单. 拆单后，两个子单继承原时效信息.
4) 天猫直送订单改单或绑定赠品后，如果原主品所在的仓无法满足赠品时，系统强制拆单，两个子单继承原时效信息
4.5.2.2、 审单
天猫直送承诺时效订单达到推单时间，系统强制审核. 除以下几种情况不强制审核：
1) 订单有退款标示
2) 订单被客服锁定.
3) 订单下发仓库被返回修改的订单
4.5.2.3、 促销
订单绑定赠品后，会优先判断主品所在的仓是否满足赠品，如果满足，原仓发货，如果不满足则订单拆单发货. 保证主品仓不变，时效不变.
4.5.2.4、 合单
1) 两个时效订单合单：继承早的时效信息
2) 一个时效订单和一个非时效订单合单，继承时效订单信息
3) 订单在合单池等待时，如果推单时间到了，优先以推单时间推送，会降低一点合单比例
4) 订单手工合单后，如果时效订单是返回修改的，不进行强推
5) 订单手工合单后，如果有一个时效订单不是返回修改的，且订单没有退款标示，则强推
4.5.2.5、 取消再激活
订单取消后，会给订单打标，即使再激活发货，也不会强制推送
4.5.2.6、 改单
1. 订单改单后，可能会随意更改，保存后重新路由仓库，以新仓库发货.
2. 改单保存后，即使仓换了，也继承时效，是否要赔偿，判责决定
业务规则：换仓后不会主动赔付，消费者可以发起投诉，根据物流单记录的换仓操作作为凭证，如果量多，可根据天猫直送的标准考核商家。
4.6、 ERP对接说明
此节内容适用于使用ERP接入的商家，如是使用ASCP发货的商家，请查看“菜鸟供应链中台ASCP
”章节
4.6.1、交易数据信息
天猫直送表达给消费者的服务，订单信息会有相关的数据记录，商家及ISV要感知天猫直送服务时，可以通过TOP接口或聚石塔的订单信息里获取。
| 字段 | 描述 |
| 菜鸟服务标识（cnService） | 天猫直送的服务表达会记录到此字段中，有多个服务标，多个服务标通过"_"分割，如：83_50。 80：天猫直送当日达 81：天猫直送次日达 82：预计时效表达 83：天猫直送预约配送 84：天猫直送多日达 50: 送货上门 |
| 预约配送约定日期（osDate） | 预约配送时，消费者选择的配送日期，格式"2016-06-20" |
| 预约配送约定时间范围（osRange） | 预约配送时，消费者选择的配送时间段，格式09:00-19:00 |
| 预计送达日期（esDate） | 天猫直送的当日达、次日达和预约配送时，承诺或表达给消费者的送达日期，格式"2016-06-20" |
| 预计送达时间范围（esRange） | 天猫直送的当日达、次日达和预约配送时，承诺或表达给消费者的送达时间范围，值为空，表达无时间段要求，格式09:00-19:00 |
| 商家应推单时间（pushTime） | 有时效服务表达的订单，为了仓库能及时出库，需要ERP在指定的时间前将订单下发到仓库。 |
| 发货仓信息（store_code） | 前置路由仓信息，ERP直接识别此仓库Code，并在推单时指定这个仓。如果不按这个仓推单，视为改仓 |
4.6.2、 交易订单
4.6.2.1、TOP接口订单查询
接口名称：taobao.trade.fullinfo.get
在调用接口，入参fields字段要增加cnService，pushTime，否则trade_attr内容不会包含cnService，pushTime这两个KEY值。
示例：
<trade_fullinfo_get_response>
<trade>
<trade_attr>{"cnService":"80";"pushTime":"2016-06-20 09:30:00";}</trade_attr>
<es_date>2016-06-20</es_date>
<es_range>09:00-19:00</es_range>
<os_date>2016-06-20</os_date>
<os_ range >09:00-19:00</os_ range>
</trade>
</trade_fullinfo_get_response>
4.6.2.1、聚石塔订单获取
在聚石塔的订单同步服务中设置同步内容，增加cnService、osDate、osRange、esDate、esRange、pushTime字段。
4.6.3、 分销订单
4.6.3.1、 TOP接口订单查询
接口：taobao.fenxiao.orders.get
分销订单有关物流服务相关信息都在features字段里，attr_key分别是cnService、sendDate(osDate)、osRange、esDate、esRange、pushTime
示例：
<fenxiao_orders_get_response>
<purchase_orders list="true">
<purchase_order>
<id>74199773310</id>
<features list="true">
<feature>
<attr_key>orderNovice</attr_key>
<attr_value>艳秋测试</attr_value>
</feature>
<feature>
<attr_key>orderNoviceContent</attr_key>
<attr_value/>
</feature>
<feature>
<attr_key>cnService</attr_key>
<attr_value>83</attr_value>
</feature>
<feature>
<attr_key>pushTime</attr_key>
<attr_value>2016-06-20 16:30:00</attr_value>
</feature>
<feature>
<attr_key>sendDate</attr_key><!—预约送达时间，osDate-->
<attr_value>2016-06-21</attr_value>
</feature>
<feature>
<attr_key>osRange</attr_key>
<attr_value>09:00-19:00</attr_value>
</feature>
<feature>
<attr_key>esDate</attr_key>
<attr_value>2016-06-21</attr_value>
</feature>
<feature>
<attr_key>esRange</attr_key>
<attr_value>09:00-19:00</attr_value>
</feature>
</features>
<fenxiao_id>74199773310</fenxiao_id>
<created>2016-06-15 20:49:38</created>
<modified>2016-06-15 21:03:43</modified>
<memo/>
<status>WAIT_SELLER_SEND_GOODS</status>
</purchase_order>
</purchase_orders>
<total_results>1</total_results>
</fenxiao_orders_get_response>
4.6.3.2、 聚石塔订单获取
4.7、 物流发货信息
时效订单在发货时，以下几项内容要重点注意
1) 订单类型，时效只对一般交易发货有效，补发、换发订单没有时效规则，如果将有时效的交易发货订单使用补发出库，发货优先级将降低，未按时送时，消费者投诉时，将由商家负责赔付消费者；如将补发单按有时效的交易单发货时，未按时送达，将自动走赔付鉴定流程。
2) 店铺信息，发货时，订单要与店铺相匹配。
3) 交易单号和子交易单号，有时效的订单务必要将交易单号和子交易单号填写正常，如有错误，发货优先级将降低，未按时送时，消费者投诉时，将由商家负责赔付消费者。
