Documentación Validador-BR

Valide documentos brasileños con facilidad

Aprenda cómo usar la biblioteca para validar CPFs, CNPJs, CNHs, PIS y más.

NPM VersionNPM Downloads

Empezando

Acerca de

@box4dev/validador-br

Una biblioteca ligera y robusta para validar documentos brasileños.

La biblioteca tiene como objetivo garantizar que los documentos cumplan con los cálculos matemáticos y de dígitos verificadores estipulados por las instituciones.

Instalación

Para instalar el paquete en su proyecto, ejecute uno de los comandos a continuación:

NPM

Shell
1
npm install @box4dev/validador-br

Yarn

Shell
1
yarn add @box4dev/validador-br

PNPM

Shell
1
pnpm add @box4dev/validador-br

Importación

Exportaciones nombradas (recomendado)

Use las funciones nombradas para importar solo lo que necesita.

JS
1
2
3
import { isValidCpf, isValidCnpj } from '@box4dev/validador-br';
console.log(isValidCpf('123.456.789-09')); // true ou false
console.log(isValidCnpj('GY.HU8.PG2/971E-10')); // true ou false

Objeto validate (centralizado)

O use el objeto `validate` que centraliza todos los validadores.

JS
1
2
3
import { validate } from '@box4dev/validador-br';
console.log(validate.cpf('123.456.789-09')); // true ou false
console.log(validate.cnpj('12.345.678/0001-95')); // true ou false

CommonJS (require)

JS
1
2
3
const { isValidCpf, isValidCnpj, validate } = require('@box4dev/validador-br');
console.log(isValidCpf('12345678909')); // true ou false
console.log(validate.cnpj('GYHU8PG2971E10')); // true ou false

Validadores

CPF

Valida el formato y los dígitos verificadores del CPF (módulo 11).

JS
1
2
3
import { isValidCpf } from '@box4dev/validador-br';
console.log(isValidCpf('741.535.041-30')); // true ou false
console.log(isValidCpf('43241612163')); // true ou false

CNPJ / CNPJ Alfanumérico

Valida CNPJs en el estándar antiguo (solo números) y en el nuevo estándar alfanumérico.

JS
1
2
3
4
5
import { isValidCnpj } from '@box4dev/validador-br';
console.log(isValidCnpj('GY.HU8.PG2/971E-10')); // true ou false
console.log(isValidCnpj('12.345.678/0001-95')); // true ou false
console.log(isValidCnpj('AYWO9JCVCHFB47')); // true ou false
console.log(isValidCnpj('47434563000151')); // true ou false

CNH

Valida la Licencia Nacional de Conducir utilizando el algoritmo oficial.

JS
1
2
import { isValidCnh } from '@box4dev/validador-br';
console.log(isValidCnh('12345678901')); // true ou false

PIS / PASEP / NIT

Valida el Número de Identificación del Trabajador (PIS/PASEP/NIT).

JS
1
2
3
import { isValidPis } from '@box4dev/validador-br';
console.log(isValidPis('589.21704.72.2')); // true ou false
console.log(isValidPis('07987894517')); // true ou false

CNS

Valida números de CNS provisionales (que comienzan con 7, 8, 9) y definitivos (1, 2).

JS
1
2
3
import { isValidCns } from '@box4dev/validador-br';
console.log(isValidCns('252 9608 1932 0002')); // true ou false
console.log(isValidCns('146471200460007')); // true ou false

Título Electoral

Valida el título de elector verificando los dígitos y el código del estado.

JS
1
2
3
import { isValidTituloEleitor } from '@box4dev/validador-br';
console.log(isValidTituloEleitor('4113 4513 0930')); // true ou false
console.log(isValidTituloEleitor('428779582410')); // true ou false

Certificado

Valida la matrícula de 32 dígitos de certificados (Nacimiento, Matrimonio, Defunción).

JS
1
2
3
import { isValidCertidao } from '@box4dev/validador-br';
console.log(isValidCertidao('106836 11 1926 1001 1 88626 162 6561443')); // true ou false
console.log(isValidCertidao('81007223197120011105781766173474')); // true ou false

Inscripción Estatal

Valida IEs específicas de cada estado (UF). Requiere la sigla del estado.

JS
1
2
3
4
import { isValidIE } from '@box4dev/validador-br';
// valor da IE e UF
console.log(isValidIE('7122026812064', 'SP')); // true ou false
console.log(isValidIE('01.004.823/001-12', 'AC')); // true ou false

Tarjeta de Crédito

Valida tarjetas (Visa, Mastercard, Amex, etc.) utilizando el Algoritmo de Luhn.

JS
1
2
3
import { isValidCartaoCredito } from '@box4dev/validador-br';
console.log(isValidCartaoCredito('4389 3536 3524 6297')); // true ou false
console.log(isValidCartaoCredito('4389351453183261')); // true ou false

Preguntas Frecuentes