coupang
API 文件
商品 API品類 API運輸 / 訂單 API退貨 API換貨 API物流資訊客服 / 諮詢
PUT/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/prices/{price}2609170000

變更產品中各單品的價格

# 01

簡介

變更產品中各單品的價格

# 02

詳細內容

消費者市場：韓國、台灣

修改產品中各個項目的銷售價格。當銷售申請核准並取得選項 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/{vendorItemId}/prices/{price}

URL API Name

UPDATE_PRODUCT_PRICE_BY_ITEM
# 03

Path 參數

NameTypeDescription
vendorItemId*number
屬性ID

這是分配給供應商商品的唯一編號。
price*number
價格

輸入的最小單位為 10 twd。 （不允許輸入 1 twd 單位）
# 04

請求內容

請求參數

請求內容參數

NameTypeDescription
forceSalePriceUpdateboolean
若設定價格變更百分比限制

false（預設值）：限制價格變更幅度

true：不限制價格變更幅度

為避免輸入錯誤，系統會依據既有價格限制價格變更。
如需強制進行價格變更，可於請求中加入
forceSalePriceUpdate=true 以完成價格更新。
# 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） 值是否正確。