加值属性

加值属性是给商品挂的「可选项」：一杯奶茶要选温度、甜度、加料，一个蛋糕要选尺寸、奶油。它不是一条条写在物料上的字段，而是先建成属性组（温度组、甜度组、加料组），组里再列属性值（正常冰、去冰、珍珠），最后把组关联到商品上。前台点单时按商品带出这些组，顾客选哪个就加多少钱，全部由这张表驱动。

功能路径：基础设置 → 加值属性

一、功能概述

1. 核心用途

1. 定义前台可选的规格与加料：温度、甜度、尺寸、奶油、加料、茶底这类「同一单品下的多种选择」都在这里维护，不必为每种组合另建物料；
2. 给选项定价：每个属性值带一个加价（元），如「珍珠(1.00元)」「四季春(1.00元)」「6寸动物奶油(158.00元)」，不加价的选项写 0.00 元；
3. 控制可选规则：一个组允不允许同时选多个值、最多选几个、是否必选、用勾选还是份数步进，都在属性组这一层定义；
4. 一次建组、多商品复用：组与商品是多对多关系，清单的「关联商品数」列显示该组被多少商品引用；「同步至所有商品」用于把组内改动一次性推到全部已关联商品。

2. 与其他功能的关系

功能	关系
物料管理	属性组最终挂在物料上；物料决定前台下单时出现哪几组属性
商品分类	分类的「属性配置」用于给一类商品统一带出属性组，避免逐个物料勾选
搭售商品	同为前台下单时的附加选择，区别是搭售带的是另一个商品，加值属性带的是规格/加料
云店通 / 小程序点单	消费方。前台下单页的选项行、加料行、份数加减按钮，全部来自本功能

二、界面布局说明

1. 清单页

元素	说明
工具栏	【+ 新增】【删除】【回收站】
搜索框	按属性组名称或属性名称定位
列	序号、属性组名称、属性名称、关联商品数
属性名称列	该组下所有属性值的汇总串，格式为 值名称(加价元)，用中文逗号连接，过长时截断显示
组名链接	属性组名称是蓝色链接，点它直接打开该组的「编辑」窗口
行首复选框	勾选后可用工具栏【删除】批量删组

示例账套的 7 个组：温度（正常冰/去冰/少冰/温，均 0.00 元）、甜度（七分甜/五分甜/三分甜/十分甜/不另外加糖）、茶底（红茶 0.00、绿茶 0.00、四季春 1.00）、奶油（6 寸动物奶油 158.00、6 寸植物奶油 188.00、8 寸动物奶油 168.00……）、尺寸（6 寸/8 寸/10 寸，均 0.00）、加料（抹茶浓度 1.00、抹茶麻薯 3.00、珍珠 1.00、小丸子 2.00、西米 1.00……）、SMOKE温度组（SMOKE 常温 0.00、SMOKE 烫 0.10、SMOKE 冰 0.20）。

2. 编辑窗口

点【新增】或点组名链接打开标题为编辑的弹窗，分上下两块，底部是【取消】【保存】：

上块「属性项信息」

字段	控件	说明
属性组名称	输入框，带 *	必填，清单与前台显示的组名
排序	数字框	默认 0，控制同一商品上多组的显示先后
属性值多选	复选框「启用」+「最多可选」输入框	占位提示「不填=不限」；下方说明原文：「该属性支持选择多个属性值，比如一杯奶茶可以添加布丁，珍珠等多种配料。」
属性值必选	复选框「启用」	下方说明原文：「启用后，该属性为用户下单必选内容。」
选择形态	下拉，默认「勾选式（点选 0/1 份）」	另一项为「份数步进（每值可加多份）」；配「每值最大」输入框，占位「不限」。说明原文：「份数步进需先启用「属性值多选」（初始不加、按份数加价，适合加料/配料）。」

下块「属性列表」

• 块标题旁有【回收站】和橙色的【同步至所有商品】按钮；
• 表格列：# | 属性名称 | 加价(元) | 关联产品 | 线上隐藏 | 是否打包 | 默认选择 | 排序；
• 新建时表体显示「暂无属性值，+ 添加属性值」，点【+ 添加属性值】追加一行。

三、业务操作步骤

步骤 1：规划属性组

按「顾客点这一类商品时要做什么选择」来分组，一类选择一个组：温度、甜度、加料各一组，不要把「常温/去冰/珍珠」混进同一组。组名要能自解释，前台会把它直接显示成选项行的标题。

步骤 2：新建组并设可选规则

基础设置 → 加值属性 →【+ 新增】：

1. 填属性组名称（必填）、按需调整排序；
2. 加料、配料这类可以同时要几样的，勾选属性值多选，需要限制种类数时在最多可选里填数字，留空即「不填=不限」；
3. 温度、甜度这种必须选一个的，勾选属性值必选，否则顾客可以不选就下单；
4. 加料按份加钱（珍珠 2 份）时，把选择形态改为「份数步进（每值可加多份）」——注意它要求先启用「属性值多选」，未启用时该形态不可用；单份 0/1 勾选保持默认「勾选式」即可。

步骤 3：录属性值

在属性列表块点【+ 添加属性值】逐行录入：

• 属性名称：顾客看到的选项文字，如「珍珠」「6寸动物奶油」；
• 加价(元)：选它要多加多少钱，不影响价格的选项填 0；
• 关联产品：该选项背后对应的物料（如加料本身是一个库存物料时关联上，便于按份扣库存）；
• 线上隐藏：只在门店现制用、不希望前台展示的选项打开它，清单汇总串里仍会存在但前台不出现；
• 是否打包：标记该选项需要单独打包（加料另装盒）；
• 默认选择：前台进入下单页时预选中的值，温度、甜度这类必选组建议给一个默认值；
• 排序：控制组内选项的显示顺序。

步骤 4：保存并关联到商品

点【保存】建组。之后到物料管理里给需要这组属性的商品挂上该组（或在商品分类的属性配置里按分类统一挂）。清单的「关联商品数」列随之变化，为 0 说明还没有商品引用它。

步骤 5：改动后同步

组已经建好、后来才在组里补了属性值或改了加价的，用属性列表块右上角的【同步至所有商品】把改动一次性推到全部已关联商品，省去逐个商品重新保存。

四、字段详细说明

字段名	必填	含义与取值
属性组名称	是	组名，前台选项行标题；清单第一列
排序	否	默认 0，同一商品上多组的先后顺序
属性值多选	否	启用后允许一次选多个值；配「最多可选」限制个数，留空为不限
属性值必选	否	启用后该组为下单必选内容，不选不能提交
选择形态	否	「勾选式（点选 0/1 份）」或「份数步进（每值可加多份）」；后者须先启用属性值多选
每值最大	否	份数步进下单个值最多加几份，留空为不限
属性名称	是	组内单个选项的显示名
加价(元)	否	选中该值时在商品售价上追加的金额，0 表示不加价
关联产品	否	该值对应的物料，用于库存与成本口径
线上隐藏	否	该值是否在商城/小程序等前台隐藏
是否打包	否	该值是否需要单独打包
默认选择	否	前台默认预选的值
关联商品数	—	清单列，该组被多少商品引用，只读

五、典型使用场景

场景 1：奶茶的温度与甜度

建「温度」组：正常冰、去冰、少冰、温，加价都填 0，勾选属性值必选，默认选择「正常冰」；建「甜度」组：三分甜、五分甜、七分甜、十分甜、不另外加糖，同样必选并给默认值。两组挂到全部饮品分类上，前台每杯饮品都会问一次温度和甜度。

场景 2：按份加钱的加料

建「加料」组：珍珠 1.00、西米 1.00、小丸子 2.00、抹茶麻薯 3.00。勾选属性值多选、最多可选留空（不限），选择形态改「份数步进」，每值最大填 3。顾客点一杯奶茶可以加 2 份珍珠 + 1 份小丸子，金额按份累加。

场景 3：蛋糕的尺寸决定奶油价

「尺寸」组放 6 寸、8 寸、10 寸（自身不加价，只作规格区分）；「奶油」组放 6 寸动物奶油 158.00、6 寸植物奶油 188.00、8 寸动物奶油 168.00 等，把「尺寸 × 奶油种类」的价差直接写进各值的加价里。两个组都设为必选、单选，前台就是标准的蛋糕下单流程。

场景 4：门店专用选项不上前台

某个加料只在门店现制、不希望线上顾客看到：在属性列表里把该行线上隐藏打开，门店收银仍可正常选择，商城与小程序的下单页不再出现。

六、权限控制与前置条件

1. 账号需有「基础设置 → 加值属性」菜单权限；清单工具栏的【新增】【删除】按权限显示；
2. 组必须先于关联存在：物料侧只能选已保存的属性组，未保存的组在商品上看不到；
3. 用「份数步进」前必须先启用「属性值多选」，否则该形态不可选（界面已给提示原文）；
4. 【同步至所有商品】会批量改写所有已关联商品的属性内容，属于影响面较大的操作，建议在非营业时段执行；
5. 删除走【回收站】：组被商品引用时先解除关联再删，否则前台下单会出现空选项行。

七、常见问题

1. 前台下单页看不到刚建的属性组

原因：组保存了但没挂到商品或分类上，清单「关联商品数」仍是 0。 处理：到物料管理给该商品关联属性组，或在商品分类的属性配置里按分类挂；挂好后刷新前台。

2. 加了新属性值，商品侧没变化

原因：属性组改动不会自动回写到已关联的商品上。 处理：在属性列表块点【同步至所有商品】。

3. 选不了「份数步进」

原因：未启用「属性值多选」。界面提示原文即「份数步进需先启用「属性值多选」（初始不加、按份数加价，适合加料/配料）。」 处理：先勾选属性值多选，再切选择形态。

4. 顾客一个都没选就下单了

原因：该组没启用「属性值必选」。 处理：勾选属性值必选并保存；建议同时给一个「默认选择」，减少顾客操作。

5. 加价改了但线上还是旧价

原因：改的是组内属性值的加价，未同步到商品。 处理：用【同步至所有商品】；仍不对时检查前台是否有缓存，刷新后再核对。

6. 两个组内容几乎一样，要不要合并

建议：只要两类的可选规则不同（一个必选一个可选、一个单选一个多选），就保留两组；规则相同、只是叫法不同的重复组应合并，否则清单里会出现「温度」和「SMOKE温度组」这类难以区分用途的并列项。