ErrorsBy category
General errors
All error codes returned by the General endpoints (66 total).
Every error returned by the General endpoints. Click any code for the full example response and localized messages.
| Code | Message |
|---|---|
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 |
CONCURRENT_MODIFICATION | The resource was modified by another operation. Please retry. |
CONFLICT | The operation conflicts with the current state of the resource. |
COUNTRY_CODE_MISMATCH | The country '‹value›' does not match country_code '‹value›'. Send only country_code, the country's ISO 3166-1 alpha-2 code. |
COUNTRY_CODE_REQUIRED | The country '‹value›' is not valid. Send the country's ISO 3166-1 alpha-2 code in country_code (for example, GB for the United Kingdom). |
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 |
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" |
EXTERNAL_SERVICE_ERROR | Error communicating with the external service |
FIELD_BLANK | The field '‹value›' cannot be empty |
FIELD_TOO_LONG | The field '‹value›' cannot exceed ‹value› characters. |
FILE_CORRUPTED | File is damaged or corrupt |
FILE_EMPTY | The file is empty |
FILE_TOO_LARGE | File is too large. Maximum allowed size: ‹value› |
FORBIDDEN | You do not have permission to perform this action |
IBAN_INVALID | Invalid IBAN: '‹value›'. Must match ISO 13616 format (e.g.: ES1234567890123456789012) |
IBAN_REQUIRED | Payment method ‹value› requires an IBAN |
IDEMPOTENCY_KEY_MISMATCH | This idempotency key was already used with a different request body. Use a new key for a different operation. |
IDEMPOTENCY_KEY_PROCESSING | A request with this idempotency key is already being processed. Wait and retry with the same key. |
IDEMPOTENCY_KEY_REQUIRED | This operation requires the Idempotency-Key header: without it, a retry would import the same file twice. |
INTERNAL_ERROR | An unexpected error occurred. Please try again later. |
INVALID_CONTENT | File content is not valid |
INVALID_EMAIL_FORMAT | The email '‹value›' has an invalid format |
INVALID_EXTENSION | File extension not allowed |
INVALID_FILE_TYPE | File type not allowed. Accepted types: ‹value› |
INVALID_IDEMPOTENCY_KEY | Invalid idempotency key format. Must be a UUID or an alphanumeric string. |
INVALID_JSON_FORMAT | The request body contains invalid JSON syntax. |
IRPF_REQUIRED_WHEN_NOT_EXEMPT | The income tax withholding percentage is required when not exempt |
MAIN_TAX_REQUIRED | You must configure a main tax (VAT, IGIC or IPSI) |
METHOD_NOT_ALLOWED | The HTTP method used is not allowed on this path. |
MISSING_HEADER | A required request header is missing. |
MISSING_PARAMETER | A required request parameter is missing. |
MISSING_PART | A required part of the multipart request is missing. |
MISSING_REQUIRED_FIELD | The field '‹value›' is required |
NIF_DE_BAJA | The NIF '‹value›' is deregistered in the AEAT census and cannot issue invoices |
NIF_REVOCADO | The NIF '‹value›' has been revoked by the AEAT and cannot operate |
NOT_ACCEPTABLE | The response cannot be returned in the requested content type. |
NOT_FOUND | ‹value› with identifier '‹value›' does not exist or is not available to this credential. |
NUMBER_MAX_LENGTH | Number cannot exceed ‹value› characters |
PLAZO_DIAS_OUT_OF_RANGE | Payment term must be between ‹value› and ‹value› days |
POSTAL_CODE_EMPTY | Postal code cannot be empty |
POSTAL_CODE_INVALID_ES | Invalid Spanish postal code: '‹value›'. Must be 5 digits |
PROVINCE_EMPTY | Province cannot be empty |
PROVINCE_MAX_LENGTH | Province cannot exceed ‹value› characters |
RATE_LIMIT_EXCEEDED | You have exceeded the request rate limit. Wait the seconds given in the Retry-After header and try again. |
RECARGO_EQUIVALENCIA_REQUIRED | The equivalence surcharge is required for this type of operation |
RECARGO_IVA_COMBINATION_INVALID | The equivalence surcharge does not match the chosen VAT rate. |
RECARGO_REQUIRES_REGIME_RE | When equivalence surcharge is enabled, the main tax regime must be "18 - Equivalence surcharge". Change the regime to 18 or disable the surcharge. |
REQUEST_BLOCKED | A security filter at the edge rejected this request before the API saw its body. This usually happens because a text field contains something that looks like code or markup (HTML tags, scripts). Review the request body and try again. |
REQUEST_BODY_TOO_LARGE | The request body exceeds the maximum allowed size of ‹value›. |
SERVICE_UNAVAILABLE | The service is temporarily unavailable. Please try again in a few seconds. |
STREET_EMPTY | Street cannot be empty |
STREET_MAX_LENGTH | Street cannot exceed ‹value› characters |
SWIFT_INVALID | Invalid SWIFT code: '‹value›'. Must be 8 or 11 characters (e.g.: ABCDESMMXXX) |
TAX_CONFIG_CONFLICT | Another operation created the tax configuration at the same time. Please try again. |
TOO_MANY_REQUESTS | You have exceeded the request limit. Please try again in ‹value› seconds |
UNSUPPORTED_MEDIA_TYPE | The submitted content type is not supported. |
VALIDATION_ERROR | The provided data is not valid. |
VALUE_OUT_OF_RANGE | The value provided exceeds the range allowed for that field |
VALUE_TOO_LONG | The value provided exceeds the maximum length allowed for that field |
ZERO_RATE_REQUIRES_EXEMPTION_REASON | 0% is not a tax rate: state why the operation carries no tax (art. 20 exemption or another reason) |