会员充值赠品查询
充值活动里送的不只是卡面上的金额，还有一批实物商品：充多少送一份吐司、送一组蛋挞。这些赠品一边让掉了毛利，一边占用门店库存，两头都要能对上。会员充值赠品查询把命中充值赠送规则后实际送出的商品逐行列出——哪张卡在哪家店、哪天充的、送了什么、送了几份、成本多少、折合售价多少、谁经手，是一张只读的回查报表。它管的是送出去的实物，不管充值本金和赠送金额进了多少钱。
一、功能概述
1. 功能简介
用于查询充值赠送的商品名称、数量、成本价和单据号、日期等信息。每行对应一笔充值业务实际送出的一个商品；赠送记录由充值业务在命中赠送规则时自动产生，本窗口只做查询与导出，不录入、不冲销。
功能路径：系统菜单 → 会员管理 → 会员业务 → 会员充值赠品查询
2. 核心用途
- 赠品成本核算：按期间汇总赠品数量 × 成本价，算出充值活动的实物让利；
- 库存账实核对：把赠品的出库数量与门店的实际出仓、领用记录交叉核对；
- 规则落地检查：确认设置了赠品的充值档位真的送出去了，还是只有金额没有商品；
- 门店活动复盘：按分店看各店送出的赠品结构，判断活动配置是否被门店执行到位。
3. 与相邻功能的分工
| 功能 | 口径 | 与本表的区别 |
|---|---|---|
| 会员充值查询 | 充进来的钱 | 查充值本金、赠送金额与 POS 收款，不列送出的实物 |
| 会员充值赠品查询（本文） | 送出去的实物 | 只列按规则赠送的商品及其实物成本与售价 |
| 全局充值金额分段赠送 | 规则 | 设定哪个充值档段送什么、送多少，本表是规则命中后的结果 |
| 会员卡充值赠券电子券规则 | 规则 | 充值送的是礼券/电子券，走券的记录口径，不在本表 |
| 会员卡充值 | 做单 | 后台给单张卡办理充值，赠送在这里被触发 |
| 会员礼包赠送查询 | 另一种送法 | 查会员礼包的发放记录，与充值档位赠送不是同一业务 |
| 微信会员充值赠送礼券与金额 | 线上口径 | 小程序充值送的礼券与金额，同样不含实物商品 |
| 会员卡充值消费情况（按月） | 摊销口径 | 把充值拆成本金与赠送做按月结转，不做实物明细 |
简单说：钱的对账去会员充值查询，实物的对账用本页，规则本身在会员编码的赠送设置里。
二、界面布局说明
上部：查询条件区
| 条件 | 说明 |
|---|---|
| 单据日期 | 按赠送发生的业务日期过滤，为必填条件 |
| 单据号 | 定位某张充值赠送单据下的全部赠品行 |
| 原始单号 | 按对应的外部单号、小票号等对照查询 |
| 会员卡编号 | 只查某一张卡收到的赠品 |
| 持卡人姓名 | 按姓名过滤 |
| 制单人 | 只看某位人员经手的充值赠送记录 |
会员卡类别在部分版本的条件里可选，实际以界面显示的条目为准。条件留空时按操作员权限允许的日期范围与分店范围取数。
左侧：查询方案分组
默认方案与自定义方案两类口径，支持用户自定义：常用条件组合可保存到自定义方案，下次勾选直接调用。
右侧：查询结果区
逐行列出赠送商品记录，表下方显示条数与页数，可按列标题拖拽分组、导出表格。双击其中一行会打开产生这条记录的单据，可直接回看当时的充值与赠送明细。结果列由查询策略决定，列名与列序以实际界面为准。
顶部工具栏
- 退出：关闭当前查询窗口；
- 操作：执行查询等动作；
- 报表：输出与打印查询结果；
- 条件：设置查询条件；
- 帮助：打开功能说明文档。
三、业务操作步骤
步骤 1：打开功能入口
系统菜单 → 会员管理 → 会员业务 → 会员充值赠品查询。
步骤 2：按期间查全部赠送
设定单据日期范围（必填），执行查询。结果列出该期间内实际送出的全部赠品行。
步骤 3：核算本期赠品成本
按期间查询后导出表格，用「成本价 × 赠品数量」汇总实物让利；要看这批赠品按标价值多少钱，改用「售价金额」列（口径为标准售价 × 数量）汇总。
步骤 4：定位单张卡或单个商品
按会员卡编号查询，结果只留这张卡收到的赠品；评估某个赠品被送出多少时按赠品名称查询并按分店汇总数量。
步骤 5：回跳原始单据
对某笔赠送有疑问时双击该行，打开对应单据核对当时的充值档位与命中规则；若显示的是充值单据而非赠送单，说明该笔赠送挂在这笔充值业务下。
四、字段详细说明
| 字段名 | 含义 |
|---|---|
| 单据日期 | 何时充值赠送 |
| 单据号 / 原始单号 | 充值赠送单据编号，可与对应充值业务对照 |
| 分店 | 在哪家分店充值赠送 |
| 会员卡编号 | 收到赠品的会员卡号 |
| 持卡人姓名 | 该卡持卡人 |
| 赠品名称 | 赠送什么商品 |
| 赠品数量 | 赠送数量 |
| 成本价 | 商品成本价，用于核算让利 |
| 标准售价 | 取物料档案里的标准售价 |
| 售价金额 | 标准售价 × 数量，用于按标价口径衡量赠送规模 |
| 制单人 | 哪位人员做的这笔充值 |
| 单位 / 物料编码 | 赠品的计量单位与物料编号，便于与库存出库口径对齐 |
金额口径说明
| 取值 | 含义 |
|---|---|
| 成本价 | 赠品进货成本，计入活动费用 |
| 标准售价 | 物料档案维护的零售标价，不随本笔业务变化 |
| 售价金额 | 标准售价 × 赠品数量；赠品按标价折算的规模 |
成本价与标准售价来自物料档案，未在物料中维护价格的赠品会显示为空，此时只能按数量统计，无法折算成本。
五、典型使用场景
场景 1：月度充值活动费用归集
背景：财务要把当月充值活动送出的实物折算成费用入账。 操作：按当月日期区间查询并导出，用赠品数量 × 成本价汇总实物成本；需要向门店说明活动力度时另按售价金额汇总。金额侧的赠送部分不在本表，用会员充值查询的赠送金额列补齐。
场景 2：赠品账实不符排查
背景：门店反馈某赠品的库存比系统应有数量少。 操作：按赠品名称加日期区间查询各店送出的数量，与门店出库、领用记录逐日比对，先定位差额发生在哪家店哪几天。
场景 3：档位规则没落地
背景：设置了高档充值送赠品，顾客却反映没收到。 操作：按该卡卡号查询本表，有记录说明已送出、问题出在门店未交付；无记录时回全局充值金额分段赠送核对该档位的门店范围与生效期间，并确认这笔充值是否满足门槛。
场景 4：按门店比较活动执行力度
背景：同一活动在各店执行差异明显。 操作：按期间查询后以分店为分组列汇总赠品数量与售价金额，找出送得最少或最多的门店再逐一核实。
六、权限控制与前置条件
- 本窗口只读，不做充值、不冲销赠送；办理充值见会员卡充值，批量充值见会员卡充值批量导入；
- 赠品必须先作为物料/商品维护好，并在赠送规则中挂到对应充值档段，规则未配置时本表没有记录属正常；
- 门店前台与小程序发生的充值赠送需正常上传同步后才会进入本表；
- 可查分店与日期范围由操作员的分店与数据权限决定；
- 结果列与取数口径由查询策略决定，字段少于预期时先核对策略版本，见切换查询策略版本。
七、常见问题
1. 充了值，本表里没有赠品
- 原因：这笔充值没命中任何带实物赠品的规则；或规则送的是礼券、电子券、赠送金额，不是商品；或门店数据尚未同步；
- 处理：先回规则页核对档位配置——券类走会员卡充值赠券电子券规则，金额类走全局充值金额分段赠送与会员充值查询的赠送金额列，实物才在本表。
2. 成本价、售价金额两列是空的
- 原因：该赠品在物料档案里没有维护成本价或标准售价；
- 处理：到物料档案补齐价格后再重查历史期间，本表按查询时的物料价格取数。
3. 同一笔充值出现多行赠品
- 原因：一个充值档段可以配多种赠品，本表按商品逐行输出；
- 处理：需要按业务笔数统计时用单据号列分组，不要直接数行数。
4. 想核对赠品是否被冒领
- 处理：按日期区间加制单人过滤当期赠送记录，与门店的充值登记逐笔比对；再双击可疑行打开原始单据确认当时的卡号与分店。
与其他功能的关系
| 环节 | 对应功能 |
|---|---|
| 充值档位送什么商品 | 全局充值金额分段赠送 |
| 充值档位送什么券 | 会员卡充值赠券电子券规则 |
| 充值本金与赠送金额的对账 | 会员充值查询 |
| 后台单张卡充值办理 | 会员卡充值 |
| 批量充值与导入 | 会员卡充值批量导入 |
| 按月拆本金与赠送做摊销 | 会员卡充值消费情况（按月） |
| 会员礼包的发放记录 | 会员礼包赠送查询 |
| 线上充值的赠送口径 | 微信会员充值赠送礼券与金额 |
| 赠品成本所在的活动复盘 | 门店会员卡经营分析 |
附：本文档变更记录
| 日期 | 变更 |
|---|---|
| 2026-11-10 | 初稿 |