stdnum.za.tin

TIN (South African Tax Identification Number).

The South African Tax Identification Number (TIN or Tax Reference Number) is issued to individuals and legal entities for tax purposes. The number consists of 10 digits.

More information:

• https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/South-Africa-TIN.pdf

• https://www.sars.gov.za/

>>> validate('0001339050')
'0001339050'
>>> validate('2449/494/16/0')
Traceback (most recent call last):
    ...
InvalidChecksum: ...
>>> validate('9125568')
Traceback (most recent call last):
    ...
InvalidLength: ...
>>> format('084308984-8')
'0843089848'

stdnum.za.tin.compact(number)

Convert the number to the minimal representation.

This strips the number of any valid separators and removes surrounding whitespace.

stdnum.za.tin.format(number)

Reformat the number to the standard presentation format.

stdnum.za.tin.is_valid(number)

Check if the number is a valid South Africa Tax Reference Number.

stdnum.za.tin.validate(number)

Check if the number is a valid South Africa Tax Reference Number.

This checks the length, formatting and check digit.