文档

接入指南

更新时间:

本文主要讲解如何从零开始,通过接入阿里云LinkedMall分销API,将天猫企业购(渠道聚合供应商)的商品供应链接入到企业客户(分销商)自有商城体系的过程,包括业务流程和技术接口实现。

1、概述

1.1 背景

基于阿里电商体系的供应链能力,提供全套供应链接入API,服务企业电商场景,包括:企业福利、积分兑换、销售带货、渠道流量转化等,为企业提供质美价优的商品、合规的资金流、统一开票能力和标准物流履约体系。

1.2 适用客户

此模式适合有一定研发能力的企业客户选用。企业客户(分销商)在不改变原企业商城风格的前提下,灵活地接入更丰富的商品供给用于开展多种业务。

对于LinkedMall平台提供的API/SDK,若您以商业目的使用,您需要事先从阿里云获取商用授权,完成入驻审核流程,才能使用该服务。关于具体使用规则,请参阅《阿里云LinkedMall分销商服务协议》获得详细信息。

1.3 名词定义

名词

定义

分销商

通过接入API,使用阿里商品供应链实现业务场景的企业客户

分销商商城

用于区分企业客户的某一个业务场景或电商商城

用户

分销商(企业客户)提供的业务服务的最终用户或消费者

分销渠道供应商

主要为:天猫企业购(提供天猫商品的聚合供给)

分销采购订单

分销商分销渠道供应商采购商品时下的订单,分销采购订单(分销交易单)在业务上为主子单模式

2、接入流程

整个接入过程,大致分为4个阶段。

  1. 入驻审核:注册阿里云账号,完成分销商入驻。(企业信息、资金账号、合同签约等)

  2. 对接开发:基于分销商接口SDK,完成开发和调试。(商品、订单、账单等API对接)

  3. 选品联调:选择测试商品,由运营小二支持,完成正逆向的下单测试。

  4. 上线发布:选择正式发布商品,发布上线。售后问题联系天猫企业购小二统一处理,统一由天猫企业购完成开票对账服务。

接入流程

2.1 第一阶段:入驻审核

分销商入驻流程操作步骤请参考LinkedMall企业购-分销商入驻流程

说明

若有其他疑问,请群内 @机器人:分销商入驻流程说明

image.png

2.2 第二阶段:接入开发

2.2.1 正向交易

2.2.1.1 业务流程

相关API请参考API参考

image.png

2.2.1.2 订单状态机

该订单状态机展示的是分销交易单维度的生命周期。

说明

若有其他疑问,请群内@机器人:分销商商城API对接文档

image.png

2.2.1.3 拆单逻辑

分销采购订单(分销交易单)的拆单逻辑,遵循淘宝订单的主子单拆单关系:

  1. 分销采购订单(分销交易单):分销商向LinkedMall发起的一笔采购交易订单,可以包括多件商品和SKU。

  2. 分销采购订单主单:一个分销采购订单(分销交易单)包含1到N个分销采购订单主单,每个淘宝订单主单和分销采购单主单一一对应。

  3. 分销采购订单子单:一个分销采购订单主单包含1到N个分销采购订单子单,每个淘宝订单子单和分销采购单子单一一对应。

  4. 拆分主单:根据淘宝主站商品的发货店铺和发货仓等,拆分为多个分销采购订单主单(或淘宝订单主单)。

  5. 拆分子单:每个分销采购订单主单根据子单最小颗粒度SKU进行子单拆分。

  6. 订单状态:分销商必须存储淘宝主单和子单的状态,用于展示和判断您自己商城侧订单状态。

image.png

2.2.2 逆向交易

2.2.2.1 业务流程

相关API请参考API参考

  • 仅退款image.png

  • 退货退款image.png

2.2.2.2 售后单状态机

说明

若有其他疑问,请群内@机器人:分销商商城API对接文档

LinkedMall侧逆向状态机示意:

image.png

2.2.2.3 限制条件

说明

逆向流程中,更多的用户发起和商家审核限制条件以淘宝天猫主站业务逻辑为准。

  • 仅退款:

    • 确认收货前,申请退

      • 商家未发货,申请退款只需要选择退款原因,只能全额退款。

      • 商家已发货,申请退款,用户需要选择是否收到货,如果选择未收到货,可以申请全额退款(商家待确认是否退),如果选择已经收到货,可全额退或部分退款。

    • 确认收货后,申请退

      同上。

  • 部分退款:

    • 确认收货前,申请退

      • 商家未发货,申请退款只需要选择退款原因,不支持部分退款。

      • 商家已发货,申请退款,用户需要选择是否收到货,如果选择未收到货,无法申请部分退款,如果选择已经收到货,可以支持部分退款。

    • 确认收货后,申请退

      同上。

  • 退货退款:

    • 确认收货前,申请退

      • 商家未发货,不可退货退款。

      • 商家已发货,申请退货退款,支持部分退款和全额退款,商家根据情况审核,其中7天无理由商家无法拒绝。

    • 确认收货后,申请退

      确认收货后,支持部分退款和全额退款,商家根据情况审核。

2.2.3 客户侧2C交易状态关联调用示例

说明

逆向流程中,更多的用户发起和商家审核限制条件以淘宝天猫主站业务逻辑为准。

image.png

2.2.4 商品运营

说明

若有其他疑问,请群内@机器人:分销商商城API对接文档

image.png

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 第三阶段:测试联调

  1. 联系天猫企业购运营小二,在专属技术沟通群中沟通,配合企业客户完成正逆向交易状态变更及测试。

  2. 售后退款退货逻辑

    • 联系天猫企业购运营小二,在专属技术沟通群中沟通,测试操作退款退货

    • 除特殊类目及场景,未发货申请天猫立即自动退款。

2.4 第四阶段:上线发布

  1. 上线前,联系天猫企业购运营小二,同步更新最新的商品库,并根据业务需要上架商品。

  2. 请确认代扣支付宝账号中余额充足,否则会影响正常下单。

  3. 联系天猫企业购运营小二,创建专属售后运营群,群中有专人处理售后订单。

  4. 发货时效:

    • 普通商品:一般是买家付款后24小时内上传物流单号,买家付款后48小时内发货

    • 定制、预售及其他特殊情形等另行约定发货时间的商品:约定时间内发货

    • 周期购商品:约定发货日期的23:59:59前上传物流单号,约定发货日期的23:59:59前

  5. 固定账期,根据1.4 账单明细查询中的账单信息核对货款账单,同时联系天猫企业购运营小二完成开票。

  6. 上线后,如遇系统技术等突发问题,在专属技术沟通群中提交工单,会有技术人员根据故障等级及时响应。

  • 本页导读 (0)