更新SKU - 小红书 API

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \ --header 'Content-Type: application/json;charset=utf-8' \ --data-raw '{ "itemId": "64ff12f***fd12f1", "ipq": 100, "originalPrice": 88, "price": 80, "stock": 5000, "logisticsPlanId": "5e37***a9f0", "whcode": "C01", "priceType": 1, "erpCode": "001231", "variants": [ { "id": "5a60***9ce6", "name": "尺码", "value": "36", "valueId": "f423***921f" } ], "deliveryTime": { "time": "2021/06/01", "type": "ABSOLUTE_TIME" }, "specImage": "http://img.xiaohongshu.com/items/123456789", "barcode": "RedTest20200507001", "rowNumber": "", "id": "100", "updatedFields": [ "string" ] }'

{ "spuData": { "name": "spu标题", "ename": "spuEName", "shortName": "spu短标题，不得超过30的长度，其中中文字符占两个长度", "brandId": "52dd****7d4b", "categoryId": "5a31****9df5", "attributes": [ { "propertyId": "5845****325e", "name": "测试属性名01", "valueId": "test", "value": "test", "valueList": [ { "valueId": "test", "value": "test" } ] } ], "shippingTemplateId": "null", "shippingGrossWeight": 100, "variantIds": [ "string" ], "imageUrls": [ "string" ], "videoUrl": "", "articleNo": "", "imageDescUrls": [ "string" ], "transparentImageUrl": "", "desc": "", "faqs": [ { "question": "", "answer": "" } ], "isChannel": "", "deliveryMode": "", "id": "spu标题", "createTime": "", "updateTime": "" }, "itemData": { "spuId": "spu标题", "ipq": 100, "originalPrice": 88, "price": 80, "stock": 5000, "logisticsPlanId": "5e37***a9f0", "whcode": "C01", "priceType": 1, "erpCode": "001231", "variants": [ { "id": "5a60***9ce6", "name": "尺码", "value": "36", "valueId": "f423***921f" } ], "deliveryTime": { "time": "2021/06/01", "type": "ABSOLUTE_TIME" }, "specImageUrl": "http://img.xiaohongshu.com/items/123456789", "barcode": "RedTest20200507001", "id": "6123**5132", "skucode": "spu标题", "logisticsName": "red_auto", "buyable": true, "unionItemDetails": [ { "id": "607***450", "name": "口红", "skuCode": "690***466", "barcode": "690***452", "ipq": 100, "erpCode": "dq123da" } ], "createTime": "", "updateTime": "", "name": "", "isGift": true } }

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

itemId

string

item编号

必需

ipq

integer

打包数

可选

originalPrice

integer

市场价

可选

price

integer

售价

必需

stock

integer

库存

必需

logisticsPlanId

string

物流方案Id

必需

whcode

string

仓库号

可选

priceType

integer

可选

是否包税，0：不包税；1：包税

erpCode

string

商家编码

可选

variants

array [object {4}]

规格列表

必需

string

必需

规格ID(spl与spv规格根据common.getVariations区分，spl规格和spv规格集合需要与spu规格对齐)

name

string

规格名称

可选

value

string

必需

规格值(通过common.getAttributeValues获取)，查不到则自行填写

valueId

string

可选

规格值ID(通过common.getAttributeValues获取)查不到可以不填

deliveryTime

object

发货时间信息

必需

time

string

可选

发货时间，相对时间(X)付款后X天内发货，绝对时间(YYYY/MM/DD)该天24点之前发货

type

string

可选

发货时间类型，DEFAULT:不设置 RELATIVE_TIME:相对时间 ABSOLUTE_TIME:绝对时间

specImageUrl

string

规格图

可选

barcode

string

可选

商品条形码，创建特定品类必填，普通品类可不填

rowNumber

string

可选

sku在item中的顺序,不支持更新

string

商品id

可选

updatedFields

array[string]

可选

更新字段，不填默认全量，填入后只有传入的字段会被更新

示例

返回响应

🟢200成功

application/json

Body

itemId

string

item编号

必需

ipq

integer

必需

打包数，只允许创建ipq为1的商品，该字段查询使用

originalPrice

integer

市场价，单位分

必需

price

integer

必需

售价，单位分，要求小于市场价，上限10w元，即10000000分

stock

integer

库存

必需

logisticsPlanId

string

物流方案Id

必需

whcode

string

仓库号

必需

priceType

integer

是否包税

必需

erpCode

string

商家编码

必需

variants

array [object {4}]

规格列表

必需

string

可选

规格ID(规格根据common.getVariations区分，规格集合需要与item规格对齐)

name

string

规格名称

可选

value

string

可选

规格值(通过common.getAttributeValues获取)，查不到则自行填写

valueId

string

可选

规格值ID(通过common.getAttributeValues获取)查不到可以不填

deliveryTime

object

发货时间信息

必需

time

string

必需

发货时间，相对时间(X)，X为整数数字，绝对时间(YYYY/MM/DD)该天24点之前发货

type

string

必需

发货时间类型，DEFAULT:不设置 RELATIVE_TIME:相对时间（天，即将弃用） ABSOLUTE_TIME:绝对时间（即将弃用）,TODAY:当日发，RELATIVE_TIME_NEW:相对时间（小时）,ABSOLUTE_TIME_NEW:绝对时间

specImage

string

规格图

必需

barcode

string

必需

商品条形码，创建特定品类必填

rowNumber

string

必需

sku在item中的顺序,不支持更新

string

skuId

必需

scSkucode

string

必需

scSkuCode编号,小红书编码

logisticsName

string

物流模式名

必需

buyable

boolean

必需

是否在架上，仅用于返回

unionItemDetails

array [object {6}]

必需

组合商品子商品信息，仅返回使用

string

子商品编号

可选

name

string

子商品名称

可选

scSkuCode

string

子商品小红书编码

可选

barcode

string

子商品商品条形码

可选

ipq

integer

可选

子商品在组合品中的个数

erpCode

string

子商品商家编码

可选

createTime

string

必需

商品创建时间，仅返回使用

updateTime

string

必需

商品更新时间，仅返回使用

name

string

必需

商品名称，仅返回使用

isGift

boolean

是否是赠品,

必需