Guia técnico

Como baixar o XML da NF-e da SEFAZ: guia completo

Todos os caminhos oficiais para obter o XML da NF-e — distribuição por NSU, consulta por chave e manifestação do destinatário — com as janelas de prazo e os limites reais dos serviços da SEFAZ, e como automatizar tudo isso.

O que é o XML da NF-e e por que baixá-lo

O XML é o documento fiscal oficial: é o arquivo gerado pelo emissor, assinado digitalmente e autorizado pela SEFAZ. O DANFE em PDF é apenas uma representação gráfica auxiliar, sem valor fiscal autônomo. É o XML que comprova a operação em uma fiscalização, sustenta os créditos de ICMS, PIS e COFINS e alimenta a escrituração contábil e o SPED.

Para o destinatário, depender do emitente para receber cada XML é um risco permanente: notas emitidas contra o seu CNPJ que você nem sabe que existem, e-mails perdidos e prazos fiscais correndo. Por isso a SEFAZ mantém serviços oficiais para o destinatário obter os próprios documentos — e é sobre eles que este guia trata.

Os caminhos oficiais para baixar o XML

1. Consulta por chave no Portal Nacional. Com a chave de acesso de 44 dígitos, qualquer pessoa consulta a situação da nota no portal da NF-e. A consulta pública exibe os dados e a autorização, mas o download do XML completo exige certificado digital do destinatário.

2. Distribuição DF-e por NSU (distNSU). É o serviço de distribuição contínua da SEFAZ/Ambiente Nacional: o CNPJ consulta os documentos destinados a ele em ordem de NSU (número sequencial único) e recebe, a cada lote, os resumos e os XMLs disponíveis. É o caminho usado por softwares de gestão para captura automática. O protocolo admite certificados digitais, mas a automação atual do Arquivix aceita exclusivamente A1 em arquivo .pfx/.p12; A3 ainda não é suportado.

3. Consulta por chave (consChNFe). Devolve o XML completo e assinado de uma nota específica, dentro da janela de aproximadamente 90 dias após a emissão. É o caminho para recuperar um documento pontual cuja chave você conhece.

4. Manifestação do destinatário. Antes de qualquer manifestação, a distribuição entrega apenas o resumo da nota (resNFe). O XML completo é liberado ao destinatário após o registro de um evento de manifestação — em geral a ciência da operação. Manifestar-se, portanto, não é só defesa fiscal: é condição para receber o próprio arquivo.

As janelas e os limites que pegam todo mundo de surpresa

  • Janela de ~90 dias: tanto a distribuição por NSU quanto a consulta por chave cobrem aproximadamente os últimos 90 dias. Passado esse período, a SEFAZ não redistribui o XML.
  • Sem retroativo infinito: CNPJs que nunca consultaram a distribuição ou ficaram mais de 60 dias inativos não recebem o histórico completo — apenas o que ainda estiver dentro da janela.
  • Cotas de consulta: os serviços limitam o ritmo (em geral 20 consultas por hora) e exigem espera de 1 hora quando não há documentos novos. Exceder os limites gera o bloqueio por consumo indevido (cStat 656).
  • NFC-e e SAT-CF-e não passam pela distribuição nacional: para CE, SP e as demais UFs, o fluxo confiável de NFC-e continua sendo ERP/API, e-mail, agente de pastas ou importação XML/ZIP. A SEF-SC mantém uma exceção estadual em testes desde 15/04/2026, somente para contabilistas vinculados, com versão definitiva prevista para 01/01/2027; esse serviço ainda não está integrado ao Arquivix. Consulte o comunicado oficial da SEF-SC. SAT-CF-e permanece fora de serviços de distribuição.

Como o Arquivix automatiza o download

O Arquivix faz o monitoramento contínuo da distribuição DF-e para todos os CNPJs cadastrados na sua conta, respeitando as cotas e os tempos de espera da SEFAZ: cada NF-e e CT-e destinado às suas empresas é capturado, manifestado conforme a sua rotina e arquivado com o XML oficial, íntegro e assinado. NFS-e entra pelo Ambiente de Dados Nacional, quando o município e o documento estão disponíveis no sistema nacional.

Para documentos pontuais, o resgate por chave recupera o XML dentro das regras da SEFAZ; para NFC-e e SAT-CF-e, a importação em lote (XML/ZIP), e-mail, o agente de sincronização de pastas e as integrações alimentam o acervo. O serviço estadual de NFC-e da SEF-SC está em testes e ainda não é um conector do Arquivix. Tudo fica guardado por mais de 5 anos, com pesquisa e download em massa via ZIP — sem depender de e-mail, WhatsApp ou portal da prefeitura.

Perguntas frequentes

Consigo baixar o XML de uma NF-e só com a chave de acesso?

A consulta pública por chave no Portal Nacional da NF-e mostra a situação do documento, mas o download do XML completo exige certificado digital do CNPJ destinatário. No Arquivix, a consulta por chave (consChNFe) usa certificado A1 em arquivo .pfx/.p12 e devolve o XML assinado original dentro da janela de aproximadamente 90 dias após a emissão, respeitando o limite de 20 consultas por hora.

Por quanto tempo a SEFAZ disponibiliza o XML da NF-e?

As consultas de distribuição (por NSU) e por chave cobrem uma janela de aproximadamente 90 dias. Depois disso, a SEFAZ não redistribui o documento: o caminho é pedir o XML ao emitente ou manter um acervo próprio desde a emissão — exatamente o que o monitoramento contínuo do Arquivix faz por você.

A SEFAZ distribui NFC-e e SAT-CF-e?

Não existe distribuição nacional de NFC-e (modelo 65) por NSU, e SAT-CF-e também não participa desse serviço. Santa Catarina abriu em 15/04/2026 um serviço estadual de NFC-e em testes, restrito a contabilistas vinculados, com versão definitiva prevista para 01/01/2027; esse canal ainda não está integrado ao Arquivix. Para CE, SP e as demais UFs, os canais são ERP/API, e-mail, agente de pastas ou importação XML/ZIP.

Preciso de certificado digital para baixar XML da SEFAZ?

Sim. Tanto a distribuição por NSU quanto a consulta por chave exigem certificado digital do CNPJ destinatário. A automação atual do Arquivix aceita certificado A1 em arquivo .pfx/.p12; certificado A3 ainda não é suportado. Você envia o A1 uma única vez, com arquivo e senha criptografados, e a plataforma o utiliza nas consultas oficiais.

O que é o erro 656 (consumo indevido) da SEFAZ?

É o bloqueio temporário aplicado quando um CNPJ excede os limites de consulta dos serviços de distribuição (por exemplo, mais de 20 consultas por hora ou consultas repetidas sem novos documentos). O Arquivix gerencia automaticamente o ritmo das consultas e os tempos de espera exigidos pela SEFAZ para evitar o bloqueio.

Nunca mais perca um XML fiscal

Ative o monitoramento hoje e tenha NF-e, CT-e e NFS-e arquivados automaticamente — e NFC-e e SAT-CF-e organizados por importação e agente de pastas — com manifestação do destinatário em dia.

Começar grátis

Teste grátis · sem cartão de crédito · cancele quando quiser