INVOICE_REQUIRES_AT_LEAST_ONE_NORMAL_LINE

The invoice must contain at least one NORMAL line (disbursements cannot be invoiced alone): an invoice with only disbursements documents no operation. Add the item you are invoicing; on a corrective, also correct a NORMAL line, or document the disbursement on the invoice of the operation.

Category: Invoices


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

When it happens

Every line of the invoice is a disbursement (SUPLIDO). An invoice of disbursements alone documents no operation, so it is not an invoice.

How to fix it

Put the disbursement on the invoice of the operation it goes with, next to at least one NORMAL line.

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

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_REQUIRES_AT_LEAST_ONE_NORMAL_LINE",
  "title": "INVOICE_REQUIRES_AT_LEAST_ONE_NORMAL_LINE",
  "detail": "The invoice must contain at least one NORMAL line (disbursements cannot be invoiced alone): an invoice with only disbursements documents no operation. Add the item you are invoicing; on a corrective, also correct a NORMAL line, or document the disbursement on the invoice of the operation.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "INVOICE_REQUIRES_AT_LEAST_ONE_NORMAL_LINE",
    "message": "The invoice must contain at least one NORMAL line (disbursements cannot be invoiced alone): an invoice with only disbursements documents no operation. Add the item you are invoicing; on a corrective, also correct a NORMAL line, or document the disbursement on the invoice of the operation.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

La factura debe contener al menos una línea NORMAL (los suplidos no pueden facturarse en solitario): una factura de solo suplidos no documenta ninguna operación. Añade el concepto que facturas; en una rectificativa, corrige también una línea NORMAL o documenta el suplido en la factura de la operación.

La factura ha de contenir almenys una línia NORMAL (els suplerts no poden facturar-se en solitari): una factura només de suplerts no documenta cap operació. Afegeix el concepte que factures; en una rectificativa, corregeix també una línia NORMAL o documenta el suplert a la factura de l'operació.

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

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)

Keep exploring

All Invoices errors

Every code in this category in one table.

Error reference home

Browse every category or jump to the handling guide.

INVOICE_NUMBER_TOO_LONG

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

INVOICE_SERIES_NOT_FOUND

Invoice series '‹value›' not found