coupang
GET/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}2609170000

카테고리 메타정보 조회

KRTW
# 01

요약

카테고리 메타정보 조회

# 02

상세

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

노출 카테고리코드(displayCategoryCode)를 이용하여 해당 카테고리에 속한 고시정보, 옵션, 구비서류, 인증정보 목록 등을 조회합니다.

상품 생성 시, 쿠팡에서 규정하고 있는 각 카테고리의 메타 정보와 일치하는 항목으로 상품 생성 전문을 구성해야 합니다.

*노출 카테고리코드 조회 방법(Click)

*필수 구매옵션 및 허용값 확인 방법(Click)

경로

GET/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}

예시 엔드포인트

https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/78877
# 03

Path 파라미터

NameTypeDescription
displayCategoryCode*number
노출카테고리코드
# 04

응답 본문

응답 메시지

NameTypeDescription
codestring
결과코드
SUCCESS/ERROR
messagestring
결과 메세지
dataobject
카테고리 메타정보
조회된 업체상품 개수만큼 N번 반복
isAllowSingleItem
data.isAllowSingleItem
boolean
단일상품 등록 가능 여부
true/false
2024년 10월 10일부터 필수 구매옵션 입력 시 데이터 형식에 맞게 입력해야 정상적으로 상품등록이 가능합니다.
attributes
data.attributes
object[]
카테고리 옵션목록 (구매옵션/검색옵션)
옵션 개수 만큼 반복
상품 판매 승인 이전에는 attributes의 추가, 변경, 삭제가 가능
상품 판매 승인 이후에는 attributes의 추가가 가능하나 attributes의 삭제, 변경 등은 불가
attributeTypeName
data.attributes[].attributeTypeName
string
옵션타입명
dataType
data.attributes[].dataType
string
데이터형식
Response Value Mean
STRING 문자열
NUMBER 숫자
DATE 날짜
basicUnit
data.attributes[].basicUnit
string
기본단위
예)
길이(cm) : cm,mm,m,km
길이(인치) : in,ft, yd
무게(g) : mg, g, kg, t, oz, lb
부피(ml) : cc, ml, L
데이터 용량(GB) : KB, MB, GB, TB
수량(개) : 개, 개입, 매, 매입, 팩, 입, 장, 병, 인용, 인분, box, Ea, 포, 캔, 박스, 스틱, 권, set, 세트, 캡슐, 통, 정, 봉, 마리

*음료 카테고리에서는 사용하지 않는 필드 입니다.
usableUnits
data.attributes[].usableUnits
string[]
사용가능한단위값목록
예)
길이(cm) : cm,mm,m,km
길이(인치) : in,ft, yd
무게(g) : mg, g, kg, t, oz, lb
부피(ml) : cc, ml, L
데이터 용량(GB) : KB, MB, GB, TB
수량(개) : 개, 개입, 매, 매입, 팩, 입, 장, 병, 인용, 인분, box, Ea, 포, 캔, 박스, 스틱, 권, set, 세트, 캡슐, 통, 정, 봉, 마리
required
data.attributes[].required
string
Response Value Mean
MANDATORY 필수
OPTIONAL 선택
※ 자유로운 구매옵션 구성(open attribute)이 가능합니다. 자세한 사항은 아래 가이드에서 확인할 수 있습니다.
구매옵션 자유 입력 가이드 (20201012 변경사항)

2024년 10월10일 부터 자유 구매옵션 구성을 할 경우 노출에 제한이 됩니다.
groupNumber
data.attributes[].groupNumber
string
그룹속성값(속성 중 택1 형태의 속성여부)
NONE : 그룹속성 아님
1 or 2 : 그룹 속성임. 이 경우 속성정보에 동일한 groupNumber 값이 있는 속성이 있으며 두개 중 1개만 입력 해야 함.
exposed
data.attributes[].exposed
string
구매옵션/검색옵션 구분값
Response Value Mean
EXPOSED 구매옵션
NONE 검색옵션
noticeCategories
data.noticeCategories
object[]
상품고시정보목록
옵션 개수 만큼 반복
noticeCategoryName
data.noticeCategories[].noticeCategoryName
string
상품고시정보카테고리명
noticeCategoryDetailNames
data.noticeCategories[].noticeCategoryDetailNames
object[]
상품고시정보카테고리상세목록
noticeCategoryDetailName
data.noticeCategories[].noticeCategoryDetailNames[].noticeCategoryDetailName
string
상품고시정보카테고리상세명
required
data.noticeCategories[].noticeCategoryDetailNames[].required
string
필수여부
Response Value Mean
MANDATORY 필수
OPTIONAL 선택
requiredDocumentNames
data.requiredDocumentNames
object[]
구비서류목록
옵션 개수 만큼 반복
templateName
data.requiredDocumentNames[].templateName
string
구비서류명
required
data.requiredDocumentNames[].required
string
구비서류필수여부
Response Value Mean
MANDATORY 필수
OPTIONAL 선택
certifications
data.certifications
object[]
상품 인증 정보
옵션 개수 만큼 반복
certificationType
data.certifications[].certificationType
string
상품등록/수정 시 certificationType에 입력
name
data.certifications[].name
string
인증 정보 이름
dataType
data.certifications[].dataType
string
인증 정보 이름
CODE (인증기관에서 발급받은 코드 입력)
NONE (코드 입력 불필요)
required
data.certifications[].required
string
필수여부
MANDATORY(필수)
RECOMMEND(추천)
OPTIONAL(선택)
allowedOfferConditions
data.allowedOfferConditions
string[]
허용된 상품 상태

표시된 값에 따라 리퍼, 중고 상품 등록이 가능한지 확인할 수 있습니다.
Response Value Mean
NEW 새 상품
REFURBISHED 리퍼
USED_BEST 중고(최상)
USED_GOOD 중고(상)
USED_NORMAL 중고(중)

Response Example

{
  "code": "SUCCESS",
  "message": "",
  "data": {
    "isAllowSingleItem": true,
    "attributes": [
      {
        "attributeTypeName": "수량",
        "dataType": "NUMBER",
        "basicUnit": "개",
        "usableUnits": [
          "개",
          "개입",
          "매",
          "매입",
          "팩",
          "입",
          "장",
          "병",
          "인용",
          "인분",
          "box",
          "Ea",
          "포",
          "캔",
          "박스",
          "스틱",
          "권",
          "set",
          "세트",
          "조",
          "캡슐",
          "통",
          "정",
          "봉",
          "마리",
          "롤",
          "p",
          "구",
          "피스",
          "회",
          "회분",
          "단계",
          "번",
          "프렛",
          "음판",
          "건반",
          "쪽",
          "단",
          "칸",
          "종",
          "분류",
          "현",
          "선",
          "공",
          "자리",
          "폭",
          "rpm",
          "색",
          "대"
        ],
        "required": "OPTIONAL",
        "groupNumber": "NONE",
        "exposed": "EXPOSED"
      },
      {
        "attributeTypeName": "자동차거치용품 거치대고정",
        "dataType": "STRING",
        "basicUnit": "없음",
        "usableUnits": [],
        "required": "OPTIONAL",
        "groupNumber": "NONE",
        "exposed": "NONE"
      },
      {
        "attributeTypeName": "헤드 회전 가능여부",
        "dataType": "STRING",
        "basicUnit": "없음",
        "usableUnits": [],
        "required": "OPTIONAL",
        "groupNumber": "NONE",
        "exposed": "NONE"
      },
      {
        "attributeTypeName": "각도조절 가능여부",
        "dataType": "STRING",
        "basicUnit": "없음",
        "usableUnits": [],
        "required": "OPTIONAL",
        "groupNumber": "NONE",
        "exposed": "NONE"
      }
    ],
    "noticeCategories": [
      {
        "noticeCategoryName": "자동차용품(자동차부품/기타 자동차용품)",
        "noticeCategoryDetailNames": [
          {
            "noticeCategoryDetailName": "품명 및 모델명",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "출시년월",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "KC 인증 필 유무",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "제조자(수입자)",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "제조국",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "크기",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "적용차종",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "품질보증기준",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "A/S 책임자와 전화번호",
            "required": "MANDATORY"
          }
        ]
      },
      {
        "noticeCategoryName": "기타 재화",
        "noticeCategoryDetailNames": [
          {
            "noticeCategoryDetailName": "품명 및 모델명",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "인증사항",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "제조국(원산지)",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "제조자(수입자)",
            "required": "MANDATORY"
          },
          {
            "noticeCategoryDetailName": "소비자상담 관련 전화번호",
            "required": "MANDATORY"
          }
        ]
      }
    ],
    "requiredDocumentNames": [
      {
        "templateName": "기타인증서류",
        "required": "OPTIONAL"
      },
      {
        "templateName": "수입신고필증(병행수입 선택시)",
        "required": "MANDATORY_PARALLEL_IMPORTED"
      },
      {
        "templateName": "인보이스영수증(해외구매대행 선택시)",
        "required": "MANDATORY_OVERSEAS_PURCHASED"
      }
    ],
    "certifications": [
      {
        "certificationType": "NOT_REQUIRED",
        "name": "인증대상아님",
        "dataType": "NONE",
        "required": "OPTIONAL"
      },
      {
        "certificationType": "PRESENTED_IN_DETAIL_PAGE",
        "name": "상세설명에 표시",
        "dataType": "NONE",
        "required": "OPTIONAL"
      },
      {
        "certificationType": "KC_KID_CERTIFICATION",
        "name": "KC인증 어린이제품 안전인증",
        "dataType": "CODE",
        "required": "RECOMMEND"
      },
      {
        "certificationType": "KC_KID_CONFIRM",
        "name": "KC인증 어린이제품 안전확인",
        "dataType": "CODE",
        "required": "OPTIONAL"
      },
      {
        "certificationType": "KC_KID_PROVIDER",
        "name": "KC인증 어린이제품 공급자적합성확인",
        "dataType": "NONE",
        "required": "OPTIONAL"
      },
      {
        "certificationType": "KC_ELECTRONICS_CERTIFICATION",
        "name": "KC인증 전기용품 안전인증",
        "dataType": "CODE",
        "required": "OPTIONAL"
      },
      {
        "certificationType": "KC_ELECTRONICS_CONFIRM",
        "name": "KC인증 전기용품 안전확인",
        "dataType": "CODE",
        "required": "OPTIONAL"
      },
      {
        "certificationType": "KC_ELECTRONICS_PROVIDER",
        "name": "KC인증 전기용품 공급자적합성확인",
        "dataType": "NONE",
        "required": "OPTIONAL"
      },
      {
        "certificationType": "KC_HOUSEHOLD_CERTIFICATION",
        "name": "KC인증 생활용품 안전인증",
        "dataType": "CODE",
        "required": "RECOMMEND"
      },
      {
        "certificationType": "KC_HOUSEHOLD_CONFIRM",
        "name": "KC인증 생활용품 자율안전확인",
        "dataType": "CODE",
        "required": "RECOMMEND"
      },
      {
        "certificationType": "KC_HOUSEHOLD_QUALITY",
        "name": "KC인증 생활용품 안전품질표시",
        "dataType": "NONE",
        "required": "RECOMMEND"
      },
      {
        "certificationType": "KC_HOUSEHOLD_PACKAGING",
        "name": "KC인증 생활용품 어린이보호포장",
        "dataType": "NONE",
        "required": "RECOMMEND"
      },
      {
        "certificationType": "COMMUNICATION_EQUIPMENT",
        "name": "방송통신기자재 적합성 평가 대상",
        "dataType": "CODE",
        "required": "RECOMMEND"
      }
    ],
    "allowedOfferConditions": [
      "NEW",
      "REFURBISHED",
      "USED_BEST",
      "USED_GOOD",
      "USED_NORMAL"
    ]
  }
}
# 05

에러 코드

HTTP코드메시지
400HTTP_400Bad Request

오류 사양

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

관리카테고리를 찾을 수 없는 노출카테고리코드 입니다. 담당MD에게 확인하고 유효한 노출카테고리를 입력해주세요.

올바른 노출카테고리코드를 입력했는지 확인합니다.

400400 (요청변수확인)

전시카테고리코드는 숫자형으로 입력해주세요.

올바른 노출(전시)카테고리코드를 입력했는지 확인합니다. 노출(전시)카테고리코드는 숫자로만 입력 가능합니다.