• Cómo configurar y usar ValidaNIF

Cómo configurar y usar ValidaNIF

ValidaNIF permite validar NIF/CIF de clientes y proveedores desde FacturaScripts utilizando el servicio oficial de calidad de datos identificativos de la AEAT.

Requisitos

Para utilizar el plugin necesitas:

• FacturaScripts 2026 o superior.
• PHP 8.1 o superior.
• Extensiones PHP SOAP, OpenSSL y DOM/XML.
• Un certificado digital válido para realizar consultas al servicio de AEAT.
• Acceso desde el servidor a los servicios web de AEAT.

Instalación

1. Descarga el plugin desde la ficha de ValidaNIF.
2. Entra en tu instalación de FacturaScripts.
3. Ve a Administrador > Plugins.
4. Sube e instala el archivo ZIP del plugin.
5. Activa el plugin.
6. Entra en Administrador > ValidaNIF para realizar la configuración.

Configuración del certificado

Para que el plugin pueda consultar el servicio de AEAT es necesario configurar un certificado digital.

1. Entra en Administrador > ValidaNIF.
2. Sube tu certificado digital en formato .p12 o .pfx.
3. Introduce la contraseña del certificado, si la tiene.
4. Guarda la configuración.
5. Revisa que los requisitos del servidor aparezcan como correctos.

El certificado se utiliza para autenticar la conexión con AEAT. Si el certificado no es válido, está caducado o la contraseña no es correcta, la validación no podrá realizarse.

Prueba de conexión

Desde la pantalla de configuración puedes realizar una prueba manual indicando un NIF/CIF y un nombre o razón social.

Esta prueba sirve para comprobar que:

• El certificado se ha cargado correctamente.
• El servidor tiene las extensiones PHP necesarias.
• La conexión con AEAT funciona.
• El servicio devuelve una respuesta válida.

Validar un cliente

1. Entra en Ventas > Clientes.
2. Abre la ficha de un cliente ya guardado.
3. Comprueba que el campo NIF/CIF y el nombre o razón social estén informados.
4. Pulsa el botón Validar NIF.
5. Revisa el resultado devuelto por AEAT.

El botón de validación se muestra cuando el cliente ya está guardado. No aparece durante la creación inicial del cliente al no existir todavía el registro.

Validar un proveedor

1. Entra en Compras > Proveedores.
2. Abre la ficha de un proveedor ya guardado.
3. Comprueba que el campo NIF/CIF y el nombre o razón social estén informados.
4. Pulsa el botón Validar NIF.
5. Revisa el resultado devuelto por AEAT.

Al igual que en clientes, el botón solo aparece cuando el proveedor ya existe.

Resultado de la validación

El plugin puede mostrar principalmente estos resultados:

IDENTIFICADO

AEAT ha encontrado coincidencia entre el NIF/CIF y los datos identificativos enviados.

Cuando la validación es correcta, el plugin puede mostrar también la razón social censal devuelta por AEAT.

NO IDENTIFICADO

AEAT no reconoce la combinación de NIF/CIF y nombre o razón social enviada.

En este caso conviene revisar:

• Que el NIF/CIF esté bien escrito.
• Que no haya espacios, guiones o caracteres incorrectos.
• En personas físicas, que el nombre y apellidos estén escritos de forma suficientemente parecida a los datos registrados en AEAT.

Empresas y personas físicas

En empresas, normalmente basta con indicar correctamente el NIF/CIF para que AEAT devuelva la identificación censal.

En personas físicas o autónomos, la validación depende más de la coincidencia entre NIF/DNI y nombre completo. Si el nombre o los apellidos no coinciden suficientemente con los datos censales, AEAT puede devolver un resultado NO IDENTIFICADO aunque el NIF sea correcto.

Problemas frecuentes

No aparece el botón Validar NIF

Comprueba que estás editando un cliente o proveedor ya guardado. El botón no se muestra durante la creación inicial del registro.

También revisa que el campo NIF/CIF esté informado.

Error de certificado

Comprueba que el certificado sea válido, que no esté caducado y que la contraseña introducida sea correcta.

Error de conexión

Comprueba que el servidor tenga conexión saliente hacia AEAT y que estén instaladas las extensiones PHP necesarias: SOAP, OpenSSL y DOM/XML.

Resultado NO IDENTIFICADO

Revisa el NIF/CIF y el nombre o razón social. En personas físicas puede ser necesario ajustar el nombre y apellidos para que coincidan con los datos censales.

Importante

ValidaNIF no modifica automáticamente los datos del cliente o proveedor. La validación se realiza bajo demanda y el resultado se muestra para que el usuario pueda revisar la información antes de emitir documentos o realizar gestiones fiscales.

La información devuelta por AEAT depende de los datos disponibles en el momento de la consulta y puede cambiar si posteriormente se modifican los datos censales del contribuyente.