扫码分销示例

本文档介绍扫码分销功能，通过实际操作演示如何设置分销商、生成分销二维码、用户绑定以及查看分销订单和佣金等完整流程。

功能概述

扫码分销功能允许平台管理员创建分销商账号，为分销商生成专属二维码。用户通过扫描分销二维码进入小程序后下单，系统会自动记录订单归属分销商，分销商可查看订单和佣金信息。

核心流程：

1. 平台端 - 创建分销商并生成二维码
2. 小程序端 - 用户扫码绑定分销关系
3. 小程序端 - 用户下单，订单自动归属分销商
4. 小程序端 - 分销商查看订单和佣金

平台端操作流程

第一步：创建商家分销商

平台管理员在 分销管理 → 商家分销 → 商家分销商 页面创建分销商账号。

操作步骤：

1. 点击"新增"按钮，填写分销商信息：

   • 二维码跳转类型：选择"平台"（跳转到平台小程序首页）或"店铺"（跳转到指定店铺首页）
   • 分销商名称：手动录入（平台类型）或下拉选择店铺（店铺类型）
   • 管理员姓名：手动录入或自动带出（根据选择的店铺）
   • 管理员手机号：手动录入或自动带出（根据选择的店铺）
   • 佣金比例：手动录入（如：10%）

2. 点击"保存"按钮，系统会自动生成分销二维码

详细操作说明： 参考 商家分销商 文档

第二步：下载分销二维码

创建分销商后，系统会自动生成专属二维码。

操作步骤：

1. 在分销商列表中，点击对应分销商的"下载二维码"按钮
2. 系统会自动下载该分销商的二维码图片
3. 分销商可以将二维码分享给客户进行扫码

详细操作说明： 参考 商家分销商 文档

第三步：用户绑定管理

用户通过扫描分销二维码进入小程序后，系统会自动创建分销商用户记录，建立用户与分销商的绑定关系。

绑定规则：

• 用户扫码后，系统自动记录用户手机号与分销商的绑定关系
• 支持设置绑定有效期（如：60天），在有效期内用户下单均计入该分销商
• 若用户首次扫码未登录，系统会在其后续登录时自动识别并关联之前的分销关系（在有效期24小时内）

平台端查看绑定用户：

在 分销管理 → 商家分销 → 分销商用户 页面可以查看所有绑定用户信息：

• 分销商名称
• 用户手机号码
• 绑定时间
• 过期时间
• 启用状态

详细操作说明： 参考 分销商用户 文档

第四步：分销佣金设置

平台可在创建或编辑分销商时设置佣金比例。

佣金计算：

佣金金额 = 订单金额 × 佣金比例

操作步骤：

1. 在分销商列表或编辑页面，设置佣金比例（如：10%）
2. 保存后，该分销商的所有订单将按此比例计算佣金

第五步：分销商订单管理

平台可在 分销管理 → 商家分销 → 分销商订单 页面查看各分销商的订单明细。

订单数据来源：

• 通过扫描分销二维码建立关系的用户
• 在绑定有效期内下的订单

查询条件：

• 分销商：选择分销商名称
• 订单号：输入订单号
• 下单时间：选择时间范围
• 结算状态：选择结算状态（待结算/已结算）

订单信息包括：

• 分销商名称
• 订单号
• 用户手机号
• 订单金额
• 佣金比例
• 佣金金额（系统自动计算）
• 下单时间
• 结算状态
• 结算时间

详细操作说明： 参考 分销商订单 文档

小程序端操作流程

第一步：用户扫码绑定分销关系

操作场景：

1. 用户已登录状态扫码：

   • 用户扫描分销二维码后，系统自动记录用户手机号与分销商的绑定关系
   • 根据二维码跳转类型，跳转到平台首页或指定店铺首页

2. 用户未登录状态扫码：

   • 用户扫描分销二维码后，系统记录扫码信息
   • 用户后续登录时，系统自动识别并关联之前的分销关系（在有效期24小时内）

绑定有效期：

• 平台可设置用户与分销商的绑定有效期（如：60天）
• 在有效期内，用户下单均计入该分销商

第二步：用户下单

用户通过分销二维码进入小程序后，在绑定有效期内下单，系统会自动记录订单归属分销商。

订单归属规则：

• 系统自动识别用户当前绑定的分销商
• 订单创建时自动关联分销商信息
• 订单金额和佣金信息自动计算

第三步：分销商查看订单

分销商可通过申请分销商时，绑定的管理员手机号登录小程序，查看分销订单列表及详情。

查看入口：

如果当前用户的小程序绑定的手机号有分销商数据，在平台小程序的"我的"界面，会有以下入口：

• 分销订单 - 查看分销订单列表
• 查看佣金 - 查看累计佣金

订单信息包括：

• 订单号
• 联系人
• 订单金额
• 订单状态
• 下单时间

第四步：分销商查看佣金

分销商可在小程序"我的"界面点击"查看佣金"，查看累计佣金信息。

佣金信息包括：

• 累计佣金总额
• 已结算佣金
• 佣金明细列表

实际操作演示

下面通过一个完整的示例演示扫码分销的完整流程。

演示环境信息

角色	信息
平台管理员	平台后台管理员
分销商	张三（管理员手机号：13800138000）
用户	李四（手机号：13900139000）
二维码跳转类型	平台
佣金比例	10%
绑定有效期	60天

第一步：平台创建分销商

1. 平台管理员登录后台，进入 分销管理 → 商家分销 → 商家分销商
2. 点击"新增"按钮，填写分销商信息：
   • 二维码跳转类型：选择"平台"
   • 分销商名称：输入"张三分销商"
   • 管理员姓名：输入"张三"
   • 管理员手机号：输入"13800138000"
   • 佣金比例：输入"10"
3. 点击"保存"按钮，系统自动生成分销二维码

第二步：下载并分享二维码

1. 在分销商列表中，找到"张三分销商"，点击"下载二维码"按钮
2. 将下载的二维码图片分享给分销商张三
3. 张三可以将二维码分享给客户进行扫码

第三步：用户扫码绑定

场景一：用户已登录状态扫码

1. 用户李四（已登录小程序）扫描分销二维码
2. 系统自动记录绑定关系：
   • 用户手机号：13900139000
   • 分销商：张三分销商
   • 绑定时间：当前时间
   • 过期时间：绑定时间 + 60天

场景二：用户未登录状态扫码

1. 用户李四（未登录）扫描分销二维码
2. 系统记录扫码信息（临时存储）
3. 用户后续登录小程序时，系统自动识别并关联分销关系（在有效期24小时内）

第四步：用户下单

1. 用户李四在绑定有效期内下单，订单金额为 1000 元
2. 系统自动记录订单归属：
   • 订单归属分销商：张三分销商
   • 订单金额：1000 元
   • 佣金比例：10%
   • 佣金金额：100 元（1000 × 10%）

第五步：平台查看订单

1. 平台管理员登录后台，进入 分销管理 → 商家分销 → 分销商订单
2. 在订单列表中可以看到：
   • 分销商名称：张三分销商
   • 订单号：系统生成的订单号
   • 用户手机号：13900139000
   • 订单金额：1000 元
   • 佣金比例：10%
   • 佣金金额：100 元
   • 下单时间：订单创建时间
   • 结算状态：待结算

第六步：分销商查看订单和佣金

1. 分销商张三使用管理员手机号（13800138000）登录小程序
2. 在"我的"界面，可以看到"分销订单"和"查看佣金"入口
3. 点击"分销订单"，查看订单列表：
   • 可以看到用户李四的订单信息
   • 订单金额：1000 元
4. 点击"查看佣金"，查看累计佣金：
   • 累计佣金总额：100 元
   • 待结算佣金：100 元

第七步：平台结算订单

1. 平台管理员在分销商订单列表中，找到待结算的订单

2. 点击"结算"按钮，确认结算

3. 系统更新订单状态：

   • 结算状态：已结算
   • 结算时间：当前时间

4. 分销商在小程序查看佣金时，可以看到：

   • 累计佣金总额：100 元
   • 已结算佣金：100 元
   • 待结算佣金：0 元

注意事项

1. 管理员手机号唯一性： 管理员手机号是分销商的唯一标识，平台小程序端通过管理员手机号来判断用户是否是分销商

2. 绑定有效期： 用户与分销商的绑定关系有有效期限制，超过有效期后，用户下单不再计入该分销商

3. 订单归属规则： 只有通过扫描分销二维码建立绑定关系的用户，在有效期内下单，订单才会归属分销商

4. 佣金计算： 佣金金额 = 订单金额 × 佣金比例，系统自动计算

5. 结算管理： 平台管理员可以手动结算订单，结算后的订单佣金计入分销商的已结算佣金

6. 二维码跳转类型：

   • 选择"平台"：扫码后跳转到平台小程序首页
   • 选择"店铺"：扫码后跳转到指定店铺首页

相关文档

• 商家分销商 - 分销商创建和管理
• 分销商用户 - 用户绑定关系管理
• 分销商订单 - 订单查看和结算管理