ErrorsBy category
Account settings errors
All error codes returned by the Account settings endpoints (38 total).
Every error returned by the Account settings endpoints. Click any code for the full example response and localized messages.
| Code | Message |
|---|---|
DEFAULT_CANNOT_BE_UNMARKED | Cannot unmark the default series. Set another series as default first |
DEFAULT_CANNOT_DEACTIVATE | Cannot deactivate the default series. Set another series as default first |
DEFAULT_CANNOT_DELETE | Cannot delete the default series. Set another series as default first |
ENTITY_TYPE_INCONSISTENT_WITH_NIF | The entity type ‹value› does not match the NIF ‹value›: an individual is identified by a DNI or NIE, and a company or entity by a NIF that starts with a legal-form letter |
FISCAL_IDENTITY_LIVE_ONLY | This company is live. In Test mode you can only change how the invoice looks (logo, colour, template, languages and additional information). Fiscal details are edited in Live mode |
HAS_INVOICES_CANNOT_DELETE | Cannot delete a series that has associated invoices. Delete the invoices first |
IMMUTABLE_ENTITY_TYPE | Entity type (individual/company) cannot be changed. This field is immutable |
IMMUTABLE_LEGAL_FORM | Legal form cannot be changed. This field is immutable |
IMMUTABLE_NIF | NIF/CIF cannot be changed. This field is immutable |
INACTIVE_CANNOT_BE_DEFAULT | Cannot set an inactive series as default |
INVALID_IBAN | The IBAN format is not valid. It must start with the country code and be 15 to 34 characters long (e.g. ES9121000418450200051332) |
NIF_CENSUS_MISMATCH | The NIF does not match the fiscal name in the AEAT census. Please verify that both values match your official records exactly. Detail: ‹value› |
PHYSICAL_PERSON_CANNOT_HAVE_LEGAL_FORM | Individuals cannot have a legal form |
PHYSICAL_PERSON_CANNOT_HAVE_REPRESENTATIVE | Individuals cannot have a legal representative |
PROFILE_INCOMPLETE | Your tax profile is incomplete. Complete the required data before issuing invoices |
PROFILE_NOT_FOUND | User profile not found |
REFERENCED_BY_PAYMENT_CONNECTION | Cannot delete or deactivate the series: it is configured in a payment connection. Remove it from the connection settings first or choose another series there |
REFERENCED_BY_RECURRING_INVOICE | Cannot delete or deactivate the series: there are active or paused recurring invoice templates using it. Finish them or switch them to another series first |
SERIES_ANNUAL_REQUIRES_YEAR | Annual reset requires the format to include the year ({YYYY} or {YY}); otherwise the invoice number would repeat every year. |
SERIES_CODE_DUPLICATED | The code '‹value›' is already taken by a series, existing or deleted. Series codes are never reused: they identify invoices already issued. Choose a different code. |
SERIES_CODE_LOCKED_HAS_INVOICES | Cannot modify the series code because it has associated invoices. This would affect numbering integrity. |
SERIES_COMPANY_DELETED | The series belongs to a deleted tax ID: it cannot be activated or set as default. |
SERIES_DEFAULT_CONFLICT | Another operation changed the default series for this document type at the same time. Please try again. |
SERIES_DEFAULT_NOT_FOUND | You have no default invoice series. Create a series in settings before issuing invoices. |
SERIES_DOCUMENT_TYPE_LOCKED_HAS_INVOICES | The document type of a series that has already numbered invoices cannot be changed: it would number two types in the same sequence (RD 1619/2012, arts. 6.1.a and 7.1.a). Create a new series for the other type. |
SERIES_FORMAT_INVALID_CHARACTERS | The number this series generates would contain characters the AEAT does not accept: ‹value›. Use printable ASCII characters only, without quotes, <, > or = |
SERIES_FORMAT_LOCKED_HAS_INVOICES | Cannot modify the series format because it has associated invoices. This would affect numbering integrity. |
SERIES_FORMAT_NUMBER_TOO_LONG | The number this series generates can reach ‹value› characters and the AEAT accepts at most ‹value› (series and number together). Shorten the code or the fixed text of the format |
SERIES_FORMAT_OVERLAPS | This series' format can produce the same numbers as series '‹value›'. An invoice number must be unique per issuer: change the code or the format. |
SERIES_INCOMPATIBLE_DOC_TYPE | Series '‹value›' does not accept documents of type ‹value›: each series numbers only its own type. Choose a series of that type. |
SERIES_INITIAL_NUMBER_LOCKED_HAS_INVOICES | Cannot modify the initial number because the series has associated invoices. This would affect numbering integrity. |
SERIES_INITIAL_NUMBER_OUT_OF_RANGE | The initial number must be between 1 and 999999 |
SERIES_MONTHLY_REQUIRES_MONTH_AND_YEAR | Monthly reset requires the format to include the month ({MM}) and the year ({YYYY} or {YY}); otherwise the invoice number would repeat every month. |
SERIES_NOT_FOUND | Invoice series not found |
SERIES_NUMBERING_FROZEN | This series has already assigned invoice numbers: its code, format, reset policy and initial number cannot be modified. |
SERIES_RESET_LOCKED_HAS_INVOICES | Cannot modify the counter reset policy because the series has associated invoices. This would affect numbering integrity. |
SERIES_TYPE_CHANGE_LEAVES_TYPE_UNCOVERED | Cannot change the type of this series: it is the default for ‹value›, and that type still has other active series that would be left without a default. Set another ‹value› series as default first |
SERIES_UNASSIGNED_TYPE_NOT_ALLOWED | Set the series' document type. Unassigned series can no longer be created: corrective invoices need a series of their own. |