.jpeg)
一、【业务场景】
1、采购入库作业中会产生商品赠送数量，后续出现多入、多余赠品等场景时，业务需要通过采退流程完成赠品退回出库。原有采退业务链路仅支持常规商品数量处理，未适配赠送数量相关字段与流转逻辑。
2、当采退单据包含赠送数量时，系统无法识别、无法正常处理赠品退货，导致采退出库单
3、现有采退订单、采退任务、退货分拣全流程缺失赠送数量链路，从订单创建、任务生成、分拣拣货、出库同步到上游回传，均无赠品数量管控能力，无法支撑赠送商品的标准化采退作业。
4、客户核心需求：补齐采退全链路赠送数量字段，区分常规数量与赠送数量双维度数据流转，实现赠品采退可建单、可拣货、可出库、可同步上游，完善采退业务闭环，解决进销存回传失败问题。
二、【功能介绍】
问题编号：EAR-263177
更新范围：WMS采退订单、WMS采退任务、仓配App退货分拣拣货全流程、采退出库单、上游数据同步链路
限制条件：无限制
本次系统升级迭代，针对采退流程无赠送数量链路、赠品退货无法流转、回传进销存失败、业务无法闭环等痛点，全流程补齐赠送数量字段与计算规则，实现常规数量、赠送数量双维度独立管控与联动展示。
三、【使用说明】
功能路径及详细操作
1、WMS-采退订单页面字段新增
功能路径：WMS - 采退订单 - 新增/编辑页面
1、页面新增「赠送数量」「赠送基本数量」两个字段；
2、赠送数量：默认展示，单位跟随当前行「采购单位」字段；
3、赠送基本数量：默认隐藏，系统自动计算，计算规则=赠送数量 × 采购单位对应换算率；
4、任务生成规则：采退订单存在赠送数量时，生成采退任务自动同步至任务「赠送计划数量」字段，完成订单到任务的数据透传。
2、WMS-采退任务列表字段新增与计算规则
功能路径：WMS - 采退任务 - 采退任务Tab / 采退明细Tab
2.1 采退任务Tab新增字段
1、新增「赠送计划数量」：多订单生成同一任务时，自动合计对应商品所有订单赠送数量，按采购换算率统一换算展示，列表支持合计行统计；
2、新增「赠送已拣数量」：实时统计采退明细回传的已拣赠送数量数据，支持合计行统计；
3、新增「赠送差异数量」：系统自动计算，规则=赠送计划数量 - 赠送已拣数量。
2.2 采退明细Tab新增字段
1、明细列表新增「已拣赠送数量」列，数据来源为仓配App退货分拣拣货提交回传数据；
2、字段单位跟随当前行采购单位，页面支持合计行汇总统计。
2.3 任务作废规则
采退任务存在赠送计划数量时，执行作废操作后，系统自动扣减对应商品赠送计划数量，保证数据账实一致。
3、仓配App-退货分拣-拣货列表
功能路径：仓配App - 退货分拣 -拣货列表
1、原有数量展示规则：仅展示常规已拣数量/计划数量；
2、全新展示规则：数量展示=（已拣数量+已拣赠送数量）/（计划数量+计划赠送数量），合并统计常规与赠品总量，真实反馈整体拣货进度。
4、仓配App-退货分拣-拣货录入页面
功能路径：仓配App - 退货分拣 - 采购录入 - 拣货录入页面
1、页面新增「赠送数量」输入框；
2、默认自动带入当前任务对应商品的赠送计划数量，支持人工修改；
3、提交拣货明细后，录入的赠送数量自动回传保存至后台「已拣赠送数量」字段；
4、页面顶部拣货任务数量统计同步兼容赠品，采用总量合并展示规则。
5、仓配App-退货分拣-拣货明细
功能路径：仓配App - 退货分拣 - 采购录入 - 拣货明细页面
1、原有拣货数量=常规已拣数量；
2、全新规则：拣货数量=常规已拣数量 + 已拣赠送数量，明细总量数据完整准确。
6、仓配App-退货分拣-提交出库赠品流转规则
1、拣货明细存在赠送数量数据时，提交作业生成出库单；
2、系统自动将拣货明细中的赠送数量数据同步至出库单对应赠送字段；
3、完成出库单数据同步后，正常回传进销存，解决赠品采退回传失败问题。
四、【注意事项】
1、本次迭代为全链路能力补齐，完全兼容原有常规数量采退流程，非赠品采退场景作业逻辑、数据流转无变更，存量业务稳定不受影响。
2、赠送数量字段展示、录入完全受「PDA收货启用赠送数量」参数控制，参数关闭时页面无多余字段展示，保持页面简洁。
3、所有新增赠品数量字段均支持合计统计、差异计算，数据口径统一、计算逻辑严谨，保证采退任务数据精准可追溯。
4、任务作废场景自动扣减赠送计划数量，避免无效数据滞留，保证后台台账数据准确、账实相符。
5、前端页面采用「常规+赠送」合并总量展示、后台双向独立存储的模式，既满足员工直观读数需求，又保证业务数据精细化区分管控。
6、打通采退订单、任务、分拣、出库、上游回传全链路赠品流转，彻底解决赠品采退回传进销存失败问题，完善采退业务闭环。
7、本次优化仅新增赠品数量字段、统计规则与流转逻辑，不改动原有采购、采退、出库核心业务流程，系统运行稳定无风险。
