产品 API – 简体中文

使用 API 修改商品时，出现了错误‘Required options (weight per piece, other) have not been entered.’。

通过API修改在Coupang注册的商品时，建议通过以下步骤来修改 1. 使用商品查询 API（GET）搜索在Coupang注册的商品 2. 查看的返回的 JSON 文本，将相关内容更改为您需要的值 3. 将更改后的 JSON 文本，按修改商品API 的格式，请求修改商品（PUT）修改商品时，如果您删除了一些此商品的单品信息，那么您也会收到上面的错误消息。如果您在修改商品时删除... 查看更多

使用 API 修改产品时出现“중복된 아이템 이름이 존재합니다.”的报错

通过API修改在Coupang注册的商品时：1.首先通过商品查询API（GET）搜索在Coupang注册的商品2. JSON格式全文只改变需要修改部分的值3. 必须请求修改整个JSON文本才能正常反馈。请检查初始注册的商品信息中是否有缺失的attributeTypeName和attributeValueName值。查看更多

通过API修改商品时，返回“판매중인 상품은 삭제할 수 없습니다.”的报错信息

通过API修改在Coupang注册的商品时，请注意：1.首先通过商品查询API（GET）搜索在Coupang注册的商品2. JSON格式全文只改变需要修改部分的值3. 必须请求修改整个JSON文本才能正常请求。修改产品时，如果部分已注册的产品选项缺失或被排除，将显示您查询的错误信息。备选产品注册后审核通过后不可删除。请检查是否缺少选项 Item、sellerProductItem 和 ven... 查看更多

我可以通过商品修改 API 向已注册为单品（一个可选商品）的商品添加其它商品单项吗？

很抱歉，您无法通过修改商品 API 来向已注册为单品（一个可选商品）的商品添加其它商品单项。如果您需要添加其它商品单项，请用相关商品信息来创建新商品。查看更多

通过 API 注册或修改产品时，输入的 itemName 并未准确展示出来。

在API 请求body的要求中，itemName 是内部使用的值，用于区分每个项目（选项）。 API上的itemName和WING上显示的option名称没有关联，因此通过API修改itemName时可能出现暴露名称不同的问题。查看更多

通过API注册商品时，出现“아이템과 같은 옵션 및 옵션값을 가지고 있는 아이템이 중복으로 존재합니다”的错误。

该报错主要出现在商品的option中内容有重复的情况下。请按照以下方法进行排查： 1.检查产品创建的完整JSON中每个选项的itemName值是否没有重复。2.请检查属性数组中attributeTypeName和attributeValueName的值是否不重复。查看更多

因representative或其他图片下载失败的原因，导致的产品批准被拒绝该如何处理。

在Coupang的服务结构中，图片下载失败的原因如下：1. 图片下载速度超速导致超时2.无法访问图片托管服务器3.图片路径无效4.图片URL使用80和443端口以外的数字如果是除上述4种情况之外的正常图片，请尝试重新编辑链接，如果仍然下载失败，请提交在线咨询。查看更多

哪些状态下可以使用产品修改API 进行修改？

可以在已批准或已拒绝的状态下使用 API 进行产品修改（使用规则与WING平台一样）。等待批准期间不能进行修改。查看更多

注册产品时，出现“通知”相关错误。

请查询通过类目元数据查询接口输入的类目编码是否与商品注册时输入的通知信息相符。查看更多

我通过修改产品 API 更改了运费类型和免费送货条件金额。什么时候会更新在Coupang商品页面上？

如果使用修改商品接口修改运费，需要经过审批流程。审批完成后可能需要最少4小时，最多24小时才能反映在Coupang前端，所以修改运费时请使用商品修改（无需审批）API。查看更多

我如何从客户那里获得个人清关编号 (PCC)？

您可以在产品创建 API 中将 pccNeeded 值设置为 true。查看更多

如何发布平行进口商品？

要发布平行进口商品，需要检查两方面，如下所示： 1. 为您的平行进口（parallelImported）产品输入“PARALLEL_IMPORTED”。 { "parrallelImported": "PARALLEL_IMPORTED",} 2.在 json 文件中注册所需文档（“requiredDocuments”）。对于平行进口，您需要注册所需文件（进口通知证书）。注册或修改，在... 查看更多

产品listing的搜索关键词有什么规则？

每个关键字不应超过 20 个字符。您最多可以输入 20 个关键字。您的关键字不应包含任何特殊字符，除了：!@#$%^&*-+;:'。一般来说，所有与产品相关的关键字都是可以接受的。有关搜索关键字的更多详细信息，请参阅链接中的指南： Go to [Keyword Listing Guide] 查看更多

当我调用商品注册 API 时，出现以下错误：“输入错误”

此错误通常出现在有问题的行中。请修改 json 正文中的相应行。查看更多

我可以在Coupang注册卖家提供的唯一密钥（产品管理码）来管理我的产品吗？

当您创建商品时，输入“externalVendorSku”（卖家商品编码）即可使用您商品订单等处的编码进行管理。对于其他值，请使用“extraProperties”（额外选项）字段。该字段不暴露在前端。它是为方便卖家而制作的。您可以输入您自己的管理代码/您需要额外保存的其他值。有关更多详细信息，请参阅[创建产品API]以获取有关参数的信息。查看更多

我想添加一个商品item（vendor item）。

您必须在现有item list中的各个选项添加所有子类别。不要在添加的选项中输入“sellerProductItemId”。查看更多

“无法删除已创建为vendorItem 的项目”这样的错误将发生。

当您尝试删除已批准的产品时会发生此错误。对于已经通过审核的产品，您不能删除选项。因此，请将该选项标记为“暂停销售”并进行相应操作。查看更多

我的产品能否按照我注册的选项顺序显示在网站上？

无法按顺序展示。产品会按照Coupang自己的逻辑顺序展示在前台（销售页面）。查看更多

我想搜索产品，在哪里可以查到 sellerProductId？

sellerProductId 可以在产品创建时以“响应”的形式提供，并通过下面两个API进行查询： [Product List paging retrieve API] and [Product List segment retrieve API]. 查看更多

接口返回的信息如下：“卖家商品[********]未找到，也无法删除。只能在‘已保存’或‘暂时保存’状态下删除该商品。”，该如何处理？

只有当商品下的所有选项都切换到“暂停销售”状态时，您才能删除商品。请暂停所有出售选项后重试。查看更多

接口返回如下报错：“超出搜索范围。最大搜索范围为 10 分钟“

您只能在【商品列表段检索API】中查询配置的10分钟范围内的商品。请重新配置查询范围。查看更多

产品审批时如何查看sellerProductId？

sellerProductId 将在产品创建阶段，会作为响应里的参数返回给请求方，您可以获取并保存下来。（或者您可以在卖家门户（WING）中的产品查询下根据“注册产品ID”进行搜索）。查看更多

接口返回报错信息：“对象文本必须以字符 0 处的‘{’开头”。

请检查 vendorItemId。 vendorItemId 是产品获得批准时创建的选项 ID。请检查并确保您输入了正确的值。查看更多

错误信息 '输入值有误。显示第 1 行。我该如何解决？

当由于输入值作为单行输入而无法识别确切的错误位置时，将显示错误消息“line:1”。请在使用 JSON Viewer 更改 JSON 格式后重试。 * 参考推荐的 JSON 查看器：http://jsonviewer.stack.hu/ 查看更多

我可以使用 <iframe> 吗？

不能使用 <iframe> 标签，YouTube 和一般图片除外。查看更多

我想删除一个item（vendor item）。

您只能在项目首次上市后，在批准前删除该项目。（“vendorItemId”一经批准创建，不可删除。）要在批准前删除它，删除 items 数组中各个选项的所有子类别。（您希望留下的选项应包括“sellerProductItemId”。）查看更多

我收到以下报错：“无法更改销售价格。您可以在以下范围内更改：比更改前的先前销售价格最多低 50% - 最多高 100%。”

为了防止卖家提供偏差过大的错误价格金额，保护他们免受错误影响，Coupang 将价格修改限制在给定范围内。如果您需要一次大幅调整价格，请使用[Change Price by Item API]将“forceSalePriceUpdate”设置为“True”。查看更多

我如何知道哪些参数是必需的，哪些是可选的？

对于3P商品的 items 数组，除以下参数外，所有参数都是必需的： <items数组可选的低优先级参数>- externalVendorSku：卖家/供应商使用的项目代码- 条码- emptyBarcode：没有可用的条码- emptyBarcodeReason: 条码不可用的原因- 型号：型号- extraProperties：关于卖家物品的附加选项信息- 证明：有关该项目的任何证明... 查看更多

API 产品集成是否适用于仅限成人（19 岁以上）的产品？

是的。创建产品时，添加参数 "adultOnly": "ADULT_ONLY" 以将您的产品列为仅限成人（19 岁以上）。查看更多

接口报错提示：“卖家产品 [****] 不可用于批准/批准请求”

只有处于“暂时保存”状态的产品才能申请审批。请检查产品是否处于正确状态。查看更多

OPENAPI 관련 안내