一、【业务场景】

1、门店退回中心仓的货物无品类区分，收货环节商品混杂堆放，无法快速按品类分拣归类。同时退货货物普遍存在数量缺失、混货、过期、污损等异常情况，现场收货、拣货作业出现缺货、异常货品时，系统无任何原因记录入口，问题无法留存、无法追溯。

2、原有销退收货、拣货标记缺货流程无备注、无原因选择功能，作业人员遇到缺货、拒收异常时无法录入问题原因，后续复盘、对账、追责无数据依据。且销退收货商品明细缺少品类相关字段，收货人员无法快速区分商品品类，分货分拣效率低。

3、日常拣货作业中频繁出现大面积缺货、货品异常情况，由于系统无标准化原因留存机制，无法统计异常高发原因、无法定位问题环节，不利于仓库规范管理、问题整改与作业质控。

4、客户核心需求：搭建全流程异常原因溯源体系，新增拣货缺货、销退拒收标准化原因管理，支持配置是否必填；优化销退收货字段展示与状态名称，实现异常原因留存、回传、溯源；同时适配中心仓与前置仓双场景，完善异常作业管控能力。

二、【功能介绍】

问题编号：EAR-260377

更新范围：WMS标准管理原因管理、WMS前置仓原因管理、WMS销退任务、WMS拣货任务、仓配App销退收货、仓配App拣货、前置仓App拣货

限制条件：无限制

本次系统升级迭代，针对销退收货无品类区分、异常无记录、缺货拒收无溯源依据、作业异常无法复盘等痛点，全新搭建标准化原因管理模块，统一缺货、拒收异常流程，补齐品类展示字段，实现全链路异常可记录、可回传、可追溯。

三、【使用说明】

功能路径及详细操作

1、WMS-标准管理-原因管理（原“冻结原因”升级）

功能路径：WMS - 标准管理 - 原因管理

1、模块名称由「冻结原因」修改为「原因管理」，页面包含三大Tab：冻结原因、拣货缺货原因、销退收货拒收原因；

2、通用操作：所有Tab均支持新增、修改、删除、数据展示，列表按原因代码正序排序；

3、权限同步更新，控制页面查询、新增、编辑、删除操作权限。

1.1 拣货缺货原因 Tab

1、新增「拣货缺货设置」：控制仓配App拣货标记缺货是否必选原因，默认不必填；

2、新增原因规则：原因代码为数字输入（最大20位），原因文本最大50位；

3、保存校验：代码重复、原因文本重复均弹窗提示，禁止重复保存。

1.2 销退收货拒收原因 Tab

1、新增「销退收货拒收设置」：控制仓配App销退收货标记拒收是否必选原因，默认不必填；

2、新增原因规则：原因代码为数字输入（最大20位），原因文本最大50位；

3、保存校验：代码重复、原因文本重复均弹窗提示，禁止重复保存。

2、WMS-销退任务列表优化

功能路径：WMS - 销退任务

1、列表新增「拒收原因」字段，默认隐藏，数据来源于App端标记拒收时选择的原因；

2、标记拒收的商品数据，自动将拒收原因回传至上游内部申请单/售后申请单对应商品的批复备注字段；

3、查询条件「入库状态」选项由「缺货」修改为「拒收」；

4、列表「入库状态」展示文字由「缺货」修改为「拒收」，同步修复全部历史数据，统一状态口径。

3、仓配App-销退收货流程优化

功能路径：仓配App - 销退收货

1、按钮文字改造：「标记缺货」改为「标记拒收」、「取消标记缺货」改为「取消标记拒收」；

2、操作提示改造：标记成功提示「标记拒收成功」，取消成功提示「取消标记拒收成功」；

3、页面状态改造：标记后商品状态展示为「拒收」；

4、原因弹窗规则：读取后台销退收货拒收设置，必填状态下弹出单选拒收原因弹窗，未选择禁止确认；不必填状态下直接标记拒收，无需选择原因；

5、弹窗来源：下拉选项取自WMS标准管理拒收原因列表，默认空值、单选选择；

6、商品明细新增字段：新增「WMS类别」「部门」字段，数据取自商品档案，用于收货快速品类分货。

4、WMS-标准管理-拣货任务字段新增

功能路径：WMS - 标准管理 - 拣货计划 - 拣货任务Tab

1、列表新增「缺货原因」字段，默认隐藏；

2、数据来源：仓配App拣货页面标记缺货时回传的标准化原因，用于后台数据追溯。

5、仓配App-拣货缺货原因选择流程

功能路径：仓配App - 拣货

1、点击「标记缺货」读取后台拣货缺货原因设置；

2、设置为必填：弹出缺货原因单选弹窗，选项取自后台拣货缺货原因列表，未选择禁止确定，确认后回传原因至后台拣货任务；

3、设置为不必填：无弹窗，直接标记缺货，无需填写原因。

6、WMS-前置仓管理-原因管理

功能路径：WMS - 前置仓管理 - 原因管理

1、页面默认空数据，支持新增、修改、删除，列表按拣货缺货原因代码正序排序；

2、内置「拣货缺货原因」Tab，提供「拣货缺货设置」，控制前置仓App拣货缺货原因是否必填，默认不必填；

3、新增原因校验规则与中心仓一致，代码、文本长度限制统一，重复数据拦截提示统一；

4、配套独立权限控制页面操作。

7、WMS-前置仓拣货任务字段新增

功能路径：WMS - 前置仓管理 - 拣货任务 - 拣货任务Tab

1、列表新增「缺货原因」字段，默认隐藏；

2、数据来源：前置仓App拣货标记缺货时回传的原因数据，用于前置仓作业异常追溯。

8、前置仓App-拣货流程适配

功能路径：前置仓App - 拣货

1、标记缺货逻辑跟随前置仓后台原因设置；

2、必填状态弹出缺货原因单选弹窗，选择后确认标记并回传后台；取消则不生效；

3、不必填状态直接标记缺货，无需选择原因；

4、弹窗选项取自前置仓原因管理配置数据，默认空、单选、必填校验。

四、【注意事项】

1、本次整体迭代统一术语口径，将原有销退收货「缺货」状态全面替换为「拒收」，前端展示、后台字段、查询条件、历史数据全部同步修复，保证数据口径统一无歧义。

2、中心仓与前置仓原因管理数据相互独立、互不互通，各自维护对应缺货原因配置，分别控制对应App作业流程，场景隔离清晰。

3、所有原因新增均做代码、名称双重唯一校验，防止重复数据导致的选择混乱、统计不准问题，保证基础数据规整。

4、原因必填设置默认关闭，完全兼容原有作业习惯，客户可根据自身管控需求手动开启强制校验，灵活适配宽松/严格两种作业模式。

5、销退拒收原因支持自动回传上游售后、内部申请单批复备注，实现从收货异常到上游单据的全链路追溯。

6、新增WMS类别、部门字段仅做品类展示辅助分货，不改动原有销退收货业务逻辑，不影响原有单据流转。

7、缺货原因、拒收原因列表字段默认隐藏，不改变原有页面展示样式，需要追溯数据时手动开启即可，兼顾页面简洁与业务追溯需求。

8、弹窗均为单选必填控制，严格跟随后台参数配置，无参数配置漏洞，管控逻辑严谨统一。