消費者市場：韓國、台灣
修改產品中各個項目的銷售價格。當銷售申請核准並取得選項 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
參數需求
主體參數
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| vendorItemId | O | Number | 屬性ID 這是分配給供應商商品的唯一編號。 | ||||
| price | O | Number | 價格 輸入的最小單位為 10 twd。 （不允許輸入 1 twd 單位） | ||||
查詢字串參數
| Name | Required | Type | Description | ||||
|---|---|---|---|---|---|---|---|
| forceSalePriceUpdate | Boolean | 若設定價格變更百分比限制 false（預設值）：限制價格變更幅度 true：不限制價格變更幅度
| |||||
請求範例
不需要請求主體
錯誤響應
| 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) | 자동생성옵션의 가격을 직접 수정할 수 없습니다. 기준 판매자옵션 가격으로 자동생성옵션 가격도 변경할 수 있습니다. | 若您要調整賣方單體商品的價格（此為建立「自動生成選項」的基準）， 但如果您已直接修改過自動生成單體的價格， |
| 400 (Check request parameter) | 가격변경에 실패했습니다. [옵션ID[4685***739]: 가격은 최소 10원 단위로 입력가능합니다. (1원단위 입력 불가)] | 請確認輸入的價格（price）是否正確。 價格最小調整單位為 10 韓元（無法以 1 韓元為單位輸入）。 |
| 400 (Check request parameter) | 유효하지 않은 ID입니다. | 請確認輸入的 屬性 ID（vendorItemId） 值是否正確。 |
URL API Name
UPDATE_PRODUCT_PRICE_BY_ITEM