拉新查询

拉新查询记录的是**「谁把谁带进了会员体系」**：一位老会员通过小程序分享拉来新会员，注册成功后就在这里留一行，能查到新会员的注册时间和对应的拉新人。它是拉新活动结算奖励、算推荐排行的原始依据。

一、功能概述

菜单位置：O2O业务 → 微信商城 → 拉新查询（页面地址 /admin/o2o/wx_invitevip_qry/）

用途	说明
查推荐关系	按注册时间区间筛，看这段时间里每位老会员拉了几位新会员
双向定位	可按新会员编号查「他是谁拉来的」，也可按拉新人编号查「他拉了谁」
导出	导出 Excel 交给门店或运营做奖励结算

本页纯查询：没有新增、没有作废、没有状态，也不显示送的券。要看券发到没有，去拉新下单送券查询。

二、界面布局说明

区域	内容
工具栏	刷新、条件、导出Excel
列表	行号、新会员注册时间、新会员编号、新会员名、拉新人编号、拉新人名称
条件回显	「查询条件: 注册时间: 最近30天」+「记录数: N」
空态	「暂无数据」「共 0 条」

三、业务操作步骤

步骤 1：设时间

点「条件」，弹窗分两组：

注册时间：今天 / 昨天 / 本月 / 上月 / 最近 N 天（7、15、30、60、90、180、365，可自填）/ 指定时段（起止两个日期）。默认「最近 30 天」，即从当天往前推 30 天到当天。

其他过滤：新会员编号、拉新人编号两个输入框，占位提示都是「会员卡编号（精准）」，只支持完整编号匹配，不支持模糊。

步骤 2：查一个人

想知道	怎么填
这位新会员是谁拉来的	在「新会员编号」填他的会员卡编号
这位老会员拉了几个人	在「拉新人编号」填他的会员卡编号，时间放宽到活动区间
某门店/某活动的整体拉新效果	时间设活动区间，两个编号框留空，导出后按拉新人编号汇总

步骤 3：导出结算

点「导出Excel」，按当前条件导出。运营按「拉新人编号」做数据透视即可得到每位老会员的成功拉新人数，与拉新下单送券 的奖励发放对得上。

四、字段详细说明

界面字段	含义
新会员注册时间	新会员在小程序完成会员注册的日期，也就是这条推荐关系成立的时点
新会员编号 / 新会员名	被拉来的会员，取会员卡档案的编号与姓名
拉新人编号 / 拉新人名称	推荐人（老会员）的编号与姓名

数据落在拉新关系表 WX_inviteNewVip 上，两个人都是按会员卡编号回连会员档案取名字的：如果某行的编号查不到会员卡（会员卡被删或编号变更），对应名称会显示为空。列表按注册时间倒序。

五、典型使用场景

场景一：门店做拉新比赛。 每店给一个专属老会员做入口，月底按「拉新人编号」分别查这三个人的记录数，即得各店名次。

场景二：奖励争议核实。 会员说自己推荐过某人。用新会员编号精准查，看「拉新人编号」是不是投诉人；查不到记录说明注册时没走推荐链接，或两人是同一人。

场景三：判断活动是否有效。 活动期记录数几乎为 0，先看拉新下单送券 方案是否生效，再看本页时间是否覆盖活动区间——默认只看最近 30 天，跨月活动要把时间放宽。

六、权限控制与前置条件

• 本页无独立 ERP 菜单权限映射项（Django 新增页面），可见性跟随 O2O业务 分组。
• 前置条件：小程序开启了会员注册与推荐（拉新）功能；已有会员档案（编号能对上 VipCard）。
• 查询按人记忆条件，与线上订单 用的是同一套条件保存机制。

七、常见问题

问：能在这里看到送的券吗？ 答：不能。本页只有推荐关系；送券结果在拉新下单送券查询，那里按「送券目标类型」区分拉新人与新会员各自拿到的券。

问：输入编号后两位数字查不到？ 答：两个编号框都是精准匹配，必须输完整会员卡编号。

问：为什么名称列是空的？ 答：该行的会员编号在会员档案里找不到对应记录（多为档案被删除或编号被改）。可以用编号继续定位，名称需要到会员档案核对。

问：某位老会员的记录一条都没有？ 答：只有新会员注册成功才写关系；仅点击分享链接但没有完成注册的，不会出现在这里。