# Download de XML fiscal

> Download de XML fiscal é a obtenção do arquivo XML de um documento fiscal eletrônico, como NF-e, NFC-e, NFS-e, CT-e ou MDF-e, depois de emitido ou recebido. Esse arquivo é a versão oficial e com validade jurídica do documento, usada para guarda obrigatória, escrituração contábil, conferência de dados e envio a clientes ou parceiros.

**Também conhecido como:** Baixar XML da nota fiscal, Download do XML da NF-e, Download de XML de nota fiscal, Exportação de XML fiscal, Fiscal XML download

**Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** D

## O que significa fazer o download de XML fiscal?

Toda nota fiscal eletrônica existe, de fato, como um arquivo XML: um texto estruturado com todos os dados da operação, a assinatura digital do emitente e, depois da autorização, o protocolo do órgão responsável. Fazer o download desse XML é baixar uma cópia desse arquivo para guardar, consultar ou repassar.

O download pode ser feito pelo emitente, que precisa arquivar o que emitiu, ou pelo destinatário, que precisa guardar o que recebeu. Em ambos os casos, o objetivo é ter em mãos o documento original, e não apenas uma representação impressa.

## Para que serve baixar o XML de uma nota fiscal?

O XML é o documento que vale perante o fisco. Por isso, empresas precisam armazená-lo pelo prazo previsto na legislação, que em geral é de cinco anos, para apresentar em fiscalizações ou auditorias.

Além da guarda, o XML é usado pela contabilidade para escriturar entradas e saídas, por sistemas de gestão para importar dados de compras automaticamente e por clientes que exigem o arquivo junto com a mercadoria ou o serviço. Ele também serve para conferir impostos, valores e códigos como CFOP e CST.

## Qual a diferença entre o XML e o PDF da nota?

O XML é o documento fiscal em si, legível por sistemas e com validade jurídica. O PDF é uma representação gráfica simplificada, como o DANFE da NF-e, o DANFCE da NFC-e, o DACTE do CT-e e o DAMDFE do MDF-e, feita para facilitar a leitura humana e acompanhar a mercadoria.

Na prática, o PDF ajuda a visualizar e conferir, mas não substitui o XML. Guardar apenas o PDF não atende à obrigação de arquivamento.

## Como funciona o download de XML por meio de uma API fiscal?

Quando a emissão é feita por API, o sistema da empresa envia os dados da venda, a API transmite o documento e acompanha o processamento até a autorização. Depois disso, o XML autorizado fica disponível para consulta, normalmente identificado pela chave de acesso ou por um identificador próprio da API.

O sistema pode buscar o arquivo com uma requisição autenticada, por exemplo usando uma API Key ou um Bearer token, ou recebê-lo automaticamente por notificações. Assim, ERPs, marketplaces e softwares de gestão armazenam o XML sem que alguém precise baixá-lo manualmente em portais.

## Como o destinatário consegue baixar o XML de notas recebidas?

Nem sempre o fornecedor envia o XML ao cliente. Para esses casos, existe o serviço de Distribuição de DF-e, que permite ao destinatário consultar e baixar documentos emitidos contra o seu CNPJ, usando certificado digital.

Esse recurso é útil para empresas que recebem muitas notas de compra e querem automatizar a entrada no estoque e na contabilidade.

## Quais cuidados tomar ao baixar e guardar XMLs?

Verifique se o arquivo baixado é a versão autorizada, com o protocolo de autorização incluído. Um XML apenas assinado, sem protocolo, não comprova que a nota foi aceita.

Também é importante guardar os XMLs de eventos, como cancelamento e carta de correção, junto com a nota original, e manter cópias em local seguro, organizadas por CNPJ e período.

## Exemplos de Download de XML fiscal

- Um ERP emite uma NF-e via API e, assim que recebe o status de autorizada, faz o download do XML e o salva no repositório do cliente, organizado por mês.
- Um marketplace baixa automaticamente o XML de cada NFC-e emitida pelos lojistas para disponibilizá-lo no painel de vendas.
- Uma transportadora baixa o XML do CT-e autorizado para enviar ao embarcador junto com o DACTE em PDF.
- O setor contábil de uma indústria usa a Distribuição de DF-e para baixar os XMLs das notas de compra emitidas contra seu CNPJ e importá-los no sistema.

## Perguntas frequentes

### O PDF da nota substitui o XML?

Não. O PDF, como o DANFE, é apenas uma representação visual. O documento com validade jurídica é o XML, e é ele que deve ser arquivado pelo prazo exigido pela legislação.

### Posso baixar o XML de uma nota cancelada?

Sim. O XML original continua existindo, e o cancelamento gera um XML de evento próprio. O ideal é guardar os dois arquivos juntos, para comprovar tanto a emissão quanto o cancelamento.

### Preciso de certificado digital para baixar XML?

Depende do meio. Serviços oficiais como a Distribuição de DF-e exigem certificado digital. Em uma API fiscal, o acesso costuma ser autenticado por credenciais da própria API, como API Key ou token.

### O XML baixado em homologação tem validade fiscal?

Não. Documentos emitidos no ambiente de homologação servem apenas para testes e não têm valor jurídico. Somente XMLs autorizados no ambiente de produção valem perante o fisco.

## Termos relacionados

- [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md)
- [Distribuição de DF-e](https://conota.dev/glossario/distribuicao-de-df-e.md)
- [Autorização de uso da NF-e](https://conota.dev/glossario/autorizacao-de-uso-da-nf-e.md)
- [Chave de acesso da NF-e](https://conota.dev/glossario/chave-de-acesso-da-nf-e.md)
- [DANFE](https://conota.dev/glossario/danfe.md)
- [API fiscal](https://conota.dev/glossario/api-fiscal.md)

---

Fonte: [Download de XML fiscal](https://conota.dev/glossario/download-de-xml-fiscal/) · Atualizado em 2026-10-22
