Mudanças entre as edições de "Distribuição de DF-e"

Linha 1: Linha 1:
 
==='''Conceito'''===
 
==='''Conceito'''===
A Distribuição DF-e serve para realização da consulta de documentos destinados, trazendo as informações necessárias para realização da manifestação do destinatário eletrônica. Além de disponibilizar os documentos que foram emitidos contra o CNPJ a empresa, também realiza consulta de manifestações realizadas pelos destinatários das notas fiscais emitidas.
 
  
A utilização desse processo é realizada em lotes, ou seja, os dados solicitados sempre são retornados parcialmente e é necessária nova consulta a partir do ultimo documento retornado. Isso se dá dessa forma para evitar o consumo excessivo dos webservices da SEFAZ. Devemos ainda tomar alguns cuidados para evitar a rejeição por consumo indevido, que pode resultar no bloqueio ao webservice por algumas horas.
+
A Distribuição DF-e permite realizar a consulta de documentos fiscais destinados à empresa, disponibilizando as informações necessárias para o processo de Manifestação do Destinatário.
 +
 
 +
Por meio da distribuição, são consultados os documentos fiscais emitidos contra o CNPJ da empresa, permitindo posteriormente realizar o tratamento e a manifestação dos documentos disponíveis na tela de [[Manifestação Destinatário MD-e|Manifestação do Destinatário]].
 +
 
 +
O processo de consulta é realizado em lotes, conforme o mecanismo de distribuição disponibilizado pela SEFAZ. A cada consulta, o sistema controla as informações de processamento e a sequência de documentos consultados, permitindo dar continuidade às consultas posteriores sem a necessidade de consultar novamente documentos já processados.
 +
 
 +
É importante evitar consultas excessivas ao serviço da SEFAZ, pois o consumo indevido pode ocasionar rejeições e temporariamente impedir novas consultas ao webservice.
 +
 
 +
==='''Filtros'''===
 +
 
 +
A tela permite filtrar as distribuições já realizadas por meio dos seguintes campos:
 +
 
 +
*'''Data:''' Permite informar um período inicial e final para localizar as distribuições realizadas.
 +
 
 +
*'''Hora:''' Permite definir um intervalo de horário para complementar o filtro por data.
 +
 
 +
*'''Filial:''' Permite selecionar a filial relacionada à distribuição dos documentos.
 +
 
 +
A opção Salvar Filtro, quando habilitada, permite que os filtros informados sejam mantidos para utilização posterior.
  
 
==='''Realizando a consulta'''===
 
==='''Realizando a consulta'''===
Para realizar a consulta, é necessário informar a filial, ou informar um período específico de datas que a consulta vai iniciar. O procedimento de consulta se faz pelo botão <img src="https://wiki.phsys.com.br/images/WIKI/modulos/fiscal/distribuicao_de_dfe/Pesquisa.svg" alt="Imagem do botão de pesquisa width="40px" height="40px">  na parte superior, mas só é possível consultar na lupa caso houver um formulário localizado, senão aparecerá a mensagem "'JSON do formulário não localizado".
 
  
*'''Ultima NSU:''' O sistema armazena automaticamente a cada consulta, a ultima NSU consultada, sendo assim, utilizar de 3 formas:
+
Para realizar a consulta dos documentos destinados, utilize o botão de Atualizar/Consultar disponível na parte superior da tela.
:*'''A partir da última consulta:''' O sistema vai realizar de forma continua as consultas até ultima NF-e destinada.  
+
 
:*'''Informar NSU específica:''' Permite o usuário informar uma NSU específica para consulta.
+
A consulta utiliza o controle de NSU realizado pelo sistema para dar continuidade à distribuição dos documentos, evitando que documentos já consultados sejam processados novamente.
:*'''Todas:''' Essa opção realiza a consulta dos últimos 3 meses. Essa opção exige um cuidado especial, pois dependendo da quantidade de notas destinadas, a sistema fará várias consultas até a ultima NF-e destinada, e pode ocorrer a rejeição "656 - Consumo indevido".
+
 
 +
Durante o processo, o sistema realiza as consultas em lotes e atualiza as informações apresentadas na tela conforme os resultados retornados pela SEFAZ.
 +
 
 +
O acompanhamento das consultas pode ser realizado pela grade de distribuições, onde são apresentadas as informações de cada processamento:
 +
 
 +
*'''Filial:''' Filial relacionada à consulta realizada.
 +
 
 +
*'''Última NSU:''' Última NSU processada na consulta.
 +
 
 +
*'''Máx. NSU:''' Maior NSU disponibilizada pela SEFAZ no momento da consulta.
 +
 
 +
*'''Data / Hora:''' Data e hora em que a consulta foi realizada.
 +
 
 +
*'''Motivo:''' Resultado ou situação apresentada durante o processamento da consulta, como, por exemplo, Documento localizado ou Nenhum documento localizado.
 +
 
 +
Quando novos documentos forem localizados, eles ficarão disponíveis para tratamento na tela de [[Manifestação Destinatário MD-e|Manifestação do Destinatário]].
 +
 
 +
\==='''Detalhamento do Documento'''===
 +
Ao selecionar um documento na grade de resultados da Distribuição DF-e, o sistema apresenta o detalhamento das informações relacionadas ao documento selecionado, permitindo consultar os registros vinculados a ele.
 +
 
 +
O detalhamento é organizado nas seguintes abas:
 +
 
 +
*'''Conhecimento de Transporte:''' Apresenta as informações do CT-e selecionado, incluindo data, número, série, situação, valor dos serviços, histórico e emitente.
 +
 
 +
*'''Manifestação Destinatário:''' Apresenta as informações relacionadas às manifestações realizadas para o documento selecionado.
 +
 
 +
*'''Manutenção de Notas Fiscais:''' Apresenta as informações relacionadas às notas fiscais vinculadas ao documento.
 +
 
 +
*'''Eventos:''' Apresenta os eventos relacionados ao documento selecionado, permitindo consultar o histórico de eventos registrados.
 +
 
 +
==='''Informações de Processamento da Consulta'''===
  
<img src="https://wiki.phsys.com.br/images/WIKI/modulos/fiscal/distribuicao_de_dfe/Uso_Indevido_WebService.png" alt="Imagem do botão de novo cadastro" width="100%">
+
Cada execução da distribuição gera um registro na grade de processamento, permitindo consultar o histórico das distribuições realizadas.
  
 +
O registro apresenta a evolução das NSUs consultadas e o resultado obtido em cada processamento. Dessa forma, é possível acompanhar se foram localizados novos documentos ou se a consulta não encontrou documentos disponíveis para a filial.
  
*'''Informações de Processamento da Consulta:''' A cada lote consultado, serão exibidas as informações relacionadas ao documentos incluídos ou alterados. Os documentos vão estar disponíveis na tela de [[Manifestação Destinatário MD-e|manifestação]]. A qualquer momento é possível interromper o processo pelo botão na parte inferior "Interromper".
+
Os documentos localizados durante a distribuição ficam disponíveis posteriormente na tela de [[Manifestação Destinatário MD-e|Manifestação do Destinatário]].

Edição das 15h35min de 10 de agosto de 2026

Conceito

A Distribuição DF-e permite realizar a consulta de documentos fiscais destinados à empresa, disponibilizando as informações necessárias para o processo de Manifestação do Destinatário.

Por meio da distribuição, são consultados os documentos fiscais emitidos contra o CNPJ da empresa, permitindo posteriormente realizar o tratamento e a manifestação dos documentos disponíveis na tela de Manifestação do Destinatário.

O processo de consulta é realizado em lotes, conforme o mecanismo de distribuição disponibilizado pela SEFAZ. A cada consulta, o sistema controla as informações de processamento e a sequência de documentos consultados, permitindo dar continuidade às consultas posteriores sem a necessidade de consultar novamente documentos já processados.

É importante evitar consultas excessivas ao serviço da SEFAZ, pois o consumo indevido pode ocasionar rejeições e temporariamente impedir novas consultas ao webservice.

Filtros

A tela permite filtrar as distribuições já realizadas por meio dos seguintes campos:

  • Data: Permite informar um período inicial e final para localizar as distribuições realizadas.
  • Hora: Permite definir um intervalo de horário para complementar o filtro por data.
  • Filial: Permite selecionar a filial relacionada à distribuição dos documentos.

A opção Salvar Filtro, quando habilitada, permite que os filtros informados sejam mantidos para utilização posterior.

Realizando a consulta

Para realizar a consulta dos documentos destinados, utilize o botão de Atualizar/Consultar disponível na parte superior da tela.

A consulta utiliza o controle de NSU realizado pelo sistema para dar continuidade à distribuição dos documentos, evitando que documentos já consultados sejam processados novamente.

Durante o processo, o sistema realiza as consultas em lotes e atualiza as informações apresentadas na tela conforme os resultados retornados pela SEFAZ.

O acompanhamento das consultas pode ser realizado pela grade de distribuições, onde são apresentadas as informações de cada processamento:

  • Filial: Filial relacionada à consulta realizada.
  • Última NSU: Última NSU processada na consulta.
  • Máx. NSU: Maior NSU disponibilizada pela SEFAZ no momento da consulta.
  • Data / Hora: Data e hora em que a consulta foi realizada.
  • Motivo: Resultado ou situação apresentada durante o processamento da consulta, como, por exemplo, Documento localizado ou Nenhum documento localizado.

Quando novos documentos forem localizados, eles ficarão disponíveis para tratamento na tela de Manifestação do Destinatário.

\===Detalhamento do Documento=== Ao selecionar um documento na grade de resultados da Distribuição DF-e, o sistema apresenta o detalhamento das informações relacionadas ao documento selecionado, permitindo consultar os registros vinculados a ele.

O detalhamento é organizado nas seguintes abas:

  • Conhecimento de Transporte: Apresenta as informações do CT-e selecionado, incluindo data, número, série, situação, valor dos serviços, histórico e emitente.
  • Manifestação Destinatário: Apresenta as informações relacionadas às manifestações realizadas para o documento selecionado.
  • Manutenção de Notas Fiscais: Apresenta as informações relacionadas às notas fiscais vinculadas ao documento.
  • Eventos: Apresenta os eventos relacionados ao documento selecionado, permitindo consultar o histórico de eventos registrados.

Informações de Processamento da Consulta

Cada execução da distribuição gera um registro na grade de processamento, permitindo consultar o histórico das distribuições realizadas.

O registro apresenta a evolução das NSUs consultadas e o resultado obtido em cada processamento. Dessa forma, é possível acompanhar se foram localizados novos documentos ou se a consulta não encontrou documentos disponíveis para a filial.

Os documentos localizados durante a distribuição ficam disponíveis posteriormente na tela de Manifestação do Destinatário.