December 2023 SP-API Release Announcement

[hudalexa]

New Application Management API v2023-11-30 in public beta

On February 6, 2023, we announced that you must rotate your Login With Amazon (LWA) credentials (client secrets) for all applications every 180 days. The new Selling Partner API for Application Management lets you do this rotation programmatically on registered applications. For more information, refer to the Application Management API v2023-11-30 Use Case Guide on the SP-API public beta site.

Shipping API v2 launches support for Amazon Shipping Dangerous Goods

Amazon Shipping now supports the shipment of dangerous goods (DG) in the US and UK markets. Sellers and shippers can provide DG details through the Shipping API v2, or use Shipper Central to generate shipping labels for cosmetic products and electronics with lithium batteries.

Customers must comply with all applicable laws and regulations to ensure the safe handling and transportation of DG packages. For more information, refer to the following documentation:

• Tutorial: Purchase a dangerous goods shipment for an item containing a lithium ion battery from a rate
• Tutorial: Purchase a limited quantity dangerous goods shipment from a rate
• US Dangerous Good Shipping Guide
• UK Dangerous Goods Shipping Guide

Updates to Listings Items API v2021-08-01

Listings Items API v2021-08-01 is now available in the India (IN) marketplace

On December 4, 2023, the Listings Items API launched support for the India (IN) Marketplace.

Developers in the IN marketplace can use the Listings Items API to build programmatic integrations that create and manage listings on Amazon. Developers can also 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.

You can learn more about integrating with the SP-API to build and manage listings workflows in the Building Listings Management Workflows Guide. You can learn more about migrating your existing listings management workflows from XML-based and flat file feeds to Listings Items API in the Migrating Listings Management Workflows Guide.

Updated Listing attribute usage and enumeration values

The attribute usage and enumeration values of numerous product types across several marketplaces were updated to eliminate redundant attributes and curate the attributes and enumeration values relevant to their corresponding product types. This change applies to the following marketplaces:

• United States (US)
• France (FR)
• Germany (DE)
• Italy (IT)
• Netherlands (NL)
• Poland (PL)
• Spain (ES)
• Sweden (SE)
• India (IN)
• Turkey (TR)
• Japan (JP)
• Canada (CA)
• Brazil (BR)
• Mexico (MX)
• Australia (AU)
• Singapore (SG)
• Saudi Arabia (SA)
• Emirates (AE)
• Egypt (EG)
• United Kingdom (UK)

Developers using the Listings Items API v2021-08-01 and JSON_LISTINGS_FEED feed type to create and edit products with offers are affected by this change. Product-only listings and XSD/XML feed uploads are not affected by this change.

Refer to the December 2023 Listings Items API Product Type Changes for a full list of affected product types and changes.

New Listings Sample Application

The new Listings Sample Application demonstrates how to use the APIs listed in the Building Listings Management Workflows Guide to construct common listing management workflows through a user interface.

New Issue object fields in Listings Items API v2021-08-01

The Issue object has two new fields that offer more information about issues with listings:

• Enforcements provides information about the action Amazon took on the listing due to the issue. For example, LISTING_SUPPRESSED means that Amazon took down the listing because of this issue.
• Categories provides high-level categorization information about the issue.

In addition, the LISTINGS_ITEM_ISSUE_CHANGE notification will now be able to report additional Enforcements. To subscribe to the new version of LISTINGS_ITEM_ISSUE_CHANGE, use a payloadVersion of 2023-12-13.

Vendor Retail Procurement API v1

The Vendor Retail Procurement APIs v1 Use Case Guide has been updated to include information on using the operations SubmitShipments and GetShipmentDetails.

The SubmitShipments operation is designed for Collect or WePay vendors to submit requests for the pickup of their shipments by Amazon.

You can use the GetShipmentDetails operation to retrieve scheduled pickup and carrier assignment information.

Vendor Direct Fulfillment Orders API v1 and v2021-12-28

Vendor Direct Fulfillment Orders API v1 Use Case Guide was updated to include a section on Direct Fulfillment customer data transmission. Vendors do not receive customer data such as name, address, or phone number for certain shipments fulfilled through the getOrder and getOrders operations. For Amazon label only vendors, certain fields will be replaced with the fictitious value XXXXX.

Product Type Definitions API v2020-09-01

The Product Type Definitions API v2020-09-01 model was updated to resolve a known issue with the productTypeVersion attribute in the response of the searchDefinitionsProductTypes operation.

Updates to Notifications API v1

The Notifications APIhas been updated with an optional parameter of payloadVersion. You can use this parameter to return the version of the payload object to be used in the notification.

The new Listings Item Issues Change Notification version 2023-12-13 has three new enforcement actions: LISTING_SUPPRESSED, ATTRIBUTE_SUPPRESSED, and CATALOG_ITEM_REMOVED. These actions describe the enforcement action that Amazon has taken on their listing issues.

Updates to FBA Reports

GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA now includes updated column names. A note has been added to the FBA Long Term Storage Fee Charges Report on the Fulfillment by Amazon (FBA) Report Type Values page, outlining the correct way to generate the report.

The Fulfillment by Amazon (FBA) bulk invoice report (FBA_BULK_INVOICE) shares the invoices for a seller within the given date range. These invoices include customer orders served by the seller.

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.
• RFQ_UPLOAD_FEED (FE and EU) was deprecated and sunset on December 13, 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