RECURRING_OCCURRENCE_ALREADY

That occurrence of the recurring template has already been billed: an invoice exists for that scheduled date. Check the template history before retrying.

Category: Invoices


HTTP status	`409` Conflict
Retry	No

When it happens

An invoice already exists for the occurrence you asked to generate, from the scheduled run or from an earlier call.

How to fix it

Check the recurring invoice's history before generating again.

Retry

Do not retry. The outcome is final: sending the same request again gets the same answer.

Returned by

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

POST /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}/generate

Example response

When this error occurs, the API answers 409 Conflict with a JSON body of this shape:

{
  "type": "https://docs.beel.es/errors/RECURRING_OCCURRENCE_ALREADY_CONSUMED",
  "title": "RECURRING_OCCURRENCE_ALREADY_CONSUMED",
  "detail": "That occurrence of the recurring template has already been billed: an invoice exists for that scheduled date. Check the template history before retrying.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "RECURRING_OCCURRENCE_ALREADY_CONSUMED",
    "message": "That occurrence of the recurring template has already been billed: an invoice exists for that scheduled date. Check the template history before retrying.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

That occurrence of the recurring template has already been billed: an invoice exists for that scheduled date. Check the template history before retrying.

Esa ocurrencia de la recurrencia ya se facturó: existe una factura para esa fecha programada. Consulta el historial de la plantilla antes de reintentar.

Aquesta ocurrència de la recurrència ja s'ha facturat: hi ha una factura per a aquella data programada. Consulta l'historial de la plantilla abans de reintentar.

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