VERI*FACTU - Fatturazione Elettronica Spagna (Decreto Reale 1007/2023)

VERI*FACTU per Dolibarr — Fatturazione Elettronica conforme al Decreto Reale spagnolo 1007/2023

VERI*FACTU è il modulo professionale per Dolibarr che implementa il sistema di verifica e validazione delle fatture richiesto dalla normativa fiscale spagnola. È pienamente conforme al Decreto Reale 1007/2023 sui Sistemi Informatizzati di Fatturazione (SIF), consentendo l'invio telematico automatico delle fatture all'Agenzia Fiscale Spagnola (AEAT), la generazione automatica di codici QR, la firma digitale con certificato e la tracciabilità fiscale completa di ogni fattura emessa.

Sviluppato da EasySoft Tech S.L., produttore di software registrato conforme alla normativa antifrode, il modulo garantisce che la tua azienda rispetti tutti gli obblighi legali di fatturazione elettronica in Spagna.

📋 Tabella delle funzionalità

� Sistema di Notifiche e Avvisi

• 🔔 Icona campanella nella barra superiore: Indicatore permanente nella barra menu di Dolibarr con accesso diretto allo stato del modulo.
• 📢 Avvisi push dal server: Notifiche in tempo reale con 3 livelli di priorità (normale, alta, critica), ciascuno con colori differenziati.
• 🆕 Notifica aggiornamenti disponibili: Il modulo verifica automaticamente le nuove versioni e avvisa l'amministratore.
• 🌡️ Indicatore di ambiente: Mostra chiaramente se si è in modalità TEST o PRODUZIONE, con conto alla rovescia fino alla data obbligatoria.
• 📊 Versione del modulo visibile: Tooltip con informazioni di versione, ambiente e link diretti alla configurazione.
• 🔗 Link diretto al download: Gli amministratori possono accedere al download degli aggiornamenti direttamente dalla notifica.

📥 Aggiornamento Integrato del Modulo

• 🔄 Verifica versione remota: Controlla l'ultima versione disponibile dal server di aggiornamento di EasySoft.
• 📥 Download diretto da Dolibarr: Scarica il pacchetto di aggiornamento senza uscire dall'interfaccia dell'ERP.
• 🔐 Verifica di integrità: Confronta l'hash del pacchetto scaricato per garantire che non sia stato alterato.
• 💾 Backup automatico: Prima di applicare l'aggiornamento, viene creato automaticamente un backup del modulo attuale.
• 📋 Gestione file scaricati: Vista con data, dimensione e azioni disponibili per ogni download.
• ⚠️ Gestione errori: Messaggi descrittivi per errori HTTP (200/400/403) durante il download.

📊 Dashboard / Pannello di Controllo

• 🎨 Design moderno con schede animate: Pannello principale con animazioni CSS (fadeInUp) e gradienti professionali.
• 📋 3 schede di navigazione principali: Fatture Emesse, Consultazione AEAT e FAQ, con accesso diretto a ogni sezione.
• 🔑 Stato della licenza: Visualizzazione prominente dello stato di attivazione con messaggi chiari.
• 🔐 Stato del certificato digitale: Informazioni di validazione del certificato con conto alla rovescia di scadenza.
• 🖥️ Stato del server certificati: Indicatore del server locale/remoto dei certificati.
• 📱 Design responsive: Layout a griglia adattabile a qualsiasi risoluzione dello schermo.

👻 Rilevatore di Fatture Fantasma

• 🔍 Strumento di amministrazione dedicato: Pagina esclusiva per rilevare fatture “fantasma” (inviate all'AEAT ma non correttamente validate nell'ERP).
• 📅 Filtro per mese e anno: Ricerca per periodo per facilitare il rilevamento.
• 🔄 Sincronizzazione individuale: Ripara una fattura specifica utilizzando il suo RiferimentoEsterno come identificatore unico con l'AEAT.
• 🔄 Sincronizzazione in massa: Azione “Ripara Fatture Fantasma” disponibile dall'elenco standard delle fatture di Dolibarr.
• ⚠️ Dialoghi di conferma: Conferma obbligatoria prima di ogni operazione di sincronizzazione.

🔌 API REST

• 📡 GET /verifactu/integrity: Endpoint pubblico (protetto da API-KEY) che restituisce l'hash di integrità del modulo.
• 🔄 POST /verifactu/toProduction: Passa il modulo all'ambiente di produzione da remoto.
• 🔄 POST /verifactu/toTest: Passa il modulo all'ambiente di test da remoto.
• 📋 Risposta strutturata: Restituisce hash di integrità, versione, stato configurazione e informazioni dell'ambiente.

�🚀 Invio Automatico all'AEAT

Alla validazione di una fattura in Dolibarr, il modulo intercetta il processo tramite trigger e:

1. 📋 Valida i dati fiscali: NIF/CIF di emittente e destinatario, tipo di fattura, chiave di regime e imposte applicate.
2. 🔏 Genera la firma digitale: Costruisce l'XML SOAP firmato con il tuo certificato digitale.
3. 🔗 Concatena con la fattura precedente: Calcola l'hash SHA-256 concatenato per tracciabilità e inalterabilità.
4. 📡 Invia all'AEAT: Trasmissione SOAP sicura (TLS) al servizio web dell'Agenzia Fiscale.
5. 📥 Elabora la risposta: Memorizza stato, CSV di risposta e dettagli dell'invio.
6. 📊 Genera il codice QR: QR conforme alle specifiche AEAT con URL di verifica e dati della fattura.

🎨 Interfaccia Utente

• 📌 Scheda VERI*FACTU su ogni fattura: Tutte le informazioni di invio, risposta AEAT, codice QR e opzioni di simulazione.
• 📊 Elenco fatture VERI*FACTU: Vista centralizzata con filtri per stato di invio (In attesa, Corretto, Parziale, Errato).
• 🔍 Consultazione diretta AEAT: Verifica lo stato di una fattura direttamente contro i registri dell'Agenzia Fiscale.
• 💡 Tooltip intelligente: I campi Verifactu appaiono nel tooltip solo se la fattura è stata elaborata.
• 📊 Icona nel menu superiore: Stato del modulo visibile con tooltip posizionato dinamicamente compatibile con tutti i temi.
• 🏷️ Icona di stato CSV sui riferimenti: Ogni riferimento fattura nell'interfaccia mostra un'icona di stato risposta AEAT (Corretto, Parziale, Errato).
• ⚙️ Pannello di amministrazione con 9 schede: Generale, Certificati, Download, Accordo di licenza, Registro modifiche, Telemetria, Informazioni, Fatture fantasma e Documentazione.
• 📐 Configurazione progressiva per fasi: I campi si rivelano gradualmente — Base → Aggiuntiva → QR → Avanzata — per non sovraccaricare l'utente.
• 👤 Sistema di permessi: Permesso dedicato verifactu->manage per controllo accessi granulare alle funzionalità del modulo.
• 📋 20 chiavi di regime fiscale: Regime generale, esportazione, beni usati, oro, agenzie di viaggio, cassa, OSS/IOSS, maggiorazione di equivalenza, REAGYP, semplificato e altro.
• 📑 Tutti i tipi di fattura ufficiali: F1 (completa), F2 (semplificata), F3 (sostituzione), R1–R5 (rettificative), con rettifica per sostituzione (S) e per differenze (I).

🧩 Cosa include il modulo

• 📄 Scheda VERI*FACTU su ogni fattura con stato invio, risposta AEAT, QR e simulazione.
• 📋 Elenco fatture con filtri di stato e azioni in batch.
• 🔍 Verifica NIF/CIF con badge automatico sulla scheda del terzo.
• 🇪🇺 Verifica VIES/ROI per operazioni intracomunitarie.
• 🔍 Consultazione registri AEAT per verificare le fatture inviate.
• 🔐 Gestione certificati con caricamento, validazione ed estrazione automatica.
• 📥 Gestione download con verifica aggiornamenti.
• 📜 Dichiarazione responsabile scaricabile in PDF.
• ⚙️ Pannello di amministrazione con 9 schede: Generale, Certificati, Download, Accordo di licenza, Registro modifiche, Telemetria, Informazioni, Fatture fantasma e Documentazione.
• 🔧 5 maschere di numerazione: Standard, Rimborso, Nota di credito, Anticipo e Semplificata.
• ⚡ 2 cronjob: Reinvio fatture in errore e generazione sicura di fatture ricorrenti.
• 🔒 2 trigger: Restrizioni di fatturazione e invio automatico all'AEAT.
• 📐 Libreria verifactu_lib: Motore indipendente per costruzione XML, firma, invio SOAP e validazioni.
• 🔍 Verificatore di compatibilità: Script per verificare i prerequisiti PHP/estensioni del server.
• ❓ FAQ integrata: Domande frequenti su campi e valori VERI*FACTU.
• 🌍 Traduzioni in Spagnolo (es_ES), Inglese (en_US) e Galiziano (gl_ES).
• 📋 Documentazione completa: Guide PDF incluse nel modulo.
• 🔐 Telemetria trasparente: Politica GDPR completa documentata.
• 🛡️ Modulo antifrode DR 1007/2023 incluso: Include il modulo aggiuntivo module_rd10072023-1.5.3.zip, richiesto dalla normativa antifrode del Decreto Reale 1007/2023.

📦 Casi d'uso comuni

• 🏢 Società spagnole: Conformità obbligatoria dal 1° gennaio 2027. Invio automatico di tutte le fatture emesse all'AEAT.
• 💼 Lavoratori autonomi e professionisti: Conformità obbligatoria dal 1° luglio 2027. Configurazione semplificata per freelance.
• 🛒 Negozi con POS (TakePos): Fatturazione semplificata automatica per vendite al punto vendita fisico.
• 🏗️ Imprese edili e di servizi: Gestione fatture con ritenute (IRPF) e calcolo corretto dell'ImporteTotal.
• 🌍 Aziende con clienti UE: Verifica VIES e ROI integrata per operazioni intracomunitarie.
• 📊 Consulenti fiscali e studi: Validazione in batch e verifica NIF/CIF contro il censimento AEAT.
• 🏭 Aziende di distribuzione: Alto volume di fatturazione con tentativi automatici e cronjob di reinvio.
• 💻 Aziende software e SaaS: Fatture ricorrenti generate in sicurezza con il cronjob specializzato.

🛡️ Sicurezza e Conformità

• 🔐 Verifica SSL attiva: Tutte le comunicazioni con l'AEAT utilizzano verify_peer = true per prevenire attacchi MITM.
• 🛡️ Protezione XSS: dol_escape_htmltag() applicato a tutti gli attributi HTML dinamici.
• 🔒 Dialogo di conferma: Conferma modale jQuery UI prima di eseguire azioni critiche.
• 📋 Hash di integrità SHA-256: Verifica che il codice del modulo non sia stato alterato.
• ⚖️ Dichiarazione responsabile: Documento legale scaricabile che certifica la conformità al DR 1007/2023.
• 📊 Telemetria minima e trasparente: Solo dati tecnici essenziali, mai dati dei clienti o di fatturazione. Politica GDPR documentata.
• 🔗 Catena di fatture: Hash SHA-256 concatenato che garantisce inalterabilità e tracciabilità di tutti i registri.
• 🔐 Archiviazione crittografata delle chiavi: Chiavi private crittografate in DB con dolEncrypt()/dolDecrypt().
• 🚫 Restrizioni di fatturazione: Blocco automatico della riapertura, cancellazione e modifica delle fatture validate, con pulsanti disabilitati e tooltip esplicativo.
• 🛡️ Protezione extrafield: Impedisce la cancellazione dei campi con prefisso verifactu_ per preservare l'integrità dei dati fiscali.
• ✅ Validazione automatica dei dati: CIF obbligatorio per clienti spagnoli, P.IVA intracomunitaria per clienti UE, indirizzo obbligatorio (eccetto fatture semplificate).
• 🔐 Protezione CSRF: Tutti gli endpoint AJAX e i moduli protetti contro la falsificazione di richieste cross-site.

⚙️ Compatibilità e requisiti

• 📦 Dolibarr V10+ (compatibile fino a V23+)
• ⚙️ PHP 7.4 – 8.3+
• 🗄️ MySQL 5.7+ / MariaDB 10.3+ / PostgreSQL 10+
• 🔌 Estensioni PHP richieste: curl, openssl, json, xml
• 🔐 Certificato digitale FNMT/AEAT valido (.pfx o .p12)
• 🔗 Moduli Dolibarr richiesti: Fatturazione, BlockedLog, API REST
• 🌐 Browser moderno con supporto JavaScript
• 📡 Accesso a Internet per comunicazione SOAP con l'AEAT

💰 Prezzo e licenza

Il modulo è distribuito con licenza GPL v3 con condizioni aggiuntive necessarie per la conformità al Decreto Reale 1007/2023. Il produttore del software (EasySoft Tech S.L.), in qualità di responsabile legale ai sensi della normativa antifrode, implementa controlli di integrità e attivazione tramite licenza.

✉️ Supporto

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