GET
/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}2609170000品类元数据查询
# 01
简介
品类元数据查询
# 02
详细内容
API支持的买家用户地区:韩国
可通过显示品类代码(displayCategoryCode) 查询品类的信息、属性、所需文件及认证信息列表等。
创建商品时,商品创建message应由与酷澎规定的各品类元信息一致的内容组成。
路径
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 参数
| Name | Type | Description |
|---|---|---|
| displayCategoryCode* | number | 显示品类代码
|
# 04
响应体
响应消息
| Name | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | string | 结果代码: SUCCESS/ERROR | ||||||||||||
| message | string | 结果信息
| ||||||||||||
| data | object | 品类元信息 按查询到的卖家商品数量,重复N次 | ||||||||||||
| isAllowSingleItem data.isAllowSingleItem | boolean | 是否可以注册单件商品 是/否 ※ 与isAllowSingleItem的值无关,如果输入一个单一属性商品,在商品创建时则无需输入属性值(attributes)即可注册。(2020年底开始适用) | ||||||||||||
| attributes data.attributes | object[] | 品类属性列表 (购买属性/搜索属性) 根据属性数量重复
| ||||||||||||
| attributeTypeName data.attributes[].attributeTypeName | string | 属性类型名
| ||||||||||||
| dataType data.attributes[].dataType | string | 数据类型
| ||||||||||||
| 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 |
自由输入购买属性指南(20201012修改) | ||||||||||||
| groupNumber data.attributes[].groupNumber | string | 组属性值(属性中择1,是否为所属状态的属性) NONE: 不是组属性 1 or 2: 是组属性。此时,若属性信息中有与groupNumber 值相同的属性,则只输入其中一个即可 | ||||||||||||
| exposed data.attributes[].exposed | string | 购买属性/搜索属性区分值
| ||||||||||||
| 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 | 是否为必须项
| ||||||||||||
| requiredDocumentNames data.requiredDocumentNames | object[] | 所需文件列表 根据属性数量重复 | ||||||||||||
| templateName data.requiredDocumentNames[].templateName | string | 所需文件名
| ||||||||||||
| required data.requiredDocumentNames[].required | string | 是否必须提交所需文件
| ||||||||||||
| 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 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 | 代码 | 消息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
错误说明
| HTTP | 类型 | 错误消息 | 解决方案 |
|---|---|---|---|
| 400 | 400 (确认请求参数) | 未找到该显示品类代码的管理品类。 请向负责的MD确认并输入有效显示品类。 | 请确保输入的显示品类代码正确无误。 |
| 400 | 400 (确认请求参数) | 请以数字形式输入显示品类代码。 | 请确认您输入的显示(展示)品类代码是否正确。显示(展示)品类代码仅支持输入数字。 |