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

品類元數據查詢

# 01

簡介

品類元數據查詢

# 02

詳細內容

支援地區:韓國、台灣

此 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/v2/marketplace/meta/category-related-metas/display-category-codes/{displayCategoryCode}
# 03

Path 參數

NameTypeDescription
displayCategoryCode*number
顯示品類代碼
# 04

回應內容

回應訊息

NameTypeDescription
codestring
結果代碼:

SUCCESS/ERROR
messagestring
結果訊息
dataobject
品類元資訊(根據商品數量重複 N 次)
isAllowSingleItem
data.isAllowSingleItem
boolean
是否可註冊單件商品(是/否)

※ 即使為單一屬性商品,若輸入單一屬性值,則可直接註冊(2020 年底起適用)
attributes
data.attributes
object[]
品類屬性列表(購買屬性 / 搜尋屬性)

根據屬性數量重複
  • 商品審核前:可新增、修改、刪除屬性
  • 商品審核後:僅可新增,不可刪除或修改
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
組屬性值:表示該屬性屬於某個屬性組,可能與其他屬性一起構成購買選項,並可能限制只能選擇其中一項。

NONE: 不是組属性

1 或 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
認證類型
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 (Check Request Parameter)

找不到對應的管理類別代碼,請聯繫您的 MD 並輸入正確的展示類別

請確認您輸入的展示類別代碼是否正確

400400 (Check Request Parameter)

請確認展示類別代碼是數字格式。

請確認展示類別代碼是否正確。展示類別代碼只能是數字格式