1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
# codicefiscale.py - library for Italian fiscal code
#
# This file is based on code from pycodicefiscale, a Python library for
# working with Italian fiscal code numbers officially known as Italy's
# Codice Fiscale.
# https://github.com/baxeico/pycodicefiscale
#
# Copyright (C) 2009-2013 Emanuele Rocca
# Copyright (C) 2014 Augusto Destrero
# Copyright (C) 2014-2020 Arthur de Jong
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
# 02110-1301 USA
"""Codice Fiscale (Italian tax code for individuals).
The Codice Fiscale is an alphanumeric code of 16 characters used to identify
individuals residing in Italy or 11 digits for non-individuals in which case
it matches the Imposta sul valore aggiunto.
The 16 digit number consists of three characters derived from the person's
last name, three from the person's first name, five that hold information on
the person's gender and birth date, four that represent the person's place of
birth and one check digit.
More information:
* https://it.m.wikipedia.org/wiki/Codice_fiscale
>>> validate('RCCMNL83S18D969H') # personal number
'RCCMNL83S18D969H'
>>> validate('RCCMNL83S18D969')
Traceback (most recent call last):
...
InvalidLength: ...
>>> validate('00743110157') # company number
'00743110157'
>>> validate('00743110158') # company number with invalid check digit
Traceback (most recent call last):
...
InvalidChecksum: ...
>>> calc_check_digit('RCCMNL83S18D969')
'H'
"""
import datetime
import re
from stdnum.exceptions import *
from stdnum.it import iva
from stdnum.util import clean
# regular expression for matching personal fiscal codes
_code_re = re.compile(
r'^[A-Z]{6}'
r'[0-9LMNPQRSTUV]{2}[ABCDEHLMPRST]{1}[0-9LMNPQRSTUV]{2}'
r'[A-Z]{1}[0-9LMNPQRSTUV]{3}[A-Z]{1}$')
# encoding of birth day and year values (usually numeric but some letters
# may be substituted on clashes)
_date_digits = dict((x, n) for n, x in enumerate('0123456789'))
_date_digits.update(dict((x, n) for n, x in enumerate('LMNPQRSTUV')))
# encoding of month values (A = January, etc.)
_month_digits = dict((x, n) for n, x in enumerate('ABCDEHLMPRST'))
# values of characters in even positions for checksum calculation
_even_values = dict((x, n) for n, x in enumerate('0123456789'))
_even_values.update(
dict((x, n) for n, x in enumerate('ABCDEFGHIJKLMNOPQRSTUVWXYZ')))
# values of characters in odd positions for checksum calculation
values = [1, 0, 5, 7, 9, 13, 15, 17, 19, 21, 2, 4, 18, 20, 11, 3, 6, 8,
12, 14, 16, 10, 22, 25, 24, 23]
_odd_values = dict((x, values[n]) for n, x in enumerate('0123456789'))
_odd_values.update(
dict((x, values[n]) for n, x in enumerate('ABCDEFGHIJKLMNOPQRSTUVWXYZ')))
del values
def compact(number):
"""Convert the number to the minimal representation. This strips the
number of any valid separators and removes surrounding whitespace."""
return clean(number, ' -:').strip().upper()
def calc_check_digit(number):
"""Compute the control code for the given personal number. The passed
number should be the first 15 characters of a fiscal code."""
code = sum(_odd_values[x] if n % 2 == 0 else _even_values[x]
for n, x in enumerate(number))
return 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'[code % 26]
def get_birth_date(number, minyear=1920):
"""Get the birth date from the person's fiscal code.
Only the last two digits of the year are stored in the number. The dates
will be returned in the range from minyear to minyear + 100.
>>> get_birth_date('RCCMNL83S18D969H')
datetime.date(1983, 11, 18)
>>> get_birth_date('RCCMNL83S18D969H', minyear=1990)
datetime.date(2083, 11, 18)
"""
number = compact(number)
if len(number) != 16:
raise InvalidComponent()
day = (_date_digits[number[9]] * 10 + _date_digits[number[10]]) % 40
month = _month_digits[number[8]] + 1
year = _date_digits[number[6]] * 10 + _date_digits[number[7]]
# find four-digit year
year += (minyear // 100) * 100
if year < minyear:
year += 100
try:
return datetime.date(year, month, day)
except ValueError:
raise InvalidComponent()
def get_gender(number):
"""Get the gender of the person's fiscal code.
>>> get_gender('RCCMNL83S18D969H')
'M'
>>> get_gender('CNTCHR83T41D969D')
'F'
"""
number = compact(number)
if len(number) != 16:
raise InvalidComponent()
return 'M' if int(number[9:11]) < 32 else 'F'
def validate(number):
"""Check if the given fiscal code is valid. This checks the length and
whether the check digit is correct."""
number = compact(number)
if len(number) == 11:
return iva.validate(number)
if len(number) != 16:
raise InvalidLength()
if not _code_re.match(number):
raise InvalidFormat()
if calc_check_digit(number[:-1]) != number[-1]:
raise InvalidChecksum()
# check if birth date is valid
get_birth_date(number)
return number
def is_valid(number):
"""Check if the given fiscal code is valid."""
try:
return bool(validate(number))
except ValidationError:
return False
|