归组与尺寸变体组
商品上架到 Noon 时,面对多件同款不同规格的商品,Nomu 提供两条并行的「变体」路径——它们都把多件商品组织在一起发布,但语义、平台数据形态、配置位置都不同:
| 路径 | 平台 UI 位置 | 平台产物 | 单件独立性 | 典型场景 |
|---|---|---|---|---|
| 归组(Group) | Noon 后台 Group Tab | skuGroup(ZD…) | 保留:每件走自己的 product/create 链 | 同款多尺码 / 多型号,颜色系列 |
| 尺寸变体组(Sizes) | Noon 后台 Sizes Tab | parentGroupKey / skuParent(ZA…) | 子品继承父品,价格独立 | 标准尺码表(衣服 / 鞋) |
两条路径互不影响——单商品上架(既不归组也不填尺码变体)依旧按原来的流水线跑,没有强制要求。
归组上架(Group)
适用场景
「同一品牌同类目」的多件商品,每件有自己的 partnerSku 与图片,但标题 / 介绍 / 卖点 / 类目 / 部门要保持一致。归组让买家在前台看到一个统一商品页,下方有规格变体可挑。
怎么走
- 抓取或新建多件同款商品
- 在上架抽屉里勾选要归组的若干件
- 配置「组名」(
partnerRef)与「规格轴」(size/model_name/colour_name) - 提交后引擎按归组路径走:组内第一件
group/upsert建组拿到skuGroup(ZD…),后续件带skuGroup加入;每件在归组后额外写入自己的轴值
关键规则
- 同品牌是硬门禁(口径 =
BrandRef.code):仓储层 create/replace 事务校验;任一方未设 brand 放行,组内品牌必须一致才允许建组 - 同类目不设门禁:组内类目一致性只靠「编辑组共享字段时覆盖成员」维持,没有事务级校验
- 每件商品在归组后仍走自己完整的
product/create链与内容,不共享 SKU 链——「组」是扁平商品模型之上的可选聚合视图(CONTEXT.md ADR-0001 / 0006) - 任务面板里归组任务标
taskKind: 'group',行展示「X 件 · 父/子 · #N」
概念区分
skuGroup(ZD…)—— 归组路径的组标识skuParent(ZA…)—— 单件路径下每个商品自己的父编码(在单商品路径下两者同值)- 不要把「归组」与「Sizes 变体组」混为一谈——它们是平台 UI 上并列的两套机制
尺寸变体组(Sizes)
适用场景
Noon 后台 Sizes Tab 下的标准尺码表:一个商品作为父品(带价格 / 介绍 / 图片),另有 N 个尺码变体作为子品。子品内容自动继承父品(图、标题、介绍、品牌等),价格需单独写入。
怎么走
尺码变体不再需要单独发起任务,直接在单商品上架表单里配置:
- 按快速上手抓取或新建商品
- 打开商品的上架抽屉,滚到「尺码变体」区
- 点「添加变体」,填入父品尺码(这一件自己的尺码,如 S / M / L)
- 逐行添加子品:每行填尺码、SKU、条码(SKU 会自动生成,也可手改)
- 正常提交上架,父品与子品随同一次提交完成
留空「尺码变体」区 = 普通单商品发布,不触发任何变体逻辑。
关键规则
- 轴只允许 1 个 = size,不可挂 color / style 等多轴
- 父品尺码必填:填了变体就必须给父品尺码,否则提交时该商品上架失败
- 子品 SKU 由
父品编码-{序号}派生,序号按变体行填写的顺序排 - 子品价格随变体一起提交,按变体行顺序对应
- 尺码名称去首尾空格后,父品尺码与子品尺码相同的会自动去重,不会产生重复轴选项
- 引擎在单商品上架的最后一步才处理变体:父品内容(标题、图、价格)先落 Noon,再按变体逐个建子品
任务面板标识
尺码变体不再是独立任务类型——它作为单商品上架任务的最后一步执行,任务面板里看到的就是普通单商品任务。子品的 parentGroupKey / pskuCode / sku 在该任务的 child 区展示。
选 Group 还是 Sizes?
| 想做的事 | 用什么 |
|---|---|
| 标准尺码表(S / M / L / XL …) | Sizes |
| 颜色系列(红 / 蓝 / 黑),各色独立商品图 | Group |
| 同一型号有多个细分型号(手机 128G / 256G / 512G) | Group + model_name 轴 |
| 不同商品图片需要按颜色变体独立展示 | Group + colour_name 轴 |
| 子品内容需要严格继承父品 | Sizes |
常见问题
归组了为什么组里商品的状态还是独立的?
归组是平台层面的「共享段 + 成员」组织,不是「所有成员一起成功或一起失败」。每件商品仍走自己的 product/create 链与步骤表,任务面板里能看到每件独立状态。
归组要选同品牌吗?
要。同品牌是硬门禁——BrandRef.code 一致才允许建组;任一方未设 brand 会被放过,但实际建组时仍会被仓储层校验。
归组和 Sizes 能不能同时存在?
不能。一个商品一旦在单商品表单里填了尺码变体,它的子品就不是归组成员;Group 段只对未上架单商品展示。
尺码变体要单独发一次任务吗?
不用。它是单商品上架任务的最后一步,跟着商品一起提交即可——父品先落 Noon,再按变体逐个建子品。
