Validador e gerador do novo CNPJ Alfanumérico brasileiro (Instrução Normativa RFB nº 2.229/2024), com suporte a CNPJs numéricos tradicionais.
Parte do monorepo novo-cnpj — implementações em TypeScript, Go, PHP, Python e JVM com o mesmo algoritmo e casos de teste.
pip install novo-cnpjRequer Python 3.9+. Sem dependências externas.
from novo_cnpj import CnpjValidator
# Validação — aceita com ou sem máscara, maiúsculas e minúsculas
CnpjValidator.is_valid("12.ABC.345/01AB-77") # True
CnpjValidator.is_valid("12.abc.345/01ab-77") # True — normaliza automaticamente
CnpjValidator.is_valid("11.222.333/0001-81") # True — CNPJ numérico tradicional
CnpjValidator.is_valid("00000000000000") # False — sequência uniforme
CnpjValidator.is_valid(None) # False — não é string
# Normalização — retorna 14 chars sem máscara ou lança ValueError
CnpjValidator.create("12.abc.345/01ab-77") # "12ABC34501AB77"
CnpjValidator.create("12ABC34501AB35") # raises ValueError: Invalid Alphanumeric CNPJ!
# Geração de CNPJs válidos aleatórios
CnpjValidator.generate() # ["A1B2C3D4E5F677"] — 1 CNPJ
CnpjValidator.generate(5) # ["...", "...", ...] — 5 CNPJs# Instalar em modo editável com dependências de dev
pip install -e ".[dev]"
# Rodar os testes
pytest -v tests/Ou via Docker (sem nenhuma dependência local):
# Na raiz do monorepo
make test-pythonMIT