一、【业务场景】

1、客户存在大量商品加工业务，加工生产时需要优先扣减指定主料A库存，当A库存不足时，需要自动扣减备选B商品库存完成加工投料。

2、原系统物料清单无原材料替补规则配置功能，主料库存不足时，无法自动切换替补商品，必须人工手动更换物料商品。

3、人工手动替换物料操作繁琐、耗时较长，且容易选错商品、录错用量，不仅严重影响加工出库效率，还容易导致库存扣减错乱、成本不准，影响库存数据准确性。

4、客户核心需求：在WMS物料清单中新增替补商品配置能力，支持维护原料替代关系、替补用量及成本，加工扣库时自动按规则替换，减少人工干预、保障加工流程顺畅。

二、【功能介绍】

问题编号：EAR-243938

更新范围：新WMS-物料清单（物料商品新增替补配置）

限制条件：无

本次系统升级迭代，参考银豹系统替换商品逻辑，新增物料替补商品维护能力，解决加工原料不足需人工替换的痛点。

三、【使用说明】

功能路径及详细操作

1、WMS-物料清单-物料商品列表新增字段

功能路径：新WMS - 物料清单 - 物料商品列表

展示字段：新增【替补商品】、【替补商品数】两列

操作规则：

1、点击【替补商品】可弹出替补商品配置弹窗；

2、弹窗自动带入当前原料商品信息：物料商品名称、单位用量、加工单位、门店名称；

3、【替补商品数】自动统计当前主料已配置的替补商品总数量；

4、该功能仅 QT 前台、安卓端生效，其他端暂不支持。

2、替补商品弹窗-添加商品规则

操作路径：替补商品弹窗 → 点击【添加商品】→ 打开商品档案公共页

商品过滤规则：自动过滤以下不可选商品：

1、被替换的当前原料商品；

2、当前加工成品商品；

3、已添加过的替补商品；

4、非当前加工商品同门店的其他物料商品。

添加规则：新添加的替补商品默认排序在列表最下方，支持自定义调整顺序。

3、替补商品表格字段及计算规则

弹窗表格展示字段：序号、操作、商品代码、商品名称、商品规格、基本单位、单位用量、最近进价、用量成本、最小加工用量

核心字段规则：

1、单位用量：支持手动输入，代表生成1个加工商品所需的该替补商品用量；

2、最小加工用量：系统自动计算，公式：最小加工用量 = 最小加工量 * 单位用量；

3、最近进价：遵循系统全局最近进价规则自动带出；

4、用量成本：系统自动计算，公式：用量成本 = 最小加工用量 * 最近进价。

4、保存规则

1、点击保存后，完整保存当前所有替补商品明细；

2、同步保存用户自定义的替补商品排序顺序，加工替补优先按排序执行；

3、保存成功后，列表“替补商品数”实时刷新对应数量。

四、【注意事项】

1、本替补商品功能仅支持QT前台、安卓端使用，其他终端暂不生效。

2、添加替补商品时系统自动过滤无效商品，避免主料、成品、重复替补商品导致的数据异常。

3、最小加工用量、用量成本为系统自动计算，以录入的单位用量和系统进价为准，无需手动计算。

4、替补商品排序支持自定义，排序顺序即为加工时替补优先顺序，需根据业务替补优先级提前维护。

5、维护替补规则后，加工场景主料库存不足时可自动按配置替补商品扣库，减少人工替换操作，提升加工出库效率与库存准确性。

6、删除/调整替补商品后需重新保存，否则新规则不生效。