分销员查询

分销员查询用来管小程序分销（推荐拿提成）的名单：谁能做分销员、什么时候创建的、现在是不是还在职。它是一张报表页，唯一的操作是把某个分销员停用或恢复正常。

一、功能概述

菜单位置：O2O业务 → 微信商城 → 分销员查询（页面地址 /admin/o2o/wxrepresentativeqryreport/）

用途	说明
查分销员名单	按注册时间与姓名/手机号筛出分销员
停用分销资格	点状态列即可在正常与停用之间切换，停用后该手机号不能再做分销
导出名单	导出当前筛选结果

分销员的产生不在本页：会员在小程序里申请成为分销员（或门店代为开通）后才会出现在这里，本页只能停用，不能新增。

二、界面布局说明

区域	内容
条件区	第一行「注册时间」页签：今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 自定义（自定义带起止日期）
条件区	第二行「分销员名」：文本框 + 匹配方式下拉（包含 / 等于 / 开头为 / 结尾为 / 不等于 / 不包含 / 介于）
条件区	第三行「手机号」：同上七种匹配方式
条件区	第四行「状态」：不限 / 正常 / 停用
按钮	查询、重置、导出；右侧「★ 方案」用于保存/调用常用条件组合
已选条件回显	「已选条件： 注册时间 等于 本月 ×」，点 × 移除该条件
列表	分销员名、手机号（这两列冻结在左侧）、创建时间、状态，右上「共 N 条」

三、业务操作步骤

步骤 1：查人

想查	怎么填
本月新增的分销员	注册时间点「本月」→ 查询
某个手机号是不是分销员	「手机号」匹配方式选「等于」，填完整号码 → 查询
某个人名下所有分销记录	「分销员名」选「包含」，填姓名里的两个字
现在还在职的	状态选「正常」
已经被停的	状态选「停用」

条件默认不带时间限制时按「本月」计，跨月要自己改页签或用「自定义」。

步骤 2：停用或恢复分销员

在结果表里点该行的状态列：

• 状态为「正常」→ 点一下变「停用」，该分销员的推荐/提成关系即被冻结。
• 状态为「停用」→ 点一下恢复「正常」。

停用是按手机号生效的：同一个手机号在名单里只对应一个分销身份，切换的是这条身份记录。

步骤 3：导出与留存

点「导出」下载当前筛选结果。名单交付门店做提成结算前，先用「状态=正常」过滤，避免给已停用的人算提成。

步骤 4：常用条件存成方案

条件组合好后点「★ 方案」保存，下次直接调出，适合每周固定查「本周新增 + 状态正常」这类口径。

四、字段详细说明

界面字段	含义
分销员名	分销员姓名，来自分销员档案的用户名
手机号	分销员注册手机号，也是停用/切换状态的定位依据
创建时间	成为分销员的时间
状态	正常 / 停用 两种；档案里的停用标记为 1 时显示「停用」，其余（含空值）显示「正常」

数据来自分销员档案表 WX_Representative。列表默认按创建时间倒序，最新开通的排在最上面。

五、典型使用场景

场景一：分销员离职或违规。 找到他的行，点状态列改成「停用」。停用后他带来的分销关系不再产生提成，但历史记录仍可查。

场景二：核对提成名单。 状态选「正常」，时间用自定义覆盖整个结算周期，导出后与分销提成明细核对人数。

场景三：怀疑有人重复注册。 「手机号」用「包含」查前三后四，或用「介于」按号段查，看同一人是否有多个分销身份。

六、权限控制与前置条件

• 本页是报表页，无独立 ERP 菜单权限映射项（Django 新增页面），可见性跟随 O2O业务 分组。
• 前置条件：小程序端已开通分销功能，会员可申请分销员；否则名单为空。
• 停用/恢复只对已存在的分销员生效，本页不提供开通与删除。

七、常见问题

问：能在这里新增分销员吗？ 答：不能。分销员由会员在小程序侧重申请产生，本页只查与停用/恢复。

问：状态点不动？ 答：状态列是可点链接；如果点了没反应，先确认该行手机号非空——停用是按手机号定位的。

问：老地址打不开？ 答：旧地址 /admin/o2o/wx_representative_qry/ 已自动跳转到当前地址，直接用新菜单进即可。

问：导出的文件打不开或中文乱码。 答：报表导出的是 CSV，用 Excel 的「数据 → 从文本」按 UTF-8 打开即可正常显示中文。