Histórico da Página
Evolução da Arquitetura da Integração com Protheus
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 BackOffice Linha RM (inclusão, alteração, cancelamento, baixa, cancelamento da baixa, acordo
...
e cancelamento do
...
Acordo), 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
...
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 no banco de dados com o conteúdo da mensagem. Assim, após consolidada toda a atualização do banco de dados
...
da linha RM, esta mensagem registrada no banco de dados é resgatada
...
e
...
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
...
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
...
módulo Gestão Financeira, tais como baixa e o
...
Acordo.
Mensagens Pendentes
...
Comportamento Original:
A mensagem ao Protheus (em azul) é executada ao longo da execução do processo no RM (em verde). Se porventura o processamento for interrompido pelo RM após acionado o envio da mensagem, o processo RM pode sofrer um rollback (desfazimento) automático, sem efeito no processo no Protheus, gerando inconsistência.
Novo processo de envio de mensagens:
Neste caso, o processo do RM (em verde) é executado normalmente até o seu final levando a base a um ponto de consistência. Após o processo ser encerrado com sucesso, ocorre o disparo de um novo processo apenas para o envio da mensagem ao Protheus (em azul). Se a execução do envio da mensagem ao Protheus retornar um erro, a mensagem fica registrada no banco de dados do RM e poderá ser reenviada após uma ação corretiva.
Configuração Necessária
A natureza do Protheus é significativamente mais restritiva que o RM no que diz respeito ao tratamento das datas de emissão e vencimento na manutenção do lançamento, e da data de baixa, por ocasião da baixa do lançamento. Neste cenário, é necessário que sejam habilitadas algumas restrições na configuração do RM, de modo que não ocorra de um processo iniciado no RM seja bloqueado de ser concluído no Protheus, com prejuízo de necessariamente este procedimento ser desfeito e novamente aplicado com os devidos ajustes.
Seguem algumas orientações de ajustes e procedimentos:
1) Desabilitar o parâmetro "Permite data de vencimento menor que data de emissão" em parâmetros do TOTVS Gestão Financeira, nos parâmetros de inclusão de lançamentos.
2) Desabilitar o parâmetro "Permite data de baixa menor que data de emissão" nos parâmetros do TOTVS Gestão Financeira, nos parâmetros de baixa dos lançamentos.
3) Ao executar a baixa manual, o atributo "Data de baixa igual ao vencimento" não deve ser marcado, e não deve ser informada uma data futura.
Observação: As orientações de ajustes e procedimentos 1), 2) e 3) serão validadas pelo sistema durante os processos, caso não estejam conforme orientação serão exibidas mensagens de aviso orientando sobre as mesmas. Estas validações visão garantir que os processos sejam concluídoscom sucesso no Protheus.
Visão de Mensagens Pendentes
As mensagens pendentes poderão ser observadas na visão de monitoramento das mensagens EAI, disponível no módulo Gestão Financeira 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.
Envio / 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,
...
em seguida
...
, 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 | ||
---|---|---|
| ||
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 .:
|
Expandir | ||
---|---|---|
| ||
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:
|
Expandir | ||
---|---|---|
| ||
O processo de Acordo e cancelamento de 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:
|