XML e chave de acesso são a mesma coisa? O que é o nfeProc
Não. A chave de acesso é o número de 44 dígitos que identifica uma NF-e. O XML é o arquivo da nota, com produtos, impostos e a assinatura do emitente. O nfeProc é esse XML junto com o protocolo de autorização da SEFAZ, e é ele que vale como documento fiscal. Com a chave você encontra a nota. Para ter o XML, precisa baixá-lo.
Chave, XML, nfeProc e DANFE#
| O quê | O que é | Serve como documento fiscal? |
|---|---|---|
| Chave de acesso | 44 dígitos que identificam a nota: UF, ano e mês, CNPJ ou CPF do emitente, modelo, série, número, forma de emissão, código aleatório e dígito verificador | Não. É o "endereço" da nota |
| XML da NF-e (NFe) | O arquivo com todos os dados da nota, assinado pelo emitente | Sozinho, não prova que a SEFAZ autorizou |
| nfeProc (procNFe) | O XML da NF-e mais o protocolo de autorização (protNFe) | Sim. É o arquivo que o emitente envia ao destinatário e os dois guardam |
| DANFE | A impressão do XML, em papel ou PDF | Não substitui o XML |
O que tem dentro do nfeProc#
Um nfeProc tem dois blocos. O primeiro é a nota assinada. O segundo é a resposta da SEFAZ:
<nfeProc versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe">
<NFe>
<infNFe Id="NFe3526...0019" versao="4.00">
<!-- emitente, destinatário, produtos, impostos, totais -->
</infNFe>
<Signature><!-- assinatura do emitente --></Signature>
</NFe>
<protNFe versao="4.00">
<infProt>
<chNFe>3526...0019</chNFe>
<dhRecbto>2026-09-15T10:32:08-03:00</dhRecbto>
<nProt>135260000000000</nProt>
<digVal>...</digVal>
<cStat>100</cStat>
<xMotivo>Autorizado o uso da NF-e</xMotivo>
</infProt>
</protNFe>
</nfeProc>Valores do exemplo são fictícios. Repare que a chave aparece duas vezes: no atributo Id do infNFe, precedida de "NFe", e no chNFe do protocolo. O MOC sugere nomear o arquivo como <chave>-procNFe.xml.
Por que o XML sem protocolo não basta#
O XML assinado mostra o que o emitente enviou. Só o protNFe, com cStat 100 e número de protocolo, mostra que a SEFAZ autorizou. Por isso o Ajuste SINIEF 07/05 manda o emitente enviar ao destinatário o arquivo da NF-e com o respectivo protocolo de autorização, logo depois da autorização. Se você recebeu só o NFe, sem protNFe, peça o arquivo completo.
Tenho a chave. Como chego ao XML?#
A chave não carrega os dados da nota, então não dá para "gerar" o XML a partir dela. Você baixa o XML que a SEFAZ já tem, com o certificado digital de quem participa da nota (emitente, destinatário, transportador ou autorizado). O passo a passo está em como baixar o XML pela chave de acesso.
Na FiscalAPI, você cola a chave, usa o seu certificado e recebe o nfeProc completo, pelo painel ou pela API. Chave sem XML não é cobrada. Veja os planos.
Perguntas frequentes#
XML e chave de acesso são a mesma coisa? Não. A chave identifica a nota; o XML é o documento. Duas notas nunca têm a mesma chave, mas a chave não traz itens, valores nem impostos.
O que é nfeProc? É o XML da NF-e com o protocolo de autorização da SEFAZ. O nome vem da tag raiz nfeProc e do schema procNFe.
Dá para gerar o XML pela chave de acesso? Não se gera, se baixa. Com a chave e o certificado de um participante, você obtém o XML que está na SEFAZ.
O DANFE vale como nota? O DANFE acompanha a mercadoria e serve para consulta, mas o documento fiscal é o XML. Para escriturar e guardar, use o nfeProc.
Onde encontro a chave de acesso? No DANFE, abaixo do código de barras, em blocos de 4 dígitos. No XML, no chNFe do protocolo.
Fontes#
- MOC 7.0 Visão Geral, Portal da NF-e: composição da chave (item 2.2.6) e leiaute de distribuição da NF-e,
nfeProc(item 6.3) - Ajuste SINIEF 07/05, cláusula sétima, § 7º: envio do arquivo com o protocolo ao destinatário
Artigos relacionados#
Consulte dados fiscais via API
Consulte Inscrições Estaduais, CNPJs e Certidões Negativas via API REST. Dados direto da SEFAZ e Receita Federal. Planos a partir de R$ 19,99/mês.
Criar conta →