# ALTERNATIVE_ID_SPAIN_INVALID_TYPE

For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed

<Callout type="info">
**Category:** [Customers](/errors/category/cliente)
</Callout>

| | |
|---|---|
| HTTP status | `422` Unprocessable Content |

## Rules that cite this code

- [CNT-021 · A recipient without a Spanish NIF is identified by an alternative id](/rules/contents#cnt-021)

## Example response

When this error occurs, the API answers `422` Unprocessable Content with a JSON body of this shape:

```json
{
  "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

<Tabs items={["English", "Spanish", "Catalan"]}>
  <Tab value="English">{"For customers with country ES only types PASSPORT (03) or NOT_REGISTERED (07) are allowed"}</Tab>
  <Tab value="Spanish">{"Para clientes con país ES solo se permiten los tipos PASAPORTE (03) o NO_CENSADO (07)"}</Tab>
  <Tab value="Catalan">{"Per a clients amb país ES només es permeten els tipus PASSAPORT (03) o NO_CENSAT (07)"}</Tab>
</Tabs>

Send the request with `Accept-Language: <es|en|ca>` to receive the message in your preferred language.

## Other errors in this category

<div className="grid grid-cols-2 gap-3 not-prose">
  <Card title="ALTERNATIVE_ID_AND_NIF_EXCLUSIVE" description="The customer cannot carry both a NIF and an alternative identifier. Use only one" href="/errors/ALTERNATIVE_ID_AND_NIF_EXCLUSIVE" />
  <Card title="ALTERNATIVE_ID_COUNTRY_REQUIRED" description="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." href="/errors/ALTERNATIVE_ID_COUNTRY_REQUIRED" />
  <Card title="ALTERNATIVE_ID_INVALID" description="The alternative identifier is not valid" href="/errors/ALTERNATIVE_ID_INVALID" />
  <Card title="ALTERNATIVE_ID_REQUIRES_SPAIN" description="Type NOT_REGISTERED (07) is only valid for Spain; received country: '‹value›'" href="/errors/ALTERNATIVE_ID_REQUIRES_SPAIN" />
  <Card title="ALTERNATIVE_ID_VAT_INVALID_FORMAT" description="'‹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" href="/errors/ALTERNATIVE_ID_VAT_INVALID_FORMAT" />
</div>

## Keep exploring

<div className="grid grid-cols-2 gap-3 not-prose">
  <Card title="All Customers errors" description="Every code in this category in one table." href="/errors/category/cliente" />
  <Card title="Error reference home" description="Browse every category or jump to the handling guide." href="/errors" />
</div>

---

Full OpenAPI spec: https://docs.beel.es/api/openapi