Chaves de Acesso

Monte e valide a chave de acesso de NFe/NFC-e/CT-e (numérica ou alfanumérica) e decomponha a chave de NFS-e Padrão Nacional, gratuito e sem login.

Montar chave de acesso

Validar chave de acesso

Anatomia da chave de 44 posições (NF-e, NFC-e, CT-e)

A chave de acesso não é um identificador sorteado. Ela é a concatenação de campos do próprio documento, e por isso dá para ler boa parte do que é a nota só pela chave:

PosiçõesCampoConteúdo
1–2cUFCódigo IBGE da UF do emitente
3–6AAMMAno e mês de emissão
7–20CNPJ/CPFEmitente; pode ser alfanumérico (novo CNPJ)
21–22modModelo: 55 NF-e, 65 NFC-e, 57 CT-e
23–25serieSérie do documento
26–34nNFNúmero do documento
35tpEmisForma de emissão: normal ou contingência
36–43cNFCódigo numérico aleatório
44cDVDígito verificador (módulo 11)

O cNF existe para que ninguém consiga deduzir a chave de uma nota alheia só conhecendo emitente, série e número. Ele deve ser aleatório de verdade: repetir o próprio número da nota ou usar uma sequência derrota o propósito e pode ser rejeitado pelo autorizador.

O tpEmis está dentro da chave, então a mesma nota emitida em contingência tem outra chave. Uma nota que falhou em emissão normal e foi reemitida em SVC-AN (6) ou SVC-RS (7) é outro documento. Essa é uma fonte comum de nota "duplicada" em integrações que reaproveitam a chave depois de trocar a forma de emissão. Qual SVC vale para cada UF está em Autorizadores por UF.

Como o dígito verificador é calculado

O último caractere é um módulo 11 sobre os 43 anteriores. Da direita para a esquerda, cada caractere é multiplicado por um peso que vai de 2 a 9 e recomeça em 2. Os produtos são somados e a soma é dividida por 11. Se o resto for 0 ou 1, o dígito é 0. Caso contrário, o dígito é 11 menos o resto.

Com o CNPJ alfanumérico, as letras da faixa do emitente também entram no cálculo, convertidas em valor numérico pela mesma regra usada no dígito verificador do próprio CNPJ alfanumérico. Um validador que só aceita dígitos vai rejeitar chaves legítimas a partir da adoção do novo formato. Vale conferir isso na sua base de código antes que o primeiro fornecedor com CNPJ alfanumérico apareça.

A chave de 50 posições da NFS-e Padrão Nacional

A NFS-e nacional usa outro layout, com 50 posições, montado a partir do município e do emitente em vez da UF:

PosiçõesCampoConteúdo
1–7cMunCódigo IBGE do município emissor
8ambiente1 sistema próprio do município, 2 Sefin Nacional
9tpInsc1 CPF, 2 CNPJ
10–23inscriçãoCPF ou CNPJ do emitente (CPF com zeros à esquerda)
24–36nNFSeNúmero da NFS-e
37–40AAMMAno e mês de emissão
41–49códigoCódigo numérico
50DVDígito verificador

O campo de ambiente gerador indica quem gerou a nota: o sistema próprio do município conveniado ou o emissor nacional (Sefin Nacional). Ele ajuda a entender por que duas notas do mesmo prestador podem ter comportamentos diferentes na consulta. Como indicado na ferramenta, a fórmula do dígito final da chave de NFS-e não está documentada em fonte oficial disponível, então ele é exibido mas não conferido.