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

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

# 01

요약

API 적용 가능한 구매자 사용자 지역: 한국,대만 상품 아이템별 재고수량, 판매가격, 판매상태를 조회한다.

# 02

상세

API 적용 가능한 구매자 사용자 지역: 한국,대만
상품 아이템별 재고수량, 판매가격, 판매상태를 조회한다.

Path

GET

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

Example Endpoint

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

Request Parameters

Path Segment Parameter

Name Required Type Description
vendorItemId O Number
옵션ID
벤더아이템에 부여되는 고유 번호입니다.

Request Example

not require body

Response Message

Name Type Description
code Number
결과코드
SUCCESS/ERROR
message String
결과 메세지
data  
 
조회된 옵션 수량/가격/상태
  sellerItemId Number
옵션아이디
  amountInStock Number
옵션잔여수량
  salePrice Number
옵션판매가격
  onSale Boolean
옵션판매상태
true/false

Response Example

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

Error Spec

HTTP 상태 코드 (오류 유형) 오류 메시지 해결 방법
400 (요청변수확인) 유효한 옵션이 없습니다:[vendorItemId=3039***378] 옵션ID(vendorItemId) 값을 올바로 입력했는지 확인합니다.옵션ID(vendorItemId)가 삭제 되었는지 확인합니다.
400 (요청변수확인) 유효하지 않은 ID가 입력되었습니다. 옵션ID(vendorItemId) 값을 올바로 입력했는지 확인합니다.

URL API Name

GET_PRODUCT_QUANTITY_PRICE_STATUS