App codice fiscale, Excel e API: strumenti per calcolarlo

Come usare lo strumento di estrazione massiva

Lo strumento legge un elenco di codici fiscali e, per ognuno, ricava data di nascita, età, sesso e luogo di nascita e controlla l’ultima lettera. È gratuito, non richiede registrazione e funziona anche dal telefono.

1. Incolla i codici fiscali, uno per riga. Puoi copiare un’intera colonna da Excel, LibreOffice Calc o Google Sheets; in alternativa premi «Carica file CSV».
2. Premi «Estrai dati». Il calcolo richiede pochi secondi anche con migliaia di codici.
3. Leggi la tabella. Per ogni codice trovi data di nascita, età, sesso, comune o Stato estero di nascita e l’esito del controllo.
4. Porta i risultati in Excel. Con «Copia per Excel» e poi Incolla ogni dato finisce nella sua colonna; «Scarica CSV» crea un file che si apre direttamente in Excel in italiano.

Esempio con dati di fantasia

Tutto il calcolo avviene nel tuo browser: i codici inseriti non vengono salvati sui nostri server e non vengono inviati a nessuno, un aspetto importante quando l’elenco contiene dati di dipendenti, clienti o studenti (GDPR). Per questo lo strumento è adatto a uffici del personale, commercialisti, scuole e associazioni.

Cosa lo strumento non fa

• Non ricava nome e cognome: le prime sei lettere non permettono di ricostruirli.
• Non dice se un codice esiste: «Scritto correttamente» significa che il codice rispetta le regole di calcolo. Per sapere se è attribuito a una persona serve la verifica ufficiale dell’Agenzia delle Entrate, spiegata nella guida alla verifica del codice fiscale.
• Non spiega un codice nel dettaglio: per leggere un solo codice parte per parte usa il codice fiscale inverso.

App e programmi per il codice fiscale

Per calcolare il codice fiscale non serve scaricare un’app o un programma: il calcolatore online funziona su Android, iPhone, Windows, Mac e Linux, direttamente nel browser. Le app servono soprattutto per avere a portata di mano il proprio codice fiscale, non per calcolarlo.

Serve davvero un’applicazione per il codice fiscale?

• Per calcolare un codice: no. Apri il calcolo codice fiscale dal browser. Su Android (Chrome) usa «Aggiungi a schermata Home», su iPhone (Safari) «Aggiungi alla schermata Home»: avrai un’icona come un’app, senza installare niente.
• Per avere il tuo codice sempre con te: l’app IO mostra la tessera sanitaria digitale con il codice fiscale e il codice a barre.
• Per controllare un codice: usa la verifica codice fiscale.

Programmi e software da scaricare

Esistono programmi gratuiti e app per il calcolo del codice fiscale per Windows, Android e Linux. Prima di scaricarne uno controlla:

• Aggiornamento dei comuni: è la parte più importante. Un programma vecchio non conosce i comuni nati da fusioni recenti e può dare il codice catastale sbagliato.
• Privacy: un’app che chiede permessi inutili (contatti, posizione) o salva i tuoi dati su un server non è necessaria per un calcolo.
• Provenienza: scarica solo da store ufficiali o dal sito dello sviluppatore.

Un buon calcolatore gestisce anche il codice fiscale degli stranieri e permette di stampare il risultato, come il nostro. L’Agenzia delle Entrate non distribuisce un software ufficiale per calcolare il codice fiscale.

Scaricare il proprio codice fiscale

Chi vuole «scaricare il codice fiscale» di solito cerca un documento con il proprio codice, non un programma:

1. Accedi all’area riservata. Dell’Agenzia delle Entrate o del portale Sistema Tessera Sanitaria, con SPID, CIE o CNS.
2. Scarica la copia della tessera. In PDF, fronte e retro; in ufficio puoi chiedere anche il certificato di attribuzione del codice fiscale.
3. In alternativa usa l’app IO. Mostra la tessera sanitaria digitale.

Una stampa fatta con un calcolatore online è solo un promemoria: trovi la differenza nella guida su codice fiscale e tessera sanitaria.

Codice fiscale in Excel e Calc

Con poche formule Excel puoi ricavare dal codice fiscale la data di nascita, l’età, il sesso e il codice del comune, e controllare se l’ultima lettera è giusta. Le formule sono state verificate su codici di esempio (ad esempio FRRGLI85C54F839R → 14/03/1985, donna, F839).

In tutte le formule il codice fiscale è nella cella A2, in maiuscolo. Trascina la formula verso il basso per elaborare un intero elenco: funziona anche su migliaia di righe, in Excel, in LibreOffice Calc e in Google Sheets. Non vuoi usare formule? Incolla la colonna dei codici nello strumento di estrazione massiva in cima alla pagina e copia i risultati in Excel.

Formula Excel per la data di nascita dal codice fiscale

=DATA(SE(VALORE(STRINGA.ESTRAI(A2;7;2))>ANNO(OGGI())-2000;1900;2000)+VALORE(STRINGA.ESTRAI(A2;7;2));TROVA(STRINGA.ESTRAI(A2;9;1);"ABCDEHLMPRST");RESTO(VALORE(STRINGA.ESTRAI(A2;10;2));40))

=DATE(IF(VALUE(MID(A2,7,2))>YEAR(TODAY())-2000,1900,2000)+VALUE(MID(A2,7,2)),FIND(MID(A2,9,1),"ABCDEHLMPRST"),MOD(VALUE(MID(A2,10,2)),40))

Come funziona:

• Anno: caratteri 7–8. Se il numero è maggiore delle ultime due cifre dell’anno in corso, l’anno è del Novecento (85 → 1985), altrimenti del Duemila (00 → 2000).
• Mese: carattere 9, cercato nella stringa delle lettere dei mesi «ABCDEHLMPRST» (C → 3, marzo).
• Giorno: caratteri 10–11; il resto della divisione per 40 toglie il +40 delle donne (54 → 14).

Formatta la cella come data. Una persona nata più di 100 anni fa verrebbe letta come nata nel Duemila: per gli archivi storici sostituisci ANNO(OGGI())-2000 con un anno limite a tua scelta.

Età, sesso e comune dal codice fiscale in Excel

Se la data di nascita è nella cella B2:

Per avere il nome del comune al posto del codice (F839 → Napoli) serve un foglio con l’elenco dei codici catastali e un CERCA.VERT (VLOOKUP); i codici sono quelli dei comuni per il codice fiscale, pubblicati dall’ISTAT.

Nome e cognome, invece, non si possono estrarre dal codice fiscale: le prime sei lettere sono solo consonanti e vocali scelte. Il calcolo inverso completo (data, sesso, luogo) lo fai anche online con il codice fiscale inverso.

Controllare l’ultima lettera in Excel

Questa formula dice se il carattere di controllo, la 16ª lettera, è giusto. Funziona anche con i codici omocodici.

=IF(CHAR(65+MOD(SUMPRODUCT(CODE(MID("BAFHJNPRTVBAFHJNPRTVCESULDGIMOQKWZYX",FIND(MID(A2,ROW($1:$8)*2-1,1),"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"),1))-65)+SUMPRODUCT(CODE(MID("ABCDEFGHIJABCDEFGHIJKLMNOPQRSTUVWXYZ",FIND(MID(A2,ROW($1:$7)*2,1),"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"),1))-65),26))=RIGHT(A2,1),"Valido","Non valido")

=SE(CODICE.CARATT(65+RESTO(MATR.SOMMA.PRODOTTO(CODICE(STRINGA.ESTRAI("BAFHJNPRTVBAFHJNPRTVCESULDGIMOQKWZYX";TROVA(STRINGA.ESTRAI(A2;RIF.RIGA($1:$8)*2-1;1);"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ");1))-65)+MATR.SOMMA.PRODOTTO(CODICE(STRINGA.ESTRAI("ABCDEFGHIJABCDEFGHIJKLMNOPQRSTUVWXYZ";TROVA(STRINGA.ESTRAI(A2;RIF.RIGA($1:$7)*2;1);"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ");1))-65);26))=DESTRA(A2;1);"Valido";"Non valido")

La prima stringa lunga contiene i valori della tabella dei caratteri dispari, la seconda quelli dei caratteri pari, scritti come lettere (A = 0, B = 1…). La formula somma i valori, divide per 26 e confronta il resto con l’ultima lettera. «Valido» vuol dire solo che il codice è scritto in modo coerente, non che esiste: per quello serve la verifica dell’Agenzia delle Entrate.

Calcolo del codice fiscale in Excel con una macro VBA

Per far calcolare il codice fiscale a Excel partendo dai dati anagrafici conviene una funzione VBA, perché la formula sarebbe troppo lunga. Apri l’editor VBA (Alt + F11), inserisci un modulo e incolla:

Function CODICEFISCALE(cognome As String, nome As String, nascita As Date, sesso As String, luogo As String) As String
  Dim cf As String, g As Integer
  g = Day(nascita) + IIf(UCase(sesso) = "F", 40, 0)
  cf = TreLettere(cognome, False) & TreLettere(nome, True) & Right(CStr(Year(nascita)), 2) _
     & Mid("ABCDEHLMPRST", Month(nascita), 1) & Format(g, "00") & UCase(luogo)
  CODICEFISCALE = cf & Controllo(cf)
End Function

Private Function TreLettere(ByVal s As String, isNome As Boolean) As String
  Dim i As Integer, c As String, cons As String, voc As String
  s = UCase(s)
  For i = 1 To Len(s)
    c = Mid(s, i, 1)
    Select Case c
      Case "A", "E", "I", "O", "U": voc = voc & c
      Case "À", "È", "É", "Ì", "Ò", "Ù": voc = voc & Mid("AEEIOU", InStr("ÀÈÉÌÒÙ", c), 1)
      Case "B" To "Z": cons = cons & c
    End Select
  Next i
  If isNome And Len(cons) >= 4 Then
    TreLettere = Mid(cons, 1, 1) & Mid(cons, 3, 1) & Mid(cons, 4, 1)
  Else
    TreLettere = Left(cons & voc & "XXX", 3)
  End If
End Function

Private Function Controllo(cf15 As String) As String
  Const T = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"
  Const D = "BAFHJNPRTVBAFHJNPRTVCESULDGIMOQKWZYX"
  Const P = "ABCDEFGHIJABCDEFGHIJKLMNOPQRSTUVWXYZ"
  Dim i As Integer, s As Integer, k As Integer
  For i = 1 To 15
    k = InStr(T, Mid(cf15, i, 1))
    If i Mod 2 = 1 Then s = s + Asc(Mid(D, k, 1)) - 65 Else s = s + Asc(Mid(P, k, 1)) - 65
  Next i
  Controllo = Chr(65 + s Mod 26)
End Function

Uso nel foglio: =CODICEFISCALE("Ferrari";"Giulia";DATA(1985;3;14);"F";"F839") → FRRGLI85C54F839R. Il codice del comune (F839) va inserito a mano o con un CERCA.VERT sull’elenco dei comuni. Salva il file come .xlsm (cartella di lavoro con macro).

Nota di trasparenza: la macro VBA è la traduzione riga per riga delle funzioni JavaScript e Python qui sotto, che abbiamo testato; la macro in sé non è stata eseguita in Excel, quindi provala su un codice noto prima di usarla.

LibreOffice, OpenOffice e Google Sheets

Le formule usano solo funzioni standard, presenti anche in LibreOffice Calc, OpenOffice Calc e Google Sheets: in Google Sheets usa la versione in inglese, in Calc con l’interfaccia in italiano i nomi italiani e il punto e virgola. Le macro VBA, invece, in Calc vanno adattate a LibreOffice Basic.

API e codice per sviluppatori

Per inserire il calcolo o la verifica del codice fiscale in un sito o in un gestionale bastano poche righe di codice: l’algoritmo è pubblico (DM 23 dicembre 1976) e non serve un’API esterna.

L’algoritmo in breve

1. Cognome e nome. Tre lettere ciascuno: consonanti, poi vocali, poi X; per il nome con 4 o più consonanti la 1ª, la 3ª e la 4ª.
2. Data e sesso. Due cifre dell’anno, lettera del mese, giorno (+40 per le donne).
3. Luogo. Codice catastale del comune o codice dello Stato estero (Z…).
4. Controllo. Somma dei valori dei caratteri in posizione dispari e pari, resto della divisione per 26, convertito in lettera.

Tutti i passaggi spiegati con esempi sono nella guida su come funziona il codice fiscale.

Funzione JavaScript

Calcolo e verifica in JavaScript, utilizzabili nel browser o in Node.js:

const DISPARI = {0:1,1:0,2:5,3:7,4:9,5:13,6:15,7:17,8:19,9:21,A:1,B:0,C:5,D:7,E:9,F:13,G:15,H:17,I:19,J:21,K:2,L:4,M:18,N:20,O:11,P:3,Q:6,R:8,S:12,T:14,U:16,V:10,W:22,X:25,Y:24,Z:23};
const MESI = "ABCDEHLMPRST";
function carattereControllo(cf15) {
  let s = 0;
  for (let i = 0; i < 15; i++) {
    const c = cf15[i];
    if (i % 2 === 0) s += DISPARI[c];
    else s += /[0-9]/.test(c) ? Number(c) : c.charCodeAt(0) - 65;
  }
  return String.fromCharCode(65 + s % 26);
}
function lettere(str, isNome) {
  str = str.toUpperCase().normalize("NFD").replace(/[^A-Z]/g, "");
  const cons = str.replace(/[AEIOU]/g, ""), voc = str.replace(/[^AEIOU]/g, "");
  if (isNome && cons.length >= 4) return cons[0] + cons[2] + cons[3];
  return (cons + voc + "XXX").slice(0, 3);
}
function calcolaCodiceFiscale(cognome, nome, anno, mese, giorno, sesso, codiceLuogo) {
  const g = sesso === "F" ? giorno + 40 : giorno;
  const cf15 = lettere(cognome, false) + lettere(nome, true) + String(anno).slice(-2)
    + MESI[mese - 1] + String(g).padStart(2, "0") + codiceLuogo.toUpperCase();
  return cf15 + carattereControllo(cf15);
}
function verificaCodiceFiscale(cf) {
  cf = cf.toUpperCase().trim();
  if (!/^[A-Z]{6}[0-9LMNPQRSTUV]{2}[ABCDEHLMPRST][0-9LMNPQRSTUV]{2}[A-Z][0-9LMNPQRSTUV]{3}[A-Z]$/.test(cf)) return false;
  return carattereControllo(cf.slice(0, 15)) === cf[15];
}

// calcolaCodiceFiscale("Ferrari", "Giulia", 1985, 3, 14, "F", "F839") → "FRRGLI85C54F839R"

L’espressione regolare nella funzione di verifica controlla il formato e accetta anche i codici omocodici, con lettere al posto delle cifre. La funzione toglie accenti, spazi e apostrofi da nomi e cognomi (Marco Antonio, De Santis, D’Angelo).

Funzione Python

import re, unicodedata
DISPARI = dict(zip("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ",
    [1,0,5,7,9,13,15,17,19,21,1,0,5,7,9,13,15,17,19,21,2,4,18,20,11,3,6,8,12,14,16,10,22,25,24,23]))
MESI = "ABCDEHLMPRST"
def carattere_controllo(cf15):
    s = 0
    for i, c in enumerate(cf15):
        s += DISPARI[c] if i % 2 == 0 else (int(c) if c.isdigit() else ord(c) - 65)
    return chr(65 + s % 26)
def lettere(testo, nome=False):
    testo = re.sub(r"[^A-Z]", "", unicodedata.normalize("NFD", testo.upper()))
    cons, voc = re.sub(r"[AEIOU]", "", testo), re.sub(r"[^AEIOU]", "", testo)
    if nome and len(cons) >= 4:
        return cons[0] + cons[2] + cons[3]
    return (cons + voc + "XXX")[:3]
def calcola_codice_fiscale(cognome, nome, anno, mese, giorno, sesso, codice_luogo):
    g = giorno + 40 if sesso == "F" else giorno
    cf15 = (lettere(cognome) + lettere(nome, True) + str(anno)[-2:]
            + MESI[mese - 1] + f"{g:02d}" + codice_luogo.upper())
    return cf15 + carattere_controllo(cf15)
def verifica_codice_fiscale(cf):
    cf = cf.upper().strip()
    if not re.fullmatch(r"[A-Z]{6}[0-9LMNPQRSTUV]{2}[ABCDEHLMPRST][0-9LMNPQRSTUV]{2}[A-Z][0-9LMNPQRSTUV]{3}[A-Z]", cf):
        return False
    return carattere_controllo(cf[:15]) == cf[15]

# calcola_codice_fiscale("Ferrari", "Giulia", 1985, 3, 14, "F", "F839") → "FRRGLI85C54F839R"

Funzione PHP (verifica)

In un modulo PHP o in un plugin per WordPress, la verifica lato server è la parte più utile:

function carattereControllo(string $cf15): string {
  $dispari = array_combine(str_split("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"),
    [1,0,5,7,9,13,15,17,19,21,1,0,5,7,9,13,15,17,19,21,2,4,18,20,11,3,6,8,12,14,16,10,22,25,24,23]);
  $s = 0;
  for ($i = 0; $i < 15; $i++) {
    $c = $cf15[$i];
    $s += ($i % 2 === 0) ? $dispari[$c] : (ctype_digit($c) ? (int)$c : ord($c) - 65);
  }
  return chr(65 + $s % 26);
}

function verificaCodiceFiscale(string $cf): bool {
  $cf = strtoupper(trim($cf));
  if (!preg_match('/^[A-Z]{6}[0-9LMNPQRSTUV]{2}[ABCDEHLMPRST][0-9LMNPQRSTUV]{2}[A-Z][0-9LMNPQRSTUV]{3}[A-Z]$/', $cf)) {
    return false;
  }
  return carattereControllo(substr($cf, 0, 15)) === $cf[15];
}

// verificaCodiceFiscale("FRRGLI85C54F839R") → true

Richiede PHP 7.3 o successivo. È la stessa logica delle funzioni JavaScript e Python testate, riga per riga; prima di metterla in produzione provala con un codice noto, ad esempio FRRGLI85C54F839R.

Altri linguaggi e gestionali

La logica è la stessa in ogni linguaggio: una tabella dei valori dispari, la somma, il resto per 26. Puoi tradurre la funzione JavaScript in Java, C#, SQL o qualsiasi altro linguaggio; in Access e in VB.NET la macro VBA vista sopra funziona quasi senza modifiche. Nei gestionali, se compare un errore di calcolo del codice fiscale, di solito manca il modulo di localizzazione italiana o l’elenco dei comuni è vecchio.

Tre consigli per chi sviluppa:

• Verifica, non calcolare, quando l’utente inserisce il proprio codice: il calcolo non conosce l’omocodia, quindi un codice ufficiale diverso da quello calcolato non è per forza sbagliato.
• Elenco dei comuni aggiornato: usa i dati ISTAT per i codici catastali, compresi comuni soppressi e fusioni.
• Privacy (GDPR): il codice fiscale è un dato personale. Fai il calcolo lato client quando puoi e non salvare i dati se non servono.

Esiste un’API ufficiale per il codice fiscale?

No: l’Agenzia delle Entrate non offre un’API pubblica gratuita per calcolare il codice fiscale. Offre il servizio web di verifica, pensato per l’uso manuale, e servizi di cooperazione applicativa per gli enti autorizzati. Il VIES della Commissione europea verifica solo le partite IVA, non il codice fiscale delle persone. Esistono API di terze parti per il calcolo e il calcolo inverso, ma per la maggior parte dei siti le funzioni qui sopra bastano e non inviano dati a nessuno.

Errori comuni

1. Usare la formula della data su un codice omocodico. Prima vanno convertite le lettere in cifre (L=0, M=1 … V=9).
2. Pensare di estrarre nome e cognome dal codice fiscale in Excel.
3. Dimenticare il +40 delle donne quando si calcola il giorno.
4. Usare elenchi dei comuni vecchi in un programma o in un foglio Excel.
5. Rifiutare un codice ufficiale perché diverso da quello calcolato. Può essere un caso di omocodia.
6. Scaricare app sconosciute che chiedono permessi o salvano i dati.

Domande frequenti