您好,这里是 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)”,获得批准后即可恢复正常曝光。
准确的商品信息是提升顾客购买转化率的关键。非常感谢您的积极配合。
我们衷心的希望以上更新能给您带来更好的体验。谢谢。