June 2023 SP-API Release Announcement

Introducing the new Replenishment API

We are excited to announce the new Replenishment API v2022-11-07. This API allows SP-API developers to get critical data about selling partner business performance that can help improve speed and decision making. Key features of this API include:

• Amazon Subscribe & Save performance metrics such as sales and missed promise due to out of stock aggregated by year, quarter, month, or week.
• Subscribe & Save revenue and sales units forecasts for the upcoming 30, 60, and 90 days.
• Subscribe & Save program configuration details such as active Subscribe & Save ASINs, active subscriptions, and discount percentages.

This API is available in the following marketplaces: United States of America, Canada, Brazil, Mexico, United Kingdom, Germany, Spain, Italy, France, Netherlands, United Arab Emirates, India, Japan, and Australia.

For more information, refer to the Replenishment API v2022-11-07 Use Case Guide.

New Migrating Listings Management Workflows guide

The new Migrating Listings Management Workflows guide helps you migrate your existing listings management workflows from XML-based and flat file feeds to the Selling Partner Listings Items API and JSON-based feeds.

Listings Items API now available in the Belgium (BE) marketplace

Public developers in the BE marketplace can use the Listings Items API to build programmatic integrations that create and manage listings on Amazon. Developers can search for a list of all launched product types, submit full product and offer information to a new ASIN, submit partial product updates, and upload images.

Learn more about integrating with the SP-API to build and manage listings workflows in the Building Listings Management Workflows Guide. For more information about migrating your existing listings management workflows from XML-based and flat file feeds to Listings Items API, refer to the new Migrating Listings Management Workflows Guide.

Update to Brand Analytics Search Terms Report Search Frequency Rank

On May 22, 2023, the Search Frequency Rank calculation method changed to show the same numeric rank for search terms with the same search frequency during the selected time frame. Search terms with the same rank are then sorted alphanumerically. This change applies to all marketplaces and developers with applications that use theGET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT API are affected by this change. No action is required.

New rapid retail analytics reports for access to near-real time performance metrics

The new GET_VENDOR_REAL_TIME_SALES_REPORT shares sales data at an ASIN level, aggregated hourly. Requests can span multiple date range periods.

The new GET_VENDOR_REAL_TIME_TRAFFIC_REPORT shares data on the customer traffic to the detail pages of the vendor's items, aggregated hourly. Requests can span multiple date range periods.

The new GET_VENDOR_REAL_TIME_INVENTORY_REPORT shares inventory data at an ASIN level, aggregated hourly.

For more information, refer to Analytics reports and Vendor Retail reports.

New rapid retail analytics notifications for access to near-real time performance metrics

The new ITEM_SALES_EVENT_CHANGE notification is sent five minutes after the beginning of each hour. This notification shares sales data at an ASIN level and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs are included when they have orders or cancellations during a given hour. Each notification may include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.

The new ITEM_INVENTORY_EVENT_CHANGE notification is sent five minutes after the beginning of each hour. This notification shares inventory data at an ASIN level, and includes data for the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs are included if the number of units available for purchase by customers has changed. Each notification may include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.

The new DETAIL_PAGE_TRAFFIC_EVENT notification is sent five minutes after the beginning of each hour. This notification shares traffic data at an ASIN level and includes data for the hour before the previous hour, as well as any delayed data from up to 24 hours earlier. ASINs that have glance views are included. Each notification may include multiple ASINs, and a selling partner can expect to receive multiple notifications every hour.

New LISTING_ITEM_MFN_QUANTITY_CHANGE notification for receiving near-real time MFN available quantity

The new LISTINGS_ITEM_MFN_QUANTITY_CHANGE notification is sent whenever there is a change in the available quantity of a listings item.

New ORDER_CHANGE notification for any changes related to an order, including order status changes and buyer requested cancellation

The new ORDER_CHANGE notification sends an order-level payload whenever there is an important change in the order. Important changes include order status changes and buyer requested cancellations. This notification replaces ORDER_STATUS_CHANGE and is built in an extensible way. All future notification event types related to MFN and FBA orders will be added into ORDER_CHANGE. This launch introduces time_of_order_change, which is a timestamp of when the event was triggered. Due to asynchronous processing, our systems may not send you the notification at the exact time of the order change. As such, you may reference this new timestamp instead of relying on the EVENT_TIME timestamp for your integrations.

B2B_ANY_OFFER_CHANGE notification updated with Quantity Discount information

The B2B_ANY_OFFER_CHANGED notification has been updated to include the Quantity Discount (QD) pricing in the Offer section, with new attributes including multiple quantity tiers, discount type, and price. You can now use this notification to build QD re-pricing solutions, which eliminates the need to use pricing APIs for this purpose.

New SP-API documentation Changelog category

SP-API Release Notes and Deprecations have moved to the Changelog category on the developer documentation site. Bookmark this new location for quick access to Release Note history and deprecation dates.

B2B Product Opportunities Reports Schemas available on GitHub

You can now find reports schemas for GET_B2B_PRODUCT_OPPORTUNITIES_RECOMMENDED_FOR_YOU and GET_B2B_PRODUCT_OPPORTUNITIES_NOT_YET_ON_AMAZON on the Selling Partner API GitHub repo.

Deprecations

SP-API resources announcing deprecation will no longer be supported after their deprecation date. Calls to deprecated resources will fail beginning on their sunset date.

ORDER_STATUS_CHANGE is announcing deprecation on June 21, 2023 and will sunset on December 31, 2023 date.

MFN_ORDER_STATUS_CHANGE announced deprecation August 22, 2022 and will sunset on June 21, 2023. It is being replaced by the ORDER_CHANGE notification.

For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

Best regards,
The Selling Partner API team