CodiceFiscale.js

CodiceFiscale.js is a utility library to compute and validate Italian Italian Tax code (codice fiscale).

Usage

Compute

Compute a codice fiscale given:

• Name (String)
• Surname (String)
• Gender (String) ["M","F"]
• Birthday day (Number)
• Birthday month (Number)
• Birthday year (Number)
• Place of birth (String)
• Province of birth (String)

var cf = CodiceFiscale.compute("Enzo","Righi","M",24,7,1957,"Napoli", "NA");

or

var cf = CodiceFiscale.compute({
    name: "Enzo",
    surname: "Righi",
    gender: "M",
    day: 24,
    month: 7,
    year: 1957,
    birthplace: "Napoli", 
    birthplace_provincia: "NA"});

NEW Added support for foreign countries

Use the italian name of the foreign country (e.g. Francia, for France) as birthplace and "EE" as birthplace_provincia

var cf = CodiceFiscale.compute("Enzo","Righi","M",24,7,1957,"Francia", "EE");

or

var cf = CodiceFiscale.compute({
    name: "Enzo",
    surname: "Righi",
    gender: "M",
    day: 24,
    month: 7,
    year: 1957,
    birthplace: "Francia", 
    birthplace_provincia: "EE"});

Inverse Computation

Get a person data for a given Codice Fiscale. It returns an object:

• Name (String)
• Surname (String)
• Gender (String)
• Birthday day (Number)
• Birthday month (Number)
• Birthday year [Number]
• Place of birth (String)
• Province of birth (String)

var personData = CodiceFiscale.computeInverse("RGHNZE10L24F839E");

// personData
{
    name: "NZE",
    surname: "RGH",
    gender: "M",
    day: 24,
    month: 7
    year: [1910, 2010],
    birthplace: "NAPOLI",
    birthplace_provincia: "NA"
}

Check

Check if a codice fiscale is valid. It returns a boolean value.

var isValid = CodiceFiscale.check("VNDLDL10A01G410Z");

Omocodie

Get all the omocodie for a given Codice Fiscale. It returns an array of strings

var omocodie = CodiceFiscale.getOmocodie("VNDLDL10A01G410Z");

Available npm scripts:

• npm run build: build the bundle into dist directory.
• npm run test: launch the karma tests.