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
BAD_REQUEST
The provided data is not valid.
BUSINESS_RULE_VIOLATION
The operation breaks a business rule.
CITY_EMPTY
City cannot be empty
CITY_MAX_LENGTH
City cannot exceed ‹value› characters