版本：202506

更新子款式

PUT /openapi/2025-06/variants/:variant_id

根据提供的信息更新已有的子款式。

请求

Path参数

variant_id string必填

待更新的子款式 ID

application/json

请求体
示例

请求体必填

variant object必填

待更新的子款式数据

option1string

商品款式属性 1 的取值（例如"颜色"取值"红色"）

option2string

商品款式属性 2 的取值

option3string

商品款式属性 3 的取值

image_idstring

子款式关联的图片 ID

image object

子款式图片对象；当商品的 need_variant_image 字段为 true 时必填

srcstring必填

图片 URL

widthint32

图片宽度（单位：像素）

heightint32

图片高度（单位：像素）

altstring

图片替代文本（alt）

pathstring

图片存储路径

compare_at_pricedouble

划线价

pricedouble必填

子款式售价；如需留空请设置为 "0.00"

skustring

SKU

barcodestring

条形码

notestring

款式备注/说明

inventory_quantityint64

库存数量

weightdouble

重量

weight_unitstring

重量单位，可选值：kg、g、lb、oz

cost_pricedouble

成本价

whole_prices object[]

批发价列表

Array [

pricedouble

批发价

min_quantityint64

起购量（达到该数量才适用此批发价）

]

retail_pricedouble

零售价

positionint64

子款式在列表中的排序位置

extend object

子款式扩展信息（包裹尺寸、原产地国别、HS 代码等）

lengthdouble

包裹长度

widthdouble

包裹宽度

heightdouble

包裹高度

dimension_unitstring

尺寸单位，可选值：cm、in、mm

origin_country_codestring

原产地国别（国家代码，例如 CN、US）

hs_codestring

HS（协调制度）代码

{
  "variant": {
    "option1": "string",
    "option2": "string",
    "option3": "string",
    "image_id": "string",
    "image": {
      "src": "string",
      "width": 0,
      "height": 0,
      "alt": "string",
      "path": "string"
    },
    "compare_at_price": 0,
    "price": 0,
    "sku": "string",
    "barcode": "string",
    "note": "string",
    "inventory_quantity": 0,
    "weight": 0,
    "weight_unit": "string",
    "cost_price": 0,
    "whole_prices": [
      {
        "price": 0,
        "min_quantity": 0
      }
    ],
    "retail_price": 0,
    "position": 0,
    "extend": {
      "length": 0,
      "width": 0,
      "height": 0,
      "dimension_unit": "string",
      "origin_country_code": "string",
      "hs_code": "string"
    }
  }
}

响应

application/json

数据结构
示例

数据结构

codestring

错误码

messagestring

错误信息

data object

variant object

已更新的子款式

idstring

子款式 ID

product_idstring

子款式所属商品的 ID