API支持的买家用户地区：韩国,台湾
用于变更单品级别的销售价格。“销售申请”批准通过后，已生成属性ID（vendoritemId）的情况下可使用此功能。
当forceSalePriceUpdate=true的情况下更改价格时，更改比率没有限制。
Path
PUT
/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/prices/{price}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/3572784698/prices/49000?forceSalePriceUpdate=true
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorItemId | O | Number | 属性ID 卖家单品固有的号码 | ||||
| price | O | Number | 价格 以10韩元为单位输入（无法以1韩元为单位输入） | ||||
Query String Parameter
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| forceSalePriceUpdate | Boolean | 是否有价格更改的比率限制 false(默认值) or true (更改比率无限制) 为避免输入错误，会以之前的价格为基准限制更改范围。 添加forceSalePriceUpdate=true时，可进行价格更改 | |||||
| apMinSalePrice | Number | 自动定价最低售价。必须小于 path 中的 {price} | |||||
| apActive | Boolean | 是否启用自动定价（true/false） | |||||
Request Example
not require body
Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | Result code | SUCCESS/ERROR | ||||
| message | String | 结果信息 | ||||
Response Example
{
"code": "SUCCESS",
"message": "Completed price change.",
"data": null
}Error Spec
| HTTP status code (Error type) | Error message | Solution |
|---|---|---|
| 400 (确认请求参数) | 가격변경에 실패했습니다. [옵션ID[3572***698] : 판매가 변경이 불가능합니다. 변경전 판매가의 최대 50% 인하/최대 100%인상까지 변경가능합니다.] | 确认输入的price值是否在价格更改范围内。 添加forceSalePriceUpdate=true即可输入无范围限制的价格。
|
| 400 (Check request parameter) | 가격변경에 실패했습니다. [옵션ID[5133***569] : 삭제된 상품은 변경이 불가능합니다.] | 确认属性ID (vendorItemId)是否被删除。 |
| 400 (Check request parameter) | 자동생성옵션의 가격을 직접 수정할 수 없습니다. 기준 판매자옵션 가격으로 자동생성옵션 가격도 변경할 수 있습니다. | 如果您要调整卖方单体商品的价格（这是创建自动生成选项的基础），则自动生成单体的价格也相应的也会被调整并以数量的倍数反映。 如果您已经直接修改了自动生成的单体价格，则无法将其调整为卖方单体商品的价格，则必须在WING中直接更改。 |
| 400 (Check request parameter) | 가격변경에 실패했습니다. [옵션ID[4685***739]: 가격은 최소 10원 단위로 입력가능합니다. (1원단위 입력 불가)] | 确认输入的价格（price）是否正确。价格最少以10韩元为单位输入(无法以1韩元为单位输入) |
| 400 (Check request parameter) | 유효하지 않은 ID입니다. | 确认输入的属性ID(vendorItemId) 值是否正确 |
| 400 Bad Request | apMinSalePrice must be less than price | 请将 apMinSalePrice 设为低于 path 中的 {price} |
| 400 Bad Request | apMinSalePrice and apActive must be provided together | 请同时传递 apMinSalePrice 与 apActive |
URL API Name
UPDATE_PRODUCT_PRICE_BY_ITEM