券明细管理
券明细管理是逐张券的台账：一行一张券，显示它现在什么状态、在哪个部门或客户名下、被谁领的、卖给谁了。领出、销售、退回、核销这些动作都会把券状态往前推一步，这里看到的就是当前状态；想看它一路是怎么走过来的，去 券进出日志。
这个页面还承担两个后台动作：作废废券、解锁冻结券。
一、功能概述
菜单位置：连锁管理 → 饼券管理 → 券明细管理（页面地址 /admin/MoonCake/ticketdetailpage/）
| 用途 | 说明 |
|---|---|
| 定位单张券 | 按类型 + 券号/流水号范围查，支持导出 |
| 看流转痕迹 | 领取部门/领取人/销售人/退回人/单据号一屏可见 |
| 作废 | 把误发、过期、损坏的券置为终态 |
| 解锁 | 恢复被冻结的券（状态是负数的那种） |
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 作废（红色）、解锁（蓝色），都要先勾选行 |
| 查询条 | 券类型（必选）、流水号范围（介于 最小值~最大值）、券号（包含） |
| 列表 | 券类型 / 券号 / 流水号 / 券状态 / 客户 / 领取部门 / 领取人 / 领取日期 / 销售人 / 销售日期 / 销售单号 / 销售价格 / 领用日期 / 领用单号 / 退回人 / 退回日期 / 有效日期 |
| 分页 | 默认 50 条/页，按流水号升序（同批入库的券挨在一起） |
必须先选券类型才查得到数据——券是按类型分表存的，不选类型系统不知道去哪张表找。选完类型后可以只按流水号范围或券号过滤。
「密码」列存在但默认隐藏，日常对账用不上。
三、券状态对照
| 状态 | 含义 | 下一步会变成 |
|---|---|---|
| 空库 | 已入库，还在总部库里 | 领出 → 领取 / 代理商领取；作废 → 作废 |
| 领取 | 门店已领，还没卖 | 销售 → 销售出；退回 → 空库；作废 → 作废 |
| 销售出 | 已卖给顾客，等核销 | 核销 → 已使用；退回 → 销售退回 |
| 销售退回 | 顾客退回来了 | 再次销售 → 销售出；作废 → 作废 |
| 已使用 | 已核销，业务终态 | 仍可作废，其他业务不再受理 |
| 代理商领取 | 在代理商手上 | 代理商销售登记；退回 → 空库 |
| 消费退回 | 核销后发生的退回 | 按门店实际处理结果回到可售或作废 |
| 赠送 | 作为赠品发出 | 核销后 → 已使用 |
| 作废 | 终态，永久失效 | 没有反悔入口 |
负数状态是冻结标记：券被冻结时状态存成负数，列表里显示为 [冻结]，用「解锁」恢复。
四、作废与解锁
作废
- 先选券类型并查出券；
- 勾选要作废的券（可多选）；
- 点 作废，确认框原文：「确认作废所选券？月饼券一旦作废将不能再使用！」；
- 确认后提示「已作废 N 张」。
只有四种状态可以作废：空库、领取、销售退回、已使用。 已销售出去（销售出）或在代理商手上的券不能直接作废，要先做退回。执行完毕后系统还会附带提示：
| 附带提示 | 含义 |
|---|---|
| 空库 N 张已计入类型作废数量 | 空库券作废会累加到类型的「作废数量」，结存随之减少 |
| N 张已是作废状态 | 重复勾选了已作废的券，跳过 |
| N 张状态不允许作废（仅空库/领取/销售退回/已使用可作废） | 勾到了不能作废的状态 |
| 请选择要作废的券明细 | 没勾行就点了作废 |
| 该类型的券明细分表不存在，无法作废! | 类型缺少券号分表，需要先在旧客户端建一次该类型 |
解锁
- 勾选状态为
[冻结]的券； - 点 解锁，确认框原文：「是否确认对所选券进行解锁操作？」；
- 提示「已解锁 N 张」，恢复成冻结前的状态。
解锁只对负数（冻结）生效，勾了正常券会提示「N 张非冻结状态已跳过」，不会报错。谁冻结的券就得谁来解——冻结通常发生在收银端异常或风控拦截，先问清原因再解锁。
五、常见问题
问：为什么我选的券类型，明细一条都没有？ 答：这个类型还没入库，或者入库时分的券号在别的分表里。先去 券列表管理 确认这个类型有没有入库记录。
问：客户列为什么大部分是空的？ 答：「客户」只对代理商相关业务有值（代理商领出、代理商销售）。门店业务记的是「领取部门」，两者不同时为值。
问：作废之后还能恢复吗？ 答：不能。作废是终态，只能重新入库新券。所以作废前一定确认券号区间没选错。
问：这里改状态吗？ 答：不能直接改。状态只能通过领出、销售、退回这些单据流转，或者走 电子券状态修改（仅电子券）。饼券没有「状态修改」入口。
问：券找不到了，但流水号记得？ 答：用「流水号范围」查，最小值=最大值=那个流水号就行。券号不确定时不要用券号条件，那个是模糊包含匹配，容易漏。