stdnum

Country Standard Numbers

JavaScript (TypeScript) package to validate most all national numbers, with a focus on VAT, Person and Tax identifiers.

Quick start

import { stdnum } from 'stdnum';

const { isValid } = stdnum.br.cpf.validate('xyzzy');

// isValid is false

Supported Countries and Numbers

Country	Code	Name	Group	Meaning
Albania	AL	NIPT	Vat	Vat Identifier (Numri i Identifikimit për Personin e Tatueshëm)
Andorra	AD	NRT	Tax	Tax Identifier (Número de Registre Tributari)
Argentina	AR	CBU	Bank	Bank Account (Clave Bancaria Uniforme)
Argentina	AR	CUIT	Tax	Tax Identity (Código Único de Identificación Tributaria)
Argentina	AR	DNI	Person	National Identity (Documento Nacional de Identidad)
Austria	AT	Businessid	Company	Austrian Company Register Numbers
Austria	AT	TIN	Tax	Austrian tax identification number (Abgabenkontonummer)
Austria	AT	UID	VAT	Austrian VAT number (Umsatzsteuer-Identifikationsnummer)
Austria	AT	VNR	Person	Austrian social security number(Versicherungsnummer)
Australia	AU	ABN	Company	Australian Business Number
Australia	AU	ACN	Company	Australian Company Number
Australia	AU	TFN	Tax/Person/Company	Australian Tax File Number
Belize	BZ	TIN	Person/Company	Brazilian Tax ID ()
Brazil	BR	CPF	Person	Brazilian identity number (Cadastro de Pessoas Físicas)
Brazil	BR	CNPJ	Company	Brazilian company number (Cadastro Nacional da Pessoa Jurídica)
Canada	CA	BN	Company	Company Identifier (Canadian Business Number)
Canada	CA	SIN	Person	Person Identifier (Social Insurance Number)
Chile	CL	RUT	Tax	Tax Identifier (Rol Unico Tributario) [RUN]
China	CN	RIC	Person	Person Identifier (Chinese Resident Identity Card Number)
China	CN	USCC	Company	Company Identifier (Unified Social Credit Code, 统一社会信用代码, China tax number)
Columbia	CO	NIT	Tax	Tax Identifier (Número de Identificación Tributaria)
Costa Rica	CR	CPF	Person	Person Identifier (Cédula de Persona Física)
Costa Rica	CR	CPJ	Company	Company Identifier (Cédula de Persona Jurídica)
Costa Rica	CR	CR	Person	Person Identifier (Cédula de Residencia)
Dominican Republic	DO	CEDULA	Person	Person Identifier (Cédula de Residencia)
Dominican Republic	DO	NCF	Vat	Tax Receipt Number (Números de Comprobante Fiscal)
Dominican Republic	DO	RNC	Tax	Person Identifier (Registro Nacional del Contribuyente)
Ecuador	EC	CI	Person	Ecuadorian person identifier (Cédula de identidad)
Ecuador	EC	RUC	Tax/Vat	Ecuadorian company tax number (Registro Único de Contribuyentes)
El Salvador	SV	NIT	Tax	Tax Identifier (Número de Identificación Tributaria)
Guatemala	GT	CUI	Person	Guatemala person (Código Único de Identificación)
Guatemala	GT	NIT	Company	Guatemala company tax number (Número de Identificación Tributaria)
Hong Kong	HK	HKID	Person	Hong Kong Identity Card
Indonesia	ID	NPWP	Person/Company	NPWP (Nomor Pokok Wajib Pajak, Indonesian VAT Number).
India	IN	AADHAAR	Company	Indian digital resident personal identity number
India	IN	PAN	Person	Permanent Account Number, Indian income tax identifier
Japan	JP	CN	Company	法人番号, hōjin bangō, Japanese Corporate Number
South Korea	KR	BRN	Company	사업자 등록 번호, South Korea Business Registration Number)
South Korea	KR	RRN	Person	South Korean resident registration number
Mexico	MX	RFC	Tax/Vat	Tax Identifier (Registro Federal de Contribuyentes)
Mexico	MX	CURP	Person	Individual Identifier (Clave Única de Registro de Población)
Mexico	MX	CLABE	Bank	Bank Account (Clave Bancaria Estandarizada)
Malaysia	MY	NRIC	Person	Malaysian National Registration Identity Card Number
New Zealand	NZ	IRD	Person/Company	New Zealand Inland Revenue Department (Te Tari Tāke) number
Paraguay	PY	RUC	Tax/Vat	Tax Identifier (Registro Único de Contribuyentes)
Peru	PE	CUI	Person	Person Identifier (Cédula Única de Identidad)
Peru	PE	RUC	Tax/Vat	Tax Identifier (Registro Único de Contribuyentes)
Russia	RU	INN	Tax/Vat	Tax Identifier (Идентификационный номер налогоплательщика)
Singapore	SG	UEN	Company	Singapore's Unique Entity Number
Thailand	TH	IDNR	Person	Thai National ID (บัตรประจำตัวประชาชนไทย)
Taiwan	TW	UBN	Company	Unified Business Number, 統一編號, Taiwanese tax number
Spain	ES	CIF	Tax/Vat	Tax Identifier (Código de Identificación Fiscal)
Spain	ES	DNI	Person	Identity code (Documento Nacional de Identidad)
Spain	ES	NIE	Person	Identity code foreigner (Número de Identificación de Extranjero)
Spain	ES	NIF	Tax	Tax Identifier (Número de Identificación Fiscal)
Uruguay	UY	RUT	Tax/Vat	Tax Identifier (Registro Único Tributario)
Uruguay	UY	CEDULA	Person	Person Identifier (Cédula de Residencia)
Uruguay	UY	NIE	Person	ForeignersI identification Number
United States	US	EIN	Tax/Company	Tax Identifier (Employer Identification Number)
United States	US	SSN	Tax/Individual	Tax Identifier (Social Security Number)
Venezuelan	VE	RIF	Vat	Vat Identifier (Registro de Identificación Fiscal)
Vietnam	VN	MST	Company	Mã số thuế, Vietnam tax number
South Africa	ZA	IDNR	Person	ID number (South African Identity Document number).
South Africa	ZA	TIN	Person/Company	TIN (South African Tax Identification Number).

Examples

TODO -- Usage examples

Credits

Thanks to python-stdnum for providing the inspiration and many of the checksum algorithm sources

References

https://wiki.scn.sap.com/wiki/display/CRM/Country+Tax+Category+check