ErrorsAll codes
NIF_MISMATCH
The provided NIF does not match the user's NIF
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_MISMATCH",
"title": "NIF_MISMATCH",
"detail": "The provided NIF does not match the user's NIF",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "NIF_MISMATCH",
"message": "The provided NIF does not match the user's NIF",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
The provided NIF does not match the user's NIF
El NIF proporcionado no coincide con el NIF del usuario
El NIF proporcionat no coincideix amb el NIF de l''usuari
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