INVOICE_NUMBER_TOO

The number ‹value› has ‹value› characters and the AEAT accepts at most ‹value›. The invoice was not issued and the number was not used: issue it with another series or, if this one has no issued invoices yet, shorten its code or format

Category: Invoices


HTTP status	`422` Unprocessable Content
Retry	After fixing the cause

When it happens

At issue time, the generated invoice number has more than the 60 characters characters the AEAT accepts. The invoice is not issued and the number is not used.

How to fix it

Issue it with another series, or shorten the series code or format while the series has no issued invoices, and retry.

Retry

Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.

Returned by

The operations where this code is most likely. The list is not exhaustive.

Rules that cite this code

NUM-008 An invoice number fits AEAT's length and character set

Example response

When this error occurs, the API answers 422 Unprocessable Content with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/INVOICE_NUMBER_TOO_LONG",
  "title": "INVOICE_NUMBER_TOO_LONG",
  "detail": "The number ‹value› has ‹value› characters and the AEAT accepts at most ‹value›. The invoice was not issued and the number was not used: issue it with another series or, if this one has no issued invoices yet, shorten its code or format",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "INVOICE_NUMBER_TOO_LONG",
    "message": "The number ‹value› has ‹value› characters and the AEAT accepts at most ‹value›. The invoice was not issued and the number was not used: issue it with another series or, if this one has no issued invoices yet, shorten its code or format",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

The type URI is stable and always resolves to this page.

Message

El número ‹value› tiene ‹value› caracteres y la AEAT solo admite ‹value›. La factura no se ha emitido y el número no se ha consumido: emítela con otra serie o, si esta aún no tiene facturas emitidas, acorta su código o su formato

El número ‹value› té ‹value› caràcters i l'AEAT només n'admet ‹value›. La factura no s'ha emès i el número no s'ha consumit: emet-la amb una altra sèrie o, si aquesta encara no té factures emeses, escurça'n el codi o el format

Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.

Placeholders like ‹value› are filled in at runtime with the actual values of your request.

Other errors in this category

ATTACH_SOURCE_INVOICE_UNAVAILABLE

A source invoice is not available (it does not exist or you no longer have access); uncheck the source invoices attachment to send without the folder

ATTACH_SOURCE_INVOICES_NO_SOURCES

The invoice has no consolidation disbursements: there are no source invoices to attach

ATTACH_SOURCE_INVOICES_REQUIRES_PDF

Attaching the source invoices also requires attaching the invoice PDF

ATTACH_SOURCE_PDF_MISSING

These source invoices have no generated PDF: ‹value›

ATTACH_SOURCE_ZIP_TOO_LARGE

The source invoices ZIP (‹value› MB) exceeds the maximum sendable size (‹value› MB)

INVOICE_NUMBER_TOO_LONG