ricardocechinel/cnpj-alfanumerico

Biblioteca PHP para validar, gerar dígitos verificadores e criar CNPJ alfanumérico válido conforme as regras oficiais do SERPRO e RFB.

v1.0.1 2025-11-18 04:50 UTC

Requires

• php: >=7.4

Requires (Dev)

• phpunit/phpunit: ^9.0

MIT

• Ricardo Cechinel

• generator
• php
• validator
• cnpj
• modulo 11
• SERPRO
• cnpj alfanumerico
• digito verificador

README

Biblioteca PHP para validar, gerar dígitos verificadores (DV) e criar CNPJ alfanumérico válido, seguindo rigorosamente as regras oficiais publicadas pelo SERPRO e pela Instrução Normativa RFB nº 2.119/2022.

Compatível com:

• PHP 7.4+
• PHP Puro
• CodeIgniter 4
• Laravel
• Qualquer projeto com PSR-4

📦 Instalação

Via Composer:

composer require ricardocechinel/cnpj-alfanumerico

🧩 Como Funciona

O CNPJ Alfanumérico possui:

• 12 caracteres alfanuméricos
• 2 dígitos verificadores numéricos

Cálculo baseado em:

• Código ASCII (valor - 48)
• Pesos de 2 a 9 (da direita para a esquerda)
• Módulo 11

Toda a lógica segue os documentos oficiais do SERPRO.

📚 Referências Oficiais

• Receita Federal — Programa CNPJ Alfanumérico
• SERPRO — Cálculo dos Dígitos Verificadores do CNPJ Alfanumérico

🚀 Uso

✔ 1. Validar um CNPJ alfanumérico

<?php
require __DIR__ . '/vendor/autoload.php';
use RicardoCechinel\CnpjAlfanumerico\CnpjAlfa;

$cnpj = "12ABC34501DE35";

if (CnpjAlfa::validar($cnpj)) {
    echo "CNPJ válido!";
} else {
    echo "CNPJ inválido!";
}

✔ 2. Gerar os dígitos verificadores (DV)

<?php
require __DIR__ . '/vendor/autoload.php';
use RicardoCechinel\CnpjAlfanumerico\CnpjAlfa;

$base = "12ABC34501DE"; // 12 caracteres
$dv = CnpjAlfa::gerarDV($base);

echo $dv; // Exemplo: "35"

✔ 3. Gerar um CNPJ alfanumérico completo e válido

<?php
require __DIR__ . '/vendor/autoload.php';
use RicardoCechinel\CnpjAlfanumerico\CnpjAlfa;

$novo = CnpjAlfa::gerarCnpj();

echo $novo; // Exemplo: A9BC12XY34ZP08

📁 Estrutura do Projeto

cnpj-alfanumerico/
 ├── src/
 │    └── CnpjAlfa.php
 ├── tests/
 ├── vendor/
 └── composer.json