Download de XML fiscal

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.