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(default 값) or true (가격 변경 비율 제한 없음)
입력 실수 방지를 위해 기존 가격 대비 변경할 수 있는 가격 비율 제한함.
forceSalePriceUpdate=true 를 추가해서 가격변경 요청 시 처리 가능함. |
|||||
Request Example
Response Message
| Name | Type | Description | ||||
|---|---|---|---|---|---|---|
| code | 결과코드 |
SUCCESS/ERROR
|
||||
| message | String |
결과 메세지
|
||||
Response Example
{
"code": "SUCCESS",
"message": "가격 변경을 완료했습니다.",
"data": null
}Error Spec
|
HTTP 상태 코드 (오류 유형) |
오류 메시지 |
해결 방법 |
|---|---|---|
|
400 (요청변수확인) |
가격변경에 실패했습니다. [옵션ID[3572***698] : 판매가 변경이 불가능합니다. 변경전 판매가의 최대 50% 인하/최대 100%인상까지 변경가능합니다.] |
가격변경 범위 내의 price 값을 입력했는지 확인합니다. forceSalePriceUpdate=true 를 추가해서 변경 범위 외의 가격을 수정할 수 있습니다. |
|
400 (요청변수확인) |
자동생성옵션의 가격을 직접 수정할 수 없습니다. 기준 판매자옵션 가격으로 자동생성옵션 가격도 변경할 수 있습니다. |
자동생성옵션 생성의 기준이 되는 판매자옵션의 가격을 조정하시면 자동생성옵션의 가격도 수량의 배수만큼 조율 되어 반영 됩니다. 이미 자동생성옵션을 직접 가격 수정한 경우는 판매자옵션 가격으로 조정할 수 없으며, 직접 WING에서 변경하셔야 합니다. |
|
400 (요청변수확인) |
가격변경에 실패했습니다. [옵션ID[5133***569] : 삭제된 상품은 변경이 불가능합니다.] |
옵션ID(vendorItemId)가 삭제 되었는지 확인합니다. |
|
400 (요청변수확인) |
가격변경에 실패했습니다. [옵션ID[4685***739]: 가격은 최소 10원 단위로 입력가능합니다. (1원단위 입력 불가)] |
가격(price)을 올바른 값으로 입력했는지 확인합니다. 최소 10원 단위로 입력가능합니다. (1원 단위 입력 불가) |
|
400 (요청변수확인) |
유효하지 않은 ID입니다. |
옵션ID(vendorItemId) 값을 올바로 입력했는지 확인합니다. |
URL API Name
UPDATE_PRODUCT_PRICE_BY_ITEM