Vai al contenuto
Officina Tributaria, tecnologie per uffici tributi comunali: pagina iniziale
Lettore F24 tributi locali SOGEI
Approfondimento · Flussi F24

Lettore F24 Tributi: dalla rendicontazione SOGEI al governo degli incassi

Come i flussi F24 dell’Agenzia delle Entrate vengono trasformati da file a tracciato fisso in una dashboard interattiva per la gestione dei versamenti tributari comunali, IMU, TARI, TEFA e oltre.

Fonte dati SOGEI: agenzia delle Entrate
Tracciato Record A1 · G1 · G2 · G5
Tributi IMU · TARI · TEFA · TASI
Accesso Area riservata
F24

Contesto: il modello F24 e i flussi di rendicontazione

D.Lgs. 241/1997 · Provvedimenti AdE · Tracciato SOGEI

Il Modello F24 come strumento universale di pagamento

Il Modello F24, istituito dal D.Lgs. 9 luglio 1997, n. 241, è lo strumento con cui i contribuenti versano imposte, tasse, contributi e premi, sia erariali che locali. Per i tributi comunali, il F24 rappresenta il canale principale di riscossione: IMU (codici tributo 3912-3918), TARI (3944-3946), TEFA e addizionali provinciali sono tutti versati attraverso questo modello.

Il ciclo di rendicontazione SOGEI

Quando un contribuente paga un F24 presso una banca, un ufficio postale o tramite home banking, il flusso finanziario attraversa una catena precisa: istituto di credito → sistema bancario (CBI) → SOGEI → Agenzia delle Entrate → tesoreria dell’Ente destinatario. In parallelo, SOGEI genera un flusso informativo, il tracciato record, che viene messo a disposizione dell’Ente per la rendicontazione.

I flussi informativi per i Comuni

L’Agenzia delle Entrate rende disponibili ai Comuni, attraverso Siatel/Punto Fisco, i file contenenti i dettagli dei versamenti F24 effettuati a favore dell’Ente. Questi file sono in formato a tracciato fisso, record di lunghezza predeterminata, e contengono centinaia o migliaia di record per ogni flusso mensile.

ℹ️
Frequenza dei flussi. I file F24 sono resi disponibili con cadenza periodica (tipicamente mensile). Un Comune di medie dimensioni riceve decine di file all’anno, ciascuno contenente migliaia di record di versamento.
REC

Il tracciato SOGEI: tipi record A1, G1, G2, G5

Struttura record a posizione fissa · Codifiche e decodifiche

Il tracciato SOGEI per i flussi F24 è composto da diversi tipi di record, ciascuno con una struttura a posizione fissa e un significato specifico. Il lettore elabora quattro tipi di record (A1, G1, G2, G5); G3, G4, G9 e Z1 sono riconosciuti ma non ancora elaborati.

Tipo RecordContenutoCampi principali
A1Inizio fornituraDati identificativi della fornitura
G1Versamento, dati analitici del versamento indicato dal contribuente in un rigo del modello F24Codice fiscale, codice tributo, anno di riferimento, importi a debito e a credito, data di riscossione, acconto/saldo, numero immobili
G2Accredito dispostoDati contabili dell’accredito a favore dell’ente, di IFEL o della TEFA
G5Identificazione accreditoEstremi dell’operazione comunicati da Banca d’Italia (CRO o codice del movimento)
G9Annullamento delegaVersamento annullato su istanza di intermediari o contribuenti (riconosciuto, non ancora elaborato)

La complessità della decodifica

Il record G1, quello del singolo versamento, ha come tutti i record 300 caratteri, con decine di campi a posizione fissa. Il codice tributo (4 caratteri) determina la natura del pagamento: 3912 per l’abitazione principale IMU, 3918 per gli altri fabbricati, 3944 per la TARI, 3945 per gli interessi TARI, 3946 per le sanzioni TARI, TEFA per l’addizionale provinciale. Un singolo file può contenere decine di migliaia di questi record.

📐
Precisione al carattere. Un errore di posizione nella lettura del tracciato, anche un solo carattere spostato, significa attribuire un importo al codice tributo sbagliato o al contribuente errato. Il parser deve essere rigorosamente conforme alle specifiche SOGEI.
!

L’esigenza: gestire il volume degli incassi

Problematiche operative degli uffici tributi

Migliaia di record, nessuno strumento nativo

L’Agenzia delle Entrate fornisce i file F24 in formato raw, tracciato fisso, nessuna interfaccia di consultazione. Gli uffici tributi ricevono file di testo con centinaia di migliaia di caratteri per flusso, senza intestazioni, senza formattazione, senza possibilità di ricerca. Per estrarre i versamenti TARI di un singolo contribuente, l’operatore dovrebbe navigare manualmente il file, contare le posizioni dei caratteri e decodificare ogni record.

Il problema della rendicontazione

I Comuni hanno l’obbligo di rendicontare gli incassi tributari, verificare la corrispondenza tra versamenti attesi e versamenti effettuati, individuare gli omessi/parziali versamenti e alimentare i processi di accertamento. Senza uno strumento di parsing e analisi, questa attività richiede elaborazioni manuali con fogli di calcolo, lente, soggette a errori, non ripetibili.

La frammentazione dei file

Un anno fiscale produce decine di file F24 per un singolo Comune. Ogni file copre un periodo diverso, con strutture potenzialmente diverse tra versioni successive del tracciato. Aggregare i dati di un’intera annualità per tributo richiede di processare tutti i file, normalizzare le strutture e consolidare i record, un’operazione che, manualmente, può richiedere giorni.

2.000+File/anno per Comune medio
84.000+Record G1 per flusso
4Tipi record da gestire
300Caratteri per record
OT

La soluzione: parser conforme, dashboard interattiva

Import massivo · Ricerca avanzata · Rendiconto per tributo

Upload massivo

Il Lettore F24 di OfficinaTributaria consente di caricare fino a 1.500 file F24 in un’unica operazione. Il parser, conforme al tracciato SOGEI di giugno 2020, decodifica i record A1, G1, G2 e G5; riconosce G3, G4, G9 e Z1 senza elaborarli, normalizza le strutture e persiste tutti i dati in un database strutturato interrogabile.

Dashboard in tempo reale

Dopo l’import, l’operatore accede a una dashboard che mostra: importo totale riscosso, numero di versamenti e di contribuenti, riscosso per codice tributo, per anno di riferimento, per anno di riscossione e per canale di pagamento. Ogni dato è filtrabile per anno di riferimento, anno di riscossione, codice tributo e tipo di bonifico.

Ricerca avanzata

La funzione di ricerca consente di interrogare l’intero database dei versamenti per codice fiscale (anche parziale), codice tributo, anno di riferimento e intervallo di date. Il risultato è esportabile in CSV per ulteriori elaborazioni. La ricerca su centinaia di migliaia di record avviene in tempo reale, senza attese.

Accesso dall’area riservata

Il Lettore F24 si apre dall’area riservata della piattaforma Officina Tributaria e non è raggiungibile direttamente da internet, ma solo attraverso l’accesso autenticato.

✅
Export strutturato. Ogni tabella della dashboard è esportabile in Excel; i risultati della ricerca anche in CSV; la rendicontazione dei bonifici anche in PDF. Il rendiconto per tributo e per periodo è pronto per la riconciliazione con la tesoreria e per la predisposizione degli atti di accertamento per omesso/parziale versamento.
⚙

Architettura tecnica del parser

Pipeline di elaborazione · Codici tributo · Database

1
Upload e validazione I file vengono caricati e validati: verifica formato, encoding, presenza record header. File non conformi vengono segnalati con il dettaglio dell’errore.
2
Parsing posizionale Ogni record viene decodificato in base al tipo (A1/G1/G2/G5) con estrazione dei campi a posizione fissa: CF, codice tributo, importo, data, codice ente, anno riferimento.
3
Normalizzazione e dedup I record vengono normalizzati (importi in centesimi → euro, date in formato ISO, CF uppercase); i file già importati vengono riconosciuti dal nome e saltati.
4
Persistenza e indicizzazione I dati normalizzati vengono salvati nel database con indici ottimizzati per ricerca per CF, codice tributo, data e importo. Ogni record mantiene il riferimento al file sorgente.
5
Aggregazione e dashboard Le viste aggregate vengono calcolate: totali per tributo, per periodo, per contribuente. La dashboard si aggiorna in tempo reale ad ogni nuovo import.
✓

Vantaggi operativi

Dalla rendicontazione manuale al governo degli incassi

AspettoPrimaCon Lettore F24
ImportManuale, un file alla voltaMassivo: fino a 1.500 file in una sessione
DecodificaManuale o con script non manutenutiParser conforme al tracciato SOGEI di giugno 2020
RicercaCtrl+F su file di testoRicerca su database indicizzato, risultati in tempo reale
RendicontoFogli Excel manuali, soggetti a erroriAutomatico per tributo, periodo, contribuente
AccessoFile di testo sul computer dell’ufficioAccesso dall’area riservata della piattaforma
ExportCopia-incolla da file rawCSV strutturato, pronto per la tesoreria

Attiva il Lettore F24 per il tuo Comune

Carica i flussi SOGEI, interroga i versamenti, rendiconta gli incassi. Configurazione immediata, accesso dall’area riservata.

Richiedi Attivazione →