Amazon is removing two settlement report formats on 11 November 2026: the XML settlement report and the V1 flat file settlement report. Both are replaced by the Flat File V2 settlement report, in every marketplace. Amazon says V2 presents the same information in fewer columns, so if you download settlement reports by hand this is mostly a change of layout - but if any tool, integration or spreadsheet you rely on reads the old formats, it will stop getting data on that date.
What exactly is being removed
Amazon’s Selling Partner API changelog lists two report types for removal:
- GET_V2_SETTLEMENT_REPORT_DATA_XML — the XML settlement report.
- GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE — the V1 flat file settlement report.
The replacement is GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2, the Flat File V2 settlement report. The change applies to all marketplaces.
The date has already moved once. Amazon originally announced the removal for 25 March 2026 and then pushed it to 11 November 2026. That is worth knowing for two reasons: if you read about this earlier and put a March date in your calendar, it is wrong; and a date that has moved once can move again, which is an argument for switching early rather than for waiting.
One limit on what this notice covers, stated plainly because it matters: the changelog entry is about API report types. It does not say what happens to the download options in the Seller Central interface. Anyone telling you exactly what those buttons will do on 12 November is guessing. What is certain is that the old formats are going out of support, so anything built on them should be moved to V2 now.
Who needs to do something
Three groups, roughly:
- Anyone using an app, integration or custom API code that fetches the XML or V1 flat file report. This is the group with a hard deadline: those report types stop being available.
- Anyone with a spreadsheet template built around the V1 column names. V2 does not use those columns, so formulas that look for them will return nothing or, worse, zero.
- Bookkeepers and accountants who parse V1 columns for clients. If you have a mapping written down anywhere, it needs a V2 version.
If you download the settlement report and read it yourself without any tooling, you have the least to do - but it is still worth downloading a V2 file now so the layout is familiar before you need it.
What is different in V2
The biggest change is how prices and fees are laid out. In V1 each kind of price or fee had its own columns: one naming the type and one holding the amount, as in Amazon’s example of item-related-fee-type and item-related-fee-amount. V2 condenses all of them into the same three columns. Amazon publishes which V2 column replaces which V1 field:
| In the V1 flat file | In V2 |
|---|---|
| The column naming a price or fee type, for example item-related-fee-type | amount-type |
| The value in that column, for example Commission | amount-description |
| The price or fee amount column, for example item-related-fee-amount | amount |
| transaction-type | transaction-type, or amount-description |
| Other price or fee type columns, for example other-fee-reason-description | amount-description (Amazon notes that separate amounts may be combined) |
Amazon lists a few more differences. V2 gives the posted date in two formats, posted-date and posted-date-time, a full timestamp in UTC. It gives a quantity on every row. And it shows amounts in the local currency format, so an EU file can say 95,00 where you might expect 95.00, which matters to any spreadsheet that reads the amounts as numbers. Amazon’s list of V2 columns also includes settlement-id, order-id, sku, marketplace-name and quantity-purchased.
In practice this means a V1 template cannot be pointed at a V2 file and made to work by renaming a column or two. A row that was “an item-related fee of this type and this amount” is now “an amount of this type, described this way, of this value”. The information is the same; where it sits is not.
Getting the V2 file
Amazon’s documentation for this change covers the report and the API, not where to click in Seller Central, so we do not give click-by-click steps here. If you download settlement reports from Seller Central and cannot find a V2 version of a settlement, ask Amazon Seller Support now rather than in November.
If you or an app collect the reports through the API: Amazon says settlement reports cannot be requested or scheduled. Amazon schedules them itself, and you search for them, so an integration should be looking for the V2 report type.
A checklist before 11 November
- Find out which format each of your tools imports. Accounting integrations, repricers, analytics dashboards, anything that reads settlement data. Ask the vendor directly if it is not documented.
- Download a recent settlement as V2 and open it beside the V1 file for the same period.
- Compare the totals between the two files. They describe the same settlement, so they should agree. If they do not, you want to know why now.
- Update any spreadsheet formula that looks for a V1 price or fee column. Anything referencing a V1 type or amount column, such as item-related-fee-type or item-related-fee-amount, needs rewriting against amount-type, amount-description and amount. Check how it reads the amounts too, since V2 uses the local currency format.
- Tell your bookkeeper or accountant before the date, not after, and send them a V2 file so they can adjust their own process.
- Make sure you can get a V2 file for a recent settlement, and raise a case with Amazon Seller Support if you cannot.
- Do it before November. The date has already moved once; being early costs nothing and being late costs a closing period.
Checking your V2 file
PayoutCheck reads the Flat File V2 settlement report and reconciles it line by line: it adds up what the rows say and compares that against the payout the file itself declares, then reports what does not add up. It will not tell you whether Amazon owes you money - it tells you which rows do not account for themselves, which is the part that takes an afternoon by hand. The check is free and runs on your real file.
Questions
What is the exact date?
11 November 2026. Amazon first announced 25 March 2026 and then moved it. Because it has already moved once, treat November as the latest safe deadline rather than a fixed one, and switch before it.
Does this change the numbers in my settlements?
Amazon says V2 presents the same information in fewer columns. What changes is the layout: prices and fees that had their own type and amount columns are condensed into amount-type, amount-description and amount, and amounts are shown in the local currency format. That is a reason to compare rather than to assume - if your V1 and V2 totals for the same period disagree, that is worth investigating before the old format goes away.
Can I still download settlement reports from Seller Central after this?
Amazon's notice covers the two API report types, and does not say what happens to the download options in the Seller Central interface. We are not going to guess at that. What is clear is that the old formats are being withdrawn, so anything built on them should move to V2 now.
I do not use the API. Does this affect me?
Possibly, and indirectly. Apps and integrations you use may read those report types on your behalf, and a spreadsheet template built on V1 column names will stop working against a V2 file. If you only ever open the report and read it, you have the least to do.
What if I cannot find a V2 file for my settlements?
Amazon's documentation for this change does not cover the Seller Central screens. If you cannot get a V2 file for a settlement, raise a case with Amazon Seller Support now rather than close to the date.
Sources
- Amazon SP-API changelog, removal of the XML and flat file settlement reports: developer-docs.amazon.com
- Amazon SP-API changelog, the original deprecation notice with the first date and the list of V2 changes: developer-docs.amazon.com
- Amazon SP-API, settlement reports and the Flat File V2 columns: developer-docs.amazon.com
This guide describes Amazon’s published change as of 6 October 2026, which can change. It is not accounting, tax or legal advice, and PayoutCheck is not affiliated with Amazon.