更新商品

请求 #

接口概述 #

此接口可以更新商品信息，包括skus。

注意
商品更新之后会自动变成待审核状态，需要平台重新审核。

请求URL # 

POST {{host}}/products/update

请求头(header) #

参数名 类型 是否必填 说明
Authorization string 是 token

请求参数(body) #

参数名 类型 必选 验证规则 参数路径 说明
uid string 是 平台商品uid
title string 是 max=90 商品标题
sub_title string 否 max=90 商品副标题
cate_id int 是 平台类目最底层ID
brand string 是 max=30 品牌名称
unit_name string 是 max=10 单位名称
inventory_method int 是 oneof(-1,1,2) 库存扣减方式，1 提交订单减库存 2 付款减库存 -1 虚拟库存
line_price float 否 划线价格
is_sale int 是 oneof(-1,1) SPU是否上架（前端展示）1上架，-1 下架
images StringArray 是 url 商品图片
pc_content string 是 max=8000 PC端商品详情
mobile_content string 是 max=8000 移动端商品详情
tax_code string 是 税收分类编码 商品对应的税收分类编码
tax_rate float 是 税率 商品开票税率,免税商品0，其他0.06,0.13等
refer_url string 否 参考商品连接
attrs array 否 商品属性
label string 是 max=30 attrs 属性名称
value string 是 max=100 attrs 属性值
sort int 否 attrs 属性排序，升序
skus array 否 商品SKU (如果不传skus,则不更新商品SKU)
sku_uid string 是 skus SKU uid (平台的sku_uid)
sku_code string 是 skus 自定义sku_code
sale_price float 是 skus 销售价格
market_price float 否 skus 参考价格(第三市场价)
min_order_num int 是 skus 最小起订量
inventory int 是 skus 库存
upc_code string 否 max=60 skus UPC编码
is_sale int 是 oneof(-1,1) skus 是否上架，1 上架 -1 下架
images StringArray 否 url skus SKU图片

请求示例 # 

{
  "uid": "27921310738817024",
  "title": "API1测试商品",
  "sub_title": "--subtitile",
  "cate_id": 37,
  "brand_id": 2,
  "unit_name": "个",
  "is_sale": -1,
  "inventory_method": 1,
  "line_price": 100.00,
  "images": [
    "https://inews.gtimg.com/om_bt/OrMpVlRiNYrhEguaKDCMIlZsS55hdV-D-et1bOaKIarf8AA/641",
    "https://inews.gtimg.com/om_bt/O6B8z3TRANzX36ut8z4sgDJt0Rbh2Xv1ZbGlCCED7XmUUAA"
  ],
  "refer_url": "",
  "pc_content": "<p><img src=\"https://erp-img.jsyxgyl.com/products_imgs/10199485204406272/1711337337-XAdw3dPD.jpg\" alt=\"\" width=\"800\" height=\"800\" /></p>",
  "mobile_content": "<p><img src=\"https://erp-img.jsyxgyl.com/products_imgs/10199485204406272/1711337337-XAdw3dPD.jpg\" alt=\"\" width=\"800\" height=\"800\" /></p>",
  "attrs": [
    {
      "label": "产地1",
      "value": "北京",
      "sort": 1
    },
    {
      "label": "品牌",
      "value": "中车",
      "sort": 2
    }
  ],
  "skus": [
    {
      "sku_uid": "27921311133081600",
      "sku_code": "c123",
      "sale_price": 231,
      "market_price": 321,
      "min_order_num": 2,
      "inventory": 999,
      "upc_code": "",
      "is_sale": -1,
      "images": [
        "https://inews.gtimg.com/om_bt/OrMpVlRiNYrhEguaKDCMIlZsS55hdV-D-et1bOaKIarf8AA/641",
        "https://inews.gtimg.com/om_bt/O6B8z3TRANzX36ut8z4sgDJt0Rbh2Xv1ZbGlCCED7XmUUAA"
      ]
    }
  ]
}

响应 #

返回参数 #

参数名 类型 参数路径 说明
code int 错误码
msg string 错误详情
data object 结果集
uid string data 平台商品uid
code string data 自定义商品code
skus array data SKU列表
sku_uid string skus 平台sku_uid
sku_code string skus SKU code

响应示例 # 

{
  "code": 10000,
  "msg": "success",
  "data": {
    "uid": "27921310738817024",
    "code": "27921310738817024",
    "skus": [
      {
        "sku_uid": "27921311133081600",
        "sku_code": ""
      }
    ]
  }
}