Lettore F24 Tributi

Lettore F24 Tributi
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 G1 · G2 · G5 · G9
Tributi IMU · TARI · TEFA · TASI
Architettura Multi-Comune
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 i portali Entratel/Fisconline e SIATEL/PuntoFisco, 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 G1, G2, G5, G9

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. I quattro tipi principali utilizzati nella rendicontazione dei tributi locali sono:

Tipo RecordContenutoCampi principali
G1Sezione Erario e Regioni — versamenti per tributi erariali, addizionali regionali e comunali IRPEFCF, codice tributo, anno/periodo, importo a debito, importo a credito, data versamento
G2Sezione IMU e altri tributi locali — versamenti IMU, TARI, TASI, TEFA, contributi di soggiornoCF, codice tributo, codice ente, anno, numero immobili, importo a debito, acconto/saldo
G5Sezione INPS e altri enti — bonifici e versamenti a enti previdenziali, ma utile per alcune tipologie di pagamento localeCF, codice sede, periodo, importo, causale
G9Record di riepilogo — totale del modello F24 compilato dal contribuenteCF, totale versato, saldo netto, data operazione, banca/posta

La complessità della decodifica

Il record G2 — il più rilevante per i tributi comunali — contiene circa 300 caratteri per record, 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
300+Caratteri per record G2
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 2.000 file F24 in un’unica operazione. Il parser — conforme al tracciato SOGEI vigente — decodifica automaticamente ogni tipo di record (G1, G2, G5, G9), 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: totale incassato per tributo, distribuzione temporale dei versamenti, top codici tributo per importo, distribuzione acconto/saldo per l’IMU. Ogni dato è filtrabile per periodo, codice tributo, contribuente.

Ricerca avanzata

La funzione di ricerca consente di interrogare l’intero database dei versamenti per codice fiscale, codice tributo, range di date, range di importo, tipo di record. Il risultato è esportabile in CSV per ulteriori elaborazioni. La ricerca su centinaia di migliaia di record avviene in tempo reale, senza attese.

Architettura multi-Comune

Il sistema supporta nativamente la gestione multi-ente: ogni Comune opera in un ambiente isolato, con i propri file e i propri dati. L’operatore vede solo i dati del proprio Comune, ma l’infrastruttura consente la gestione centralizzata di più enti da parte del fornitore di servizi.

Export strutturato. Ogni vista della dashboard è esportabile in CSV. 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 (G1/G2/G5/G9) 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) e i duplicati vengono identificati e gestiti.
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 2.000 file in una sessione
DecodificaManuale o con script non manutenutiParser SOGEI-conforme, aggiornato
RicercaCtrl+F su file di testoFull-text su database indicizzato, risultati in tempo reale
RendicontoFogli Excel manuali, soggetti a erroriAutomatico per tributo, periodo, contribuente
Multi-EnteGestione separata per ogni ComuneArchitettura multi-tenant nativa
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, architettura multi-Comune.

Richiedi Attivazione →