tin-validators
v0.0.7
Published
Comprehensive Tax Identification Number (TIN) Validator for all European Union (EU) countries. This tool checks the syntax and structure of TINs to ensure compliance with EU standards. Perfect for developers integrating accurate TIN validation into web ap
Downloads
511
Maintainers
Readme
tin-validators
Tax Identification Number (TIN) Validator for European Union (EU) Countries Source: https://ec.europa.eu/taxation_customs/tin/#/check-tin
Supported Countries
- Austria (AT)
- Belgium (BE)
- Bulgaria (BG)
- Croatia (HR)
- Cyprus (CY)
- Czech Republic (CZ)
- Denmark (DK)
- Estonia (EE)
- Finland (FI)
- France (FR)
- Germany (DE)
- Greece (GR)
- Hungary (HU)
- Ireland (IE)
- Italy (IT)
- Latvia (LV)
- Lithuania (LT)
- Luxembourg (LU)
- Malta (MT)
- Spain (ES)
limitations
For the following countries, syntax rules are not publicly available so it only check if length and pattern matches. You will never get 0 as the response
- Czech Republic
- Greece
- Malta
install
# npm
npm install tin-validators
usage
import {validate, Country} from 'tin-validators';
const result = validate("DOEJCK80T12H501J", Country.IT)
Responses:
- VALID = 0;
- INVALID_SYNTAX = 1;
- NO_SYNTAX_CHECKER = 2;
- INVALID_PATTERN = 3;
- INVALID_LENGTH = 4;
- NO_INFORMATION = -1;
Run tests
npm run test
disclaimer
Important disclaimer:
This repo confirms whether the structure of the TIN you enter is valid (types and number of characters).
It can also validate the syntax (i.e. algorithm/internal logic) only when the national authority has informed EU about the algorithm in https://ec.europa.eu/taxation_customs/tin/#/check-tin
Contrary to VAT number checks carried out on the VIES portal, it does NOT confirm the identity of a person nor whether the TIN you enter actually exists or has been allocated.
As any updates must be provided by the national authorities, we cannot guarantee that the information provided is up to date.
⚠ Please note that this repo can validate only the structure of TIN referring to a natural person. EU Countries may use for legal entity other format of TIN, and it cannot be validated with this module.