一、【业务场景】

1. 客户销售退货过程中，存在两种退货单位场景：部分客户按商品基本单位退货，部分客户按常用单位退货，两种退货单位需同步适配系统展示及操作流程。

2. 核心业务痛点：内部申请单中显示的退货单位为常用单位（如件），但订单流转至WMS系统后，仅显示基本单位数量，未同步显示常用单位及常用单位数量；同时，仓配App（PDA）收货界面也仅能看到基本单位数量，导致仓库收货人员无法直观对应内部申请单的退货要求，易出现收货数量混淆、换算失误等问题，影响销退收货效率。

3. 客户核心需求：将内部申请单中的常用单位、基本单位及对应数量，同步带入乐檬WMS系统；在销退订单、销退任务中新增内部申请单的常用单位和申请数量；在仓配App（PDA）收货界面，同步显示常用单位及对应申请数量、收货数量，确保收货操作与内部申请单一致，提升销退收货准确性和效率。

       期望目标和解决方案：期望解决销退流程中常用单位及常用数量未同步显示、收货人员无法直观核对退货申请的问题；解决方案为在销退订单、销退任务、仓配App销退收货全流程中，嵌入常用单位和常用数量相关字段，同步内部申请单的单位及数量信息，优化差异数量计算规则，确保单位展示统

二、【功能介绍】

问题编号：http://jira.nhsoft.cn:8080/browse/EAR-227123

更新范围：新WMS（销退订单、销退任务）、仓配App（销退收货-商品列表、商品明细）

限制条件：无限制

本次系统升级迭代，为解决销退流程中常用单位及数量未同步显示、收货核对不便的问题，完善销退收货全流程单位展示，提升收货准确性和效率，对新WMS及仓配App相关模块进行优化改造，主要功能包括：

1. 新WMS-销退订单-单据明细改造：将原有“退货数量”字段名称修改为“基本数量”（规则：内部申请单申请退货的基本单位数量）；将原有“单位”字段名称修改为“基本单位”（规则：内部申请单的申请基本单位）；新增“常用单位”列（规则：内部申请单的设置单位）；新增“常用数量”列（规则：取内部申请单的退货数量）（原型参考指定链接）。

2. 新WMS-销退任务-销退任务tab改造：将原有“退货数量”字段名称修改为“销退基本数量”；将原有“收货数量”字段名称修改为“收货基本数量”；新增“收货数量”列；新增“常用单位”列；新增“销退申请数量”列；优化差异数量计算公式，差异数量=销退申请数量(常用单位)-收货数量(常用单位)

3. 新WMS-销退任务-销退明细tab改造：将原有“退货数量”字段名称修改为“退货基本数量”；将原有“收货数量”字段名称修改为“收货基本数量”；新增“收货数量”列；新增“收货单位”列

4. 仓配App-销退收货-商品列表改造：商品名称展示规则优化

5. 仓配App-销退收货-商品明细改造：右上角“退货数量”展示规则优化，原规则为“XX（基本单位）”，新规则为“XX（常用单位）”（取web端销退任务-销退任务tab的“常用单位”）；商品录入时的“收货数量”展示规则优化，原规则为“XX（基本单位）”，新规则为“XX（常用单位）”，允许切换其他单位，切换后自动换算对应基本单位数量。

✧ 功能详情：本次功能改造核心是将内部申请单的常用单位、常用数量同步至销退全流程，优化字段命名及展示规则，新增必要字段，调整差异数量计算逻辑，确保WMS端与仓配App端单位、数量展示统一，适配客户按基本单位/常用单位退货的场景。具体规则如下：

三、【使用说明】

功能路径：

1. 新WMS销退订单查看路径：新WMS-销退订单-进入对应单据-单据明细页-查看“基本数量”“基本单位”“常用单位”“常用数量”（均取自内部申请单，不可修改）

   内部申请单，申请数量=1，单位=箱，申请基本数量=100，基本单位=公斤

   

   销退订单-明细，常用数量=1，常用单位=箱，基本数量=100，基本单位=公斤

   

2. 新WMS销退任务查看路径：新WMS-销退任务-进入对应任务-销退任务tab页-查看“销退基本数量”“收货基本数量”“收货数量”“常用单位”“销退申请数量”及差异数量；销退明细tab页-查看“退货基本数量”“收货基本数量”“收货数量”“收货单位”

   销退任务-销退任务tab，销退申请数量=1，常用单位=箱，销退基本数量=100，差异数量=1-0=1，差异数量添加注释

   

   仓配app收货5件后，收货数量=0.5（按常用单位转化），收货基本数量增加注释，差异数量=1-0.5=0.5

   

3. 仓配App销退收货-商品列表操作路径：仓配App-销退收货-选择对应销退任务-商品列表页-查看商品名称（含常用单位）、退货数量（销退申请数量）、收货数量（常用单位）-录入实际收货数量（常用单位）。

   销退任务-销退明细tab，收货单位=件（实际提交单位），新增“收货数量”列，收货数量=5（实际提交数量），收货基本数量=50

   

   

4. 仓配App销退收货-商品明细操作路径：仓配App-销退收货-商品列表-点击对应商品进入商品明细-查看右上角退货数量（常用单位）-在收货数量录入框录入实际收货数量（常用单位，可切换其他单位）-提交收货。

   

   收货单位默认=箱（常用单位），可切换其他单位

四、【注意事项】

1. 常用单位、常用数量、基本单位、基本数量均取自内部申请单，系统自动同步，不可手动修改，确保与内部申请单数据一致。

2. 销退任务中，差异数量按常用单位计算（销退申请数量-收货数量），需注意区分常用单位与基本单位，避免混淆差异数据。

3. 仓配App收货时，收货数量默认按常用单位录入，可切换其他单位，切换后系统会自动按换算率同步基本单位数量，无需手动换算。