爱分销

1. 概述

1.1. 术语

1.2. 需求背景

      将业界有价值的分销员应用引入有赞体系,为有赞商家赋能。通过电商云的开放能力,将分销员功能依赖的节点通过扩展点、接口形式开放出去。外部分销员应用通过简单的扩展点、开放接口便可将拥有丰富功能的玩法接入有赞电商生态。同时有赞大量的商家也为外部分销员带客户和流量。

1.3. 选题目标

    1. 通过扩展点和开放接口,打通有赞和开发者分销员应用;

    2. 接入更多专业领域应用的同时,有赞大量的商家也为外部应用带来更多客户和流量;

2. 用例分析

2.1 用例拆解

        image.png

   绿色部分为有赞云已有能力;橘黄色部分依赖于有赞的开放接口或扩展点;灰色部分为分销员 app 自有能力。

2.2 业务流程

        image.png

2.3 案例

   商家端

   image.pngimage.pngimage.pngimage.png

   分销员端

   image.png

3. 业务流程分析

3.1 商品管理(有赞商家)

   image.png

3.2 查询分享商品列表(分销员)

   image.png

   所生成的分销链接 url 格式为:https://h5.youzan.com/v2/goods/alias?tp_ps=tag,其中 tag 是分销员的唯一标记。

3.3 通过分享链接下单(买家)

   image.png

   订单成功消息扩展字段有 TP_PS 部分内容。

3.4 分享订单退款(买家)

   image.png

   订单详情扩展字段有 TP_PS 部分内容。

4. 系统接口与扩展点

4.1 对外开放接口

接口内容 提供方 开放接口地址
接口内容 提供方 开放接口地址
open-api-1 商品列表查询 商品中心 https://open.youzan.com/v3/apicenter/doc-api-main/1/2/item/youzan.items.inventory.get
open-api-2 查询商品详情 商品中心 https://open.youzan.com/v3/apicenter/doc-api-main/1/2/item/youzan.item.get
open-api-2 商品列表详情查询 商品中心 https://open.youzan.com/v3/apicenter/doc-api-main/1/2/item/youzan.item.search
open-api-4 交易详情查询 交易中心 https://open.youzan.com/v3/apicenter/doc-api-main/1/2/trade/youzan.trade.get

4.2 扩展点

接口内容 提供方 地址
extension-1 支付成功消息扩展点 交易中心 [https://doc.youzanyun.com/doc#/content/EXT/1-1/detail/ext/42](https://doc.youzanyun.com/doc#/content/EXT/1-1/detail/ext/38)
extension-2 退款订单状态更新消息扩展点 交易中心 https://doc.youzanyun.com/doc#/content/EXT/1-1/detail/ext/60