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: str) → str

Convert the number to the minimal representation.

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

stdnum.za.tin.format(number: str) → str

Reformat the number to the standard presentation format.

stdnum.za.tin.is_valid(number: str) → bool

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

stdnum.za.tin.validate(number: str) → str

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

This checks the length, formatting and check digit.