LinkedMall企业购-接入指南有哪些_企业商城 LinkedMall(LinkedMall)-阿里云帮助中心

本文主要讲解如何从零开始，通过接入阿里云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 业务流程

2.2.2 逆向交易

2.2.2.1 业务流程

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 账单明细查询中的账单信息核对货款账单，同时联系天猫企业购运营小二完成开票。
上线后，如遇系统技术等突发问题，在专属技术沟通群中提交工单，会有技术人员根据故障等级及时响应。