Uma biblioteca TypeScript/JavaScript/Node para validar e formatar números de CPF e CNPJ já com o suporte aos novos CNPJ alfanuméricos.
npm install cnpj-cpf-validator🇧🇷 Leia em Português • 🇺🇸 Read in English
 !TypeScript !Node.js !JavaScript  
Uma biblioteca TypeScript/JavaScript/Node para validar e formatar números de CPF e CNPJ já com o suporte aos novos CNPJ alfanuméricos.
``bash`
npm install cnpj-cpf-validatorou
yarn add cnpj-cpf-validatorou
pnpm add cnpj-cpf-validator
- Validação de números de CPF e CNPJ
- Formatação de números de CPF e CNPJ com máscaras padrão
- Limpeza de números de CPF e CNPJ (remoção de caracteres não numéricos)
- Suporte a TypeScript com definições de tipos
- Zero dependências
- Funciona em Node.js e navegadores
- Suporta tanto CommonJS quanto ES Modules
- Suporte ao novo formato alfanumérico de CNPJ (a partir de julho de 2026)
A Receita Federal do Brasil anunciou mudanças no formato do CNPJ que começarão a valer a partir de julho de 2026. A principal alteração é a introdução do CNPJ alfanumérico, que incluirá letras, além dos números, na sua composição.
- Formato Alfanumérico: O CNPJ continuará tendo 14 caracteres, mas:
- As oito primeiras posições, que formam a raiz do CNPJ (identificação da empresa), poderão conter tanto letras quanto números.
- As quatro posições seguintes, que indicam a ordem do estabelecimento (matriz ou filial), também serão alfanuméricas.
- As duas últimas posições, que são os dígitos verificadores (utilizados para validar a autenticidade do CNPJ), continuarão sendo exclusivamente numéricas.
- Convivência de formatos: Os CNPJs já existentes (apenas numéricos) permanecerão válidos. O novo formato alfanumérico será implementado apenas para novas inscrições a partir de julho de 2026. Os dois formatos (numérico e alfanumérico) vão coexistir.
- Cálculo do dígito verificador: O cálculo dos dígitos verificadores para o novo formato segue a metodologia oficial definida pela Receita Federal do Brasil:
- Cada caractere alfanumérico é convertido para um valor numérico, subtraindo 48 do seu código ASCII.
- O algoritmo de cálculo continua utilizando módulo 11, como já é feito para o CNPJ tradicional.
- Os pesos utilizados no cálculo variam de 2 a 9, aplicados da direita para a esquerda.
- EH.DFG.8RN/WE9R-72
-
-
-
-
Esta biblioteca já suporta a validação e formatação de CNPJs alfanuméricos!
`javascript`
const { isValidCPF, formatCPF, isValidCNPJ, formatCNPJ } = require('cnpj-cpf-validator');
`javascript`
import { isValidCPF, formatCPF, isValidCNPJ, formatCNPJ } from 'cnpj-cpf-validator';
`javascript
// Validação de CPF
console.log(isValidCPF('529.982.247-25')); // true
console.log(isValidCPF('52998224725')); // true
console.log(isValidCPF('111.111.111-11')); // false (CPF inválido)
// Formatação de CPF
console.log(formatCPF('52998224725')); // '529.982.247-25'
// Validação de CNPJ (formato numérico tradicional)
console.log(isValidCNPJ('11.222.333/0001-81')); // true
console.log(isValidCNPJ('11222333000181')); // true
console.log(isValidCNPJ('11.111.111/1111-11')); // false (CNPJ inválido)
// Formatação de CNPJ (formato numérico tradicional)
console.log(formatCNPJ('11222333000181')); // '11.222.333/0001-81'
// Validação de CNPJ (novo formato alfanumérico)
console.log(isValidCNPJ('9L.VBX.IIJ/0POW-08')); // true
console.log(isValidCNPJ('O0O6Q7X1CXHE83')); // true
// Formatação de CNPJ (novo formato alfanumérico)
console.log(formatCNPJ('A1B2C3D4E5F6G7H801')); // 'A1.B2C.3D4/E5F6-01'
`
#### isValidCPF(cpf: string): boolean
Valida se um número de CPF é válido.
- cpf: O número de CPF a ser validado (pode estar formatado ou conter apenas números)
- Retorna: True se o CPF for válido, false caso contrário
#### formatCPF(cpf: string): string
Formata um número de CPF com a máscara padrão (XXX.XXX.XXX-XX).
- cpf: O número de CPF a ser formatado (pode estar formatado ou conter apenas números)
- Retorna: O CPF formatado ou uma string vazia se for inválido
#### cleanCPF(cpf: string): string
Remove quaisquer caracteres não numéricos de um CPF.
- cpf: O CPF a ser limpo
- Retorna: Uma string contendo apenas os números do CPF
#### isValidCNPJ(cnpj: string): boolean
Valida se um número de CNPJ é válido (suporta tanto o formato numérico tradicional quanto o novo formato alfanumérico).
- cnpj: O número de CNPJ a ser validado (pode estar formatado ou conter apenas números/letras)
- Retorna: True se o CNPJ for válido, false caso contrário
#### formatCNPJ(cnpj: string): string
Formata um número de CNPJ com a máscara padrão (XX.XXX.XXX/XXXX-XX).
- cnpj: O número de CNPJ a ser formatado (pode estar formatado ou conter apenas números/letras)
- Retorna: O CNPJ formatado ou uma string vazia se for inválido
#### cleanCNPJ(cnpj: string): string
Remove caracteres de formatação de um CNPJ.
- Para CNPJs numéricos: remove todos os caracteres não numéricos
- Para CNPJs alfanuméricos: remove todos os caracteres não alfanuméricos
- cnpj: O CNPJ a ser limpo
- Retorna: Uma string contendo apenas os caracteres alfanuméricos do CNPJ
#### isValidDocument(document: string): boolean
Valida se um número de documento é um CPF ou CNPJ válido.
- document: O número do documento a ser validado (pode estar formatado ou conter apenas números/letras)
- Retorna: True se o documento for um CPF ou CNPJ válido, false caso contrário
#### formatDocument(document: string): string
Formata um número de documento como CPF ou CNPJ com base em suas características.
- document: O número do documento a ser formatado (pode estar formatado ou conter apenas números/letras)
- Retorna: O documento formatado ou uma string vazia se for inválido
#### cleanNumbers(value: string): string
Remove todos os caracteres não numéricos de uma string.
- value: A string a ser limpa
- Retorna: Uma string contendo apenas números
#### cleanAlphanumeric(value: string): string
Remove todos os caracteres não alfanuméricos de uma string.
- value: A string a ser limpa
- Retorna: Uma string contendo apenas letras e números
Para executar os testes:
`bash`
npm test
Para executar os testes com cobertura:
`bash`
npm run test:coverage
MIT
A TypeScript/JavaScript/Node library for validating and formatting CPF and CNPJ numbers with support for the new alphanumeric CNPJ format.
`bash`
npm install cnpj-cpf-validatoror
yarn add cnpj-cpf-validatoror
pnpm add cnpj-cpf-validator
- Validation of CPF and CNPJ numbers
- Formatting of CPF and CNPJ numbers with standard masks
- Cleaning of CPF and CNPJ numbers (removal of non-numeric characters)
- TypeScript support with type definitions
- Zero dependencies
- Works in Node.js and browsers
- Supports both CommonJS and ES Modules
- Support for the new alphanumeric CNPJ format (starting July 2026)
The Brazilian Federal Revenue Service announced changes to the CNPJ format that will take effect from July 2026. The main change is the introduction of the alphanumeric CNPJ, which will include letters, in addition to numbers, in its composition.
- Alphanumeric Format: The CNPJ will continue to have 14 characters, but:
- The first eight positions, which form the root of the CNPJ (company identification), may contain both letters and numbers.
- The next four positions, which indicate the establishment order (headquarters or branch), will also be alphanumeric.
- The last two positions, which are the verification digits (used to validate the authenticity of the CNPJ), will continue to be exclusively numeric.
- Format Coexistence: Existing CNPJs (numeric only) will remain valid. The new alphanumeric format will be implemented only for new registrations from July 2026. The two formats (numeric and alphanumeric) will coexist.
- EH.DFG.8RN/WE9R-72
-
-
-
-
This library already supports validation and formatting of alphanumeric CNPJs!
`javascript`
const { isValidCPF, formatCPF, isValidCNPJ, formatCNPJ } = require('cnpj-cpf-validator');
`javascript`
import { isValidCPF, formatCPF, isValidCNPJ, formatCNPJ } from 'cnpj-cpf-validator';
`javascript
// CPF Validation
console.log(isValidCPF('529.982.247-25')); // true
console.log(isValidCPF('52998224725')); // true
console.log(isValidCPF('111.111.111-11')); // false (Invalid CPF)
// CPF Formatting
console.log(formatCPF('52998224725')); // '529.982.247-25'
// CNPJ Validation (traditional numeric format)
console.log(isValidCNPJ('11.222.333/0001-81')); // true
console.log(isValidCNPJ('11222333000181')); // true
console.log(isValidCNPJ('11.111.111/1111-11')); // false (Invalid CNPJ)
// CNPJ Formatting (traditional numeric format)
console.log(formatCNPJ('11222333000181')); // '11.222.333/0001-81'
// CNPJ Validation (new alphanumeric format)
console.log(isValidCNPJ('RQ.KX9.6B3/8UOV-71')); // true
console.log(isValidCNPJ('PI4NRZRZTLMH10')); // true
// CNPJ Formatting (new alphanumeric format)
console.log(formatCNPJ('A1B2C3D4E5F6G7H801')); // 'A1.B2C.3D4/E5F6-01'
`
#### isValidCPF(cpf: string): boolean
Validates if a CPF number is valid.
- cpf: The CPF number to be validated (can be formatted or contain only numbers)
- Returns: True if the CPF is valid, false otherwise
#### formatCPF(cpf: string): string
Formats a CPF number with the standard mask (XXX.XXX.XXX-XX).
- cpf: The CPF number to be formatted (can be formatted or contain only numbers)
- Returns: The formatted CPF or an empty string if invalid
#### cleanCPF(cpf: string): string
Removes any non-numeric characters from a CPF.
- cpf: The CPF to be cleaned
- Returns: A string containing only the numbers of the CPF
#### isValidCNPJ(cnpj: string): boolean
Validates if a CNPJ number is valid (supports both the traditional numeric format and the new alphanumeric format).
- cnpj: The CNPJ number to be validated (can be formatted or contain only numbers/letters)
- Returns: True if the CNPJ is valid, false otherwise
#### formatCNPJ(cnpj: string): string
Formats a CNPJ number with the standard mask (XX.XXX.XXX/XXXX-XX).
- cnpj: The CNPJ number to be formatted (can be formatted or contain only numbers/letters)
- Returns: The formatted CNPJ or an empty string if invalid
#### cleanCNPJ(cnpj: string): string
Removes formatting characters from a CNPJ.
- For numeric CNPJs: removes all non-numeric characters
- For alphanumeric CNPJs: removes all non-alphanumeric characters
- cnpj: The CNPJ to be cleaned
- Returns: A string containing only the alphanumeric characters of the CNPJ
#### isValidDocument(document: string): boolean
Validates if a document number is a valid CPF or CNPJ.
- document: The document number to be validated (can be formatted or contain only numbers/letters)
- Returns: True if the document is a valid CPF or CNPJ, false otherwise
#### formatDocument(document: string): string
Formats a document number as CPF or CNPJ based on its characteristics.
- document: The document number to be formatted (can be formatted or contain only numbers/letters)
- Returns: The formatted document or an empty string if invalid
#### cleanNumbers(value: string): string
Removes all non-numeric characters from a string.
- value: The string to be cleaned
- Returns: A string containing only numbers
#### cleanAlphanumeric(value: string): string
Removes all non-alphanumeric characters from a string.
- value: The string to be cleaned
- Returns: A string containing only letters and numbers
To run the tests:
`bash`
npm test
To run the tests with coverage:
`bash``
npm run test:coverage
MIT