品類元數據查詢

支援地區：韓國、台灣

此 API 可透過「顯示品類代碼（displayCategoryCode）」查詢品類的資訊、屬性、所需文件及認證資訊等。

韓國地區說明

在建立商品時，商品建立訊息需與 Coupang 規定的各品類元資訊一致。

如何查詢顯示品類代碼（點擊）

台灣地區說明

如何查詢購買選項與允許值 (點擊)

通路

GET

/v2/providers/seller_api/apis/api/v2/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

請求參數

請求路徑參數部分

名稱					是否必填	類型	描述
displayCategoryCode					O	Number	顯示品類代碼

請求範例

無參數體內容要求

響應信息

名稱類型描述

code

Number

結果代碼:

SUCCESS/ERROR

message String 結果訊息

data Array 品類元資訊（根據商品數量重複 N 次）

isAllowSingleItem

Boolean

是否可註冊單件商品（是/否）

※ 即使為單一屬性商品，若輸入單一屬性值，則可直接註冊（2020 年底起適用）

attributes

Array

品類屬性列表（購買屬性 / 搜尋屬性）

根據屬性數量重複

商品審核前：可新增、修改、刪除屬性
商品審核後：僅可新增，不可刪除或修改

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	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

組屬性值：表示該屬性屬於某個屬性組，可能與其他屬性一起構成購買選項，並可能限制只能選擇其中一項。

NONE: 不是組属性

1 或 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 認證類型

name String 認證名稱

dataType

String

資料類型

CODE (輸入認證機構發行的代碼)

NONE (無須輸入代碼)

required

String

是否必填

MANDATORY (必填)

RECOMMEND (建議填寫)

OPTIONAL (選填)

allowedOfferConditions

Array

可註冊的商品狀態

可根據顯示的值，確認是否可註冊翻新或二手商品。

Response Value	Mean
NEW	新商品
REFURBISHED	翻新
USED_BEST	二手 (近全新)
USED_GOOD	二手 (良好)
USED_NORMAL	二手 (一般)

響應範例

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

錯誤說明

HTTP 狀態碼 (Error Type)	錯誤訊息	解決辦法
400 (Check Request Parameter)	找不到對應的管理類別代碼，請聯繫您的 MD 並輸入正確的展示類別	請確認您輸入的展示類別代碼是否正確
400 (Check Request Parameter)	請確認展示類別代碼是數字格式。	請確認展示類別代碼是否正確。展示類別代碼只能是數字格式

OPENAPI 관련 안내

此段落內的文章

通路

請求範例端點

請求參數

請求路徑參數部分

請求範例

響應信息

響應範例

錯誤說明

OPENAPI 관련 안내

此段落內的文章

通路

請求範例端點

請求參數

請求路徑參數部分

請求範例

響應信息

響應範例

錯誤說明

相關文章