2022 年 5 月 SP-API 发布公告

更新于 2022 年 5 月 20 日，对报告类型类别进行了细微更正

目录商品 API 的新版本

新的 Catalog Items API version 2022-04-01 通过以下变更改善了 API 体验并回应了开发者的反馈：

• 向 searchCatalogItems 操作添加了基于标识符的搜索，启用类似批处理的请求，每个请求最多有 20 个标识符（ASIN、UPC、EAN 等）
• 已添加 dimensions 数据集，提供标准化的商品和包裹尺寸
• 为商品类别、商品子类别和浏览分类添加了显示名称
• 将识别属性扩展至商品摘要（商品分类、包装数量、零件编号、网站展示组）
• 在销售排名中添加了浏览分类和网站显示组
• 已将 searchCatalogItems 和 getCatalogItem 操作保持一致以使用相同的数据集，包括 attributes
• 已用 relationships 替换 variations，以允许表示多种关系类型，例如包层次结构
• 添加了变体主题详情（关系详情中的名称）

新的批处理操作功能

Product Fees API 和 Product Pricing API 现在包含用于检索商品列表信息的批量操作。我们强烈建议迁移到这些 API 的开发人员使用新的批处理操作来最有效地调用这些 API，而不是逐个调用这些 API。

• Product Fees API 包括一个新的 getMyFeesEstimates 操作，用于检索商品列表和商城的商品费用估算值。有关更多信息，请参阅 Product Fees API Use Case Guide。
• Product Pricing API 包括新的 getItemOffersBatch 和 getListingOffersBatch 操作，可在商品列表中检索商品定价和商品信息。有关更多信息，请参阅 Product Pricing API Use Case Guide。

New Purchase Shield program operations

The Orders API now includes two new operations to support the Purchase Shield program for managing regulated orders in the UK and Italy. Regulated orders are a limited set of orders that fulfill products requiring a prescription (pet medication, prescription contacts, and prescription glasses). Two new operations have been added: getOrderRegulatedInfo and updateVerificationStatus.

新的生产者责任延期 (EPR) 报告类型

The Reports API now includes three new Extended Producer Responsibility (EPR) report types. The EPR Monthly Report, EPR Quarterly Report, and EPR Annual Reports include data on the EPR declarations for service providers in France and Germany to help sellers maintain compliance with EU regulations.

新增了对筛选和限制“任何优惠变更通知”的支持

Notifications API ANY_OFFER_CHANGED 通知现在支持仅对特定 marketplaceIds 过滤通知，并将通知频率限制为每五或十分钟一次。更新后的通知会接受新的 processingDirective参数，使您能够向订阅传递其他信息以控制对通知的处理。欲了解更多信息，请参阅 Notifications Use Case Guide。

For more information on this release, view our Selling Partner API Release Video.

报告弃用情况

请注意，以下报告宣布弃用，卖家和供应商均不可用：

商品信息报告

The following reports will be unavailable as of June 15, 2022:

• _GET_MERCHANT_LISTINGS_DEFECT_DATA_
• _LISTINGS_DEFECT_REPORT_XL_

这些报告将替换为 _GET_MERCHANTS_LISTINGS_FYP_REPORT_。如果您的应用程序受此弃用影响，则必须在 2022 年 6 月 15 日之前更新应用程序，以使用 _GET_MERCHANTS_LISTINGS_FYP_REPORT_ 报告，避免服务中断。

供应商零售分析报告

The following reports are announcing deprecation and will be unavailable as of June 27, 2022.

• GET_VENDOR_SALES_DIAGNOSTIC_REPORT
• GET_VENDOR_DEMAND_FORECAST_REPORT
• GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING

Each of these reports has a new version or replacement report available. For more information on migrating to the new versions and replacement reports, refer to the Vendor Retail Analytics Reports Migration Guide.

库存报告

The following reports will be unavailable as of June 27, 2022:

• GET_FBA_FULFILLMENT_INVENTORY_HEALTH_DATA
• GET_EXCESS_INVENTORY_DATA
• GET_FBA_INVENTORY_AGED_DATA

这些报告将替换为 GET_FBA_INVENTORY_PLANNING_DATA。如果您的应用程序受此弃用影响，则必须在 2022 年 6 月 27 日之前更新应用程序，以使用 GET_FBA_INVENTORY_PLANNING_DATA 报告，避免服务中断。

品牌分析报告

以下报告将于 2022 年 6 月 30 日停用：

• GET_BRAND_ANALYTICS_ITEM_COMPARISON_REPORT
• GET_BRAND_ANALYTICS_ALTERNATE_PURCHASE_REPORT

并无计划为这些报告提供替换版本。如果您的应用程序受到此变更的影响，请确保您的应用程序在 2022 年 6 月 30 日之后不再使用已弃用的报告类型。

最诚挚的问候，
销售伙伴 API 团队