券列表管理
券列表管理是饼券的入库口：选一个券类型，告诉系统从哪个流水号开始、要多少张，系统就一次性把券号生成出来，同时写一条入库流水。列表里一行 = 一次入库，记录的是券号区间，不是单张券——逐张的明细在 券明细管理。
一、功能概述
菜单位置：连锁管理 → 饼券管理 → 券列表管理（页面地址 /admin/MoonCake/ticketlistpage/）
| 用途 | 说明 |
|---|---|
| 批量入库 | 按类型生成券号，一次最多一万张 |
| 查入库批次 | 每批的开始/结束券号、张数、有效日期、谁在什么时候建的 |
| 跳到明细 | 选中批次后可看这批券的逐张明细或出入库流水 |
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 添加饼券、饼券明细、出入库明细 |
| 查询条 | 券类型（下拉，默认「不限」）、关键字（包含）＋内容框，提示「类型名称/起始券号/人员」 |
| 列表 | 券类型 / 开始券号 / 结束券号 / 张数 / 有效日期 / 定义人员 / 定义日期 / 操作（明细） |
| 分页 | 默认 50 条/页，按定义日期倒序，最新入库的在最上面 |
这个页面没有日期范围筛选，只有券类型和关键字。要找某天入的库，用关键字搜起始券号，或按定义日期在页内翻。
三、添加饼券
操作步骤
- 先在筛选区把「券类型」选成要入库的类型（必做，见下面的提示）。
- 点右上角 添加饼券，弹出入库对话框。
- 填单据日期、有效日期、开始流水号、入库张数；结束流水号会自动算。
- 点 确定，系统生成券号并写日志，提示「添加成功：开始券号 ~ 结束券号 共 N 张」。
对话框字段
| 字段 | 说明 |
|---|---|
| 单据日期 | 本次入库的业务日期 |
| 饼券类型 | 默认带出筛选区选的类型 |
| 有效日期 | 本批券的有效日期，导入后写到每张券上 |
| 开始流水号 | 本批第一张券的流水号 |
| 结束流水号 | 按「最后一个流水号 + 入库张数」自动推出，一般不用改 |
| 面值 | 本批券的面值 |
| 入库张数 | 正整数，一次上限一万张 |
会遇到的提示（原文）
| 提示 | 原因与处理 |
|---|---|
| 请先在筛选器中选择券类型 | 筛选区还是「不限」。先选类型再点添加 |
| 数量格式不正确! | 入库张数填了小数、负数或空 |
| 一次最多只能添加10000张! | 超过单次上限，拆成多批 |
| 没有大批量添加权限，一次最多只能添加10张! | 当前账号没有大批量入库权限，找管理员开权限或按 10 张一批 |
| 券类型不存在! | 类型被删或状态异常，回 券类型管理 确认 |
| 电子券不能在此添加，请使用电子券发放! | 选到的是电子券类型，电子券走 电子券发放 |
| 流水号超出系统设定的范围，每次券最多只能到 | 券号位数用完，换编号规则或扩容 |
| 该类型的券明细分表不存在（…），请先用旧系统创建该类型! | 类型没有对应的券号分表，需要先在旧客户端建一次该类型 |
入库时系统做了什么
添加成功那一刻，下面三件事同时发生，缺一不可：
- 在券的明细表里生成 N 张券，状态一律
空库； - 写一条入库记录（就是列表里的这一行）；
- 写一条 券进出日志，操作类型「入库」，备注是「操作人名 + 添加」。
所以入库不产生单据，改不了也删不了；券号发出去就已经存在，只能通过作废或退回业务把它消耗掉。
四、三个按钮怎么配合用
| 按钮 | 是否需要选中行 | 效果 |
|---|---|---|
| 添加饼券 | 不需要 | 弹出库对话框 |
| 饼券明细 | 需要，可多选 | 带上选中批次的券号区间跳 券明细管理 |
| 出入库明细 | 需要，可多选 | 带上券类型跳 券进出日志 |
多选时券号取并集：勾两批不连续的券，明细页会把两个区间都显示出来。
五、常见问题
问：券号是谁定的？ 答：按 券类型管理 里配的「编号规则」生成，默认是「类别编号 + 6 位流水码」。券号是按类型分别编的，所以查券、查明细都要先选类型。
问：入错了张数怎么办？ 答：不能改也不能删。正确做法是在 券明细管理 里把多出来的券作废（未使用的券可以作废），然后重新入库正确数量。
问：为什么添加入库后，券类型列表的「总数量」变了，但「领取数量」没变？ 答：入库只加总数量；领取数量要等 门店领出 或 代理商领出 审核后才累计。
问：能一次导入 Excel 吗？ 答：这个页面是按流水号区间连续生成的，不读 Excel。一次入库的券号必须是连续区间；要分号请分多次入库。