RECTIFICATION_REASON

A corrective invoice must state the reason for the correction.

Category: Invoices


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

When it happens

The corrective invoice does not say why it corrects the original. The reason is part of the fiscal record.

How to fix it

Send the reason for the correction.

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.

POST /v1/companies/{company_id}/invoices/{invoice_id}/corrective

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/RECTIFICATION_REASON_REQUIRED",
  "title": "RECTIFICATION_REASON_REQUIRED",
  "detail": "A corrective invoice must state the reason for the correction.",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "RECTIFICATION_REASON_REQUIRED",
    "message": "A corrective invoice must state the reason for the correction.",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}