一、【业务场景】

1、使用标准WMS入库订单的客户，当采购订单商品由非标WMS商品调整为标准WMS商品后，已生成的入库订单明细不会自动补入对应商品，需手动点击入库订单页面「刷新商品」重新计算明细数据。

2、商品WMS类型变更后，入库订单明细无法及时同步最新商品范围，导致后续生成收货任务、入库数量统计、入库订单查询结果出现偏差，数据准确性不足。

3、原有入库订单列表采用全量查询后内存筛选分页的方式，生成状态、收货状态、入库状态等落库字段未参与数据库层查询，易出现列表数量、分页、合计数据不一致的问题。

二、【功能介绍】

问题编号：EAR-276103

更新范围：WMS入库订单模块（刷新商品功能、列表分页查询）

限制条件：仅上游同步的入库订单支持刷新商品操作；已生成收货任务的商品类型变更不隐藏明细；列表状态字段均参与数据库层查询。

本次系统升级迭代，针对入库订单商品类型变更不同步、列表分页数据不一致等痛点，优化刷新商品重算逻辑与列表查询机制。

三、【使用说明】

功能路径及详细操作

1、入库订单刷新商品功能优化

功能路径：WMS - 入库订单

1、按钮交互优化 - 鼠标悬停「刷新商品」按钮展示注释：刷新商品可重新同步符合条件订单商品明细、单据状态。仅上游同步单据支持操作； - 非进销存采购订单来源的入库订单，刷新按钮置灰不可操作。

2、适用范围优化 已生成收货任务的入库订单也支持执行刷新商品操作，不再限制仅未生成任务的单据可刷新。

3、刷新重算规则 - 点击刷新后，按当前关联采购订单明细重新计算入库订单明细，将符合标准WMS条件的商品同步至入库订单明细；

• 重算后商品字段统一按上游单据数据更新，覆盖数量、基本单位、基本数量、赠品单位、赠送数量、生产日期、实收数量、实收赠品数量、实收基本数量、备注、单价、金额等；

• 刷新后新增及重算的商品，入库状态重置为未入库，是否生成标记为否； 

•  不满足同步条件的商品，仍保留对应明细展示；

• 原有刷新商品规则保持不变，若本次调整与现有规则存在差异，以现有刷新商品规则为准。

采购订单：

入库订单：

生成收货任务，商品档案修改非标商品为标品

4、单据信息同步规则 刷新商品新增商品明细时，同步重算单据的生成状态、收货状态、入库状态及入库订单汇总数据，保证单据头与明细数据一致。

5、商品类型双向变更处理 - 非标WMS转标准WMS：

• 符合条件的商品同步进入入库订单明细，按上游数据更新对应字段；

• 标准WMS转非标WMS：判断商品业务生成关系，若已生成收货任务，不隐藏该商品明细，固定保留展示；

• 若未生成收货任务，自动隐藏对应商品明细，不展示在列表中。

2、入库订单列表分页查询优化

1、原有逻辑：列表先全量查询数据，再通过内存筛选条件过滤后分页，易导致分页数量、合计值与实际数据不符；

2、优化后逻辑：调整为数据库层真分页查询，生成状态、收货状态、入库状态等已落库状态字段全部参与SQL查询，从数据源头过滤结果；

3、优化后列表分页数量、每页数据、合计值完全匹配，查询效率与数据准确性同步提升。

四、【注意事项】

1、「刷新商品」仅支持上游进销存采购订单来源的入库订单，手工创建等非上游同步单据按钮置灰，无法执行刷新操作。

2、刷新商品操作以现有入库订单同步规则为核心，本次仅补充商品WMS类型变更后的重算能力，不改变原有同步规则与字段映射逻辑。

3、标准WMS转非标WMS场景下，已生成收货任务的商品明细不隐藏、不删除，保证已产生的业务数据完整可追溯；未生成收货任务的商品自动隐藏，符合商品范围管控要求。

4、刷新后新增及重算的商品入库状态重置为未入库，不影响已生成的收货任务数据，需重新生成收货任务的可手动操作。

5、列表优化为真分页查询后，状态筛选、分页、合计数据完全一致，查询性能更稳定，原有筛选条件的使用方式无变化。

6、本次优化仅调整刷新商品重算逻辑与列表查询机制，不改动入库订单审核、收货任务生成、库存入库等核心业务流程，系统运行稳定可靠。