库存盘点
库存盘点是这一组里唯一有「新建」入口的窗口，也是盘盈单和盘亏单的唯一来源。它本身是一张工作台：先按某一种范围方式生成一张盘点单（把该盘的物料和当时的账面数摊成一页表），再在表上录实盘数，最后点「盘完确认」让系统自动算差异、生成盘盈盘亏单、过账记账、生成财务凭证。
功能路径：存货管理 → 库存盘点 网页地址：/admin/Storage/chkstockinventpage/（列表）、/admin/Storage/chkstockinventpage/invent_wizard/（新建向导）、/admin/Storage/chkstockinventpage/invent_edit/<盘点单ID>/（录入工作台）
窗口标题写作盘点单，不是「库存盘点」。
一、四种盘点方式
建单时必须选一种物料范围方式，这决定了盘点表里出现哪些物料：
| 方式 | 界面文案 | 物料从哪来 | 适用 |
|---|---|---|---|
| 1 | 按模板盘点 | 盘点模板里维护的物料清单 | 每月固定盘同一批货；模板必须先审核生效 |
| 2 | 按货架盘点 | 选定货架 / 货区挂着的物料 | 按物理位置盘，仓库大、分区清楚时用 |
| 3 | 按库存账簿盘点 | 该仓当前有账的全部物料 | 全仓大盘，最常用 |
| 4 | 按自定义物料盘点 | 建单时手工挑一批物料 | 抽盘、只盘某几类 |
实测数据里第 3 种的名字写作「按货库存账薄盘点」——这是系统内置的类型名，界面上就是这么显示的，不是你的账套被改坏了。建单向导里给的正确说法是「按库存账簿」。
二、新建向导
点「新建盘点单」进三步向导：1 基本信息 → 2 盘点物料范围方式 → 3 确认建单。按钮是下一步 / 取消 / 返回列表。
| 字段 | 必填 | 说明 |
|---|---|---|
| 盘点仓库 | 是 | 一次只能盘一个仓 |
| 盘点单名称 | 否 | 留空按所选方式自动生成，形如「按货库存账薄盘点_2026-10-21 14:31」 |
| 摘要 | 否 | 留空自动生成，形如「[15 原材料仓] _按货库存账薄盘点」 |
第二步按所选方式给不同的选择区：选「按模板」要挑模板，选「按货架」要勾货架，选「按库存账簿」和「按自定义物料」各有对应的选择控件。向导顶部一行提示写得很直白：「四种盘点物料范围方式：按模板 / 按货架 / 按库存账簿 / 按自定义物料」。
校验原文：
| 提示原文 | 触发条件 |
|---|---|
| 请选择盘点仓库 | 表头仓库为空 |
| 必须要选择一种【盘点物料范围方式】! | 第二步一个方式都没勾 |
| 请选择盘点模板 | 选了按模板但没挑模板 |
| 没有选择要盘点的货架! | 选了按货架但没勾货架 |
| 【按库存帐生成盘点表】,【按物料编码生成盘点表】,请选择一种盘点方式！ | 账簿 / 自定义两种都没选 |
| 已勾选「过滤无异动产品」，请选择异动起始日期 | 勾了过滤项却没给起始日期 |
| 所选范围内无结存物料，未生成盘点明细。请检查仓库/条件或库存账簿。 | 范围里一支物料都没有 |
| 当前仓库暂无已生效模板，请先到「盘点模板定义」审核生效 | 按模板盘点，但该仓没有生效模板 |
建单成功给「建单成功：<方式名>，共 N 行明细」。明细行数超过 500 行时会有额外提醒，大盘建议按货区分几张单做。
三、录入工作台
建完单直接进工作台，也可以从列表双击进。顶部信息区给：盘点单名称、仓库、盘点日期、盘点方式、状态、摘要。
按钮：返回列表、保存实盘、盘完确认、从Excel导入实盘数、重新加载。
信息行给三个计数：明细 N / 盘盈行 N / 盘亏行 N，实时按你录的实盘数算。
明细列：
| 列 | 能不能改 | 说明 |
|---|---|---|
| 物料编号、条码、物料名称、规格、单位 | 只读 | 建单时定死 |
| 账面数 | 只读 | 建单那一刻从库存账取的数，不会随别人后续出入库变化 |
| 实盘数 | 可改 | 唯一要录的数 |
| 盘盈 | 只读 | = max(0, 实盘数 − 账面数) |
| 盘亏 | 只读 | = max(0, 账面数 − 实盘数) |
| 进价、售价 | 只读 | 差异金额口径用 |
账面数是快照。 建单到盘完确认之间如果这批货还在出入库，差异会算错。正确做法是盘点期间冻结该仓的单据，或者盘完立刻确认。
保存实盘 vs 盘完确认
这两个按钮差别很大，别混：
- 保存实盘：只把实盘数写回盘点单，不动库存、不生成任何单据。可以反复保存，状态仍是「盘点中」；
- 盘完确认：一次性做完四件事——保存实盘数、按差异生成盘盈单和盘亏单、把这两张单过账记账、生成财务凭证。做完之后状态变「已盘完」，整张单转只读。
盘完确认前会弹一次确认，原文：
确认盘完？系统将保存实盘数、生成盘盈/盘亏单并过账记账、生成财务凭证，之后不可直接修改（需反审核）。
成功后给「过账成功：盘盈 X 行、盘亏 Y 行」。
已盘完的单子再改实盘数会被拦：
| 提示原文 | 触发条件 |
|---|---|
| 该盘点单已盘完过账，不能修改实盘数。如需修改请先反审核。 | 在已盘完状态编辑 |
四、反审核
反审核在列表页做（工具栏第二个按钮），不在工作台做。确认框原文：
确认反审核选中盘点单？将冲销盘盈/盘亏单（库存+凭证）并回退为盘点中。
它是一条连带链：冲销盘盈单和盘亏单的库存账 → 红冲或删除两张单的财务凭证 → 删除或作废这两张单 → 盘点单状态回到「盘点中」，实盘数重新可编辑。
三个注意点：
- 凭证已经被财务记账时反审核不了，提示「关联凭证[…]已记账，不能反审核。请先在财务模块对该凭证红字冲销后再反审核。」——先去财务处理，再回来；
- 反审核后重做盘完确认会重新生成盘盈盘亏单，不是在原单上改；
- 反审核是列表上的批量动作，勾错行会一次冲掉好几张盘点单，动手前核对「仓库 + 盘点日期 + 明细数」三列。
五、状态与列表
| 状态 | 含义 | 能做什么 |
|---|---|---|
| 盘点中 | 已建单，实盘数可录可存 | 保存实盘、盘完确认、反审核 |
| 已盘完 | 已生成盘盈盘亏并过账 | 只能反审核 |
| 作废 | 内部状态，列表筛选里不给 | — |
列表默认每页 50 条（可切 20 / 30 / 50 / 100 / 200），比一般单据窗口的 20 条宽。查询条件三项：关键字（可选包含 / 等于 / 开头为 / 结尾为 / 不等于 / 不包含 / 介于七种匹配方式）、仓库（默认「不限」）、状态（全部 / 盘点中 / 已盘完）。
六、凭证怎么生成
盘完确认顺带生成的两张凭证走固定科目：
| 单 | 凭证方向 | 对方科目 |
|---|---|---|
| 盘盈 | 借：物料科目 / 贷：5301-0A 商品盘盈 | 物料所属类别上配的默认财务科目 |
| 盘亏 | 借：5502-0A 商品盘亏 / 贷：物料科目 | 同上 |
凭证摘要统一写「系统生成凭证」。财务系统选项里开了自动记账的账套，凭证生成即置为已记账。
科目没配好会在这里报错，原文：
| 提示原文 | 触发条件 |
|---|---|
| 获取物料[编码]的[默认财务科目]失败! 请到[物料类别]中为该物料所属类别设置默认科目。 | 物料类别没配默认科目 |
| 生成财务凭证失败! 原因:<原因> | 凭证生成中断 |
撞到这两条时盘盈盘亏单本身可能已经过了库存账，只是凭证没出。先补物料类别的默认科目，再重做，别反复点盘完确认。
七、常见问题
「账面数为什么是 0」 — 建单时该物料在该仓没有账。检查期初库存单做没做、有没有已生效的出入库单。
「盘完确认了，实盘数录错了」 — 列表上反审核这张盘点单 → 回工作台改实盘 → 重新盘完确认。原来的盘盈盘亏单会被冲销，新单重新生成。
「一次盘出三百多行，很慢」 — 按货区或按类别拆成几张单，或者用「按自定义物料」只盘重点品类。超过 500 行系统会提醒。
「从Excel导入实盘数怎么用」 — 工作台的第三个按钮。先按导出的模板填实盘列再导入，导入后仍需「保存实盘」才落库。
「按模板盘点提示没有生效模板」 — 去盘点模板把该仓的模板审核生效，模板存在但状态是草稿等于没有。
「为什么列表里有一张明细 0 行的盘点单」 — 建单时范围里没物料，但当时没被拦住（历史版本或并发条件下可能出现）。这种单盘完确认会生成 0 张盘盈 0 张盘亏，直接作废或反审核后重建。