November 2023 SP-API Release Announcement
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` 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 forresultStatus
. 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 andmarketplaceId
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
Weight
is now a mandatory field in the Vendor Direct Fulfillment Shipping API v2021-12-28 and v1The 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
, andgetAdditionalSellerInputsOld
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