November 2023 SP-API Release Announcement

[hudalexa]

Introducing the Supply Sources API v2020-07-01

You can use the new Supply Sources API to configure and update information on seller supply sources, such as stores and warehouses. You can use the Supply Sources API to build applications that use location-level fulfillment capabilities and provide information about supply sources and location level inventory.

New Multi-Location Inventory Integration guide

Multi Location inventory (MLI) allows multi location sellers to provide Amazon with location-level data on their inventory and actual fulfillment capabilities. This location-level data is paired with the Seller’s actual ship-from location behavior and fed into the promise systems to generate precise Customer promises. These speed and reliability improvements make offers more attractive to Customers and drive MFN sales, while the lower cost to serve leads to more competitive ASPs and/or higher Seller profits. The new Multi-Location Inventory Integration guide advises Selling Partners on the APIs and operations that are mandatory for integration.

Seller Central is now available in the South Africa Marketplace (ZA)

On October 17th, 2023**,** Seller Central launched support for the South Africa Marketplace (ZA). For more information, refer to the Seller Central URLs, SP-API Endpoints, and Marketplace IDs.

Notification of Product Type (PT) availability for the Listings API

As of October 19, 2023, 1,712 product types supported by XML and flat-file feeds are now available to Sellers on Listings API WW (excluding IN) for Hardlines, Softlines, and Consumables. All remaining product types will be available on the Listings API in early 2024.

You can subscribe to the [PRODUCT_TYPE_DEFINITIONS_CHANGE](https://developer-docs.amazon.com/sp-api/docs/notifications-api-v1-use-case-guide#product_type_definitions_change) notification to receive updates when new product types are available.

Updates to Product Pricing API v2022-05-01

The following updates are now available for the Product Pricing API v2022-05-01:

• The United Kingdom is now a valid marketplace.
• The getFeaturedOfferExpectedPriceBatch operation has been extended to Amazon.co.uk. This operation lets you receive the FOEP data for up to 40 SKUs, provided that the items are in new condition, ship nationwide, and are eligible to become the featured offer.
• ASIN_NOT_ELIGIBLE is now a value for resultStatus. This error code is returned if an ASIN is ineligible for an FOEP value.
• The new competitiveSummary operation returns the competitive summary response including featured buying options for the ASIN and marketplaceId combination.

Update to Product Type Definitions API v2020-09-01

Product Type Definitions v2020-09-01 now includes three new request parameters
(itemName, locale, and searchlocale) and one new response field (displayName). Selling Partners can use these new parameters to get the Amazon recommended Product Type for their listing based based on their item’s name.

A new tutorial for Get Product Type Definition recommendations is now included in the Product Type Definitions API v2020-09-01 Use Case Guide. You can use this tutorial to get Amazon product type recommendations from the Product Type Definitions API for a given Amazon marketplace, type of selling partner account, and item name.

Finances v0 operation changes

ListFinancialEvent and ListFinancialEventGroups were updated to more clearly communicate expected responses and scope. The response for ChangeRefundTransactions was modified from an object to an array.

Weight is now a mandatory field in the Vendor Direct Fulfillment Shipping API v2021-12-28 and v1

The weight field is now mandatory. This change will generate an error when invoking shipmentconfirmations so that vendors do not have to wait for an error during transaction status.

New Reauthorization Workflow guidance

The new Reauthorization Workflow topic provides guidance for application authorization renewal through Manage Your Apps.

Update to Building Listings Management Workflows Guide

The List an item that does not already exist in the Amazon catalog workflow now includes steps to retrieve a recommendation using the itemName or keywords.

Update to Brand Analytics Reports documentation

The departmentName attribute has been removed from the Brand Analytics Reports documentation. This is only a documentation update. The attribute was removed from the JSON model in early 2023. For more information refer to the Updates to the Brand Analytics Search Terms Report announcement.

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. For more detailed information about SP-API deprecation dates, refer to the Deprecations table.

APIs

• The Fulfillment Inbound API v0 getInboundGuidance operation was deprecated on September 20, 2023 and will sunset on December 28, 2023. This API is currently returning static data and should not be used.
• The Merchant Fulfillment API v0 getEligibleShipmentServicesOld, cancelShipmentOld, and getAdditionalSellerInputsOld operations were deprecated on September 20, 2023 and will sunset on December 28, 2023.
• The Authorization API v1 was deprecated on September 20, 2023 and will sunset on March 20, 2024.

Feeds

• POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN was deprecated on May 17, 2023 and will sunset on November 8, 2023.
• POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN was deprecated on May 17, 2023 and will sunset on November 8, 2023.

Reports

• GET_PRODUCT_EXCHANGE_DATA was deprecated on September 20, 2023 and will sunset on December 28, 2023.
• GET_FBA_UNO_INVENTORY_DATA was deprecated on September 20, 2023 and will sunset on March 31, 2024.

Notifications

• ORDER_STATUS_CHANGE was deprecated on June 21, 2023 and will sunset on December 31, 2023.

Best regards,
The Selling Partner API team