coupang
GET/v2/providers/seller_api/apis/api/v1/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}v1

品类元数据查询

# 01

简介

API支持的买家用户地区:韩国 可通 过显 示品 类 代 码 (displayCategoryCode) 查询 品 类 的信息、 属 性、所需文件及 认证 信息列表等 。 创 建商品 时 , 商品 创 建 message 应 由 与 酷澎 规 定的各品 类 元信息一致的 内 容 组 成。

# 02

详细内容

API支持的买家用户地区:韩国

可通过显示品(displayCategoryCode) 查询的信息、性、所需文件及认证信息列表等 

建商品商品message酷澎定的各品元信息一致的成。  

  

*如何查询显示品 () 

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

是否可以注册单件商品 

/  

isAllowSingleItem如果入一个单性商品,在商品时则无需(attributes)即可注(2020年底始适用) 

  attributes Array

类属性列表 (购买属性/搜索) 

根据量重 

  •    商品售通过审批前,可添加、更改或attributes 
  •    商品售通过审批后,可添加attributes,但不可除或更改 
    attributeTypeName String 属性类型名 
    required String
Response Value Mean
MANDATORY 必选
OPTIONAL 可选

可自由购买属(open attribute)。详细信息请参阅下方指南。  

自由购买属性指南(20201012修改)  

    dataType String
数据类型
Response Value Mean
STRING 字符串 
NUMBER 数字 
DATE 日期 
    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、套、胶囊、桶、容器、纸包、头

   
inputType
String
属性的输入类型
Response Value Mean
INPUT
属性值可以通过输入字符串形式定义
SELECT
属性值不可自定义,需要从inputValues中选择。
   
inputValues
Array

该属性的有效取值列表。

属性值必须与此列表中的其中一个值完全一致

    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
购买属性/搜索属性区分值  
Response Value Mean
EXPOSED 购买属性 
NONE 搜索属性 
  noticeCategories Array

商品信息列表 

根据量重 

    noticeCategoryName String 商品信息品类名 
    noticeCategoryDetailNames String 商品信息品类详细列表 
      noticeCategoryDetailName String 商品信息品类详细名称 
      required String
是否为必须项
Response Value Mean
MANDATORY 必须 
OPTIONAL 可选 
  requiredDocumentNames Array

所需文件列表 

根据量重 

    templateName String 所需文件名 
    required String
是否必须提交所需文件 
Response Value Mean
MANDATORY 必填
OPTIONAL 选填
  certifications Array

商品认证信息 

根据量重 

    certificationType String 注册/修改商品时,需输入certificationType 
    name String 认证信息名称 
    dataType String

认证信息名称 

CODE (输入认证机构发行的代码 

NONE (无需输入代码) 

    required String

是否为必须项 

MANDATORY (必须 

RECOMMEND (建议填写 

OPTIONAL (可选) 

  allowedOfferConditions Array

允许的商品状态 

可根示的确认是否可以注翻新或二手商品 

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"
    ]
  }
}

Error Spec

HTTP Status Code (Error Type) Error Message Solution
400 (认请参数)  未找到该显示品类代码的管理品类请向负责MD确认并输入有效显示品类  请确保输入的显示品类代码正确无误。 
400 (认请参数)  请以数字形式输入显示品类代码  请确认您输入的显示(展示)品类代码是否正确。显示(展示)品类代码仅支持输入数字。