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).

O objetivo é oferecer uma API simples, com suporte ao padrão novo e uma implementação mais cuidadosa do que a normalmente encontrada em bibliotecas desse tipo.

📘 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();
generator.generateCnpjV1();
generator.generateCnpjV2();

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

generateCpf();
generateCnpj();
generateCnpjV1();
generateCnpjV2();

CommonJS

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

generator.generateCpf();
generator.generateCnpj();
generator.generateCnpjV1();
generator.generateCnpjV2();

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

generateCpf();
generateCnpj();
generateCnpjV1();
generateCnpjV2();

🏢 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

🔹 "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";

// Aleatório entre v1 e v2
generateCnpj();

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

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

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

Sem argumento, generateCnpj() escolhe aleatoriamente entre "v1" e "v2".

Também é possível usar os geradores diretos:

import { generateCnpjV1, generateCnpjV2 } from "cpf_and_cnpj-generator";

generateCnpjV1();
generateCnpjV2();

☕ Apoie o projeto

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