# Comprobar NIF y NIF-IVA en lote

Pega o sube la lista de NIF de tus clientes, españoles o de la UE, y comprueba todos de una vez: la letra de control de los españoles y el VIES de los demás.

- Página: https://herramient.as/comprobar-nif-masivo
- Categoría: Validación
- Dónde se ejecuta: en nuestro servidor

Es una herramienta interactiva: se usa desde el navegador en https://herramient.as/comprobar-nif-masivo.

## Uso por API

También se puede usar por API REST, con una clave en la cabecera `Authorization: Bearer htas_...`. Referencia completa: https://herramient.as/api-docs.md

### `POST /api/v1/tools/nif/batch`

Comprueba una lista de NIF españoles y NIF-IVA de la UE

Hasta 100 números por petición, uno por línea o en una lista. Los NIF españoles (DNI, NIE, CIF, con o sin ES delante) se comprueban por su carácter de control; los NIF-IVA de otros países, que tienen que llevar el prefijo, en el VIES, igual que en POST /api/v1/tools/vies/check. Contesta 202 con un trabajo: sigue su estado con GET /api/v1/jobs/{id}, y las filas aparecen en result.items según se comprueban. Cada línea consume lo mismo que su comprobación suelta: 5 unidades una de la UE y 1 una española. El resultado se borra a la hora.

No consume cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `numbers` | string | sí | Los números, uno por línea. También se acepta una lista. Si una línea tiene varias columnas separadas por ; , o tabulador, se usa la primera que parezca un NIF (Ejemplo: `B12345674
IE6388047V
FR32521724336`) |
| `webhook_url` | string | no | URL a la que avisar al terminar, como en POST /api/v1/jobs |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `id` | string | Identificador del trabajo, para GET /api/v1/jobs/{id} |
| `operation` | string | nif.batch |
| `status` | string | queued al crearse |
| `progress` | integer | 0 al crearse |
| `total` | integer | Cuántos números se van a comprobar |
| `expires_at` | string | Cuándo se borra el resultado |

**Errores**

- `400`: La lista está vacía o tiene más de 100 números
- `402`: La lista no cabe en lo que queda de la cuota del periodo

```bash
curl -X POST https://herramient.as/api/v1/tools/nif/batch \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"numbers":"B12345674\nIE6388047V\nFR32521724336"}'
```

## Preguntas frecuentes

### ¿Cuántos NIF puedo comprobar a la vez?

Gratis, 3 por lista. Si necesitas comprobar listas más grandes, pega la lista igualmente: la herramienta te pide un email y te contamos cómo. Si quieres comprobarlos desde tu propio programa, la misma comprobación está en la API, con tu propia cuota.

### ¿Qué comprobáis de un NIF español?

Que la letra o el dígito de control cuadra con el resto del número, que es lo que descubre casi todos los errores al copiarlo. No dice si el NIF existe en Hacienda ni a quién pertenece: para eso está la comprobación de NIF de terceros de la sede de la Agencia Tributaria, con certificado digital, DNI electrónico o Cl@ve, que también admite un fichero.

### ¿Por qué los NIF de otros países necesitan el prefijo?

Porque en una lista es lo único que dice de qué país es cada número, y muchos formatos se parecen: un número de nueve cifras puede ser alemán, griego o portugués. Escribe el NIF-IVA completo, como FR32521724336 o DE811569869. Para Grecia, el prefijo es EL.

### ¿Qué pasa si el VIES no responde para algunos números?

Salen marcados como «sin respuesta», no como no válidos, porque una caída del VIES no dice nada del número. Si el servicio de un país se cae a mitad de la lista, dejamos de preguntarle para que el resto no espere. Puedes volver a comprobar solo esos con un botón, unos minutos después.

### ¿Guardáis mi lista de clientes?

Lo justo para comprobarla. Si cargas un fichero, se lee en tu navegador y solo nos llegan los números. El resultado se borra de nuestros servidores una hora después de comprobarlo, y los números no se guardan en los registros. Descarga el CSV si quieres conservarlo.

### ¿Puedo cargar un Excel?

Guárdalo como CSV desde Excel o Google Sheets y cárgalo. Si tiene varias columnas, como el nombre del cliente y su NIF, usamos en cada fila la primera que parezca un NIF, y nos saltamos las filas sin cifras, como la cabecera.

## Herramientas relacionadas

- [Comprobar NIF-IVA en el VIES](https://herramient.as/comprobar-vies): Comprueba si el NIF-IVA de un cliente de otro país de la UE está dado de alta en el VIES antes de facturarle sin IVA, y guarda el resultado con su fecha.
- [Comprobar CIF de empresa](https://herramient.as/comprobar-cif): Comprueba si el CIF de una empresa es válido y descubre qué tipo de entidad es. Validamos el carácter de control con el algoritmo oficial.
- [Comprobar DNI, NIF y NIE](https://herramient.as/dni-nif-validator): Comprueba si un DNI, NIF o NIE es válido al instante. Validamos la letra de control con el algoritmo oficial.
- [Validador de IBAN](https://herramient.as/iban): Valida números de cuenta bancaria IBAN españoles y de los 38 países SEPA. Verifica formato y dígito de control.