關於加強 Coupang 品牌管理 Open API 方面的說明

本說明文件旨在針對 5 月 21 日 WING 管理後台發布的公告 《[OpenAPI] Notice on Mandatory Product Attributes Entry and Strengthened Monitoring》 提供進一步的補充 FAQ 與系統對接指引。 目前相關的 OpenAPI 變更正在內部審查（Review）中，將於近期正式發布。為避免影響日常營運，請相關開發商與品牌賣家務必在 2026 年 7 月 31 日 前完成評估及系統升級串接。

我們目前已推出以下全新 API：

1. 全新品牌搜尋 API (Brand Search API)： 透過品牌名稱查詢品牌資訊。

2. 全新已註冊品牌列表 API (Brand Enrolled API)： 賣家可獲取系統中已註冊的品牌資訊列表。

3. 全新品牌 ID 查詢 API (Get Brand by ID API)： 賣家可透過 brandId 獲取詳細品牌資訊。

4. 商品建立 API 更新 (Update Product Creation API)： 新增 brandId 欄位，並支援在 attribute 陣列中傳入 GTIN / MPN 的新格式。

Q1: 如果到 6 月 1 日還沒有補充相關資訊，現存的商品會被下架嗎？老舊 API 用戶會受到什麼影響？

• 對於已上架的現存商品： 6 月 1 日後若未及時補充相關識別碼資訊，商品不會被直接下架，但會面臨平台限制曝光（降權或限流）的影響。

• 對於新建立的商品（分為新舊用戶）：

  • 新用戶（2026 年 6 月 1 日及之後新發放的金鑰 Key）： 缺失必填屬性將直接導致商品在審核流程中被拒絕（審核駁回）。

  • 舊用戶（2026 年 6 月 1 日前已生效的金鑰 Key）： 短期內註冊新商品不會直接被攔截或報錯，但請務必在 2026 年 7 月 31 日 最終截止日期前完成 API 升級，否則屆時新商品發布也將在審核流程中被拒絕（攔截）。

   

Q2: 這次 OpenAPI 到底有哪些具體變更？涉及哪些新介面和新欄位？

這次升級將新增 1 個欄位和 3 個全新介面（End-points）。現有的舊欄位（如 barcode / modelNo / emptyBarcode）將保持完全隔離，互不影響。

• 商品建立 API 新增欄位： 新增 brandId 欄位（與目前的 brand 文字名稱對應）。同時，可在 attributes 陣列參數中傳入 Global Trade Item Number 或 Manufacturer Part Number.

• 全新 Brand Search API（品牌搜尋介面）： 支援透過品牌名稱字串查詢 Coupang 系統標準的 brandId 及其詳細資訊。

• 全新 Enrolled Brands API（已註冊品牌列表介面）： 允許開發商查詢目前系統中所有已註冊的標準品牌名稱。

• 全新 Get Brand by ID API（品牌 ID 查詢介面）： 允許賣家透過 brandId 獲取對應的品牌資訊。

#JSON 請求範例 
"items": [
  {
    "itemName": "Black",
    "attributes": [
      {
        "attributeTypeName": "Global Trade Item Number",
        "attributeValueName": "0194253941234"
      },
      {
        "attributeTypeName": "Manufacturer Part Number",
        "attributeValueName": "MT0Q3FE/A"
      }
    ]
  }
]

Q3: 只要是有品牌資訊的商品，就必須要強制填寫 MPN 或 GTIN 嗎？如果商品在客觀上確實沒有該怎麼處理？

• 非絕對強制，視品牌具體要求而定： 這並非無條件的強制要求。開發商應先呼叫 Brand Search API，並根據回傳結果中的 isUIDRequired 布林值進行邏輯判斷：

  • 若為 true：則必須傳入 MPN 或 GTIN。

  • 若為 false：則 MPN 或 GTIN 欄位為選填（非強制）。

• 無識別碼的特殊情況： 如果商品在客觀上確實不具備品牌或任何識別碼，相關欄位可以留空。

• 重要注意事項： 若商品名稱（標題）中包含了品牌名稱，但 brand 欄位卻留空，該商品在審核時將會被拒絕，或是在前台遭到嚴重的曝光限制。

Q4: 不同商品（如跨尺寸、跨顏色）的 MPN 或 GTIN 資訊是否允許重複？

一般情況下，針對同品牌、同款式但不同尺寸或顏色的商品，系統驗證支援使用相同的識別碼。具體驗證邏輯請以正式上線後的 OpenAPI 回傳錯誤碼為準。

Q5: 平台是否會開放用於「註冊新品牌」的 API 介面？

不會，目前暫不開放透過 API 註冊新品牌的介面。相反地，Coupang 近期將在 WING 管理後台直接上線全新的品牌註冊入口。若有新品牌入駐需求，賣家需前往 WING 後台進行手動申請。

Q6: 作為系統整合商（ERP）或自研賣家，現在該如何配合調整現有的現存商品？

目前 OpenAPI 暫不支援透過介面直接修改或更新現存商品的屬性欄位（如直接補填 brandId）。針對現有的現存商品，請引導或協助賣家登入 WING 後台透過以下兩種方式進行批次或單一修復：

• 方法一：WING 後台單品編輯 登入 WING > 商品管理 > [查詢/修改商品]。在網頁上方的「更新資訊並提升銷售額」區塊中，篩選出提示「輸入缺失的必填選項資訊」或「輸入必填屬性」的商品。點擊「修改商品」填入識別碼並儲存。(註：若下方出現「AI 建議」，可審核後套用，AI 建議不會自動生效。)

• 方法二：WING 後台 Excel 批次上傳 登入 WING > 商品管理 > [查詢/修改商品]。在「更新資訊並提升銷售額」區塊底部點擊「批次輸入缺失的必填屬性資訊」。下載 [步驟1] 的 Excel 範本，補全缺失的屬性/識別碼資訊後儲存，再透過 [步驟2] 上传更新。