库存管理 — 用户操作手册
功能概述
库存管理页面用于统一查看品牌旗下所有标准品的库存统计与批次明细，支持按包装类型筛选、搜索商品、查看批次详情、盘点调整库存、导出库存数据，以及释放被订单占用的库存。
- 已登录品牌管理后台
- 至少配置了一个仓库
- 已有商品入库记录
一、页面总览
进入页面后，您将看到以下区域：
- 顶部操作栏 — 仓库筛选、商品入库、导出库存、库存调拨按钮
- 包装分类卡片 — 桶装、箱装、罐装/瓶装、周边物料四个统计卡片
- SKU 库存列表 — 按规格合并展示的商品库存表格
二、筛选与搜索
Step 1：选择仓库
点击页面右上角的「仓库」下拉框，选择要查看的仓库。
- 选择「全部仓库」可查看所有仓库的汇总库存
- 选择具体仓库后，页面数据将自动刷新为该仓库的库存
Step 2：按包装类型筛选
点击四个包装卡片中的任意一个，表格将只显示该类型的商品：
| 卡片 | 包含商品 |
|---|---|
| 桶装 | 桶装商品 |
| 箱装 | 箱装商品 |
| 罐装/瓶装 | 罐装和瓶装商品 |
| 周边物料 | 非酒水类周边物料 |
每个卡片上显示三个指标：
- 现货库存 — 仓库中实际持有的总量
- 已开单占用 — 已被订单占用但尚未出库的数量
- 可用商品 — 可用于新订单的数量（= 现货库存 - 已开单占用）
箱装商品的数量以"箱"为单位显示，系统会自动按装箱数折算。
Step 3：搜索商品
在搜索框中输入品牌名称、商品名称或条码，系统会自动搜索匹配的商品。按回车可立即搜索。
Step 4：按规格快速筛选
在表格的「规格」列中，点击某个规格名称（蓝色链接），表格将只显示该规格的商品。筛选生效后，搜索框下方会出现一个标签，点击标签上的关闭按钮即可清除筛选。
三、查看批次明细
Step 1：打开批次详情
在表格的「操作」列中，点击「查看批次」按钮。
Step 2：查看右侧抽屉
系统将从右侧滑出一个面板，显示：
- 顶部信息：商品名称、规格、包装形式、69码
- 汇总统计：现货库存、占用库存、可用库存
- 批次明细表：每一行代表一个批次，包含仓库、批次日期、69码、装箱数、现货、可用、占用数量
四、查看与释放占用库存
当商品库存被订单占用时，您可以查看占用明细并释放不再需要的占用。
Step 1：进入占用明细
在批次详情面板中，点击「占用库存」卡片（带有眼睛图标，提示"点击查看占用明细"）。
Step 2：查看占用列表
弹窗顶部显示占用概览：
- 可释放 — 来源订单已终态，可安全释放
- 需复核 — 需人工确认后才能释放
- 保留占用 — 不建议释放
占用列表包含以下信息：
- 履约单号、来源类型（销售订单 / 售后单 / 营销活动 / 押金单 / 积分兑换）
- 来源单据ID、来源状态、客户名称
- 占用数量、单位、批次日期
- 释放判定（可释放 / 需复核 / 保留占用）及判定说明
Step 3：释放单条占用
在列表右侧点击「释放占用」（或「强制释放」），系统会弹出输入框要求您填写释放原因，填写后点击「确认释放」。
Step 4：批量释放占用
- 勾选需要释放的记录（只有"可释放"状态的记录可被勾选）
- 如需同时释放"需复核"状态的记录，请勾选底部的「包含需复核（强制）」选项
- 点击「批量释放（X）」按钮
- 在弹出的输入框中填写释放原因，点击「确认释放」
释放原因为必填项，最多255个字符。释放后库存将自动刷新。
五、库存盘点
盘点功能用于调整库存数据，使系统数据与实际库存一致。
溯源类商品（带追溯码的商品）不支持在网页端盘点，请使用 PDA 设备进行盘点。
Step 1：发起盘点
在表格「操作」列中，点击「盘点」按钮（仅非溯源商品显示此按钮）。
Step 2：选择盘点类型
弹窗中显示商品信息，并提供两种盘点类型：
方式一：现有批次调整
适用于已有批次的库存数量需要修正的场景。
- 选择「现有批次调整」
- 在「批次」下拉框中选择需要调整的批次（显示格式：仓库 · 批次日期 · 现货数量）
- 系统会显示当前库存（现货、可用、占用）
- 在「目标库存」中输入盘点后的实际数量
- 填写「调整原因」和「备注」（均为必填）
- 点击「确认盘点」
方式二：新增批次入库
适用于发现有未入系统的新批次商品。
- 选择「新增批次入库」
- 选择「仓库」
- 选择「批次日期」
- 在「入库数量」中输入数量（必须大于 0）
- 填写「调整原因」和「备注」（均为必填）
- 点击「确认盘点」
箱装商品的数量以"箱"为单位输入，系统会自动换算为基础单位。
六、商品入库
点击页面右上角的「商品入库」按钮，系统将跳转至 [[商品入库-用户操作手册|商品入库]] 页面。
七、导出库存
点击页面右上角的「导出库存」按钮，系统会将当前筛选条件下的库存数据导出为 Excel 文件（文件名格式：库存数据_YYYY-MM-DD.xlsx）。导出范围受仓库筛选和包装类型筛选影响。
八、库存调拨
点击页面右上角的「库存调拨」按钮，系统将跳转至 [[库存调拨-用户操作手册|库存调拨]] 页面，用于在不同仓库之间转移库存。
常见问题
| 问题 | 原因与解决方案 |
|---|---|
| 页面提示"获取库存统计失败" | 网络异常或服务暂时不可用，请刷新页面重试 |
| 页面提示"获取库存数据失败" | 网络异常或服务暂时不可用，请刷新页面重试 |
| 表格显示"暂无库存数据" | 当前筛选条件下没有库存记录，请切换包装类型或清除搜索条件 |
| 盘点按钮不显示 | 该商品为溯源类商品，请使用 PDA 设备进行盘点 |
| 提示"溯源规格请使用 PDA 盘点" | 溯源商品不支持网页端盘点，请使用 PDA 设备操作 |
| 提示"请补充调整原因与备注" | 盘点时调整原因和备注均为必填，请完整填写 |
| 提示"入库数量必须大于 0" | 新增批次入库时，数量不能为零 |
| 提示"批次明细加载失败" | 所有仓库的批次查询均失败，请检查网络或联系技术支持 |
| 部分仓库批次加载失败 | 多仓库查询时部分仓库返回异常，已加载的数据仍可使用 |
| 占用释放提示"没有可释放的占用" | 选中的记录不满足释放条件，请检查释放判定状态 |
| 释放原因不能为空 | 释放占用时必须填写原因，最多255个字符 |