礼券对账
礼券对账（分店交款对账）解决一件很具体的事：门店手上收上来的礼券，和系统里记的销售数量对不对得上。一行 = 一个分店一天的汇总，左边是系统算出来的销售数量，右边是门店上交的数量，中间用误差率判断能不能生效结账。
一、功能概述
菜单位置：卡券 → 礼券管理 → 礼券对账（页面地址 /admin/TokenSvr/tokenfilialegatheringreport/）
| 用途 | 说明 |
|---|---|
| 日核数 | 按分店按天看礼券上交数量与系统销售数量是否一致 |
| 看口径 | 状态 列告诉你这条对平记录进没进结算 |
| 追差异 | 误差率异常时先导出留档，再回客户端重算销售数量 |
数据从哪来
这一页读的是分店交款表，记录由门店端日常交班/日结时产生。网页端只查不改；如果某天某店压根没有行，说明那天的交款数据还没上来，先回门店端确认。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 查询条 | 操作日期 页签（今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 自定义）、分店 下拉（默认「不限」）、查询、重置、导出、★ 方案 |
| 列表 | 日期 / 分店编号 / 分店名称 / 销售数量 / 上交数量 / 误差率(%) / 状态 |
| 状态 | 未生效 / 已生效 |
| 工具栏 | 只有查询、重置、导出、方案，没有新增、没有打印、也没有动作下拉 |
网页端这一页目前只能查数，四个动作执行不了
礼券对账在系统里配了 刷新销售数量 / 生效选中记录 / 全部生效 / 撤销生效 四个动作，但报表页没有渲染行勾选列，也没有动作下拉——列表里既勾不了行，也找不到执行入口。所以现阶段这一页在网页端只用来看数、比差异、导出；真正执行对账动作请在客户端做，见 礼券对账（客户端）。 下面四个动作的含义照旧要懂，因为列表里那些数字就是被它们改出来的。
三、四个动作分别做什么（在客户端执行）
| 动作 | 效果 | 完成后提示 |
|---|---|---|
| 刷新销售数量 | 按券核销记录（已消费）重新统计各分店各券类型的销售数量并回写 | 「销售数量已刷新」 |
| 生效选中记录 | 把勾选的行中误差率绝对值小于 0.01 的置为已生效 | 「N条记录已生效」 |
| 全部生效 | 对当前查询结果里所有误差率达标且还未生效的记录批量生效 | 「N条记录已生效」 |
| 撤销生效 | 把勾选行中已生效的退回未生效 | 「N条记录已撤销生效」 |
误差率绝对值小于 0.01 才让生效，这是硬门槛。误差率偏大的行不会被生效，也不会报错——它只是被跳过，所以执行完一定要看提示里的条数对不对得上你勾选的行数；条数少了就说有一部分行还没对平。
误差率为 0 的行，目前生不了效
判定条件把「误差率 = 0」当成了空值跳过，所以完全对平的行执行 生效选中记录 或 全部生效 后，提示会是「0条记录已生效」。这不是操作错了：误差率越小越生不了效，反而是有轻微误差的行更容易生效。对平行需要按月结生效时，先和总部确认口径，别靠反复点动作来试。
四、怎么用
- 选日期（月结对账就选自定义把整月框进来）和分店，点 查询。
- 先看 误差率 列：为 0 或绝对值极小的行是对平的；状态 列告诉你这条记录进没进结算口径。
- 有差异时，先在客户端执行 刷新销售数量 让系统按核销记录重算销售数量，再回本页重查看误差率是否收敛。
- 收敛后在客户端勾选这些行执行 生效选中记录；整月都对平就直接用 全部生效。
- 生效后发现某条错了，用 撤销生效 把它退回未生效再处理。
- 需要看某店某天上交了哪些券、多少张，去 礼券对帐汇总查询。
五、常见问题
问：刷新销售数量之后，误差率还是不对？ 答：刷新销售数量只重算「销售数量」（按券的已消费记录），不动「上交数量」（门店实交）。差异出在门店那一侧，要门店补交或退交后重新生成交款记录。
问：生效后还能改吗？ 答：能，先 撤销生效 回到未生效，处理完数据再生效。已经生效的记录建议不要长期挂着差异，否则结算口径和实际收款会一直背离。
问：状态是已生效，为什么费用/利润里看不到？ 答：本表只管礼券上交对平，不直接进利润表。礼券的手续费在 礼劵类别费用率设置 里定，费用结果看 门店利润表。
问：一张券在两个店核销会怎样？ 答：核销记录按发生分店统计，刷新销售数量后各店分别承担自己的消费数量；如果上交数量算到别的店，误差率会出现一正一负，这种成对的差异基本就是核销门店录错。