CodiceFiscale

A .NET Core library to calculate and validate the Italian Tax Code (Codice Fiscale)

Table of Contents

• Description
• Installation
• Usage
• Contributing
• License
• Acknowledgments

Description

The CodiceFiscale library provides an easy-to-use interface for generating and validating the Italian Tax Code based on personal data such as name, surname, date of birth, and city of birth.

It is designed for .NET developers who need to work with the Italian Tax Code in applications like tax management, user registration, and government service integrations.

Installation

You can install the CodiceFiscale library via NuGet Package Manager:

dotnet add package CodiceFiscale --version X.X.X

Or by adding the following to your .csproj:

<PackageReference Include="CodiceFiscale" Version="X.X.X" />

Once installed, restore the packages:

dotnet restore

Usage

Here’s a few examples of how to use the library:

Generate a Codice Fiscale

using CodiceFiscaleLib.Helpers;

string result = 
.Encode("Rossi", "Mario", 'M', new DateTime (1980, 5, 20), "Milano");

Console.WriteLine($"Generated Codice Fiscale: {result}");

Decode a Codice Fiscale

using CodiceFiscaleLib.Helpers;

// decode
var decoded = DecodingHelper.Decode(code);

// get the dictionary
var decodedDict = (Dictionary<string, string>)decoded["raw"];

// access the value
string firstName = decodedDict["firstname"];

Console.WriteLine($"Decoded Codice Fiscale First Name: {firstName}");

Validate a Codice Fiscale

using CodiceFiscaleLib.Helpers;

bool isValid = DecodingHelper.IsValid("RSSMRA80E20F205I");

Console.WriteLine($"Is valid Codice Fiscale: {isValid}");

Contributing

Contributions are welcome! If you'd like to contribute to this project, please follow these steps:

1. Fork the repository
2. Create a new branch (git checkout -b feature/your-feature)
3. Commit your changes (git commit -am 'Add new feature')
4. Push the branch (git push origin feature/your-feature)
5. Open a Pull Request

Please ensure all pull requests pass the existing tests and include new tests for any added functionality

License

This project is licensed under the GPL-3.0 License. See the LICENSE file for more details

Acknowledgments

Special thanks to all contributors and resources that made this project possible