云服务 API 参考行业场景垂直行业解决方案App Mall开放能力商品管理编辑商品

编辑商品

更新时间：2024-01-12 02:42:47下载pdf

本文介绍编辑商品的 API。

接口描述

编辑店铺商品库中的商品，支持单个编辑。

接口地址

POST: /v1.0/cloud/ecm/store/admin/api/commodity/edit

请求参数

body 说明

参数名	类型	是否必填	说明
mall_code	String	true	商城 Code。
site_code	String	true	站点 Code。
commodity_code	String	true	商品 Code，必传。
title	String	false	商品标题，最多 80 个字符。
sub_title	String	false	商品副标题，最多 250 个字符。
description	String	false	商品描述，支持富文本，最多 20000 个字符。
brand	String	false	商品品牌，最多 30 个字符。
first_category_code	String	false	一级类目 Code。
second_category_code	String	false	二级类目 Code。
third_category_code	String	false	三级类目 Code。
showcase_codes	List	false	前台类目 Code 列表。
video	String	false	商品展示视频。使用该接口时，要求传视频 URL，该 URL 支持通过浏览器打开视频文件。仅支持 MP4 格式，不超过 50M，建议时长 9-30 秒。
video_pic	String	false	视频展示图。使用该接口时，要求传图片 URL，该 URL 支持通过浏览器打开图片。当 `video` 参数值不为空时，本参数为必填参数。
show_pictures	List	false	商品展示图片。使用该接口时，要求传图片 URL，该 URL 支持通过浏览器打开图片。最多支持 10 张图片，只支持 JPG、PNG 和 GIF 格式。文件尺寸小于等于 500 KB，建议尺寸 750 × 750 像素。
is_jump	Boolean	false	是否跳转第三方。 `true`：支持。 `false`：不支持，默认 `false`。
jump_link	String	false	商品跳转链接。当 `is_jump` 为 `true`，本参数为必填参数。
publish	Boolean	false	商品是否上架。 `true`：立即上架商品，默认 `true`。 `false`：商品不上架。
sku_list	List	false	SKU 列表，最多支持 100 组 SKU。

sku_list 说明

参数名	类型	是否必填	说明
skuCode	String	false	SKU Code，SKU 唯一编码。修改某个已存在的 SKU 时，本参数为必填参数。
skuPicList	List	false	SKU 图片列表。使用该接口时，要求传图片 URL，该 URL 支持通过浏览器打开。最多支持 10 张图片，只支持 JPG、PNG 和 GIF 格式。每张图片的尺寸小于等于 500 KB，建议尺寸 750 × 750 像素。
originalPrice	BigDecimal	false	SKU 原价，最多支持两位小数。不传默认为 `0`。
salePrice	BigDecimal	false	SKU 售价，最多支持两位小数。不传默认为 `0`。
inventory	Integer	false	库存，支持整数。不传默认为 `0`。
weight	BigDecimal	false	重量，最多支持三位小数，单位 KG。不传默认为 `0`。
externalCode	String	false	外部编码。
supportOutStockBuy	Boolean	false	是否支持零库存下单。
skuAttrList	List	false	SKU 属性集合。

skuAttrList 说明

参数名	类型	是否必填	说明
attrCode	String	true	属性编码。
attrValueId	Long	true	属性值 ID。
attrName	String	false	属性名称。
attrValueName	String	false	属性值名称。

返回参数

参数名	类型	说明
result	CommodityAddOpenApiVO	返回结果。

result 说明

参数名	类型	说明
commodity_code	String	商品唯一编码。

请求示例

POST: /v1.0/cloud/ecm/store/admin/api/commodity/edit

{
  "mall_code": "8h4tiureddm***",
  "site_code": "CN",
  "commodity_code": "CMaplyr4bzck***",
  "title": "冰箱",
  "sub_title": "Hr冰箱X0",
  "description": "<div><p>智能冰箱...</p><img src='https://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg' /></div>",
  "brand": "hr",
  "first_category_code": "12",
  "second_category_code": "1312",
  "third_category_code": "131211",
  "show_pictures": [
    "https://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
  ],
  "video": "https://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.mp4",
  "video_pic": "https://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg",
  "showcase_codes": [
    "Cbgrc6mvk***"
  ],
  "is_jump": true,
  "jump_link": "www.demo.com/home",
  "publish": true,
  "sku_list": [
    {
      "skuCode": "SKba0j4xcti***",
      "skuPicList": [
        "https://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
      ],
      "externalCode": "",
      "inventory": 100,
      "originalPrice": 1,
      "salePrice": 2,
      "supportOutStockBuy": false,
      "skuAttrList": [
        {
          "attrCode": "ATci8mev9w0***",
          "attrName": "颜色",
          "attrValueId": 6181512,
          "attrValueName": "白色"
        }
      ],
      "weight": 0
    }
  ]
}

返回示例

{
    "result": {
        "commodity_code": "CMaplyr4bzck***"
    },
    "t": 1624969838836,
    "success": true
}

错误码

参考错误码。

错误码	错误信息	说明
2000000	params error	参数错误
2001000	shop does not exist	店铺（站点）不存在
2000001	character limit exceeded	超出字符限制
2002002	commodity title already exists	商品标题已存在
2002003	category does not exist	商品类目不存在
2002004	failed to add commodity	商品添加失败
2002201	sku exceeds the maximum limit	SKU 数量超出最大限制
2002202	sku attribute does not exist	SKU 属性不存在
2002203	the sku combination rule is wrong	SKU 未按照规则组合
2004000	image size exceeds limit	媒体文件大小超出限制
2004001	the number of pictures exceeds the limit	图片数量超出限制
2004002	picture error	图片有误
2004003	video error	视频文件有误

上一篇创建商品 SKU 属性

下一篇商城管理