GET
/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}v1카테고리 메타 정보 조회
# 01
요약
노출 카테고리코드(displayCategoryCode)를 이용하여 해당 카테고리에 속한 고시정보, 옵션, 구비서류, 인증정보 목록 등을 조회합니다. 상품 생성 시, 쿠팡에서 규정하고 있는 각 카테고리의 메타 정보와 일치하는 항목으로 상품 생성 전문을 구성해야 합니다. 카테고리 메타 정보 조회의 경우 마켓플레이스와 동일한 Endpoint를 사용하며, 조회된 카테고리에 대해 유통기간 정보를 필요 여부에 대한 파라미터가 추가 응답됩니다. 로켓그로스 상품의 경우 해당 파라미터를 기준으로 상품등록 시 유통기간 정보가 제공되어야 합니다.
# 02
상세
노출 카테고리코드(displayCategoryCode)를 이용하여 해당 카테고리에 속한 고시정보, 옵션, 구비서류, 인증정보 목록 등을 조회합니다. 상품 생성 시, 쿠팡에서 규정하고 있는 각 카테고리의 메타 정보와 일치하는 항목으로 상품 생성 전문을 구성해야 합니다. 카테고리 메타 정보 조회의 경우 마켓플레이스와 동일한 Endpoint를 사용하며, 조회된 카테고리에 대해 유통기간 정보를 필요 여부에 대한 파라미터가 추가 응답됩니다. 로켓그로스 상품의 경우 해당 파라미터를 기준으로 상품등록 시 유통기간 정보가 제공되어야 합니다.
Example Endpoint
Request Parameters
Path Segment Parameter
| Name | Required | Type | Description |
| displayCategoryCode | O | Number | 노출카테고리코드 |
Request Example
not require body
Response Message
| Name | Type | Description | |||||||||||||||
| code | Number |
결과코드
SUCCESS/ERROR
|
|||||||||||||||
| message | String |
결과 메세지
|
|||||||||||||||
| data | Array |
카테고리 메타정보
조회된 업체상품 개수만큼 N번 반복
|
|||||||||||||||
| isAllowSingleItem | Boolean |
단일상품 등록 가능 여부
true/false
2024년 10월 10일부터 필수 구매옵션 입력 시 데이터 형식에 맞게 입력해야 정상적으로 상품등록이 가능합니다.
|
|||||||||||||||
| attributes | Array |
카테고리 옵션목록 (구매옵션/검색옵션)
옵션 개수 만큼 반복
상품 판매 승인 이전에는 attributes의 추가, 변경, 삭제가 가능
상품 판매 승인 이후에는 attributes의 추가가 가능하나 attributes의 삭제, 변경 등은 불가 |
|||||||||||||||
| attributeTypeName | String |
옵션타입명
|
|||||||||||||||
| required | String |
※ 자유로운 구매옵션 구성(open attribute)이 가능합니다. 자세한 사항은 아래 가이드에서 확인할 수 있습니다.
구매옵션 자유 입력 가이드 (20201012 변경사항) 2024년 10월10일 부터 자유 구매옵션 구성을 할 경우 노출에 제한이 됩니다.
|
|||||||||||||||
| dataType | String |
데이터형식
|
|||||||||||||||
| 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 | Array |
사용가능한단위값목록
예)
길이(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, 세트, 캡슐, 통, 정, 봉, 마리 |
|||||||||||||||
| groupNumber | String |
그룹속성값(속성 중 택1 형태의 속성여부)
NONE : 그룹속성 아님
1 or 2 : 그룹 속성임. 이 경우 속성정보에 동일한 groupNumber 값이 있는 속성이 있으며 두개 중 1개만 입력 해야 함. |
|||||||||||||||
| exposed | String |
구매옵션/검색옵션 구분값
|
|||||||||||||||
| noticeCategories | Array |
상품고시정보목록
옵션 개수 만큼 반복
|
|||||||||||||||
| noticeCategoryName | String |
상품고시정보카테고리명
|
|||||||||||||||
| noticeCategoryDetailNames | String |
상품고시정보카테고리상세목록
|
|||||||||||||||
| noticeCategoryDetailName | String |
상품고시정보카테고리상세명
|
|||||||||||||||
| required | String |
필수여부
|
|||||||||||||||
| requiredDocumentNames | Array |
구비서류목록
옵션 개수 만큼 반복
|
|||||||||||||||
| templateName | String |
구비서류명
|
|||||||||||||||
| required | String |
구비서류필수여부
|
|||||||||||||||
| certifications | Array |
상품 인증 정보
옵션 개수 만큼 반복
|
|||||||||||||||
| certificationType | String |
상품등록/수정 시 certificationType에 입력
|
|||||||||||||||
| name | String |
인증 정보 이름
|
|||||||||||||||
| dataType | String |
인증 정보 이름
CODE (인증기관에서 발급받은 코드 입력)
NONE (코드 입력 불필요) |
|||||||||||||||
| required | String |
필수여부
MANDATORY(필수)
RECOMMEND(추천) OPTIONAL(선택) |
|||||||||||||||
| allowedOfferConditions | Array |
허용된 상품 상태
표시된 값에 따라 리퍼, 중고 상품 등록이 가능한지 확인할 수 있습니다.
|
|||||||||||||||
| isExpirationDateRequiredForRocketGrowth | Boolean | 로켓그로스 상품 SKU정보에 대한 유통기간 필수 여부 | |||||||||||||||
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"
],
"isExpirationDateRequired": true
}
}
Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | 관리카테고리를 찾을 수 없는 노출카테고리코드 입니다. 담당MD에게 확인하고 유효한 노출카테고리를 입력해주세요. | 올바른 노출카테고리코드를 입력했는지 확인합니다. |
| 400 (요청변수확인) | 전시카테고리코드는 숫자형으로 입력해주세요. | 올바른 노출(전시)카테고리코드를 입력했는지 확인합니다. 노출(전시)카테고리코드는 숫자로만 입력 가능합니다. |