invoice_year_required_for_ambiguous_number
That invoice number matches more than one invoice, so on its own it identifies none. It repeats for two independent reasons: the fiscal year (series recycle numbering every year) and the series (two series of your company each issue their own F-2026-001).
| Code | Type | HTTP | Category |
|---|---|---|---|
invoice_year_required_for_ambiguous_number | invalid_request_error | 422 | Invoices |
Cause
That invoice number matches more than one invoice, so on its own it identifies none. It repeats for two independent reasons: the fiscal year (series recycle numbering every year) and the series (two series of your company each issue their own F-2026-001).
What to do
Repeat the lookup adding series_id, year, or both; error.message lists the series found — with their identifier — and the fiscal years, and error.param points at whichever narrows your case.
Related
All Invoices error codes
Causes and actions for errors in this category.
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.