Calcola codice fiscale italiano da dati personali

Calcola un codice fiscale italiano a partire da dati reali: nome, cognome, sesso, data e luogo di nascita. Per nascite in Italia occorre anche indicare provincia e comune così da risolvere il corretto codice Belfiore dal registro ufficiale.

Algoritmo di codifica

Il codice di 16 caratteri viene assemblato in questo ordine:

• Caratteri 1–3 (cognome) — consonanti in ordine, poi vocali; riempire con X fino a tre lettere.
• Caratteri 4–6 (nome) — con quattro o più consonanti, posizioni 1, 3 e 4; altrimenti la stessa regola del cognome.
• Caratteri 7–8 (anno) — ultime due cifre dell’anno di nascita.
• Carattere 9 (mese) — lettera A–L per i mesi 1–12 (si salta la lettera I).
• Caratteri 10–11 (giorno) — giorno a due cifre; aggiungere 40 per il sesso femminile prima del riempimento con zeri.
• Caratteri 12–15 (luogo) — codice Belfiore a quattro caratteri per i comuni italiani, oppure il codice dello Stato estero se la nascita è avvenuta all’estero.
• Carattere 16 (controllo) — lettera di controllo calcolata sui primi 15 caratteri con la tabella ufficiale di pesatura dispari/pari.

Quando usarlo

Utile per ricontrollare un codice digitato a mano, costruire flussi di onboarding, o capire come le regole su nome e dati di nascita si mappano su ogni segmento dell’identificativo.

Limitazioni

Il calcolatore riproduce solo l’algoritmo di formattazione. Non può confermare che un codice sia stato effettivamente assegnato dall’Agenzia delle Entrate né che la persona esista nei registri anagrafici. Nomi con caratteri rari, casi limite di traslitterazione o fusioni storiche di comuni possono differire dalle assegnazioni ufficiali.

Esempio

Ad esempio, inserisci i valori di esempio predefiniti nel modulo e confronta l’output con un riferimento noto; modifica un input alla volta per vedere come cambia il risultato.

Questa skill è disponibile via A2A JSON-RPC e REST. Se conosci già skillId ed export, chiama execute direttamente—senza discovery.

Esempio REST

curl -sS -X POST https://toolplaza.app/api/helpers/execute \
  -H 'Content-Type: application/json' \
  -d '{"skillId":"fiscal-code__calculate","export":"calculateItalianFiscalCode","args":[10,20]}'

Esempio A2A JSON-RPC

Send POST https://toolplaza.app/api/a2a with:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "message": {
      "messageId": "uuid",
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "ignored"
        }
      ]
    },
    "metadata": {
      "toolplaza": {
        "skillId": "fiscal-code__calculate",
        "export": "calculateItalianFiscalCode",
        "args": [
          10,
          20
        ]
      }
    }
  }
}

Guida completa Agent API · Schema della skill