coupang
API 문서
상품 API카테고리 API브랜드 API배송 / 주문 API반품 API교환 API프로모션 / 쿠폰물류 정보고객 문의정산CGF / CGF liteRocket Growth
GET/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/inventories2609170000

상품 아이템별 수량/가격/상태 조회

KRTW
# 01

요약

상품 아이템별 수량/가격/상태 조회

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국,대만

상품 아이템별 재고수량, 판매가격, 판매상태를 조회한다.

경로

GET/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/inventories

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/vendor-items/{vendorItemId}/inventories

URL API Name

GET_PRODUCT_QUANTITY_PRICE_STATUS
# 03

Path 파라미터

NameTypeDescription
vendorItemId*number
옵션ID
벤더아이템에 부여되는 고유 번호입니다.
# 04

응답 본문

응답 메시지

NameTypeDescription
codestring
결과코드
SUCCESS/ERROR
messagestring
결과 메세지
dataobject
조회된 옵션 수량/가격/상태
sellerItemId
data.sellerItemId
integer
옵션아이디
amountInStock
data.amountInStock
integer
옵션잔여수량
salePrice
data.salePrice
integer
옵션판매가격
onSale
data.onSale
boolean
옵션판매상태
true/false

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": {
    "sellerItemId": 3000000000,
    "amountInStock": 0,
    "salePrice": 32000,
    "onSale": true
  }
}
# 05

에러 코드

HTTP코드메시지
400HTTP_400Bad Request

오류 사양

HTTP유형오류 메시지해결 방법
400400 (요청변수확인)

유효한 옵션이 없습니다:[vendorItemId=3039***378]

옵션ID(vendorItemId) 값을 올바로 입력했는지 확인합니다.옵션ID(vendorItemId)가 삭제 되었는지 확인합니다.

400400 (요청변수확인)

유효하지 않은 ID가 입력되었습니다.

옵션ID(vendorItemId) 값을 올바로 입력했는지 확인합니다.