New: Invoices API v2024-06-19 for FBA Brazil
Amazon released Invoices API v2024-06-19 for the Brazil marketplace on June 19, 2024. It adds GET /invoices/v2024-06-19/invoices and POST /invoices/v2024-06-19/download, supports pagination (100 records per page), async jobs with a pre‑signed URL valid ~15 min, and a default 10 RPS rate limit.
Overview
Amazon has introduced a new version of its Invoices API, dated 2024‑06‑19, that enables sellers on the Brazil marketplace to locate, filter, and download FBA invoices through code. The endpoint is live today and replaces the manual download steps in Seller Central, giving sellers the ability to automate accounting, reporting, and tax‑compliance processes.
Key Points
- Release identifier — The API is labeled v2024‑06‑19, meaning its schema and behavior are locked as of June 19 2024.
- Brazil‑only availability — All calls apply exclusively to the Brazil (BR) marketplace and support local fiscal documents such as NF‑e and CT‑e.
- Search‑first workflow — Sellers provide filter criteria (date range, order IDs, invoice status) and receive a paginated list of matching invoice IDs.
- Background download — Large batches are processed asynchronously; the service returns a pre‑signed URL once the job finishes.
- SP‑API security model — Requests must be signed with AWS Signature V4 and include the sellingpartnerapi::notifications scope.
- Rate‑limit policy — The default ceiling is 10 requests per second per seller account, with the option to request higher limits.
How Invoices API Works
-
Submit a search request — The seller issues a
GET /invoices/v2024-06-19/invoicescall, adding query parameters such asstartDate,endDate, and optionallyorderId.
Example: To retrieve every invoice issued between March 1 and March 31 2024, the query string contains"startDate":"2024-03-01","endDate":"2024-03-31". -
Receive a paginated result set — The response returns an array of invoice summaries, each holding fields like
invoiceId,orderId,issueDate, andstatus. If more than 100 records exist, a appears for subsequent calls. : The first call returns 100 invoices; the seller appends to the next request to fetch the following 100.
Analysis & Recommendations
Why This Matters
Sellers can replace manual PDF downloads in Seller Central with automated calls, pulling daily invoices, storing them in encrypted S3, and feeding tax‑compliance systems. The async job and 15‑minute URL reduce latency, while the 10 RPS limit requires throttling logic.
Key Takeaways
- API version v2024-06-19 is Brazil‑only and supports NF‑e/CT‑e fiscal documents.
- Search endpoint returns up to 100 invoice summaries per page and uses a nextToken for pagination.
- Download requests are processed asynchronously; a jobId is returned and the final pre‑signed S3 URL expires after about 15 minutes.
- Default rate limit is 10 requests per second per seller account, with throttling handling needed.
Recommended Actions
- →Add GET /invoices/v2024-06-19/invoices and POST /invoices/v2024-06-19/download calls to your SP‑API client, signing with the sellingpartnerapi::not...
- →Implement pagination by checking for nextToken after each GET request and looping until it disappears.
- →Create a background worker (e.g., Lambda) that posts invoice IDs, polls GET /invoices/v2024-06-19/download/{jobId} every 5 seconds, downloads the p...
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!