简体中文
简体中文
English
联系我们
注册
登录

添加商品

更新时间:2022-09-27 06:12:06下载pdf

本文介绍添加商品的 API。

接口描述

将商品添加到店铺商品库,支持单个添加。

接口地址

POST: /v1.0/sellercenter/commodity

请求参数

body 说明

参数名类型参数位置是否必填说明
titleString true商品标题,最多 80 个字符。
descriptionString false商品描述,最多 250 个字符。
brandString false商品品牌,最多 30 个字符。
codeString false商品编码或者型号,最多 50 个字符。
pidString false商品 PID,最多 16 个字符。
first_category_codeString true一级类目 Code。
second_category_codeString true二级类目 Code。
third_category_codeString true三级类目 Code。
videoString false商品展示视频。使用该接口时,要求传视频 URL,该 URL 支持通过浏览器打开视频文件。仅支持 MP4 格式,不超过 50M,建议时长 9-30 秒。
video_picString false视频展示图。使用该接口时,要求传图片 URL,该 URL 支持通过浏览器打开。当 video 不为空时,该参数为必要参数。
show_picturesList true商品展示图片。使用该接口时,要求传图片 URL,该 URL 支持通过浏览器打开。最多支持 10 张图片,只支持 JPG、PNG 和 GIF 格式。每张图片的尺寸小于等于 500 KB,建议尺寸 750 × 750 像素。
detail_picturesList true商品详情图片。使用该接口时,要求传图片 URL,该 URL 支持通过浏览器打开。最多支持 15 张图片,只支持 JPG、PNG 和 GIF 格式。每张图片的尺寸小于等于 3 MB,建议尺寸 750 × 750 像素。
sku_listList trueSKU 列表,最多支持 100 组 SKU。
postage_typeInteger true邮费类型。
  • 1:免邮。
  • 2:统一邮费。
postage_feeBigDecimal false商品邮费。如果 postageType2,则该字段必填。
install_typeInteger false安装类型。
  • 1:无需安装,默认值。
  • 2:上门安装。
  • 3:安装自理。
install_feeBigDecimal false安装费用。
is_jumpBoolean false是否跳转第三方。
  • true:支持
  • false:不支持。默认值。
jump_linkString false商品跳转链接。如果 isJumptrue, 则此字段为必填。
publishBoolean false商品是否上架。
  • true:立即上架。默认值。
  • false:商品不上架
mall_codeString true商城 code。
site_codeString true国家码。

sku_list 说明

参数名类型参数位置是否必填说明
original_priceBigDecimal falseSKU 原价,最多支持两位小数。
sale_priceBigDecimal trueSKU 售价,最多支持两位小数。
inventoryInteger true库存,支持整数。
weightBigDecimal true重量,最多支持三位小数,单位 KG。
external_codeString true外部 code。
sku_attr_listList trueSKU 属性集合。

sku_attr_list 说明

参数名类型参数位置是否必填说明
attr_codeString true属性 code。
attr_value_idLong true属性值 ID。

返回参数

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

result 说明

参数名类型说明
commodity_codeString商品唯一 code。

请求示例

POST: /v1.0/sellercenter/commodity
{
  "mall_code": "8h4tiureddm***",
  "site_code": "CN",
  "title": "冰箱",
  "brand": "",
  "code": "define_code",
  "detail_pictures": [
    "http://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
  ],
  "first_category_code": "12",
  "second_category_code": "1312",
  "third_category_code": "131211",
  "install_fee": 1,
  "install_type": 2,
  "is_jump": false,
  "pid": "",
  "postage": 100,
  "postage_type": 1,
  "publish": true,
  "show_pictures": [
    "http://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
  ],
  "video": "",
  "video_pic": "",
  "sku_list": [
    {
      "external_code": "",
      "inventory": 100,
      "original_price": 1,
      "sale_price": 2,
      "sku_attr_list": [
        {
          "attr_code": "COLOR",
          "attr_value_id": 1001
        }
      ],
      "weight": 0
    }
  ]
}

返回示例

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

错误码

参考 错误码

错误码错误信息说明
2000000params error参数错误
2000001character limit exceeded超出字符限制
2002001pid error商品 PID 有误
2002002commodity title already exists商品标题已存在
2002003category does not exist商品类目不存在
2002004failed to add commodity商品添加失败
2002200sku list can not emptySKU 列表不能为空
2002201sku exceeds the maximum limitSKU 数量超出最大限制
2002202sku attribute does not existSKU 属性不存在
2002203the sku combination rule is wrongSKU 未按照规则组合
2004000image size exceeds limit媒体文件大小超出限制
2004001the number of pictures exceeds the limit图片数量超出限制
2004002picture error图片有误
2004003video error视频文件有误