Módulo Distribuição DF-e

O que é o módulo Distribuição DF-e

A Distribuição DF-e é o serviço da SEFAZ que entrega, de forma automática, todos os documentos fiscais eletrônicos emitidos contra o CNPJ da sua empresa — NF-es, CT-es e MDF-es em que ela aparece como destinatária. Em vez de pedir o XML ao fornecedor, o ERP consulta a SEFAZ de tempos em tempos e recebe os documentos assim que são autorizados.

O módulo cuida de todo o fluxo: consulta periódica, manifestação do destinatário (ciência, confirmação, desconhecimento, não realizada), criação de pré-entrada com conferência de itens e, por fim, lançamento em estoque e financeiro. Tudo isso é notificado em tempo real via Socket.IO, para que o operador veja o progresso sem precisar recarregar a tela.

Como acessar

No menu lateral, acesse Suprimentos → Distribuição DFe. A rota é /distribuicao-dfe.

Rotas:

• /distribuicao-dfe — listagem de documentos recebidos.
• /distribuicao-dfe/pre-entradas — pré-entradas (conferência antes de virar NF de entrada).
• /distribuicao-dfe/pre-entradas/[id] — detalhe com itens e conferência.
• /distribuicao-dfe/configuracao — ajustes da consulta automática.

Documentos recebidos

A lista principal mostra tudo o que veio da SEFAZ:

• NSU — Número Sequencial Único (identificador do envio pela SEFAZ).
• Chave de acesso — 44 dígitos.
• Emitente — CNPJ e nome do fornecedor.
• Tipo — resumo de NF-e (resNFe), NF-e completa (procNFe), resumo de evento e outros.
• Status — Pendente, Ciência, Confirmado, Desconhecido, Não realizado, Importado ou Ignorado.
• Valor da NF, data de emissão.

Filtros

• Status da manifestação.
• Período.
• CNPJ do emitente.

Menu de contexto dos documentos

• Visualizar detalhe — abre um painel com o resumo, o XML completo (se já consultado) e o histórico de manifestações.
• Consultar XML completo — executa a ciência automática e baixa o XML.
• Manifestar — abre um painel com os quatro eventos da manifestação do destinatário (ver abaixo).
• Criar pré-entrada — converte o documento em uma pré-entrada editável.
• Compartilhar — gera um link público com o DANFE para o cliente ou auditor.
• Ignorar — marca como não utilizável (não altera a SEFAZ).

Manifestação do destinatário

Ao receber uma NF-e contra o seu CNPJ, a empresa tem a obrigação — e o benefício — de manifestar a ciência ao fisco. Há quatro eventos possíveis:

A manifestação pode ser individual ou em lote.

Pré-entrada

A pré-entrada é um passo intermediário entre receber o XML e gerar a NF-e de entrada de fato. Serve para conferir os itens fisicamente antes de movimentar estoque e financeiro.

Formulário

• Dados gerais — fornecedor, chave, número, série, data, valor total, depósito destino.
• Itens — tabela com produto, código do fornecedor, descrição, NCM, CFOP, quantidade da NF, valor unitário, EAN e quantidade conferida. O operador edita esta última à medida que confere fisicamente.
• Fiscal — dados de ICMS, IPI e demais tributos por item.
• Observações.

Status da pré-entrada

• Rascunho — aceita edição.
• Conferindo — operador está ajustando quantidades.
• Confirmada — bloqueada para edição, pronta para os próximos passos.
• Cancelada.

Ações

• Lançar estoque — cria as movimentações no depósito informado.
• Lançar financeiro — gera contas a pagar conforme a condição de pagamento da nota.
• Gerar NF de entrada — converte a pré-entrada em um documento no módulo NF.

Consulta automática

Um job em segundo plano consulta a SEFAZ periodicamente para buscar novos documentos. A configuração permite:

• Ativar a consulta automática.
• Intervalo em minutos — mínimo de 60 minutos (limite do serviço da SEFAZ).
• Exibir eventos — incluir ou não manifestações e cancelamentos na listagem.

A consulta é incremental: a cada chamada, o sistema pede apenas NSUs posteriores ao último recebido. O progresso é publicado em tempo real via Socket.IO (10%, 50%, 100%) para que o painel mostre o andamento.

Integrações com outros módulos

Clientes e fornecedores

A pré-entrada vincula o emitente ao cadastro de fornecedores do ERP. Se o fornecedor não existir, o sistema oferece criação rápida.

NF

Ao gerar a NF de entrada, a pré-entrada vira um documento no módulo NF, com todos os dados de destinatário, itens e tributos preenchidos.

Estoque

O lançamento de estoque movimenta o depósito escolhido, com controle de lotes e séries quando o produto exige.

Finanças

O lançamento financeiro gera contas a pagar com categoria, parcelas e vencimentos, tudo respeitando a condição de pagamento da nota.

Compras

A pré-entrada pode ser vinculada a um pedido de compra existente, fechando o ciclo entre a ordem e a entrada real da mercadoria.

Socket.IO

Eventos em tempo real publicam o progresso das consultas, das manifestações em lote e dos lançamentos em lote — o operador vê tudo em tempo real na interface, sem F5.

Permissões

• Consultar documentos DF-e.
• Manifestar.
• Criar pré-entrada.
• Lançar estoque.
• Lançar financeiro.
• Gerar NF de entrada.
• Compartilhar publicamente.
• Configurar consulta automática.

Perguntas frequentes

O que é o NSU?

Número Sequencial Único — é o identificador que a SEFAZ dá para cada envio recebido pelo seu CNPJ. O ERP usa o último NSU recebido como marcador para as próximas consultas.

Preciso manifestar toda nota?

Depende da UF. Em alguns estados a ciência é obrigatória. Já a confirmação da operação é fortemente recomendada porque impede que o fornecedor cancele a NF depois que a sua empresa já recebeu a mercadoria.

A consulta automática manifesta sozinha?

Não. A consulta apenas baixa os documentos. A manifestação é manual (ou em lote), garantindo que o usuário analise cada caso antes de ciente ou confirmar.

Preciso criar pré-entrada sempre?

Não. Se você confia nos dados do XML do fornecedor e não quer conferir item a item, pode gerar a NF de entrada direto. A pré-entrada é recomendada quando você precisa conferir fisicamente as quantidades recebidas.

Os documentos chegam em tempo real?

A SEFAZ disponibiliza os documentos minutos após a emissão pelo fornecedor. O tempo exato depende da fila da SEFAZ e do intervalo configurado da consulta automática.

O compartilhamento público é seguro?

Sim. O link usa um hash aleatório, não expõe dados cadastrais sensíveis e entrega apenas o DANFE renderizado para consulta visual.