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

品類元數據查詢

# 01

簡介

支援地區:韓國、台灣 此 API 可透過「顯示品類代碼(displayCategoryCode)」查詢品類的資訊、屬性、所需文件及認證資訊等。 韓國地區說明 在建立商品時,商品建立訊息需與 Coupang 規定的各品類元資訊一致。

# 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/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) 請確認展示類別代碼是數字格式。 請確認展示類別代碼是否正確。展示類別代碼只能是數字格式