送装一体系统对接

1、版本记录

Date Version Description
2020.04.28 1.0 1、家装商家ERP标准化协议v1.0发布

2、业务背景

1、商家系统无法获取到家装物流服务履约全链路物流详情
2、前端商品和后端货品、包件信息不匹配，收货存在差异， 可能影响商家结算
3、商家在ERP改地址时，城市仓无法接收到更改后的新地址信息
4、发货清单每次需要线下人肉跟进
5、部分商家末端需要操作双系统，数据准确性不足

3、对接业务方案

3.1 对接前准备

1. 对接商家需要在淘宝或者天猫开有店铺
2. 对接商家需要签署家装送装一体相关业务协议，请用商家主账号登录以下链接订购“送装一体服务”，已经够送装一体服务商家不用重复订购，订购流程见：https://www.yuque.com/youshu-vvhwl/kb/dd1w43
3. 商家在接入前，请联系天猫业务小二，由天猫业务小二配置商家名单，可加群号：31386464咨询

3.2 系统对接主要逻辑

1、 交易产生后，商家点击发货前调取菜鸟电子面单号
2、 交易产生后，商家将交易订单（主交易、子交易）和物流（货品、包件信息）推送给UOP
3、 商家发货时将电子面单打印贴在货品上作为后续物流履约唯一标识
4、 履约完成后将履约节点回传到商家ERP

3.3 系统对接的好处

1、 物流节点回传给到商家，ERP系统可以查看到相应物流订单的履约节点，减少商家客服查单成本。
2、 消费者可以通过手淘、支付宝、裹裹等按运单号查物流详情，减少因无物流节点导致的查单、咨询投诉、退款等，提升店铺消费者体验。
3、 家具大件商家可实现从仓到消费者签收实现“一票到底”，提升商家信息化水平。

3.4 注意事项

  对接后，商家可以推送天猫家装送装一体交易订单对应的物流订单（以下简称送装一体订单），也可以推送线下物流订单，天猫交易对应的物流订单，请商家确保子交易订单与物流订单的匹配关系，否则将影响物流详情回传
  商家只需要将已开通送装一体城市的订单推送给天猫；其他城市将会推单失败

4、接口说明

建议按照以下顺序依次进行开发

4.1 商家物流订单下发接口（商家–>天猫）–重要

接口介绍：商家通过ERP->淘宝开放平台->向订单中心下发物流订单
接口详情见：https://open.taobao.com/api.htm?docId=49907&docType=2
注意：针对线下订单如果没有线上交易单号，发货子单中的交易单号可以回传ERP单号

4.2 物流状态回传接口（天猫–>商家）–重要

接口介绍：订单中心回传流状态->淘宝对外开放平台->商家ERP
接口详情见链接：https://open.taobao.com/api.htm?docId=49906&docType=2

4.3 电子面单号获取

接口介绍：商家ERP发货->电子面单平台取号->商家ERP
接口详情见链接：https://support-cnkuaidi.taobao.com/doc.htm#?docId=108009&docType=1

4.4 物流订单拦截接口 （商家–>天猫）

接口介绍：商家通过ERP->淘宝开放平台->订单中心下发物流订单取消报文
接口详情：https://www.yuque.com/docs/share/50cb1b21-5b80-40c7-985c-7840a69a53c3?#

4.5 物流拦截结果推送接口（天猫–>商家）

接口介绍：运单中心->淘宝开放平台->ERP向商家推送物流轨迹信息
接口详情见链接：https://open.taobao.com/api.htm?docId=49905&docType=2

5、常见问题FAQ

https://www.yuque.com/docs/share/32524780-7323-4aea-94b6-739a7402c706?#