Trasforma il tuo Dolibarr in un sistema di fatturazione conforme al RD 1007/2023 spagnolo
Registro di fatturazione, impronta concatenata e codice QR su ogni fattura. Con le due modalità previste dalla legge: invio in tempo reale all'Agenzia delle Entrate spagnola oppure custodia locale firmata in XAdES.
|
2 modi
VERI*FACTU e NO VERI*FACTU
|
V@lide
firma XAdES-EPES validata nel validatore ufficiale
|
34
simulatori di QA deterministici
|
V16–V23
PHP da 7.4 a 8.3
|
Il problema che risolve
Costruire l'XML e inviarlo all'Agenzia è la parte facile, ed è dove si ferma la maggior parte delle implementazioni. La parte cara arriva il giorno in cui l'invio non va come previsto: è allora che una fattura validata resta senza registro di fatturazione, o che la catena di impronte si spezza senza che nessuno se ne accorga fino all'invio successivo.
| Quello che ti capita |
Quanto ti costa |
| L'Agenzia risponde con un errore indeterminato — 20009 — e non dice se il registro è passato |
Se reinvii, duplichi il registro (errore 3000). Se non reinvii, ti resta una fattura validata senza alcun registro di fatturazione |
| L'attività pianificata nativa delle fatture ricorrenti genera l'intero lotto in un'unica transazione |
Ne fallisce una e il rollback annulla l'intero blocco: fatture già accettate dall'Agenzia tornano in bozza. Sono le fatture fantasma |
| Due invii simultanei leggono la stessa impronta precedente |
La catena si biforca e smette di essere strettamente sequenziale, che è esattamente ciò che impone l'art. 13 dell'ordinanza HAC/1177/2024 |
| Il codice QR compare solo sul modello PDF fornito con il modulo |
O cambi il modello con cui fatturi da anni, oppure consegni fatture prive del QR obbligatorio |
| Validi cinquanta fatture in blocco e la numero 12 va in errore |
Con una transazione globale, il fallimento di una si trascina dietro le altre 49 |
| Hai attivo il modulo delle fatture proforma |
Validare una proforma la trasmette all'Agenzia come fattura F1, quando non è affatto una fattura emessa (art. 6 RD 1007/2023) |
Questo modulo non si limita a costruire l'XML e spedirlo: si occupa di quello che succede quando l'invio non va come previsto, che è dove la conformità si rompe davvero.
LE DUE VIE DELLA LEGGE
Anche in modalità NO VERI*FACTU, con custodia locale firmata
La normativa spagnola ammette due modi di adempiere, e il modulo li implementa entrambi, commutabili dalla configurazione. In modalità VERI*FACTU ogni fattura viene trasmessa all'Agenzia nel momento stesso in cui la validi. In modalità NO VERI*FACTU non si trasmette nulla in tempo reale: ogni registro viene firmato e custodito sul tuo server, e viene consegnato solo se l'Agenzia lo richiede.
Questa custodia è pensata per reggere a un'ispezione, non per cavarsela. La firma è XAdES-EPES con la Politica di Firma della pubblica amministrazione spagnola (AGE), applicata al nodo del registro esattamente come impone la specifica tecnica dell'Agenzia, e validata in V@lide, il validatore ufficiale. I registri di evento dell'art. 9 sono generati contro l'XSD ufficiale, con una catena di impronte propria e indipendente da quella delle fatture, e il riepilogo periodico si avvia da solo.
Quando arriva una richiesta ai sensi dell'art. 18, il modulo raccoglie i registri firmati del periodo e ti lascia scegliere: scaricare lo ZIP pronto da depositare sul portale, oppure trasmetterlo direttamente via SOAP al servizio di richiesta — canale verificato contro l'ambiente di preproduzione dell'Agenzia. E poiché in custodia l'originale vive solo sul tuo server, il modulo sorveglia con impronta SHA-256 che nessun file sia andato perso o sia stato manomesso, e ti ricorda la tua responsabilità di conservazione.
Si integra dove già lavori
Niente schermate parallele: lo stato fiscale di ogni fattura vive nella scheda fattura di Dolibarr, accanto a tutto il resto.
Il codice QR fiscale accanto al riferimento e il blocco «VERI*FACTU Data» con lo stato dell'invio e il codice CSV restituito dall'Agenzia.
L'area «VERI*FACTU Area»: elenco degli invii con i relativi stati, consultazione diretta sul portale dell'Agenzia e guida ai campi fiscali, alle chiavi di regime e agli errori più frequenti.
Pannello di amministrazione: licenza, ambiente attivo e stato della configurazione a colpo d'occhio, con schede per certificati, rilevamento delle fatture fantasma, telemetria e registro delle modifiche.
Rispetto a un'implementazione minima
| Dimensione |
Costruire l'XML e inviarlo |
Questo modulo |
| Modalità |
Solo invio in tempo reale |
VERI*FACTU e NO VERI*FACTU con custodia locale, commutabili dalla configurazione |
| Se l'Agenzia cade |
La fattura resta a metà |
Viene marcata in attesa, ritentata dal cron e riconciliata chiedendo all'Agenzia se il registro è passato |
| Invii simultanei |
Catena biforcata |
Un lock per entità e ambiente serializza leggi-ancora, invia e salva-impronta; se non riesce a ottenerlo, l'invio viene differito invece di rompere l'ordine |
| Fatture fantasma |
Non previsto |
Rilevatore dedicato, sincronizzazione singola o massiva e quarantena esplicita quando serve un intervento umano |
| QR nel PDF |
Solo sul proprio modello |
Iniettato tramite hook in qualsiasi modello PDF attivo, oltre a ODT e scontrini TakePos |
| Fatture ricorrenti |
Il cron nativo, con la sua transazione globale |
Reindirizza l'attività nativa a una versione con una transazione per fattura, e la ripristina disattivando il modulo |
| Richiesta |
Non previsto |
Art. 18 coperto: ZIP firmato da depositare sul portale, oppure trasmissione SOAP diretta che preserva la firma di ogni registro |
| Eventi SIF |
Non previsto |
Registri di evento dell'art. 9 validati contro l'XSD ufficiale, con riepilogo periodico e catena propria |
| Verifica dei terzi |
Manuale, dopo il rifiuto |
Codice fiscale spagnolo contro l'anagrafe dell'Agenzia, partita IVA intracomunitaria contro VIES e ROI, con contrassegno automatico sulla scheda del terzo |
| Verifica |
Test manuali |
34 simulatori deterministici, più un banco di prova che esegue il codice reale contro un database reale e un'Agenzia simulata |
Cosa include
Sei in regola qualunque modalità scelga
Registri di emissione, annullamento e rettifica R1–R5 con impronta concatenata, e tutti i tipi ufficiali: F1 completa, F2 semplificata e F3 di sostituzione, con rettifica per sostituzione o per differenze. Invio SOAP o custodia locale firmata, a tua scelta.
Sopravvive a un blackout dell'Agenzia
Transazione isolata per fattura, cron di ritentativo, riconciliazione delle risposte indeterminate, reinvio idempotente che non duplica mai il registro, rilevatore di fatture fantasma e stati di attesa con etichetta propria per sapere cosa manca.
Il QR esce sulla fattura che consegni tu
Iniettato in qualsiasi modello PDF attivo di Dolibarr, non solo in quello del modulo, oltre a ODT e scontrini TakePos. Tre dimensioni conformi alla specifica (30, 35 e 40 mm), posizione configurabile e testo di verifica opzionale sotto.
Sai in ogni momento se sei conforme
Cruscotto di conformità con modalità attiva, stato del certificato e della catena, verifica di integrità dei file custoditi, avviso di scadenza del certificato e dichiarazione responsabile scaricabile.
I dati del cliente verificati prima di fatturare
Codice fiscale spagnolo contro l'anagrafe dell'Agenzia, con contrassegno a colori sulla scheda del terzo e pulsante per correggere il nome; partita IVA intracomunitaria contro VIES per i 27 Paesi UE, più consultazione del ROI. Singola o massiva.
Il tuo certificato, trattato come si deve
PKCS#12 (.pfx e .p12) con estrazione automatica tramite PHP nativo, senza dipendere da un hosting che consenta OpenSSL esterno. Chiave privata cifrata nel database, comunicazioni con verifica TLS e possibilità di ospitare il certificato su un server esterno.
A cosa serve
- Società obbligate dal 1° gennaio 2027 e liberi professionisti dal 1° luglio 2027, con ambiente di test disponibile fin da ora.
- Negozi con punto cassa: TakePos emette automaticamente una fattura semplificata F2, con serie propria e QR sullo scontrino.
- Aziende che fatturano nell'UE e devono verificare la partita IVA contro VIES prima di emettere.
- Studi e commercialisti che validano a lotti e hanno bisogno che un rifiuto non si trascini dietro il resto del lotto.
- Attività in abbonamento che non possono permettersi un rollback globale a metà della generazione mensile.
- Soggetti obbligati che preferiscono non trasmettere in tempo reale e custodire i propri registri firmati, consegnandoli solo su richiesta.
- Edilizia e servizi professionali, con ritenute d'acconto e maggiorazione di equivalenza nella ripartizione IVA.
Messa in funzione
1
Installa il modulo e attivalo. Prima, se vuoi, lancia il verificatore di compatibilità incluso per controllare versione di PHP ed estensioni del tuo server.
2
Carica il certificato digitale e completa i dati fiscali. La configurazione si svela per fasi — base, aggiuntiva, QR e avanzata — per non sommergerti di campi tutti insieme.
3
Scegli la modalità: VERI*FACTU o custodia locale. In ambiente di test, simula l'invio di una fattura per vedere il registro esatto che verrebbe generato, senza trasmettere nulla.
4
Valida le fatture come hai sempre fatto. Registro, impronta e QR si generano da soli; apri la scheda VERI*FACTU solo se vuoi il dettaglio.
Requisiti
| Dolibarr |
Da V16 a V23. Si installa da V10, ma l'elenco VERI*FACTU e la sua area richiedono V16 o successiva |
| PHP |
Da 7.4 a 8.3, con curl, openssl, json e xml |
| Database |
MySQL 5.7+ o MariaDB 10.3+. Non supportato su PostgreSQL: la concatenazione delle impronte e la serializzazione della catena usano SQL specifico di MySQL/MariaDB |
| Certificato |
Un certificato digitale valido in formato .pfx o .p12 e accesso a Internet in uscita verso i servizi dell'Agenzia |
| Licenza |
GNU General Public License v3.0 · 365 giorni di accesso agli aggiornamenti |
Prima di acquistare
Posso leggerlo e adattarlo?
Sì. È distribuito sotto GNU GPL v3 e ricevi tutto il codice sorgente. Con una precisazione che preferiamo darti prima dell'acquisto: poiché il modulo agisce da sistema informatico di fatturazione ed EasySoft Tech S.L. figura come produttore del software, incorpora un controllo di integrità del codice e un'attivazione tramite chiave legata al tuo dominio. Modificarlo è un tuo diritto; tieni solo presente che così cambia l'impronta del codice su cui si regge la dichiarazione responsabile.
Come lo provo senza rischi?
Lavorando contro l'ambiente di test dell'Agenzia, dove il modulo opera finché l'obbligo non è entrato in vigore per te. Hai inoltre la simulazione di invio: genera il registro completo che verrebbe trasmesso — anche per una fattura in bozza — senza spedire nulla. Detto questo, siamo chiari: validare una fattura crea dati fiscali reali nel tuo ERP, quindi fai le prime prove su una copia.
E se qualcosa non si incastra con la mia installazione?
Scrivici a
info@easysoft.es prima di acquistare e lo guardiamo insieme: versione di Dolibarr, motore del database, tipo di certificato e come fatturi oggi. Preferiamo dirti che non fa per te piuttosto che venderti qualcosa che non ti serve.
Cosa succede quando scadono i 365 giorni?
Il modulo che hai installato continua a funzionare. Quello che scade è l'accesso alle nuove versioni e ai download. Per un modulo che insegue una normativa viva, con un calendario già slittato una volta, mantenere l'abbonamento è la scelta sensata: quando l'Agenzia cambia uno schema, l'aggiornamento ti arriva.
Mi obbliga a cambiare il modello di fattura?
No. Il QR viene iniettato tramite hook nel modello PDF che già usi, e funziona anche in ODT. Puoi continuare a emettere con la grafica di sempre.
Manutenzione attiva
Questo modulo non è stato pubblicato e poi abbandonato. Ogni rilascio passa per 34 simulatori deterministici che fissano per contratto il comportamento atteso, e gli incidenti reali diventano test prima di considerarsi chiusi. Si lavora così:
- Un banco di prova di integrazione che esegue il codice reale contro un database reale e un server fiscale simulato, riproducendo blackout e risposte indeterminate, e annullando tutto alla fine.
- Revisione adversariale di ogni correzione: proviamo a rompere la nostra stessa patch prima di pubblicarla, e ciò che emerge viene blindato nella stessa versione.
- Validazione contro gli schemi XSD ufficiali dell'Agenzia e il suo ambiente di preproduzione, con la firma verificata in V@lide.
- Aggiornatore integrato: controlla se esiste una nuova versione, verifica l'integrità del pacchetto scaricato ed esegue un backup prima di applicarlo.
Il dettaglio versione per versione è nel registro delle modifiche, accessibile dalla scheda di amministrazione del modulo.
|
24
moduli pubblicati su Dolistore
|
GPLv3
codice sorgente completo
|
3
lingue nell'interfaccia
|
365
giorni di aggiornamenti
|
È adatto al tuo modo di fatturare?
Raccontaci il tuo caso — versione di Dolibarr, tipo di certificato, se usi il punto cassa o la fatturazione ricorrente — e ti diremo se questo modulo fa per te. E se non fa per te, te lo diciamo lo stesso.
info@easysoft.es www.easysoft.es