本文主要讲解如何从零开始，通过接入阿里云LinkedMall分销API，将天猫企业购（渠道聚合供应商）的商品供应链接入到企业客户（分销商）自有商城体系的过程，包括业务流程和技术接口实现。
1、概述
1.1 背景
基于阿里电商体系的供应链能力，提供全套供应链接入API，服务企业电商场景，包括：企业福利、积分兑换、销售带货、渠道流量转化等，为企业提供质美价优的商品、合规的资金流、统一开票能力和标准物流履约体系。
1.2 适用客户
此模式适合有一定研发能力的企业客户选用。企业客户（分销商）在不改变原企业商城风格的前提下，灵活地接入更丰富的商品供给用于开展多种业务。
对于LinkedMall平台提供的API/SDK，若您以商业目的使用，您需要事先从阿里云获取商用授权，完成入驻审核流程，才能使用该服务。关于具体使用规则，请参阅《阿里云LinkedMall分销商服务协议》获得详细信息。
1.3 名词定义
名词 | 定义 |
分销商 | 通过接入API，使用阿里商品供应链实现业务场景的企业客户 |
分销商商城 | 用于区分企业客户的某一个业务场景或电商商城 |
用户 | 分销商（企业客户）提供的业务服务的最终用户或消费者 |
分销渠道供应商 | 主要为：天猫企业购（提供天猫商品的聚合供给） |
分销采购订单 | 分销商向分销渠道供应商采购商品时下的订单，分销采购订单（分销交易单）在业务上为主子单模式 |
2、接入流程
整个接入过程，大致分为4个阶段。
入驻审核：注册阿里云账号，完成分销商入驻。（企业信息、资金账号、合同签约等）
对接开发：基于分销商接口SDK，完成开发和调试。（商品、订单、账单等API对接）
选品联调：选择测试商品，由运营小二支持，完成正逆向的下单测试。
上线发布：选择正式发布商品，发布上线。售后问题联系天猫企业购小二统一处理，统一由天猫企业购完成开票对账服务。
2.1 第一阶段：入驻审核
分销商入驻流程操作步骤请参考LinkedMall企业购-分销商入驻流程。
若有其他疑问，请群内 @机器人：分销商入驻流程说明
2.2 第二阶段：接入开发
2.2.1 正向交易
2.2.1.1 业务流程
相关API请参考API参考。
2.2.1.2 订单状态机
该订单状态机展示的是分销交易单维度的生命周期。
若有其他疑问，请群内@机器人：分销商商城API对接文档
2.2.1.3 拆单逻辑
分销采购订单（分销交易单）的拆单逻辑，遵循淘宝订单的主子单拆单关系：
分销采购订单（分销交易单）：分销商向LinkedMall发起的一笔采购交易订单，可以包括多件商品和SKU。
分销采购订单主单：一个分销采购订单（分销交易单）包含1到N个分销采购订单主单，每个淘宝订单主单和分销采购单主单一一对应。
分销采购订单子单：一个分销采购订单主单包含1到N个分销采购订单子单，每个淘宝订单子单和分销采购单子单一一对应。
拆分主单：根据淘宝主站商品的发货店铺和发货仓等，拆分为多个分销采购订单主单（或淘宝订单主单）。
拆分子单：每个分销采购订单主单根据子单最小颗粒度SKU进行子单拆分。
订单状态：分销商必须存储淘宝主单和子单的状态，用于展示和判断您自己商城侧订单状态。
2.2.2 逆向交易
2.2.2.1 业务流程
相关API请参考API参考。
仅退款
退货退款
2.2.2.2 售后单状态机
若有其他疑问，请群内@机器人：分销商商城API对接文档
LinkedMall侧逆向状态机示意：
2.2.2.3 限制条件
逆向流程中，更多的用户发起和商家审核限制条件以淘宝天猫主站业务逻辑为准。
仅退款：
确认收货前，申请退
商家未发货，申请退款只需要选择退款原因，只能全额退款。
商家已发货，申请退款，用户需要选择是否收到货，如果选择未收到货，可以申请全额退款（商家待确认是否退），如果选择已经收到货，可全额退或部分退款。
确认收货后，申请退
同上。
部分退款：
确认收货前，申请退
商家未发货，申请退款只需要选择退款原因，不支持部分退款。
商家已发货，申请退款，用户需要选择是否收到货，如果选择未收到货，无法申请部分退款，如果选择已经收到货，可以支持部分退款。
确认收货后，申请退
同上。
退货退款：
确认收货前，申请退
商家未发货，不可退货退款。
商家已发货，申请退货退款，支持部分退款和全额退款，商家根据情况审核，其中7天无理由商家无法拒绝。
确认收货后，申请退
确认收货后，支持部分退款和全额退款，商家根据情况审核。
2.2.3 客户侧2C交易状态关联调用示例
逆向流程中，更多的用户发起和商家审核限制条件以淘宝天猫主站业务逻辑为准。
2.2.4 商品运营
若有其他疑问，请群内@机器人：分销商商城API对接文档
2.2.5 API接口列表
本文所有提供的接口都是通过阿里云的 POP 网关对外透出，客户需要用阿里云的用户身份通过LinkedMall 的SDK调用接口，LinkedMall已经提供了相应的 demo 程序，可以向对接人员索取。调用本文中所有接口的阿里云账户需要和自身的客户ID绑定，否则将拒绝执行。
API接口详细描述，请参考API参考。
客户通过SDK客户端（Client）调用LinkedMall服务时，LinkedMall只能保证服务端稳定性，不能保证客户端稳定性，因此客户侧有秒杀等大流量活动时，请提前通知LinkedMall并自行压测验证接口性能。
2.2.5.1 分销商管理
编号 | API接口名称 | API接口描述 |
1 | 分销商城查询queryDistributionMall | 分销商查询自己拥有的商城信息 |
2 | 分销商城列表查询listDistributionMall | 查询分销商已经开通的商城列表 |
3 | 分销商城回调通知distributorChangeNotify | 分销商城入驻完成后，有状态变更时向客户系统发起通知 |
4 | 账单明细查询queryDistributionBillDetail | 账单明细查询，返回明细数据下载链接 |
2.2.5.2 商品管理
编号 | API接口名称 | API接口描述 |
1 | 查询商品列表listDistributionItem | 查询分销商商品库内的商品列表，分销商品信息排序规则为商品的添加时间 |
2 | 查询商品详情接口queryItemDetail | 查询单个商品的详细信息 |
3 | 分销商品库信息变更通知distributionItemChangeNotify | 商品库单商品关键信息发生变化，通知客户系统（商品价格、标题、主图、轮播图和详情信息） |
4 | 查询商品详情接口（支持区域库存）queryItemDetailWithDivision | 查询单个商品详细信息，支持区域库存查询 |
5 | 查询商品类目信息queryMallCategoryList | 查询商品类目信息 |
6 | 查询商品建议零售价格queryItemGuideRetailPrice | 查询商品的建议零售价格 说明 接口数据为T+1数据，当日添加的商品次日才有数据返回 |
2.2.5.3 交易管理
编号 | API接口名称 | API接口描述 |
1 | 分销采购订单渲染renderDistributionOrder | C端用户购买某个商品前，渲染用户订单，基于商品的收货地址区域库存判断状态 |
2 | 提交分销采购订单创建请求applyCreateDistributionOrder | 异步接口，只是提交创建分销订单申请，需要接收分销订单创建结果通知或者主动调查询分销交易状态接口。 |
3 | 查询分销交易状态queryDistributionTradeStatus | 返回分销交易状态。 |
4 | 分销采购订单创建结果通知syncDistributionStatus | 分销订单创建结果通知，包括分销交易状态，及分销订单的信息。 |
5 | 分销采购订单确认收货confirmDisburse4Distribution | 只支持主分销订单确认收货。 |
6 | 分销采购订单退款申请初始化initApplyRefund4Distribution | 逆向退款申请初始化，在发起退款申请之前调用，以便申请方渲染退款页面给用户。 |
7 | 分销采购订单退款申请applyRefund4Distribution | 基于3.7接口获取退款申请初始化信息，发起退款或者退货退款申请，该接口不支持退换货。 |
8 | 分销采购订单退款申请修改初始化initModifyRefund4Distribution | 获取订单相关的逆向修改数据，必须在发起退款申请之后调用。 |
9 | 分销采购订单退款申请修改modifyRefund4Distribution | 基于3.9接口获取退款信息，发起退款或者退货退款修改申请，该接口不支持退换货 |
10 | 取消分销采购订单退款申请cancelRefund4Distribution | 如果已经提交了退款申请，商家还未响应时，客户想取消退款申请，可以通过此接口取消。 |
11 | 提交分销采购订单退货物流信息submitReturnGoodLogistics4Distribution | 如果提交了退货申请，通过该接口提交退货的物流信息。 |
12 | 查询分销采购订单退款申请queryRefundApplicationDetail4Distribution | 基于子分销订单号查询逆向申请详情 |
13 | 分销采购订单物流通知syncDistributionLogisticsInfo | 物流状态时同步物流信息给分销客户 |
14 | 分销采购订单退款消息通知syncDistributionRefundInfo | 退款消息通知，调用方可根据消息通知状态设计自身退款流程。 |
15 | 分销采购订单状态同步syncDistributionOrderInfo | 当订单状态变化时，同步订单信息给分销商。（子订单维度异步通知） |
16 | 分销采购订单物流查询queryLogistics4Distribution | 查询订单对应的物流信息 |
17 | 地址接口queryChildDivisionCodeById | 根据区划码查询子区划的地址 |
2.2.5.4 订单管理
编号 | API接口名称 | API接口描述 |
1 | 查询分销采购订单详情queryOrderDetail4Distribution | 根据订单ID查询分销采购订单详情 |
2 | 查询分销采购订单列表queryOrderList4Distribution | 根据过滤条件查询分销商城的订单列表 |
2.3 第三阶段：测试联调
联系天猫企业购运营小二，在专属技术沟通群中沟通，配合企业客户完成正逆向交易状态变更及测试。
售后退款退货逻辑
联系天猫企业购运营小二，在专属技术沟通群中沟通，测试操作退款退货
除特殊类目及场景，未发货申请天猫立即自动退款。
2.4 第四阶段：上线发布
上线前，联系天猫企业购运营小二，同步更新最新的商品库，并根据业务需要上架商品。
请确认代扣支付宝账号中余额充足，否则会影响正常下单。
联系天猫企业购运营小二，创建专属售后运营群，群中有专人处理售后订单。
发货时效：
普通商品：一般是买家付款后24小时内上传物流单号,买家付款后48小时内发货
定制、预售及其他特殊情形等另行约定发货时间的商品：约定时间内发货
周期购商品：约定发货日期的23:59:59前上传物流单号，约定发货日期的23:59:59前
固定账期，根据1.4 账单明细查询中的账单信息核对货款账单，同时联系天猫企业购运营小二完成开票。
上线后，如遇系统技术等突发问题，在专属技术沟通群中提交工单，会有技术人员根据故障等级及时响应。