商品规格设置
会员在小程序买蛋糕时要选口味、温度、夹心,买饮品时要选糖度、冰块,还要决定加不加餐具与蜡烛——这些可选项以及选中后额外加多少钱,都在商品规格设置里维护。它是一份两级规格字典:一级是分组,二级是具体规格项,加购金额与成本金额在规格项这一层生效;某个商品用哪些规格项,再到网店商品 的「自定义规格」里挑。
一、功能概述
菜单位置:O2O业务 → 微信商城 → 商品规格设置(页面地址 /admin/o2o/wxmatesku/)

| 用途 | 说明 |
|---|---|
| 建规格字典 | 两级树:一级分组 + 二级规格项,维护编号、名称、节点顺序 |
| 定加购金额 | 会员选中该规格项时额外计入的金额,按两位小数录入 |
| 留成本口径 | 成本金额供内部核算使用,与加购金额分开两列 |
| 供商品挑用 | 网店商品的「自定义规格」按分组名 + 规格项名读取这份字典 |
| 绑定商品 | 规格项可挂商品明细行(商品ID、单位ID、数量、单价、金额) |
| 删除可还原 | 逻辑删除,记录进「回收站」,需要时还原 |
本页是树形档案,层级上限两层:一级分组只作归类,二级规格项才承载金额。字典与「商品启用了哪些规格」是两件事——本页只管字典本身,商品侧的启用关系在网店商品维护,分类与规格也不是一回事,分类树见网店商品分类。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 列表工具栏 | 新增、导出、回收站、打印,树形列表另有 ▼ 展开全部 |
| 列表列 | 规格编号、规格名称、上级节点、节点顺序、加购金额、成本金额、使用标志 |
| 树形结构 | 按上级节点挂载,一级分组的「上级节点」列显示「—」,默认展开全部层级 |
| 进入编辑 | 点「规格名称」打开编辑页 |
| 搜索与排序 | 搜索覆盖规格编号、规格名称、助记码;列表按节点顺序、规格ID 排序 |
| 分页 | 底部显示「共 N 条」「共 N 页」,每页可选 10 / 20 / 30 / 50 / 100 / 200 条 |
编辑页只有一个规格信息分组,两列排布:规格编号、规格名称(必填)、上级节点、节点顺序、加购金额、成本金额、助记码、使用标志。「上级节点」是数值输入框,旁边提示「留空或 0 为一级分组;最多 2 层(分组 → 规格)」。顶部工具栏为返回、保存(下拉含「保存并继续编辑」「保存并新增下一个」「保存并返回列表」)、取消、刷新、上一行、下一行、历史版本、删除。
主表单下方另有绑定商品明细区,列为商品ID、单位ID、数量、单价、金额;该明细区是否显示、金额列能否手工改,以现场界面为准。
三、业务操作步骤
步骤 1:先建一级分组
- 点工具栏「新增」,编辑页打开。
- 填规格编号(必填)与规格名称(必填),名称写这一组的业务叫法,例如「口味」「餐具」。
- 上级节点留空或填
0,表示这是一级分组;分组行的加购金额、成本金额留空即可。 - 填节点顺序控制分组之间的先后,点「保存」。列表刷新后出现一条「上级节点」为「—」的分组行。
步骤 2:在分组下建规格项
- 再点「新增」,上级节点填所属分组的规格ID(数值,不是名称)。
- 填规格名称,例如某个口味或某种餐具份数;填加购金额(会员选它要额外付的钱)与成本金额(内部核算口径)。
- 点「保存」,或用下拉里的「保存并新增下一个」把同一组的选项一次建完。保存后列表里这些行挂在分组下,点「▼ 展开全部」可一次看全。
校验不通过时,表单顶部出现横幅「表单验证失败,请修正以下错误后重新提交:」,字段下方给出具体原因:
- 「规格编号不能为空」
- 「规格编号只能包含字母、数字、下划线、中划线」
- 「规格编号 [填写的编号] 已存在,请更换编号」
- 「规格名称不能为空」
- 「上级节点不能选择自身」
- 「上级节点不存在」
- 「级别层次已经超出了2层!」
助记码不用手工填:保存时按规格名称的拼音首字母重新生成,格式为 / 加首字母串,手工填写也会被覆盖。
步骤 3:调整顺序与金额
- 节点顺序决定同级陈列先后,列表也按它排序;想让某个选项排在前面,把它的节点顺序调小。
- 加购金额按两位小数录入,改完保存,列表与商品侧读取到的就是新值。
- 金额能否填负数(用于减免类规格项)以实际版本为准:客户端口径要求加购金额与成本金额不小于 0,对应提示为「加购金额不能小于0!」「成本金额不能小于0!」。
步骤 4:给规格项绑定商品(可选)
- 先保存主记录,否则明细区提示「请先保存修改内容,再修改绑定商品。」。
- 在「绑定商品」明细里加行,填商品ID与单位ID,再填数量、单价、金额。
- 点明细区的「保存」。行校验不通过时提示「请先输入商品在输入单位!」(商品或单位没填)、「系统不允许重复输入相同的行信息!」(同一规格下商品 + 单位组合重复)。
步骤 5:到商品页挑用规格
到网店商品 打开商品抽屉的「自定义规格」,候选项按分组名 + 规格项名列出,只取未打删除标志的规格,并按分组编号排序。商品实际启用了哪些规格项记录在商品侧,本页新增字典项不会自动挂到所有商品上。
步骤 6:删除与还原
- 编辑页点「删除」,确认框提示「确认删除该记录?此操作不可恢复。」,确认后记录打上删除标志,不再出现在列表与商品侧的自定义规格候选里。
- 需要找回时点列表工具栏「回收站」,弹窗列出已删除记录,行尾「操作」列点「还原」,确认「确定要还原这条记录吗?」,成功后提示「记录已还原」。回收站没有数据时显示「回收站为空,没有已删除的记录」。
- 新增尚未保存的页面点「删除」会提示「新增页面无法删除」。
四、字段详细说明
字典落库表 WX_MateSKU,主键为规格ID(fSkuID),新增时自动发号;绑定商品明细落 WX_MateSKUInv,按规格ID + 商品ID + 单位ID 唯一。
| 界面字段 | 落库字段 | 含义与取值 |
|---|---|---|
| 规格编号 | fSkuNo | 必填,长度 15;只允许字母、数字、下划线、中划线;同账套内不可重复 |
| 规格名称 | fSkuName | 必填,长度 30;列表首列文字与编辑入口,也是商品侧显示的规格项名 |
| 上级节点 | fParentID | 整数,填父节点的规格ID;留空或 0 为一级分组,最多两层 |
| 节点顺序 | fIndex | 整数,同级陈列顺序,列表按它排序 |
| 加购金额 | fMoney | 金额,两位小数;会员选中该规格项时额外计入的金额 |
| 成本金额 | fCostMoney | 金额,两位小数;内部成本口径,与加购金额分列 |
| 助记码 | ZJM | 保存时按名称拼音首字母自动生成,手工填写会被覆盖 |
| 使用标志 | SignUsed | 档案使用状态,网页端只读,由框架维护 |
| 建立人 / 建立日期 | DefineMan / DefineDate | 审计信息,系统写入 |
| 修改人 / 修改日期 | ChangeMan / ChangeDate | 审计信息,系统写入 |
| 删除人 / 删除日期 / 删除标志 | DeleteMan / DeleteDate / SignDelete | 逻辑删除留痕,删除标志为 1 的记录进回收站 |
| 级别标志 / 专用标志 / 明细标志 / 修改标志 | SignLevel / SignSpecial / SignDetail / SignModify | 框架标志位,只读 |
| 有附件 / 版本号 | HaveAttach / RecVer | 框架字段 |
绑定商品明细列:
| 明细列 | 落库字段 | 含义与取值 |
|---|---|---|
| 商品ID | WX_MateSKUInv.fInvID | 必填,指向物料档案的商品ID |
| 单位ID | WX_MateSKUInv.fUnitID | 必填,与商品ID 组合去重 |
| 数量 | fQty | 该规格项对应的商品数量 |
| 单价 | fPrice | 该规格项对应的商品单价 |
| 金额 | fMoney | 明细金额,客户端口径按数量 × 单价计算 |
五、典型使用场景
场景一:蛋糕店建一套口味与温度字典。 先建「口味」「温度」两个一级分组,再在分组下逐个建规格项并填加购金额;商品页挑用后,会员下单时按分组看到可选项。
场景二:餐具与蜡烛按份加价。 建「餐具」「蜡烛」分组,规格项名称里写清份数与是否免费,加购金额填对应差价,会员选哪一档就加哪一档的钱,客服不必再手工改价。
场景三:上新只加规格项,不动商品结构。 新增一个口味选项只需在对应分组下加一条规格项,需要它的商品到「自定义规格」里勾上即可,其它商品不受影响。
场景四:内部核算留成本口径。 加购金额对会员,成本金额对内部;两列分开维护,做毛利分析时按规格项取成本口径,不必另建一张表。
场景五:季节过后收起某个选项。 把该规格项删除(逻辑删除),商品侧候选里立即不再出现;下个季节从「回收站」还原同一条记录,编号、名称与金额都保留。
六、权限控制与前置条件
- 本页属于网页端新增的商城配置菜单,权限映射表里没有对应的老 ERP 菜单项,登录网页后台即可进入;数据按当前账套隔离。
- 无前置档案依赖:规格字典可以先建,商品后挑用。要用「绑定商品」明细,需要物料档案里已有对应商品与单位。
- 层级上限两层是硬校验,建不出第三层;需要更细的分类维度时,用分组名称区分,或改用商品分类体系。
- 字典与商品启用关系分开维护:本页新增或删除规格项后,到网店商品 核对商品的「自定义规格」。
- 删除属于逻辑删除,记录进「回收站」,可还原;历史单据里已记录的规格不受影响。
- 账号与角色本身的维护见用户管理。
七、常见问题
问:能建三级规格吗? 答:不能。最多两层(分组 → 规格项),把二级节点当父节点再挂子节点会提示「级别层次已经超出了2层!」。
问:「上级节点」到底填什么? 答:填父节点的规格ID(数值),不是名称;留空或 0 表示一级分组。列表「上级节点」列显示的是父节点名称,方便核对,编辑时仍以ID 为准。
问:一级分组要不要填加购金额? 答:分组只作归类,金额在二级规格项上才有业务意义,分组行的金额留空或 0 即可。
问:字典里建好了,商品页却看不到? 答:分两步看:先确认该规格项未打删除标志(商品侧只取未删除的),再到商品的「自定义规格」里确认已挑用该项。本页新增不会自动挂到所有商品。
问:助记码手工改了,保存后又变回去? 答:助记码按规格名称的拼音首字母无条件重生成,这是设计口径。要改检索关键字,请改规格名称。
问:编号提示「已存在,请更换编号」,但列表里搜不到? 答:查重包含已删除的记录。到「回收站」里找同编号的旧记录,还原后改名,或换一个新编号。
问:加购金额能填负数做减免吗? 答:客户端口径要求加购金额与成本金额不小于 0,网页端是否放开负数以实际版本为准;需要减免类玩法时先与实施人员确认,或改用商城活动 的促销方案表达。
