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

网页地址:/admin/Storage/batchstockreport/
一、功能概述
- 只读报表:数据来自单据审核记账后写入的批次库存账,本窗口不产生也不修改数据;未启用批号管理的商品不产生批次账;
- 结存口径:结存数量 = 期初数量 + 累计收入 − 累计发出;
- 状态列:失效状态、批号状态取自批号档案,以中文显示(正常 / 预警 / 过期;草稿 / 已生效 / 禁用);
- 下钻:「明细账」列进入批号库存明细账,看单个批号的完整生命周期;
- 报表不提供合计行。
二、界面布局说明
上方为筛选面板:常用条件直接平铺,「高级筛选」按钮打开右侧抽屉收纳更多条件;面板上有「查询」「重置」「导出」「★ 方案」按钮,「★ 方案」可保存当前条件组合供下次调用。下方为结果列表,底部状态栏显示「共 N 条,第 x-y 条」,每页 100 条。打开窗口时按默认条件自动查询一次,会计期默认当前自然月。
三、业务操作步骤
步骤 1:设置查询条件
| 条件 | 说明 |
|---|---|
| 仓库 | 多选,仅列总部仓库 |
| 会计期 | 月份条件,默认当前自然月;快捷按钮:本月 / 上月 / 本季度 / 上季度 / 今年 / 去年 |
| 批号 | 文本模糊匹配,占位「输入批号...」 |
| 商品名称 | 文本模糊匹配,占位「输入商品名称...」 |
| 失效状态 | 全部 / 正常 / 预警 / 过期 |
步骤 2:查询
点「查询」,列表刷新列出符合条件的批次结存,默认按仓库正序排列;点「重置」清空条件。
步骤 3:下钻批号库存明细账
点某行「明细账」,打开批号库存明细账,自动携带该行的仓库、商品、批号与会计期。该页不在菜单中,从本窗口进入,地址形如 /admin/Storage/batchledgerpage/?store=<仓库ID>&inv=<商品ID>&batch=<批号ID>&month=<会计期>。页面内容:
- 批号信息栏:批号、批号名称、生产日期、失效日期、失效标志,以及商品编号、名称、规格、单位,并给出该批号最新会计期的结存;
- 四张指标卡:期初数量、本期收入数量、本期发出数量、期末结存(查询范围不是本会计期时,收入、发出卡片标题随范围变化);
- 明细帐簿页签:查询范围可选本会计期 / 本年度 / 全部 / 自定义(起止六位年月),另有「仅当天」勾选。列表列为会计期、单据日期、单据类型、单据号、备注、收入数量、发出数量、结存数量;首行为期初余额,跨期有期次分隔行;表尾合计对收入、发出求和,结存取最后一行的值。单据号是可点的链接,点击打开生成该笔流水的原始单据,规则与单品库存明细账一致,见库存查询与库存明细账;
- 月份对比页签:近 24 个会计期的数量趋势图与逐期对比表;
- 页内切换批号:顶部三级联动(仓库 → 批号商品 → 批号)加「查询」按钮,只列批号账里有数的维度,不必返回本报表;
- 导出:CSV 列为会计期 / 单据日期 / 单据类型 / 单据号 / 备注 / 收入数量 / 发出数量 / 结存数量;
- 未选仓库、商品、批号时提示「请选择仓库、商品和批号后再查询」。
步骤 4:导出
点筛选面板「导出」,导出当前查询条件下显示列的数据:CSV 带 BOM,Excel 直接打开不乱码;文件名形如「批次库存查询_20260101120000.csv」(前缀 + 导出时间);最多导出 10000 行;「明细账」链接列不导出。
四、字段详细说明
1)结果列
| 字段名 | 含义 |
|---|---|
| 仓库 | 批次所在仓库(冻结列) |
| 会计期 | 存货会计期 |
| 商品编码 | 商品编码 |
| 商品名称 | 商品名称 |
| 规格 | 商品规格 |
| 批号 | 批号编码 |
| 生产日期 | 取自批号档案 |
| 失效日期 | 取自批号档案 |
| 失效状态 | 正常 / 预警 / 过期 |
| 批号状态 | 草稿 / 已生效 / 禁用 |
| 期初数量 | 该会计期期初结存 |
| 累计收入 | 该会计期累计入库数量 |
| 累计发出 | 该会计期累计出库数量 |
| 结存数量 | 期初数量 + 累计收入 − 累计发出 |
| 单位 | 商品基本单位 |
| 明细账 | 下钻链接,不导出、不参与排序 |
2)枚举值说明
失效状态:
| 取值 | 含义 |
|---|---|
| 正常 | 批号在有效期内 |
| 预警 | 临期预警批号 |
| 过期 | 已过失效日期 |
批号状态:
| 取值 | 含义 |
|---|---|
| 草稿 | 未生效的批号 |
| 已生效 | 正常使用的批号 |
| 禁用 | 标记停用的批号 |
五、典型使用场景
场景 1:临期批次排查
背景:烘焙门店每月清理临期原料。 操作:失效状态选「预警」或「过期」→ 选仓库 → 查询 → 按失效日期核对 → 需要看某批号的来龙去脉,点该行「明细账」。
场景 2:召回时定位库存分布
背景:某批号原料被供应商通知召回。 操作:批号条件输入该批号,不选仓库查全部总部仓 → 查询得到各仓结存分布 → 逐仓安排下架、报损,处理后再查确认结存清零。
场景 3:月末批次对账
背景:财务需要按批次核对库存。 操作:会计期选当月 → 导出 CSV → 与库存查询的总账核对;注意批次库存只含启用批号管理的商品。
六、权限控制与前置条件
- 账套需开通「批号管理」应用,账号需有批次库存菜单权限;导出受导出权限控制;
- 商品需启用批号管理,且单据已审核记账,才有批次账数据;
- 仓库条件仅列总部仓库,分店仓库存不在本窗口统计范围;
- 会计期为存货会计期,与自然月可能不同;默认条件落在当前自然月。
七、常见问题
1. 打开窗口列表为空
- 原因:默认会计期为当前自然月,当月没有批次记账时结果为空;
- 处理:切换会计期(如「上月」)或放宽条件再查。
2. 下拉里找不到某仓库
- 原因:仓库条件只列总部仓库;
- 处理:分店仓库存到零售、加盟侧窗口查看。
3. 导出文件没有「明细账」列
- 原因:链接列不参与导出;
- 处理:属正常口径,如需批号逐笔流水,下钻明细账后在明细账页导出。
4. 批次库存合计与库存查询对不上
- 原因:批次库存只统计启用批号管理商品的批次账,库存查询统计全部商品;
- 处理:先按商品口径对齐,再比数量。
5. 提示「查询失败: …」
- 原因:查询条件或数据异常,提示冒号后为具体原因;
- 处理:按原因调整条件;持续出现时把查询条件与提示原文报给技术支持。
相关窗口
- 批号档案 — 批号与保质期信息的来源
- 批次流水 — 批次结存的逐笔发生额
- 库存查询与库存明细账 — 不分批号的库存总账与单据号下钻规则
