상품 아이템별 판매가격을 변경한다.이 기능은 판매요청 신청 후 승인완료되어 옵션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(default 값) or true (가격 변경 비율 제한 없음)
입력 실수 방지를 위해 기존 가격 대비 변경할 수 있는 가격 비율 제한함.
forceSalePriceUpdate=true 를 추가해서 가격변경 요청 시 처리 가능함. |
|||||
Request Example
not require body
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 (요청변수확인) | 가격변경에 실패했습니다. [옵션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