4.1 商品基本信息
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
spuId |
string | 修改时是 | 平台 SPU ID;新增成功后由平台返回 |
name |
string | 是 | 商品名称,最多 200 个字符 |
productCode |
string | 是 | 供应商商品货号;同一供应商下唯一,创建后不可修改 |
brandId |
string | 是 | 平台品牌 ID,必须是当前供应商的有效品牌,参考10. 获取当前供应商有效品牌 |
categoryId |
string | 是 | 平台类目 ID,必须是当前供应商可用的有效末级类目,参考11. 获取当前供应商有效类目 |
deliveryCycle |
string | 是 | 货期,例如 3天、现货 |
mainImageUrl |
string | 是 | 商品主图地址,必须是可访问的 HTTPS 地址 |
casNumber |
string | 否 | CAS 号 |
description |
string | 否 | 商品详情,可为文本或平台允许的富文本内容,可以是第三方的商品详情地址 |
officialWebsite |
string | 否 | 供应商官网商品地址,必须是 HTTP 或 HTTPS 地址 |
skus |
array | 是 | SKU 列表;新增商品时至少包含一个 SKU |
4.2 新增商品 SKU
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
specification |
string | 是 | 规格,例如 500ml/瓶 |
marketPrice |
number | 是 | 市场价 |
discountPrice |
number | 是 | 优惠价,即商城实际销售价 |
4.3 修改商品 SKU
修改商品接口不允许修改价格。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
originalSpecification |
string | 是 | 修改前的 SKU 规格,用于定位原有 SKU |
specification |
string | 是 | 修改后的 SKU 规格 |
如果不修改 SKU 规格,批量修改商品时可以不传 skus。新增 SKU 不通过修改商品接口处理。
作者:吴群杰 创建时间:2026-10-10 16:15
最后编辑:吴群杰 更新时间:2026-10-10 17:37
最后编辑:吴群杰 更新时间:2026-10-10 17:37