Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Visando oferecer uma melhor usabilidade na integração por mensagens EAI 2.0, as mensagens associadas ao ciclo de vida de um lançamento financeiro no RM (inclusão, alteração, cancelamento, baixa, cancelamento da baixa, acordo, Acordo e cancelamento do acordoAcordo), passam a dispor de um novo modelo de integração. Esta evolução, no momento, se aplica exclusivamente aos lançamentos gerados pelo Educacional, e a habilitação da funcionalidade está sendo feita de forma progressiva e controlada, apenas para apenas alguns clientes.


Como funciona

Como exemplo, considere a inclusão de um novo lançamento financeiro gerado a partir do TOTVS Educacional. Durante os procedimentos de registro da inclusão do lançamento financeiro, a mensagem que seria enviada ao Protheus não é executada, em seu lugar ocorre a gravação de um registro em no banco de dados com o conteúdo da mensagem. Assim, após consolidada toda a atualização do banco de dados no RM, esta mensagem registrada no banco de dados é resgatada, e então finalmente é enviada ao Protheus. 

O envio da mensagem ocorre a partir de um estado consistentemente gravado no RM. Se ao enviar a mensagem pendente ao Protheus, o procedimento de inclusão for executado com sucesso no Protheus, a mensagem pendente é removida do banco de dados. Por outro lado, se ao enviar a mensagem pendente ao Protheus, este reportar algum problema, a mensagem fica retida no banco de dados. Enquanto a mensagem permanecer pendente, o (s) lançamento (s) associado (s) fica (m) em estado de inconsistência, impedido (s) de ser (em) submetido (s) a outros processos do RM, tais como baixa e o acordoAcordo.


Visão de Mensagens Pendentes

As mensagens pendentes poderão ser observadas na visão de monitoramento das mensagens EAI, disponível através do menu "Utilitários | Mensagem EAI". Uma vez que a causa do problema na comunicação entre os sistemas esteja solucionada, as mensagens poderão ser selecionadas , e enviadas através do processo "Reenviar Mensagem". A causa da falha poderá ser melhor entendida ao editar uma mensagem pendente.  

...

Ao solicitar a edição da mensagem EAI pendente, será apresentado detalhamento da mensagem, com a mensagem de erro gerada pelo EAI , e o detalhamento do conteúdo da mensagem na aba "Metadados", em formato XML.


Reenvio de Mensagem

Uma mensagem pode existir de forma autônoma , ou como parte de um agrupamento (grupo de mensagem). Ao selecionar uma ou mais mensagens da visão e solicitar o reenvio, o sistema irá identificar os respectivos grupos de mensagens associados àquelas mensagens, ordenará estes grupos por ordem cronológica de execução , e irá disparar cada uma das mensagens destes grupos que estejam com status "Pendente" ou "Falha". 

Esta execução avançará de mensagem em mensagem em cada grupo, até que todas tenham sido enviadas , ou até que ocorra o primeiro erro. Esta medida é importante porque, em alguns casos, existe dependência entre as mensagens, como por exemplo, no TOTVS Educacional quando associa um lançamento existente a uma bolsa 100%, este modifica o lançamento financeiro e, e em seguida efetuar , efetua a respectiva baixa. Neste cenário, se houver impedimento para a modificação do lançamento, a mensagem de baixa deve aguardar a correção do impedimento.

...

Expandir
titleManutenção de Lançamentos

O processo de inclusão, alteração e cancelamento de lançamentos financeiros, integrados ao Protheus no contexto desta nova arquitetura dispõe de alguns mecanismos visando facilitar a correção de eventuais problemas:

  • Ao proceder a inclusão de novo lançamento, se houver algum problema para o envio da mensagem, este será marcado como pendente de envio de mensagem EAI , e permanecerá bloqueado para execução de outros processos (ex.: baixa, acordoAcordo, etc.).
  • Se o lançamento foi incluído no RM, mas ainda não foi integrado ao Protheus, este poderá ser editado , ou cancelado. Se editado neste contexto, ocorrerá a substituição da mensagem EAI pendente por uma nova modificada, que será submetida a uma nova tentativa de envio. Se cancelado neste contexto, ocorrerá apenas a remoção da mensagem EAI pendente, procedendo o processo de cancelamento no RM sem a obrigação de primeiro enviar a mensagem de inclusão.
  • Se o lançamento foi incluído no RM e este foi corretamente integrado ao Protheus, ao editar este lançamento, este será modificado no RM e uma mensagem de alteração será enviada ao Protheus. Ocorrendo algum impedimento para alteração deste lançamento no Protheus, o lançamento ficará bloqueado para outros processos, inclusive para cancelamento.
Expandir
titleBaixa de Lançamentos

O processo de baixa , e cancelamento de baixa de lançamentos financeiros , integrados ao Protheus no contexto desta nova arquitetura dispõe de alguns mecanismos visando facilitar a correção de eventuais problemas:

  • Ao proceder realizar a baixa de um lançamento, este será validado da não existência de bloqueio para o envio de mensagem EAI devido a alguma mensagem EAI anterior ainda pendente de envio. Não existindo impedimento, a mensagem EAI é colocada em fila de processamento. 
  • Ao proceder realizar o cancelamento da baixa de um lançamento é avaliado se a mensagem EAI de baixa foi efetivamente enviada , e processada com sucesso pelo Protheus. Caso a baixa não tenha sido integrada ao Protheus devido a algum incidente, esta baixa poderá ser cancelada no RM sem o envio de mensagem EAI no Protheus.
Expandir
titleAcordo de Lançamentos

O processo de acordo, Acordo e cancelamento de acordo Acordo de lançamentos financeiros , integrados ao Protheus no contexto desta nova arquitetura dispõe de alguns mecanismos visando facilitar a correção de eventuais problemas:

  • Ao proceder incluir o acordo Acordo de um lançamento, este será validado de não existência de bloqueio para o envio de mensagem EAI devido a alguma mensagem EAI anterior ainda pendente de envio. Não existindo impedimento, a mensagem EAI é colocada na fila de processamento.
  • Ao proceder realizar o cancelamento do Acordo de acordo de um lançamento, é avaliado se a mensagem de acordo foi enviada , e processada com sucesso pelo Protheus. Caso o acordo Acordo não tenha sido integrado ao Protheus devido a algum incidente, este acordo Acordo poderá ser cancelado no RM sem o envio de mensagem EAI no Protheus.