VAT validation for Python
Project description
With EU VAT handling rules becoming ever more ridiculous and complicated, businesses within the EU are faced with the complexity of having to validate VAT numbers. pyvat was built for Iconfinder’s marketplace to handle just this problem.
Validation of VAT numbers is performed in two steps: firstly, the VAT number is checked against an expression for the given country if one such is available, after which it is checked against a registry if one such is available.
Supported countries and registries
As of the current version, pyvat has VAT number validation expressions for the following countries:
ISO 3166-1-alpha-2 |
Country |
Reference |
---|---|---|
AT |
Austria |
|
BE |
Belgium |
|
BG |
Bulgaria |
|
CY |
Cyprus |
|
CZ |
Czech Republic |
|
DE |
Germany |
|
DK |
Denmark |
|
EE |
Estonia |
|
EL |
Greece |
|
ES |
Spain |
|
FI |
Finland |
|
FR |
France |
|
GB |
United Kingdom |
|
HU |
Hungary |
|
IE |
Ireland |
|
IT |
Italy |
|
LT |
Lithuania |
|
LU |
Luxembourg |
|
LV |
Latvia |
|
MT |
Malta |
|
NL |
The Netherlands |
|
PL |
Poland |
|
PT |
Portugal |
|
RO |
Romania |
|
SE |
Sweden |
|
SK |
Slovakia |
The VAT numbers for the following countries can furthermore be validated against a registry:
ISO 3166-1-alpha-2 |
Country |
Registry |
---|---|---|
AT |
Austria |
|
BE |
Belgium |
|
BG |
Bulgaria |
|
CY |
Cyprus |
|
CZ |
Czech Republic |
|
DE |
Germany |
|
DK |
Denmark |
|
EE |
Estonia |
|
EL |
Greece |
|
ES |
Spain |
|
FI |
Finland |
|
FR |
France |
|
GB |
United Kingdom |
|
HU |
Hungary |
|
IE |
Ireland |
|
IT |
Italy |
|
LT |
Lithuania |
|
LU |
Luxembourg |
|
LV |
Latvia |
|
MT |
Malta |
|
NL |
The Netherlands |
|
PL |
Poland |
|
PT |
Portugal |
|
RO |
Romania |
|
SE |
Sweden |
|
SK |
Slovakia |
Installation
To install requests, do yourself a favor and don’t use anything other than pip:
$ pip install pyvat
Usage
pyvat exposes its functionality through two simple methods:
- pyvat.is_vat_number_valid(vat_number, country_code=None)
Test if a VAT number is valid.
If possible, the VAT number will be checked against available registries.
- Parameters:
vat_number – VAT number to validate.
country_code – Optional country code. Should be supplied if known, as there is no guarantee that naively entered VAT numbers contain the correct alpha-2 country code prefix for EU countries just as not all non-EU countries have a reliable country code prefix. Default None prompting detection.
- Returns:
True if the VAT number can be fully asserted as valid or False if not, otherwise None indicating that the VAT number may or may not be valid.
- pyvat.is_vat_number_format_valid(vat_number, country_code=None)
Test if the format of a VAT number is valid.
- Parameters:
vat_number – VAT number to validate.
country_code – Optional country code. Should be supplied if known, as there is no guarantee that naively entered VAT numbers contain the correct alpha-2 country code prefix for EU countries just as not all non-EU countries have a reliable country code prefix. Default None prompting detection.
- Returns:
True if the VAT number can be fully asserted as valid or False if not, otherwise None indicating that the VAT number may or may not be valid.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.