会员积分查询
积分是会员最容易追问的一笔账：顾客说"我买了两单怎么只加了一单的分"，门店说"我刷过卡了"。会员积分查询把每一笔积分对应到哪张小票、哪张卡、哪个门店、本次积了多少分逐条列出，并提供按小票、按日期两种汇总口径，让积分的来路可以逐笔倒查。积分不是消费当时就一定可见——前台预订与小程序预订要等取货后才计分，这一点是绝大多数"积分没到账"争议的根源。
功能路径：系统菜单 → 会员管理 → 会员分析 → 会员积分查询
一、功能概述
1. 功能简介
查询会员卡的积分获取情况。凡是在收银系统输入条码的界面上录入会员卡号进行积分的消费，都会在本表留下记录，逐条列出小票、会员卡、本次积分与门店；另有按小票汇总与按日期汇总两种口径，用于核对单张小票的合计积分和某段期间的积分总量。
本窗口只查不改。积分被兑换或返利出去的流水，看会员积分兑奖查询与会员积分返利查询。
2. 核心用途
- 逐笔倒查：顾客质疑积分时，按小票找出对应的积分记录，确认是否漏积；
- 小票合计核对：一张小票上多个商品的积分合并成一条，与收银时口头告知的积分数一致；
- 期间积分统计：按日期汇总会员在某段期间获得的积分，作为积分发放规模的口径；
- 门店归属核对：确认积分记在哪家门店产生，用于分店间的会员运营归属；
- 兑换前体检：兑奖或返利前先看可用积分的来源是否清楚，避免把预订未取的分数当成已有积分。
3. 整体结构
窗口分组内为三张表，取数范围逐级放大：
| 查询口径 | 查什么 |
|---|---|
| 会员积分查询 | 积分获取明细，记录小票、会员卡、本次积分、门店等 |
| 会员积分汇总（小票） | 按小票汇总会员卡积分，一张小票上多个产品的积分合并成一条 |
| 会员积分汇总（日期） | 按日期汇总会员卡积分，看某天或某段期间的积分总量 |
口径条目名称来自查询方案配置，不同账套显示可能略有差异。
二、界面布局说明
上部：查询条件区
| 条件 | 说明 |
|---|---|
| 日期范围 | 按积分业务日期过滤，是汇总口径的主要维度 |
| 分店 / 门店 | 限定积分产生的门店 |
| 卡号 / 会员 | 只查某张卡或某个会员的积分记录 |
| 小票号 | 逐笔倒查时录入收银小票号 |
| 会员卡系列 / 会员卡类别 | 按卡的范围过滤积分记录 |
左侧：默认分组
以勾选方式列出明细与两种汇总口径，勾选其一后执行查询，右侧结果表按该口径刷新。分组标题与口径条目来自查询方案配置（默认方案 / 自定义方案）。
右侧：查询结果区
按所选口径逐行列出积分记录或汇总数值，表下方显示记录条数与页数，结果可导出表格。
顶部工具栏
- 退出：关闭当前查询窗口；
- 操作：执行查询等动作；
- 报表：输出与打印查询结果；
- 条件：设置查询条件；
- 帮助：打开功能说明文档。
三、业务操作步骤
步骤 1：打开功能入口
系统菜单 → 会员管理 → 会员分析 → 会员积分查询。
步骤 2：按卡号查积分明细
在查询条件区录入卡号并设定日期范围，执行查询。结果表逐行列出该卡期间的积分记录，每条对应一张小票、一个门店和一笔本次积分。
步骤 3：按小票逐笔倒查
录入小票号查询，结果只留这一张小票产生的积分；切到按小票汇总口径时，同张小票上多个产品的积分合并显示成一条合计，便于与顾客手里的收银小票直接对照。
步骤 4：按日期统计积分发放规模
切到按日期汇总口径，选定期间后查询，结果按日期列出积分总量，用于评估某段时间的积分发放规模与活动效果。
步骤 5：确认预订订单是否已取货
若顾客的订单是前台预订或小程序预订，报表在取货之前不会显示积分；需要确认交易状态时，先在收银端核对该订单是否已完成取货，再回到本表查询。
四、字段详细说明
1）积分明细列
| 字段名 | 含义 |
|---|---|
| 小票 | 产生该笔积分的收银小票号 |
| 会员卡 | 积分归属的会员卡号 |
| 本次积分 | 这一笔（这张小票）增加的积分数 |
| 门店 | 积分产生的门店 |
| 业务日期 | 积分记录所属的业务日期 |
| 会员姓名 | 持卡人姓名 |
| 累计积分 | 该卡截止查询日的历史累计积分 |
| 可用积分 | 扣减已兑换部分后仍可使用的积分 |
2）汇总口径列
| 口径 | 关键列 | 说明 |
|---|---|---|
| 按小票汇总 | 小票、本次积分合计 | 一张小票含多个产品时，各产品积分相加为一条 |
| 按日期汇总 | 日期、积分合计 | 同一期间内多张小票的积分相加 |
3）积分比例说明
| 取值 | 含义 |
|---|---|
| 比例 1 | 消费 1 元获得 1 积分 |
| 比例大于 1 | 消费 1 元获得多倍积分，多用于促销卡 |
| 比例为 0 或卡未开积分 | 该卡消费不产生积分，本表也不会出现记录 |
积分比例随会员卡级别设置，不积分商品不参与积分计算。
五、典型使用场景
场景 1：顾客说积分没到账
背景：顾客反馈某次消费后积分未增加。 操作：用小票号或卡号加日期查询明细；查不到时，先确认这单是否为预订单且尚未取货，再确认所购商品是否属于不积分商品、该卡级别是否配置了积分比例。
场景 2：门店核对当日积分发放
背景：会员日活动中门店集中处理积分，店长要确认当日发放量。 操作：用按日期汇总口径选定当天查询，得到全店当日积分合计；按门店看各分店会员运营水平时转门店会员卡经营分析。
场景 3：兑奖前核对可用积分来源
背景：会员要求用大额积分兑换奖品，操作员需确认分数来路正当。 操作：按卡号查询期间明细，逐笔确认积分由本店消费产生，再走会员积分兑奖登记，兑奖后流水可在会员积分兑奖查询复核。
六、权限控制与前置条件
- 只有配置为可积分的会员卡类别才会产生积分记录；卡的积分比例在会员卡级别中设定；
- 不积分商品清单见不积分商品，命中该清单的商品金额不参与积分；
- 前台预订、小程序预订的订单在取货之前不显示积分，取货后才计入本表；
- 操作员可见范围由分店权限决定；
- 结果列与取数口径由查询策略决定，字段少于预期时先升级或切换策略版本，见切换查询策略版本。
七、常见问题
1. 顾客确实消费了，本表没有记录
- 原因：该订单是前台预订或小程序预订且尚未取货；或该卡级别未开积分；或所购为不积分商品；
- 处理：先确认订单是否已完成取货，再核对卡级别的不积分商品设置。
2. 一张小票上分了多条积分记录
- 原因：当前使用的是明细口径，同张小票的不同产品分别成行；
- 处理：切换到按小票汇总口径查询，同票积分合并为一条合计。
3. 积分金额与顾客算的不一样
- 原因：积分按参与积分的金额计算，赠送额、不积分商品与整单优惠都会被剔除；部分门店还存在按抹零后金额计分的情况；
- 处理：用明细口径逐笔核对每张小票的计分基数与本次积分，差额定位到具体商品后，再回到卡的积分比例设置检查。
4. 查到的积分比卡上可用积分多
与其他功能的关系
| 环节 | 对应功能 |
|---|---|
| 积分比例的设定 | 会员卡级别 |
| 不参与积分的商品 | 不积分商品 |
| 积分换成返利 | 会员积分返利查询 |
| 积分换成奖品 | 会员积分兑奖 |
| 兑奖流水核对 | 会员积分兑奖查询 |
| 会员的消费明细 | 会员购物明细 |
| 卡上的可用积分余额 | 会员卡查询 |
| 门店端积分兑换界面 | 积分兑换（门店应用） |
附：本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-10 | 初稿 |