# stdnum.nl.bsn

BSN (Burgerservicenummer, the Dutch citizen identification number).

The BSN is a unique personal identifier and has been introduced as the successor to the sofinummer. It is issued to each Dutch national. The number consists of up to nine digits (the leading zeros are commonly omitted) and contains a simple checksum.

More information:

- https://en.wikipedia.org/wiki/National_identification_number#Netherlands
- https://nl.wikipedia.org/wiki/Burgerservicenummer
- http://www.burgerservicenummer.nl/

    >>> validate('1112.22.333')
    '111222333'
    >>> validate('1112.52.333')
    Traceback (most recent call last):
        ...
    InvalidChecksum: ...
    >>> validate('1112223334')
    Traceback (most recent call last):
        ...
    InvalidLength: ...
    >>> format('111222333')
    '1112.22.333'

`stdnum.nl.bsn.``checksum`(number)

  Calculate the checksum over the number. A valid number should have a checksum of 0.

`stdnum.nl.bsn.``compact`(number)

  Convert the number to the minimal representation. This strips the number of any valid separators and removes surrounding whitespace.

`stdnum.nl.bsn.``format`(number)

  Reformat the passed number to the standard presentation format.

`stdnum.nl.bsn.``is_valid`(number)

  Check if the number is a valid BSN.

`stdnum.nl.bsn.``validate`(number)

  Check if the number is a valid BSN. This checks the length and whether the check digit is correct.