Pular para o conteúdo
FiscalAPI
FiscalAPI
CT-e

Chave de acesso do CT-e: o que significa cada um dos 44 dígitos

Equipe FiscalAPI 6 min de leitura
CT-eChave de AcessoPythonGuia

A chave de acesso do CT-e tem 44 posições, nesta ordem: código da UF do emitente (2), ano e mês de emissão (4), CNPJ do emitente (14), modelo (2), série (3), número do CT-e (9), forma de emissão (1), código numérico (8) e dígito verificador (1), conforme o item 4.4 do Manual de Orientação do Contribuinte (MOC) do CT-e.

Os dígitos 21 e 22 dizem o tipo de documento: 57 é CT-e, 67 é CT-e OS e 64 é GTV-e. O último dígito confere os 43 anteriores e protege a chave contra erros de digitação.

Atualizado em 16 de novembro de 2026.

As 44 posições, uma a uma

Exemplo fictício: 5126 1012 3456 7800 0195 5700 1000 0001 2311 2345 6785.

PosiçõesCampoNo exemploO que significa
1 e 2cUF51Código IBGE da UF do emitente: 51 é Mato Grosso
3 a 6AAMM2610Ano e mês de emissão: outubro de 2026
7 a 20CNPJ12345678000195CNPJ do emitente, a transportadora
21 e 22mod57Modelo: 57 CT-e, 67 CT-e OS, 64 GTV-e
23 a 25serie001Série 1
26 a 34nCT000000123Número 123
35tpEmis1Forma de emissão: normal
36 a 43cCT12345678Código numérico gerado pelo emitente
44cDV5Dígito verificador

O código numérico é um número aleatório que o emitente gera para cada CT-e, para evitar acessos indevidos ao documento (MOC do CT-e, Leiaute, campo cCT).

Forma de emissão (posição 35)

CódigoForma de emissão
1Normal
2Contingência offline
3Regime Especial da Nota Fiscal Fácil (NFF)
4EPEC pela SVC (o evento EPEC não é mais aceito)
5Contingência FSDA (não é mais aceita)
7Autorização pela SVC-RS
8Autorização pela SVC-SP

Os códigos estão no Leiaute do MOC do CT-e, campo tpEmis. Chaves antigas com 4 ou 5 continuam existindo, mas o MOC informa que o tipo 5 deixou de ser aceito e que o evento EPEC não é mais recebido (QR Code e Consulta Pública, item 2.3.2). No CT-e emitido pelo aplicativo da NFF, as posições 1 e 2 trazem a UF do carregamento e as posições do CNPJ trazem o CPF do transportador autônomo, com zeros à esquerda (MOC do CT-e, Visão Geral, item 4.6).

CNPJ alfanumérico na chave

A chave continua com 44 posições, mas as 12 primeiras posições do CNPJ (posições 7 a 18 da chave) passam a aceitar letras maiúsculas. A expressão regular oficial é [0-9]{6}[A-Z0-9]{12}[0-9]{26}. No cálculo do dígito verificador, cada caractere vale o seu código ASCII menos 48: os números continuam iguais e as letras viram A = 17, B = 18, C = 19, e assim por diante (MOC do CT-e, Tabelas e Informações, item 2.3.3).

Quem limpa a chave com uma regra que tira tudo que não é número arranca as letras do CNPJ e quebra a chave. Tire só espaços, pontos e traços.

O dígito verificador

O dígito é calculado pelo módulo 11 sobre as 43 primeiras posições. Cada caractere é multiplicado por pesos de 2 a 9, da direita para a esquerda, recomeçando em 2 depois do 9. Some tudo e divida por 11: o dígito é 11 menos o resto, e vira 0 quando o resto é 0 ou 1 (MOC do CT-e, Tabelas e Informações, item 2.3).

Validador em Python

O código abaixo limpa a chave, confere o formato, separa as partes e confere o dígito verificador. Funciona com CNPJ numérico e alfanumérico.

python
import re

UFS = {"11": "RO", "12": "AC", "13": "AM", "14": "RR", "15": "PA", "16": "AP",
       "17": "TO", "21": "MA", "22": "PI", "23": "CE", "24": "RN", "25": "PB",
       "26": "PE", "27": "AL", "28": "SE", "29": "BA", "31": "MG", "32": "ES",
       "33": "RJ", "35": "SP", "41": "PR", "42": "SC", "43": "RS", "50": "MS",
       "51": "MT", "52": "GO", "53": "DF"}
MODELOS = {"57": "CT-e", "67": "CT-e OS", "64": "GTV-e"}


def dv_chave(chave43):
    # Módulo 11, pesos 2 a 9 da direita para a esquerda; letra vale ASCII - 48
    soma, peso = 0, 2
    for c in reversed(chave43):
        soma += (ord(c) - 48) * peso
        peso = 2 if peso == 9 else peso + 1
    resto = soma % 11
    return 0 if resto < 2 else 11 - resto


def ler_chave_cte(chave):
    chave = re.sub(r"[^0-9A-Z]", "", chave.upper())
    if len(chave) == 47 and chave.startswith("CTE"):
        chave = chave[3:]  # Id do XML: "CTe" + chave
    if not re.fullmatch(r"[0-9]{6}[A-Z0-9]{12}[0-9]{26}", chave):
        raise ValueError("A chave tem 44 posições; letras só no CNPJ do emitente")
    return {
        "uf": UFS.get(chave[0:2], "código desconhecido"),
        "ano_mes": f"20{chave[2:4]}-{chave[4:6]}",
        "emitente": chave[6:20],
        "modelo": MODELOS.get(chave[20:22], f"não é CT-e ({chave[20:22]})"),
        "serie": int(chave[22:25]),
        "numero": int(chave[25:34]),
        "forma_emissao": chave[34],
        "codigo_numerico": chave[35:43],
        "dv_confere": dv_chave(chave[:43]) == int(chave[43]),
    }


print(ler_chave_cte("5126 1012 3456 7800 0195 5700 1000 0001 2311 2345 6785"))

Com a chave do exemplo, a saída é UF MT, 2026-10, emitente 12345678000195, modelo CT-e, série 1, número 123, forma de emissão 1 e dv_confere: True. Com o exemplo de cálculo do MOC, dv_chave("5206043300991100250655012000000780026730161") devolve 5, como no manual.

Erros comuns com a chave do CT-e

  • Chave de NF-e no lugar da de CT-e. Se os dígitos 21 e 22 são 55, é uma nota fiscal. A NF-e tem a mesma estrutura de 44 posições, mas outro modelo. Para ela, use o XML da NF-e pela chave.
  • Chave copiada pela metade. Acontece ao copiar do PDF do DACTE. Conte as posições: são 44.
  • Prefixo "CTe" colado. No XML, o atributo Id do grupo infCte é "CTe" seguido da chave. O painel e a API da FiscalAPI aceitam a chave com esse prefixo, e o validador acima também.
  • Letras arrancadas. Com CNPJ alfanumérico, a limpeza que tira tudo que não é número deixa a chave com menos de 44 posições.

Perguntas frequentes

Onde fica a chave de acesso do CT-e? Impressa no DACTE, com o código de barras e o QR Code, e no XML, no atributo Id do grupo infCte.

Como saber pela chave se é CT-e, CT-e OS ou GTV-e? Pelos dígitos 21 e 22: 57 é CT-e, 67 é CT-e OS e 64 é GTV-e.

A chave do CT-e pode ter letras? Sim, nas posições 7 a 18, que são as 12 primeiras posições do CNPJ alfanumérico do emitente. O resto é sempre número.

A chave mostra quem é o tomador? Não. A chave traz só o CNPJ do emitente. O tomador está no XML: no CT-e (modelo 57), indicado no grupo toma3 ou toma4.

Com a chave válida, consigo o XML? Com a chave e o certificado A1 de quem participa do CT-e, sim. Veja como baixar o XML do CT-e pela chave de acesso.

Fontes

Artigos relacionados


Chave conferida? Baixe o XML em CT-e por Chave, com o certificado A1 de quem participa do frete.

Compartilhar: WhatsApp LinkedIn Twitter

Baixe o XML do CT-e pela chave

XML completo e assinado do CT-e, CT-e OS ou GTV-e, com o certificado A1 de quem participa do frete. Só cobra quando o XML vem.

Ver o XML do CT-e pela chave