# nit.py - functions for handling Colombian identity codes # coding: utf-8 # # Copyright (C) 2008-2011 Cédric Krier # Copyright (C) 2008-2011 B2CK # Copyright (C) 2015 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 """NIT (Número De Identificación Tributaria, Colombian identity code). This number, also referred to as RUT (Registro Unico Tributario) is a 10-digit code that includes a check digit. >>> validate('213.123.432-1') '2131234321' >>> validate('2131234351') '2131234351' >>> validate('2131234350') Traceback (most recent call last): ... InvalidChecksum: ... >>> validate('213123435') Traceback (most recent call last): ... InvalidLength: ... >>> validate('213123435A') Traceback (most recent call last): ... InvalidFormat: ... >>> format('2131234351') '213.123.435-1' """ from stdnum.exceptions import * from stdnum.util import clean def compact(number): """Convert the number to the minimal representation. This strips surrounding whitespace and separation dash.""" return clean(number, '.-').upper().strip() def calc_check_digit(number): """Calculate the check digit. The number passed should not have the check digit included.""" weights = (3, 7, 13, 17, 19, 23, 29, 37, 41, 43, 47, 53, 59, 67, 71) s = sum(int(n) * weights[i] for i, n in enumerate(number[::-1])) return '01987654321'[s % 11] def validate(number): """Checks to see if the number provided is a valid number. This checks the length, formatting and check digit.""" number = compact(number) if len(number) != 10: raise InvalidLength() if not number.isdigit(): raise InvalidFormat() if calc_check_digit(number[:-1]) != number[-1]: raise InvalidChecksum() return number def is_valid(number): """Checks to see if the number provided is a valid number. This checks the length, formatting and check digit.""" try: return bool(validate(number)) except ValidationError: return False def format(number): """Reformat the passed number to the standard format.""" number = compact(number) return (number[:-7] + '.' + number[-7:-4] + '.' + number[-4:-1] + '-' + number[-1])