使用displayCategoryCode可以搜索属于相关类别的通知信息、选项、所需文件和认证信息列表。创建产品时，产品创建文本必须由与 Coupang 指定的每个类别的元信息相匹配的项目组成。在类目元信息查询的情况下，使用与市场相同的端点，并提供一个附加参数来确定所搜索的类目是否需要有效期信息。对于 Rocket Growth 产品，注册产品时必须根据适用参数提供有效期信息。
Path
GET
/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}
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 |
是否可以注册单件商品 是/否 ※ 与isAllowSingleItem的值无关，如果输入一个单一属性商品，在商品创建时则无需输入属性值(attributes)即可注册。(2020年底开始适用) |
|||||||||||||||
| attributes | Array |
品类属性列表 (购买属性/搜索属性) 根据属性数量重复
|
|||||||||||||||
| attributeTypeName | String |
属性类型名 |
|||||||||||||||
| required | String |
※ 可自由组成购买属性(open attribute)。详细信息请参阅下方指南。 |
|||||||||||||||
| 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 值相同的属性，则只输入其中一个即可 |
|||||||||||||||
| 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 Status Code (Error Type) | Error Message | Solution |
|---|---|---|
|
400 (确认请求参数) |
未找到该显示品类代码的管理品类。 请向负责的MD确认并输入有效显示品类。 |
请确保输入的显示品类代码正确无误。 |
|
400 (确认请求参数) |
请以数字形式输入显示品类代码。 |
请确认您输入的显示(展示)品类代码是否正确。显示(展示)品类代码仅支持输入数字。 |