Validar CNPJ em Python

Rota 1: validar CNPJ em Python com o algoritmo local

Uma função só para os dois formatos. O parâmetro de modo legado rejeita letras para sistemas que ainda não migraram para o CNPJ alfanumérico.

# validador_cnpj.py (só stdlib)
import re

FORMATO_CNPJ = re.compile(r"[0-9A-Z]{2}\.?[0-9A-Z]{3}\.?[0-9A-Z]{3}/?[0-9A-Z]{4}-?\d{2}")
PESOS_1 = [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2]
PESOS_2 = [6] + PESOS_1  # pesos deslocados para o 2º DV (13 posições)


def _digito(base: str, pesos: list[int]) -> int:
    soma = sum((ord(c) - 48) * p for c, p in zip(base, pesos))  # '0'=0 ... '9'=9, 'A'=17 ... 'Z'=42
    resto = soma % 11
    return 0 if resto < 2 else 11 - resto


def valida_cnpj(cnpj: str, aceita_letras: bool = True) -> bool:
    """mod-11 da Receita Federal. Com aceita_letras=True cobre o CNPJ alfanumérico (IN RFB 2.229/2024)."""
    if not FORMATO_CNPJ.fullmatch(cnpj.strip()):
        return False
    c = re.sub(r"[./-]", "", cnpj.strip())
    if not aceita_letras and not c.isdigit():
        return False
    if len(set(c)) == 1:  # 00.000.000/0000-00 passa na conta, mas é inválido
        return False
    return int(c[12]) == _digito(c[:12], PESOS_1) and int(c[13]) == _digito(c[:13], PESOS_2)


if __name__ == "__main__":
    for cnpj in ("11.222.333/0001-81", "11222333000181", "12.ABC.345/01DE-35", "11.222.333/0001-82", "00.000.000/0000-00"):
        print(f"{cnpj:22} -> {valida_cnpj(cnpj)}")
    print("alfa bloqueado:", valida_cnpj("12.ABC.345/01DE-35", aceita_letras=False))

Como o cálculo do dígito verificador do CNPJ funciona

Um exemplo calculado à mão, para você conferir o código contra a conta.

CNPJ 11.222.333/0001-81

1º DV: soma dos 12 caracteres × pesos 5,4,3,2,9,8,7,6,5,4,3,2 = 102
      102 mod 11 = 3  ->  resto < 2 dá 0, senão 11 - resto  ->  DV1 = 8
2º DV: soma dos 13 caracteres × pesos 6,5,4,3,2,9,8,7,6,5,4,3,2 = 120
      120 mod 11 = 10  ->  DV2 = 1

CNPJ alfanumérico 12.ABC.345/01DE-35

Valor de cada caractere = código ASCII - 48:  0-9 valem 0 a 9,  A=17, B=18, C=19 ... Z=42
Valores: [1, 2, 17, 18, 19, 3, 4, 5, 0, 1, 20, 21]
1º DV: soma = 459,  459 mod 11 = 8  ->  DV1 = 3
2º DV: soma = 424,  424 mod 11 = 6  ->  DV2 = 5

Rota 2: conferir o validador com CNPJs da API do FakeForge

A API do FakeForge gera CNPJ tradicional (type=cnpj) e alfanumérico (type=cnpjAlfa), mas não tem endpoint de validação. Use os lotes gerados como oráculo: todos precisam passar, e com o último dígito trocado precisam falhar.

# confere_cnpj_api.py (stdlib). Salve o validador da Rota 1 como validador_cnpj.py
import json
import urllib.request

from validador_cnpj import valida_cnpj


def gera(tipo: str, qtd: int = 20) -> list[str]:
    with urllib.request.urlopen(f"https://fakeforge.com.br/api/generate?type={tipo}&quantity={qtd}", timeout=10) as resp:
        return json.load(resp)["data"]


def troca_ultimo_digito(cnpj: str) -> str:
    return cnpj[:-1] + str((int(cnpj[-1]) + 1) % 10)


for tipo, aceita_letras in (("cnpj", False), ("cnpjAlfa", True)):
    lote = gera(tipo)
    rejeitados = [c for c in lote if not valida_cnpj(c, aceita_letras)]
    aceitos = [c for c in lote if valida_cnpj(troca_ultimo_digito(c), aceita_letras)]
    print(f"{tipo}: {len(lote)} gerados | válidos rejeitados: {len(rejeitados)} | inválidos aceitos: {len(aceitos)}")
    assert not rejeitados and not aceitos

Como testar o validador de CNPJ com pytest

Rode com pytest -q. Os casos cobrem válidos, inválidos e as bordas de CNPJ.

# test_validador_cnpj.py (pytest)
import pytest

from validador_cnpj import valida_cnpj

NUMERICOS = ["11.222.333/0001-81", "11222333000181", "11.444.777/0001-61"]
ALFANUMERICOS = ["12.ABC.345/01DE-35", "12ABC34501DE35", "A1.B2C.3D4/0001-93"]
INVALIDOS = [
    "11.222.333/0001-82",  # DV errado
    "00.000.000/0000-00",  # repetidos
    "11.222.333/0001-8",   # curto demais
    "12.abc.345/01de-35",  # letras minúsculas não existem no padrão
    "",
]


@pytest.mark.parametrize("cnpj", NUMERICOS + ALFANUMERICOS)
def test_aceita_cnpj_valido(cnpj):
    assert valida_cnpj(cnpj) is True


@pytest.mark.parametrize("cnpj", INVALIDOS)
def test_rejeita_cnpj_invalido(cnpj):
    assert valida_cnpj(cnpj) is False


@pytest.mark.parametrize("cnpj", ALFANUMERICOS)
def test_modo_legado_rejeita_letras(cnpj):
    assert valida_cnpj(cnpj, aceita_letras=False) is False

Validar CNPJ: algoritmo local ou serviço externo

Perguntas frequentes sobre validar CNPJ em Python

Páginas relacionadas