# Comprobar NIF-IVA en el 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.

- Página: https://herramient.as/comprobar-vies
- 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-vies.

## 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/vies/check`

Comprueba si un NIF-IVA de la UE está dado de alta en el VIES

Consulta el VIES de la Comisión Europea. Antes de llamarlo se comprueba el formato del país, y si no cuadra se contesta format_error sin consultar. Una caída del VIES o del país nunca se devuelve como invalid: llega con 503 y un status propio, y no consume cuota. Los resultados valid e invalid se guardan una hora.

Consume 5 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `vat_number` | string | sí | NIF-IVA, con o sin el prefijo de país. Se admiten espacios, puntos y guiones (Ejemplo: `IE6388047V`) |
| `country` | string | no | Código de país del VIES (EL para Grecia, XI para Irlanda del Norte). Opcional si vat_number lleva prefijo (Ejemplo: `IE`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `status` | string | Resultado de la consulta |
| `country` | string | Código de país usado en la consulta |
| `vat_number` | string | Número normalizado, sin prefijo |
| `name` | string | Nombre que publica el VIES, o null si el país no lo da |
| `address` | string | Dirección que publica el VIES, o null si el país no la da |
| `checked_at` | string | Fecha y hora de la consulta según el VIES |
| `request_identifier` | string | Número de consulta del VIES, o null si no lo hay |
| `cached` | boolean | Si el resultado viene de una consulta de la última hora |
| `converted_from` | string | Si lo enviado no era el NIF-IVA pero se deduce de ello (un SIREN francés, un número sueco sin el 01, un número belga de 9 cifras, uno austríaco sin la U, un número fiscal húngaro completo), lo que se envió. vat_number es entonces el NIF-IVA consultado. Si no, null |
| `conversion` | string | Qué conversión se aplicó, o null |
| `message` | string | Mensaje legible del resultado |

**Errores**

- `400`: El NIF-IVA está vacío
- `503`: El VIES o el servicio del país no responden; status dice cuál. Reintenta en unos minutos

```bash
curl -X POST https://herramient.as/api/v1/tools/vies/check \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"IE6388047V","country":"IE"}'
```

## Preguntas frecuentes

### ¿Qué es el VIES?

Es el sistema de la Comisión Europea que dice si un NIF-IVA de la UE está dado de alta para operaciones intracomunitarias. No es un registro aparte: consulta en directo la base de datos de Hacienda de cada país. Por eso, si el servicio de un país se cae, el VIES no puede contestar por ese país.

### ¿Por qué el VIES dice que no está disponible?

Porque el servicio de ese país no responde, o porque hay demasiadas consultas a la vez. Pasa a menudo: Alemania, por ejemplo, para cada noche por mantenimiento. No significa que el número no sea válido. Prueba en unos minutos y, si sigue igual, más tarde.

### ¿Por qué no sale el nombre de la empresa?

Algunos países, como Alemania o España, no publican el nombre ni la dirección en el VIES. El número puede ser válido igualmente. En ese caso, confirma con tu cliente que el NIF-IVA es el suyo antes de facturar.

### ¿Qué hago si mi cliente no figura en el VIES?

Pídele que revise el número y que confirme que está dado de alta para operaciones intracomunitarias. Mientras no figure, lo prudente es facturar con IVA español y consultarlo con tu gestor.

### ¿Qué pongo en la factura?

Su NIF-IVA con el prefijo del país y la mención «Inversión del sujeto pasivo», sin IVA español, si la operación es entre empresas. Es información general: si tienes dudas sobre tu caso, consúltalo con tu gestor.

### ¿Tengo que guardar el justificante?

Es muy recomendable. Si Hacienda te pregunta por qué no cobraste IVA, poder enseñar que el NIF-IVA de tu cliente figuraba en el VIES el día de la factura es tu mejor prueba. Imprime el resultado o guárdalo en PDF, con su fecha y hora.

## Herramientas relacionadas

- [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 NIF y NIF-IVA en lote](https://herramient.as/comprobar-nif-masivo): 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.
- [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.