Fiscal · 2026-05-20 · 11 min

Como pesquisar XML pela chave de acesso da nota fiscal

Entenda como pesquisar uma nota fiscal pela chave de acesso, o que é XML da nota fiscal e quando é possível obter o arquivo XML.

Introdução

Pesquisar XML pela chave de acesso da nota fiscal é uma dúvida muito comum entre empresas, contadores, setores fiscais e pessoas que recebem notas fiscais eletrônicas. Muitas vezes, o usuário tem apenas o DANFE em PDF, a chave de acesso ou uma nota impressa, mas precisa localizar o XML para enviar à contabilidade, conferir os dados fiscais ou organizar os documentos do mês.

A chave de acesso é uma sequência de 44 dígitos que identifica a NF-e. Ela aparece no DANFE e permite consultar informações da nota fiscal eletrônica nos portais oficiais. No entanto, é importante entender uma diferença essencial: consultar uma nota pela chave de acesso não é sempre a mesma coisa que baixar o XML completo da nota.

Neste artigo, você vai entender o que é a chave de acesso, o que é o XML da nota fiscal, como pesquisar uma NF-e, quando é possível obter o XML e como organizar esses arquivos para evitar retrabalho na rotina contábil.

O que é a chave de acesso da nota fiscal?

A chave de acesso da nota fiscal eletrônica é um código numérico com 44 dígitos. Ela funciona como um identificador único da NF-e.

Com essa chave, é possível consultar a nota em ambientes oficiais, como o Portal Nacional da NF-e ou portais das Secretarias de Fazenda, conforme o caso.

A chave normalmente aparece no DANFE, próxima ao código de barras ou em uma área identificada como “Chave de Acesso”.

Exemplo simplificado:

Chave de acesso:
3526 0500 0000 0000 0000 5500 1000 0000 0010 0000 0000

Na hora de consultar, o ideal é informar apenas os números, sem espaços, pontos ou traços.

O que é XML da nota fiscal?

O XML da nota fiscal é o arquivo eletrônico estruturado da NF-e. Ele contém os dados fiscais da nota em um formato que pode ser lido por sistemas contábeis, fiscais e financeiros.

Dentro do XML, podem existir informações como:

  • CNPJ do emitente;
  • CNPJ ou CPF do destinatário;
  • número da nota;
  • série;
  • data de emissão;
  • produtos ou serviços;
  • NCM;
  • CFOP;
  • CST ou CSOSN;
  • valores;
  • impostos;
  • chave de acesso;
  • protocolo de autorização.

Enquanto o PDF e o DANFE são usados para visualização, impressão e conferência visual, o XML é mais útil para importação em sistemas, automação fiscal, organização contábil e geração de relatórios.

Pesquisar XML pela chave de acesso é possível?

Depende do que você quer dizer com “pesquisar XML”.

Se a intenção é consultar os dados da NF-e, a chave de acesso permite localizar informações da nota nos portais oficiais de consulta.

Se a intenção é baixar o XML completo, o processo pode depender de fatores como certificado digital, manifestação do destinatário, acesso ao sistema emissor, envio pelo fornecedor ou outro meio autorizado.

Por isso, a chave de acesso ajuda a localizar e conferir a nota, mas nem sempre garante, sozinha, o download do XML completo.

De forma simples:

Objetivo A chave de acesso ajuda? Observação
Consultar dados da NF-e Sim Pode ser feito em portal oficial de consulta
Confirmar se a nota existe Sim Ajuda a verificar situação e dados principais
Baixar XML completo Depende Pode exigir certificado, manifestação, sistema emissor ou envio pelo fornecedor
Conferir DANFE Sim A chave aparece no DANFE
Enviar XML ao contador Parcialmente O ideal é obter o arquivo XML original

Como consultar uma NF-e pela chave de acesso

Para consultar uma NF-e, o caminho mais comum é acessar o Portal Nacional da Nota Fiscal Eletrônica ou a SEFAZ correspondente.

O processo geralmente segue esta lógica:

  1. acesse o portal oficial de consulta da NF-e;
  2. informe a chave de acesso com 44 dígitos;
  3. confirme a verificação de segurança, quando solicitada;
  4. visualize as informações disponíveis da nota;
  5. confira dados como emitente, destinatário, valor, número, série e situação da nota.

A consulta pode ajudar a confirmar se a nota foi autorizada, cancelada ou se possui eventos relacionados.

O que conferir na consulta da nota fiscal?

Ao pesquisar uma nota pela chave de acesso, confira:

  • situação da nota;
  • CNPJ do emitente;
  • CNPJ ou CPF do destinatário, quando disponível;
  • número e série;
  • data de emissão;
  • valor total;
  • chave de acesso;
  • protocolo de autorização;
  • eventos da nota, quando houver.

Essa conferência é útil para evitar que documentos incorretos sejam enviados à contabilidade ou usados em relatórios internos.

Tenho apenas o DANFE. Como conseguir o XML?

Se você tem apenas o DANFE, use a chave de acesso para localizar informações da nota. Depois, tente obter o XML por caminhos seguros.

As opções mais comuns são:

  1. solicitar o XML ao fornecedor que emitiu a nota;
  2. verificar se o XML foi enviado por e-mail;
  3. procurar no sistema emissor ou ERP da empresa;
  4. consultar o contador, caso ele já tenha recebido o arquivo;
  5. verificar backups, pastas fiscais ou sistemas internos;
  6. utilizar meios oficiais ou autorizados quando aplicável.

Evite tentar “recriar” XML manualmente a partir do DANFE ou PDF. O XML correto deve ser o arquivo eletrônico original ou uma cópia legítima dele.

Nota fiscal de serviço tem XML?

Sim, a Nota Fiscal de Serviço eletrônica também pode ter XML. Porém, é importante entender que NF-e e NFS-e não são exatamente a mesma coisa.

A NF-e geralmente está relacionada a operações com mercadorias. Já a NFS-e está relacionada à prestação de serviços e pode seguir regras municipais ou o padrão nacional da NFS-e, conforme o caso.

Na prática, quando uma empresa emite ou recebe uma NFS-e, pode existir um arquivo XML com os dados da nota de serviço. Esse arquivo é importante para armazenamento, integração com sistemas, conferência e envio à contabilidade.

Se o contador pedir o XML da nota fiscal de serviço, ele normalmente está se referindo ao arquivo eletrônico da NFS-e, não apenas ao PDF ou documento auxiliar.

É possível transformar NF-e em XML?

Essa pergunta aparece muito porque algumas pessoas têm apenas o PDF, o DANFE ou a chave de acesso e querem “transformar a NF-e em XML”.

Tecnicamente, se a NF-e foi emitida corretamente, o XML já existe. O caminho mais adequado é obter o XML original autorizado, e não criar um novo arquivo manualmente.

Se você possui apenas o PDF ou DANFE, o ideal é buscar o XML com o fornecedor, sistema emissor, ERP, contador ou meio oficial aplicável.

Depois de obter o XML, aí sim é possível transformar os dados em uma planilha Excel, relatório fiscal ou arquivo organizado para análise.

Como organizar XMLs depois de pesquisar ou recuperar os arquivos

Depois de obter os XMLs, mantenha uma organização simples e padronizada.

Exemplo:

Documentos Fiscais/
├── 2026/
│   ├── 05-Maio/
│   │   ├── XML/
│   │   ├── DANFE-PDF/
│   │   └── Relatorios/

Outra possibilidade:

Notas Fiscais/
├── Entrada/
│   ├── 2026-05/
├── Saida/
│   ├── 2026-05/

O importante é conseguir localizar os arquivos depois, principalmente em fechamento mensal, conferência fiscal ou envio ao contador.

Como o Seu XML ajuda nessa rotina

O Seu XML não substitui os portais oficiais de consulta da NF-e nem a orientação do contador. Porém, ele ajuda em etapas operacionais depois que você já tem os arquivos ou links corretos.

Com o Seu XML, você pode:

  • baixar XMLs a partir de links;
  • converter XML de nota fiscal em planilha Excel;
  • organizar XMLs por competência;
  • gerar relatórios a partir dos XMLs;
  • facilitar a conferência dos dados fiscais;
  • reduzir abertura manual de arquivo por arquivo.

Isso é útil para empresas, escritórios contábeis, BPO financeiro e equipes fiscais que lidam com muitos documentos.

Erros comuns

1. Achar que a chave de acesso sempre baixa o XML

A chave permite consultar a nota, mas o download do XML completo pode depender de outros requisitos.

2. Confundir DANFE com XML

O DANFE é documento auxiliar. O XML é o arquivo eletrônico estruturado.

3. Guardar apenas o PDF

O PDF ajuda na leitura visual, mas não substitui o XML para rotinas contábeis e fiscais.

4. Não conferir a situação da nota

Antes de usar uma nota na rotina fiscal, confira se ela está autorizada, cancelada ou se possui eventos relevantes.

5. Não pedir o XML ao fornecedor

Em muitos casos, o caminho mais simples é solicitar o XML diretamente ao emissor da nota.

6. Deixar XMLs espalhados em e-mails

Arquivos fiscais devem ser armazenados em pastas organizadas e com backup.

Como resolver na prática

Se você precisa pesquisar XML pela chave de acesso, siga este caminho:

  1. localize a chave de acesso no DANFE;
  2. consulte a NF-e em portal oficial;
  3. confira emitente, destinatário, valor e situação;
  4. veja se você já recebeu o XML por e-mail;
  5. solicite o XML ao fornecedor, se necessário;
  6. procure no sistema emissor, ERP ou contador;
  7. organize os XMLs recuperados em pastas por mês;
  8. converta os XMLs em Excel quando precisar analisar os dados em lote.

Checklist rápido

Antes de finalizar a conferência, verifique:

  • a chave tem 44 dígitos?
  • a consulta foi feita em portal confiável?
  • a nota está autorizada?
  • o CNPJ do emitente está correto?
  • o destinatário está correto?
  • o valor total confere?
  • o XML original foi obtido?
  • o arquivo foi salvo em pasta organizada?
  • o contador recebeu o XML?
  • existe backup do documento?

Perguntas frequentes

O que é chave de acesso da nota fiscal?

É o código de 44 dígitos que identifica a NF-e e permite consultar informações da nota nos portais oficiais.

Como pesquisar XML pela chave de acesso?

Você pode usar a chave para consultar a NF-e. Para obter o XML completo, pode ser necessário solicitar ao fornecedor, acessar o sistema emissor, usar certificado digital ou seguir outro procedimento autorizado.

O que é arquivo XML da nota fiscal?

É o arquivo eletrônico estruturado da nota, usado por sistemas fiscais e contábeis para ler os dados da NF-e.

Nota fiscal de serviço tem XML?

Sim, a NFS-e também pode ter XML, mas o funcionamento pode variar conforme município, sistema emissor ou padrão nacional adotado.

Posso transformar NF-e em XML?

Se a NF-e foi emitida, o XML original já existe. O ideal é obter esse arquivo, e não tentar recriá-lo a partir de PDF ou DANFE.

Posso transformar XML em Excel?

Sim. Depois de obter o XML, os dados podem ser organizados em planilha Excel para conferência e análise.

Conclusão

Pesquisar XML pela chave de acesso é uma dúvida comum, mas é importante separar consulta de nota e obtenção do XML completo. A chave de acesso permite localizar e conferir informações da NF-e, mas o XML deve ser obtido por meios adequados, como fornecedor, sistema emissor, contador ou procedimentos autorizados.

Para a rotina contábil, o XML é mais importante que o PDF porque permite leitura automática, conferência, importação em sistemas e geração de relatórios.

O Seu XML ajuda depois que você tem os arquivos ou links corretos, oferecendo automações para baixar XMLs por link, transformar XML em Excel e organizar documentos fiscais com mais agilidade.

Aviso importante

Este conteúdo é informativo e não substitui a análise de um contador, consultor fiscal ou orientação oficial da Receita Federal e Secretarias de Fazenda.

Fontes consultadas

  • Portal Nacional da NF-e — https://www.nfe.fazenda.gov.br/
  • Consulta NF-e — https://www.nfe.fazenda.gov.br/portal/consultaRecaptcha.aspx
  • Portal Nacional da NFS-e — https://www.gov.br/nfse/pt-br
  • Consulta pública NFS-e — https://www.nfse.gov.br/consultapublica
  • Receita Federal — https://www.gov.br/receitafederal/pt-br
Aplicação prática

Serviços do Seu XML relacionados a este tema

Use estes atalhos para sair do conteúdo e aplicar a automação mais próxima da dor operacional discutida neste artigo.

Download automático de arquivos XML a partir de Links

O sistema realiza o download do arquivo XML a partir dos links diretos adicionados na tabela, verifica os recebedores e retorna o arquivo ZIP com as informações organizadas.

Abrir serviço
Download automático de DANFE ou arquivos PDF a partir de Links

O sistema realiza o download do DANFE ou arquivos em PDF, a partir dos links diretos adicionados na tabela e retorna um ZIP com os arquivos organizados por recebedor.

Abrir serviço
Converter XML de NF-e ou CT-e em DANFE/DACTE PDF

O sistema lê XMLs fiscais de NF-e e CT-e, identifica o tipo de documento e gera automaticamente os respectivos documentos auxiliares em PDF.

Abrir serviço