VERIFACTU_REPRESENTATION_REQUIRED

When it happens

You tried to enable VeriFactu in production for a company that has no signed representation. In production the signed representation is a precondition, because it is what lets BeeL. submit to the tax authority on the company's behalf. Sandbox does not require it.

How to fix it

Generate, sign and submit the company's representation, then enable VeriFactu 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.

• PUT /v1/companies/{company_id}/verifactu-configuration

Rules that cite this code

• REC-011 The NIF holder signs the AEAT representation first

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/VERIFACTU_REPRESENTATION_REQUIRED",
  "title": "VERIFACTU_REPRESENTATION_REQUIRED",
  "detail": "To enable VeriFactu in production you must first sign the AEAT representation form for this tax ID",
  "instance": "/v1/<resource>",
  "errors": [],
  "success": false,
  "error": {
    "code": "VERIFACTU_REPRESENTATION_REQUIRED",
    "message": "To enable VeriFactu in production you must first sign the AEAT representation form for this tax ID",
    "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.

Other errors in this category

Keep exploring