ErrorsAll codes
IRPF_REQUIRED_WHEN_NOT_EXEMPT
The income tax withholding percentage is required when not exempt
Category: General
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/IRPF_REQUIRED_WHEN_NOT_EXEMPT",
"title": "IRPF_REQUIRED_WHEN_NOT_EXEMPT",
"detail": "The income tax withholding percentage is required when not exempt",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "IRPF_REQUIRED_WHEN_NOT_EXEMPT",
"message": "The income tax withholding percentage is required when not exempt",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
The income tax withholding percentage is required when not exempt
El porcentaje de IRPF es obligatorio cuando no estás exento
El percentatge d''IRPF és obligatori quan no estàs exempt
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"