Download de XML de NF-e: consulta, arquivo e conferência
CONTROLE DE XML

Download de XML de NF-e: consulta, arquivo e conferência

Revisado em .

O download do XML de NF-e começa pela identificação do documento e de quem pode acessá-lo. Você pode receber o arquivo do fornecedor ou obtê-lo por um serviço autorizado. Consultar uma chave no portal, visualizar um DANFE e possuir o XML completo são situações diferentes.

1. Obtenha o arquivo e confira sua origem

  1. Identifique a nota: confira a chave de acesso, o emitente e o destinatário. O DANFE ajuda a identificar a NF-e, mas seu PDF não substitui o arquivo XML.
  2. Peça o XML ao fornecedor: esse recebimento não exige que você forneça a senha do seu certificado. Confira se o arquivo corresponde à operação e à empresa correta.
  3. Consulte a situação: use os serviços oficiais aplicáveis. Uma consulta pública com chave não garante acesso ao XML completo nem a documentos de terceiros.
  4. Preserve e organize: mantenha o arquivo original, os eventos disponíveis e os registros de conferência. Identifique versões e duplicidades antes da importação.

Baixar sem certificado é sempre inválido?

Não. Receber o XML original do emitente é diferente de consultar a distribuição autenticada na SEFAZ. Também é diferente de receber apenas um resumo ou um arquivo reconstruído. Verifique a origem, o conteúdo e a situação do documento; o canal de recebimento, isoladamente, não demonstra sua validade.

2. Avalie a captura em lote

O NFeDistribuicaoDFe permite automatizar consultas de documentos de interesse de atores autorizados da NF-e. O retorno depende de acesso, sequência de NSU, disponibilidade e regras do serviço. A integração deve distinguir resumos, arquivos completos e eventos; não é uma busca ilimitada de todas as notas de um CNPJ.

Confira o certificado e a configuração aceitos pelo sistema. Registre falhas e documentos esperados que não chegaram. Ao manifestar uma NF-e, escolha o evento correspondente aos fatos; não confirme uma operação apenas para tentar obter o arquivo.

Conheça os recursos do Flow Fiscal

Avalie documentos atendidos, acesso às fontes, exportação, retenção e plano contratado. Organizar XMLs pode apoiar a rotina financeira, mas a conferência da compra e a autorização do pagamento continuam sendo etapas próprias.

Ver recursos e planos

3. Confira antes de importar ou pagar

  • Documento: confira empresa, chave, valores e eventos relevantes, incluindo cancelamento quando houver.
  • Operação: compare pedido, recebimento e fornecedor. Uma nota desconhecida exige investigação; o download não detecta nem comprova sozinho uma fraude.
  • Financeiro: confira parcelas, vencimentos, duplicidades e beneficiário. A existência de uma NF-e não equivale a autorização de pagamento.
  • Guarda: defina retenção conforme as obrigações aplicáveis e as condições do serviço. Não confunda prazo de guarda com garantia de armazenamento vitalício ou recuperação pela SEFAZ.

Perguntas frequentes

Posso baixar qualquer NF-e apenas com a chave?

Não presuma acesso ao XML completo. A consulta pública e a distribuição de documentos têm requisitos diferentes. Obtenha o arquivo do emitente ou utilize o serviço autorizado para o seu papel na operação.

O mesmo serviço baixa CT-e e NFS-e?

Não pelo endpoint de distribuição da NF-e. CT-e utiliza serviços próprios; NFS-e depende dos serviços nacionais ou municipais aplicáveis e das respectivas permissões. Confira a cobertura de cada integração.

O XML já contém tudo para pagar uma conta?

Não necessariamente. Parcelas e vencimentos podem não estar disponíveis ou exigir conferência. Valide os dados com os documentos da compra e do pagamento antes de criar ou autorizar lançamentos.

Fontes e próximos passos

Consulte o Portal Nacional da NF-e, a orientação sobre manifestação do destinatário e a documentação da NFS-e Nacional. Para implantar uma rotina, leia também os guias relacionados de captura em lote e recebimento sem certificado.

Pare de caçar XML dos seus fornecedores

Organize os XMLs e acompanhe a captura dos documentos disponíveis ao seu CNPJ no Flow Fiscal. A cobertura depende do tipo de documento, da fonte consultada e da configuração. Confira os requisitos de certificado A1, os recursos de manifestação e as condições do plano.

Consulte os requisitos de conexão e as condições do teste.