礼券管理
礼券（代金券）是按面值收钱的券：客人买一张 100 元礼券，之后到店消费时当钱花。整个栏目围绕「这张券在谁手里、是什么状态」转——先定类别，再把券发给部门、代理商或直接卖给客户，卖出去后到店核销，退回来就冲减，作废是终态。
菜单入口：卡券 → 礼券管理，共十四项功能。六个是单据（发放、销售、销售退回、领出、领出退回，加上作为档案的礼券类别），七个是查询与对账，一个是费率参数。
本目录文档
| 文档 | 内容 |
|---|---|
| 礼券类别 | 建类别：面值、积分、有效期、券号编号规则，看五类数量口径 |
| 礼券发放 | 无偿或有偿地把券批量发放出去，登记总量与金额 |
| 礼券销售 | 把券卖给客户，录券号段、售价与折扣 |
| 礼券销售退回 | 客户退券，券回到在库并冲减销售数量 |
| 礼券领出 | 把券发给领取部门/领用方，审核后券变已发放 |
| 礼券领出退回 | 领用方没发完的券退回，可反审核 |
| 礼券明细状态查询 | 逐张券查状态、生成日期、失效日期、面值、积分 |
| 礼券销售查询 | 按明细行看卖了哪些券、多少钱、单据状态 |
| 礼券发出明细 | 按客户汇总领用金额与实付金额 |
| 查询礼券操作日志 | 每笔出入库流水、期末数量、经手人与原因 |
| 礼券管理 | 逐张券看归属；作废的口径在这里，执行还在客户端 |
| 礼券对账 | 分店上交数量与销售数量对平、生效、撤销 |
| 礼券对帐汇总查询 | 按日期与分店列出上交数量台账 |
| 礼劵类别费用率设置 | 给每个礼券类别定手续费率，进门店费用 |
先建立三个认知
第一，券号是身份，状态是位置。 一张礼券的状态只有五种：在库（还在总部）、已发放（领出去了或卖出去了）、已消费（到店核销了）、退货（退回的中间痕迹，退回后按在库处理）、作废（终态）。领出和销售都会把券变成已发放，区别在于销售收客户的钱、领出走内部或代理往来。
同一个意思在两个页面上叫法不一样：礼券明细状态查询 取券主档，未发出的券显示「未使用」；礼券管理 取逐张明细，同一状态显示「在库」。看到「未使用」不要以为还没入库。
第二，网页端不改券状态，只有单据审核才改。 查询、导出、对账、费用率这些页面看到的一切，都是 礼券销售、礼券领出 等单据审核后写进去的。券状态不对，往单据上找，不要试图在明细页改。
第三，几乎所有列表默认只看本月。 五张礼券单据页和 礼券明细状态查询、礼券销售查询、礼券发出明细、礼券对账、礼券对帐汇总查询 一打开都落在「本月」，而礼券的生成日期、单据日期经常落在几个月前，于是满屏「暂无数据」——这不是没数据，把日期改成「自定义」并拉大到建账那年才是正确姿势。
一张券的完整旅程
| 阶段 | 在哪做 | 券状态变化 |
|---|---|---|
| 建类别 | 礼券类别 | 还不存在券 |
| 生成券号入库 | 礼券入库（生成券号） | 券出现，状态 在库 |
| 批量发放登记 | 礼券发放 | 不改状态，只把单据置为已生效 |
| 领到部门/领用方 | 礼券领出 | 在库 → 已发放 |
| 卖给客户 | 礼券销售 | 在库 → 已发放 |
| 顾客到店核销 | 收银前台 | 已发放 → 已消费 |
| 卖出的券退回 | 礼券销售退回 | 已发放 → 回到 在库 |
| 领出的券退回 | 礼券领出退回 | 已发放 → 回到 在库 |
| 门店交款对平 | 礼券对账（生效动作在客户端） | 不改券，只把对账记录置为已生效 |
| 作废 | 礼券管理（执行在客户端） | 终态 作废，不能再使用 |
不是每一步都留流水。发放单审核只改单据状态，既不动券也不写日志；销售、领出和两种退回这四类单据才会在 查询礼券操作日志 里留下一条号段出入库流水，备注写清原因和操作人。作废是单张动作，记在逐张操作记录里，不进这张流水表。
阅读顺序
- 第一次上手：先读 礼券类别，弄清编号规则和五个数量口径；再读本页的「一张券的完整旅程」，建立状态概念。
- 要把券卖出去：按 礼券销售 → 收银核销 → 礼券销售查询 对账的顺序走；客户退货时用 礼券销售退回。
- 要发给部门或代理商：用 礼券领出，月底用 礼券发出明细 按客户汇总结算，退回用 礼券领出退回。
- 有纠纷要查单张券：先用 礼券明细状态查询 确认这张券的状态与有效期；要看谁买的、哪张领用单领走的，用 礼券管理 按券号搜（这一页读的是逐张明细表，账套没补明细数据时查不出行，先按该页的排查顺序确认）。真要作废，网页端还没有执行入口，得到客户端做。
- 月结对账：礼券对账 在网页端用来看误差率、比差异、导出留档，刷新销售数量和生效/撤销都要在客户端做；台账留在 礼券对帐汇总查询；手续费口径看 礼劵类别费用率设置。
- 数字对不上时：按「单据 → 日志 → 类别统计」的顺序查。先看单据状态是不是还停在草稿，再看 查询礼券操作日志 有没有那笔流水，最后到客户端的 礼券类别 跑一次 更新使用数量统计 重算累计数（网页端这一版的资料页不渲染动作下拉，重算点不了）。
网页端这一版做不了的事
礼券管理刚移植到网页后台，下面几件在客户端能做的事，网页端目前点不动。这不是操作姿势的问题，知道边界可以省掉很多试错：
| 想做的事 | 网页端现状 | 怎么办 |
|---|---|---|
| 开新单 | 五张单据页的 + 新增 点开是「500 - 服务器内部错误」页 | 在客户端开单，网页端查询、导出、核对 |
| 改单 / 审核 / 反审核 | 列表里的单据号是蓝色链接，但点了不跳转，改单页打不开 | 同上，单据全流程在客户端做 |
| 进费率修改页 | 礼劵类别费用率设置 的蓝色类别编号点开是「500 - 服务器内部错误」 | 手续费率在列表行内直接改，不用进修改页 |
| 作废单张券 | 勾选行后只显示「已选 N 条」，没有动作下拉、没有执行按钮 | 到客户端的代金券明细窗口作废 |
| 重算类别累计数 | 同上，更新使用数量统计 没有执行入口 | 到客户端的 礼券类别 执行 |
| 对账生效 / 撤销 | 礼券对账 列表连勾选列都没有 | 网页端看误差率、导出；生效在客户端 |
| 查历史数据 | 单据页和报表页一打开都落在「本月」，没有「全部」页签 | 点 自定义 把区间拉到建账那年 |
仍然可以在网页端完成的是：礼券类别建档与修改、逐张券与号段的状态查询、按客户/部门/日期的销量与领用汇总、手续费率维护（行内直接改）、以及所有页面的导出。
与饼券、电子券的分工
| 礼券（代金券） | 饼券 | 电子券 | |
|---|---|---|---|
| 本质 | 当钱花的有价券，有券号 | 兑换月饼等实物的实体券 | 会员账户里的虚拟券 |
| 档案页 | 本页 礼券类别 | 券类型管理 | 电子券类型 |
| 谁拿着 | 客户、代理商、部门 | 门店、代理商、会员 | 会员 |
| 核销 | 收银前台 | 收银前台 | 线上/前台兑换 |
三套档案和数量互不相通，别在礼券单据里选饼券类别，也别指望电子券的状态修改能影响礼券。