ErrorsAll codes
API_COMMUNICATION_ERROR
Error communicating with the VeriFactu API
Category: VeriFactu
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/API_COMMUNICATION_ERROR",
"title": "API_COMMUNICATION_ERROR",
"detail": "Error communicating with the VeriFactu API",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "API_COMMUNICATION_ERROR",
"message": "Error communicating with the VeriFactu API",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
Error communicating with the VeriFactu API
Error de comunicación con la API de VeriFactu
Error de comunicació amb l'API de VeriFactu
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
ALREADY_REGISTERED
The NIF is already registered in VeriFactu
COMPANY_NIF_MISSING
The issuing company has no NIF configured. Set the NIF before submitting invoices to VeriFactu
ENV_MISMATCH
API key does not match NIF environment: use a live key for production NIFs and a test key for sandbox NIFs
NIF_NOT_CONFIGURED
The profile has no NIF. Complete it before continuing.
NIF_NOT_REGISTERED
The NIF is not registered in VeriFactu