Adeus Regex de CNPJ: Valide o Novo Formato Alfanumérico no NestJS e TS ⚡

Leandro Gazoli — Tue, 07 Apr 2026 14:36:25 +0000

A Mudança que ninguém avisou (ou quase ninguém)

A Receita Federal e o SERPRO atualizaram o formato do CNPJ. Agora, além de números, teremos letras (alfanumérico). Se o seu sistema usa aquela Regex antiga de 2010, ele vai quebrar.

Para resolver isso de forma elegante e tipada, criei a cnpj-universal. Uma biblioteca ultra-leve (~2KB) que lida com a transição do formato legado para o novo sem dor de cabeça.

O que ela faz?

✅ Validação Dual: Aceita o formato antigo (11.222.333/0001-81) e o novo (12.ABC.345/01DE-35).
✅ NestJS Ready: Já vem com decorator @IsCNPJ() para seus DTOs.
✅ Zero Dependências: Performance pura e sem inchar seu projeto.
✅ Type-Safe: Escrita para TypeScript 5.x. ou superior.

Como implementar no NestJS (class-validator)

Esqueça as validações manuais no controller. Com a cnpj-universal, você usa como um decorator nativo:

import { IsCNPJ } from "cnpj-universal";

export class EmpresaDto {
  @IsCNPJ({ message: "CNPJ inválido (numérico ou alfanumérico)" })
  cnpj: string;
}

Uso em Vanilla JS/TS

Se você não usa NestJS, a classe utilitária resolve tudo:

import { CNPJ } from "cnpj-universal";

CNPJ.isValid("12.ABC.345/01DE-35"); // ✅ true
CNPJ.formatar("12ABC34501DE35");    // '12.ABC.345/01DE-35'

Conclusão

A transição para o CNPJ alfanumérico é gradual, mas obrigatória. Não espere o erro chegar no seu log de produção.

Explore o projeto, abra issues e contribua:
📦 NPM: cnpj-universal
⭐ GitHub: LeandroGazoli/cnpj-universal

LeandroGazoli / cnpj-universal

Validação de CNPJ numérico (legado) e alfanumérico (novo formato SERPRO) para NestJS e class-validator.

CNPJ Universal ⚡

Validador Type-Safe para CNPJ Numérico (Legado) e Alfanumérico (Novo Formato SERPRO).

Compatível com NestJS, class-validator e TypeScript/JavaScript puro, com suporte completo para ambos os formatos de CNPJ brasileiros.

📋 Índice

✨ Características

✅ Validação Dual: Suporta CNPJ numérico (legado) e alfanumérico (novo formato SERPRO)
✅ Sem Dependências Externas: Apenas class-validator como peer dependency
✅ Type-Safe: Totalmente tipado em TypeScript
✅ NestJS Ready: Funciona como decorator em DTOs
✅ Flexível: Com ou sem máscara (XX.XXX.XXX/XXXX-XX)
✅ Batch Operations: Métodos utilitários para cálculo de dígitos verificadores
✅ Leve: ~2KB minificado
✅ Zero Breaking Changes: API estável desde v1.0.0

🚀 Instalação

npm install cnpj-universal

Com yarn:

yarn add cnpj-universal

Com pnpm:

pnpm

…

View on GitHub

Validando CNPJ de forma definitiva: Conheça a cnpj-universal (JS/TS)

Leandro Gazoli — Tue, 07 Apr 2026 14:25:35 +0000

Se você trabalha com sistemas que consomem dados da Receita Federal, já sabe: o CNPJ mudou. O novo formato alfanumérico (ex: 12.ABC.345/0001-01) já é uma realidade e muitas bibliotecas de validação legadas simplesmente param de funcionar porque esperam apenas números.

Recentemente publiquei a cnpj-universal, uma biblioteca criada para ser a solução definitiva para quem precisa validar, formatar e gerar CNPJs.

Por que usar a `cnpj-universal`?

Diferente de implementações antigas, esta biblioteca foi construída pensando na transição. Ela valida tanto o formato clássico (numérico) quanto o novo formato alfanumérico, seguindo rigorosamente as notas técnicas da Receita Federal.

Híbrida: Suporta os dois formatos simultaneamente.
Minimalista: Zero dependências.
Type-safe: Feita em TypeScript para evitar erros em tempo de desenvolvimento.
Performance: Preparada para tree shaking.

Como usar

Instalação:

npm install cnpj-universal

Exemplo Prático:

import { validar, formatar, gerar } from 'cnpj-universal';

// Validando um CNPJ
const isValid = validar('12.345.678/0001-00'); // true/false

// Formatando (adiciona pontos, barra e traço)
const cnpjFormatado = formatar('12345678000100'); // "12.345.678/0001-00"

// Gerando um CNPJ válido para testes
const novoCnpj = gerar();

Principais Funcionalidades

Validação rigorosa: Algoritmo de dígitos verificadores completo.
Limpeza automática: Aceita strings com ou sem pontuação.
Suporte a ESM e CommonJS: Funciona no seu projeto legado ou no mais moderno com Next.js/Vite.

Conclusão

Se você está cansado de copiar e colar funções de validação entre projetos, dê uma chance ao cnpj-universal.

Acesse o repositório, deixe uma ⭐ e contribua:
https://www.npmjs.com/package/cnpj-universal

LeandroGazoli / cnpj-universal

Validação de CNPJ numérico (legado) e alfanumérico (novo formato SERPRO) para NestJS e class-validator.

CNPJ Universal ⚡

Validador Type-Safe para CNPJ Numérico (Legado) e Alfanumérico (Novo Formato SERPRO).

Compatível com NestJS, class-validator e TypeScript/JavaScript puro, com suporte completo para ambos os formatos de CNPJ brasileiros.

📋 Índice

✨ Características

🚀 Instalação

npm install cnpj-universal

Com yarn:

yarn add cnpj-universal

Com pnpm:

pnpm

…

View on GitHub

DEV Community: Leandro Gazoli

Adeus Regex de CNPJ: Valide o Novo Formato Alfanumérico no NestJS e TS ⚡

A Mudança que ninguém avisou (ou quase ninguém)

O que ela faz?

Como implementar no NestJS (class-validator)

Uso em Vanilla JS/TS

Conclusão

LeandroGazoli / cnpj-universal

Validação de CNPJ numérico (legado) e alfanumérico (novo formato SERPRO) para NestJS e class-validator.

CNPJ Universal ⚡

📋 Índice

✨ Características

🚀 Instalação

Validando CNPJ de forma definitiva: Conheça a cnpj-universal (JS/TS)

Por que usar a cnpj-universal?

Como usar

Principais Funcionalidades

Conclusão

LeandroGazoli / cnpj-universal

Validação de CNPJ numérico (legado) e alfanumérico (novo formato SERPRO) para NestJS e class-validator.

CNPJ Universal ⚡

📋 Índice

✨ Características

🚀 Instalação

Por que usar a `cnpj-universal`?