ErrorsAll codes
NIF_VALIDATION_ERROR
Technical error validating the NIF against the AEAT census
Category: VeriFactu
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/NIF_VALIDATION_ERROR",
"title": "NIF_VALIDATION_ERROR",
"detail": "Technical error validating the NIF against the AEAT census",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "NIF_VALIDATION_ERROR",
"message": "Technical error validating the NIF against the AEAT census",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
Technical error validating the NIF against the AEAT census
Error técnico al validar el NIF contra el censo de la AEAT
Error tècnic en validar el NIF contra el cens de l''AEAT
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