礼券明细状态查询
礼券明细状态查询是一张券现在归谁、还能不能用的总账：按券号或类别把每一张礼券的状态、生成日期、失效日期、面值、积分一次列全。客人拿着券来核销、客服接到投诉、门店说券卖不出去，第一站都是这里。
一、功能概述
菜单位置：卡券 → 礼券管理 → 礼券明细状态查询（页面地址 /admin/TokenSvr/tokenstatereport/）
| 用途 | 说明 |
|---|---|
| 查单张券 | 用券号（可只输片段）定位一张券，看它是什么状态、哪天生成、哪天过期 |
| 查一批券 | 用类型编号 + 生成日期区间，看某个类别某批券的分布 |
| 看有效期 | 用高级筛选的失效日期区间，把即将到期或已过期的一批券挑出来 |
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 查询条 | 类型编号（文本 + 运算符）、券号（文本 + 运算符）、生成日期 页签（今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 自定义）、⚙ 高级筛选、查询、重置、导出、★ 方案 |
| 运算符 | 包含 / 等于 / 开头为 / 结尾为 / 不等于 / 不包含 / 介于 |
| 高级筛选 | 抽屉里「其他条件」只有一项：失效日期（区间，可留空），底部是 重置 和 确认筛选 |
| 已选条件 | 页面上方会出现「生成日期 等于 本月 ×」这样的条件条，点 × 可去掉 |
| 列表 | 券号 / 类型编号 / 类型名称 / 生成日期 / 状态 / 失效日期 / 面值 / 积分 |
默认只查本月生成的券，这是本页最容易踩的坑：早几个月入库的券一打开是「暂无数据」，不是没发过券，是日期口径太窄。想看历史，把生成日期改成「自定义」并拉大区间，或直接点「上月」。
两个日期不是一回事
生成日期在查询条上，是主条件；失效日期藏在 ⚙ 高级筛选 抽屉里，只有展开并点 确认筛选 才生效，直接点页面空白处会丢掉。填完后条件会出现在「已选条件」条里，点 × 可以单独去掉。
三、状态怎么读
| 状态 | 含义 | 下一步 |
|---|---|---|
| 未使用 | 券已生成，还躺在总部库里，没领出也没卖 | 走 礼券领出 或 礼券销售 |
| 已发放 | 已经被领到部门/客户或卖出，还没被消费 | 归属看 礼券管理 和单据 |
| 已消费 | 顾客到店核销掉了 | 核销记录在收银流水里 |
| 作废 | 券被作废，不能再用 | 终态，不可恢复 |
状态只能看不能筛：本页没有状态条件。要挑出某一种状态的券，先把类型和日期范围缩小，用 导出 拿到 Excel 里筛。
四、怎么用
- 打开页面，先把 生成日期 设成能覆盖这批券入库时间的区间（不确定就选「自定义」，从建账那年拉到现在）。
- 在 券号 里输入客人手里的券号，运算符选 等于，点 查询。只记得片段时用 包含 或 开头为。
- 看 状态：未使用说明还没卖出；已消费说明已经核销过，重复来用就是纠纷；作废说明这张票无效。
- 看 失效日期：早于今天，即使状态还是已发放，前台也核销不了。
- 需要盘点某个类别还有多少张没过期的活券，用 类型编号 + 高级筛选的 失效日期（从今天起往后），再导出统计。
五、常见问题
问：明明销售过这张券，为什么状态还是未使用？ 答：先确认查询日期把这张券的生成日期圈进来了；圈进来还不对，说明销售单没审核。单据是草稿状态时不会改券状态，去 礼券销售 看这张单的「单据状态」。
问：这里的券号和 礼券管理 里的券号是同一套吗？ 答：是同一套。本页从券主档取数，偏「档案视角」（生成日期、失效日期、面值、积分）；礼券管理 偏「持有视角」，能看到客户、销售人、销售日期、领用单号，并且是唯一能做作废的入口。
问：为什么按类型编号查不到？ 答：类型编号是 礼券类别 里的编号，不是名称。名称请填在列表筛完之后再核对，或者直接用券号片段查。
问：能不能只查还没卖出去的券？ 答：组合条件做不到，因为状态不能筛。可行做法：用类型 + 生成日期区间把这批券全查出来导出，再在表里去掉已消费和作废。