상품 API 카테고리 API 브랜드 API 배송 / 주문 API 반품 API 교환 API 프로모션 / 쿠폰 물류 정보 고객 문의 정산 CGF / CGF lite Rocket Growth

Rocket Growth

GET/v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries2609170000

로켓창고 재고 API

KRTW

# 01

요약

로켓창고 재고 API

# 02

상세

로켓성장 재고 요약 API는 쿠팡의 국내 로켓 물류센터(Local Korean Rocket Warehouses)에 있는 상품의 재고 정보를 프로그램 연동을 통해 조회할 수 있도록 지원합니다.

이 API는 재고 요약 목록을 반환합니다. 반환되는 요약 정보는 vendorItemId 파라미터의 제공 여부에 따라 달라집니다:

vendorItemId 파라미터를 생략하면, API는 사용 가능한 모든 상품에 대한 재고 요약 정보를 반환합니다.
vendorItemId 파라미터가 제공되면, 해당 vendorItemId에 대한 재고 요약 정보만 반환되며, 이 경우 nextToken 파라미터는 무시됩니다.
vendorId와 nextToken 파라미터가 모두 제공되면, API는 nextToken 이후부터 시작하는 모든 상품의 재고 요약 정보를 반환합니다.

중요 안내:
API 호출 빈도는 분당 50회 이하로 제한해 주시기 바랍니다.
이를 초과할 경우, 과도한 요청으로 인해 오류가 발생할 수 있습니다.

경로

GET/v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/rg_open_api/apis/api/v1/vendors/{vendorId}/rg/inventory/summaries

# 03

Path 파라미터

Name	Type	Description
vendorId*	string	판매자 벤더 ID 벤더 ID는 A로 시작하는 문자열 (예: Axxxx)입니다.

# 04

Query 파라미터

Name	Type	Description
vendorItemId	string	단일 `vendorItemId`를 통해 특정 판매자의 SKU 재고 요약 정보를 조회할 때 사용됩니다
nextToken	string	이전 요청의 응답에서 반환된 문자열 토큰으로, 페이징 처리에 사용됩니다.

# 05

응답 본문

응답 메시지

Name	Type	Description
code	integer	결과 코드: SUCCESS/ERROR
message	string	결과 메시지
data	object[]	유효한 정보
vendorId data[].vendorId	string	쿠팡에서 판매자에게 부여한 고유 코드
vendorItemId data[].vendorItemId	integer	단일 상품에 대한 고유 식별자
externalSkuId data[].externalSkuId	integer	판매자가 정의한 SKU ID
inventoryDetails data[].inventoryDetails	object	특정 SKU에 대한 재고 세부 정보
totalOrderableQuantity data[].inventoryDetails.totalOrderableQuantity	integer	해당 상품의 주문 가능 수량 총합
salesCountMap data[].salesCountMap	object	판매 정보
SALES_COUNT_LAST_THIRTY_DAYS data[].salesCountMap.SALES_COUNT_LAST_THIRTY_DAYS	integer	최근 30일간 판매된 수량
nextToken	string	페이징 토큰

응답 예시

{
  "code": 200,
  "message": "SUCCESS",
  "data": [
    {
      "vendorId": "A00123456",
      "vendorItemId": 70000000000,
      "externalSkuId": 10012345,
      "inventoryDetails": {
        "totalOrderableQuantity": 10
      },
      "salesCountMap": {
        "SALES_COUNT_LAST_THIRTY_DAYS": 15
      }
    },
    {
      "vendorId": "A00123456",
      "vendorItemId": 70000000001,
      "externalSkuId": 10012346,
      "inventoryDetails": {
        "totalOrderableQuantity": 20
      },
      "salesCountMap": {
        "SALES_COUNT_LAST_THIRTY_DAYS": 25
      }
    }
  ],
  "nextToken": "2"
}

# 06

에러 코드

HTTP	코드	메시지
400	HTTP_400	Bad Request
429	HTTP_429	Too Many Requests

오류 사양

HTTP	유형	오류 메시지	해결 방법
400	400	Request has missing or invalid parameters and cannot be parsed.	요청에 필수 파라미터가 누락되었거나 잘못된 파라미터가 포함되어 있어 요청을 처리할 수 없습니다. 필수 파라미터를 정확히 입력해 주세요.
429	429	Too Many Requests	요청을 중단하고 잠시 후 다시 시도해 주세요.