Come Integrare CodiceFiscale.dev in 10 Minuti

Se hai bisogno di verificare codici fiscali o partite IVA nella tua applicazione web, CodiceFiscale.dev offre un’API semplice e veloce per farlo in pochi minuti. In questa guida vedremo come integrare il servizio con una chiamata API utilizzando JavaScript e Node.js, in modo che tu possa iniziare subito.

Perché Usare CodiceFiscale.dev?

L'API di CodiceFiscale.dev permette di:

  • Verificare la validità di un codice fiscale
  • Convalidare i dati anagrafici di una persona (nome, cognome, data di nascita, luogo di nascita)
  • Controllare la validità di una partita IVA e ottenere i dati aziendali associati

Ogni richiesta all’API richiede 1 credito, e hai 50 crediti gratuiti ogni mese, più che sufficienti per testare il servizio o per progetti a basso traffico.

1️⃣ Ottenere una API Key

Per iniziare, registrati su CodiceFiscale.dev e ottieni la tua API Key. Questa chiave sarà necessaria per autenticare le richieste.

2️⃣ Verificare un Codice Fiscale

Il primo passo è verificare se un codice fiscale è valido. Usiamo JavaScript con Node.js per effettuare la chiamata API.

Esempio con Fetch API

const fetch = require('node-fetch');

const API_KEY = 'TUO_API_KEY';
const codiceFiscale = 'ABCDEF12G34H567I';

async function verificaCodiceFiscale() {
    const url = `https://api.codicefiscale.dev/api/v1/verifica/codice-fiscale/${codiceFiscale}`;
    
    const response = await fetch(url, {
        method: 'GET',
        headers: {
            'Authorization': `Bearer ${API_KEY}`
        }
    });

    const data = await response.json();
    console.log(data);
}

verificaCodiceFiscale();

Risultato Atteso

{
  "cf": "ABCDEF12G34H567I",
  "isValid": true
}

Se isValid è true, il codice fiscale è corretto.

3️⃣ Verificare i Dati Anagrafici di una Persona

Puoi anche controllare se un codice fiscale corrisponde a una persona specifica. Basta passare cognome, nome, data di nascita, provincia, comune e sesso.

Esempio con Fetch API

async function verificaDatiPersona() {
    const url = `https://api.codicefiscale.dev/api/v1/verifica/persona/ABCDEF12G34H567I?cognome=Rossi&nome=Giovanni&dataNascita=1990-01-01&provincia=RM&comune=Roma&sesso=M`;

    const response = await fetch(url, {
        method: 'GET',
        headers: {
            'Authorization': `Bearer ${API_KEY}`
        }
    });

    const data = await response.json();
    console.log(data);
}

verificaDatiPersona();

Risultato Atteso

{
  "cf": "ABCDEF12G34H567I",
  "isValid": true
}

Se isValid è true, i dati forniti corrispondono al codice fiscale.

4️⃣ Verificare una Partita IVA

Vuoi verificare la validità di una partita IVA e ottenere informazioni aziendali? Basta usare l’endpoint dedicato.

Esempio con Fetch API

async function verificaPartitaIVA() {
    const url = `https://api.codicefiscale.dev/api/v1/verifica/partita-iva/IT12345678901`;

    const response = await fetch(url, {
        method: 'GET',
        headers: {
            'Authorization': `Bearer ${API_KEY}`
        }
    });

    const data = await response.json();
    console.log(data);
}

verificaPartitaIVA();

Risultato Atteso

{
  "isValid": true,
  "name": "Azienda Esempio Srl",
  "address": "Via Esempio, 123, Milano"
}

Se isValid è true, la partita IVA è registrata e valida.

📖 Consulta la Documentazione Completa

Se vuoi approfondire tutte le funzionalità disponibili e scoprire come integrare CodiceFiscale.dev nella tua applicazione nel modo più efficiente, visita la documentazione ufficiale:

👉 docs.codicefiscale.dev

Qui troverai dettagli sugli altri endpoint disponibili, i parametri supportati e le best practice per l’integrazione.

5️⃣ Conclusione

Come hai visto, integrare CodiceFiscale.dev nella tua applicazione web è facilissimo! Con pochi comandi puoi:
✅ Verificare la validità di un codice fiscale
✅ Controllare che un codice fiscale corrisponda ai dati anagrafici
✅ Controllare la validità di una partita IVA e ottenere i dati aziendali

Ogni richiesta consuma 1 credito, e hai 50 crediti gratuiti ogni mese per testare l’API senza costi.

Inizia subito a usare CodiceFiscale.dev e semplifica la gestione fiscale della tua applicazione! 🚀

Read more