本文主要讲解如何从零开始，通过接入阿里云LinkedMall分销API，将猫淘商品供应链接入到企业客户（分销商）自有商城体系的过程，包括业务流程和技术接口实现。
1、概述
1.1 背景
基于阿里电商体系的供应链能力，提供全套供应链接入API，服务企业电商场景，包括：企业福利、积分兑换、销售带货、渠道流量转化等，为企业提供质美价优的商品、合规的资金流、统一开票能力和标准物流履约体系。
1.2 适用客户
此模式适合有一定研发能力的企业客户选用。企业客户（分销商）在不改变原企业商城风格的前提下，灵活的接入更丰富的商品供给用于开展多种业务。
对于LinkedMall平台提供的API/SDK，若您以商业目的使用，则您需事先从阿里云获取商用授权，完成入驻审核流程，才能使用该服务。
关于具体使用规则，请参阅阿里云LinkedMall分销商服务协议获得详细信息。
1.3 名词定义
名词 | 定义 |
分销商 | 通过接入API，使用阿里商品供应链实现业务场景的企业客户。 |
分销商商城 | 分销商入驻后，开通的分销商城API对接中，此商城将作为采购方（买方）进行下单，在API语境下为分销商采购商城。 |
用户 | 分销商（企业客户）提供的业务服务的最终用户或消费者。 |
分销渠道供应商 | 提供猫淘商品聚合能力的渠道供应商。请在接入前，和对应的猫淘供应商完成沟通后再接入。 |
采购订单 | 分销商向分销渠道供应商采购商品时，下的订单，采购订单（分销交易单）在业务上为主子单模式。 |
店铺账单 | 所有采购订单会在下月初固定时间，统一生成采购订单关联的账单。 |
商品选品池 | 分销商从渠道商店铺中选取的可采购商品子集，目前每个采购店铺默认创建一个商品选品池，并自动导入商品；分销商创建采购订单、商品的变更通知的商品需要在选品池中存在。 |
订单 | 分销商采购订单下单后，按照一定的订单拆单逻辑，在渠道店铺中生成一个或多个订单。订单用于定义双方交易合约，维护订单支付、履约状态的生命周期。 |
子订单 | 按照SKU进行订单拆单产出的实体，子订单将包含子订单费用、履约状态等信息。 |
物流单 | 订单进行物流履约时，用于关联物流公司物流单以及物流状态与详情的实体。物流单与快递号一一对应。 |
退款单 | 分销商发起退款的处理实体，基于子订单进行退款，包含退款基本信息、退款执行状态等。 |
地址码 | 采购订单下单时，传入下单地址需要转换成标准的地址代码。 |
2、接入流程
整个接入过程，大致分为4个阶段：
入驻审核：注册阿里云账号，完成分销商入驻。（企业信息、资金账号、合同签约等）
对接开发：基于分销商接口SDK，完成开发和调试。（商品、订单、帐单等API对接；商品、订单消息对接）
选品联调：选择测试商品，由运营小二支持，完成正逆向的下单测试。
上线发布：选择正式发布商品，发布上线。售后问题联系天猫企业购小二统一处理，统一由天猫企业购完成开票对账服务。
2.1 第一阶段：入驻审核
分销商入驻请参考分销商入驻与工作台操作指南。
2.2 第二阶段：接入开发
2.2.1 正向交易
2.2.1.1 业务流程
相关API请参考订单。
分销商在完成API对接后，建议独立搭建分销商城，将商品同步至自建商品库，下图流程中的商品浏览仅做示意，不建议分销商直接使用商品列表接口和商品详情接口直接C端接入。
2.2.1.2 采购订单状态机
该状态机展示的是采购订单维度的生命周期。
2.2.1.3 拆单逻辑
采购订单的拆单逻辑，遵循淘宝订单的主子单拆单关系：
采购订单：分销商向LinkedMall发起的一笔采购交易订单，可以包括多件商品和SKU。
采购订单主单：一个分销采购订单包含1到N个分销采购订单主单，每个淘宝订单主单和分销采购单主单一一对应。
采购订单子单：一个分销采购订单主单包含1到N个分销采购订单子单，每个淘宝订单子单和分销采购单子单一一对应。
拆分主单：根据淘宝主站商品的发货店铺和发货仓等，拆分为多个分销采购订单主单（或淘宝订单主单）。
拆分子单：每个分销采购订单主单根据子单最小颗粒度SKU进行子单拆分。
订单状态：分销商必须存储淘宝主单和子单的状态，用于展示和判断您自己商城侧订单状态。
2.2.2 逆向交易
2.2.2.1 业务流程
相关API请参考售后单。
仅退款
退货退款
2.2.2.2 售后单状态机
LinkedMall侧逆向状态机示意：
2.2.2.3 限制条件
逆向流程中，更多的用户发起和商家审核限制条件以淘宝天猫主站业务逻辑为准。
仅退款：
确认收货前，申请退
商家未发货，申请退款只需要选择退款原因，只能全额退款。
商家已发货，申请退款，用户需要选择是否收到货，如果选择未收到货，可以申请全额退款（商家待确认是否退），如果选择已经收到货，可全额退或部分退款。
确认收货后，申请退
确认收货后，同上。
部分退款：
确认收货前，申请退
商家未发货，申请退款只需要选择退款原因，不支持部分退款。
商家已发货，申请退款，用户需要选择是否收到货，如果选择未收到货，无法申请部分退款，如果选择已经收到货，可以支持部分退款。
确认收货后，申请退
确认收货后，同上。
退货退款：
确认收货前，申请退
商家未发货，不可退货退款。
商家已发货，申请退货退款，支持部分退款和全额退款，商家根据情况审核，其中7天无理由商家无法拒绝。
确认收货后，申请退
确认收货后，支持部分退款和全额退款，商家根据情况审核。
2.2.3 客户侧2C交易状态关联调用示例
备注：逆向流程中，更多的用户发起和商家审核限制条件以淘宝天猫主站业务逻辑为准。
2.2.4 商品运营
2.2.5 API接口列表
API接口详细描述请参考API参考。
本文所有提供的接口都是通过阿里云的 POP 网关对外透出，客户需要用阿里云的用户身份通过 LinkedMall 的SDK调用接口，LinkedMall已经提供了相应的 demo 程序，可以向对接人员索取。调用本文中所有接口的阿里云账户需要和自身的客户Id绑定，否则将拒绝执行。
客户通过SDK客户端（Client）调用LinkedMall服务时，LinkedMall只能保证服务端稳定性，不能保证客户端稳定性，因此客户侧有秒杀等大流量活动时，请提前通知LinkedMall并自行压测验证接口性能。
2.3 第三阶段：测试联调
联系运营小二配合测试
联系渠道运营小二，在专属技术沟通群中沟通，配合企业客户完成正逆向交易状态变更及测试。
售后退款退货逻辑
联系渠道运营小二，在专属技术沟通群中沟通，测试操作退款退货等场景；
除特殊类目及场景，未发货申请天猫立即自动退款。
接口错误码和错误获取
开启debug模式，参考阿里云官方异常处理中通用异常 TeaException处理方式；
获取error.data （如上图示例）：
errorCode -> CategoryInvalid 为错误码；
errorMessage -> “该订单商品类目为生鲜类目，仅允许仅退款操作” 为错误原因；
其他语言也可以调试解析error结构来获取错误码与错误原因结构。
2.4 第四阶段：上线发布
上线前，联系天猫运营小二，同步更新最新的商品库，并根据业务需要上架商品。
请确认代扣支付宝账号中余额充足，否则会影响正常下单。
发货时效：
普通商品：一般是买家付款后24小时内上传物流单号,买家付款后48小时内发货 。
定制、预售及其他特殊情形等另行约定发货时间的商品：约定时间内发货。
固定账期，根据接口的账单信息核对货款账单，同时联系天猫运营小二完成开票。
上线后，如遇系统技术等突发问题，在专属技术沟通群中提交工单，会有技术人员根据故障等级及时响应。