June 2021 Release Announcement

[jenilew]

Hi All,

Today, June 2, 2021, we released these APIs and updates:

• Product Type Definitions API v2020-09-01
• Listings Items API v2020-09-01
• Catalog Items API v2020-12-01
• Listings Feed JSON Schemas for the Feeds API
• Shipment Invoice API

Product Type Definitions API

We are releasing the definitionsProductTypes_2020-09-01 API. This is a foundational API that allows you to search and retrieve Amazon product type definitions, which describe the attribute and data requirements for items in the Amazon catalog using JSON Schemas. The JSON Schemas represent the format of data used by the Listings Items API, the Catalog Items API, and the JSON_LISTING_FEED.

Amazon product types, like "BED" and "SUITCASE", will be available in the Product Type Definitions API as they are migrated from legacy listings systems. Refer to the searchDefinitionsProductTypes operation for the latest list of available product types for your account and marketplaces.

To learn more, see the Selling Partner API for Product Type Definitions model, API Reference, and Use Case Guide.

Listings Items API

We are releasing the listingsItems_2020-09-01 API that works with the Product Type Definitions API and allows you to create, edit, and delete Amazon listings (SKUs) for merchants and vendors; including product details (such as item names and bullet points) and sales terms (such as price, cost, and inventory). Using the JSON Schemas provided by the Product Type Definitions API, you can validate data requirements are met prior to submission with the Listings Items API.

Like the Product Type Definitions API, Amazon product types will be supported as they are migrated from legacy listings systems. For listings with product types not yet available, the "PRODUCT" product type may be used to create offer-only listings, update common attributes like item names, and update sales terms like price and inventory.

To learn more, see the Selling Partner API for Listings Items model, API Reference, and Use Case Guide.

Catalog Items API

We are updating the catalogItems_2020-12-01 API to include the searchCatalogItems operation that allows you to search the Amazon catalog (ASINs) for existing items using keywords, including product identifiers, and allows you to refine search queries on classifications (browse nodes) and brand names.

To learn more, see the Selling Partner API for Catalog Items model, API Reference, and Use Case Guide.

Listings Feed JSON Schemas

We are releasing a new feed type for the Feeds API, the JSON_LISTINGS_FEED. The JSON_LISTINGS_FEED works with the Product Type Definitions API and allows you to create, edit, and delete Amazon listings (SKUs) for merchants (vendor support coming soon) with the same data format used by the Listings Items API. Listings data is interoperable between the Listings Items API and JSON_LISTINGS_FEED, allowing you to use whichever mechanism or combination that works best for your listings workflows.

To learn more, see the JSON Schemas for the JSON_LISTINGS_FEED, Selling Partner API for Feeds model, API Reference, and Use Case Guide.

Shipment Invoice API

We are releasing the Shipment Invoice API for the Brazil marketplace. This API helps you programmatically retrieve shipment invoice information.

Note: The getShipmentDetails operation requires the new access protocol (RDT) to successfully retrieve shipment details.
• To learn more, see the Shipment Invoice API model and API Reference.
• To learn more about RDT, see the Tokens API Use Case Guide, API Reference, and model.

Best regards,

The Selling Partner API team