# NIF_REPRESENTATION_REQUIRED

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

<Callout type="info">
**Category:** [VeriFactu](/errors/category/verifactu)
</Callout>

| | |
|---|---|
| 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.

- [`POST /v1/companies/{company_id}/invoices/{invoice_id}/issue`](/invoices/issueCompanyInvoice)
- [`POST /v1/companies/{company_id}/invoices`](/invoices/createCompanyInvoice)

## Rules that cite this code

- [REC-011 · The NIF holder signs the AEAT representation first](/rules/records#rec-011)

## Example response

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

```json
{
  "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"
  }
}
```

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

## Message

<Tabs items={["English", "Spanish", "Catalan"]}>
  <Tab value="English">{"You must sign the AEAT representation model before issuing real invoices with this NIF"}</Tab>
  <Tab value="Spanish">{"Debes firmar el modelo de representación AEAT antes de emitir facturas reales con este NIF"}</Tab>
  <Tab value="Catalan">{"Has de signar el model de representació davant l'AEAT abans d'emetre factures reals amb aquest NIF"}</Tab>
</Tabs>

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

## Other errors in this category

<div className="grid grid-cols-2 gap-3 not-prose">
  <Card title="ALREADY_DISABLED" description="VeriFactu is already disabled for this user" href="/errors/ALREADY_DISABLED" />
  <Card title="ALREADY_ENABLED" description="VeriFactu is already enabled for this user" href="/errors/ALREADY_ENABLED" />
  <Card title="ALREADY_REGISTERED" description="The NIF is already registered in VeriFactu" href="/errors/ALREADY_REGISTERED" />
  <Card title="API_COMMUNICATION_ERROR" description="Error communicating with the VeriFactu API" href="/errors/API_COMMUNICATION_ERROR" />
  <Card title="API_KEY_NOT_CONFIGURED" description="The VeriFactu API key has not been configured" href="/errors/API_KEY_NOT_CONFIGURED" />
</div>

## Keep exploring

<div className="grid grid-cols-2 gap-3 not-prose">
  <Card title="All VeriFactu errors" description="Every code in this category in one table." href="/errors/category/verifactu" />
  <Card title="Error reference home" description="Browse every category or jump to the handling guide." href="/errors" />
</div>

---

Full OpenAPI spec: https://docs.beel.es/api/openapi