# 分销

「分销」是 Raise 的分销裂变与佣金结算管理应用，用于建立最多两级的分销体系。你可以通过应用管理分销员档案与关系链、追踪推广链接归因、维护有版本的佣金规则、记录只增不改的佣金账，并为分销员生成线下付款的结算单。本应用为组织员工管理后台，分销员本人不在本界面操作，而是通过站点前端查看个人下线、物料与佣金。

## 谁能用

分销应用通过权限控制操作范围。管理员拥有全部权限。助手不能直接改分销数据，改动必须生成草稿或经你在对话中确认后执行。

| 权限标签 | 默认分配 | 可操作内容 |
|---|---|---|
| 「查看分销员与规则」（界面「分销员查看」） | 普通成员、分析员 | 查看分销员、关系链、规则、设置、等级、冲突与异常、推广物料 |
| 「审核与管理分销员」 | 仅管理员 | 开通、审核、暂停、恢复、结束分销员资格；修改等级与收款人；改绑与结束关系；处理冲突与异常 |
| 「维护规则与推广物料」 | 管理员 | 维护佣金规则版本、基础设置、分销等级、推广物料 |
| 「查看佣金账与结算单」（界面「佣金查看」） | 普通成员、分析员 | 查看佣金列表、佣金流水与导出；查看结算单列表、详情与导出 |
| 「调整佣金（管理员）」 | 仅管理员 | 登记正负佣金调整记录 |
| 「生成结算单与登记已付」 | 管理员 | 预览与生成结算单草稿、确认、作废、登记线下付款 |
| 「查看统计」（界面「统计查看」） | 分析员 | 查看「统计」页面各项报表 |

权限控制在界面上的表现：
- 若账号没有「分销员查看」权限，但拥有「统计查看」权限，打开首页或分销员列表时会自动跳转至「统计」页。
- 若账号既没有「分销员查看」也没有「统计查看」权限，打开应用时会显示空态「没有查看分销的权限」，并引导去开通「分销员查看」或「统计查看」。
- 在各模块无对应权限时，系统会提示无权访问：无分销员权限提示「查看分销员」或「分销员查看」；无佣金权限提示「查看佣金」或「佣金查看」，流水提示「查看佣金流水」，结算提示「查看结算单」；无物料权限提示「查看推广物料」；无统计权限提示「查看统计」或「统计查看」。

## 怎么打开

1. 在[工作台](/guide/workspace)左侧进入「增长」套件，点击「分销」页签。分销属于增长套件的可选成员，组织需要开展分销裂变时可在应用市场安装。
2. 在浏览器中输入地址访问：`https://distribution.apps.{base}`。

进入应用后，左侧导航包含以下页面入口：
- 「分销员」：需拥有「分销员查看」权限。角标显示待审核申请的条数。
- 「关系链」：需拥有「分销员查看」权限，查看与维护客户及分销员的上下线关系。
- 「规则」：需拥有「分销员查看」权限，管理佣金规则、基础设置与分销等级。
- 「佣金」：需拥有「佣金查看」权限，查看全量佣金记录并支持导出与调整。
- 「结算」：需拥有「佣金查看」权限，查看结算单台账与付款记录。
- 「冲突与异常」：需拥有「分销员查看」权限。角标显示未处理异常条数与未查看冲突条数之和。
- 「推广物料」：需拥有「分销员查看」权限，管理分销海报、链接与文案。
- 「统计」：需拥有「统计查看」权限，查看分销业绩、趋势与排行榜。

工作台或助手打开分销员、结算单、规则、关系、等级、冲突、异常或物料时，会落到对应页面或分区。

## 界面一览

![「分销员」列表](/shots/distribution-list.webp)

图：「分销员」列表

1. 页内导航：「分销员」
2. 「规则」：佣金规则、等级和基础设置
3. 「推广物料」：海报和文案
4. 「添加分销员」：用手机号直接开通

| 页面 / 区域 | 主要内容与功能 |
|---|---|
| 「分销员」列表 | 顶部提供「添加分销员」按钮（需管理权限）；有待审核申请时横幅提示「去审核」；搜索框「查找分销员」（占位「姓名 / 推广码」）；状态芯片支持「全部」「待审核」「分销中」「已暂停」「已结束」，以及「全部等级」下拉与「只看有异常的」芯片；表头包含分销员、状态、等级、上线、下线（一级 / 二级）、可结算、累计佣金、加入时间；页脚显示分销员总人数；无数据时提示「还没有分销员」「没有等待审核的申请」或「没有符合条件的分销员」。 |
| 分销员详情页 | 顶部返回链「全部分销员」，展示姓名、推广码与等级；徽章显示状态文案，暂停时显示「佣金暂停成熟」，存在异常时提示待复核异常条数；核心指标区展示「冻结中」「可结算」「结算中」「已结算」「待扣减」「累计佣金」六格；标签页包含「下线」（无下线提示「还没有下线」）、「成交与佣金流水」（说明「只增不改：错了再记一笔纠正。」）与「异常」；侧栏展示「资料」与「上线与下线」（二级下线说明「成交时他也拿二级佣金」）；操作栏支持「通过申请」「拒绝」「暂停」「恢复」「结束资格」「修改」「调整佣金」与「生成结算单」。若找不到分销员提示「找不到这位分销员」。 |
| 「关系链」 | 顶部支持切换「查客户」与「查分销员」；未选人时提示「还没有选人」；查客户通过「客户编号，例如 cu_8f3k2…」查询「这位客户」、一级上线（说明「直接推荐他的人，拿一级佣金」）、二级上线（说明「一级上线的推荐人，拿二级佣金；再往上的人不分佣」）以及「上线历史」，支持操作「改绑上线」与「结束关系」；查分销员展示向下两级分销树；关系状态支持按「全部」「有效」「已结束」筛选。 |
| 「规则」 | 顶部说明「改规则只影响之后的成交。」；包含「佣金规则」「基础设置」「分销等级」三个标签；规则列表展示「当前生效的规则」，空态提示「还没有佣金规则」与「没有规则，成交不产生佣金。」；新建与编辑分区包含「基本信息」「适用范围」「佣金」「冻结期」「适用的分销员等级」「生效时间」，侧栏提供「预览」展示分销员看到的文案与示例，并展示只读的「产品规定（不能修改）」与「版本历史」；基础设置配置申请、归因与防作弊；分销等级管理等级名称、排序与状态。若规则不存在提示「找不到这条规则」。 |
| 「佣金」列表 | 顶部提供「导出 CSV」与「调整」按钮；搜索框「查找佣金」（占位「买家姓名 / 成交编号」）；支持按类型、状态（「冻结中」「可结算」「暂停成熟」「结算中」「已结算」「已冲回」）、级别（「全部级别」「一级」「二级」）及日期筛选；无数据时提示「还没有佣金流水」或「没有符合条件的佣金」。 |
| 「冲突与异常」 | 包含「归因冲突」与「异常复核」两标签；归因冲突说明推广链接与已锁定上线不一致时，佣金一律按已锁定的关系链分，链接里的分销员不分佣；支持筛选「待查看」「全部」，操作「已知晓」；异常复核说明阈值标可疑，有未处理异常时佣金暂停成熟；支持筛选「待复核」「全部」，操作「确认是误报」与「确认作弊」。 |
| 「结算」列表与详情 | 列表展示结算单台账与状态（「草稿」「已确认」「已付款」「已作废」），支持「导出汇总 CSV」（文件名为「结算单汇总.csv」）；空态提示「还没有结算单」或「没有符合条件的结算单」；详情页展示「佣金合计」「扣减」「应付」汇总、「明细」（说明负数为结算后退款扣减）、「信息」、「付款记录」（包含「付款日期」「方式」「凭证」「登记时间」），支持「确认」、详情按钮「作废」、以及「登记已付」。若找不到提示「找不到这张结算单」。 |
| 「推广物料」 | 展示物料卡片，支持「海报」「链接」「文案」3 种物料；海报展示「大标题」「副标题（可不填）」「主题颜色」（「墨黑」「鼠尾草绿」「沙色」「砖红」）「号召语」「二维码指向的页面」，预览区说明「二维码是占位，分销员生成时换成自己的。」；无物料时提示「还没有推广物料」「新建一张海报，分销员即可生成带自己二维码的图。」。 |
| 「统计」 | 提供近 7 天、近 30 天、本月或自选范围（最长 1 年）统计；四格展示「分销员」「成交」「佣金」「待处理」指标，下排展示「冻结中」「可结算」「已结算」「待扣减」；提供「每日趋势」（包含「佣金」「成交额」「成交笔数」）折线与「贡献最多的分销员」排行；无数据时提示「这段时间没有分销成交」。 |

## 常用操作

### 开通分销员

![「添加分销员」：用手机号开通](/shots/distribution-add.webp)

图：「添加分销员」：用手机号开通

1. 怎么找到这个人：手机号或客户编号
2. 「用手机号」：未登记的会在客户中心新建
3. 手机号
4. 分销等级：可不选
5. 「开通」：成为分销员不收费用

1. 在左侧导航点「分销员」。
2. 点右上角「添加分销员」（需拥有「审核与管理分销员」权限）。
3. 选择「怎么找到这个人」：
   - 「用手机号」：输入 11 位数字手机号（以 1 开头）。
   - 「用客户编号」：输入以 `cu_` 开头的客户编号。
4. 填写分销员信息：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「分销等级（可不选）」 | 否 | 从已启用的分销等级中选择。 |
   | 「收款人（可不填）」 | 否 | 填写线下收款户名（非银行卡号）。若与其他未结束分销员重名，会触发异常标记。 |
   | 「备注（可不填）」 | 否 | 填写开通备注信息。 |
5. 点「开通」完成开通。

> **提示**
>
> 分销员必须是客户。若使用手机号开通且该手机号尚未在组织登记，系统会在[客户](/apps/customer)中心自动创建客户档案。成为分销员不收取任何费用。开通后状态直接为「分销中」，来源记录为「后台指定」，系统自动分配 8 位专属推广码（由字母和数字组成，自动排除 0、o、1、l、i 字符）。同一客户不能重复开通分销员。

### 审核分销员申请

1. 当访客在站点提交分销申请且组织未开启自动通过时，申请会进入待审核队列。「分销员」导航角标会显示待审数量。
2. 在左侧导航点「分销员」，点击顶部横幅中的「去审核」，或将状态芯片切换至「待审核」。
3. 检查申请人信息，包括「申请说明」「收款人」「推荐人」。
4. 审核处理：
   - 点「通过」：可选择「分销等级（可不选）」并补充备注。通过后分销员状态变更为「分销中」，从下一笔成交开始计算分佣。
   - 点「拒绝」：在弹出的对话框中必须填写「拒绝原因」。拒绝后分销员状态变更为「已结束」。拒绝对话框写申请人看到「没有通过」，原因仅员工可见；站点上该申请显示为「已结束」。

### 暂停、恢复与结束分销员资格

1. 在左侧导航点「分销员」，点击进入目标分销员详情页。
2. 依据当前状态与业务需求执行操作：
   - **暂停资格**：当分销员处于「分销中」时，点右上角「暂停」，必须填写暂停原因。暂停后状态变更为「已暂停」，徽章提示「佣金暂停成熟」。已计提的佣金保留但停止成熟，后续新成交不再计算分佣。
   - **恢复资格**：当分销员处于「已暂停」时，点右上角「恢复」。恢复后状态变更为「分销中」，冻结期满的佣金继续恢复成熟。
   - **结束资格**：当分销员处于「分销中」或「已暂停」时，点右上角「结束资格」，必须填写结束原因。结束资格后状态变更为「已结束」。

> **注意**
>
> 结束分销员资格不可撤销。结束后该分销员后续不再享受任何分佣，此前已计提的佣金不会自动冲回，如需核减必须通过「调整佣金」处理。若该客户未来需要重新分销，必须重新开通。

### 修改分销员资料

1. 在左侧导航点「分销员」，进入分销员详情页。
2. 处于非待审核、非已结束状态时，点页面操作栏的「修改」。
3. 修改「分销等级（可不选）」、「收款人（可不填）」或备注信息。
4. 点保存。若填写的收款人姓名与其他未结束的分销员完全相同，系统会自动为双方打上「收款人相同」异常标记并提交复核。

### 调整佣金

1. 确认当前账号拥有「调整佣金（管理员）」权限。
2. 在分销员详情页点「调整佣金」，或在「佣金」列表点「调整」。
3. 填写调整信息：
   | 字段 | 必填 | 说明 |
   |---|---|---|
   | 「金额（元）」 | 是 | 输入调整金额（元）。增加佣金输入正数，扣减佣金输入负数。金额不能为 0，绝对值上限为 100,000,000 元。 |
   | 「调整原因」 | 是 | 填写本次调整的具体业务原因，记入审计流水。 |
4. 点「记入账上」完成调整。
   - 正数调整金额会立即进入该分销员的「可结算」账目。
   - 负数调整金额会进入该分销员的「待扣减」账目，在下次结算时自动抵扣。
   - 佣金账目只增不改，系统会追加一条类型为「调整」的流水记录。

### 查询与维护关系链

1. 在左侧导航点「关系链」。
2. **查询客户上线链**：
   - 切换至「查客户」。
   - 在输入框输入客户编号（占位「客户编号，例如 cu_8f3k2…」），或在分销员详情的下线列表中点击客户进入。
   - 查看节点结构：「这位客户」、一级上线（直接推荐人，拿一级佣金）、二级上线（一级上线的推荐人，拿二级佣金；再往上不分佣），以及「上线历史」。
3. **改绑上线**：
   - 在客户关系链视图中，点「改绑上线」（需「审核与管理分销员」权限）。
   - 在对话框中选择「新的上线」（必须处于「分销中」状态），并填写「改绑原因」。
   - 点确认。系统将原关系标记为「已结束」，新关系来源标记为「后台指定」。员工改绑不受锁定期限制，但不能将客户自身设为上线，且不能形成循环链路。
4. **结束关系**：
   - 在客户关系链视图中，点「结束关系」（需「审核与管理分销员」权限）。
   - 在对话框中填写「结束原因」，点「结束关系」。
   - 结束后该关系标记为「已结束」，后续该客户的新成交不再向原上线分佣，此前已计提佣金保持不变。
5. **查询分销员下线树**：
   - 切换至「查分销员」。
   - 选择一位分销员，系统展开展示其向下两级的下线分销树。

### 新建与管理佣金规则

![「规则」：佣金规则列表](/shots/distribution-rules.webp)

图：「规则」：佣金规则列表

1. 「新建规则」：没有规则，成交不产生佣金
2. 「佣金规则」页签
3. 「当前生效的规则」列表
4. 规则状态：「生效中」

1. 在左侧导航点「规则」，进入「佣金规则」标签。
2. 点右上角「新建规则」（需「维护规则与推广物料」权限）。
3. 填写规则配置：
   | 分区 | 字段 | 必填 | 说明 |
   |---|---|---|---|
   | 基本信息 | 「规则名称」 | 是 | 填写规则名称，最多 40 个字。右侧可勾选是否启用。 |
   | 适用范围 | 范围单选 | 是 | 选择「全部商品」「指定商品」或「指定活动」。若选指定商品或指定活动，需手动填写商品编号或活动编号，最多填写 100 个。 |
   | 佣金 | 「一级佣金」 / 「二级佣金」 | 是 | 可分别选择「按比例」或「固定金额」。按比例填写百分数（占位「例如 8」，单位「% 实付金额」）；固定金额填写元（占位「例如 20」，单位「元 每笔成交」）。二级佣金可留空，但一二级不能同时留空。两级比例各自不能超过 100%，合计不能超过 100%。 |
   | 佣金 | 封顶配置 | 否 | 可选填「单笔封顶（元，可不填）」与「每人每月封顶（元，可不填）」，填 0 或不填表示不封顶。月封顶按自然月统计。 |
   | 冻结期 | 「冻结几天」 | 是 | 设置佣金成熟前的冻结天数，取值范围为 1–365 天，默认为 7 天，不能设为 0 天。常用天数为 7、15、30 天。 |
   | 适用等级 | 「适用的分销员等级」 | 否 | 勾选适用的分销等级。界面提示「不勾选 = 所有等级都适用。」。 |
   | 生效时间 | 「从」 / 「到」 | 否 | 配置规则生效的起止时间窗口。 |
4. 在右侧侧栏「预览」中核对分销员看到的说明文案与成交计算示例（「分销员看到的就是这句话。」）。
5. 新建时点「创建规则」（成功「规则已创建」）；再改时点「保存为新版本」（成功提示已保存为新版本，只影响之后的成交）。

> **提示**
>
> 修改规则保存后会生成新版本，界面提示「改规则只影响之后的成交。」，历史已发生的成交不会受新规则影响。若有多条规则同时生效，匹配优先级为：活动 > 商品 > 全部；同优先级按较新版本计算。若系统内没有生效规则，成交不产生佣金；实付基数小于或等于 0 的免费订单不分佣。

### 处理归因冲突与异常复核

1. 在左侧导航点「冲突与异常」。
2. **处理归因冲突**：
   - 进入「归因冲突」标签。页面提示：推广链接与已锁定上线不一致时，佣金一律按已锁定的关系链分，链接里的分销员不分佣。
   - 筛选「待查看」或「全部」记录。
   - 查看冲突记录后，点「已知晓」（可填写备注）。该操作仅用于标记已阅，不会改变佣金分配结果。若确实需要调整推荐人，需前往「关系链」操作改绑上线。
3. **处理异常复核**：
   - 进入「异常复核」标签。页面提示：阈值标可疑；有未处理异常时佣金暂停成熟。
   - 筛选「待复核」或「全部」记录。异常种类包括自购尝试、自己推广自己、短时间大量下线、同一网络密集绑定、同一设备密集绑定、收款人相同。
   - 处于异常状态的分销员，其名下佣金会标记为「暂停成熟」，无法放入结算单。
   - 核查事实后进行处理：
     - **确认误报**：在对话框中填写「处理说明」，点「确认是误报」。若该分销员无其他未处理异常，佣金恢复成熟计算。
     - **确认作弊**：在对话框中填写「处理说明」，点「确认作弊」。系统记录作弊结论，并将该分销员状态直接置为「已暂停」。

### 生成结算单与登记已付款

1. 确认当前账号拥有「生成结算单与登记已付」权限。
2. **生成结算单草稿**：
   - 在左侧导航点「结算」，点「新建结算单」；或在分销员详情页（可结算金额大于 0 时）点「生成结算单」。
   - 选择目标分销员（处于已暂停或存在待复核异常的分销员不可结算）。
   - 进入明细预览：勾选本次结算的正数佣金行。若该分销员存在「待扣减」行，系统会自动带上且不能取消勾选。
   - 确认无误后生成草稿，对应的佣金状态变更为「结算中」。每位分销员同时只能存在一张未完成的结算单（草稿或已确认）。
3. **确认结算单**：
   - 打开结算单详情，核对「佣金合计」「扣减」「应付」金额。
   - 点「确认」，系统复核明细无误后锁定单据，提示「已确认，可以去付款了」，结算单状态变为「已确认」。若期间发生退款导致明细冲突，需作废后重新生成。
4. **作废结算单**：
   - 若结算单处于「草稿」或「已确认」状态且尚未付款，可点详情按钮「作废」，确认按钮是「作废结算单」。
   - 填写「作废原因」后确认，系统提示「已作废」，结算单状态变为「已作废」。单据内包含的佣金退回「可结算」状态，可在后续重新结算。已登记付款的结算单不能作废。
5. **登记已付**：
   - 线下通过银行转账等渠道向分销员转账完毕后，在已确认的结算单详情点「登记已付」。
   - 填写付款信息：
     | 字段 | 必填 | 说明 |
     |---|---|---|
     | 「付款日期」 | 是 | 选择实际付款日期，不能为将来日期。 |
     | 「付款方式」 | 是 | 选择付款方式，可选「银行转账」「现金」「微信转账」「支付宝转账」「其他」。列表「付款记录」列才是「方式」「凭证」。 |
     | 「凭证说明」 | 是 | 填写线下转账凭证号或付款说明。 |
   - 点确认提交。系统提示「已登记付款，经营里记了一笔支出」，结算单状态变更为「已付款」，写入结算流水，并自动向[经营](/apps/biz)应用同步记录一笔分销佣金支出（应付金额为 0 时不入账）。

> **提示**
>
> 本应用仅记录线下付款对账信息，系统不执行线上资金划转。请在线下转账完成后再进入系统登记已付款。

### 创建与维护推广物料

![「推广物料」：海报列表](/shots/distribution-materials.webp)

图：「推广物料」：海报列表

1. 页头：「推广物料」
2. 「新建物料」：一张海报，分销员可生成带自己二维码的图
3. 物料种类：「海报」
4. 状态：「在用」

1. 在左侧导航点「推广物料」（需「维护规则与推广物料」权限）。
2. 点右上角新建物料，选择物料种类：
   - **「海报」**：填写「名称」（提示「给员工看的，分销员看不到」）、「大标题」（必填）、「副标题（可不填）」、选择「主题颜色」（可选「墨黑」「鼠尾草绿」「沙色」「砖红」）、「号召语」以及「二维码指向的页面」。预览区域说明「二维码是占位，分销员生成时换成自己的。」。
   - **「链接」**：填写物料名称与页面路径（路径必须以 `/` 开头）。分销员在站点端生成时会自动附加其专属推广码。
   - **「文案」**：填写物料名称与推广文案（文案最多 500 个字）。
3. 点保存完成创建（新建海报、链接或文案）。分销员可在站点端使用对应物料进行推广。若物料停用，分销员端将不再展示。

### 查看统计与导出数据

1. **查看统计分析**：
   - 在左侧导航点「统计」（需拥有「统计查看」权限）。
   - 选择统计日期范围：近 7 天、近 30 天（默认）、本月，或自选日期范围（最长不超过 1 年）。
   - 查看四项核心指标：「分销员」（统计分销中与已暂停人数）、「成交」、「佣金」（计提减冲回金额）、「待处理」（未查看冲突数与未处理异常数之和）。
   - 查看金额分布格：「冻结中」「可结算」「已结算」「待扣减」。
   - 查看「每日趋势」图表（支持按「佣金」「成交额」「成交笔数」切换）以及「贡献最多的分销员」排行榜。无数据时提示「这段时间没有分销成交」。
2. **导出数据**：
   - 导出佣金流水：在「佣金」列表设置筛选条件后，点右上角「导出 CSV」。
   - 导出结算汇总：在「结算」列表点「导出汇总 CSV」，下载「结算单汇总.csv」。
   - 导出结算明细：在单张结算单详情页点导出，下载该单据的明细 CSV。

## 状态说明

### 分销员状态流转

```
待审核 → (审核通过) → 分销中 → (暂停) → 已暂停 → (恢复) → 分销中
   ↓ (审核拒绝)         ↓ (结束资格)       ↓ (结束资格)
 已结束               已结束             已结束
```

| 状态 | 含义说明 | 允许的操作 |
|---|---|---|
| `待审核` | 访客在站点提交分销申请，等待组织员工审核 | 通过、拒绝 |
| `分销中` | 分销员正常在职分销，推广可正常归因并计提分佣 | 修改、暂停、结束资格、生成结算单（可结算>0）、调整佣金 |
| `已暂停` | 分销资格被暂停，佣金暂停成熟，新成交不再分佣 | 恢复、结束资格、修改、调整佣金 |
| `已结束` | 分销资格被拒绝、终止或结束，不可恢复 | 查看详情、查看关系链历史、调整佣金 |

### 佣金账与资金流转

佣金流水遵循只增不改原则，包含以下核心状态与流转阶段：

```
成交事件 → 冻结中 → (冻结到期) → 可结算 → (生成结算单) → 结算中 → (登记付款) → 已结算
             ↓ (分销员暂停 / 存在异常)   ↑ (作废结算单)
          暂停成熟 ───────────────────────┘
```

| 指标 / 状态 | 含义说明 |
|---|---|
| `冻结中` | 订单成交后计提佣金，尚未达到规则设定的冻结天数。在此期间若发生退款，佣金按退款比例冲回。 |
| `暂停成熟` | 分销员处于「已暂停」状态，或存在「待复核」异常记录。佣金暂停到期成熟，不可放进结算单。异常解除或恢复后，已过冻结期的佣金立即转为可结算。 |
| `可结算` | 冻结期满且分销员状态正常，可以勾选放进结算单的金额。 |
| `结算中` | 已勾选放入结算单草稿或已确认结算单，等待完成线下付款。 |
| `已结算` | 线下付款完成并已登记付款的佣金。 |
| `待扣减` | 佣金结算完成后买家发生退款产生的冲回金额，或管理员登记的负数佣金调整。在下次生成结算单时强制抵扣。 |
| `累计佣金` | 分销员历史所有计提佣金减去冲回金额的净总额。 |
| `已冲回` | 订单退款或订单作废后冲回的佣金状态。 |

### 结算单状态流转

```
草稿 → (确认) → 已确认 → (登记已付款) → 已付款
  ↓ (作废)        ↓ (作废)
已作废          已作废
```

| 状态 | 含义说明 | 允许的操作 |
|---|---|---|
| `草稿` | 结算单已生成，明细已暂锁，尚未完成最终确认 | 确认、作废结算单、导出明细 |
| `已确认` | 结算单金额与明细已锁定，等待线下付款 | 「登记已付」、作废、导出明细 |
| `已付款` | 线下已打款并在系统完成登记，已向经营记支出 | 导出明细（不可作废） |
| `已作废` | 结算单已作废，包含的佣金已退回「可结算」 | 导出明细 |

## 让助手帮你做

你可以直接在对话框中给助手发送指令，由助手帮你起草分销员信息、查询数据或处理业务操作。

你可以这样对助手说：
> 帮我把客户 cu_8f3k2 开通为分销员，等级选金牌。
> 审核通过尾号 8899 的分销员申请。
> 新建一条佣金规则，全部商品按 8% 提成，冻结 7 天。
> 给分销员张三生成一张结算单并确认。
> 登记结算单 JS2026-0001 已付款，方式为银行转账，凭证为流水号 998811。
> 查一下这个月贡献最多的分销员。

### 交互与确认机制

助手在处理分销业务时，根据操作类型与风险级别采取不同的交互模式：

| 操作类别 | 涉及动作 | 交互方式 | 风险级别 |
|---|---|---|---|
| 表单起草与设置修改 | 新增分销员、修改分销员、新建/修改佣金规则、修改基础设置与防作弊阈值、新增/修改分销等级、创建/修改物料、生成结算单 | 助手生成[草稿](/agent/drafts)，由你审阅应用 | 普通 / 高 |
| 审核与流转操作 | 通过分销员申请、驳回分销员申请、恢复分销员、确认异常是误报 | 助手在对话中发起[动作确认](/agent/confirm)，经你确认后执行 | 高 |
| 已阅标记 | 「已知晓」（备注可不填） | 助手在对话中发起[动作确认](/agent/confirm) | 普通 |
| 资金与破坏性操作 | 暂停分销员、结束分销员资格、更换上线、结束关系、调整佣金、确认作弊、确认结算单、作废结算单、登记结算单已付款 | 属于高风险破坏性动作，助手发起严格二次确认，经你确认后执行，不能预签 | 高 |

> **提示**
>
> 助手不能自己改分销数据，所有变更均需通过草稿或动作确认由你授权并以你的身份执行。

## 设置

拥有「维护规则与推广物料」权限的成员可以在「规则」页面配置各项规则与参数。

### 基础设置

在「规则」页面的「基础设置」标签中进行配置，保存成功后提示「设置已保存」：

| 分区 | 设置项 | 默认值 | 取值范围 | 说明 |
|---|---|---|---|---|
| 「成为分销员」 | 「申请后自动通过」 | 关闭 | 开启 / 关闭 | 开启后访客在站点提交申请即刻成为分销员并生成推广码；关闭则需人工在「分销员」列表逐一审核。 |
| 「归因：客户算谁的」 | 「锁定期（天）」 | 90 天 | 1–365 天 | 客户首次通过推广链接建立绑定后的保护期限。在锁定期内，其他推广链接无法抢夺归因。 |
| 「归因：客户算谁的」 | 「锁定期过后」 | 「首次绑定优先」 | 「首次绑定优先」 / 「最后点击覆盖」 | 锁定期结束后的归因策略。选择「首次绑定优先」则继续保留原上线；选择「最后点击覆盖」则后续访问的新推广码可覆盖原上线。 |
| 「防作弊阈值」 | 「每小时新增下线」 | 20 条 | ≥ 1 的整数 | 单个分销员每小时新增下线达到该数值时触发异常标记。 |
| 「防作弊阈值」 | 「同一网络地址每天绑定」 | 5 条 | ≥ 1 的整数 | 同一 IP 地址每天绑定下线达到该数值时触发异常标记。 |
| 「防作弊阈值」 | 「同一设备每天绑定」 | 3 条 | ≥ 1 的整数 | 同一设备每天绑定下线达到该数值时触发异常标记。 |

### 硬性产品规定

系统内置严格的产品规定（「产品规定（不能修改）」），用于保障分销合规性，不可更改：
- **「最多两级」**：一级是直接推荐成交的人，二级是他的推荐人，再往上的人不分佣。
- **「佣金只来自真实成交」**：无入门费、无按人头拉人奖励，佣金严格根据实付成交金额计算。
- **「自购不返」**：买家在自己的分销链路上下单时不产生返佣。
- **「规则对分销员可见」**：佣金计算规则文案向分销员公开展示。
- **「冻结期不能为 0」**：佣金冻结天数必须在 1–365 天之间，不能为 0 天。

### 分销等级

在「规则」页面的「分销等级」标签中维护分销员等级：
- 支持配置等级名称（最多 20 个字）、排序整数以及启用状态（「使用中」或「已停用」）。
- 停用等级后，无法再将该等级分配给新分销员，此前已分配该等级的分销员保持不变。
- 无等级时列表提示「还没有等级」。

## 注意事项

- **不可撤销的操作**：
  - 「结束分销员资格」：操作不可撤销。结束后分销员不再享受分佣，此前已计提佣金不会自动冲回（如需核减须通过调整佣金处理），若需重新参与分销必须重新开通。
  - 「结束关系」：操作不可撤销。结束后后续该客户的新成交不再向该分销员分佣。
  - 「登记已付」：结算单一旦登记已付，不可作废，且不可重复登记。
  - 「作废结算单」：草稿或已确认的结算单作废后，关联的佣金重新回到「可结算」状态。
- **层级限制与合规红线**：
  - 系统严格执行最多两级分销：直接推荐人拿一级佣金，直接推荐人的上线拿二级佣金，再往上的上级不分佣。
  - 严禁收取入门费与拉人头奖励。开通分销员不收费，佣金必须基于订单成交产生。自购订单不返佣。
- **归因与绑定规则**：
  - 一个客户在同一时间只能绑定一个有效上线。分销员不能成为自己的上线，关系链不允许形成环路。
  - 锁定期内（默认 90 天）上线关系受到保护，其他人无法通过推广链接抢绑；锁定期过后依据设置执行首次绑定优先或最后点击覆盖。
  - 归因冲突机制：若推广链接与已锁定上线不一致，佣金一律归属于锁定的上线，推广链接对应的分销员不分佣，系统在「归因冲突」中记录该事实。
- **佣金与对账规则**：
  - 佣金账只增不改：系统不直接修改或删除既有佣金记录，数据纠偏必须通过追加正负调整流水完成。
  - 线下打款登记：结算单只用于记录线下转账事实，系统不提供在线划扣资金。登记已付款后会自动向[经营](/apps/biz)应用同步记录一笔支出（分销佣金支出；应付金额为 0 时不入账）。
  - 退款冲回与待扣减：结算前发生退款按比例冲回冻结或可结算佣金；结算后发生退款，冲回金额计入「待扣减」，在下次结算时自动抵扣，不向分销员追索已付款项。
  - 暂停成熟：分销员处于「已暂停」状态或存在未处理异常时，佣金「暂停成熟」，在此期间无法生成结算单。
- **推广码规则**：
  - 推广码为 8 位随机字母与数字组合（排除 0、o、1、l、i），组织内全局唯一，生成后不可修改。
- **权限与可见范围**：
  - 本应用仅限组织内部员工使用，分销员本人无法登录本后台。分销员仅能通过站点前端页面查看个人下线、物料与佣金。

## 目前不支持

- 在线直接打款、自动代扣个税、开具发票、分销员实名认证与银行卡绑定。
- 三级及以上分销、团队奖、极差分红、复投分红、收取入门费或按人头拉人奖励。
- 分销等级自动晋升引擎。
- 自购优惠或自购折扣。
- 分销员培训考核功能。
- 员工后台直接点击按钮主动生成邀请下线链接。
- 客户合并或匿名化时自动同步变更分销员历史记录。

## 常见问题

#### 为什么分销员的可结算金额一直没有增加，或者提示「佣金暂停成熟」？
请排查以下几种情况：
1. 佣金仍在冻结期内，尚未到达成熟日期。
2. 该分销员当前处于「已暂停」状态，佣金会停止成熟。
3. 该分销员存在尚未处理的「待复核」异常记录。当触发防作弊阈值或存在异常时，系统会暂停佣金成熟。在异常被标记为误报或恢复正常前，无法将该佣金纳入结算单。

#### 客户通过其他分销员的推广链接下单，为什么佣金还是算给了原推荐人？
客户在建立绑定关系后处于锁定期内（默认 90 天）。在锁定期内，该客户的上线关系受到系统保护，其他分销员的推广链接无法覆盖已有上线。此时系统会在「归因冲突」中记录一条记录，但佣金仍严格按照已锁定的关系链分配给原上线，推广链接中的分销员不分佣。

#### 结算完成后买家发生了退款，已经付给分销员的佣金怎么处理？
系统不会向前追索已付佣金。因退款产生的佣金冲回金额会自动进入该分销员的「待扣减」账目。在下次为该分销员生成新结算单时，系统会自动将「待扣减」金额带入结算单明细中，直接抵扣应付金额。

#### 为什么在分销员详情页中，「生成结算单」按钮无法点击或找不到入口？
生成结算单需满足以下条件：
1. 当前登录账号必须拥有「生成结算单与登记已付」权限。
2. 分销员的「可结算」金额必须大于 0。
3. 分销员不能处于「已暂停」状态，且不能存在未处理的「待复核」异常。
4. 该分销员当前不能有其他处于「草稿」或「已确认」状态的未完成结算单（每位分销员同时只能存在一张未完成的结算单）。

#### 为什么在规则中无法配置三级分销或拉人头奖励？
系统严格执行合规化分销机制，内置「最多两级」与「佣金只来自真实成交」的硬性规定，且不可修改。分销层级严格限制在两级以内，且佣金必须基于订单实付金额计算，不支持设置入门费或拉人头奖励。