DEV Community

Pedro Sardi
Pedro Sardi

Posted on AI-assisted

Perché i codici fiscali di Faker non passano la validazione (e come risolvere)

Se sviluppi software per il mercato italiano, prima o poi scrivi una factory così:

'codice_fiscale' => fake('it_IT')->taxId(),
'iban' => fake('it_IT')->iban('IT'),
Enter fullscreen mode Exit fullscreen mode

E poi aggiungi una validazione seria al form, come è giusto che sia. A quel punto i test iniziano a fallire. Non sempre: quasi sempre.

Ho misurato quanto spesso, generando 10.000 valori con il provider it_IT di Faker e controllandoli con un validatore completo:

Valore Validi
Codice fiscale (taxId()) 1,1%
IBAN italiano (iban('IT')) 3,6%
Partita IVA (vat()) 84,3%

Vediamo perché.

Il codice fiscale non è una stringa casuale

Faker genera il codice fiscale con un semplice schema di lettere e cifre:

// Faker\Provider\it_IT\Person
public static function taxId()
{
    return strtoupper(static::bothify('??????##?##?###?'));
}
Enter fullscreen mode Exit fullscreen mode

Il risultato ha la forma giusta, ma il contenuto no. Alcuni esempi reali:

TUROAS92L62Z558R  → carattere di controllo sbagliato
GNCYKS46A60N219M  → carattere di controllo sbagliato
WFRJKY67I92H299I  → "I" non è un mese valido, e il giorno 92 non esiste
Enter fullscreen mode Exit fullscreen mode

Un codice fiscale vero ha una struttura precisa:

Caratteri Significato
1–3 consonanti (e vocali) del cognome
4–6 consonanti (e vocali) del nome
7–8 anno di nascita
9 mese, con una lettera tra ABCDEHLMPRST
10–11 giorno di nascita, +40 per le donne
12–15 codice catastale del comune o dello stato estero (es. H501 Roma)
16 carattere di controllo

L'ultimo carattere si calcola dai primi 15 con una tabella di valori per le posizioni dispari e una per le pari, poi il resto della divisione per 26. Una stringa casuale lo indovina una volta su 26, e deve anche avere un mese e un giorno validi: da qui l'1,1%.

L'IBAN italiano ha un controllo in più

Per un IBAN qualsiasi basta il controllo internazionale (modulo 97) sulle due cifre dopo IT, e Faker lo calcola correttamente. Ma gli IBAN italiani hanno anche il CIN: la lettera subito dopo le cifre di controllo, calcolata da ABI, CAB e numero di conto con lo stesso algoritmo del codice fiscale.

IT96 C376 4097 024Y 249W 526M 7NJ
     ^
     CIN casuale: dovrebbe essere X
Enter fullscreen mode Exit fullscreen mode

Faker mette una lettera a caso, quindi indovina circa una volta su 26. I validatori "solo modulo 97" lo accettano, quelli italiani (molti gestionali e i moduli delle banche) no.

La partita IVA quasi ci arriva

Per la partita IVA Faker calcola la cifra di controllo (un algoritmo simile a Luhn), ma sceglie il codice ufficio, le cifre 8–10, tra 001 e 121. I codici validi sono 001–100, più 120, 121, 888 e 999: le partite IVA con un ufficio tra 101 e 119 non esistono. Da qui l'84%.

La soluzione: faker-italia

Ho raccolto gli algoritmi corretti in un pacchetto open source, faker-italia:

composer require --dev generatore-dati/faker-italia
Enter fullscreen mode Exit fullscreen mode
use GeneratoreDati\FakerItalia\FakerProvider;

$faker = Faker\Factory::create('it_IT');
$faker->addProvider(new FakerProvider($faker));

$faker->codiceFiscale();                         // "GRCCHR58E68L219K"
$faker->codiceFiscale('F', '1990-05-12', 'F205'); // donna, nata a Milano il 12/05/1990
$faker->partitaIva();                            // "10446710534"
$faker->ibanItaliano();                          // "IT31E5666885391743795602475"
Enter fullscreen mode Exit fullscreen mode

E se ti servono dati coerenti tra loro, per esempio per un'anagrafica:

$faker->personaItaliana();
// [
//     'nome' => 'Chiara', 'cognome' => 'Greco', 'sesso' => 'F',
//     'data_nascita' => '1958-05-28', 'luogo_nascita' => 'Torino',
//     'codice_catastale' => 'L219', 'codice_fiscale' => 'GRCCHR58E68L219K',
// ]
Enter fullscreen mode Exit fullscreen mode

Con Laravel

Il provider si registra da solo, quindi funziona subito nelle factory:

public function definition(): array
{
    $persona = fake()->personaItaliana();

    return [
        'nome' => $persona['nome'],
        'cognome' => $persona['cognome'],
        'codice_fiscale' => $persona['codice_fiscale'],
        'partita_iva' => fake()->partitaIva(),
        'iban' => fake()->ibanItaliano(),
    ];
}
Enter fullscreen mode Exit fullscreen mode

E include le regole di validazione per i form:

use GeneratoreDati\FakerItalia\Laravel\Rules\CodiceFiscale;
use GeneratoreDati\FakerItalia\Laravel\Rules\Iban;
use GeneratoreDati\FakerItalia\Laravel\Rules\PartitaIva;

$request->validate([
    'codice_fiscale' => ['required', new CodiceFiscale],
    'partita_iva' => ['nullable', new PartitaIva],
    'iban' => ['required', new Iban(onlyItalian: true)],
]);
Enter fullscreen mode Exit fullscreen mode

Le regole gestiscono anche l'omocodia (i codici fiscali in cui alcune cifre sono sostituite da lettere) e il prefisso IT della partita IVA.

Senza scrivere codice

Se ti serve solo un file di dati al volo (per un import, una demo o un database di staging), gli stessi algoritmi sono disponibili gratis anche online su generatore-dati.it.

Tutto avviene nel browser: i dati inseriti non vengono inviati a nessun server.

In sintesi

  • taxId() di Faker genera stringhe con la forma di un codice fiscale, ma valide solo nell'1% dei casi.
  • Gli IBAN italiani di Faker superano il controllo internazionale ma quasi mai quello del CIN.
  • Se la tua applicazione valida questi campi, usa dati generati con gli algoritmi veri: i test smettono di fallire a caso.

Il pacchetto è MIT: suggerimenti, issue e pull request sono benvenuti su GitHub.

Top comments (0)