产品 API2026-06-15

关于加强Coupang 品牌管理 Open API 方面的说明

本说明文档旨在针对 5 月 21 日 WING 后台发布的公告 《[OpenAPI] Notice on Mandatory Product Attributes Entry and Strengthened Monitoring》 提供进一步的补充 FAQ 与技术指导。目前相关的 OpenAPI 变更正在内部评审（Review）中，将于近期正式发布。为避免影响日常业务，请相关开发者与品牌卖家务必在 2026 年 7 月 31 日 前完成评估及系统升级对接。

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

全新品牌搜索 API (Brand Search API)： 通过品牌名称查询品牌信息。
全新已注册品牌列表 API (Brand Enrolled API)： 卖家可获取系统中已注册的品牌信息列表。
全新品牌 ID 查询 API (Get Brand by ID API)： 卖家可通过 brandId 获取详细品牌信息。
商品创建 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",
        "exposed": "NONE"
      },
      {
        "attributeTypeName": "Manufacturer Part Number",
        "attributeValueName": "MT0Q3FE/A",
        "exposed": "NONE"
      }
    ]
  }
]

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] 上传更新。

关于 加强Coupang 品牌管理 Open API 方面的说明