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(default 값) or true (가격 변경 비율 제한 없음) 입력 실수 방지를 위해 기존 가격 대비 변경할 수 있는 가격 비율 제한함. forceSalePriceUpdate=true 를 추가해서 가격변경 요청 시 처리 가능함. | |||||
| apMinSalePrice | Number | 자동 가격 조정 최저 판매가. path의 {price}보다 작아야 함 | |||||
| apActive | Boolean | 자동 가격 조정 활성화 여부 (true/false) | |||||
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 (요청변수확인) | 자동생성옵션의 가격을 직접 수정할 수 없습니다. 기준 판매자옵션 가격으로 자동생성옵션 가격도 변경할 수 있습니다. | 자동생성옵션 생성의 기준이 되는 판매자옵션의 가격을 조정하시면 자동생성옵션의 가격도 수량의 배수만큼 조율 되어 반영 됩니다. 이미 자동생성옵션을 직접 가격 수정한 경우는 판매자옵션 가격으로 조정할 수 없으며, 직접 WING에서 변경하셔야 합니다. |
| 400 (요청변수확인) | 가격변경에 실패했습니다. [옵션ID[5133***569] : 삭제된 상품은 변경이 불가능합니다.] | 옵션ID(vendorItemId)가 삭제 되었는지 확인합니다. |
| 400 (요청변수확인) | 가격변경에 실패했습니다. [옵션ID[4685***739]: 가격은 최소 10원 단위로 입력가능합니다. (1원단위 입력 불가)] | 가격(price)을 올바른 값으로 입력했는지 확인합니다. 최소 10원 단위로 입력가능합니다. (1원 단위 입력 불가) |
| 400 (요청변수확인) | 유효하지 않은 ID입니다. | 옵션ID(vendorItemId) 값을 올바로 입력했는지 확인합니다. |
| 400 (요청변수확인) | apMinSalePrice must be less than price | apMinSalePrice를 path의 {price}보다 작게 설정하세요 |
| 400 (요청변수확인) | apMinSalePrice and apActive must be provided together | apMinSalePrice / apActive를 함께 전달하세요 |
URL API Name
UPDATE_PRODUCT_PRICE_BY_ITEM