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

Rocket Growth

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products2609170000

상품 목록 페이징 조회 (로켓그로스 및 로켓그로스/마켓플레이스 동시 운영 상품)

KRTW

# 01

요약

# 02

상세

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

등록상품 목록을 페이징 조회합니다. 기존 상품 목록 페이징 조회 API의 endpoint URL에 파라미터를 추가하여 로켓그로스 상품만 별도 조회가 가능하며 신규 파라미터는 초록색 텍스트를 참고하세요.

경로

GET/v2/providers/seller_api/apis/api/v1/marketplace/seller-products

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/seller-products?vendorId={vendorId}&nextToken={nextToken}&maxPerPage={maxPerPage}&sellerProductId={sellerProductId}&sellerProductName={sellerProductName}&status={status}&manufacture={manufacture}&createdAt={createdAt}&businessTypes={businessTypes}

URL API Name

GET_PRODUCTS_BY_QUERY

# 03

Query 파라미터

Name	Type	Description
vendorId*	string	판매자 ID 쿠팡에서 업체에게 발급한 고유 코드 예) A00012345
nextToken	integer	페이지 다음 페이지를 호출하기 위한 키값. 첫 페이지 호출시에는 넣지 않거나 1 입력
maxPerPage	integer	페이지당건수 기본값 : 10, 최대값 :100
sellerProductId	integer	등록상품ID
sellerProductName	string	등록상품명 등록상품명 검색. 20자 이하
status	string	업체상품상태
manufacture	string	제조사
createdAt	string	상품등록일시 "yyyy-MM-dd" 형식 예)2015-12-17과 같이 입력하면, 2015-12-17T00:00:00 ~ 2015-12-17T23:59:59 와 같이 조회됨
businessTypes*	array	"rocketGrowth" 파라미터 사용 시, 로켓그로스 상품 또는 마켓플레이스 및 로켓그로스 아이템이 모두 존재하는 Hybrid 상품 목록이 조회됩니다. 파라미터 미사용 시, 기존 형식에 따라 마켓플레이스 상품 또는 마켓플레이스 및 로켓그로스 아이템이 모두 존재하는 Hybrid 상품이 조회됩니다.

# 04

응답 본문

응답 메시지

Name

Type

Description

code

string

결과코드

SUCCES/ERROR

message

string

nextToken

string

다음 페이지

만약 다음 페이지가 없을 경우 빈문자열

data

object[]

sellerProductId

data[].sellerProductId

integer

등록상품ID

sellerProductName

data[].sellerProductName

string

등록상품명

displayCategoryCode

data[].displayCategoryCode

integer

노출카테고리코드

categoryId

data[].categoryId

integer

카테고리ID

productId

data[].productId

number

ProductId

vendorId

data[].vendorId

string

판매자 ID

saleStartedAt

data[].saleStartedAt

string

판매시작일시
"yyyy-MM-dd’T’HH:mm:ss" 형식, *2099까지 입력 가능

saleEndedAt

data[].saleEndedAt

string

판매종료일시
"yyyy-MM-dd’T’HH:mm:ss" 형식, *2099까지 입력 가능

brand

data[].brand

string

브랜드
공식 브랜드명을 한글/영어로 입력

statusName

data[].statusName

string

등록상품 상태
심사중/ 임시저장/ 승인대기중/ 승인완료/ 부분승인완료/ 승인반려/ 상품삭제

심사중/ 임시저장/ 승인대기중/ 승인완료/ 부분승인완료/ 승인반려/ 상품삭제

Parameter Name	Status
IN_REVIEW	심사중
SAVED	임시저장
APPROVING	승인대기중
APPROVED	승인완료
PARTIAL_APPROVED	부분승인완료
DENIED	승인반려
DELETED	상품삭제

createdAt

data[].createdAt

string

판매등록일시
"yyyy-MM-dd’T’HH:mm:ss" 형식,

items

data[].items

object[]

itemName

data[].items[].itemName

string

업체상품 옵션명(벤더아이템 옵션명)

marketPlaceItemData

data[].items[].marketPlaceItemData

object

택배사 코드
택배사 코드 링크

sellerProductItemId

data[].items[].marketPlaceItemData.sellerProductItemId

object

업체상품 옵션 아이디(벤더아이템 옵션 ID)

vendorItemId

data[].items[].marketPlaceItemData.vendorItemId

object

옵션ID
임시저장 상태일 경우 값이 null 입니다. 상품 승인완료 시에 값이 표시됩니다.

rocketGrowthItemData

data[].items[].rocketGrowthItemData

object

sellerProductItemId

data[].items[].rocketGrowthItemData.sellerProductItemId

object

업체상품 옵션 아이디(벤더아이템 옵션 ID)

vendorItemId

data[].items[].rocketGrowthItemData.vendorItemId

object

옵션ID
임시저장 상태일 경우 값이 null 입니다. 상품 승인완료 시에 값이 표시됩니다.

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "nextToken": " 30100307028",
  "data": [
    {
      "items": [
        {
          "itemName": "RED",
          "marketPlaceItem": null,
          "rocketGrowthItem": {
            "vendorInventoryItemId": 30100601902,
            "vendorItemId": 123333333
          }
        }
      ],
      "sellerProductId": 30100307028,
      "sellerProductName": "RG test",
      "displayCategoryCode": 78361,
      "categoryId": 2357,
      "productId": null,
      "vendorId": "A00159255",
      "mdId": null,
      "mdName": null,
      "saleStartedAt": "2024-06-26T09:00:00",
      "saleEndedAt": "2099-12-31T09:00:00",
      "brand": "",
      "statusName": "승인반려",
      "createdAt": "2024-06-26T13:58:37",
      "registrationType": "RFM"
    }
  ]
}

# 05

에러 코드

HTTP	코드	메시지
400	HTTP_400	Bad Request

오류 사양

HTTP	유형	오류 메시지	해결 방법
400	400 (요청변수확인)	업체코드는 반드시 입력되어야 합니다.	판매자 ID(vendorId) 값을 올바로 입력했는지 확인합니다.
400	400 (요청변수확인)	Format of createdAt is `yyyy-MM-dd`	상품등록일시(createdAt) 값을 올바른 형식으로 입력했는지 확인합니다. "yyyy-MM-dd" 형식으로 입력합니다.