Gerador de CPF e CNPJ

Este pacote fornece funções em JavaScript/TypeScript para gerar CPFs e CNPJs válidos, incluindo suporte à nova norma de CNPJ alfanumérico definida pela Receita Federal (SERPRO).

📘 Documentação

https://gabriel-logan.github.io/Gerador-CPF-e-CNPJ-valido

🌐 CDN

Atualmente, o pacote oferece suporte oficial apenas via ESM, utilizando jsDelivr.

https://cdn.jsdelivr.net/npm/[email protected]/+esm

Uso via CDN (ESM)

<script type="module">
  import generator from "https://cdn.jsdelivr.net/npm/[email protected]/+esm";
  import {
    generateCpf,
    generateCnpj,
  } from "https://cdn.jsdelivr.net/npm/[email protected]/+esm";

  generator.generateCpf();
  generator.generateCnpj();

  generateCpf();
  generateCnpj();
</script>

📦 Instalação

npm install cpf_and_cnpj-generator

yarn add cpf_and_cnpj-generator

pnpm add cpf_and_cnpj-generator

🚀 Como Usar

ES Modules

import generator from "cpf_and_cnpj-generator";

generator.generateCpf();
generator.generateCnpj();

import { generateCpf, generateCnpj } from "cpf_and_cnpj-generator";

generateCpf();
generateCnpj();

CommonJS

const generator = require("cpf_and_cnpj-generator");

generator.generateCpf();
generator.generateCnpj();

const { generateCpf, generateCnpj } = require("cpf_and_cnpj-generator");

generateCpf();
generateCnpj();

🏢 Geração de CNPJ — Versões Suportadas

Disponível a partir da versão >= 1.5.0 Esta versão inclui suporte à nova norma oficial de CNPJ alfanumérico.

O gerador de CNPJ suporta duas normas oficiais:

🔹 "v1" — CNPJ Numérico (norma tradicional)

• Formato: 14 dígitos numéricos
• Exemplo: 12.345.678/0001-95
• Norma amplamente utilizada
• Versão padrão do gerador

🔹 "v2" — CNPJ Alfanumérico (nova norma oficial)

• Formato: 12 caracteres alfanuméricos + 2 dígitos verificadores
• Exemplo: 12.ABC.345/01DE-35
• Norma oficial da Receita Federal / SERPRO
• Utiliza:
  • Conversão ASCII (ASCII - 48)
  • Módulo 11
  • Pesos de 2 a 9

📌 Uso das versões de CNPJ

import { generateCnpj, CNPJ_VERSIONS } from "cpf_and_cnpj-generator";

// Padrão (v1)
generateCnpj();

// Explícito
generateCnpj("v1");

// Nova norma alfanumérica
generateCnpj("v2");

// Usando constantes
generateCnpj(CNPJ_VERSIONS.V1);
generateCnpj(CNPJ_VERSIONS.V2);

Caso nenhuma versão seja informada, o gerador utiliza "v1" por padrão.

☕ Apoie o projeto

Se este pacote te ajudou, considere pagar um café ☺️