Codice Fiscale Explainer
Decodifica e valida un codice fiscale italiano in pochi secondi. Estrazione algoritmica di data di nascita, sesso, comune (codice Belfiore), rilevamento omocodia e verifica check digit - tutto client-side. Spiegazione narrativa AI opzionale via Ollama on-prem.
Come funziona l'algoritmo
- Cognome (pos. 1-3): Consonanti in ordine, poi vocali, poi X come padding fino a 3 caratteri.
- Nome (pos. 4-6): Se ≥4 consonanti: si usano la 1a, 3a e 4a. Altrimenti come per il cognome.
- Anno (pos. 7-8): Ultime 2 cifre dell'anno di nascita (es. 85 → 1985 o 2085).
- Mese (pos. 9): Lettera da tabella: A=Gen, B=Feb, C=Mar, D=Apr, E=Mag, H=Giu, L=Lug, M=Ago, P=Set, R=Ott, S=Nov, T=Dic.
- Giorno + Sesso (pos. 10-11): Maschio: giorno reale (01-31). Femmina: giorno + 40 (41-71).
- Comune (pos. 12-15): Codice Belfiore del comune di nascita (es. H501 = Roma).
- Check digit (pos. 16): Somma pesata dei primi 15 caratteri con tabelle pari/dispari → resto mod 26 → lettera.
Come utilizzare Codice Fiscale Explainer
Inserisci il codice fiscale da 16 caratteri
Digita o incolla il codice fiscale nel campo di input: viene convertito automaticamente in maiuscolo e limitato a 16 caratteri.
Decodifica il codice
Clicca su "Decodifica CF": la validazione e l'estrazione dei dati (cognome, nome, data di nascita, sesso, comune, check digit) avvengono interamente nel browser, senza inviare nulla al server.
Verifica omocodia e check digit
Il tool segnala se il codice presenta omocodia (lettere al posto di cifre nelle posizioni 7-13) e confronta il check digit dichiarato con quello ricalcolato per validare l'autenticità strutturale.
Genera la spiegazione AI narrativa (opzionale)
Spunta "Genera spiegazione AI narrativa" prima di decodificare per ottenere un riassunto testuale generato da Ollama on-prem, con nessun invio a servizi cloud di terze parti.
Suggerimenti
- Usa questo tool per verificare rapidamente la coerenza tra un codice fiscale ricevuto e i dati anagrafici dichiarati, ad esempio durante un onboarding cliente.
- Se il codice presenta omocodia, il "CF normalizzato" mostrato ripristina le cifre originali solo per il calcolo interno: il codice legale resta sempre quello con le lettere speciali.
- Non serve attivare la spiegazione AI per usi rapidi: la decodifica deterministica è già completa e istantanea, l'AI aggiunge solo un riassunto discorsivo.
Domande frequenti
Come viene calcolato il codice fiscale italiano?
L'algoritmo dell'Agenzia delle Entrate (DM 23 dicembre 1976) combina 3 lettere dal cognome, 3 dal nome, 2 cifre dell'anno di nascita, 1 lettera per il mese, 2 cifre per giorno e sesso (+40 per le donne), 4 caratteri per il comune (codice Belfiore) e 1 check digit calcolato con una somma pesata mod 26.
Cos'è l'omocodia e perché alcuni codici fiscali hanno lettere al posto di numeri?
Quando più persone genererebbero lo stesso codice fiscale (stesso cognome, nome, data di nascita e comune), l'Agenzia delle Entrate sostituisce progressivamente le cifre nelle posizioni 7-13 con lettere speciali (L M N P Q R S T U V) per renderlo univoco. È un codice legale al 100%.
Il codice fiscale che inserisco viene salvato da qualche parte?
No. La validazione e la decodifica avvengono sempre client-side nel tuo browser. Solo se attivi la spiegazione AI narrativa il codice viene inviato al backend, che lo inoltra al modello Ollama installato on-prem sul VPS, senza persistenza né invio a servizi cloud esterni.
Perché il comune non viene sempre riconosciuto per nome?
Il tool usa un lookup locale dei codici Belfiore che copre i comuni più comuni, ma non l'archivio storico completo (inclusi comuni soppressi o esteri). In questi casi viene mostrato comunque il codice a 4 caratteri, con l'indicazione di verificare manualmente sul sito dell'Agenzia delle Entrate.
Cosa significa se il check digit calcolato non coincide con quello del codice inserito?
Significa che il codice fiscale non è strutturalmente valido: potrebbe contenere un errore di battitura, essere stato inventato o corrotto. Ricontrolla i 16 caratteri direttamente dal documento originale (tessera sanitaria o carta d'identità).
Vuoi altri tool per sviluppatori italiani?
Iscriviti alla newsletter di Federico per ricevere aggiornamenti sui nuovi strumenti, articoli tecnici e guide su fiscalità e normativa IT.