# 前言
三级分销的使用前提是用户之间关系的建立，系统首先要明确某个用户是哪个用户邀请（发展）的，在系统中建立用户与用户的关系网络，才能在后续销售完成后根据关系进行返利。
所谓的三级分销，是指的返利层级最多为3级，当然通过将第二、第三级的返利设置为0 来实现一级分销；将第三级返利设置为0来实现2级分销。
用户的关系是如何建立的呢？请回顾以下章节：
[《如何建立用户之间的邀请关系 / 邀请注册机制》](https://www.yuque.com/apifm/doc/lc73ys)
# 启用插件
1. 如果你是免费会员户，有点小遗憾，暂时无法使用api工厂的插件功能；
2. 如果你是专业版会员，那么登录后台，左侧菜单 “工厂设置” --> “插件管理” ，找到 “三级分销” 插件，在线购买开通即可；
3. 如果你是增值版会员，那么无需做任何操作，你可以免费使用所有的插件功能；
# 启用模块
左侧菜单 “工厂设置” --> “模块管理” ，找到 “三级分销” 模块，启用模块后刷新页面，你将可以在左侧菜单中看到三级分销相关的菜单
# 分销设置
三级分销支持进行现金 / 积分返佣的形式，你可以根据你自己的实际需要，设置返现金或者返积分
如上图的设置：
1. 一级返佣： 销售额_50%_28%
2. 二级返佣： 销售额_50%_13%
3. 三级返佣： 销售额_50%_9%
这里的设置是全局设置，上图中设置了所有商品销售额拿出 50% 来进行返佣分配，但是实际应用中，会有需求针对不同的商品进行单独的比例设置；
比如利润高的商品可以设置拿出60%来返佣；利润薄的商品只能拿出 30% 来返佣；
针对这种需求，你可以在商品管理，发布/编辑 商品的时候，针对商品单独设计这个比例；
**商品设置了比例以商品设置为准；商品未设置比例的以这里的全局设置比例为准**
# 关于分销商的说明
只有分销商才能得到返佣，如果是普通用户，还不是分销商身份，虽然可以正常建立用户关系，但是将拿不到返佣，继而也会影响到其上级分销商的返佣。
**在左侧菜单 “用户管理” 中，可查看并设置某个用户的分销商身份**
# 如何成为分销商
用户想成为分销商，有以下几种途径：
## 管理员手动调整
管理员在“用户管理”中，编辑某个用户，直接将其设置为分销商或者取消某用户的分销商身份；
## 用户申请后管理员审核
用户在小程序/网页/app中申请成为分销商，管理员在后台审核批准后，该用户成为分销商；
## 用户注册后自动成为分销商
通过设置下面的系统参数设置，使得新注册用户自动获得分销商身份
开关参数 REGISTER_OPEN_SELLER 设置为 开启状态
## 邀请指定数量用户自动升级
在分销设置中，可设置邀请n个用户以后，自动获得分销商身份
## 完成任务自助升级
在系统参数中，增加文本参数：upgrade_fxs_condition
配置如下 Json ：
```javascript
{
fans: 100,
fansLevel1: 10,
orderNumber90Days: 100
}
```
+ fans 邀请人数（粉丝数）
+ fansLevel1 直属邀请人数（直属粉丝数）
+ orderNumber90Days 最近90天内结算订单数
上面的例子中，只要满足有100个粉丝数、直属粉丝10个，最近90天内建议笔数达到 100笔 即可自助升级成为分销商，而无需通过管理员审核
升级方法：
通过调用接口：/{domain}/saleDistribution/upgrade 自助完成升级
## 直接付费升级成为分销商
后台开启付费升级，届时用户即可通过接口直接购买开通分销商了
## 购买指定的分销商品获得分销商身份
# 相关接口
具体的接口及接口说明，请查阅接口文档，这里为了方便大家理解，简单的做了一下汇总：
## 读取后台分销设置
读取上图后台配置的分销设置信息，通过该接口，即可读取是否支持付费升级以及付费的金额
```plain
GET /{domain}/saleDistribution/setting
```
## 申请成为分销商
用户自助申请成为分销商
```plain
POST /{domain}/saleDistribution/apply/v2
```
## 查看申请进度
用户自助申请成为分销商后，可以通过该接口查询审核进度
```plain
GET /{domain}/saleDistribution/apply/progress/v2
```
## 完成任务自助升级为分销商
```plain
POST /{domain}/saleDistribution/upgrade
```
## 付费升级为分销商
```plain
POST /{domain}/saleDistribution/buy
```
## 查看我的团队
```plain
POST /{domain}/saleDistribution/members
```
## 查看佣金明细
```plain
POST /{domain}/saleDistribution/commision/log
```
## 查看订单详情
查看返佣订单详情信息
```plain
GET /{domain}/saleDistribution/order-info
```
## 获取待结算佣金统计
```plain
GET /{domain}/saleDistribution/commission/freeze
```
接口返回：
+ money 待结算佣金
+ mjtCommission 待返佣 mjt
+ mjtOrder 待赠送 mjt
## 分销商累计销售额排行榜
```plain
GET /{domain}/saleDistribution/sale-room-rank/total
```
## 分销商团队销售额排行榜
```plain
GET /{domain}/saleDistribution/sale-room-rank/team/total
```
## 查询某天的销售额排行榜
```plain
GET /{domain}/saleDistribution/sale-room-rank/daily
```
## 查询自己N天累计业务汇总
```plain
GET /{domain}/saleDistribution/statistics/days
```
接口返回：
+ number 订单总笔数
+ commisionAmount 佣金累计金额
+ saleroom 累计销售额
## 团队成员统计
```plain
GET /{domain}/saleDistribution/members/statistics
```
接口返回：
+ totleFans 全部粉丝人数
+ totleChildFxs 全部分销商人数
+ totleChildFxsLevel1 全部直属分销商人数
+ totleChildFxsLevel2 全部间接分销商人数
# 常见问题
## 没有产生返佣记录和佣金返现?
请按下面步骤进行排查：
1. 检查 “三级分销插件” 是否在有效期？
_前往 “工厂设置” --> “插件管理”，查看 “三级分销插件”，是否在有效期内；_
2. 检查分销设置是否正确
_左侧菜单 --> 分销管理 --> 分销设置，检查返佣开关是处于开启状态，消费订单状态和 “到账类型” 设置的匹配；_
_计算订单金额 _ 返佣比例，保留2位小数后的返佣金额大于0；*
3.返佣的金额计算方法
_订单金额 _ 商品返佣比例 * 能拿的佣金比例
计算结果必须大于0，否则不返佣*
4. 分销商才可以享受返佣待遇
*A 邀请 B ，B 下单，A 没有拿到返佣，也没有看到返佣记录
那么，建议您此刻立马去 “用户管理” 里面，查看A 是否是分销商，只有分销商才能享受返佣
如果A 还不是分销商，请编辑该用户，把他（她）设置为分销商*
5. 以上问题都已排查，还是没有返佣怎么办？
*接下来，我觉得我们应该去检查一下 A 到底是不是 B 的上线了：
前往用户管理，搜索框“邀请人编号”处输入A的用户编号，点击搜索，查看B在不在A的邀请人列表中
如果没有记录，说明 B 不是 A 邀请的，那么A自然就得不到返佣了*
6. 用户关系何时建立？
[《如何建立用户之间的邀请关系 / 邀请注册机制》](https://www.yuque.com/apifm/doc/lc73ys)
7. 后期如何修改用户关系？
左侧菜单 --> 分销管理 --> 用户关系管理
可以将不想存在的用户关系删除，重建用户关系
请注意，用户关系错综复杂，重建用户关系需要有比较清晰的头脑，不建议一般用户手动调整关系而导致不可逆的数据错误！
```plain
举个例子， A 发展 B，B 发展 C， C 发展 D， D 发展 E
用户关系如下：
A 邀请 B 1级 关系；
A 邀请 C 2级 关系；
A 邀请 D 3级 关系；
B 邀请 C 1级 关系；
B 邀请 D 2级 关系；
B 邀请 E 3级 关系；
C 邀请 D 1级 关系；
C 邀请 E 2级 关系；
D 邀请 E 1级 关系；
```
_也就是说，每个用户对应的需要建立 3 条关系，分别表示 直接上级、间接上级、间间接上级_
**如果不是很能理解这个概念的，不建议去调整用户关系！！！**
8. 返佣最多有几级？
最多三级！
```plain
D 把商品卖给 E ，那么 D 首先拿到一级返佣比例的返佣；C 拿二级； B拿三级；
虽然B是A发展的，但是返佣不能超过3级，所以A没有返佣
```
## 只要1级/2级分销怎么办？
你只要把第三级的返佣比例设置为0，那么相当于就是两级分销；
同理，你只要把 2、3 两级的返佣比例都设置为0，那么相当于就只有1级分销了；