Guia do Oobj Distribuição MD-e

Apresentação do Oobj Distribuição MD-e

Todo cliente Oobj que contrata a solução Oobj Recebe DF-e leva em sua composição a possibilidade de se receber documentos fiscais através de uma conta de e-mail e de uma consulta diretamente no WebService da Sefaz na intenção de obter todos os arquivos XMLs de NF-e e CT-e que foram emitidos contra o seu CNPJ.

A aplicação responsável por fazer essa recuperação de XML se chama Oobj Distribuição MD-e. Sua funcionalidade principal é o recebimento automático de DF-e diretamente no ambiente da Sefaz Nacional, ou seja, ele descobre todos os documentos compatíveis que foram emitidos contra seu CNPJ e os disponibilizam para visualização através do Monitor Oobj. Esses documentos podem ser:

Resumo de NFe
Resumo de Evento
Proc NFe
Proc Evento NFe
Proc CTe
Proc Evento CTe

Fluxo do Oobj Distribuição MD-e

Veja como é simples o fluxo de processamento do Oobj Distribuição MD-e.

Monitor Oobj	No monitor Oobj você pode ativar a busca automática de XML na Sefaz para dar inicio ao fluxo do Distribuição MD-e.

Oobj MDe	Este é o nosso serviço responsável por realizar as requisições no WS do Ambiente Nacional a fim de buscar os documentos na base de dados.

Sefaz	A Sefaz é o destino final deste fluxo, onde, ao receber a requisição do Distribuição MD-e, retorna os possíveis documentos para captura.

Banco de Dados	Assim que o documento é disponibilizado pela Sefaz, gravamos ele no banco de dados e disponibilizamos o XML no monitor Oobj. Após o recebimento dos XMLs, você pode precisar que esses documentos sejam disponibilizados em alguma pasta ou via FTP, por exemplo. O serviço é totalmente capaz de entregar os arquivos em um diretório de rede, em uma pasta local ou até mesmo em um FTP previamente configurado. Para saber mais sobre essa configuração, acesse nossa base de conhecimento Ativar Integração com o ERP (entrega de XML recebido) no Monitor Oobj.

Processo de Recebimento no Monitor Oobj

Existe algumas funcionalidades a respeito dos documentos buscados automaticamente na Sefaz no Monitor Oobj.

Doc. Não Recebidos
	Documentos Não Recebidos são aqueles que foram emitidos contra o seu CNPJ, mas cujos arquivos Proc XML (arquivos idênticos aos armazenados na Sefaz) ainda não foram recebidos. O MD-e, ao fazer uma consulta no ambiente nacional, a Sefaz devolve somente algumas informações que a Sefaz denomina de resumo da NFe (resNFe). Esse resumo contém o CNPJ do Emitente e Destinatário, Valor da NF-e, Data de Emissão, Chave de Acesso, entre outras informações. Para que este documento vá para a aba de Doc. Recebidos, é necessário realizar uma manifestação do destinatário para que a aplicação MD-e consiga buscar o Proc XML. Para mais detalhes sobre manifestação do destinatário, leia nosso artigo da base de conhecimento.

Doc. Recebidos
	Documentos Recebidos são aqueles em que sua empresa aparece como Destinatário, Transportador, Remetente, Expedidor, Recebedor, etc. Em suma, documentos recebidos são todos aqueles que o seu CNPJ não é Emitente e ele consta no DF-e. Quando o documento está nesta aba, significa que já temos o Proc XML, seja por manifestação do destinatário ou por manifestação automática de ciência da operação. Habilitar Manifestação Automática de Ciência da Operação: Esse parâmetro pode ser ativado para que seja possível, após a consulta na Sefaz, o download do XML completo, já que a Sefaz exige que seja realizado um registro de Manifestação para que o Destinatário da NF-e possa realizar o download do XML completo. IMPORTANTE: Esse parâmetro ativa o registro do Evento do Destinatário de Ciência da Operação de forma automática. Para saber mais sobre a Manifestação Automática de Ciência da Operação, acesse nosso artigo de Ativar busca automática de XML na Sefaz.

Registro de Entrada
	É possível fazer também o Registro de Entrada de um documento manualmente caso o usuário receba um DANFE e tenha a Chave de Acesso. O Registro de Entrada é um controle de Portaria, utilizado para auxiliar em todas as movimentações relacionadas à entrada da nota/mercadoria nos estabelecimentos cadastrados, permitindo o controle da entrada dos DANFE/DACTE com a(s) mercadoria(s) transportada(s). Caso realize o registro de entrada com manifestação automática, o documento vai direto para a aba de Doc. Recebidos. Se for realizado o registro de entrada manual, a Sefaz informa que o documento será disponibilizado para download entre 5 a 15 minutos.

Consulta WS Distribuição
	Nessa tela é possível realizar pesquisa por todas as consultas realizadas pela Oobj no Web Service de Distribuição da Sefaz. Esse histórico permite identificar quando a Sefaz disponibilizou um certo documento para consulta e que tipo de documento foi disponibilizado nessa pesquisa. Para cada registro será possível verificar o CNPJ da Consulta, o NSU, o Tipo do Documento, Tipo da Consulta, a Chave de Acesso, a Data da Consulta e a Data da Resposta da Sefaz para a Consulta.

Limitações Impostas pela Sefaz na Nota Técnica 2014.002 v1.13 a v1.15

Limites de tempo e consulta

Limite de Tempo de Consulta: será permitido um número limitado de consultas por chave de acesso ou NSU em um período de 1hora.
Limite de Consultas: será permitido 20 consultas por hora no WS da Sefaz.

Obs: Cliente Oobj, não se preocupe, nossa aplicação está perfeitamente adaptada a essas parametrizações.

Penalidades/consequências por não respeitar as definições da Sefaz

Rejeição por consumo indevido
- Serão mantidos controles para identificar as situações de uso indevido de sucessivas tentativas de busca de registros já disponibilizados anteriormente.
  - As novas tentativas serão rejeitadas com o erro “656–Rejeição: Consumo Indevido”.

Não há mais documentos a distribuir e serviço continua consultando
- A realização de novas consultas em 1h, após receber a mensagem de não existir mais documentos a serem retornados, gerará o uso indevido. Nesse caso, o CNPJ é bloqueado por 1 hora, sendo impedido de realizar novas consultas nesse intervalo. Decorrido o intervalo de tempo, o desbloqueio será automático.

Serviço não está consultando os NSU de forma sequencial
- O serviço deve sempre realizar a consulta baseada no ultNsu retornado na consulta anterior, ou seja, deve usar os valores do ultNSU retornados pelo WS nas chamadas subsequentes. O valor do ultNSU corresponde ao ponto de onde a leitura dos blocos de documentos deve continuar. Quando ultNSU for igual ao valor do maxNSU retornado pelo WS, quer dizer que não existem mais documentos para serem recuperados. Neste caso, para não haver bloqueio por uso indevido, deve-se aguardar 1 hora para realização de novas consultas.

Consultada uma quantidade de NF-e ou NSU superior ao limite permitido por hora
- Será permitido um número limitado de consultas por chave de acesso ou NSU em um período de 1 hora. Se o usuário continuar consultando após atingir o limite de consultas por chave de acesso ou NSU em 1h, retornará consumo indevido. Nesse caso, o CNPJ é bloqueado por 1 hora, sendo impedido de realizar novas consultas nesse intervalo. Decorrido o intervalo de tempo, o desbloqueio será automático.
  - Quando o serviço receber a mensagem de consumo indevido, deve-se aguardar 1 hora. Se retomar a consulta antes de completar 1 (uma) hora, o tempo é zerado e a contagem reiniciará até completar 1 hora.

RESTRIÇÕES DE USO DO OOBJ DISTRIBUIÇÃO MD-E

Visto as causas de consumo indevido que bloqueia a busca de notas no período de 1 hora seguida, conclui-se alguns cuidados e restrições que deve-se ter ao utilizar a busca automática na Sefaz com o nosso serviço Distribuição MD-e.

Ao utilizar o MD-e, o mesmo está configurado para buscar a quantidade limite e no tempo limite proposta pela Sefaz para buscar o máximo de nota possível, agilizando assim a sua operação.

Devido a isso, um grande problema é utilizar duas aplicações diferentes para se realizar esta busca no WS da Sefaz (MD-e e outra aplicação, por exemplo). Visto que o MD-e já está consultando no limite, uma outra aplicação vai atrapalhar o funcionamento de ambos, pois a Sefaz retornará consumo indevido pelos motivos informados nos tópico anteriores.

Por exemplo, cada aplicação vai estar consultando um NSU diferente, a quantidade de consultas vai extrapolar o limite definido pela Sefaz, estarão consultando em tempos diferentes e afins. Como citado, a Sefaz retornará consumo indevido e será necessário esperar 1 hora ininterrupta para uma nova consulta. Um novo problema surge nisso: após receber esta rejeição, o MD-e esperará o tempo proposto para uma nova consulta, porém, se outra aplicação estiver rodando, poderá consultar nesse meio tempo fazendo com que o tempo seja zerado e a contagem reiniciará até completar 1 hora direto sem consultas.

Em resumo, duas aplicações atrapalhará extremamente a sua operação dependente das notas buscadas na Sefaz.

Referência

Nota Técnica 2014.002 v1.13 a v1.15

Nº do Artigo: 1245
Postado: 03/01/2023 09:26:01
Última atualização: 10/01/2023 08:39:58
Postado: Guilherme Silva [guilherme.silva@oobj.com.br]

URL: https://backupbc.novooobj.xyz/article/guia-do-oobj-distribuição-md-e-1245.html