Para automatizar o recebimento de notas fiscais, a melhor alternativa técnica é utilizar o download xml nfe web service oficial disponibilizado pela SEFAZ. Trata-se do serviço NFeDistDFe (Distribuição de Documentos Fiscais Eletrônicos), que permite consultar e descarregar lotes de documentos fiscais emitidos contra o CNPJ da empresa.
Como funciona o Web Service de Distribuição?
Diferente de um download manual via chave de acesso, o webservice opera em segundo plano. Eis o fluxo geral da comunicação:
- Identificação: O sistema assina digitalmente a requisição XML utilizando o certificado digital A1 da empresa destinatária.
- Consulta por NSU: O webservice utiliza o controle de NSU (Número Sequencial Único). A cada requisição, você envia o último NSU gravado no seu banco de dados e a SEFAZ devolve novos eventos.
- Resumos e Documentos: No primeiro momento, a SEFAZ envia apenas o resumo da nota fiscal (informações básicas como emitente, valor e data).
- Manifestação: Para obter o XML completo e assinado para download, é obrigatório registrar um evento de manifestação de destinatário (ex: Confirmação da Operação). Em seguida, uma nova consulta ao webservice disponibiliza o arquivo final.
Evite o consumo indevido
A SEFAZ possui regras estritas de frequência para consultas no webservice. Se o seu sistema efetuar chamadas consecutivas repetidas sem intervalo mínimo ou com dados incorretos, o CNPJ pode sofrer um bloqueio temporário por "Consumo Indevido".
O papel do Certificado Digital A1
O Web Service DistDFe exige que toda conexão seja autenticada com segurança TLS e mútua autenticação usando um certificado digital. Por isso, a automação total só é viável com o certificado A1, que pode ser armazenado diretamente no servidor e criptografado para consultas agendadas, diferentemente do certificado A3 (que exige token físico ou cartão).
Automatize a Conexão com o Web Service da SEFAZ
O Flow Fiscal gerencia de forma robusta e otimizada a conexão com o webservice DistDFe da SEFAZ, realizando consultas cronológicas, evitando bloqueios de consumo indevido e trazendo todos os seus XMLs automaticamente.
Testar Gratuitamente
Vantagens operacionais
- Zero digitação: Nunca mais digite chaves de 44 dígitos para baixar uma nota.
- Conformidade Contábil: Garantia de que 100% dos XMLs estarão centralizados para envio contábil.
- Integração com ERP: Os dados extraídos do XML alimentam automaticamente sistemas internos, evitando lançamentos manuais.
Perguntas frequentes
Qual é o limite de retorno do DistDFe?
O webservice retorna no máximo 50 registros por requisição. Se houver mais notas pendentes, o sistema deve continuar paginando com base no NSU retornado na última mensagem até que a resposta retorne código indicando fim de lote.
Posso baixar XML de NFS-e (Serviço) por este Web Service?
Não. O webservice DistDFe Nacional atende apenas a documentos de âmbito estadual/federal (NF-e, modelo 55 e CT-e, modelo 57). Para NFS-e, as capturas dependem de webservices municipais ou do novo padrão da NFS-e Nacional.
O Flow Fiscal oferece API para integrações?
Sim. A Fideflow possui estrutura modularizada para receber os dados do webservice de forma centralizada e disponibilizá-los aos seus sistemas corporativos parceiros e ERPs integrados.