FULL DOCUMENTATION: https://dennisturco.github.io/CodiceFiscale/
A lightweight .NET library for Italian fiscal compliance: validate, parse and generate Codice Fiscale, validate Partita IVA and IBAN, and query a built-in database of Italian municipalities and foreign countries (Belfiore codes). Everything runs locally, no HTTP calls, no data leaves your app.
dotnet add package ItalianFiscalKit- Fiscal code validation (format + checksum)
- Fiscal code generation from personal data
- Cross-check: does this fiscal code match these personal details?
- Italian VAT number validation (standard, public entity, foreign)
- IBAN validation (mod97, all countries)
- Comuni and codici Belfiore embedded dataset (no external files needed)
- Fully tested
-
Validate a fiscal code
using ItalianFiscalKit; bool isValid = FiscalCodeValidator.IsValid("RSSMRA80A01H501U"); // true
-
Generate a fiscal code
string cf = FiscalCodeGenerator.Generate( name: "Mario", surname: "Rossi", dateOfBirth: new DateOnly(1980, 1, 1), gender: Gender.Male, belfioreCode: "H501" // Roma — use MunicipalityExtensions to look up the code ); // "RSSMRA80A01H501U"
-
Cross-check fiscal code against personal data
bool matches = FiscalCodeMatcher.Matches( cf: "RSSMRA80A01H501U", name: "Mario", surname: "Rossi", dateOfBirth: new DateOnly(1980, 1, 1), gender: Gender.Male, belfioreCode: "H501" ); // true
-
Parse a fiscal code
FiscalCodeData parsed = FiscalCodeParser.Parse("RSSMRA80A01H501U"); parsed.Gender // Male parsed.DateOfBirth // 1980-01-01 parsed.BelfioreCode // "H501"
-
Age helpers (extension methods on
FiscalCodeData)int age = parsed.GetAge(); // e.g. 45 bool adult = parsed.IsAdult(); // true if age >= 18
-
Look up a municipality
Municipality? comune = "H501".GetMunicipalityByBelfiore(); // Roma Municipality? byName = "Milano".GetMunicipalityByName(); Municipality? byCAP = "00186".GetMunicipalityByCAP(); IEnumerable<Municipality>? inRoma = "Roma".GetAllByProvince(); // 121 comuni IEnumerable<Municipality> all = MunicipalityExtensions.GetAll(); // ~7 896
-
Validate an Italian VAT number
bool isValid = ItalianVatCodeValidator.IsValid("00484960588", isConsumer: false, isFiscal: false); // true
-
Validate an IBAN
bool isValid = IBANValidator.IsValid("IT60X0542811101000000123456"); // true
- Names with fewer than 3 consonants (Re, Li, Yu)
- Names with apostrophes and accents (D'Amico, Rosà)
- Foreign-born individuals (Belfiore code Z + country number)
- Omocodia (alternate fiscal codes with letters replacing digits)
- VAT numbers for public entities (starting with 8 or 9)
- Obsolete municipalities (comuni soppressi)
Fiscal codes and VAT numbers are personal data. Sending them to a third-party server to validate them raises immediate GDPR concerns. This library validates everything locally. The data never leaves your application.
The comuni/Belfiore dataset is sourced from ISTAT open data and embedded directly in the library binary. No external files are required at runtime.
The dataset is updated with each minor release to reflect municipality changes (merges, renames, new comuni).
Contributions are welcome. If you find a fiscal code that validates incorrectly, please open an issue with:
- The fiscal code (you can anonymise it — just keep the structure)
- The personal data it should/should not match
- The expected result
https://comuni-ita.readme.io/reference/getcomuni
- Fiscal code validation (format + checksum)
- Fiscal code generation from personal data
- Cross-check: does this fiscal code match these personal details?
- Italian VAT number validation (standard, public entity, foreign)
- IBAN validation (mod97, all countries)
- Comuni and codici Belfiore embedded dataset (no external files needed)
- Fully tested
-
Validate a fiscal code
using CodiceFiscale; bool isValid = FiscalCodeValidator.IsValid("RSSMRA80A01H501U"); // true
-
Generate a fiscal code
string cf = FiscalCodeGenerator.Generate( name: "Mario", surname: "Rossi", dateOfBirth: new DateOnly(1980, 1, 1), gender: Gender.Male, belfioreCode: "H501" // Roma — use MunicipalityExtensions to look up the code ); // "RSSMRA80A01H501U"
-
Cross-check fiscal code against personal data
bool matches = FiscalCodeMatcher.Matches( cf: "RSSMRA80A01H501U", name: "Mario", surname: "Rossi", dateOfBirth: new DateOnly(1980, 1, 1), gender: Gender.Male, belfioreCode: "H501" ); // true
-
Parse a fiscal code
FiscalCodeData parsed = FiscalCodeParser.Parse("RSSMRA80A01H501U"); parsed.Gender // Male parsed.DateOfBirth // 1980-01-01 parsed.BelfioreCode // "H501"
-
Age helpers (extension methods on
FiscalCodeData)int age = parsed.GetAge(); // e.g. 45 bool adult = parsed.IsAdult(); // true if age >= 18
-
Look up a municipality
Municipality? comune = "H501".GetMunicipalityByBelfiore(); // Roma Municipality? byName = "Milano".GetMunicipalityByName(); Municipality? byCAP = "00186".GetMunicipalityByCAP(); IEnumerable<Municipality>? inRoma = "Roma".GetAllByProvince(); // 121 comuni IEnumerable<Municipality> all = MunicipalityExtensions.GetAll(); // ~7 896
-
Validate an Italian VAT number
bool isValid = ItalianVatCodeValidator.IsValid("00484960588", isConsumer: false, isFiscal: false); // true
-
Validate an IBAN
bool isValid = IBANValidator.IsValid("IT60X0542811101000000123456"); // true
- Names with fewer than 3 consonants (Re, Li, Yu)
- Names with apostrophes and accents (D'Amico, Rosà)
- Foreign-born individuals (Belfiore code Z + country number)
- Omocodia (alternate fiscal codes with letters replacing digits)
- VAT numbers for public entities (starting with 8 or 9)
- Obsolete municipalities (comuni soppressi)
Fiscal codes and VAT numbers are personal data. Sending them to a third-party server to validate them raises immediate GDPR concerns. This library validates everything locally. The data never leaves your application.
The comuni/Belfiore dataset is sourced from ISTAT open data and embedded directly in the library binary. No external files are required at runtime.
The dataset is updated with each minor release to reflect municipality changes (merges, renames, new comuni).
Contributions are welcome. If you find a fiscal code that validates incorrectly, please open an issue with:
- The fiscal code (you can anonymise it — just keep the structure)
- The personal data it should/should not match
- The expected result