会员卡自动升级查询
会员等级设成自动升级后，卡的等级会在后台悄悄变化：顾客充了一笔钱、消费到某个额度，第二天卡就升了一级，权益、价格、活动跟着换一套。顾客问"我怎么升级了"、运营要核"这批人为什么没升"，都需要一张按卡逐条留痕的表。会员卡自动升级查询把系统每次自动判定并改写的等级记录列出来：哪张卡、什么业务日期、从哪个类别哪个等级升到哪个类别哪个等级、按哪种口径判定，以及判定时读到的累计充值、累计积分、累计消费等数值。它是只读的回查报表，等级规则本身不在这里配。
功能路径：系统菜单 → 会员管理 → 会员编码 → 会员卡自动升级查询
一、功能概述
1. 功能简介
用于查询会员等级自动升级记录。会员等级按累计充值、累计积分、累计购物额等口径设置好区间后，会员达标即由系统自动升等，每升一次就在本表落一条记录；只有卡的级别或类别确实发生了变化才记录，达标但等级未变的会员不会产生记录。
2. 核心用途
- 向顾客解释等级来源：顾客质疑"我没要求升级"时，调出升级时间与判定依据当面说明；
- 验证等级规则是否生效：新配好区间后，用本表确认达标会员确实被升上来了，还是规则没跑；
- 排查"该升没升"：某位会员达到条件却没升级，先查本表有没有他的记录，再回规则侧核对；
- 升级礼包对账：升级会触发等级礼包赠送，本表的升级记录与会员礼包赠送查询逐条对应；
- 分层结构统计：按期间统计各等级的升量，评估会员分层调整的实际效果。
3. 与相邻功能的分工
| 功能 | 定位 | 查什么 / 做什么 |
|---|---|---|
| 会员等级 | 配规则 | 设置各等级的升级口径、区间、礼包与有效天数 |
| 会员降级规则 | 配规则 | 设置到期后不降级、到期重算还是指定降级 |
| 会员卡自动升级查询（本文） | 回查 | 查系统自动判定并生效的等级变更留痕 |
| 卡类别修改查询 | 回查 | 查人工开单改卡类别的记录，与自动升级分列两张表 |
| 会员卡查询 | 查现状 | 看某张卡此刻的等级与余额，不列变更过程 |
| 会员礼包赠送查询 | 回查 | 查升级赠送出去的礼包实际到账明细 |
一句话：规则在会员等级配，自动升了哪些卡用本页查，人工改的卡在卡类别修改查询。
二、界面布局说明
上部：查询条件区
| 条件 | 说明 |
|---|---|
| 业务日期 | 按升级记录的业务日期过滤，为必填条件，默认取最近 30 天 |
| 会员卡编号 | 只查某一张卡的升级历史 |
| 持卡人姓名 | 按姓名过滤 |
| 联系电话 | 按会员预留电话过滤 |
| 会员卡类别 | 按卡类别圈定范围 |
| 会员卡系列 | 按卡系列圈定范围（等级规则挂在卡系列上） |
| 物理卡号 | 按实体卡面印的卡号过滤 |
| 卡状态 | 多选，正常、停用、挂失、作废、退卡，默认只勾「正常」 |
条件区按查询方案勾选，勾哪几项就按哪几项过滤；业务日期不能留空。
左侧：查询方案分组
默认方案与自定义方案两类口径，常用条件组合可保存到自定义方案，下次勾选直接调用。
右侧：查询结果区
逐行列出等级自动变更记录，表上方红色横幅会回显当前生效的日期范围，表下方显示条数与页数，结果可导出表格留档。结果列由查询策略决定，列名与列序以实际界面为准；看不到某些列时先核对策略版本。
顶部工具栏
- 退出：关闭当前查询窗口；
- 操作：执行查询等动作；
- 报表：输出与打印查询结果；
- 条件：设置查询条件；
- 帮助：打开功能说明文档。
三、业务操作步骤
步骤 1：打开功能入口
系统菜单 → 会员管理 → 会员编码 → 会员卡自动升级查询。
步骤 2：按期间查全部升级记录
保留默认的业务日期区间（最近 30 天）执行查询，结果列出该期间内所有被自动改写过等级的会员卡，可按会员编号列排序浏览。
步骤 3：定位单张卡的升级轨迹
录入会员卡编号（或持卡人姓名、联系电话）配合日期区间查询，结果只留这张卡的变更行，逐条核对「会员旧类别名称 → 会员新类别名称」「会员旧等级 → 会员新等级」的走向。
步骤 4：核对判定依据
看该行的升级方式列确认按哪个口径判定，再对照同行的累计充值金额、累计积分、累计消费金额、可用充值金额等数值列，判断当时的数值是否确实落进了新等级设定的区间。
步骤 5：导出留底
需要交运营或留存证据时，用【报表】导出表格，把业务日期、前后等级与升级方式列一并带出。
四、字段详细说明
1）结果列
| 字段名 | 含义 |
|---|---|
| 会员卡系列编号 / 会员卡系列名称 | 该卡所属的卡系列，等级规则挂在卡系列上 |
| 会员编号 | 发生等级变更的会员卡号 |
| 会员名称 | 该卡持卡人 |
| 会员卡当前等级 | 查询时点该卡的等级 |
| 会员卡状态 | 该卡当前卡状态（正常、停用、挂失、作废、退卡） |
| 业务日期 | 系统判定并改写等级的日期 |
| 会员旧类别名称 | 升级前的会员卡类别 |
| 会员旧等级 | 升级前的等级 |
| 会员新类别名称 | 升级后的会员卡类别 |
| 会员新等级 | 升级后的等级 |
| 升级方式 | 本次判定所依据的规则口径 |
| 累计消费金额 / 累计消费次数 / 支付次数 | 判定时读到的该卡累计消费数据 |
| 累计充值金额 / 累计积分 | 判定时读到的该卡累计充值与累计积分 |
| 可用充值金额 / 可用积分 | 判定时读到的该卡当前可用余额与可用积分 |
2）升级方式取值
升级方式显示的是卡系列上设定的自动升级规则口径，与会员等级规则窗口一一对应：
| 取值 | 判定所读的数值 |
|---|---|
| 不使用 | 不参与自动升级，不会产生记录 |
| 按累计充值 | 该卡历史累计充值金额 |
| 按累计积分 | 该卡历史累计积分 |
| 按累计购物额 | 该卡历史累计购物金额 |
| 按可用充值 | 该卡当前可用充值余额 |
| 按可用积分 | 该卡当前可用积分 |
| 按最近消费额 | 最近若干天内的消费额，天数在等级规则里设置且必须大于 0 |
达标区间的判定口径为「开始值 ≤ 数值 < 结束值」，数值落进哪一档就升到哪一档。
五、典型使用场景
场景 1：顾客质疑等级被改动
背景：顾客发现小程序里的会员等级变了，主张自己没操作过。 操作：按会员卡编号查询本表，读出业务日期、会员旧类别名称→会员新类别名称与升级方式，再对照该行的累计充值金额说明达标依据；确属规则设定不合预期的，回会员等级调整区间。
场景 2：新规则上线后验证是否跑通
背景：总部把某卡系列的口径从按累计充值改成按可用充值，当晚要确认生效。 操作：按该卡系列加日期区间查询，抽查若干已知达标会员是否出现新记录，核对升级方式列是否已变为新口径。
场景 3：升级礼包未到账排查
背景：运营反馈部分升级会员没收到等级礼包。 操作：先在本表确认这些会员确有升级记录，再到会员礼包赠送查询按同期查赠送明细；有升级记录而无赠送记录的，回等级规则核对是否给该等级关联了礼包。
六、权限控制与前置条件
- 本窗口只读，配等级规则请到会员等级；
- 系统特点【是否启用会员等级自动升级功能】须先开通，未开通时相关功能会提示该特点未开启；
- 只有卡类别被勾选参与自动升级的会员卡才纳入判定，未勾选的级别卡等级保持不变，本表也不会有它的记录；
- 卡系列未设置自动升级规则（口径为「不使用」）时不产生任何记录；
- 同一张卡在同一业务日期只保留一条记录，当天多次达标的以当天首次生效的那条为准；
- 卡状态默认只勾「正常」，停用、挂失、作废、退卡的卡需要手工把状态勾上才查得到；
- 结果列与取数口径由查询策略决定，见切换查询策略版本。
七、常见问题
1. 会员明明达标了，本表查不到记录
- 原因：该卡所属级别未勾选参与自动升级；卡系列未设置升级规则或口径与会员实际达标的数值不匹配（如按可用充值判定，而会员只累计了消费额）；数值恰好等于区间结束值（判定为小于结束值）；业务日期区间没覆盖到；卡状态不是「正常」被默认条件排除；
- 处理：回会员等级核对口径、区间与参与级别，再放宽日期区间、把卡状态一并勾上重查。
2. 一天里升了两级，为什么只有一条记录
- 原因：本表按卡按业务日期留痕，同一张卡同一天只记一条；
- 处理：需要看逐日走向时按更长的日期区间查询，或到会员卡查询核对当前等级。
3. 表里有记录，但卡的等级和记录不一致
- 原因：自动升级之后又有人工开单改过卡类别，人工改写的记录不在本表；
- 处理：到卡类别修改查询按同一卡号核对人工变更行，两张表合起来才是这张卡的完整等级轨迹。
4. 结果里没有累计消费次数、可用积分等列
- 原因：结果列由查询策略决定，默认方案未必全部开放；
- 处理：核对策略版本后按需调整，见切换查询策略版本。
与其他功能的关系
| 环节 | 对应功能 |
|---|---|
| 升级规则与礼包配置 | 会员等级 |
| 到期降级配置 | 会员降级规则、会员卡系列 |
| 升级赠送礼包的到账明细 | 会员礼包赠送查询 |
| 人工改卡类别的留痕 | 卡类别修改查询 |
| 卡当前的等级与资金 | 会员卡查询 |
| 参与自动升级的开关 | 会员卡设置用户特点 |
附：本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-10 | 初稿 |