coupang
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 参数

NameTypeDescription
displayCategoryCode*number
显示品类代码
# 04

响应体

响应消息

NameTypeDescription
codestring
结果代码:

SUCCESS/ERROR
messagestring
结果信息
dataobject
品类元信息

按查询到的卖家商品数量,重复N次
isAllowSingleItem
data.isAllowSingleItem
boolean
是否可以注册单件商品

是/否

※ 与isAllowSingleItem的值无关,如果输入一个单一属性商品,在商品创建时则无需输入属性值(attributes)即可注册。(2020年底开始适用)
attributes
data.attributes
object[]
品类属性列表 (购买属性/搜索属性)

根据属性数量重复
  • 商品销售通过审批前,可添加、更改或删除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修改)
groupNumber
data.attributes[].groupNumber
string
组属性值(属性中择1,是否为所属状态的属性)

NONE: 不是组属性

1 or 2: 是组属性。此时,若属性信息中有与groupNumber 值相同的属性,则只输入其中一个即可
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 (确认请求参数)

请以数字形式输入显示品类代码。

请确认您输入的显示(展示)品类代码是否正确。显示(展示)品类代码仅支持输入数字。