Skip to main content

Visão Geral

Visão Geral da Distribuição DFe​

A Distribuição de Documentos Fiscais Eletrônicos (DFe) é um serviço da SEFAZ que permite consultar e recuperar os documentos fiscais eletrônicos (NF-e) destinados a um determinado CNPJ ou CPF.

Essa funcionalidade é essencial para empresas que precisam manter em seu sistema uma cópia atualizada das notas fiscais emitidas contra o seu CNPJ, garantindo conformidade fiscal e integração automática com seus sistemas de gestão (ERP).

Finalidade da Distribuição DFe​

A rota /nfe/distribuicaodfe da Emitix API possibilita:

  • Consultar as NF-e emitidas para um determinado interessado (CNPJ/CPF).
  • Baixar os XMLs e DANFEs correspondentes às notas localizadas.
  • Obter documentos de forma incremental, utilizando o NSU (Número Sequencial Único).
  • Automatizar o processo de sincronização fiscal entre o sistema interno e os serviços da SEFAZ.

Modos de Consulta Disponíveis​

Tipo de ConsultaDescriçãoObservações
Por NSURetorna documentos a partir de um determinado número sequencial.Ideal para sincronizações periódicas.
Por Chave de Acesso (chNFe)Consulta uma NF-e específica.Útil para buscas diretas.
Últimos Documentos (sem NSU)Retorna os primeiros 50 documentos disponíveis.Recomendado para inicialização do processo.

Situações em que é Recomendada​

  • Integração de NF-e recebidas por empresas e escritórios contábeis.
  • Recuperação automática de notas emitidas contra o CNPJ do cliente.
  • Consulta periódica para detectar novas notas distribuídas pela SEFAZ.
  • Monitoramento de documentos pendentes de download ou manifestação.

Requisitos da Requisição​

  • Certificado digital A1 válido e senha correspondente.
  • Autenticação via Bearer Token e API Key.
  • Definição do ambiente (tpAmb):
    • 1 = Produção
    • 2 = Homologação

Boas Práticas de Utilização​

  • Sempre armazene o último NSU consultado para evitar requisições duplicadas.
  • Implemente rotinas automáticas para sincronização periódica (por exemplo, a cada 6 horas).
  • Salve os XMLs retornados localmente para auditoria e contingência.
  • Utilize certificados digitais protegidos e válidos — sem eles, a SEFAZ não autoriza a consulta.