跳转到内容

更新商品至中台

POST /app/product/cloud/updateCloudProduct

注意:

  1. 按传入内容整体覆盖商品,没有传的字段会被清空或置0,建议先通过「通过id获取中台的商品详情」取到完整数据,修改后再整体提交
  2. skus 中要保留的规格必须带上原规格 id;不带 id 的规格会被当作新规格创建,本次没有提交的原规格会被删除,规格id会发生变化
  3. is_display 需要传当前的上下架状态,不传会被当作下架处理
  4. 供货价或成本价为0的规格库存会被置0;所有规格都为0时商品自动下架
  5. 只能更新当前应用绑定供应商自己的商品;会按中台商品设置中的必填字段进行校验
  6. 供应商开启了商品审核时,更新后会重新提交审核
字段名称类型是否必须
id中台商品idint是
title商品名称string是
detail_images商品详情富文本是
category1_id中台一级分类id(通过 公用API-分类类API 获取)int是
category2_id中台二级分类idint是
category3_id中台三级分类idint是
stock库存int是
price供货价(单位分)int是
guide_price指导价(单位分)int是
origin_price市场价(单位分)int是
cost_price成本价(单位分)int是
freight运费(分),freight_type=0 时使用int否
freight_template_id中台运费模板id,freight_type=1 时使用int否
freight_type运费类型 0统一,1模板int否
unit单位string是
image_url主图string是
gallery组图array是
attrs属性array否
skus规格array是
single_option0多规格1单规格int是
code自定义编码string否
is_display上下架 0下架 1上架,需传当前状态int是

gallery:

type1图片 目前只有1int是
src路径string是

attrs:

name属性名称string是
value属性值string是

skus:

id中台规格id,已有规格必传,新增规格不传int已有规格必传
title规格属性名称string是
cost_price成本价格(分)int是
origin_price市场价(分)int是
guide_price指导价(分)int是
activity_price营销价格(分)int否
stock库存int是
options规格详情array是
price供货价(分)int是
weight重量int否
sn条码string否
code自定义编码,建议每个规格唯一,便于推送后按 code 对应中台规格idstring否

options:

spec_name规格名称,如:颜色string是
spec_item_name规格项名称,如:黑色string是

{
"code": 0,
"data": {}, // 无返回数据,以 code=0 判断成功
"msg": "更新成功"
}