README

Biblioteca PHP para validacao de CNPJ (numerico e alfanumerico) com suporte a mascaras.

Requisitos

PHP 8.1 ou superior

Instalacao

composer require luancosta/is-cnpj

Uso

Validacao de CNPJ

<?php

use LuanCosta\IsCnpj\CnpjValidator;

// Validar CNPJ numerico
CnpjValidator::isValid('11222333000181'); // true
CnpjValidator::isValid('11.222.333/0001-81'); // true (remove mascara automaticamente)
CnpjValidator::isValid('00000000000000'); // false (todos digitos iguais)

// Validar CNPJ alfanumerico
CnpjValidator::isValid('34028316000103'); // true
CnpjValidator::isValid('ABC123456789XY'); // valida se os digitos verificadores estao corretos

// Validacao especifica para CNPJ numerico
CnpjValidator::validateNumeric('11222333000181'); // true
CnpjValidator::validateNumeric('ABC123456789XY'); // false

// Validacao especifica para CNPJ alfanumerico
CnpjValidator::validateAlphanumeric('34028316000103'); // true

Calcular Digitos Verificadores

<?php

use LuanCosta\IsCnpj\CnpjValidator;

// Calcular digitos verificadores de um CNPJ alfanumerico
$digitos = CnpjValidator::calculateCheckDigits('340283160001'); // retorna '03'

Formatacao de CNPJ

<?php

use LuanCosta\IsCnpj\CnpjFormatter;

// Aplicar mascara
CnpjFormatter::mask('11222333000181'); // 11.222.333/0001-81
CnpjFormatter::mask('ABC123456789XY'); // AB.C12.345/6789-XY

// Remover mascara
CnpjFormatter::unmask('11.222.333/0001-81'); // 11222333000181
CnpjFormatter::unmask('AB.C12.345/6789-XY'); // ABC123456789XY

// Verificar se esta com mascara
CnpjFormatter::isMasked('11.222.333/0001-81'); // true
CnpjFormatter::isMasked('11222333000181'); // false

CNPJ Alfanumerico

A partir de 2026, a Receita Federal permitira CNPJs alfanumericos. Esta biblioteca suporta:

Validacao de CNPJs alfanumericos (letras A-Z e numeros 0-9)
Calculo automatico dos digitos verificadores
Aplicacao de mascara

Especificacao

O CNPJ alfanumerico segue as seguintes regras:

12 caracteres base + 2 digitos verificadores
Caracteres validos: A-Z e 0-9
Calculo dos digitos usa pesos de 2 a 9, da direita para esquerda
Cada caractere tem um valor especifico (0-9 = 0-9, A = 17, B = 18, ..., Z = 42)

Testes

Para rodar os testes:

composer install
vendor/bin/phpunit

Licenca

MIT License

Autor

Luan Costa

luancosta / is-cnpj

Maintainers

Details