ALTERNATIVE_ID_SPAIN_INVALID_TYPE
For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed
Category: Customers
| HTTP status | 422 Unprocessable Content |
Rules that cite this code
Example response
When this error occurs, the API answers 422 Unprocessable Content with a JSON body of this shape:
{
"type": "https://docs.beel.es/errors/ALTERNATIVE_ID_SPAIN_INVALID_TYPE",
"title": "ALTERNATIVE_ID_SPAIN_INVALID_TYPE",
"detail": "For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "ALTERNATIVE_ID_SPAIN_INVALID_TYPE",
"message": "For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
ALTERNATIVE_ID_AND_NIF_EXCLUSIVE
The customer cannot carry both a NIF and an alternative identifier. Use only one
ALTERNATIVE_ID_COUNTRY_REQUIRED
The country of the alternative identifier is missing (alternative_id.country_code). It is required except for the PASSPORT and NOT_REGISTERED types, which are taken as Spanish when it is omitted.
ALTERNATIVE_ID_INVALID
The alternative identifier is not valid
ALTERNATIVE_ID_REQUIRES_SPAIN
Type NOT_REGISTERED (07) is only valid for Spain; received country: '‹value›'
ALTERNATIVE_ID_VAT_INVALID_FORMAT
'‹value›' is not a valid EU VAT number for that country: it must be the prefix '‹value›' followed by the country's VAT number, in capital letters and without spaces. If it is the recipient of an invoice already issued, correct its data with an R4 corrective invoice
Keep exploring
ALTERNATIVE_ID_REQUIRES_SPAIN
Type NOT_REGISTERED (07) is only valid for Spain; received country: '‹value›'
ALTERNATIVE_ID_VAT_INVALID_FORMAT
'‹value›' is not a valid EU VAT number for that country: it must be the prefix '‹value›' followed by the country's VAT number, in capital letters and without spaces. If it is the recipient of an invoice already issued, correct its data with an R4 corrective invoice