ErrorsAll codes
RECARGO_EQUIVALENCIA_REQUIRED
The equivalence surcharge is required for this type of operation
Category: General
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/RECARGO_EQUIVALENCIA_REQUIRED",
"title": "RECARGO_EQUIVALENCIA_REQUIRED",
"detail": "The equivalence surcharge is required for this type of operation",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "RECARGO_EQUIVALENCIA_REQUIRED",
"message": "The equivalence surcharge is required for this type of operation",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
The equivalence surcharge is required for this type of operation
El recargo de equivalencia es obligatorio para este tipo de operación
El recàrrec d''equivalència és obligatori per a aquest tipus d''operació
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
CONFIGURATION_INVALID
The configuration is not valid
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
EXEMPTION_REASON_REQUIRES_ZERO_RATE
An exemption reason is only compatible with a 0% tax rate
EXEMPTION_REASON_TEXT_REQUIRED
Provide the text explaining the exemption when the reason is "Other"