.jpeg)
一、【业务场景】
1、当前零售App未提供完整的WMS生鲜属性维护入口，商品档案、条码、保质期、体积及分拣属性等信息分散在不同接口维护，无法覆盖WMS商品完整属性字段，容易造成App端与Web端数据不一致、校验规则不统一。
2、仓库现场无法通过移动端及时维护、调整WMS商品属性，依赖Web端操作，时效性不足，影响现场作业效率与数据准确性。
3、客户核心需求：在零售App商品明细页新增WMS生鲜属性入口，上线独立的WMS生鲜属性维护页面，字段与交互对齐Web端WMS商品档案，统一复用后端WMS商品校验规则与数据模型，实现移动端完整维护WMS生鲜属性，保证两端数据与规则一致，支撑现场快速维护商品资料。
二、【功能介绍】
问题编号：EAR-277253
更新范围：零售App商品档案-商品明细页、零售App新增WMS生鲜属性页面、WMS商品属性接口、权限与操作日志
限制条件：字段、交互、校验规则与Web端WMS商品档案保持一致；复用WmsPosItemRpcDTO数据模型；修改操作受权限控制并留存操作日志。
本次系统升级迭代，针对移动端WMS商品属性维护入口缺失、字段不全、两端规则不一致等痛点，新增移动端全量WMS生鲜属性维护能力。
三、【使用说明】
功能路径及详细规则
1、零售App-商品档案-商品明细入口
功能路径：零售App - 商品档案 - 商品明细
1、页面右上角新增「WMS生鲜属性」按钮，具体页面文件及对应项目开发前确认；
2、点击按钮跳转至独立的「WMS生鲜属性」页面；
3、权限控制：需配置「WMS-零售App-WMS生鲜属性-编辑」权限才可进入编辑；
4、操作日志：修改WMS属性后自动记录日志，操作模块为商品档案，操作动作为修改，操作平台为乐檬零售APP，操作日期标记为修改WMS属性。
2、零售App-WMS生鲜属性页面
页面标题为「WMS生鲜属性」，交互规则与Web端WMS商品档案一致；进入页面调用WMS接口，直接读取WMS档案预设参数。
2.1 顶部基础信息
页面顶部固定展示商品代码、商品名称、基本条码三项基础信息。
2.2 WMS类型
可选值：标准WMS、非标WMS；
可选范围受基本参数、默认WMS类型规则控制，与Web端一致。
2.3 采购属性
默认值为空；
可选值：市场自采、直配商品、供应商直供；
联动规则：采购属性从「直配商品」切换为其他采购模式时，页面自动将「供应商配送」置为不可选。
2.4 作业开关类字段
均为勾选框，默认不勾选：
隔天采购
隔天配送
配货忽略库存
拣货忽略库存
附属商品：已被其他商品作为附属商品使用的商品，取消附属标记时触发后端关联关系校验，存在有效关联关系时不允许直接取消。
2.5 供应商配送
仅采购属性为「直配商品」时，控件允许勾选；
默认不勾选。
2.6 仓储位置
文本输入框，默认为空，支持手动维护。
2.7 包装规格
页面展示商品当前包装规格及对应单位信息；
包装规格单位沿用Web端已有单位，不允许输入系统不存在的单位；
包装规格数值为数字输入，必须大于0；为空或小于等于0时禁止保存。
2.8 辅助量单位
用于维护除基本单位外的辅助计量单位：
支持按Web端规则新增或修改辅助量单位；
辅助量单位字符长度不能超过50，超出长度禁止保存并提示具体校验原因；
辅助量单位为空时，按Web端规则允许为空；若其他包装规格或换算字段依赖辅助量单位，保存时强制校验关联字段完整性。
2.9 收货皮重
默认不勾选；勾选后允许维护收货皮重规则与皮重值；
规则选择「固定」：收货皮重值按实际重量保存，例：值为2表示收货时按固定皮重2处理；
规则选择「比例」：收货皮重值必须在0到1之间，超出范围禁止保存；
取消勾选收货皮重时，自动隐藏「皮重规则」「收货皮重比例/收货皮重固定」行；
切换皮重规则时，清空原有皮重数值。
2.10 分拣皮重
默认值：预设皮重、比例、0%；
选择「单件皮重」：自动隐藏「皮重规则」「收货皮重比例/收货皮重固定」「分拣皮重强制显示」行；
选择「预设皮重」：允许维护预设皮重规则、预设皮重数值及强制显示状态；
规则为「比例」时，预设皮重值必须在0到1之间；
规则为「固定」时，预设皮重值按实际重量保存；
「强制显示」：默认不勾选。
四、【注意事项】
1、本次新增的WMS生鲜属性页面，字段、交互逻辑、校验规则均与Web端WMS商品档案保持一致，两端数据标准统一，不会产生规则差异。
2、功能受权限控制，仅分配「WMS-零售App-WMS生鲜属性-编辑」权限的账号可修改属性，无权限账号仅可查看或无法进入页面。
3、所有修改操作自动留存操作日志，操作人、操作时间、修改内容可追溯，符合数据管理要求。
4、取消商品「附属商品」标记时，系统会自动校验后端关联关系，存在有效附属关联的商品不允许直接取消，避免业务数据异常。
5、所有数值类、文本类字段均执行与Web端一致的校验规则，包括包装规格大于0、比例类皮重在0-1之间、辅助量单位长度不超50字符等，不符合规则无法保存，保证数据规范性。
