LISTINGS_ITEM_ISSUES_CHANGE v 1.0 deprecation
Amazon is updating the Delivery Shipment Invoice API for Brazil to support multiple NF-e access keys and deprecating the LISTINGS_ITEM_ISSUES_CHANGE v1.0 notification in favor of the 2023-12-13 schema. Key deadlines include August 5, 2026, for new subscription blocks and August 26, 2026, for total service termination.
Back to All Starting August 14, 2026, version 1.0 of the LISTINGS_ITEM_ISSUES_CHANGE notification will no longer be available for new subscriptions, and requests to subscribe using this version will return an error. Effective August 26, 2026, Amazon will stop delivering events for existing subscriptions on version 1.0. Compared to version 1.0, version 2023-12-13 includes additional enforcement actions that provide more detailed listings item issues impact information. For example:
- LISTING_SUPPRESSED – This enforcement disallows purchase of the current listings item.
- ATTRIBUTE_SUPPRESSED – A listings item's attribute value is invalid and disallows purchase of the current listings item.
- CATALOG_ITEM_REMOVED – This catalog item is inactive on Amazon, and all offers against it in the applicable marketplace are not available for purchase.
Which stores are affected?
This change applies to all stores.
Who is affected?
Developers with applications that subscribe to the LISTINGS_ITEM_ISSUES_CHANGE notification are affected by this change.
What action is required?
- If you use the Notifications schema to validate the notifications you receive, download the 2023-12-13 schema and replace version 1.0.
- Update your application to create action items based on the 2023-12-13 enforcement actions.
- Migrate all existing LISTINGS_ITEM_ISSUES_CHANGE subscriptions from version 1.0 to 2023-12-13.
For more information
To learn more about the updated notification schema, refer to the ListingsItemIssuesChangeNotification_2023-12-13 Schema. For the latest information on notification types, refer to Notification Type Values
Analysis & Recommendations
Why This Matters
Failure to migrate will result in a complete loss of visibility into global listing health and enforcement actions. Additionally, Brazilian sellers must adapt to new multi-invoice data structures to remain compliant with local tax laws.
Key Takeaways
- The Brazil Delivery Shipment Invoice API `getInvoiceStatus` operation must be updated by September 30, 2026.
- New subscriptions to LISTINGS_ITEM_ISSUES_CHANGE v1.0 will be blocked starting August 5, 2026.
- The new 2023-12-13 notification schema introduces granular codes like `LISTING_SUPPRESSED` and `ATTRIBUTE_SUPPRESSED`.
- The `invoiceStatus` field is being replaced by `orderStatus` and an `invoices` array in the Brazil API response.
Recommended Actions
- →Rewrite data parsing logic for the Brazil store to replace the `invoiceStatus` field with `orderStatus` and handle the new `invoices` array.
- →Migrate all existing LISTINGS_ITEM_ISSUES_CHANGE subscriptions from v1.0 to the 2023-12-13 schema via the SP-API developer portal.
- →Update automated troubleshooting software to recognize new enforcement identifiers like `CATALOG_ITEM_REMOVED`.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!