RECURRING_MAX_INVOICES_BELOW_GENERATED

The cap cannot fall below the ‹generated› invoices already generated: issued invoices are fiscal facts and are not undone by lowering the cap. To stop it now, end the recurrence by setting its status to COMPLETED.

Category: Invoices


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

When it happens

The new max_invoices is lower than the number of invoices the recurrence has already generated. Issued invoices are not undone by lowering the cap.

How to fix it

Send a max_invoices equal to or higher than the invoices already generated. To stop the recurrence now, set its status to COMPLETED.

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.

PATCH /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}

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/RECURRING_MAX_INVOICES_BELOW_GENERATED",
  "title": "RECURRING_MAX_INVOICES_BELOW_GENERATED",
  "detail": "The cap cannot fall below the ‹generated› invoices already generated: issued invoices are fiscal facts and are not undone by lowering the cap. To stop it now, end the recurrence by setting its status to COMPLETED.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "RECURRING_MAX_INVOICES_BELOW_GENERATED",
    "message": "The cap cannot fall below the ‹generated› invoices already generated: issued invoices are fiscal facts and are not undone by lowering the cap. To stop it now, end the recurrence by setting its status to COMPLETED.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

El cupo no puede quedar por debajo de las ‹generated› facturas ya generadas: las facturas emitidas son hechos fiscales y no se descuentan bajando el cupo. Si quieres pararla ya, termina la recurrencia poniendo su estado en COMPLETED.

El límit no pot quedar per sota de les ‹generated› factures ja generades: les factures emeses són fets fiscals i no es descompten abaixant el límit. Si vols aturar-la ja, finalitza la recurrència posant el seu estat a COMPLETED.

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

Placeholders are filled in at runtime:

‹generated› — how many invoices the recurrence has already generated.

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.

RECURRING_MAX_INVOICES_ABOVE_MAXIMUM

A recurring template cannot be capped above 600 invoices, fifty years of monthly billing

RECURRING_MAX_INVOICES_BELOW_MINIMUM

A recurring template cannot be capped below 2 invoices. For a single invoice you do not need a recurrence: schedule the invoice with PUT /v1/companies/{company_id}/invoices/{invoice_id}/schedule, which also issues it on the exact date you choose instead of on the recurrence day of month.