Breaking change Amazon Seller Central Ready in Improvado

Amazon Seller Central Financial Events on the new Finances API: rows and Item change

Deadline: August 27, 2027
Affected: Financial Events
What to do: Review dashboards and queries that sum Financial Events or read values out of Item. Totals now include deferred transactions (filter on Transaction Status to separate them), sums across a seller's marketplace accounts drop to the real figure, and Item uses the new transaction structure. If the report fails with an access error, reconnect the Amazon Seller Central connection in Improvado so it grants the Finance and Accounting permission.

Amazon is retiring version 0 of its Finances API, which the Financial Events report used, on 27 August 2027. Financial Events now reads the current Finances API (version 2024-06-19). Released transactions arrive as before; the differences are below.

What changes in the data

Deferred transactions are included. Amazon now reports transactions whose funds it still holds. The new Transaction Status field shows RELEASED, DEFERRED (Amazon still holds the funds) or DEFERRED_RELEASED (held first, released later). A deferred transaction keeps its ID and posted date and changes status when Amazon releases the funds, so shipment and refund totals go up, mostly for recent days.
One marketplace per account. Each marketplace account now returns only its own transactions. Previously every marketplace account of a seller repeated the transactions of the seller's whole region, so sums across a seller's accounts counted them several times.
New Item format. Item holds the full transaction as JSON, with amounts, breakdowns and items, instead of the previous event structure. Queries that read values out of Item need updating.
More transaction types. Types such as ServiceFee, ServiceCharge, ProductAdsPayment, Transfer and FBAInventoryReimbursement now appear, and adjustments are grouped per transaction.

History

After the switch, the report's history is refreshed for up to two years, the most Amazon returns. Older history keeps the previous format. By default each run re-reads the last 21 days, so status changes of recent transactions are picked up.

Permissions

The current Finances API requires Amazon's Finance and Accounting permission. Some connections authorized earlier do not include it, and Amazon rejects the request. If the report fails with an access error, reconnect the Amazon Seller Central connection in Improvado.