查询礼券操作日志

礼券操作日志是每一笔礼券进出库的流水账：什么时候、哪个类别、哪一段券号、进还是出、数量多少、期末剩多少、是谁做的，一行一笔。它只读、不能改也不能删，是礼券账对不上时最后要看的那张表。

一、功能概述

菜单位置：卡券 → 礼券管理 → 查询礼券操作日志（页面地址 /admin/TokenSvr/postokeninoutlog/）

用途	说明
追流转	按券类型 + 券号段查每一次入库、出库、退回的动作
对库存	用「期末数量」逐行核对，看哪一笔之后数量开始对不上
查经手	「备注」里带操作人和业务原因，可追到人

这一页没有任何写入入口

没有新增、没有编辑、没有删除。日志由礼券单据审核、券入库、核销、作废这些动作自动生成。想纠正一笔错误的流水，只能去对应的单据做反向操作（退回或作废），不能直接改日志。

二、界面布局说明

区域	内容
工具栏	导出、打印、▾（打印模板管理）、搜索框 + 蓝色查询按钮、刷新、全屏
查询条	操作类型(0 = 入库,1 = 出库) 下拉、券类型ID 下拉、关键字框（提示「搜索...」）
列表	操作日期(YYYYMMDD) / 操作类型 / 券类型ID / 起始流水号 / 结束流水号 / 数量 / 期末数量 / 备注
颜色	操作类型「入库」显示绿色，「出库」显示红色

两个下拉的标题就把口径写在里面了：界面上显示的是「操作类型(0 = 入库,1 = 出库): 全部」和「券类型ID: 全部」。展开后里面只有 0 / 1 两个代码值，0 是入库、1 是出库；券类型ID 显示的是一串数字（如 2、5、7、12……），那是类别的内部 ID，不是 礼券类别 里的类型编号。按 ID 筛之前，先把 ID 对上号——列表里的券类型ID列与类别档案是同一套 ID，找一个已知类别的流水行确认即可。

三、每行记录什么

列	含义
操作日期	这笔进出发生的日期
操作类型	入库（券回到总部库）或出库（券离库）
券类型ID	属于哪个礼券类别
起始流水号 / 结束流水号	这次动的是哪一段券号
数量	本次张数
期末数量	这笔之后的库存张数
备注	业务原因和操作人，如「××销售出库」「销售退货入库」「领用出库 操作人:[××]」等

期末数量怎么算：每个券类别各算一条累计线——取该类别最后一条流水的期末数量，入库加本次数量、出库减本次数量。所以它不是实时库存，而是按流水顺序累计出来的数；只要中间有人补过流水或直接在数据库里动过券，后面所有行的期末数量都会跟着偏。

四、各种动作会留下什么日志

你做了什么	日志表现
礼券销售 审核	一条出库，备注是「××销售出库」
礼券销售退回 审核	一条入库，备注是「××销售退货入库」
礼券领出 审核	一条出库，备注「领用出库 操作人:[××]」
礼券领出退回 审核	一条入库，备注「领用退回入库 操作人:[××]」
礼券发放 审核	不留流水：发放单不选号段、不动库存，日志里查不到
礼券管理 作废	也不在这张表：作废写的是逐张的操作记录（POS 端的「查询礼券操作记录」），出入库日志不记作废

日志里没有 ≠ 没发生

作废、核销（收银台消费）这两类逐张动作不进这张表，它们记在按单张券的操作记录里。这张表只记成段号段的出入库，所以核对「某个号段一共进出过几次」用它，核对「某一张券被谁作废」要回客户端的操作记录查询。

五、常见问题

问：为什么筛选下拉里全是数字，没有中文？ 答：这一页直接取的是数据库里的代码值。操作类型 0=入库、1=出库；券类型ID 要对着 礼券类别 的类别和列表里的 ID 列互相对照，或者先用「搜索...」输入券号段定位一行，再看它的类型 ID。

问：期末数量为什么和实际库存差几张？ 答：期末数量是按流水顺序累计的，如果中途做过反审核（礼券领出支持反审核，发放/销售单不支持）或在客户端补过券，日志与累计会脱节。先跑 礼券类别 的「更新使用数量统计」重算，再对比这张表；仍然不平就是有人在客户端直接动了券。

问：能不能按日期查？ 答：这一页没有日期页签，只能按操作类型和券类型ID筛，或者用搜索框直接搜券号、备注关键字。要按时间段统计销量，用 礼券销售查询；要按门店汇总上交，用 礼券对账。

问：导出的表和界面上的列一样吗？ 答：一样，导出按当前筛选结果导全量，不只是当页。所以先筛好类别再导。