VERI*FACTU - Facturación Electrónica España (Real Decreto 1007/2023)

VERI*FACTU para Dolibarr — Facturación Electrónica conforme al Real Decreto 1007/2023

VERI*FACTU es el módulo profesional para Dolibarr que implementa el sistema de verificación y validación de facturas exigido por la normativa fiscal española. Cumple íntegramente con el Real Decreto 1007/2023 sobre Sistemas Informáticos de Facturación (SIF), permitiendo el envío telemático de facturas a la Agencia Tributaria (AEAT), la generación automática de códigos QR, la firma digital con certificado y la trazabilidad fiscal completa de cada factura emitida.

Diseñado por EasySoft Tech S.L., productor de software registrado conforme a la normativa antifraude, el módulo garantiza que tu empresa cumple con todas las obligaciones legales de facturación electrónica en España, ya seas sociedad (obligatorio desde el 1 de enero de 2027) o autónomo (obligatorio desde el 1 de julio de 2027).

⚖️ ¿Qué es VERI*FACTU y por qué lo necesitas?

El sistema VERI*FACTU, establecido por el Real Decreto 1007/2023, obliga a todos los empresarios y profesionales españoles a utilizar Sistemas Informáticos de Facturación (SIF) que garanticen la integridad, conservación, accesibilidad, legibilidad, trazabilidad e inalterabilidad de los registros de facturación. Este módulo convierte tu Dolibarr en un SIF homologado que envía automáticamente cada factura a la AEAT en el momento de su validación.

📋 Tabla de Funcionalidades

🚀 Envío Automático a la AEAT

Al validar una factura en Dolibarr, el módulo intercepta el proceso mediante triggers y:

1. 📋 Valida los datos fiscales: NIF/CIF del emisor y receptor, tipo de factura, clave de régimen, calificación de la operación e impuestos aplicados.
2. 🔏 Genera la firma digital: Construye el XML SOAP firmado con tu certificado digital (FNMT, AEAT o compatible).
3. 🔗 Encadena con la factura anterior: Calcula el hash SHA-256 encadenado para garantizar trazabilidad e inalterabilidad.
4. 📡 Envía a la AEAT: Transmisión SOAP segura (TLS) al servicio web de la Agencia Tributaria (entorno de pruebas o producción).
5. 📥 Procesa la respuesta: Almacena el estado (Correcto, Parcialmente Correcto, Incorrecto), el CSV de respuesta y los detalles del envío.
6. 📊 Genera el código QR: QR conforme a especificación AEAT con URL de verificación, NIF emisor, número de factura e importe total.

Todo el proceso es transparente para el usuario: basta con validar la factura como siempre y VERI*FACTU se encarga del resto.

📱 Código QR en Facturas PDF y ODT

• ✅ Generación automática: El código QR se genera al enviar la factura a la AEAT, sin intervención del usuario.
• ✅ 3 tamaños disponibles: 30mm, 35mm y 40mm, conforme a la especificación oficial AEAT (entre 30-40mm).
• ✅ Posición configurable: Posición X e Y personalizable en el documento, o posiciones predefinidas (izquierda, centro, derecha).
• ✅ Compatible con CUALQUIER plantilla PDF: El QR se inyecta automáticamente en todas las plantillas PDF de Dolibarr (no solo la propia), gracias al hook afterPDFCreation. También compatible con ODT.
• ✅ Texto verificable debajo del QR: URL de verificación visible opcionalmente para validación manual.
• ✅ Soporte TakePos (TPV): Código QR también en tickets de punto de venta.
• ✅ Imagen transparente en borradores: Las facturas sin enviar no muestran placeholders, sino un espacio limpio.

🔐 Certificado Digital y Firma

• ✅ Certificados PKCS#12: Soporte completo para archivos .pfx y .p12 (FNMT, AEAT, entidades certificadoras).
• ✅ Extracción automática: El módulo extrae clave privada y certificado público automáticamente.
• ✅ Método nativo PHP: Usa openssl_pkcs12_read() como método principal, con fallback a OpenSSL externo.
• ✅ Compatible sin exec(): Funciona en servidores con exec() deshabilitado (hosting compartido).
• ✅ Campos protegidos: Contraseñas y claves privadas enmascaradas con toggle mostrar/ocultar.
• ✅ Servidor de certificados remoto: Opción de alojar el certificado en un servidor externo vía API segura (Cloudflare Tunnel).
• ✅ Verificación SSL habilitada: Comunicaciones con AEAT con verify_peer activo para prevenir ataques MITM.
• ✅ Almacenamiento cifrado: Las claves privadas se almacenan cifradas en base de datos con dolEncrypt()/dolDecrypt().
• ✅ Tarjeta visual de certificado: Selector con información detallada: sujeto, emisor, fechas de validez, cuenta atrás de expiración y componentes.
• ✅ Caché de certificados: Sistema de caché con opción de purga manual para optimizar rendimiento.
• ✅ Soporte multiplataforma: Compatible con Windows y Linux, detectando automáticamente las capacidades del sistema.

✅ Verificación NIF/CIF contra AEAT

• 🔍 Verificación individual y masiva: Consulta NIF/CIF contra el servicio VNifV2 de la AEAT.
• 🟢 Badge automático en ficha de tercero: Muestra estado de verificación al abrir la ficha del cliente/proveedor.
  • 🟢 Verde: NIF verificado y nombre correcto
  • 🟡 Amarillo: NIF válido pero nombre diferente en el censo
  • 🟠 Naranja: Entidad dada de baja
  • 🔴 Rojo: NIF revocado o no identificado
• 🔧 Botón "Corregir": Actualiza el nombre del tercero con el registrado en el censo AEAT.
• 📋 Modo masivo: Verifica múltiples NIF de una vez con formato NIF;Nombre.

🇪🇺 Verificación VIES y ROI (Intracomunitario)

• 🌍 VIES: Verificación de NIF-IVA intracomunitario contra el sistema VIES de la Comisión Europea (27 países UE).
• 🏭 ROI: Consulta al Registro de Operadores Intracomunitarios español (requiere certificado digital).
• 🔵 Badge automático VIES en terceros extranjeros: Verifica automáticamente tva_intra contra VIES.
• 📋 Modo individual y masivo: Interfaz unificada con pestañas estándar de Dolibarr.

📊 Facturas Simplificadas (TPV / TakePos)

• ✅ Integración nativa con TakePos: Las facturas generadas desde el TPV se envían automáticamente como facturas simplificadas (F2).
• ✅ Máscara de numeración específica: Serie independiente para facturas simplificadas.
• ✅ Clientes extranjeros: Facturas simplificadas sin necesidad de identificación del destinatario (conforme a normativa).
• ✅ Abonos de simplificadas: Detección automática del tipo de rectificativa (normal vs. simplificada) incluso en versiones antiguas de Dolibarr.
• ✅ Código QR en tickets: QR configurable para tickets de punto de venta.

🔄 Validación Masiva y Robustez

• 🛡️ Transacciones aisladas: Cada factura validada tiene su propio BEGIN/COMMIT/ROLLBACK. Si una falla, no afecta a las demás.
• 🔄 Cronjob de reintentos: Tarea programada que reenvía automáticamente facturas con errores de conexión.
• 🏭 Cronjob seguro para recurrentes: Sustituye la tarea estándar de Dolibarr con transacciones individuales por cada paso (crear, validar, PDF, triggers).
• 📋 Jerarquía de excepciones tipadas: AeatConnectionException, AeatResponseException, CertificateException, ValidationException con mensajes claros para el usuario.
• ⏱️ Timeouts y caché WSDL: Conexiones con timeout de 30s y caché WSDL en disco+memoria para evitar descargas redundantes.

� Sistema de Notificaciones y Alertas

• 🔔 Icono de campana en la barra superior: Indicador permanente en la barra de menú de Dolibarr con acceso directo al estado del módulo.
• 📢 Alertas push del servidor: Notificaciones en tiempo real con 3 niveles de prioridad (normal, alta, crítica), cada una con color diferenciado.
• 🆕 Notificación de actualizaciones disponibles: El módulo comprueba automáticamente si hay nuevas versiones y avisa al administrador.
• 🌡️ Indicador de entorno: Muestra claramente si estás en modo TEST o PRODUCCIÓN, con cuenta atrás hasta la fecha obligatoria.
• 📊 Versión del módulo visible: Tooltip con información de versión, entorno y enlaces directos a configuración.
• 🔗 Enlace directo a descarga: Los administradores pueden acceder a la descarga de actualizaciones desde la propia notificación.

📥 Actualizador Integrado del Módulo

• 🔄 Verificación de versión remota: Comprueba la última versión disponible contra el servidor de actualizaciones de EasySoft.
• 📥 Descarga directa desde Dolibarr: Descarga el paquete de actualización sin salir de la interfaz del ERP.
• 🔐 Verificación de integridad: Compara el hash del paquete descargado para garantizar que no ha sido alterado.
• 💾 Backup automático: Antes de aplicar la actualización, se crea una copia de seguridad automática del módulo actual.
• 📋 Gestión de archivos descargados: Vista con fecha, tamaño y acciones disponibles para cada descarga.
• ⚠️ Manejo de errores: Mensajes descriptivos para errores HTTP (200/400/403) durante la descarga.

📊 Dashboard / Panel de Control

• 🎨 Diseño moderno con tarjetas animadas: Panel principal con animaciones CSS (fadeInUp) y degradados profesionales.
• 📋 3 tarjetas de navegación principales: Facturas Emitidas, Consulta AEAT y FAQ, con acceso directo a cada sección.
• 🔑 Estado de la licencia: Visualización prominente del estado de activación con mensajes claros.
• 🔐 Estado del certificado digital: Información de validación del certificado con cuenta atrás de expiración.
• 🖥️ Estado del servidor de certificados: Indicador del servidor local/remoto de certificados.
• 📱 Diseño responsive: Grid layout adaptable a cualquier resolución de pantalla.

👻 Detector de Facturas Fantasma

• 🔍 Herramienta de administración dedicada: Página exclusiva para detectar facturas "fantasma" (enviadas a la AEAT pero no correctamente validadas en el ERP).
• 📅 Filtro por mes y año: Búsqueda acotada por periodo para facilitar la detección.
• 🔄 Sincronización individual: Repara una factura concreta usando su RefExterna como identificador único con AEAT.
• 🔄 Sincronización masiva: Acción "Reparar Facturas Fantasma" disponible desde el listado estándar de facturas de Dolibarr.
• ⚠️ Diálogos de confirmación: Confirmación obligatoria antes de cada operación de sincronización.

🔌 API REST

• 📡 GET /verifactu/integrity: Endpoint público (protegido por API-KEY) que devuelve el hash de integridad del módulo.
• 🔄 POST /verifactu/toProduction: Cambia el módulo a entorno de producción remotamente.
• 🔄 POST /verifactu/toTest: Cambia el módulo a entorno de pruebas remotamente.
• 📋 Respuesta estructurada: Devuelve hash de integridad, versión, estado de configuración e información del entorno.

�🔬 Simulación de Envío (Dry Run)

• 🧪 Simular Alta y Modificación: Botones para generar el payload JSON completo sin enviarlo a la AEAT.
• 📋 Vista JSON dual: JSON raw con botón copiar + vista jerárquica interactiva.
• 🔮 Referencia simulada: En borradores, calcula y muestra la siguiente referencia que se asignaría al validar.
• 📄 Disponible en cualquier estado: Funciona incluso con facturas en borrador, ideal para verificaciones previas.

🎨 Interfaz de Usuario

• 📌 Pestaña VERI*FACTU en cada factura: Toda la información del envío, respuesta AEAT, código QR y opciones de simulación.
• 📊 Listado de facturas VERI*FACTU: Vista centralizada con filtros por estado de envío (Pendiente, Correcto, Parcial, Incorrecto).
• 🔍 Consulta directa a AEAT: Verifica el estado de una factura directamente contra los registros de la Agencia Tributaria.
• 💡 Tooltip inteligente: Los campos Verifactu solo aparecen en el tooltip si la factura ha sido procesada.
• 📊 Icono en menú superior: Estado del módulo visible con tooltip posicionado dinámicamente compatible con todos los temas.
• 🏷️ Icono de estado CSV en referencias: Cada referencia de factura en la interfaz muestra un icono del estado de respuesta AEAT (Correcto, Parcial, Incorrecto).
• ⚙️ Panel de administración con 9 pestañas: General, Certificados, Descargas, Acuerdo de licencia, Registro de cambios, Telemetría, Acerca de, Facturas fantasma y Documentación.
• 📐 Configuración progresiva por etapas: Los campos se revelan gradualmente — Básica → Adicional → QR → Avanzada — evitando abrumar al usuario.
• 👤 Sistema de permisos: Permiso dedicado verifactu->manage para control de acceso granular a las funcionalidades del módulo.
• 📋 20 claves de régimen fiscal: Régimen general, exportación, bienes usados, oro, agencias de viajes, criterio de caja, OSS/IOSS, recargo de equivalencia, REAGYP, simplificado y más.
• 📑 Todos los tipos de factura oficiales: F1 (completa), F2 (simplificada), F3 (sustitución), R1–R5 (rectificativas), con rectificación por sustitución (S) y por diferencias (I).

🧩 Qué incluye el módulo

• 📄 Pestaña VERI*FACTU en cada factura con estado de envío, respuesta AEAT, QR y simulación.
• 📋 Listado de facturas con filtros de estado y acciones masivas.
• 🔍 Verificación NIF/CIF con badge automático en ficha de tercero.
• 🇪🇺 Verificación VIES/ROI para operaciones intracomunitarias.
• 🔍 Consulta de registros AEAT para verificar facturas enviadas.
• 🔐 Gestión de certificados con carga, validación y extracción automática.
• 📥 Gestión de descargas con verificación de actualizaciones.
• 📜 Declaración responsable descargable en PDF.
• ⚙️ Panel de configuración con 9 pestañas: General, Certificados, Descargas, Acuerdo de licencia, Registro de cambios, Telemetría, Acerca de, Facturas fantasma y Documentación.
• 🔧 5 máscaras de numeración: Estándar, Abono, Nota de crédito, Anticipo y Simplificada.
• ⚡ 2 cronjobs: Reenvío de facturas con errores y generación segura de facturas recurrentes.
• 🔒 2 triggers: Restricciones de facturación y envío automático a AEAT.
• 📐 Librería verifactu_lib: Motor independiente para construcción XML, firma, envío SOAP y validaciones.
• 🔍 Verificador de compatibilidad: Script para comprobar requisitos PHP/extensiones del servidor.
• ❓ FAQ integrada: Preguntas frecuentes sobre campos y valores de VERI*FACTU.
• 🌍 Traducciones en Español (es_ES), Inglés (en_US) y Gallego (gl_ES).
• 📋 Documentación completa: Guías PDF incluidas en el módulo.
• 🔐 Telemetría transparente: Política RGPD completa documentada.
• 🛡️ Módulo antifraude RD 1007/2023: Se incluye el módulo adicional module_rd10072023-1.5.3.zip, requerido por la normativa antifraude del Real Decreto 1007/2023.

📦 Casos de uso habituales

• 🏢 Sociedades españolas: Cumplimiento obligatorio desde el 1 de enero de 2027. Envío automático de todas las facturas emitidas a la AEAT.
• 💼 Autónomos y profesionales: Cumplimiento obligatorio desde el 1 de julio de 2027. Configuración simplificada para trabajadores por cuenta propia.
• 🛒 Comercios con TPV (TakePos): Facturación simplificada automática para ventas en punto de venta físico.
• 🏗️ Empresas de construcción y servicios: Gestión de facturas con retenciones (IRPF) y cálculo correcto de ImporteTotal.
• 🌍 Empresas con clientes intracomunitarios: Verificación VIES y ROI integrada para operaciones UE.
• 📊 Asesorías y gestorías: Validación masiva de facturas por lotes y verificación NIF/CIF contra el censo AEAT.
• 🏭 Empresas de distribución: Alto volumen de facturación con reintentos automáticos y cronjobs de reenvío.
• 💻 Empresas de software y SaaS: Facturas recurrentes generadas de forma segura con el cronjob especializado.

🛡️ Seguridad y Cumplimiento

• 🔐 Verificación SSL activa: Todas las comunicaciones con AEAT usan verify_peer = true para prevenir ataques MITM.
• 🛡️ Protección XSS: dol_escape_htmltag() aplicado a todos los atributos HTML dinámicos.
• 🔒 Diálogo de confirmación: Confirmación jQuery UI modal antes de ejecutar acciones críticas.
• 📋 Hash de integridad SHA-256: Verificación de que el código del módulo no ha sido alterado.
• ⚖️ Declaración responsable: Documento legal descargable que acredita el cumplimiento del RD 1007/2023.
• 📊 Telemetría mínima y transparente: Solo datos técnicos imprescindibles, nunca datos de clientes ni facturación. Política RGPD documentada.
• 🔗 Cadena de facturas: Hash encadenado SHA-256 que garantiza inalterabilidad y trazabilidad de todos los registros.
• 🔐 Almacenamiento cifrado de claves: Claves privadas cifradas en BD con dolEncrypt()/dolDecrypt().
• 🚫 Restricciones de facturación: Bloqueo automático de reapertura, eliminación y modificación de facturas validadas, con botones deshabilitados y tooltip explicativo.
• 🛡️ Protección de extrafields: Impide eliminar campos con prefijo verifactu_ para preservar la integridad de los datos fiscales.
• ✅ Validación automática de datos: CIF obligatorio para clientes españoles, NIF-IVA intracomunitario para clientes UE, dirección obligatoria (excepto facturas simplificadas).
• 🔐 Protección CSRF: Todos los endpoints AJAX y formularios protegidos contra falsificación de peticiones.

⚙️ Compatibilidad y requisitos

• 📦 Dolibarr V10+ (compatible hasta V23+)
• ⚙️ PHP 7.4 – 8.3+
• 🗄️ MySQL 5.7+ / MariaDB 10.3+ / PostgreSQL 10+
• 🌐 Navegador moderno con soporte JavaScript
• 🔌 Extensiones PHP requeridas: curl, openssl, json, xml
• 🔐 Certificado digital FNMT/AEAT válido (formato .pfx o .p12)
• 📡 Acceso a Internet para comunicación SOAP con la AEAT
• 🔗 Módulos Dolibarr requeridos: Facturación, BlockedLog, API REST

💰 Precio y licencia

El módulo se distribuye bajo licencia GPL v3 con condiciones adicionales necesarias para el cumplimiento del Real Decreto 1007/2023. El productor del software (EasySoft Tech S.L.) como responsable legal bajo la normativa antifraude, implementa controles de integridad y activación por licencia. Incluye actualizaciones y soporte durante la vigencia de la licencia.

✉️ Soporte

✉️ info@easysoft.es | 🌐 www.easysoft.es