ErrorsAll codes
ALTERNATIVE_ID_INVALID
The alternative identifier is not valid
Category: Customers
Example response
When this error occurs, the API returns a JSON response with the following shape:
{
"type": "https://docs.beel.es/errors/ALTERNATIVE_ID_INVALID",
"title": "ALTERNATIVE_ID_INVALID",
"detail": "The alternative identifier is not valid",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "ALTERNATIVE_ID_INVALID",
"message": "The alternative identifier is not valid",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
The alternative identifier is not valid
El identificador alternativo no es válido
L''identificador alternatiu no és vàlid
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_REQUIRES_SPAIN
Type NOT_REGISTERED (07) is only valid for Spain; received country: ''{0}''
ALTERNATIVE_ID_SPAIN_INVALID_TYPE
For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed
BULK_VALIDATION_ERROR
One or more customers in the batch are invalid; none were created
CITY_EMPTY
City cannot be empty