库存盘点（建单 → 录实盘 → 确认）

库存流水记的是「有单据的变动」，盘点记的是**「仓库里的实物和账面本来就不一致」这件事**。流程固定三步：建单时冻结一份账面快照，仓管员照着实物流转填实盘，确认时由系统按当时的账面重算差异并生成盘盈/盘亏流水。

入口

登录商户 PC 后台 → 左侧 库存台账 → 库存 → 库存盘点。

这一页只下发给试用版、专业版、旗舰版，基础版套餐里没有这个菜单（确认盘点会直接记账，属记账动作）。商户端 App 暂无盘点入口，请在 PC 后台操作。

列表显示：盘点单号、仓库、门店、状态、盲盘、明细数、已录数、差异项、快照时间、创建人。可按 关键字（单号或仓库名称）、状态、仓库、门店、快照日期 筛选。

一、四个状态

差异不由你填，也不在确认前显示。列表的「差异项」与明细里的「差异」列在确认前恒为空——因为快照之后仓库还在正常出入库，拿快照账面减实盘会把这段时间的正常销售也算成盘亏。

二、新建盘点单（抓快照）

1. 点右上 新建盘点单。
2. 选 盘点仓库。下拉里只有门店仓与总部仓，在途仓不出现。仓库必须已启用、已绑定门店，否则会拦下：「仓库已停用，不能盘点」「在途仓不能盘点」「仓库未绑定门店，不能盘点」。
3. 选 盘点范围，三选一：
   • 整个仓库：该仓库里有库存记录的全部物料；
   • 按商品分类：只盘某一分类；
   • 指定物料：搜索勾选，单次最多 500 项。 同时填了「指定物料」和「分类」时，按 指定物料 → 商品分类 → 整个仓库 的优先级取，不会叠加。范围为空会提示「盘点范围内没有物料，请检查仓库与筛选条件」。
4. 盲盘：开启后，录入实盘时看不到账面数量，确认后才连同差异一起放开留档。用于让盘点人不被账面数字带着走。
5. 备注 可不填，最多 500 字。它会作为差异调整原因写进盘盈/盘亏流水，建议写清「月盘」「抽盘某分类」等事由。
6. 点 建单并抓快照。成功后提示「已抓取账面快照，共 N 项」，状态为草稿。

批次物料

启用「批次管理」的物料，建单时按批次逐行展开（一个批次一行，明细里显示批次号与到期日），这样盘出来的差异才能落到具体批次上。从没登记过批次的物料：整仓/按分类盘点会直接跳过它；单独指定该物料时会提示「物料「X」启用批次管理但尚未登记批次，请先完成采购入库」。

三、录入实盘

点行内 录入实盘 打开抽屉，逐行填 实盘：

• 按物料的基本单位填写，最多 4 位小数，必须填非负数。0 是有效计数（该物料该批次实际没有货），不是「没填」。
• 顶部进度显示「已录 X / Y 项，还差 N 项」。可以反复保存，先盘完的先行保存，没填的行留到下次再补。
• 草稿单首次录入并保存后，状态自动转 盘点中。
• 「账面（快照）」列只是给你对照用的基准，确认时不拿它算差异；没填的行在只读视图里显示「未录」；盲盘单在确认前同时不显示「账面（快照）」与「差异」两列。
• 「调整成本」列需要 查看成本 权限（inventory:cost:view），且只有已确认的单才有值。

四、确认盘点

核对完整后点 确认盘点。系统先拦一道：还有未填的行时会提示「还有 N 项未录入实盘数量，请先补录并保存」（页面上也有一道同样的检查），补录后再确认。

确认后：

• 逐行按 实盘 − 当前账面（当前账面 = 快照账面 + 快照之后的流水）算出差异，正的记盘盈、负的记盘亏，各落一笔库存流水，单据号前缀 PD。
• 库存余额被调整到与实盘一致，单据状态变 已确认、不可再改。
• 提示「已确认：盘盈 N 项、盘亏 M 项」。若附带下面两句话，按提示处理：
  • 「K 个物料没有成本基础，请到期初建账或成本补录补单位成本」：这些物料账面本来就没有均价，盘盈能入账但没有金额，补齐成本基础后另行处理。
  • 「K 个物料调整后仍为负库存，需入库冲平」：可用量（在库 − 未支付订单锁定）本来就对不上，或批次结存与台账总量不一致，需要再做一张入库单把数量冲平。

五、改数与作废

• 确认后发现数量录错：已确认的单不能改也不能作废，请再建一张反向盘点单（把正确数量重新盘一遍）来纠正。
• 未确认的单：点行内 作废。不产生任何库存变动，也不可恢复；录错了直接作废重建一张即可。

六、核对与留痕

确认后的差异在 库存台账 → 库存 → 库存流水 里可查，业务类型是「盘盈」「盘亏」，单据号是本次盘点单的 PD 号，能和盘点单逐笔对上。盘点单本身长期保留，实盘数、账面快照与差异都可回看。

七、权限

• 页面 inventory:stocktake:list（列表与详情共用），按钮 新建 :add、录入实盘 :edit、确认盘点 :confirm、作废 :void。
• 成本列另需 查看成本 权限（inventory:cost:view），没有该权限时金额为空，不影响建单与确认。
• 只能盘自己数据范围内的门店仓：仓库下拉与建单校验都受门店行级范围限制，越权时提示「仓库不存在或无权操作」「无权操作该门店的盘点单」。

常见问题

Q1：明细里的「差异」一直是「—」、列表的「差异项」恒为 0，是不是没算？ A：确认前本来就没有差异。差异由服务端在确认那一刻按当时的账面重算（快照之后的出入库也算进账面），确认前那些行只是待录入的明细。

Q2：盘点期间还在卖货，会不会被算成盘亏？ A：不会。当前账面 = 快照账面 + 快照之后的流水，销售已经先从账面上扣掉了，再拿实盘减它，剩下的才是真正的差异。所以边营业边盘点是允许的，不用停业。

Q3：多人一起录一张单会互相覆盖吗？ A：不会互相覆盖数据行——保存时按明细逐行写入，只改自己填的那几行。但同一条明细以最后一次保存为准，建议按分类或货架分工，别两人盘同一批物料。

Q4：实盘填 0 会被当成没填吗？ A：不会，0 是有效计数，表示「这里确实没有货」。判断「没填」的依据是这一行留空。

Q5：盲盘是干什么用的？ A：让盘点人看不到账面数量、只照实物填报，避免「看着账面数凑实物数」。盲盘单在确认前同时不显示「账面（快照）」与「差异」两列，确认后连同差异一起放开留档。

Q6：已经确认了才发现录错，怎么办？ A：重新建一张盘点单，把正确数量盘一遍并确认，差异会自动朝正确方向调整。已确认的单据不动，改动轨迹在流水里可查。

Q7：基础版怎么找不到「库存盘点」这个菜单？ A：有意不下发。盘点确认会直接生成盘盈/盘亏流水，属记账动作，只给试用版、专业版、旗舰版。需要的话升级套餐或联系平台运营。

Q8：盘亏要把库存扣成负数，会被「库存不足」拦下吗？ A：不会。其他出库类单据那道「可用量（在库 − 未支付订单锁定）是否够扣」的校验对盘点放行——差异是实物盘出来的事实，拦下来只会逼着人把实盘数改小。放行后若仍留下缺口（有未支付订单占着量，或批次结存与台账总量本来就对不上），确认结果里会单独提示「K 个物料调整后仍为负库存，需入库冲平」，见第四节的处理办法。