Solicitação: Implementar Requirement 62628.
Detalhes:
Equalizar os processos de integração do e-Agente / e-Datacenter para que o mesmo receba todas as integrações geradas pelo e-Forms, assim como processo de reimpressão.
Implementação realizada:
O objetivo dessa demanda é mudar a forma de funcionamento do e-Agente para que ele passe a funcionar com um processamento semelhante ao do Web Service de DF-e.
e-Agente
O e-Agente vai ficar de tempo em tempo fazendo uma chamada a um Web Service do e-Datacenter para receber todas as novas integrações de processos realizados por esse e-Agente.
Esse tempo de consultas poderá ser parametrizado através do Configuration Manager do e-Datacenter como mostra a imagem abaixo:
Onde:
• Quantidade de consultas do e-Agente (Modo Rápido) – Será a quantidade de consultas que o e-Agente irá realizar no tempo configurado.
• Intervalo de Consultas do e-Agente (Segundos – Modo Rápido) – O Intervalo (Em segundos) de tempo que o e-Agente irá realizar as consultas.
• Intervalo de Consultas do e-Agente (Minutos – Modo Normal) - Essa informação ira determinar durante quanto tempo as consultas irão ser realizadas quando o e-Agente não ter tido algum processamento recente após o término das consultas em modo rápido.
GUID
Atualmente existem vários clientes que utilizam o mesmo “Código de Cliente” em vários pontos emissores, para melhorar esse cenário foi criado um novo valor único (GUID) para poder identificar exatamente qual máquina/ponto emissor gerou ação para que apenas esse ponto emissor receba as integrações relacionadas a esse documento.
Quando o usuário migrar o seu e-Agente para a versão 3.5.0.0 será gerado um identificador único (GUID) para esse e-Agente. Esse valor deverá ser armazenado em uma chave de registro: HKEY_LOCAL_MACHINE/Software/NDDigital/Agente330/”AgentGUID”.
Esse novo valor é que será usado para identificar exatamente qual e-Agente irá receber as integrações do e-Datacenter.
Comunicação para envio de documentos
Nesse novo modelo, além do arquivo a ser processado o e-Agente deverá enviar na comunicação o seu identificador único (GUID).
Comunicação para recepção de integrações
Por padrão o e-Agente deverá ficar buscando por novas integrações de 5 em 5 minutos.
Quando o e-Agente enviar um novo arquivo para processar, o tempo de consulta deverá ser menor. Nesses casos devemos fazer 10 consultas com intervalos de 30 segundos (5 minutos de consulta de 30 em 30 segundos). Após esse tempo as consultas voltaram a ocorrer de 5 em 5 minutos.
A cada novo arquivo reenviado, o contador de consultas irá reiniciar.
Essas consultas serão controladas através de um NSU que será armazenado na TBNSUCONTROL, e vinculado ao CNPJ da empresa em questão, o mesmo poderá ser visualizado através do e-Agente Tools na aba “Geral”:
Nessa tela serão exibidos o ‘Último NSU’ consultado e o GUID do e-Agente instalado.
Caso tenha a necessidade de integrar processos anteriores, no campo ‘Último NSU’ poderá ser alterado o NSU e na próxima consulta serão retornados todos os processos a partir do NSU configurado.
Core
Após o e-Agente fazer a comunicação com o Web Service de recepção e enviar o arquivo a ser processado, será gravado em uma tabela de controle os dados de quem solicitou a ação para podermos retornar as integrações ao e-Agente correto. Segue a estrutura da tabela de controle:
TBAGENTREQUEST
ID (BIGINT)
ENTERPRISEID (BIGINT)
EMISSIONPONIT (BIGINT)
AGENTGUID (UNIQUEIDENTIFIER)
PROCESSDATE (DATETIME)
DOCUMENTKEY1(BIGINT)
DOCUMENTKEY2(BIGINT)
DOCUMENTKEY3(INT)
DOCUMENTKIND (SMALLINT)
TBAGENTREQUESTDATA
ID (BIGINT)
REQUESTID (BIGINT)
REQUESTDATA (NVARCHAR(MAX))
Abaixo seguem os tipos de documentos que podemos receber:
•Envio
•Cancelamento (-ped-can)
•Inutilização (-ped-inu)
•Cancelamento/Inutilização (-ped-can-inu)
•Consulta (-ped-cons)
•Abort (-ped-abort)
•Ajuste (-ped-ajuste)
•Consulta de doc. não encerrados (-ped-consNaoEnc)
•Solicitação de reimpressão do documento (ped-print - uso exclusivo do e-Datacenter)
•Solicitação de integração do documento (ped-int - uso exclusivo do e-Datacenter)
•Eventos (-ped-evt)
NF-e:
•110110 - Carta de correção;
•110111 – Cancelamento;
•111500 - 1° Pedido de Prorrogação
•111501 - 2° Pedido de Prorrogação
•111502 - 1° Cancelamento de Pedido de Prorrogação
•111503 - 2° Cancelamento de Pedido de Prorrogação
CT-e:
•110110 – Carta de correção
•110111 – Cancelamento
•110160 – Multimodal
MDF-e:
•110111 - Cancelamento;
•110112 - Encerramento;
•110114 - Inclusão de Condutor
Cada tipo de arquivo enviado pelo e-Agente podemos retornar uma ou mais integrações.
Segue abaixo uma lista dos tipos de integrações possíveis de serem retornadas para cada tipo de arquivo:
Envio
•Envio (CONNECTORINTEGRATION.KIND = 0);
•Inutilização (CONNECTORINTEGRATION.KIND = 2);
•Impressão (CONNECTORINTEGRATION.KIND = 3);
•Erros (CONNECTORINTEGRATION.KIND = 5);
•Substituição (CONNECTORINTEGRATION.KIND = 6);
•Rejeição AD-e (CONNECTORINTEGRATION.KIND = 9);
•EPEC (CONNECTORINTEGRATION.KIND = 10);
•Retorno auditoria Vaccine (CONNECTORINTEGRATION.KIND = 11);
Cancelamento (-ped-can)
•Cancelamento (CONNECTORINTEGRATION.KIND = 1);
•Erros (CONNECTORINTEGRATION.KIND = 5);
•Evento (CONNECTORINTEGRATION.KIND = 7);
Inutilização (-ped-inu)
•Inutilização (CONNECTORINTEGRATION.KIND = 2);
•Erros (CONNECTORINTEGRATION.KIND = 5);
Cancelamento/Inutilização (-ped-can-inu)
•Cancelamento (CONNECTORINTEGRATION.KIND = 1);
•Inutilização (CONNECTORINTEGRATION.KIND = 2);
•Erros (CONNECTORINTEGRATION.KIND = 5);
•Evento (CONNECTORINTEGRATION.KIND = 7);
Consulta (-ped-cons)
•Envio (CONNECTORINTEGRATION.KIND = 0);
•Cancelamento (CONNECTORINTEGRATION.KIND = 1);
•Inutilização (CONNECTORINTEGRATION.KIND = 2);
•Evento (CONNECTORINTEGRATION.KIND = 7);
Abort (-ped-abort)
•Envio (CONNECTORINTEGRATION.KIND = 0);
Ajuste (-ped-ajuste)
•Envio (CONNECTORINTEGRATION.KIND = 0);
•Cancelamento (CONNECTORINTEGRATION.KIND = 1);
•Inutilização (CONNECTORINTEGRATION.KIND = 2);
•Evento (CONNECTORINTEGRATION.KIND = 7);
•EPEC (CONNECTORINTEGRATION.KIND = 10);
Consulta de doc. não encerrados (-ped-consNaoEnc)
•Retorno da consulta de documentos MDF-e não encerrados (CONNECTORINTEGRATION.KIND = 12);
•Solicitação de reimpressão do documento (ped-print - uso exclusivo do e-Datacenter)
•Solicitação de integração do documento (ped-int - uso exclusivo do e-Datacenter)
•Eventos (-ped-evt)
NF-e:
110110 - Carta de correção;
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
110111 – Cancelamento;
Cancelamento (CONNECTORINTEGRATION.KIND = 1);
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
111500 - 1° Pedido de Prorrogação
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
111501 - 2° Pedido de Prorrogação
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
111502 - 1° Cancelamento de Pedido de Prorrogação
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
111503 - 2° Cancelamento de Pedido de Prorrogação
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
210200 - Confirmação da operação;
210210 - Ciência da operação;
210220 - Desconhecimento da operação;
210240 - Operação não realizada.
CT-e:
110110 – Carta de correção
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
110111 – Cancelamento
Cancelamento (CONNECTORINTEGRATION.KIND = 1);
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
110160 – Multimodal
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
MDF-e:
110111 - Cancelamento;
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
110112 - Encerramento;
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
110114 - Inclusão de Condutor
Erros (CONNECTORINTEGRATION.KIND = 5);
Evento (CONNECTORINTEGRATION.KIND = 7);
Importante:
•Para os novos processos a partir desta versão será obrigatório estar habilitado a função ‘Gerar integrações de status final para reenvios’ nos Job’s do e-Forms pois essa validação não será mais realizada pelo e-Datacenter e sim direto e-Forms.
•Arquivos rejeitados poderão ser reprocessados através do e-Monitor, permitindo o e-Agente receber o retorno desse processo.
•Será possível realizar reimpressões através do e-Monitor.
e-Agente Tools:
Haverá alteração referente ao arquivo ped-int e ped-print gerados através da ferramenta e-Agente Tools, que a partir dessa versão (3.5.0.0).
Arquivos Ped-int:
O ped-int será convertido em um arquivo de consulta (ped-cons) pelo Core e-Datacenter, e será enviado para o e-Connector processar o mesmo seguindo as regras abaixo:
Modelo 01:
Este campo pode receber os valores 1 ou 0:
1 - Trazer todas as integrações (ProcessBaseIntegrateStatus = 5);
0 - Apenas a última integração.
Modelo 2 - Para Emitente - versão do arquivo 3.10
0,1 - Consulta Normal (ProcessBase = 1);
2,3 - Consulta de eventos de saída (ProcessBaseOnlyEvents = 3);
6,7 ou 8 - Consulta de evento de manifesto (ponto emissor consulta se o destinatário deu manifesto para a nota emitida) (QueryManifestEventOnSefaz = 8).
Modelo 3 - Para Destinatário - versão do arquivo 3.10
9 – Retorna a integração de evento de manifesto gerado pelo ponto receptor (QueryManifestEventOnDB = 6).
Arquivos Ped-print:
O ped-print será convertido em um arquivo de impressão comandada (.env) pelo Core e-Datacenter, e será processado pelo ERP Print.
Nesse caso será necessário compartilhar o diretório do ERP Print com o ambiente do Core e-Datacenter. Esse diretório deverá ser informado nas ‘Configurações Gerais’ do e-Datacenter Configuration Manager, como mostra a imagem abaixo:
