Bagisto 库存管理快速指南：3步搞定多仓库库存与低库存预警

【免费下载链接】bagistoOpen Source eCommerce & Multi-Vendor Marketplace Platform Built with Laravel for Enterprise-Scale Commerce, Supporting 10M+ SKUs项目地址: https://gitcode.com/gh_mirrors/ba/bagisto

订单卖飞了才发现仓库只剩3件，客户投诉比物流单先到。库存管理是电商运营的底线，Bagisto 的库存管理模块（多仓库 Inventory Source + 低库存预警阈值）专门解决这类问题。本文带你走一遍完整路径：建仓库、给产品分配库存、设置预警阈值，照做即可跑通。

全景速览：库存管理的3个核心概念

1. Inventory Source（库存源）：一个仓库或发货点。管"货放在哪"，有代码、地址、优先级、联系人信息，是库存的容器。
2. 产品库存数量：产品与库存源多对多关联，每个"产品×库存源"组合存一个数量。管"每个仓里有多少"。
3. Out of Stock Threshold（缺货阈值）：全局预警线。管"多少数量算危险"，低于阈值的库存会被标记，并在仪表板集中展示。
4. Manage Stock（库存管理开关）：产品级开关。关掉了，系统就不跟踪这个产品的库存，预警也管不到它。

从0到配置完成：3步设置库存源与低库存预警

第1步：创建库存源

1. 打开后台Settings > Inventory Sources，点击Create New Inventory Source。
2. General 区域：填入Code（唯一编码）和Name（仓库名称，如"上海总仓"）。
3. Contact Information 区域：填入Contact Name、Contact Email、Contact Number。
4. Source Address 区域：选择Country、State、City、Street、Postcode。
5. 右侧 Settings 折叠面板：填Latitude、Longitude（发货地址坐标），设置Priority，把Status开关拨到Enabled。
6. 点击Save，返回列表页能看到刚创建的库存源。

只有 Status 为 Enabled 的库存源，才会出现在后续的产品库存配置里。

第2步：给产品分配库存

1. 打开Catalog > Products，点击要配置的产品进入编辑页。
2. 在表单中找到Manage Stock开关并勾选（不勾选则系统不跟踪该产品库存）。
3. 下方 Inventories 区域会为每个激活的库存源渲染一行输入框，逐个填入该仓的库存数量（只允许min:0的数字）。
4. 页面顶部会显示当前 Pending Ordered Qty（待发货占用量）。
5. 点击Save，刷新后各库存源数量保持不变，说明分配成功。

第3步：设置缺货预警阈值

1. 打开Settings > Configuration，在Catalog下找到Inventory > Product Stock Options。
2. 找到out_of_stock_threshold（Out of Stock Threshold），填入预警数值，如5。默认是0，即库存为 0 才算告警。
3. 同一区域还有back_orders（是否允许缺货预订），按需勾选。
4. 点击Save Config。

回到后台首页 Dashboard，Stock Threshold Products面板会列出库存最紧张的 5 个产品：总库存低于阈值的显示红色，高于阈值的显示绿色。点击行末箭头可直接跳转编辑该产品。

它是怎么工作的：库存数据从哪来到哪去

产品与库存源通过product_inventories关联表存储，每个组合一行qty；订单生成后，库存占用记录在cart_item_inventories表，发货流程据此核减。仪表板数据由Webkul\Admin\Helpers\Reporting\Product的getStockThresholdProducts()方法汇总：按产品×库存源分组、total_qty升序取前5条，前端在packages/Webkul/Admin/src/Resources/views/dashboard/stock-threshold-products.blade.php里与阈值比较并标红标绿。阈值只影响颜色标记——面板固定展示库存最低的5个产品，并不筛选。

落地前必看的坑：阈值、多仓与常见误区

阈值设了为什么产品没变红？

阈值只控制仪表板的红绿配色，不控制列表内容。另外产品必须打开Manage Stock，且库存行确实填了数量；qty为 0 或未分配的产品不会被跟踪，预警自然不生效。

新建的库存源为什么在产品编辑页看不到？

产品 Inventories 区域只遍历status = 1（Enabled）的库存源。新建后忘记开 Status 开关，或在其他渠道未启用，都会导致输入框不出现。

多个仓库时，系统从哪个仓扣库存？

各库存源数量独立保存，前台可售判断看的是产品全部激活库存源的数量合计（inventory_source_qty求和），不能指定"只从某仓发货"。仓库间的Priority用于排序参考，不是扣减顺序的硬性约束。

下一步：把预警变成日常习惯

多仓库分库存 + 全局阈值预警，让你把"卖超了"变成"提前5件就补货"。获取项目：

git clone https://gitcode.com/gh_mirrors/ba/bagisto

按官方流程安装完成后，先建好各仓库的 Inventory Source，再给爆款产品单独设低阈值观察一周——仪表板的红绿列表会成为你每日补货的第一站。

【免费下载链接】bagistoOpen Source eCommerce & Multi-Vendor Marketplace Platform Built with Laravel for Enterprise-Scale Commerce, Supporting 10M+ SKUs项目地址: https://gitcode.com/gh_mirrors/ba/bagisto