一、【业务场景】

1、仓库销退收货上架场景中，拆零商品数量统一换算为整件小数展示，上架列表、明细页面均只展示小数格式数量。

2、小数展示形式不直观，仓库作业人员无法快速识别实际上架整件、拆零真实数量，需要手动切换单位才能核对真实数据，操作繁琐、核对效率低。

3、系统缺少整件+拆零分开展示能力，不符合现场上架作业快速看数、快速核对、快速上架的作业习惯，容易出现看错数量、上架失误等问题。

4、客户核心需求：优化仓配App上架页面数量展示逻辑，支持拆零商品整件、拆零数量分开展示，无需频繁切换单位，适配现场高效上架核对作业。

二、【功能介绍】

问题编号：EAR-247551

更新范围：仓配App-上架模块（上架列表、批量上架、上架明细、按容器商品定制页面）

限制条件：无限制

本次系统升级迭代，为解决拆零商品上架数量展示不直观、核对困难的问题，优化上架全场景数量展示规则。

三、【使用说明】

功能路径及详细操作

1、仓配App-上架-新增展示参数

功能路径：仓配App → 上架模块

参数规则：

1、新增筛选项：【按整件+拆零单位展示】，默认=false（默认关闭，沿用旧逻辑）；

2、记忆规则：参数配置按 用户+设备 维度记忆，切换设备/账号重置默认值；

3、全局生效：开启后对上架列表、批量上架、上架明细、定制上架页面统一生效。

2、上架列表展示规则

1、参数=false：所有商品沿用原有逻辑，统一展示换算后小数数量；

2、参数=true：自动判断商品拆零属性：

- 拆零商品：上架数量展示为「整件数量（整件单位）+ 拆零数量（拆零单位）」，不再展示小数；

- 整件商品：保持原有采购单位展示规则不变；

3、生效范围：按容器展示、按商品展示两种视图均适配。

3、批量上架展示规则

1、开启【按整件+拆零单位展示】参数后，适配批量上架场景；

2、拆零商品拆分展示整件+拆零数量，整件商品维持原有展示；

3、生效范围：按容器、按商品批量上架视图全覆盖。

4、上架明细列表展示规则

1、整件商品：完全保留现有逻辑，仅展示采购单位数量，支持正常切换单位；

2、拆零商品：数量字段拆分为「整件数量、拆零数量」双字段展示，分别对应整件单位、拆零单位；

3、单位权限：整件单位、拆零单位均支持手动切换单位，保留灵活改数、看数能力。

5、定制页面适配

长沙好玩零食定制【按容器商品上架】页面，完整应用【按整件+拆零单位展示】参数逻辑，与标准上架页面展示规则保持统一。

四、【注意事项】

1、参数默认关闭，默认沿用历史小数展示逻辑，不影响原有作业习惯，按需开启即可。

2、本次优化仅针对拆零商品生效，整件商品展示逻辑、单位切换、数量计算完全不变，保证业务稳定。

3、参数基于用户+设备维度记忆，更换登录设备或账号后会恢复默认关闭状态，需重新按需开启。

4、拆分展示仅优化前端展示效果，不改变后台实际库存数量、换算逻辑、上架扣库逻辑，数据精准无影响。

5、全场景统一口径，上架列表、批量上架、明细、定制页面规则一致，避免多页面展示不一致问题。

6、拆分后的整件、拆零字段均支持单位切换，保留原有灵活操作能力，兼顾直观展示与自定义查看需求。