NIF_REPRESENTATION

You must sign the AEAT representation model before issuing real invoices with this NIF

Category: VeriFactu


Retry	After fixing the cause

When it happens

The company's NIF is registered but it has not signed the representation that lets BeeL. submit its invoices to the tax authority. It is only required in production, where invoices reach the real tax authority. You receive it as one of the error.details.blockers[] of an EMISSION_NOT_READY response.

How to fix it

Generate the representation document, have the company's holder sign it, and submit it. Then issue again.

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.

Rules that cite this code

REC-011 The NIF holder signs the AEAT representation first

Example response

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

{
  "type": "https://docs.beel.es/errors/NIF_REPRESENTATION_REQUIRED",
  "title": "NIF_REPRESENTATION_REQUIRED",
  "detail": "You must sign the AEAT representation model before issuing real invoices with this NIF",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "NIF_REPRESENTATION_REQUIRED",
    "message": "You must sign the AEAT representation model before issuing real invoices with this NIF",
    "details": {}
  },
  "meta": {
    "timestamp": "2026-05-21T10:00:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}