Validación IVA Intracomunitario VIES e Inversión del Sujeto Pasivo B2B
Instalar y configurar la verificación VIES, la inversión del sujeto pasivo automática y el registro de pruebas inalterable.
Este módulo verifica los números de IVA intracomunitario en la base de datos VIES de la Comisión Europea, aplica automáticamente la inversión del sujeto pasivo (factura al 0 % de IVA) para sus clientes profesionales establecidos en otro país de la UE y conserva un registro de pruebas con marca de tiempo — el documento que la administración tributaria solicita en una inspección.
El ajuste más importante es su propio número de IVA: sin él, VIES no emite un número de consulta oficial, que es la prueba más sólida durante una inspección.
Requisitos
- PrestaShop 8.0 a 9.x, en una o varias tiendas.
- PHP 7.4 a 8.3. Se recomienda la extensión SOAP; en su defecto, el módulo recurre automáticamente a la API REST de VIES.
- Acceso saliente HTTPS a
ec.europa.eudesde su servidor.
Instalación
- En el back-office, vaya a Módulos > Gestor de módulos > Subir un módulo.
- Seleccione el archivo ZIP del módulo e inicie la instalación.
- Haga clic en Configurar una vez finalizada la instalación.
La instalación crea la tabla del registro de consultas y una pestaña Registro VIES en el menú Pedidos.
Configuración
Su número de IVA de comerciante
Indique el número de IVA de su empresa en el campo previsto. En cuanto está presente, cada comprobación consulta VIES con un identificador de solicitante: la base devuelve entonces un número de consulta oficial con marca de tiempo, oponible a la administración. Es el ajuste más importante de la página.
País de establecimiento
Indique el país desde el que factura. La inversión del sujeto pasivo solo se aplica a clientes establecidos en otro país de la UE: un pedido a su propio país tributa normalmente.
Activar la exención (inversión del sujeto pasivo)
Activa o desactiva el paso automático al 0 % de IVA. Desactivada, la comprobación y el registro siguen funcionando, pero el impuesto nunca se modifica — útil para una fase de observación.
Comprobación en tiempo real
Activa el distintivo de validación instantáneo en el formulario de dirección y, si lo activa, en el campo de registro. La comprobación se dispara al escribir, con un breve retardo antirrebote.
Comportamiento si VIES no está disponible
Dos opciones:
- Aceptar (por defecto): el pedido continúa sin aplicar la exención. Es la opción más prudente comercialmente — no pierde la venta.
- Bloquear: la validación falla hasta que VIES confirme el número.
En ambos casos, la indisponibilidad se registra y puede volver a comprobarse más tarde mediante el cron.
Ventanas de validez, caché y revalidación
- Validez: tiempo durante el cual una prueba válida en el registro permite la exención sin una nueva llamada.
- Caché: tiempo durante el cual se reutiliza una comprobación reciente en lugar de volver a llamar a VIES.
- Revalidación: antigüedad a partir de la cual el cron vuelve a comprobar un número.
Grupo de clientes B2B (opcional)
Si elige un grupo, todo cliente cuyo número de IVA se valide se añade automáticamente a él — práctico para aplicar tarifas o reglas B2B.
Texto de la mención legal en la factura
La mención de inversión del sujeto pasivo impresa en las facturas al 0 % es personalizable en los cinco idiomas. Puede usar las variables %vat% (número de IVA del cliente), %date% (fecha de verificación), %consultation% (número de consulta) y %name% (razón social).
La comprobación del lado del cliente
Cuando un cliente introduce su número de IVA en el checkout o el registro, aparece un distintivo: válido (con la razón social devuelta por VIES), no válido, formato incorrecto o VIES no disponible. Si el número es válido y el cliente está establecido en otro país de la UE, su pedido se factura sin impuestos.
El registro de pruebas
Cada consulta se registra en Pedidos > Registro VIES: fecha y hora, país, número de IVA, resultado, razón social, número de consulta oficial, canal (dirección, registro, pedido, cron, manual) y dirección IP.
El registro es de solo lectura: no es posible eliminar nada, y la tabla se conserva incluso tras desinstalar el módulo. Una pista de auditoría solo tiene valor si es inalterable.
Al validar un pedido, se registra una instantánea de prueba vinculada al número de pedido, lo que enlaza cada factura sin impuestos con su prueba. El panel VIES en la ficha del pedido muestra este estado de un vistazo.
Exportación CSV
Desde la pantalla del registro, el botón de exportación genera un archivo CSV de todas las consultas, listo para entregar a su asesor o a la administración.
Revalidación automática (cron)
La página de configuración muestra una URL de cron protegida por un token. Llámela una vez al día para volver a comprobar los números de IVA cuya última consulta se va quedando antigua. Cada ejecución procesa hasta 25 números.
Ejemplo de entrada crontab:
0 4 * * * curl -s "https://su-tienda/index.php?fc=module&module=dfviesb2b&controller=cron&token=SU_TOKEN" > /dev/null
La mención legal en la factura
La mención de inversión del sujeto pasivo se imprime automáticamente en la factura PDF, en el idioma del cliente, solo cuando la factura se emite realmente al 0 % de IVA y existe una prueba válida en el registro. No se añade ninguna mención en una factura tributada normalmente.
Resolución de problemas
No aparece ningún número de consulta
Compruebe que su número de IVA de comerciante está indicado: sin él, VIES responde pero no emite un número de consulta oficial.
El distintivo permanece en «VIES no disponible»
El servicio VIES sufre interrupciones periódicas del lado de la Comisión Europea. Compruebe también que su servidor puede alcanzar ec.europa.eu por HTTPS. El cron recuperará los números no verificados.
La exención no se aplica
Asegúrese de que el cliente está establecido en un país de la UE distinto del suyo, de que su número es válido y reciente en el registro, y de que la exención está activada en la configuración.
Este módulo automatiza la verificación, la exención y la constitución de pruebas. No sustituye a su asesor fiscal: usted sigue siendo responsable de sus obligaciones fiscales.