Pular para o conteúdo
FiscalAPI
NF-e

Resumo x XML Completo: Por Que a Chave de Acesso Não Baixa o XML Sozinha

Equipe FiscalAPI 6 min de leitura
NF-eXMLCertificado DigitalSEFAZ

A chave de acesso, sozinha, não baixa o XML completo da NF-e: a consulta pública por chave só devolve o resumo da nota, e o XML assinado (`nfeProc`) exige certificado digital de quem participou da operação. Se você chegou aqui buscando "baixar XML sem certificado", a resposta honesta é: na esmagadora maioria dos casos, não dá — e neste post explicamos exatamente por quê, o que mudou na lei e qual é o caminho legítimo para obter o arquivo com validade jurídica.

O que aconteceu com a consulta pública da NF-e#

Até alguns anos atrás, era possível digitar a chave de acesso de 44 dígitos no portal nacional da NF-e e visualizar boa parte do conteúdo da nota. Isso acabou.

Desde 07/07/2020, por força do Ajuste SINIEF 16/2018, a consulta pública por chave de acesso passou a retornar apenas o resumo da NF-e. A mudança foi feita para proteger dados comerciais sensíveis: itens, valores unitários, fornecedores e tributos não devem ficar expostos a qualquer pessoa que tenha a chave em mãos.

Ou seja: a chave continua sendo o "endereço" da nota dentro da SEFAZ, mas o acesso ao conteúdo detalhado virou privilégio de quem tem relação com a operação.

Diferença entre resumo e XML da nota#

Esse é o ponto que mais gera confusão. Muita gente acha que "consultar pela chave" e "baixar o XML" são a mesma coisa. Não são.

  • Resumo (consulta pública): uma fotografia mínima da nota. Confirma que ela existe, está autorizada e a quem pertence — nada além disso.
  • XML completo (`nfeProc`): o documento fiscal em si, assinado digitalmente, com todos os itens, tributos, dados de transporte e cobrança. É ele que tem validade jurídica e precisa ser guardado por 5 anos.

Veja o que cada um realmente entrega:

Campo / informaçãoResumo (consulta pública)XML completo (nfeProc)
Número e série da notaSimSim
Chave de acessoSimSim
Razão social / CNPJ do emitenteSimSim
Valor total da notaSimSim
Situação (autorizada/cancelada) e eventosSimSim
Itens / produtos (descrição completa)NãoSim
NCM, CFOP, CST de cada itemNãoSim
Impostos (ICMS, IPI, PIS, COFINS)NãoSim
Dados de transporte e cobrançaNãoSim
Assinatura digital com validade jurídicaNãoSim

Resumindo: o resumo serve para conferir se a nota é real; o XML serve para escriturar, auditar e arquivar.

Por que a consulta só mostra o resumo#

Porque o conteúdo completo de uma NF-e é informação fiscal e comercial protegida. Liberar o nfeProc para qualquer um que digitasse a chave significaria expor margens, fornecedores, preços e estrutura tributária de empresas inteiras.

Por isso a SEFAZ só entrega o XML completo a um participante da nota, identificado por certificado digital:

  • Emitente — quem emitiu a NF-e;
  • Destinatário — para quem a nota foi emitida;
  • Transportador indicado no documento;
  • Autorizado a baixar — o famoso autXML, CNPJ/CPF que o emitente autorizou expressamente dentro da própria nota.

Sem se enquadrar em uma dessas posições — e sem certificado para provar isso — não há acesso ao XML completo. É uma regra de negócio da própria SEFAZ, não uma limitação de ferramenta.

E o "baixar XML sem certificado"? Existe alguma exceção?#

Existe uma exceção, mas ela é limitada e não cobre o cenário mais comum (consultar nota de terceiros).

NF-e destinada a CPF ou a CNPJ sem inscrição estadual pode ser baixada pelo próprio destinatário sem certificado digital. É o caso, por exemplo, do consumidor pessoa física que comprou e quer o XML da sua compra.

Fora disso, "baixar XML sem certificado" da nota de outra empresa simplesmente não é permitido. E aqui vale o alerta:

Os geradores "grátis" de DANFE pela chave não entregam o XML. Eles montam um PDF reconstruído (uma representação gráfica aproximada da nota), sem assinatura digital e sem validade jurídica.

Se o objetivo é escrituração contábil, defesa em fiscalização ou guarda legal, um PDF reconstruído não substitui o nfeProc. O XML assinado é o único documento que vale.

DANFE não é XML — e isso importa#

Vale fixar a diferença, porque ela aparece o tempo todo:

  • DANFE (PDF): representação gráfica, feita para impressão e leitura humana. Pode ser reconstruída a partir do resumo.
  • XML (`nfeProc`): o documento fiscal eletrônico, assinado, com validade jurídica e obrigatório na guarda por 5 anos.

Aceitar um DANFE em PDF no lugar do XML é como guardar a foto de um contrato em vez do contrato assinado.

O caminho legítimo para obter o XML completo#

Resumindo tudo, só há dois caminhos corretos para chegar ao nfeProc:

  1. Ser participante da nota + ter certificado digital. Emitente, destinatário, transportador ou autXML consultam o XML completo na SEFAZ usando o certificado que comprova essa relação.
  2. Manifestação do destinatário. Quando a nota é emitida contra o seu próprio CNPJ, você pode manifestar ciência/confirmação e receber o XML — também via certificado.

Em ambos os casos, o certificado digital é o que destrava o conteúdo. Não há atalho "grátis e sem certificado" para o XML completo de notas de terceiros.

Como a FiscalAPI resolve isso#

Se você é participante da nota e tem o certificado, a parte chata é a integração com a SEFAZ. É exatamente o que a NF-e por Chave automatiza:

  • Você informa a chave de acesso + seu certificado digital;
  • A FiscalAPI consulta a SEFAZ e devolve o XML completo (nfeProc), pronto para escrituração;
  • Zero custódia: não armazenamos o seu certificado;
  • Cobrança justa: 1 crédito por chave que retorna XML — se não vier XML, não cobra.

Nada de prometer o impossível: continua valendo a regra da SEFAZ (você precisa ser participante). O que entregamos é a forma mais simples de exercer esse direito sem montar toda a integração por conta própria.

Quer ver o passo a passo? Veja como baixar o XML da NF-e pela chave e a documentação do endpoint.

Perguntas frequentes#

Dá para baixar o XML completo da NF-e só com a chave de acesso?#

Não. A chave identifica a nota, mas a consulta pública por chave devolve apenas o resumo. O XML completo (nfeProc) exige certificado digital de um participante da operação.

Existe alguma forma de baixar o XML sem certificado?#

Só num caso específico: NF-e destinada a CPF ou a CNPJ sem inscrição estadual pode ser baixada pelo próprio destinatário sem certificado. Para notas de terceiros, não há caminho legítimo sem certificado.

O PDF que esses sites geram pela chave serve como XML?#

Não. Esses geradores entregam um DANFE em PDF reconstruído a partir do resumo — uma representação gráfica sem assinatura digital. Ele não tem validade jurídica e não substitui o nfeProc para escrituração ou fiscalização.

Qual a diferença prática entre resumo e XML completo?#

O resumo serve para confirmar que a nota existe, está autorizada e a quem pertence. O XML completo traz itens, NCM, CFOP, CST, impostos e dados de transporte, com assinatura digital e validade jurídica — é ele que você precisa guardar por 5 anos.

Por quanto tempo preciso guardar o XML da NF-e?#

O XML (nfeProc) deve ser arquivado por 5 anos. Por isso o arquivo assinado importa tanto: é o documento aceito em auditoria e fiscalização, não o PDF.


Tem a chave e o certificado, mas não quer montar a integração com a SEFAZ? Crie sua conta na FiscalAPI e obtenha o XML completo direto pela chave.


Leia também#

Compartilhar: WhatsApp LinkedIn Twitter

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 →