一、【业务场景】

1、门店强配商品包含新品、赠品、促销品等特殊品类，业务端需要通过添加商品备注，告知门店该类商品为非门店主动要货商品，用于区分常规订货、辅助门店收货认知。

2、原有系统存在备注链路断层问题，商品自带备注无法同步至WMS出库单、调出单，门店在调入单页面无法查看对应的商品备注信息。

3、门店收货时无法识别强配商品的来源、属性及特殊说明，不清楚商品为主动要货还是后台强配，容易产生收货疑问、客诉纠纷，增加售后沟通成本。

4、缺少备注全链路透传能力，特殊商品无业务说明标注，门店收货核对、后续销售处理、账务核对均存在不便，影响整体交付体验。

5、客户核心需求：优化拣货、集货、复核、出库全链路逻辑，实现强配商品备注全程保留、拼接、透传，最终同步至出库单明细，保证门店可正常查看备注信息，完善业务说明、规避客诉。

二、【功能介绍】

问题编号：EAR-245328

更新范围：仓配App（拣货、集货、复核）、WMS出库单全发车场景

限制条件：无限制

本次系统升级迭代，为解决强配商品备注无法下游透传、单据备注断层、门店无法识别特殊商品的问题，打通拣货-集货-复核-出库全链路备注同步能力。

三、【使用说明】

功能路径及详细操作

1、仓配App-拣货-集货（备注留存与拼接规则）

功能路径：仓配App → 拣货 → 集货操作

数据落底规则：

1、集货操作时，系统自动抓取上游商品备注，完整保留并同步至复核模块；

2、备注信息依次赋值底层关联链路：出库单明细、拣货任务明细、集货明细，保证全链路数据一致。

合并拣货参数差异化规则：

（1）PDA拣货同客户合并拣货任务=true

1、同客户、不同订单同时生成波次计划单，会合并至同一个拣货任务内；

2、多订单、多商品备注自动以分号拼接，并自动去重处理；

3、同一拣货任务下多个商品批次明细，统一赋值拼接后的完整备注。

示例：订单1备注123、订单2备注345，合并后拣货任务备注展示：123；345，所有关联批次同步该备注。

（2）PDA拣货同客户合并拣货任务=false

1、同客户不同订单分批次生成波次计划单，拆分为独立拣货任务、独立分拣；

2、各任务单独保留自身订单备注，互不干扰、不拼接。

2、仓配App-复核（批次维度备注留存，页面上不展示）

功能路径：仓配App → 复核

执行规则：

1、复核页面按商品批次号维度读取并展示备注；

2、备注数据来源为前置拣货明细留存数据，保证批次与备注一一对应，精准无误。

3、WMS-出库单（全场景备注同步生成）

功能路径：全场景出库、发车、复核生成出库单流程

同步范围全覆盖：

1、仓配App集货生成出库单、仓配App发车；

2、WMS发车任务发车、WMS装车单发车；

3、WMS集货复核-复核明细Tab、复核汇总Tab生成出库单场景。

生成规则：只要拣货明细存在备注内容，生成出库单商品明细时自动同步对应备注，下游调出单、门店调入单均可查看。

4、特殊校验规则

1、字符截断：备注拼接后若超出数据库字段最大字符限制，系统自动截断超长内容，避免报错；

2、全链路透传：最终备注可正常同步至上游对应单据，完成门店端展示闭环。

四、【注意事项】

1、合并拣货场景支持多备注自动拼接+去重，避免出现重复备注冗余展示，保证单据备注简洁规范。

2、所有批次明细统一同步对应拣货任务备注，保证同一任务下所有批次备注信息一致，无遗漏、无差异。

3、区分合并拣货与非合并拣货参数逻辑，两种模式备注处理规则独立，互不冲突，适配所有作业模式。

4、超长备注自动截断，规避字段超长导致的生成失败、数据异常问题，保障出库单正常生成。