文档

接入指南

更新时间:

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

1、概述

1.1 背景

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

1.2 适用客户

说明

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

对于LinkedMall平台提供的API/SDK,若您以商业目的使用,则您需事先从阿里云获取商用授权,完成入驻审核流程,才能使用该服务。

关于具体使用规则,请参阅阿里云LinkedMall分销商服务协议获得详细信息。

1.3 名词定义

名词

定义

分销商

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

分销商商城

分销商入驻后,开通的分销商城API对接中,此商城将作为采购方(买方)进行下单,在API语境下为分销商采购商城。

用户

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

分销渠道供应商

提供猫淘商品聚合能力的渠道供应商。请在接入前,和对应的猫淘供应商完成沟通后再接入。

采购订单

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

店铺账单

所有采购订单会在下月初固定时间,统一生成采购订单关联的账单。

商品选品池

分销商从渠道商店铺中选取的可采购商品子集,目前每个采购店铺默认创建一个商品选品池,并自动导入商品;分销商创建采购订单、商品的变更通知的商品需要在选品池中存在。

订单

分销商采购订单下单后,按照一定的订单拆单逻辑,在渠道店铺中生成一个或多个订单。订单用于定义双方交易合约,维护订单支付、履约状态的生命周期。

子订单

按照SKU进行订单拆单产出的实体,子订单将包含子订单费用、履约状态等信息。​

物流单

订单进行物流履约时,用于关联物流公司物流单以及物流状态与详情的实体。物流单与快递号一一对应。

退款单

分销商发起退款的处理实体,基于子订单进行退款,包含退款基本信息、退款执行状态等。

地址码

采购订单下单时,传入下单地址需要转换成标准的地址代码。

2、接入流程

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

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

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

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

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

接入流程

2.1 第一阶段:入驻审核

分销商入驻请参考分销商入驻与工作台操作指南

yuque_diagram.jpg

2.2 第二阶段:接入开发

2.2.1 正向交易

2.2.1.1 业务流程

相关API请参考订单

说明

分销商在完成API对接后,建议独立搭建分销商城,将商品同步至自建商品库,下图流程中的商品浏览仅做示意,不建议分销商直接使用商品列表接口和商品详情接口直接C端接入。

yuque_diagram (1).jpg

2.2.1.2 采购订单状态机

该状态机展示的是采购订单维度的生命周期。

yuque_diagram (2).jpg

2.2.1.3 拆单逻辑

采购订单的拆单逻辑,遵循淘宝订单的主子单拆单关系:

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

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

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

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

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

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

yuque_diagram (3).jpg

2.2.2 逆向交易

2.2.2.1 业务流程

相关API请参考售后单

  • 仅退款yuque_diagram (4).jpg

  • 退货退款yuque_diagram (5).jpg

2.2.2.2 售后单状态机

LinkedMall侧逆向状态机示意:yuque_diagram (6).jpg

2.2.2.3 限制条件

说明

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

  1. 仅退款:

    • 确认收货前,申请退

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

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

    • 确认收货后,申请退

      确认收货后,同上。

  2. 部分退款:

    • 确认收货前,申请退

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

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

    • 确认收货后,申请退

      确认收货后,同上。

  3. 退货退款:

    • 确认收货前,申请退

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

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

    • 确认收货后,申请退

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

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

说明

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

yuque_diagram (7).jpg

2.2.4 商品运营yuque_diagram (8).jpg

2.2.5 API接口列表

API接口详细描述请参考API参考

本文所有提供的接口都是通过阿里云的 POP 网关对外透出,客户需要用阿里云的用户身份通过 LinkedMall 的SDK调用接口,LinkedMall已经提供了相应的 demo 程序,可以向对接人员索取。调用本文中所有接口的阿里云账户需要和自身的客户Id绑定,否则将拒绝执行。

说明

客户通过SDK客户端(Client)调用LinkedMall服务时,LinkedMall只能保证服务端稳定性,不能保证客户端稳定性,因此客户侧有秒杀等大流量活动时,请提前通知LinkedMall并自行压测验证接口性能。

2.3 第三阶段:测试联调

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

  2. 售后退款退货逻辑

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

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

2.4 第四阶段:上线发布

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

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

  3. 发货时效:

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

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

  4. 固定账期,根据接口的账单信息核对货款账单,同时联系天猫运营小二完成开票。

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

  • 本页导读 (0)