A chave de acesso aparece no DANFE, nos logs, nas consultas e nas reclamações de clientes, e o XML guarda todos os dados que a impressão resume. Ler a chave e localizar os grupos do XML permite conferir, sem depender da tela do sistema, de qual documento se trata e o que ele declara.
Os grupos do XML
O documento fica dentro do elemento infNFe, identificado pelo atributo Id, formado pelas letras NFe seguidas da chave de acesso. Os grupos principais são estes:
- ide: a identificação do documento, com o modelo, a série, o número, a data e a hora de emissão, o tipo de emissão e o ambiente;
- emit: o emitente, com o CNPJ, a inscrição estadual e o endereço;
- dest: o destinatário, obrigatório na NF-e e opcional na NFC-e em boa parte das vendas;
- det: um grupo para cada item, com o produto em prod e os tributos em imposto;
- total: os totais do documento;
- transp: o transporte;
- pag: as formas de pagamento;
- infAdic: as informações complementares;
- infNFeSupl: na NFC-e, o conteúdo do QR Code e o endereço de consulta;
- Signature: a assinatura digital.
Na NFC-e, o grupo pag traz o meio de pagamento de cada parte da venda, como dinheiro, cartão ou Pix, e nas vendas com cartão traz também dados da operação de pagamento.
Os valores do XML usam o ponto como separador decimal, como em 12.50, independentemente das configurações regionais do computador. As datas e as horas trazem o fuso, como em 2026-10-13T14:30:00-03:00.
A chave de acesso
A chave de acesso tem 44 posições e reúne dados do próprio documento, nesta ordem:
- posições 1 e 2: o código do estado do emitente, como 35 para São Paulo;
- posições 3 a 6: o ano e o mês da emissão;
- posições 7 a 20: o CNPJ do emitente;
- posições 21 e 22: o modelo, 55 ou 65;
- posições 23 a 25: a série;
- posições 26 a 34: o número do documento;
- posição 35: o tipo de emissão, normal ou em contingência;
- posições 36 a 43: um código numérico gerado pelo emitente;
- posição 44: o dígito verificador.
O dígito verificador é calculado sobre as outras 43 posições pelo método do módulo 11, e uma chave digitada com um número trocado é recusada antes de qualquer consulta.
A chave é a identidade do documento. Duas notas não têm a mesma chave, e a consulta, o cancelamento e os demais eventos usam a chave para localizar o documento.
O CNPJ alfanumérico
A partir de julho de 2026, a Receita Federal passou a atribuir às novas inscrições CNPJs com letras e números nas 12 primeiras posições, e os CNPJs existentes continuam como estão. Nas notas desses emitentes, a chave de acesso tem letras nas posições do CNPJ, e o dígito verificador é calculado com o valor de cada caractere na tabela ASCII, menos 48.
Sistemas, campos de banco de dados e rotinas que tratam a chave e o CNPJ como números deixam de funcionar com esses documentos. A recusa de uma chave válida de um fornecedor novo pode ter essa origem.
A série e a numeração
Cada emitente numera os documentos por modelo e por série, em sequência. Caixas diferentes costumam usar séries diferentes, para que dois caixas não disputem o mesmo número, e cada série segue a própria sequência.
Um número que foi pulado sem uso precisa ser inutilizado. Um número já usado em um documento autorizado, rejeitado ou denegado tem regras próprias de reaproveitamento, que dependem da situação do documento.
No suporte
Diante de uma dúvida sobre uma nota, convém partir da chave de acesso: ela mostra o estado, o mês, o emitente, o modelo, a série, o número e o tipo de emissão antes de qualquer consulta. Os dados que a chave não traz, como os itens e os pagamentos, ficam nos grupos do XML.
Para guardar
- O XML guarda o documento em grupos, como ide, emit, dest, det, total e pag.
- A chave de acesso tem 44 posições, com o estado, o mês, o CNPJ, o modelo, a série, o número, o tipo de emissão, um código e o dígito verificador.
- A chave identifica o documento nas consultas e nos eventos.
- A numeração segue por modelo e por série.
- O CNPJ alfanumérico, a partir de julho de 2026, coloca letras na chave dos novos emitentes.
Uma chave começa com 35, e as posições 21 e 22 trazem 65. O que já se sabe sobre o documento?
Que é uma NFC-e emitida por um estabelecimento de São Paulo. As posições 3 a 6 mostram o ano e o mês da emissão, e a posição 35 mostra se a emissão foi normal ou em contingência.
O sistema passou a recusar a chave das notas de um fornecedor novo, com a mensagem de chave inválida, embora a nota exista na SEFAZ. O que pode explicar?
O fornecedor pode ter um CNPJ alfanumérico, e a chave da nota traz letras nas posições do CNPJ. Uma rotina que aceita só números ou que calcula o dígito verificador do jeito antigo recusa uma chave válida.