ErrorsAll codes
VERIFACTU_REPRESENTATION_REQUIRED
To enable VeriFactu in production you must first sign the AEAT representation form for this tax ID
Category: VeriFactu
Example response
When this error occurs, the API returns a JSON response with the following 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
To enable VeriFactu in production you must first sign the AEAT representation form for this tax ID
Para activar VeriFactu en producción necesitas antes firmar el modelo de representación AEAT de este NIF
Per activar VeriFactu en producció has de signar abans el model de representació AEAT d'aquest NIF
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
ALREADY_DISABLED
VeriFactu is already disabled for this user
ALREADY_ENABLED
VeriFactu is already enabled for this user
ALREADY_REGISTERED
The NIF is already registered in VeriFactu
API_COMMUNICATION_ERROR
Error communicating with the VeriFactu API
API_KEY_NOT_CONFIGURED
The VeriFactu API key has not been configured