TOTAL_CORRECTIVE_NOT

A total corrective invoice cannot be voided: the invoice it corrects would stay voided with nothing to offset it. If what it rectified was wrong, issue a new invoice for what should have stayed invoiced.

Category: Invoices


HTTP status	`422` Unprocessable Content
Retry	No

When it happens

The invoice is a TOTAL corrective. Voiding it would leave the invoice it rectifies voided with nothing to offset it.

How to fix it

If what was rectified was wrong, issue a new invoice for what was actually owed.

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}/invoices/{invoice_id}/void

Rules that cite this code

VOI-005 A corrected invoice, or a total corrective, is not voided

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/TOTAL_CORRECTIVE_NOT_VOIDABLE",
  "title": "TOTAL_CORRECTIVE_NOT_VOIDABLE",
  "detail": "A total corrective invoice cannot be voided: the invoice it corrects would stay voided with nothing to offset it. If what it rectified was wrong, issue a new invoice for what should have stayed invoiced.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "TOTAL_CORRECTIVE_NOT_VOIDABLE",
    "message": "A total corrective invoice cannot be voided: the invoice it corrects would stay voided with nothing to offset it. If what it rectified was wrong, issue a new invoice for what should have stayed invoiced.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

No se puede anular una rectificativa total: la factura que rectifica quedaría anulada sin nada que lo compense. Si lo rectificado no era correcto, emite una factura nueva por lo que debía quedar facturado.

No es pot anul·lar una rectificativa total: la factura que rectifica quedaria anul·lada sense res que ho compensi. Si el que va rectificar no era correcte, emet una factura nova pel que havia de quedar facturat.

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