노출 카테고리코드(displayCategoryCode)를 이용하여 해당 카테고리에 속한 고시정보, 옵션, 구비서류, 인증정보 목록 등을 조회합니다.
상품 생성 시, 쿠팡에서 규정하고 있는 각 카테고리의 메타 정보와 일치하는 항목으로 상품 생성 전문을 구성해야 합니다.
Path
GET
/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}
Example Endpoint
https://api-gateway.coupang.com/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/78877
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
※ isAllowSingleItem 값에 상관없이 1개의 단일옵션 상품을 입력할 경우 상품생성에서 속성값(attributes)입력 없이 상품등록이 가능합니다. ( 2020년 말 이후부터 적용)
|
||||||||||||||||
| attributes | Array |
카테고리 옵션목록 (구매옵션/검색옵션)
옵션 개수 만큼 반복
상품 판매 승인 이전에는 attributes의 추가, 변경, 삭제가 가능
상품 판매 승인 이후에는 attributes의 추가가 가능하나 attributes의 삭제, 변경 등은 불가 |
||||||||||||||||
| attributeTypeName | String |
옵션타입명
|
||||||||||||||||
| required | String |
※ 자유로운 구매옵션 구성(open attribute)이 가능합니다. 자세한 사항은 아래 가이드에서 확인할 수 있습니다.
구매옵션 자유 입력 가이드 (20201012 변경사항) |
||||||||||||||||
| 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 |
허용된 상품 상태
표시된 값에 따라 리퍼, 중고 상품 등록이 가능한지 확인할 수 있습니다.
|
||||||||||||||||
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"
]
}
}Error Spec
| HTTP 상태 코드(오류 유형) | 오류 메시지 | 해결 방법 |
|---|---|---|
| 400 (요청변수확인) | 관리카테고리를 찾을 수 없는 노출카테고리코드 입니다. 담당MD에게 확인하고 유효한 노출카테고리를 입력해주세요. | 올바른 노출카테고리코드를 입력했는지 확인합니다. |
| 400 (요청변수확인) | 전시카테고리코드는 숫자형으로 입력해주세요. | 올바른 노출(전시)카테고리코드를 입력했는지 확인합니다. 노출(전시)카테고리코드는 숫자로만 입력 가능합니다. |