Add Kazakhstan Business Identification Number validation

Prevent future date output

If the date returned is of the current year, it could be in the future,
and thus invalidate the number.

Update IIN description

Author: lucasicr

stdnum/kz/__init__.py

@@ -14,9 +14,7 @@
 # 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
+# License along with this library; if not, see <https://www.gnu.org/licenses/>.
 
 """Collection of Kazakhstan numbers."""
 

stdnum/kz/bin.py

@@ -14,9 +14,7 @@
 # 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
+# License along with this library; if not, see <https://www.gnu.org/licenses/>.
 
 """BIN or "БСН" (Business Identification Number, "бизнес-сәйкестендіру нөмірі",
 Kazakhstan tax number).
@@ -66,15 +64,20 @@
 Traceback (most recent call last):
     ...
 InvalidComponent: ...
+>>> validate('940140000386')
+Traceback (most recent call last):
+    ...
+InvalidChecksum: ...
 >>> format('990 140 004 654')
 '990140004654'
 """  # noqa: E501
 
 from stdnum.exceptions import *
+from stdnum.kz.iin import calc_check_digit
 from stdnum.util import clean, isdigits
 
 
-def compact(number):
+def compact(number: str) -> str:
     """Convert the number to the minimal representation.
 
     This strips the number of any valid separators and removes surrounding
@@ -83,7 +86,7 @@ def compact(number):
     return clean(number, ' ')
 
 
-def validate(number):
+def validate(number: str) -> str:
     """Check if the number is a valid Kazakhstan BIN number.
 
     This checks the length and formatting.
@@ -99,17 +102,19 @@ def validate(number):
         raise InvalidComponent()
     if number[5] not in ('0', '1', '2', '3'):
         raise InvalidComponent()
+    if calc_check_digit(number[:-1]) != number[-1]:
+        raise InvalidChecksum()
     return number
 
 
-def is_valid(number):
+def is_valid(number: str) -> bool:
     """Check if the number is a valid Kazakhstan BIN number."""
     try:
         return bool(validate(number))
     except ValidationError:
         return False
 
 
-def format(number):
+def format(number: str) -> str:
     """Reformat the number to the standard presentation format."""
     return compact(number)

stdnum/kz/iin.py

@@ -19,7 +19,8 @@
 """IIN (ЖСН, Жеке сәйкестендіру нөмірі, Kazakhstani Individual identification number).
 
 It is a 12-digit number of which the first 6 digits denote the person's
-birth date, the next three digits represent a birth order number
+birth date in the format YYMMDD, the next digit encodes the gender and
+century of birth, the next four digits represent a birth serial number
 and the last digit is a check digit.
 
 * https://www.gov.kz/article/648?lang=kk
@@ -83,7 +84,7 @@ def get_birth_date(number: str) -> datetime.date:
     if number[6] == '0':  # no century info for foreign nationals
         today = datetime.date.today()
         year += (today.year // 100) * 100
-        if year > today.year:
+        if year >= today.year:
             year -= 100
 
     elif number[6] in '12':

tests/test_kz_bin.doctest

@@ -13,9 +13,7 @@ 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
+License along with this library; if not, see <https://www.gnu.org/licenses/>.
 
 
 This file contains more detailed doctests for the stdnum.kz.bin module. It
@@ -53,6 +51,10 @@ InvalidComponent: ...
 Traceback (most recent call last):
     ...
 InvalidComponent: ...
+>>> bin.validate('940140000386')
+Traceback (most recent call last):
+    ...
+InvalidChecksum: ...
 
 
 These have been found online and should all be valid numbers.