coupang
PUT/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/prices/{price}2609170000

更改单品价格

# 01

简介

更改单品价格

# 02

详细内容

API支持的买家用户地区:韩国,台湾

用于变更单品级别的销售价格。“销售申请”批准通过后,已生成属性ID(vendoritemId)的情况下可使用此功能。

当forceSalePriceUpdate=true的情况下更改价格时,更改比率没有限制。

路径

PUT/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/prices/{price}

示例端点

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/3572784698/prices/49000?forceSalePriceUpdate=true

URL API Name

UPDATE_PRODUCT_PRICE_BY_ITEM
# 03

Path 参数

NameTypeDescription
vendorItemId*number
属性ID

卖家单品固有的号码
price*number
价格

以10韩元为单位输入(无法以1韩元为单位输入)
# 04

Query 参数

NameTypeDescription
forceSalePriceUpdateboolean
是否有价格更改的比率限制

false(默认值) or true (更改比率无限制)

为避免输入错误,会以之前的价格为基准限制更改范围。

添加forceSalePriceUpdate=true时,可进行价格更改
apMinSalePricenumber
自动定价最低售价。必须小于 path 中的 {price}
apActiveboolean
是否启用自动定价(true/false)
# 05

响应体

响应消息

NameTypeDescription
codestring
SUCCESS/ERROR
messagestring
结果信息

Response Example

{
  "code": "SUCCESS",
  "message": "Completed price change.",
  "data": null
}
# 06

错误码

HTTP代码消息
400HTTP_400Bad Request

错误说明

HTTP类型错误消息解决方案
400400 (确认请求参数)

가격변경에 실패했습니다. [옵션ID[3572***698] : 판매가 변경이 불가능합니다. 변경전 판매가의 최대 50% 인하/최대 100%인상까지 변경가능합니다.]

确认输入的price值是否在价格更改范围内。

添加forceSalePriceUpdate=true即可输入无范围限制的价格。

400400 (Check request parameter)

가격변경에 실패했습니다. [옵션ID[5133***569] : 삭제된 상품은 변경이 불가능합니다.]

确认属性ID (vendorItemId)是否被删除。

400400 (Check request parameter)

자동생성옵션의 가격을 직접 수정할 수 없습니다. 기준 판매자옵션 가격으로 자동생성옵션 가격도 변경할 수 있습니다.

如果您要调整卖方单体商品的价格(这是创建自动生成选项的基础),则自动生成单体的价格也相应的也会被调整并以数量的倍数反映。 如果您已经直接修改了自动生成的单体价格,则无法将其调整为卖方单体商品的价格,则必须在WING中直接更改。

400400 (Check request parameter)

가격변경에 실패했습니다. [옵션ID[4685***739]: 가격은 최소 10원 단위로 입력가능합니다. (1원단위 입력 불가)]

确认输入的价格(price)是否正确。价格最少以10韩元为单位输入(无法以1韩元为单位输入)

400400 (Check request parameter)

유효하지 않은 ID입니다.

确认输入的属性ID(vendorItemId) 值是否正确

400400 Bad Request

apMinSalePrice must be less than price

请将 apMinSalePrice 设为低于 path 中的 {price}

400400 Bad Request

apMinSalePrice and apActive must be provided together

请同时传递 apMinSalePrice 与 apActive