Revisado em .
O download de XML de NF-e via web service pode utilizar o NFeDistribuicaoDFe, serviço do Ambiente Nacional destinado à distribuição de documentos de interesse dos atores autorizados da NF-e. A consulta não é uma busca irrestrita de notas de qualquer CNPJ.
Como organizar o fluxo de distribuição
- Identificação: use certificado digital compatível com o serviço e com o interessado. Não confunda autenticação por certificado com assinatura de cada mensagem SOAP.
- Sequência: mantenha o último NSU recebido e coordene os sistemas que consultam o mesmo CNPJ. Registre o retorno para retomar o processamento.
- Conteúdo: diferencie resumo, documento completo e evento. O retorno depende do papel do interessado, da disponibilidade e das regras de distribuição.
- Manifestação: avalie o evento aplicável. Confirmação da Operação declara a ocorrência da operação; não deve ser enviada apenas como atalho para obter um XML. Ciência da Emissão é distinta da manifestação conclusiva.
Consumo indevido e continuidade
Ao receber rejeição 656, aguarde uma hora antes de nova tentativa. Repetições antecipadas podem renovar o bloqueio. Controle os retornos e a sequência; uma integração não garante ausência de rejeições ou disponibilidade permanente do serviço.
Certificado e operação do sistema
O certificado A1 pode ser utilizado em rotinas de servidor, conforme a compatibilidade da aplicação. Controle acesso, validade e renovação. O tipo de certificado, por si só, não garante cobertura completa, segurança ou funcionamento de toda automação.
Organize os documentos com o Flow Fiscal
Confira os recursos e planos para o seu cenário. A disponibilidade dos arquivos depende das fontes, permissões, configuração e histórico acessível; não há garantia de captura de 100% dos XMLs.
Ver recursos e planosPerguntas frequentes
Uma resposta vazia significa que todas as notas foram baixadas?
Não. Ela precisa ser interpretada junto ao código de retorno, ao NSU, à conta consultada e à disponibilidade dos documentos. Confira uma amostra esperada e registre lacunas; ausência de retorno não comprova ausência de notas.
Esse web service também baixa NFS-e e CT-e?
Não pelo mesmo endpoint NFeDistribuicaoDFe. CT-e tem distribuição própria; NFS-e depende dos serviços nacionais ou municipais aplicáveis. Não deduza acesso aos três modelos a partir de uma conexão NF-e.
Como integrar os XMLs ao meu ERP?
Confirme o formato de importação ou contrato de API disponível. Valide campos, duplicidades, eventos e critérios financeiros antes de gerar lançamentos. Uma página comercial não substitui documentação de endpoints e testes de integração.
Fontes e requisitos da integração
Consulte o Portal Nacional da NF-e sobre consumo indevido, a orientação da SEF/MG sobre manifestação e a documentação própria da NFS-e Nacional. Leia os esquemas e regras vigentes antes de implementar.