## Validar NIF en la AEAT

`POST`  https://{entorno}.ticketbaiws.eus/validar-nif/

Permite validar un nif con el censo de la AEAT. Verifactu exige que las facturas para una persona física se emitan con los datos (nombre + apellido + NIF) correctos. Para personas jurídicas con indicar el NIF es suficiente.

### Parámetros

- `nif` (string, obligatorio): NIF a validar. Ejemplo: `12345678Z`
- `nombre` (string, obligatorio únicamente para personas físicas): Nombre + apellido para persona física, opcional para personas jurídicas. Ejemplo: `Juan Martínez`

En el caso de personas físicas, existen estos resultados:

**IDENTIFICADO:**  Si el contribuyente se identifica con los datos identificativos aportados. Se devuelven los datos de apellidos y nombre asociados al NIF.
**NO IDENTIFICADO-SIMILAR:**  Si el contribuyente no se identifica con los datos identificativos aportados por diferencias menores en los apellidos y nombre. Se devuelven los datos de apellidos y nombre asociados al NIF.
**NO IDENTIFICADO:**  Si el contribuyente no se identifica con los datos identificativos aportados.

En el caso de entidades, no existe el resultado “No Identificado-Similar” pero se añaden estos dos resultados:

**IDENTIFICADO-BAJA:**  Si el contribuyente se identifica con el NIF aportado y está en estado baja. Se devuelve el NIF actual y su razón social.
**IDENTIFICADO-REVOCADO:**  Si el contribuyente se identifica con el NIF aportado y está en estado baja por revocación del NIF. Se devuelve el NIF actual y su razón social.

**POST** `https://api.ticketbaiws.eus/validar-nif/`

```bash
$ curl --request POST \
     --url https://api.ticketbaiws.eus/validar-nif/ \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'Token: xxx' \
     --header 'Nif: 00000014Z'
	 --data '
{
    "nif": "12345678Z",
    "nombre": "Juan Martínez"
}'
```

Respuesta:

```json
HTTP/1.1 200 OK
{
    "result": "OK",
    "return": {
        "nif": "12345678Z",
        "nombre": "MARTINEZ RODRIGUEZ JUAN",
        "resultado": "IDENTIFICADO"
    },
    "msg": ""
}
```

Fuente: https://ticketbaiws.eus/es/validar-nif-post/