一、【业务场景】

1、原有WMS出库单「一键添加批次」功能能力单一，无论单据存在多少条同商品明细、多少可用库存批次，仅支持匹配单个批次，无法按实际出库数量拆分多批次明细。

2、客户存在大批量出库业务场景，单次出库数量通常覆盖多个库存批次，现有功能无法自动分批，只能人工逐行手动选择批次、拆分数量、新增明细。

3、大批量出库人工分批操作繁琐、耗时久，极易出现批次选错、数量拆分不均、漏录明细等问题，严重影响出库开单效率与数据准确性。

4、客户核心需求：升级一键添加批次功能，新增按出库数量智能匹配多批次能力，系统自动按库存批次数量拆分、新增明细、循环匹配，减少人工干预，适配大批量快速出库场景。

二、【功能介绍】

问题编号：EAR-243571

更新范围：WMS-出库单-一键添加批次功能

限制条件：无限制

本次系统升级迭代，为解决大批量出库人工分批效率低、单批次匹配能力受限的问题，新增按出库数量智能多批次匹配能力

三、【使用说明】

功能路径及详细操作

1、功能入口新增

功能路径：WMS - 出库单编辑页面 - 一键添加批次

原有一键添加批次功能保留，新增独立操作按钮：【按出库数量添加】，支持智能按量多批次匹配。

2、基础通用匹配规则

1、匹配依据：系统预设库存周转规则、库位范围，对可出库批次自动排序，结合单据出库数量智能匹配；

2、库存口径：所有匹配数量均过滤锁库、冻结、过期库存，仅统计有效可出库库存；

3、规格适配：固定规格按基本数量匹配库存；浮动规格按常用数量匹配库存，并自动带出批次换算率；

4、特殊隔离：上游单据已同步携带批次号的商品明细，不应用本次按量匹配规则；

5、字段带出：匹配成功后自动带出有效日期、生产日期、有效期、库位、批次号、档案/批次换算率、容器信息。

3、核心按量匹配业务规则

场景一：总出库数量 > 单批次库存数量（多批次循环拆分）

1、自动汇总当前出库单内同商品所有明细合计出库总量；

2、优先匹配首个批次，将当前明细出库数量更新为该批次最大可出数量；

3、自动计算剩余出库数量，若无空明细则自动新增商品明细，继续匹配下一批次；

4、循环迭代匹配、新增明细、抵扣余量，直至出库剩余数量为0。

示例：商品A原有2条明细（10件、20件），总出库30件；

批次库存：批次1=5、批次2=10、批次3=20 系统自动匹配结果：

明细1：数量5，匹配批次1

明细2：数量10，匹配批次2 自动新增

明细3：数量15，匹配批次3，余量归零

场景二：总出库数量 ≤ 首个批次库存数量（单批次全覆盖）

1、多明细场景：汇总同商品全部出库数量，单批次全覆盖，自动整合数量并删除多余明细；

2、单明细场景：直接按单据出库数量匹配首个合规批次，数量保持不变。

示例1（多明细）：明细1=10、明细2=20，总30件；

批次1库存100件 结果：明细1更新为30件并匹配批次1，自动删除第二条多余明细。

示例2（单明细）：明细出库10件；

批次1库存100件 结果：直接匹配批次1，出库数量保留10件。

场景三：出库数量为0

正常按规则匹配合规批次，仅绑定批次、库位、容器等信息，不带入任何出库数量。

场景四：批次含多容器库存（容器维度优先匹配）

若同一批次下存在多个容器库存，系统按单个容器存量依次占用出库数量，精准按容器维度拆分明细匹配。

示例：总出库30件；

批次1含容器1（20件）、容器2（20件）

结果：明细1出库20件匹配批次1容器1，明细2出库10件匹配批次1容器2

场景五：总出库数量 > 全部可出库库存（库存不足兜底）

1、优先将所有可出库库存按对应批次逐一匹配、生成明细；

2、剩余无法匹配批次的出库数量，自动新增独立出库明细，仅录入余量、不绑定任何批次信息，保证单据总数量完整。

示例：出库总数量10件；

可出库存批次1=3件、批次2=4件

结果：

明细1（批次1，3件）、

明细2（批次2，4件）、

明细3（余量3件，无批次）

四、【注意事项】

1、本次新增为独立按量匹配功能，原有一键添加批次单批次匹配逻辑完全保留，新旧能力并存，不影响原有操作习惯。

2、所有批次匹配均基于实时有效库存，自动剔除锁库、冻结库存，不会匹配无效库存批次，保证出库可执行性。

3、上游携带固定批次号的明细不参与按量自动匹配，避免覆盖上游指定批次，保证特殊单据业务准确性。

4、浮动规格商品自动适配常用数量匹配，精准带出批次换算率，保证单位换算、数量统计无误。

5、支持容器级精细匹配，优先消耗单容器库存，贴合仓库容器归集、整容器出库作业场景。

6、库存不足场景自动兜底生成无批次余量明细，补齐单据数量，无需人工手动新增补录，大幅降低操作成本。

7、多明细自动合并、自动删除多余空行、自动新增明细，全程系统自动处理，减少人工干预，提升大批量出库开单效率。