IMMUTABLE

NIF/CIF cannot be changed. This field is immutable


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

When it happens

The request changes the company's nif, which cannot change once set. Nothing was written.

How to fix it

Drop the field from the request. Sending the value it already has is not a change and is accepted.

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}

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/IMMUTABLE_NIF",
  "title": "IMMUTABLE_NIF",
  "detail": "NIF/CIF cannot be changed. This field is immutable",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "IMMUTABLE_NIF",
    "message": "NIF/CIF cannot be changed. This field is immutable",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

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

Message

NIF/CIF cannot be changed. This field is immutable

No se puede cambiar el NIF/CIF. Este campo es inmutable

No es pot canviar el NIF/CIF. Aquest camp és immutable

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

Other errors in this category

ACTIVE_CANNOT_DELETE

Cannot delete an active series. Deactivate it first

DEFAULT_CANNOT_BE_UNMARKED

Cannot unmark the default series. Set another series as default first

DEFAULT_CANNOT_DEACTIVATE

Cannot deactivate the default series. Set another series as default first

DEFAULT_CANNOT_DELETE

Cannot delete the default series. Set another series as default first

ENTITY_TYPE_INCONSISTENT_WITH_NIF

The entity type ‹value› does not match the NIF ‹value›: an individual is identified by a DNI or NIE, and a company or entity by a NIF that starts with a legal-form letter

IMMUTABLE_NIF