[公告] 必填购买属性强制填写及 API 变更通知 (2026年 2月 2日 生效)
您好，这里是 Coupang。
根据现行的商品信息政策，Coupang 要求的属性值是销售商品的必填项。为了给顾客提供更好的购物体验，我们将针对新商品及已注册的现有商品，加强对各品类要求的“必填购买属性”输入情况的监控。
如果遗漏了必填购买属性，可能会导致如下的商品曝光限制或注册失败，因此请务必确认下方的技术变更事项。本政策不仅适用于新商品，也将依次适用于已注册的现有商品。
请注意，本文所涉及的更新内容仅针对韩国市场，对台湾地区的卖家不产生影响。
1. 政策概要
实施日期： 2026年 2月 2日起依次适用
-
主要措施内容：
商品曝光限制： 若遗漏必填购买属性，WING 系统内将标记为“曝光限制”，并可能屏蔽搜索曝光。
商品注册失败： 若遗漏必填购买属性，通过 API 发起的商品注册请求可能会被拒绝，或导致最终注册失败。
2. API 主要变更事项
1）商品创建 (Product Creation)
为明确识别遗漏必填属性时的错误原因，响应消息已进行增强。
响应规格更新： 在
details及errorItems字段中新增 “不存在必填购买属性 (未输入时将限制注册/曝光)” 的消息。
错误响应示例 (ERROR):
{
"code": "ERROR",
"message": "[]. 유효하지 않은 구매 옵션 값 혹은 단위가 존재합니다.",
"details": "... 다음과 같이 필수 구매 옵션 (미입력시 등록/노출 제한)을 입력해주세요. : '총 수량'. 자세한 사항은 아래 errorItems 에서 확인할 수 있습니다.",
"errorItems": [
{
"itemIndex": 0,
"itemAttributes": [
{
"attributeTypeName": "총 수량",
"message": "필수 구매 옵션 (미입력 시 등록/노출 제한) 존재하지 않습니다."
}
]
}
]
}2）商品修改 (需批准) (Modify Product)
Open Attributes (开放属性) 管理方式更新，且输入值的验证逻辑已增强。
-
Open Attributes (开放属性) 管理：
删除方法： 在 Payload 的
attributes列表中排除（移除）该属性元素，即视为删除。识别方法： 若 [类目元数据查询 API] 的响应中不存在该
attributeTypeName，则视为 Open Attribute。
-
错误规格更新 (400 Request Variable Confirmation)：
输入无效的数据格式/单位时，将发生错误。
输入除各类目定义的有效值以外的内容时，请求将被拒绝。
3） 商品列表分页查询 (Product List Paging Query)
为识别被限制曝光的商品，新增了查询参数。
-
新增参数：
-
violationTypes(String List): 违规类型过滤 (NO_VA_V2, MOTA_V2, ATTR)- NO_VA_V2: 需验证信息的商品 (曝光受限)
- MOTA_V2: 需输入缺失必填购买选项的商品 (曝光受限)
- ATTR: 需修改选项的商品 (低曝光)
violationTypeAndOr(String): 过滤逻辑运算设置 (AND, OR)
-
请求示例：
GET /api/v1/marketplace/seller-products?vendorId={vendorId}&violationTypes=ATTR&violationTypes=MOTA_V2&violationTypeAndOr=OR
3. 开发者需采取的行动
处理错误规格 (Handle Error Specs)： 请更新您的系统以解析“商品创建 API”中的详细
errorItems，以便卖家能明确查看到具体缺失了哪些属性。排查现有商品 (Audit Existing Products)： 请使用更新后的“商品列表分页查询 API”，结合
violationTypes为 “MOTA_V2” 的参数，识别因缺少必填购买属性而当前处于“曝光限制 (Exposure Restricted)”状态的商品。更新信息 (Update Information)： 请使用“商品修改 API”输入有效的必填购买属性，以解除曝光限制。更新完成后，状态将变更为“审核中 (Under Review)”，获得批准后即可恢复正常曝光。
准确的商品信息是提升顾客购买转化率的关键。非常感谢您的积极配合。
我们衷心的希望以上更新能给您带来更好的体验。谢谢。