gerador-validador-cnpj
TypeScript icon, indicating that this package has built-in type declarations

2.1.0 • Public • Published

gerador-validador-cnpj

Tests GA Workflow Status Coverage Status Mutation Score

Biblioteca JS para gerar e validar CNPJ Alfanumérico do Brasil.

Novo CNPJ Alfanumérico

A Receita Federal modificou o algoritmo do CNPJ para comportar caracteres alfanuméricos devido a eminente possibilidade de esgotamento dos atuais números. A modificação começa a valer a partir de Julho de 2026.

Números atuais continuam válidos. Leia mais em compatibilidade.

Docs

Leia em outros idiomas: English, Español e Português(Brasil)

Playground

TODO

Instalação

Instalação com npm:

npm install gerador-validador-cnpj

Instalação com deno(jsr):

deno add jsr:@tiagoporto/gerador-validador-cnpj

Uso

Gerando CNPJ

import { generate as generateCNPJ } from 'gerador-validador-cnpj'
// jsr import from "@tiagoporto/gerador-validador-cnpj"

const cnpj = generateCNPJ()
console.log(cnpj) // 00000000000000

const formattedCNPJ = generateCNPJ({ format: true })
console.log(formattedCNPJ) // 00.000.000/0000-00

// alphanumeric default is false
const alphanumericCNPJ = generateCNPJ({ alphanumeric: true })
console.log(alphanumericCNPJ) // W3.U42.DFI/PRD7-00

Validando CNPJ

import { validate as validadeCNPJ } from 'gerador-validador-cnpj'
// jsr import from "@tiagoporto/gerador-validador-cnpj"

const isCNPJValid = validadeCNPJ('01234567890000')
const isCNPJAlphanumericValid = validadeCNPJ('9ZW2JIM2OWTG85', {
  validateAlphanumeric: true
})
const isFormattedCNPJValid = validadeCNPJ('01.234.567/8900-00')
const isFormattedCNPJAlphanumericValid = validadeCNPJ('8I.S4O.LPO/PRD7-81', {
  validateAlphanumeric: true
})

Compatibilidade

Para forçar a validação de CNPJs não alfa numéricos até Julho de 2026 e não quebrar nenhum sistema, a opção validateAlphanumeric estará disponível até Junho de 2026, sendo removida em Julho de 2026 assim que entra em vigor os novos CNPjs.

Por default validateAlphanumeric é false.

Licença

Este projeto está licenciado sob a licença MIT.

Package Sidebar

Install

npm i gerador-validador-cnpj

Weekly Downloads

62

Version

2.1.0

License

MIT

Unpacked Size

15.1 kB

Total Files

22

Last publish

Collaborators

  • tiagoporto