礼券管理
礼券管理是逐张券看归属的地方：一张券现在在库、已发放、已消费还是退货，谁买的、谁卖的、多少钱卖的、被哪张领用单领走的，都在这里。它也是整个栏目里唯一挂着「作废」这个动作的页面——只是网页端这一版还没有做执行入口，作废仍要在客户端完成。
一、功能概述
菜单位置：卡券 → 礼券管理 → 礼券管理（页面地址 /admin/TokenSvr/postokendetail/）
| 用途 | 说明 |
|---|---|
| 定位单张券 | 按券号查这张券的归属和价格，处理客诉、丢券、重复使用纠纷 |
| 看作废口径 | 哪些状态能作废、作废会动哪三处数据，先在这里弄明白；执行目前要到客户端 |
| 看领用痕迹 | 领用日期与领用单号直接显示，能追到 礼券领出 的单据 |
这一页是只读的：没有新增、没有编辑、没有删除
行号也不可点开。券的客户、价格、状态都由单据审核写入；要改，只能做反向单据（礼券销售退回 / 礼券领出退回）再重做。作废本身是终态操作，不能撤销，而且网页端这一版还没有作废入口，见第四节。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 导出、打印、▾（点开是「打印模板管理」）、刷新、全屏 |
| 筛选下拉 | 券状态: 全部、类型ID: 全部 |
| 列表 | 券号 / 券类型 / 状态 / 客户ID / 销售人 / 销售日期 / 销售价格 / 领用日期字符串 / 领用单号 |
| 勾选列 | 每行左侧有勾选框，勾上后左下角显示「已选 N 条」；但这一版没有动作下拉，勾选之后没有可执行的动作 |
取数方式：目前请用搜索框直接输券号（支持片段）后回车查询；两个下拉只提供「全部」，选不出具体状态或类别。要按类别或状态盘点，请用 礼券明细状态查询 按类型 + 日期取数后导出。
这一页读的是另一张表，演示账套里查不出行
本页取的是代金券明细表（逐张券的归属、价格、领用单号），而 礼券明细状态查询 取的是礼券主表。两张表在有些账套里并不同步：明细表没有数据时，本页打开是一片空白，即使输入主表里确实存在的券号也查不到行。这不是搜索写错了，也不是页面坏了。先按下面的顺序判断：
- 到 礼券明细状态查询 用同样的券号查，能查到说明主表有券、明细表缺行；
- 券号是入库时按编号规则生成的，早期在客户端建的券可能只写了主表；
- 需要逐张归属和作废时，暂时在客户端的代金券明细窗口做，网页端这一页先用来确认「明细表是否已经补齐」。
颜色：状态「在库」显示绿色，「作废」显示红色，其余黑色。「已消费」和「退货」表示这张券已经走完或退回来了。
三、状态含义
| 状态 | 含义 | 能作废吗 |
|---|---|---|
| 在库 | 券已生成，还在总部库 | 能 |
| 已发放 | 已随领出/销售单离库，在部门、代理商或客户手上 | 能 |
| 已消费 | 已在收银台核销 | 不能 |
| 退货 | 退回单据写入的中间痕迹；退回完成后券会回到在库 | 按在库处理 |
| 作废 | 终态，无效券 | 已是作废 |
四、作废：口径与现状
网页端还没有作废入口
这一页在系统里配了 「作废选中代金券」 批量动作，但网页端的资料页不渲染动作下拉：勾选行后左下角只会显示「已选 N 条」，找不到执行按钮。所以现阶段作废在客户端做，网页端这一页只用来确认券的归属和状态。下面的提示语和落库口径照旧要懂，因为客户端作废后回来看的就是这些数字。
- 用搜索框输入券号（一段一张或一批都行，先把要作废的券查出来）。
- 勾选要作废的行，执行 作废选中代金券（客户端）。
- 界面按结果给三档提示：
- 全部成功：「已成功作废N张代金券。」
- 部分跳过：「N张代金券状态不是[在库/已发放]，无法作废，已跳过。」——被跳过的就是已消费、退货、作废的券；
- 一张都不能作废：「没有可作废的代金券。」
- 作废一次写三处：明细表里这张券的状态置作废、主表里同号券的状态一起置作废、再逐张留一条「后台作废」的操作记录。注意它不进 查询礼券操作日志——那张表记的是号段出入库流水，作废是单张动作，两边对不上是正常的。
作废前确认三件事
一、这张券确实没有对应未退的收款（作废不产生退款）；二、不是整批误操作，动作是批量执行的；三、作废不可逆，网页端没有恢复入口，只能重新入库一批新券。
五、常见问题
问：客户ID、销售人为什么是一串数字？ 答：这一列直接取内部 ID，不是名称。表头里那个「领用日期字符串」也是同一回事——它是字段原名露了出来，内容就是正常的 YYYY-MM-DD 日期，不是坏数据。要人名和客户名，用领用单号回 礼券领出、用销售信息回 礼券销售查询 对照。
问：作废了一张已经卖出去的券，客户的钱怎么处理？ 答：作废不产生任何退款动作，销售单和收款还在。正确顺序是先做 礼券销售退回 把券退回在库，再作废；直接作废只会让账面和实物对不上。
问：这张表和 礼券明细状态查询 用哪个？ 答：查状态、有效期、按类别盘点用 礼券明细状态查询（条件更全）；要看这张券卖给谁、由哪个销售人卖的、被哪张领用单领走的，用本页。真要作废仍然得到客户端，见第四节。
问：能不能批量作废某个类别的券？ 答：网页端连单张都还没有作废入口，批量作废更要在客户端按号段做。网页端这一页的搜索框只支持按券号片段查，类型ID 下拉只有「全部」，选不出具体类别，所以做不到「筛出一个类别再整批处理」。