券进出日志

券进出日志是只读的库存流水：每一次入库、领出、退回、销售，都在这里留一条记录，并算出该类型当时的期末数量。它不含任何编辑入口，是核对「券到底少了多少、因为哪张单」最可靠的依据。

一、功能概述

菜单位置：连锁管理 → 饼券管理 → 券进出日志（页面地址 /admin/MoonCake/mticketinoutlog/）

用途	说明
查库存变化	按操作日期、类型看每笔出入库
追单据	备注里带单据号、门店或操作人，可反查来源
对期末数	期末数量是累计结果，可以直接和券类型的结存对照

二、界面布局说明

区域	内容
工具栏	导出、打印（含打印模板管理）、搜索、刷新、全屏
查询条	关键字搜索、操作日期、操作类型（0=入库，1=出库）、类型ID
列表	操作日期 / 操作类型 / 券类型 / 起始流水号 / 结束流水号 / 数量 / 期末数量 / 备注
分页	默认 50 条/页

操作类型只有两种颜色：入库绿色、出库红色，一眼能看出方向。操作日期是 8 位字符串（如 20260810），不是日期控件，排序按字符串，跨年时注意。

三、一条日志怎么产生

来源	操作类型	备注
券列表管理 添加饼券	入库	「操作人名 添加」
门店领出 / 代理商领出	出库	「[单据号] 门店领出」/「[单据号] 代理商领出」
门店领出退回 / 代理商领出退回	入库	「[单据号] 门店领出退回」/「[单据号] 代理商领出退回」
内部销售 等销售单	出库	备注带「销售」字样，可能同时带门店名或单据号（如「[南山店][销售]出库」）
电子券发放	入库	「发放,发放人员：操作人」

内部销售退回 和 代理商销售退回 不写本日志——退回只改券状态和数量，不产生库存流水。

四、期末数量怎么读

期末数量 = 该类型上一条记录的期末数量 ± 本次数量（入库加、出库减）。

所以：

• 同一类型从旧到新看，最新一条的期末数量反映当前库存；
• 行不是按流水号排的，但可以按起始流水号定位是哪一批；
• 如果期末数量出现负数，说明这个类型的出库比入库多，通常是「销售数量超过领取数量」或数据人为调整过。

五、常见问题

问：为什么找不到某张销售单的出库记录？ 答：销售单只在有净出库时才写日志——如果这批券是「先领出再销售」，领出那一步已经出过库，销售时不再重复记。要按单据找痕迹，去 券明细管理 看销售单号列。

问：日志能改或删吗？ 答：不能。页面没有新增、修改、删除入口，历史流水只能查看和导出。写错了只能靠业务单据纠正。

问：期末数量和券类型的「结存」对不上？ 答：口径不同。结存 = 总数量 − 领取数量 − 作废数量；期末数量只跟出入库流水走，不含作废。对账时先用结存看账面，再用日志解释差额来源。

问：从券列表点「出入库明细」跳过来，为什么只看到一部分？ 答：跳转会带上券类型做预过滤（地址里带 ?ftypeid=）。清掉筛选条件就能看全部。