ErrorsAll codes
BAD_REQUEST
The provided data is not valid.
Category: General
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/BAD_REQUEST",
"title": "BAD_REQUEST",
"detail": "The provided data is not valid.",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "BAD_REQUEST",
"message": "The provided data is not valid.",
"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 data is not valid.
Los datos proporcionados no son válidos.
Les dades proporcionades no són vàlides.
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
AUTOMATIC_EMAIL_CONFIG_INVALID
For automatic sending, you must provide an email configuration or a client with email
BUSINESS_RULE_VIOLATION
The operation breaks a business rule.
CONFIGURATION_INVALID
The configuration is not valid
ENDPOINT_NOT_FOUND
The requested endpoint does not exist.
EXEMPTION_REASON_NOT_ALLOWED_AS_DEFAULT
That reason depends on each invoice and cannot be declared as a default: choose art. 20 exemption or other