礼券销售
礼券销售是把券卖给客户的那张单：客户付钱买券，券从「在库」变成「已发放」，同时把客户、销售员、成交价格写进券的档案。这张单是后面三张报表的数据源头——礼券销售查询 看卖了多少钱，礼券对账 看门店上交的券对不对得上，礼券类别 的销售数量也随之增加。
一、功能概述
菜单位置：卡券 → 礼券管理 → 礼券销售（页面地址 /admin/TokenSvr/posprovidetokenbillheadsale/）
| 用途 | 说明 |
|---|---|
| 卖券收款 | 按客户开单，明细按券类型 + 券号段销售 |
| 记业绩 | 单据带销售员，销售数量和金额可按人统计 |
| 定归属 | 审核后券上写死客户、销售员、销售价格，客诉时能追到人 |
网页端目前只能查，不能开单
实测：本页的 + 新增 会打开一个新页签，内容是「500 - 服务器内部错误」；点列表里的单据号也没有反应，改单页打不开。所以开单、改单、审核、反审核目前都在客户端做，网页端用来查询、筛选、导出和核对。客户端的同类窗口见 礼券管理。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | + 新增、导出、刷新 |
| 日期页签 | 今天 / 昨天 / 本周 / 上周 / 本月 / 上月 / 自定义（默认落在本月，历史单要点「自定义」把区间拉开） |
| 筛选 | 客户、销售员、高级筛选、查询、重置、导出、★ 方案 |
| 搜索框 | 可按单据号、手写单号、单据摘要的关键字直接搜 |
| 列表 | 单据号 / 单据日期 / 客户 / 销售员 / 发放类型 / 单据金额 / 单据状态 / 审核日期 / 单据摘要 |
| 单据号格式 | 列表里同时存在两种前缀：Tpb260821000001（Tpb + 年月日 + 序号）和 No250723000002（No + 年月日 + 序号）。前缀由开单端的编号规则决定，网页端只读不改，两种都是有效单据号 |
单据状态只有两种：空（草稿）和已生效。列表里看到的是状态名，判定口径以「审核日期」是否有值为准。
三、这张单长什么样
下面两组字段是开单页的口径。网页端这一版还打不开开单页（见第一节的实测），所以它是给你看懂单据、准备资料、事后核对用的；真正填单在客户端。
表头字段
| 分组 | 字段 | 要求 | 说明 |
|---|---|---|---|
| 基本信息 | 单据号 | 只读 | 保存时按编号规则生成 |
| 基本信息 | 单据日期 | 必填 | 默认今天，决定报表归属期 |
| 基本信息 | 手写单号 | 选填 | 纸质单据号，便于对照 |
| 业务信息 | 发放类型 | 必填 | 有偿 / 无偿，销售一般是「有偿」 |
| 业务信息 | 客户 | 必填 | 弹窗「选择客户」单选，券卖给谁 |
| 业务信息 | 销售员 | 必填 | 弹窗「选择销售员」单选，业绩归属人 |
| 业务信息 | 付款方式 | 选填 | 取自财务科目的现金/银行类项目 |
| 业务信息 | 收款金额 | 选填 | 实际收到的钱，与单据金额可以不等（挂账、优惠） |
| 汇总信息 | 单据金额 | 只读 | 所有明细行金额合计 |
| 备注 | 单据摘要 | 选填 | 长文本，列表最后一列就是它 |
明细字段
| 列 | 要求 | 说明 |
|---|---|---|
| 类型编号 | 必填 | 手工填或搜索，必须是 礼券类别 里已建、且已生成过券号的类型 |
| 开始券号 | 必填 | 填券号里的流水码段（默认 6 位），不是整串券号 |
| 结束券号 | 自动 | 按开始券号 + 数量推出，本列只读 |
| 数量 | 必填 | 本行卖多少张 |
| 标准价格 | 选填 | 券的面值参考 |
| 销售价格 | 选填 | 这张券卖多少钱 |
| 折扣(%) | 选填 | 填 85 就是八五折 |
| 金额 | 自动 | 数量 × 销售价格 × 折扣 ÷ 100；折扣没填或填 0 时按 数量 × 销售价格 |
| 行备注 | 选填 | 打印在明细行上 |
四、审核会做什么
审核成功后（提示「审核成功」），系统在同一件事里做完四步：
| 动作 | 结果 |
|---|---|
| 单据 | 状态置为已生效，写审核人和审核日期 |
| 券 | 这一段券号的状态从在库改成已发放，并把客户、销售员、销售价格、销售日期写到每张券上 |
| 类别数量 | 礼券类别 的销售数量加上本单张数 |
| 流水 | 在 查询礼券操作日志 记一笔出库，备注「销售出库」；券的操作记录同样标「销售出库」 |
五、会被什么拦住
审核前的校验是逐条给的，提示原文如下：
| 校验 | 提示原文 |
|---|---|
| 没选客户 | 请选择客户后再审核数据! |
| 没选销售员 | 请选择销售员后再审核数据! |
| 没选发放类型 | 请选择发放类型后再审核数据! |
| 某行没填数量 | 第N行: 保存之前必须输入代金券数量，或者按ESC取消! |
| 某行没填券号 | 第N行: 请输入起始券号和结束券号! |
| 号段里没有券或类型已过期 | 第N行: 未找到对应流水号在[开始券号-结束券号]内的代金券，或者已过期的代金券 |
| 号段根本没生成过券 | 第N行: 系统中不存在该流水号的代金券! |
| 号段里有非在库的券 | 第N行: 该流水号范围内的代金券中存在不[在库]状态，无法使用! |
| 张数比号段里可用的多 | 第N行: 该流水号超出范围，只能使用[N]张! |
销售只允许操作「在库」的券。如果号段里有一张已经发放、已经消费或已作废，整行都会被拦下——先确认号段没被别的单据用过，可在 礼券明细状态查询 按类型 + 券号查现状。
六、反审核：目前不支持
网页端和客户端对这张单都没有反审核，执行时直接返回原文提示：
代金券发放/销售单暂不支持反审核操作
也就是说审核错了不能退回草稿重做，正确做法是另开一张 礼券销售退回，把卖错的号段退回到在库，再重新开正确的销售单。退回单的销售数量以负数进入 礼券销售查询。
七、常见问题
问：单据金额和收款金额不一样，以哪个为准？ 答：单据金额是明细合计（应卖多少），收款金额是实收。报表统计走单据金额，对账和现金管理看收款金额，两者不等说明有挂账或折让，需要复核。
问：为什么列表一条都没有？ 答：默认落在「本月」，而礼券单据往往是历史月份开的。点 自定义 把起止日期拉开，或直接用搜索框输入单据号 Tpb 开头的关键字。
问：一张单能卖两个客户的券吗？ 答：不能，表头只有一个客户。分客户就开多张单，别在明细里想办法。
问：无号券能在这张单上卖吗？ 答：不能。销售单审核时要按号段去券表里找券，无号券不生成券号，找不到就报「未找到对应流水号在[…]内的代金券，或者已过期的代金券」。无号券的发放走 礼券发放，那张单不填券号。