Skip to content

批次库存 ​

批次库存查询按「仓库 + 商品 + 批号 + 会计期」展示每个批号的期初数量、累计收入、累计发出与结存数量,是保质期排查与召回定位时查「问题批次还剩多少、在哪些仓库」的窗口。每行末尾的「明细账」链接可下钻到批号库存明细账,查看该批号从期初到期末的逐笔流水。

功能路径:批号管理 → 批号账表 → 批次库存

批次库存界面:仓库、会计期、商品编码、商品名称、规格、批号、生产日期、失效日期等字段

网页地址:/admin/Storage/batchstockreport/

一、功能概述 ​

  1. 只读报表:数据来自单据审核记账后写入的批次库存账,本窗口不产生也不修改数据;未启用批号管理的商品不产生批次账;
  2. 结存口径:结存数量 = 期初数量 + 累计收入 − 累计发出;
  3. 状态列:失效状态、批号状态取自批号档案,以中文显示(正常 / 预警 / 过期;草稿 / 已生效 / 禁用);
  4. 下钻:「明细账」列进入批号库存明细账,看单个批号的完整生命周期;
  5. 报表不提供合计行。

二、界面布局说明 ​

上方为筛选面板:常用条件直接平铺,「高级筛选」按钮打开右侧抽屉收纳更多条件;面板上有「查询」「重置」「导出」「★ 方案」按钮,「★ 方案」可保存当前条件组合供下次调用。下方为结果列表,底部状态栏显示「共 N 条,第 x-y 条」,每页 100 条。打开窗口时按默认条件自动查询一次,会计期默认当前自然月。

三、业务操作步骤 ​

步骤 1:设置查询条件 ​

条件说明
仓库多选,仅列总部仓库
会计期月份条件,默认当前自然月;快捷按钮:本月 / 上月 / 本季度 / 上季度 / 今年 / 去年
批号文本模糊匹配,占位「输入批号...」
商品名称文本模糊匹配,占位「输入商品名称...」
失效状态全部 / 正常 / 预警 / 过期

步骤 2:查询 ​

点「查询」,列表刷新列出符合条件的批次结存,默认按仓库正序排列;点「重置」清空条件。

步骤 3:下钻批号库存明细账 ​

点某行「明细账」,打开批号库存明细账,自动携带该行的仓库、商品、批号与会计期。该页不在菜单中,从本窗口进入,地址形如 /admin/Storage/batchledgerpage/?store=<仓库ID>&inv=<商品ID>&batch=<批号ID>&month=<会计期>。页面内容:

  1. 批号信息栏:批号、批号名称、生产日期、失效日期、失效标志,以及商品编号、名称、规格、单位,并给出该批号最新会计期的结存;
  2. 四张指标卡:期初数量、本期收入数量、本期发出数量、期末结存(查询范围不是本会计期时,收入、发出卡片标题随范围变化);
  3. 明细帐簿页签:查询范围可选本会计期 / 本年度 / 全部 / 自定义(起止六位年月),另有「仅当天」勾选。列表列为会计期、单据日期、单据类型、单据号、备注、收入数量、发出数量、结存数量;首行为期初余额,跨期有期次分隔行;表尾合计对收入、发出求和,结存取最后一行的值。单据号是可点的链接,点击打开生成该笔流水的原始单据,规则与单品库存明细账一致,见库存查询与库存明细账;
  4. 月份对比页签:近 24 个会计期的数量趋势图与逐期对比表;
  5. 页内切换批号:顶部三级联动(仓库 → 批号商品 → 批号)加「查询」按钮,只列批号账里有数的维度,不必返回本报表;
  6. 导出:CSV 列为会计期 / 单据日期 / 单据类型 / 单据号 / 备注 / 收入数量 / 发出数量 / 结存数量;
  7. 未选仓库、商品、批号时提示「请选择仓库、商品和批号后再查询」。

步骤 4:导出 ​

点筛选面板「导出」,导出当前查询条件下显示列的数据:CSV 带 BOM,Excel 直接打开不乱码;文件名形如「批次库存查询_20260101120000.csv」(前缀 + 导出时间);最多导出 10000 行;「明细账」链接列不导出。

四、字段详细说明 ​

1)结果列 ​

字段名含义
仓库批次所在仓库(冻结列)
会计期存货会计期
商品编码商品编码
商品名称商品名称
规格商品规格
批号批号编码
生产日期取自批号档案
失效日期取自批号档案
失效状态正常 / 预警 / 过期
批号状态草稿 / 已生效 / 禁用
期初数量该会计期期初结存
累计收入该会计期累计入库数量
累计发出该会计期累计出库数量
结存数量期初数量 + 累计收入 − 累计发出
单位商品基本单位
明细账下钻链接,不导出、不参与排序

2)枚举值说明 ​

失效状态:

取值含义
正常批号在有效期内
预警临期预警批号
过期已过失效日期

批号状态:

取值含义
草稿未生效的批号
已生效正常使用的批号
禁用标记停用的批号

五、典型使用场景 ​

场景 1:临期批次排查 ​

背景:烘焙门店每月清理临期原料。 操作:失效状态选「预警」或「过期」→ 选仓库 → 查询 → 按失效日期核对 → 需要看某批号的来龙去脉,点该行「明细账」。

场景 2:召回时定位库存分布 ​

背景:某批号原料被供应商通知召回。 操作:批号条件输入该批号,不选仓库查全部总部仓 → 查询得到各仓结存分布 → 逐仓安排下架、报损,处理后再查确认结存清零。

场景 3:月末批次对账 ​

背景:财务需要按批次核对库存。 操作:会计期选当月 → 导出 CSV → 与库存查询的总账核对;注意批次库存只含启用批号管理的商品。

六、权限控制与前置条件 ​

  1. 账套需开通「批号管理」应用,账号需有批次库存菜单权限;导出受导出权限控制;
  2. 商品需启用批号管理,且单据已审核记账,才有批次账数据;
  3. 仓库条件仅列总部仓库,分店仓库存不在本窗口统计范围;
  4. 会计期为存货会计期,与自然月可能不同;默认条件落在当前自然月。

七、常见问题 ​

1. 打开窗口列表为空 ​

  • 原因:默认会计期为当前自然月,当月没有批次记账时结果为空;
  • 处理:切换会计期(如「上月」)或放宽条件再查。

2. 下拉里找不到某仓库 ​

  • 原因:仓库条件只列总部仓库;
  • 处理:分店仓库存到零售、加盟侧窗口查看。

3. 导出文件没有「明细账」列 ​

  • 原因:链接列不参与导出;
  • 处理:属正常口径,如需批号逐笔流水,下钻明细账后在明细账页导出。

4. 批次库存合计与库存查询对不上 ​

  • 原因:批次库存只统计启用批号管理商品的批次账,库存查询统计全部商品;
  • 处理:先按商品口径对齐,再比数量。

5. 提示「查询失败: …」 ​

  • 原因:查询条件或数据异常,提示冒号后为具体原因;
  • 处理:按原因调整条件;持续出现时把查询条件与提示原文报给技术支持。

相关窗口 ​