Validación AEAT y europea (VIES) de un contacto
Para emitir facturas válidas en España, los datos fiscales de tu cliente (NIF y nombre) tienen que coincidir con los que constan en la Agencia Tributaria. Si no, la factura puede ser rechazada (especialmente con VeriFactu activo, donde el envío a la AEAT exige que el cliente esté identificado).
FacturaDirecta verifica los identificadores fiscales contra dos servicios oficiales:
AEAT (Agencia Tributaria española) — para contactos con NIF / NIE / CIF español.
VIES (sistema de validación de IVA intracomunitario de la Comisión Europea) — para contactos con VAT EU de otros países de la UE.
Las dos validaciones pasan automáticamente al introducir o editar el identificador fiscal de un contacto. Este artículo explica qué estados puede dar la validación, qué avisos muestra FacturaDirecta y cómo resolverlos.
Cuándo se ejecuta la validación
La validación se dispara:
Al perder el foco del campo identificador fiscal en el formulario del contacto (cuando terminas de escribir el NIF y haces clic fuera).
Al cambiar el país o el tipo de identificación.
Al abrir un contacto existente en modo lectura, si tiene estado AEAT desactualizado.
Manualmente desde la página de detalle o desde el botón Corregir del banner de avisos.
Validación AEAT (contactos ES)
Aplica cuando el contacto tiene país ES y tipo de identificación NIF (fiscalIdType === "NIF" o inferido). FacturaDirecta consulta la AEAT y devuelve uno de estos estados:
Estado AEAT | Significado | Aviso que verás |
Identificado, coincidente | NIF + nombre coinciden con lo que tiene la AEAT. Todo OK. | (sin aviso; chip verde NIF válido AEAT: Sí en el listado si VeriFactu está activo) |
Identificado, nombre similar | NIF correcto, pero el nombre tiene diferencias menores (acentos, mayúsculas, espacios). | El NIF indicado se ha verificado correctamente en la AEAT pero el nombre contiene errores, el valor identificado en la AEAT es "X" |
Identificado, nombre con muchas diferencias | NIF correcto pero el nombre es claramente otro o muy distinto. | El NIF indicado tiene un nombre identificado en la AEAT "X" con demasiadas diferencias respecto al indicado: "Y" |
No identificado | La AEAT no reconoce el par NIF + nombre. | El NIF y/o nombre no coinciden con los datos de la AEAT |
Dado de baja | El NIF existió pero está dado de baja en censo. | El NIF indicado consta como dado de baja en la AEAT |
Revocado | El NIF está revocado (sancionado / inactivo). | El NIF indicado consta como revocado en la AEAT |
El banner aparece en la sección de datos básicos del contacto, debajo del campo de identificador fiscal, en modo lectura.
El botón Corregir
Cuando el estado es "identificado con diferencias" o "no identificado", el banner ofrece un botón Corregir que abre un sub-diálogo:
Corrección del NIF
Hemos detectado una diferencia en el nombre del contacto. ¿Qué deseas hacer?
Si la AEAT devuelve un nombre concreto, el diálogo muestra una comparativa lado a lado:
Nombre según la AEAT: el nombre oficial.
Nombre actual en FacturaDirecta: el que tú tienes.
Bajo el título Selecciona una opción, dos radios:
Asignar el nombre de la AEAT a mi contacto (recomendado en la mayoría de casos: tu base se sincroniza con la oficial y evitas problemas en envíos VeriFactu / TicketBAI).
Marcar como válido el nombre actual (úsalo solo si sabes que la AEAT está desactualizada en este caso concreto, por ejemplo tras un cambio reciente de razón social que aún no se haya propagado).
Pulsa Corregir para aplicar la elección, Cancelar para volver atrás.
Validación VIES (contactos UE intracomunitarios)
Aplica cuando el contacto tiene tipo de identificación VAT EU (fiscalIdType === "02"). La validación contra VIES verifica que el número de IVA europeo está activo en su país de origen.
El control de validación VIES vive integrado en el campo del identificador fiscal:
Indicador en línea — al introducir un VAT EU se dispara la validación automáticamente al perder el foco. Mientras espera respuesta del servicio VIES (puede tardar unos segundos), el campo muestra un indicador de carga.
Acción manual — un botón / icono junto al campo permite forzar la validación a demanda.
Resultado — el campo muestra el estado (válido / inválido) con la fecha y hora del último check (formato configurable en los ajustes de localización).
Cuando el contacto tiene un VAT EU validado correctamente, FacturaDirecta puede aplicar correctamente la exención de IVA intracomunitaria en facturas. Sin validación, ese tratamiento fiscal no se aplica de forma fiable.
Vista del estado en el listado
En el listado de Contactos (/company/<id>/contacts), cuando tu empresa tiene VeriFactu activo en Ajustes, aparece una columna extra NIF válido AEAT con valores Sí / No que refleja el estado oficial AEAT del NIF del contacto.
Esta columna es la base de un filtro útil:
Filtro "No verificado AEAT" — añade un filtro a la columna "NIF válido AEAT" con valor "No". Te muestra solo los contactos cuyo NIF aún no está confirmado por la AEAT.
Si VeriFactu no está activo, la columna no aparece — la identificación AEAT es opcional fuera del régimen VeriFactu.
Auditoría masiva: el wizard VeriFactu
Cuando completas el asistente VeriFactu (cubierto en Activar VeriFactu), uno de sus pasos es precisamente la revisión de contactos no identificados:
Clientes no identificados
La Agencia Tributaria no puede identificar a algunos clientes. Corrige su NIF y/o nombre para completar la validación.
El paso lista los clientes problemáticos directamente; pulsa cada uno para abrir su ficha y corregir desde el banner ContactWarnings, igual que descrito arriba.
Si todos están limpios, el asistente confirma:
Todos tus clientes están identificados y listos para VeriFactu. Puedes continuar.
Es un buen momento para hacer la limpieza masiva de la agenda antes de activar VeriFactu, así no hay sorpresas con facturas rechazadas más adelante.
Aviso de datos desactualizados en documentos
Cuando estás creando un documento de venta y los datos del contacto que has seleccionado difieren de la versión más reciente verificada por la AEAT, FacturaDirecta muestra un alert dentro del propio documento:
Los datos del contacto están desactualizados — con botón Revisar cambios.
Al pulsar se abre un diálogo de comparativa campo a campo entre lo que tienes guardado y lo que la AEAT devuelve:
Nombre.
Identificador fiscal.
Dirección principal — calle, ciudad, país.
País.
Para cada diferencia: dos columnas etiquetadas Datos actuales y Datos del contacto (los nuevos). Botones Cancelar (mantén los datos actuales) o Actualizar (aplica los datos AEAT al contacto).
Es una segunda línea de defensa cuando un cliente cambia razón social o domicilio fiscal sin avisarte: FacturaDirecta lo detecta al ir a emitir y te da la oportunidad de actualizar antes de generar la factura.
Casos especiales
Contactos sin NIF (extranjeros no-UE)
Si el contacto está en un país fuera de la UE (USA, México, etc.), no tiene ni NIF ES ni VAT EU. FacturaDirecta no valida estos identificadores contra ningún servicio (no hay equivalente universal). En estos casos, el campo se considera identificación libre y solo se valida formato si tiene patrón conocido.
Para facturar a estos contactos, la posición fiscal del documento se trata como exportación / fuera de la UE, sin necesidad de validación previa.
Particular (persona física sin NIF profesional)
Si el contacto es un particular sin actividad económica (consumidor final), su NIF puede ser un DNI normal. La validación AEAT funciona igual: comprueba que el DNI sea válido y exista en el censo de personas físicas.
En el formulario, el bloque Perfil de cliente del panel Datos básicos permite marcarlo explícitamente como Particular vs Prof./Empresa cuando aplica (autónomos ES, casos intracomunitarios). El marcador cambia el tratamiento fiscal pero no la validación del identificador.
Fallo del servicio AEAT / VIES
Si el servicio AEAT o VIES está caído, la validación devuelve un estado pendiente (no es ni "OK" ni "rechazado"). FacturaDirecta no bloquea — guarda el contacto con los datos que has introducido y reintenta la validación más tarde. Si tienes VeriFactu activo y el estado queda pendiente, la columna NIF válido AEAT del listado lo mostrará y el wizard VeriFactu lo marcará como pendiente de identificar.
Recomendaciones
Valida en alta: cuando creas un contacto nuevo, espera a que la validación AEAT / VIES termine antes de cerrar el diálogo. Si hay aviso, corrige en ese momento — es más rápido que descubrirlo después en una factura.
Antes de activar VeriFactu: ejecuta el wizard, que detecta todos los pendientes de identificar. Cada cliente que aparezca ahí dará problemas al emitir factura una vez VeriFactu esté activo.
Si la AEAT devuelve un nombre distinto al tuyo: 9 de cada 10 veces, la AEAT tiene razón (es el nombre fiscal oficial registrado). Asigna el nombre AEAT al contacto. La excepción son cambios recientes de razón social aún no propagados al censo público.
Para VAT EU: tras validar contra VIES, comprueba la fecha de la última validación. VIES recomienda revalidar antes de cada emisión intracomunitaria si la última validación es antigua (más de 3 meses). FacturaDirecta no fuerza re-validación automática constante pero el campo muestra la fecha del último check.
Recursos relacionados
Crear o editar un contacto — donde introduces y validas el identificador fiscal por primera vez.
Trabajar con el listado de contactos — para usar el filtro "NIF válido AEAT" y detectar pendientes en masa.
Página de detalle del contacto — para revisar y corregir contactos individuales.
Activar VeriFactu — el wizard guía la limpieza masiva de contactos antes de activar VeriFactu (paso "Clientes no identificados").