Para baixar XML de NF-e emitida contra o CNPJ automaticamente, a empresa precisa consultar a Distribuição DF-e com certificado digital, manter a sequência de NSU e armazenar cada retorno antes de avançar. O resultado pode ser um resumo, o XML completo ou um evento. Tratar os três como se fossem o mesmo arquivo é uma fonte comum de falhas.
O ponto central não é apenas automatizar um download. É provar que a captura está completa. Uma pasta cheia de XMLs pode esconder notas ausentes, resumos que nunca foram completados e cancelamentos que não chegaram ao ERP.
Qual caminho resolve cada situação?
Pedir o XML ao fornecedor funciona para uma falta isolada. Consultar pela chave ajuda quando a nota já é conhecida. Importar do ERP ou de uma pasta organiza o que chegou por outro canal. Nenhum desses caminhos, sozinho, mostra tudo o que foi emitido contra o CNPJ.
Para acompanhamento contínuo, o caminho oficial é o serviço NFeDistribuicaoDFe. Ele entrega informações e documentos de interesse dos atores autorizados da NF-e, como destinatário, emitente, transportador ou terceiro indicado no XML, conforme as regras do serviço. Veja o funcionamento geral da Distribuição DF-e.
A automação exige quatro peças que precisam funcionar juntas: CNPJ autorizado, certificado digital compatível, controle confiável de NSU e armazenamento próprio. Em servidores, o certificado A1 costuma ser mais adequado do que o A3 porque não depende de token conectado, mas deve permanecer criptografado, ter acesso restrito e renovação monitorada.
Como funciona a Distribuição DF-e por NSU?
O NSU, Número Sequencial Único, funciona como uma posição de leitura para os documentos de interesse daquele ator. Em vez de procurar nota por nota, a aplicação pergunta ao Ambiente Nacional quais registros estão disponíveis depois do último NSU processado.
- Autenticação: a aplicação se conecta ao web service com o certificado digital.
- Consulta: o último NSU conhecido é enviado na requisição.
- Retorno: o serviço devolve um lote com documentos e eventos posteriores à posição informada.
- Descompactação: os conteúdos retornados são descompactados e identificados pelo schema.
- Processamento: resumos, XMLs completos e eventos são tratados conforme o tipo.
- Persistência: o sistema grava o documento e a nova posição de NSU.
- Continuidade: novas consultas seguem até alcançar a posição máxima informada pelo serviço.
Esse controle precisa ser transacional. Avançar o NSU sem armazenar o lote pode criar lacunas. Repetir requisições incorretamente ou consultar em frequência incompatível com as orientações do serviço pode resultar em rejeição por consumo indevido.
Resumo da NF-e e XML completo são a mesma coisa?
Não. Em uma nota destinada ao CNPJ, o primeiro retorno pode ser um resumo da NF-e, com informações suficientes para identificar a existência da operação, mas sem todo o conteúdo fiscal dos itens e tributos.
O XML completo contém a NF-e autorizada e seu protocolo, permitindo validação, escrituração, consulta de produtos, impostos, transporte e demais grupos. O que será disponibilizado depende do papel da empresa, do documento, dos eventos registrados e das regras vigentes.
Por isso, uma ferramenta não deve marcar resumo como se fosse XML completo. Ela precisa preservar o estado do documento e substituir ou complementar o registro quando a versão completa chegar.
É necessário manifestar a NF-e para baixar o XML?
A manifestação do destinatário faz parte do fluxo de tratamento das notas emitidas contra o CNPJ. A Ciência da Operação registra que a empresa tomou conhecimento da NF-e, enquanto Confirmação da Operação, Desconhecimento da Operação e Operação Não Realizada expressam situações conclusivas diferentes.
Quando a Distribuição DF-e entrega apenas o resumo, a manifestação pode ser necessária para que o XML completo seja disponibilizado ao destinatário, conforme as regras vigentes. Não automatize uma manifestação conclusiva sem saber o que ocorreu. Ciência não é confirmação de recebimento, e Confirmação não deve ser usada apenas como atalho para obter arquivo.
Como verificar se a captura da sua empresa está completa
Faça um teste com um período recente, sem usar apenas a quantidade total de arquivos como critério.
- Escolha cinco notas de fornecedores diferentes registradas no contas a pagar ou no recebimento.
- Localize cada chave na base de documentos e confirme se existe XML completo, não apenas resumo ou DANFE.
- Compare emissão, cancelamento e Carta de Correção com os eventos armazenados.
- Verifique se o último NSU processado alcançou o máximo informado pelo serviço.
- Procure resumos antigos ainda marcados como incompletos.
- Confirme que todas as filiais estão vinculadas ao certificado e ao fluxo correto.
Se uma nota existe no financeiro, mas não na captura, o diagnóstico deve começar pelo CNPJ consultado, certificado, NSU e mensagens do serviço. Pedir o XML novamente ao fornecedor pode resolver o arquivo, mas não corrige a falha do processo.
Por que o XML não apareceu?
As causas mais comuns incluem:
- a nota ainda não foi sincronizada ou distribuída para aquele ator;
- o CNPJ consultado não participa da NF-e no papel necessário;
- o certificado está vencido, incompatível ou sem acesso ao estabelecimento;
- o serviço retornou apenas o resumo e o fluxo de manifestação ainda não avançou;
- a aplicação perdeu ou avançou incorretamente a sequência de NSU;
- houve bloqueio temporário por consumo indevido;
- o documento está fora da janela disponível no serviço;
- o arquivo existe em outro canal, mas ainda não foi importado para a base central.
Não reinicie a sequência ou faça consultas repetidas sem diagnóstico. Primeiro verifique certificado, CNPJ, último NSU, máximo NSU, mensagens do serviço e histórico de processamento.
Onde a Noltyz entra nesse processo?
O problema continua depois da conexão com a SEFAZ: alguém precisa controlar NSU, distinguir resumo de documento completo, relacionar eventos, evitar duplicidade e tornar as lacunas visíveis. É nessa parte que a Noltyz atua.
Com certificado A1 cadastrado, a plataforma processa a Distribuição DF-e por CNPJ. Ao receber um resumo de NF-e, uma automação de sistema envia Ciência da Operação com rastreabilidade. O XML completo é incorporado quando o Ambiente Nacional o disponibiliza. Eventos conclusivos continuam dependendo do que realmente ocorreu e das permissões do usuário.
A Noltyz não amplia a janela da SEFAZ nem concede acesso a documentos para os quais o CNPJ não é autorizado. Ela organiza o que foi disponibilizado e permite usar os XMLs em buscas, etiquetas, relatórios e classificação automática.
Perguntas frequentes
Consigo baixar todas as NF-e apenas informando o CNPJ?
Não. O CNPJ precisa ser um ator autorizado no documento, a consulta exige autenticação compatível e o retorno depende das regras e da janela do serviço. Informar qualquer CNPJ não concede acesso ao XML.
Por que uma nota aparece como resumo por vários dias?
Pode haver manifestação pendente, falha no processamento posterior, indisponibilidade temporária ou ausência de liberação do XML completo para aquele ator. Verifique o histórico da nota antes de repetir consultas.
Trocar de sistema exige começar o NSU do zero?
Não deveria. A migração precisa preservar a posição processada e a base já capturada. Reiniciar sem planejamento pode repetir lotes, perder a continuidade ou deixar documentos fora da janela disponível.
Uma nota cancelada deve ser apagada?
Não. O XML autorizado e o evento de cancelamento contam a história fiscal da operação. Excluir o documento original destrói parte da evidência.
Como saber se o fornecedor realmente deixou de enviar um XML?
Compare contas a pagar, recebimento físico e Distribuição DF-e pela chave de acesso. Se a nota aparece apenas no financeiro, investigue a captura; se aparece na distribuição, mas não no e-mail, o problema é do canal do fornecedor.
O que fazer agora
Use pedidos ao fornecedor para exceções e a Distribuição DF-e para acompanhamento contínuo. Antes de trocar de ferramenta ou reiniciar consultas, faça o teste de cobertura e identifique se a falha está no acesso, na sequência de NSU ou no processamento interno. O objetivo não é ter muitos arquivos, mas saber quais documentos e eventos ainda faltam.
Fontes oficiais e data de revisão
Conteúdo revisado em 17 de agosto de 2026. Serviços e regras podem mudar, por isso consulte as versões atuais:
- Portal da NF-e: documentação do Web Service NFeDistribuicaoDFe;
- Portal da NF-e: schemas e pacotes XML;
- Portal Nacional da NF-e: serviços e documentação vigentes.
Quer parar de procurar XML em e-mails e portais? Comece gratuitamente na Noltyz e centralize a captura, a manifestação e a organização das NF-e da sua empresa.
Este conteúdo foi útil para você?