会员线上充值赠券查询
线上送出去的电子券不只来自充值：积分换券、在线购物满额送券、会员画像营销、开卡赠送、生日赠送、每月送券、生日管家送券都会把券写进会员账户。会员线上充值赠券查询把这些来源集中到一张表里，用赠券统计表看"哪个会员、哪张券、送了几张"，用赠券明细表看"送出去的券有没有被用掉、什么时候用的"，用于核对赠券成本、排查顾客说没收到券的投诉，以及评估各场景的核销情况。它不发放也不作废券，只做查询与导出。
功能路径：系统菜单 → 零售POS → 电子券管理，在页面底部的报表快捷入口点【会员线上充值赠券查询】
一、功能概述
1. 核心用途
- 赠券成本核对：按会员与券名统计赠送张数，乘以券面值即本期线上赠券的补贴成本；
- 投诉查证：顾客反馈"没收到券"或"券不见了"时，先确认是否真的赠到过、赠的是哪张券；
- 核销跟踪：在赠券明细表看赠送券的使用情况，判断赠券是否带动消费；
- 活动效果比对：按活动方案名称过滤，比对不同活动的赠券量与用券量；
- 导出留档：结果可导出表格，交财务做赠券费用入账与活动结算。
2. 与相邻功能的分工
| 需求 | 对应功能 |
|---|---|
| 线上各场景赠送的电子券汇总与明细 | 本功能 |
| 券模板的面值、有效期、使用规则 | 电子券类型 |
| 后台按起止券号把券写入会员账户 | 电子券发放 |
| 按会员名单批量发券 | 批量发放电子券 |
| 充值满多少送哪张券的规则设置 | 会员卡充值赠券电子券规则 |
| 微信会员充值赠送礼券与金额的参数 | 微信会员充值赠送礼券与金额 |
| 在线购物满额送券的参数 | 微信会员在线购物赠送礼券 |
| 小程序领券的投放规则 | 微信会员电子券投放规则 |
| 画像营销发出的券的赠送、兑换与占比 | 画像营销赠券分析 |
| 从建券模板到发放、核销、统计的完整链路 | 电子券标准业务流 |
后台手工发放（电子券发放、批量发放电子券）走的是发放单，本窗口统计的是线上场景自动赠送的记录，两张口径不要混着对账。
二、界面布局说明
窗口分赠券统计表与赠券明细表两张视图（以页签或独立报表形式呈现，以实际界面为准），共用同一套查询条件。
视图
| 视图 | 回答什么 | 粒度 |
|---|---|---|
| 赠券统计表 | 送了哪些会员、哪些券、各多少张 | 按会员 × 电子券券名汇总张数 |
| 赠券明细表 | 送出去的券现在什么状态、用在哪一笔 | 逐张券一行，含使用情况 |
查询条件
| 条件 | 说明 |
|---|---|
| 赠送日期 | 券赠出（写入会员账户）的日期区间 |
| 会员 | 按会员卡号、手机号或姓名定位，支持模糊查询 |
| 电子券 | 指定券模板，只看某几张券的赠送记录 |
| 赠送来源 | 按来源场景过滤，如充值赠送、在线购物赠送、积分换券、画像营销、开卡赠送、生日赠送、每月送券、生日管家送券 |
| 活动方案 | 按活动方案名称过滤，取的是方案档案里的名称 |
不同版本上条件项的名称与多少有差异，以实际界面为准。
结果表
赠券统计表按会员与券名列出赠送张数，表尾给出合计；赠券明细表逐张列出券号、券名、赠送日期、使用状态与使用信息。列组合随视图切换，以界面显示为准。
三、业务操作步骤
步骤 1：选择视图与日期区间
- 系统菜单 → 零售POS → 电子券管理，在页面底部的报表快捷入口点【会员线上充值赠券查询】；
- 切到要看的视图（赠券统计表或赠券明细表）；
- 填赠送日期区间，例如本次充值活动的起止日期。
步骤 2：按来源或活动方案过滤
- 只想看充值送的券 → 赠送来源选充值赠送；
- 想按活动结算 → 活动方案选择该方案名称，来源与方案同时限制时结果只保留同时满足的记录；
- 条件留空即查全部线上赠券记录，数据量大时先收紧日期。
步骤 3：执行查询
点【查询】，表格刷新：统计表按会员 × 券名给出张数与合计，明细表按券逐行列出状态。
步骤 4：追踪单张券的使用情况
- 在统计表定位到目标会员与券名，双击该行（或切到赠券明细表按同一会员、同一券查询）；
- 看该会员这批券里有多少已使用、多少还在账户里、多少已过期作废；
- 已使用的记录带着使用日期与单据，据此回查那笔消费。
步骤 5：导出
点【导出Excel】保存当前视图的结果。导出内容是本次查询显示的数据，改条件后要重新查询再导出。
四、字段详细说明
赠券统计表
| 字段 | 含义 |
|---|---|
| 会员卡号 | 收到券的会员编号 |
| 会员名称 | 会员姓名 |
| 手机号 | 会员注册手机号，用于联系顾客核对 |
| 电子券券名 | 赠送的券模板名称，取自电子券类型 |
| 券面值 | 该券模板的价值金额 |
| 赠送张数 | 该会员该券累计赠出的张数 |
| 赠送金额 | 赠送张数 × 券面值，即补贴口径 |
| 来源 / 活动方案 | 该笔赠送由哪个场景触发，以及对应的活动方案名称 |
赠券明细表
| 字段 | 含义 |
|---|---|
| 券号 | 单张券的编号，唯一 |
| 电子券券名 / 价值 | 券模板名称与面值 |
| 会员 | 券当前所属会员 |
| 赠送日期 | 券写入会员账户的日期 |
| 有效期至 | 该张券的截止使用日期 |
| 券状态 | 未使用、已使用、已过期、已作废等，取值以界面显示为准 |
| 使用日期 / 使用门店 | 已核销的券在什么时候、哪家门店（或线上订单）用掉 |
| 来源 / 活动方案 | 该张券的赠送场景与方案名称 |
赠送来源的取值
| 来源 | 触发场景 |
|---|---|
| 充值赠送电子券 | 会员卡充值满额按方案赠券，规则见会员卡充值赠券电子券规则 |
| 小程序在线购物送电子券 | 线上订单满额送券，见微信会员在线购物赠送礼券 |
| 小程序积分换券 | 会员用积分在小程序上兑换券 |
| 会员画像送电子券 | 画像营销圈人自动送券，效果统计见画像营销赠券分析 |
| 开卡赠送电子券 | 新会员开卡时按级别送券 |
| 生日赠送电子券 | 会员生日当月自动送券 |
| 每月赠送礼券 | 定期给会员发券 |
| 生日管家送券 | 生日管家服务触发的送券 |
| 活动方案 | 记录触发赠送的活动方案名称，用于按活动结算 |
五、典型使用场景
场景 1：充值活动结算
活动"充值满 300 送 30 元券包"结束后，按活动方案名称查询赠券统计表，得到本次活动共赠出多少张、合计多少面额，乘以券的实际核销情况（明细表里的已使用张数）算出真实补贴成本，作为与线上运营结算的依据。
场景 2：顾客说没收到券
在统计表按手机号查询该会员，看有没有对应券名的赠送记录。有记录但顾客卡包里没有，让顾客退出小程序重新登录刷新；没有记录，回到充值赠券规则确认门槛是否达到，再看赠券明细表是否有该券已过期或被作废的记录。
场景 3：赠券不核销的排查
统计表张数多、明细表里大量券状态是未使用且临近有效期至，说明券送出去没被用起来。先检查券模板的使用规则（是否限在线支付、是否设了消费满额门槛、参与分店是否漏配），见电子券类型，再决定是否补发或调整活动。
场景 4：月度赠券成本复核
每月初按上月赠送日期查询统计表，按来源分别导出，与财务的预提费用核对；来源为活动方案的部分与活动台账逐条对齐。
六、权限控制与前置条件
- 本功能只读，不修改券状态，适合开放给券务、运营与财务；
- 前置条件：赠券场景的参数已配置（充值赠券规则、在线购物送券、积分换券、画像营销、生日赠送等），未配置的场景不会产生记录；
- 券的有效期与使用规则由券模板决定，本窗口只反映结果，改规则要回到电子券类型；
- 结果含会员手机号与券号等个人信息，导出文件按隐私要求保管，不外发；
- 线上赠券记录由小程序侧写入后同步到后台，刚发生的赠送有延迟，查不到时稍后再查。
七、常见问题
1. 查询结果为空
- 原因：日期区间内没有线上赠券业务，或赠送来源、活动方案条件选得不匹配；
- 处理：放宽日期区间，把来源与方案清空重查，确认该场景是否真的配置了赠券。
2. 顾客已充值，统计表里没有赠券记录
- 原因：充值金额没达到赠券门槛，或赠券规则未生效，或小程序侧尚未同步；
- 处理：核对会员卡充值赠券电子券规则的档位与生效状态，确认该笔充值实付金额，稍后再查。
3. 统计表张数与明细表行数不一致
- 原因：两张视图的过滤条件不同步（切换视图后条件需要重填），或统计口径按会员 × 券名合并、明细按券逐张；
- 处理：用同一套条件分别查询两张视图再比对，仍不一致时按日期分段查询定位差异区间。
4. 明细表里券显示已过期，但顾客说没用到
- 原因：券的有效期按券模板的有效期至或有效天数计算，赠送当天起算后已到期；
- 处理：按券模板核对有效期口径，需要补偿时重新发放一张券，见电子券发放。
5. 想把后台手工发放的券也统计进来
本窗口只覆盖线上场景赠送的电子券。后台按号段发放、按名单批量发放分别在电子券发放与批量发放电子券的单据里查，两类记录合并统计需要分别导出后汇总。
6. 入口和「电子券转增查询」是不是同一个
不是。两者都在零售POS → 电子券管理 页面底部的报表快捷区，是相邻的两个入口：本表看线上各场景赠送给会员的电子券，电子券转增查询看券在会员之间的转赠记录。两表的张数不能直接相加对账，各自归集的业务日期以表头提示为准。找不到入口时，先确认账套是否开通电子券模块与线上会员功能。
附：本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-09 | 初稿 |
| 2026-11-09 | 「电子券转增查询」补成实链 |