How does Nova read Amazon's payments and deductions?
A remittance is a payment from Amazon and the list of documents it settles: the invoices it paid and everything it deducted. Nova reads them every day from the Finance Remittance API, the same data as Payments, Remittance in Vendor Central, sorts each line into a family, and books the deductions that are costs into your 1P P&L.
Checked against Nova's code on October 29, 2026
All docs
How does Nova read remittances?
- Daily at 17:15 UTC, re-reading payments dated in the last 60 days: Amazon lists a payment late and updates its status.
- 24 months of payment dates when you connect.
- A payment counts once it went through: completed, or in progress for more than 14 days. Announced and failed payments are listed, not counted.
- Transfer or offset: a transfer moves money to your bank; an offset settles invoices against deductions with no money moving.
- One line per document tranche: one co-op document is often taken over many payments.
How is each line classified?
Nova reads Amazon's line type, description and document number, in this order. The first rule that matches wins:
| # | Amazon's line | Family |
|---|---|---|
| 1 | Description names a shortage claim or a missed adjustment | Shortage claim |
| 1 | Description names a price claim | Price claim |
| 2 | Type Inventory | Invoice payment |
| 3 | A provision for aged receivables or a post-audit, and its reversal | Provision |
| 4 | C2FO discount | Early-payment discount |
| 5 | Type Chargebacks | Chargeback, with the defect in English |
| 6 | Type Amazon Marketing Services | Advertising |
| 7 | Type Distributor returns, or a returns document | Return to vendor |
| 8 | RETURN FREIGHT CHARGES | Return freight |
| 9 | Type Contra Cogs | Co-op and allowances: Co-op, SPA, AVS, Damage Allowance, Price Protection, Freight Allowance |
| 10 | Freight Deduction or Misc Deduction of a reference | Other deduction |
| 11 | Anything else | Not classified, with Amazon's own type and description |
A positive line in a deduction family is a payback and nets against it. Nova never guesses from a number prefix.
Where does each deduction land in the P&L?
Deductions are account lines: they land on the account, never spread across your products.
| Family | 1P P&L line | Dated at |
|---|---|---|
| Co-op and allowances | Amazon fees, Co-op and allowances | The agreement document's date |
| Chargeback | Amazon fees, Chargebacks | Payment date |
| Return freight | Amazon fees, Return freight | Payment date |
| Other deduction, Not classified | Amazon fees, Other deductions | Payment date |
| Early-payment discount | Amazon deductions | Payment date |
| Return to vendor (the goods) | Not a cost: net received is already net of them. Shown as Returned goods under Invoiced to Amazon. | Payment date |
| Shortage and price claims | Not a cost: shown settled and withheld under Invoiced to Amazon, from your invoices | Invoice date |
| Advertising | Not booked here: it is already your ad spend from Amazon Ads | |
| Provision | Not a cost: Amazon holds it, then reverses it |
Nova converts each deduction to your workspace currency at the rate of the payment date.
Is the co-op still shown under Amazon fees?
Yes, as a named line. On a 1P P&L, Amazon fees opens on four lines: Co-op and allowances, Chargebacks, Return freight, Other deductions. They add up to the total.
Before Amazon's first co-op document reaches your remittances, Nova estimates it: your net received × the co-op Amazon accrued over the last 30 days as a share of your shipped COGS (90 days when 30 hold under 5,000 of shipped COGS, else the latest rate). The line reads Co-op and allowances (est. N%), or (partly est.) for a period that straddles that document. From the document on, the line is the real co-op.
The co-op under Amazon's shelf is another figure: Amazon's accrual on what it shipped.
Where you see it
- App: the Amazon fees lines of the Profit & Loss page, the Amazon owes you band, and the invoice register's tabs: Open, Paid (each payment with its lines) and Deducted (twelve months of deductions by family).
- MCP:
query_vendor_remittances, by payment or by line. - Data Share:
vendor_remittances, one row per line with itsfamilyandline_class, in the payment currency with Amazon's signs.vendor_product_metricscarries the converted deductions.
Ask your AI
List what Amazon deducted from my Vendor Central payments last quarter by family, and which chargebacks grew the most.
Something missing or unclear? Write to contact@novadata.io. New to Nova? Start a free trial.