Lettore FatturaPA e spiegazione delle ricevute SdI

• Piccole imprese e professionisti che ricevono molte fatture elettroniche dai fornitori.
• Chi tiene la prima nota nei piccoli studi contabili.

Le fatture elettroniche italiane arrivano come file XML in formato FatturaPA, scambiati tramite il Sistema di Interscambio (SdI) dell'Agenzia delle Entrate. Una piccola impresa può ricevere una cartella di file XML, alcuni dentro un .p7m firmato, e qualcuno deve copiare i totali in un foglio di calcolo, trovare gli errori e capire perché lo SdI ha scartato una fattura.

1. Legge i file FatturaPA: .xml, .xml.p7m firmati, oppure un .zip che li contiene. Un file può contenere più fatture.
2. Produce un unico file (Excel, CSV o JSON) con ogni fattura, riga e riepilogo IVA: cedente e cessionario, partite IVA e codici fiscali, numero, data, imponibile, IVA, totale, ritenuta d'acconto, IVA in split payment, importo da pagare, scadenza e IBAN.
3. Controlla ogni fattura ed elenca ogni problema con il motivo. Nulla viene corretto o indovinato:

• cifra di controllo di partita IVA e codice fiscale;
• quadratura di ogni riga, di ogni riepilogo IVA, del totale documento e del pagamento dopo ritenuta d'acconto e split payment;
• codici Natura, date, campi obbligatori e duplicati nello stesso lotto.

Ogni problema riporta il codice di scarto SdI corrispondente, per esempio [SdI 00423], oppure indica che lo SdI non fa quel controllo.

1. Spiega le ricevute SdI. Carichi le notifiche che lo SdI rimanda indietro (scarto, consegna, mancata consegna o esito di una pubblica amministrazione) e ottieni una risposta di una riga in italiano o in inglese, ogni codice di errore spiegato in parole semplici con un suggerimento di correzione, e il testo ufficiale.

Elaborazione locale sul tuo computer, con accesso riservato.

Tutte le fatture sono inventate dal nostro generatore. Misurati il 5 ottobre 2026; numeri tratti dai report di valutazione del progetto.

• Errori inseriti: 13 tipi, ciascuno inserito in 2 file per set, per esempio una cifra di controllo sbagliata, una quadratura errata, un numero di fattura mancante, una data impossibile, un file troncato o la stessa fattura inviata due volte.
• Un errore silenzioso è una fattura che ha superato tutti i controlli pur avendo un campo letto male.
• Perché il punteggio pieno non è il dato principale: il generatore e il lettore sono stati scritti dallo stesso sviluppatore, quindi i punteggi pieni sui nostri file mostrano soprattutto che il codice è coerente con se stesso. Due verifiche usano materiale che non abbiamo scritto noi:
• ogni file generato che deve essere valido supera lo schema ufficiale FatturaPA v1.2.2: 80 su 80 in ogni set;
• i 6 file di esempio pubblicati su fatturapa.gov.it (8 fatture) vengono letti tutti. Sono tutti segnalati, giustamente: usano una partita IVA segnaposto con la cifra di controllo sbagliata.

Ricevute SdI (sintetiche, 60 notifiche): 60 su 60 lette con il tipo giusto; 74 occorrenze di codici di errore estratte su 74; tutte le 69 occorrenze di codici noti spiegate; le 5 occorrenze di codici assenti dalla tabella ufficiale segnalate come sconosciute con il testo dello SdI, mai indovinate. La tabella dei codici viene dalle specifiche tecniche SdI, versione 1.9.1, che elenca 67 codici distinti. Le spiegazioni in parole semplici sono nostre e non sono indicazioni ufficiali.

Python, lxml e defusedxml (lettura sicura dell’XML), cryptography e asn1crypto (file firmati .p7m), pandas, openpyxl, Streamlit; test con pytest e Playwright; distribuito con Docker.

• Non misurato su fatture reali. I file dei veri programmi di contabilità conterranno blocchi che il nostro generatore non produce.
• La firma del .p7m non viene verificata. La fattura viene estratta e il risultato riporta "firma non verificata".
• Solo la cifra di controllo viene verificata per partite IVA e codici fiscali. Nessuna ricerca nei registri VIES o dell'Agenzia delle Entrate.
• Non ancora supportati: ritenuta sul contributo cassa previdenziale, sconti percentuali a livello di documento e la fattura semplificata.
• I duplicati vengono cercati solo all'interno dello stesso lotto.
• Notifiche SdI: non provate su notifiche reali; i codici assenti dalla tabella della versione 1.9.1 adottata vengono mostrati come sconosciuti.
• Non è una consulenza fiscale o legale.

Fonte: README e cartella reports/ di snello-fatturapa (main, holdout, formats, sdi, schema_check, official_examples), misurati il 5 ottobre 2026. Tabella dei codici di errore: Agenzia delle Entrate, Allegato A – Specifiche tecniche, versione 1.9.1, Appendice 1 (https://www.agenziaentrate.gov.it/portale/documents/d/guest/allegato-a-specifiche-tecniche-vers-1-9-1). Il codice è privato, quindi non è collegato.