会员充值查询
会员储值有三个进钱口：门店前台 POS 充值、后台在本窗口办的充值、顾客自己在小程序上充的充值。账对不上时最需要知道的是"这笔充值是从哪个渠道进来的、谁操作的、用什么收款方式收的"。会员充值查询把三条途径的充值记录汇到一张表里按条件查，并提供只看前台 POS 的收款口径——按收银员拆、按收款方式汇总、按门店与日期交叉，用于日结与收银员对账。
功能路径：系统菜单 → 会员管理 → 会员分析 → 会员充值查询
一、功能概述
1. 功能简介
汇总前台 POS、后台、小程序三条途径产生的会员充值记录，结果列出充值时间、充值金额、赠送金额、卡余额等信息，可按日期、分店、会员卡系列/类别、卡号等条件过滤。窗口内另设面向前台 POS 的收款查询口径，分别按收银员、按收款方式、按门店与日期交叉汇总，用于把充值业务收到的钱和收银员的缴款对上。
本窗口只做查询与导出，不改动会员卡的余额与充值记录；要给单张卡办理充值，用的是会员卡充值。
2. 核心用途
- 渠道核对：分清一笔充值是前台办、后台办还是小程序自助充的，避免三条线混在一起对不平；
- 收银员对账：看某个收银员当天经手的充值收款由哪些收款方式构成、各收了多少；
- 收款方式核数：按现金、信用卡等收款方式汇总前台充值收款总额，与收银缴款表相互印证；
- 门店日对账：按门店与日期交叉查看各分店每天的充值金额，定位异常波动的那家那天；
- 赠送落地检查：用充值金额与赠送金额两列核对赠送规则是否按预期送出。
3. 整体结构
窗口是一个查询结果区加上多个查询口径，各口径的取数范围不同：
| 查询口径 | 查什么 |
|---|---|
| 会员充值查询 | 全渠道充值明细，汇总前台、后台、小程序的充值信息，含充值时间、充值金额、赠送金额、卡余额 |
| 会员充值查询（POS 前台） | 只看前台 POS 系统发生的充值信息 |
| 会员充值收款（收银员，POS 前台） | 前台按收银员给会员充值时的收款情况，显示各收款方式分别收了多少 |
| 会员充值收款（POS 前台） | 前台每种收款方式的汇总总额 |
| 会员充值收款（POS 前台，门店） | 按门店与日期交叉汇总，显示某分店某天的充值金额 |
口径名称与页签顺序在不同客户端版本上可能略有差异，以实际界面为准。
二、界面布局说明
上部：查询条件区
| 条件 | 说明 |
|---|---|
| 日期范围 | 充值的业务时间期间，是定位数据的主要入口 |
| 分店 / 门店 | 限定查询的门店范围，实际可选列表受操作员分店权限约束 |
| 会员卡号 | 只看某张卡的充值记录时录入卡号 |
| 会员卡系列 / 会员卡类别 | 按卡的范围过滤，用于只看某类卡的充值情况 |
| 收银员 | 收款类口径下按操作员过滤 |
| 收款方式 | 按现金、信用卡等收款渠道过滤结果 |
左侧：默认分组
以勾选方式列出本窗口的各张表：全渠道的会员充值查询，以及面向 POS 前台的充值查询与几种收款汇总口径。勾选其一后执行查询，右侧结果表按该口径刷新。分组标题与分组内的口径条目都来自查询方案配置（默认方案 / 自定义方案），不同账套显示的条目名称可能不同，勾选逻辑一致。
右侧：查询结果区
结果以列表显示，可按列标题拖拽分组、导出表格，或按报表参数调整显示列。表下方显示记录条数与页数，数据量大时分页返回。
顶部工具栏
- 退出：关闭当前查询窗口；
- 操作：执行查询等动作；
- 报表：输出与打印查询结果；
- 条件：设置查询条件；
- 帮助：打开功能说明文档。
三、业务操作步骤
步骤 1：打开功能入口
系统菜单 → 会员管理 → 会员分析 → 会员充值查询。
步骤 2：查询全渠道充值明细
在查询条件区选定日期范围与分店，点【查找】。结果表刷新，逐行列出该期间内的充值记录，每行可以看到充值时间、充值金额、赠送金额与卡余额。
步骤 3：只看前台 POS 发生的充值
切换到 POS 前台的充值查询口径，同样设定期间与门店后查询。此时结果只包含前台 POS 办理的充值，小程序自助充值与后台充值不再出现。
步骤 4：按收银员核对收款构成
切到按收银员的收款口径，选定日期与门店后查询。结果按收银员列出其经手的充值收款，并拆分到收款方式：现金收了多少、信用卡收了多少一目了然，可与收银员的缴款单逐人核对。
步骤 5：按收款方式看总额
切到收款方式汇总口径查询，结果按收款方式列出前台充值收款的汇总总额，用于与当天的现金、银行卡入账合计对平。
步骤 6：按门店与日期交叉查看
切到门店维度的收款口径查询，结果以门店为行、日期为列（或按门店与日期逐行）交叉汇总，某分店某天的充值金额直接可读，便于找出异常偏高或偏低的那一天。
四、字段详细说明
1）充值明细列
| 字段名 | 含义 |
|---|---|
| 充值时间 | 这笔充值业务发生的时间 |
| 充值金额 | 顾客实际支付的充值本金 |
| 赠送金额 | 按充值赠送规则一并送出的金额，不计入顾客实付 |
| 卡余额 | 该笔充值完成后的卡上可用余额 |
| 卡号 | 发生充值的会员卡号 |
| 会员姓名 | 持卡人姓名 |
| 分店 / 门店 | 办理这笔充值的门店 |
| 收银员 | 前台办理该笔充值的操作员 |
| 收款方式 | 顾客付款所用的渠道，如现金、信用卡 |
明细列的具体名称与列序随查询口径变化，收款类口径会突出收银员与收款方式，明细口径会突出充值时间与卡余额。
2）金额口径说明
| 取值 | 含义 |
|---|---|
| 充值金额 | 本金，进入储值账户的实收部分 |
| 赠送金额 | 让利部分，与本金共同构成卡上可消费余额 |
| 卡余额 | 本金与赠送相加后的可用总额（含历史结余） |
五、典型使用场景
场景 1：前台充值与缴款对不平
背景：某门店某天收银员缴款额与系统充值额对不上。 操作：用按收银员的收款口径查出当天各收银员经手的充值收款，按收款方式拆分现金与刷卡金额，再与缴款单逐项核对，先定位差额在哪个人、哪种收款方式上。
场景 2：怀疑小程序充值没进系统
背景：顾客反馈在小程序充过值，门店查不到。 操作：先用全渠道口径查询该卡号，确认记录里的充值来源；再切到 POS 前台口径查同一期间，若前台口径没有而全渠道口径有，说明这笔是线上充的，属正常。
场景 3：月末看各门店储值规模
背景：需要按门店比较储值业务的量。 操作：用门店与日期交叉口径查询整月，按门店汇总各天充值金额；需要连同赠送、消费、积分一并看分店水平时，转门店会员卡经营分析；需要把充值拆成本金与赠送两条线做摊销时，转会员卡充值消费情况（按月）。
六、权限控制与前置条件
- 本窗口只读，不修改充值与余额数据；录入或修正充值要走会员卡充值或会员卡充值批量导入；
- 操作员只能看到自己有权限的分店数据，跨店核对需由具备多店权限的账号查询；
- 前台 POS 口径只覆盖 POS 前台发生的充值，后台与小程序的充值需在全渠道口径查看；
- 赠送金额取决于充值赠送规则是否配置生效，未配规则时该列为空属正常，规则设置见全局充值金额分段赠送与会员卡充值赠券电子券规则；
- 结果列与取数口径由查询策略决定，字段少于预期时先升级或切换策略版本，见切换查询策略版本；跨期比较请锁定同一版本。
七、常见问题
1. 明明充过值，结果表里查不到
- 原因：当前口径只看前台 POS 充值，而那笔充值发生在小程序或后台；也可能是日期或分店条件选窄了；
- 处理：切到全渠道的会员充值查询口径，放宽日期与分店条件重新查询；确认业务发生后，再回到具体口径核对。
2. 充值金额与卡上余额对不上
- 原因：卡余额是本金、赠送与历史结余的合计，单笔充值金额只是本金；期间内若还有消费、退卡或卡状态调整，余额也会随之变化；
- 处理：看该卡的充值时间序列与卡余额列，再用会员卡查询核对累计充值金额、赠送金额与总计可用金额是否自洽。
3. 赠送金额一栏为空
- 原因：该笔充值未命中任何赠送规则，或规则未对当前门店、卡类别生效；
- 处理：核对赠送规则的适用范围与生效期间，规则本身见全局充值金额分段赠送。
4. 收款方式金额之和小于收款总额
- 原因：收款方式汇总口径按前台 POS 的收款记录取数，未走前台的线上充值不参与；
- 处理：把全渠道充值金额与前台收款合计分开比对，差额对应线上与后台途径，不要强求两边相等。
5. 只想看某天某家店的充值金额，怎么最快
- 处理：直接用门店与日期交叉的收款口径，选定期间后查询，结果按分店与日期交叉列出，无需逐条筛选明细。
与其他功能的关系
| 环节 | 对应功能 |
|---|---|
| 单张卡的充值办理 | 会员卡充值 |
| 批量充值与导入 | 会员卡充值批量导入 |
| 卡维度的累计充值与余额 | 会员卡查询 |
| 充值拆本金与赠送（按月） | 会员卡充值消费情况（按月） |
| 分店充值/赠送/消费/积分汇总 | 门店会员卡经营分析 |
| 每笔付款的承担卡与小票 | 会员卡付款明细 |
| 会员积分获取记录 | 会员积分查询 |
| 门店收银端的充值办理界面 | 会员充值（门店应用） |
门店应用一栏是收银端办理充值的操作界面，本窗口是把办完之后的记录查出来对账，两端取数范围不同，不要相互替代。
附：本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-10 | 初稿 |