STATUS_NOT_MODIFIABLE

When it happens

The invoice is past the point where it can change. Editing an invoice (422) is only possible while it is DRAFT or SCHEDULED, or an ACTIVE proforma; once issued, its content is a fiscal record. Setting the status to PAID (400) is only possible from ISSUED or SENT.

How to fix it

Fetch the invoice and read its status. To change the content of an issued invoice, create a corrective invoice from it; void it only if it should never have been issued. To mark a draft as paid, issue it first.

HTTP status

This code can arrive with 422 Unprocessable Content or 400 Bad Request, depending on the operation. Branch on error.code, not on the status alone.

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.

• PATCH /v1/companies/{company_id}/invoices/{invoice_id}
• PUT /v1/companies/{company_id}/invoices/{invoice_id}/status

Rules that cite this code

• LIF-001 An issued invoice is never edited or deleted

Example response

When this error occurs, the API returns a JSON response with the following shape:

{
  "type": "https://docs.beel.es/errors/STATUS_NOT_MODIFIABLE",
  "title": "STATUS_NOT_MODIFIABLE",
  "detail": "Cannot modify an invoice in status ‹status›",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "STATUS_NOT_MODIFIABLE",
    "message": "Cannot modify an invoice in status ‹status›",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

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

Placeholders are filled in at runtime:

• ‹status› — the invoice's current status, for example ISSUED.

Other errors in this category

Keep exploring