chNFe em infProt: vincular o protocolo à NF-e correta

chNFe, em /nfeProc/protNFe/infProt/chNFe, identifica a NF-e ou NFC-e à qual a resposta individual se refere. É obrigatória em infProt. Antes de associar um protocolo a uma nota, compare essa chave com a identificação da nota original e confirme também o ambiente.

Como conferir o vínculo

O Id de infNFe usa o prefixo NFe seguido da chave. Para comparar com chNFe, separe esse prefixo na identificação original e confronte a sequência integral. Não compare só número da nota, série, final da chave ou nome do arquivo: esses dados isolados não identificam o mesmo documento com segurança.

A chave contém componentes como UF, ano/mês, identificação do emitente, modelo, série, número, tipo de emissão, código numérico e dígito verificador. Confirme os campos da própria nota. Uma chave de formato válido não prova que o protocolo lhe pertence ou que a autorização existe.

A chave atual deve ser preservada como texto

TChNFe do PL_010f_v1.04 admite 44 caracteres com padrão [0-9]{6}[0-9A-Z]{12}[0-9]{26}. A NT 2026.004 v1.01 atualizou os campos de chave para adequação ao CNPJ alfanumérico, com homologação prevista até 15/06/2026 e produção em 01/07/2026. Isso altera o domínio técnico; não significa que todas as chaves existentes passaram a conter letras.

Não converta a chave em inteiro: além do domínio alfanumérico, zeros e precisão integral precisam ser preservados. Também não remova caracteres por uma máscara antiga exclusivamente numérica. A conferência de dígito verificador e da composição é adicional à aceitação pelo XSD.

Exemplos de reconciliação sem uma chave inventada

Cenário A: o sistema associa a resposta pelo número da nota e encontra dois documentos com o mesmo número em séries diferentes. A correção é conferir a chave completa, o emitente e o ambiente, em vez de escolher o primeiro registro.

Cenário B: chNFe coincide com a identificação da nota, mas o retorno é de homologação e a aplicação procurava produção. A coincidência não prova autorização no ambiente desejado; os arquivos e consultas precisam continuar separados.

Não há XML completo nem chave sintética neste exemplo. Para demonstrar o vínculo operacional seria indispensável usar a chave original protegida. A representação textual descreve a comparação sem produzir um documento fiscal fictício.

O que fazer quando chNFe diverge

Preserve os arquivos recebidos, rastreie lote/requisição, resposta individual e associação no armazenamento. Verifique se houve troca entre notas, empresas ou ambientes. Não substitua chNFe no protocolo para fazê-lo coincidir: isso altera o conteúdo da resposta e pode quebrar sua assinatura. Recupere a resposta correta e investigue a origem da associação.

Uma chave correta precisa ser lida com cStat/xMotivo, nProt e digest quando presentes. Para situação atual, consulte o documento e seus eventos no ambiente correto; a chave sozinha não informa autorização, cancelamento ou conclusão local.

Leituras relacionadas

• tpAmb — /nfeProc/protNFe/infProt/tpAmb
• digVal — /nfeProc/protNFe/infProt/digVal

Fontes oficiais

• Leiaute NF-e/NFC-e — PL_010f_v1.04: TProtNFe, linhas 6686–6770.
• Tipos básicos NF-e/NFC-e — PL_010f_v1.04: TChNFe, TProt, TStat, TAmb, TVerAplic, TMotivo e TDateTimeUTC.
• NT 2025.002 RTC — 1.52: seção 5.1, p. 11; PR03–PR90, p. 13.
• NT 2026.004 CNPJ alfanumérico — 1.01: chave de acesso, leiaute e cronograma.