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)
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)
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)
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 (Идентификационный номер налогоплательщика)
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)
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)

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