ErrorsAll codes
MAIN_TAX_REQUIRED
You must configure a main tax (VAT, IGIC or IPSI)
Category: General
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/MAIN_TAX_REQUIRED",
"title": "MAIN_TAX_REQUIRED",
"detail": "You must configure a main tax (VAT, IGIC or IPSI)",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "MAIN_TAX_REQUIRED",
"message": "You must configure a main tax (VAT, IGIC or IPSI)",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
You must configure a main tax (VAT, IGIC or IPSI)
Debes configurar un impuesto principal (IVA, IGIC o IPSI)
Has de configurar un impost principal (IVA, IGIC o IPSI)
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
FIELD_BLANK
The field ''{0}'' cannot be empty
FILE_CORRUPTED
File is damaged or corrupt
FILE_EMPTY
The file is empty