A integração entre o sistema Gesplan e o ERP Datasul envolve diversos componentes tecnológicos que precisam estar corretamente configurados e conectados para garantir o funcionamento pleno da solução. Cada uma dessas tecnologias tem um papel específico e depende da outra para garantir o fluxo de dados de forma segura, rastreável e confiável.
Para as integrações de Arrendamento, Locações e Operações Financeiras, é utilizado o seguinte fluxo: Gesplan → SmartLink Server → SmartLink Client → Contabilidade / Caixa Bancos (Datasul).
Esse processo ocorre via método Behaviour Sharing, sendo a estratégia padrão adotada para este tipo de integração entre o Gesplan e o ERP Datasul. As mensagens trafegam em formato JSON, processadas pelo SmartLink Server, encaminhadas ao SmartLink Client e posteriormente integradas nos módulos contábil e financeiro do ERP.
2.1 SMARTLINK CLIENT DATASUL
O SmartLink Client é o componente responsável por realizar a comunicação entre o SmartLink Server e o ERP Datasul. Instalado na infraestrutura do próprio cliente (on-premise), ele atua como ponte para envio e recebimento de mensagens entre os sistemas.
Para que a integração com o SmartLink ocorra corretamente no ambiente Datasul, é necessário configurar as credenciais de acesso à TOTVS Apps:
|
2.2 GERENCIADOR DE MENSAGENS SMARTLINK CLIENT
Recomendamos que este programa deve ser acessado apenas por usuários administradores do produto Datasul, garantindo segurança e manutenção da integração. |
Verifique se os seguintes tipos de mensagens foram criados corretamente no cadastro de Tipos de Mensagens do SmartLink Client:
|
Para maiores detalhes sobre o gerenciador de mensagens acessar o link abaixo:
Gerenciador de Mensagens do Smart Link
2.3 INSTALAÇÃO SMART LINK CLIENT
A instalação do Smart Link Client deve ser realizada conforme as instruções disponíveis no link abaixo:
Para maiores detalhes sobre a integração Datasul x Smartlink Client, acessar o link abaixo:
Integração Datasul x Smarlink Client.
2.4 CONFIGURAÇÕES ERP DATASUL
Para viabilizar a integração entre o sistema de origem (Gesplan) e os módulos do ERP Datasul — Contabilidade e Caixa e Bancos — é necessário realizar o cadastro do módulo/produto de origem.
Essa configuração tem como principal objetivo facilitar a identificação, rastreabilidade e consulta dos movimentos gerados, permitindo o correto funcionamento das rotinas, relatórios e consultas tanto na Contabilidade Fiscal quanto no Caixa e Bancos.
Para maiores detalhes sobre o cadastro e parametrização, acesse os links específicos abaixo:
Configuração para Contabilidade
Configuração para Caixa e Bancos
2.5 MONITOR SMARTLINK SERVER
O correto funcionamento do SmartLink via Behavior Sharing depende de um monitoramento eficiente das mensagens que trafegam entre os serviços. Para isso, está disponível o Monitor do Smart Link, ferramenta essencial para acompanhar o comportamento das filas dos Clients. Através dele, é possível verificar:
A quantidade de mensagens atualmente na fila, aguardando leitura pelo Client;
Qual mensagem está há mais tempo pendente na fila;
Os tipos de mensagens que estão sendo processadas ou aguardando processamento.
O Monitor exibe apenas as mensagens originadas nos TOTVS Apps, que têm como destino o SmartLink Client. |
Para maiores informações sobre uso e acesso ao monitor, consulte o link abaixo:
2.6 FLUXOGRAMA DA INTEGRAÇÃO
Nesta integração, o ERP Datasul é responsável por enviar dados relacionados às movimentações financeiras previstas e realizadas para o produto Gestão de Fluxo de Caixa do Gesplan.
3.1 PROVISIONAMENTO E AUTENTICAÇÃO DE ENTIDADES(RAC)
Para garantir o correto controle das operações de criação, alteração e exclusão de registros nas tabelas do módulo Financeiro do Datasul, é necessário que as entidades (tabelas) envolvidas na integração sejam devidamente autenticadas pelo RAC (Resource Access Control).
A seguir, apresentamos a lista de tabelas que devem ser autenticadas para que a estratégia de Upstream Data Sharing funcione corretamente:
Banco | Tabela/Descrição | Filtro |
movfin | antecip_ped_pend / Antec PED Pendente | x |
movfin | impto_vincul_tit_acr / Impostos Vinculados ao Título | x |
movfin | movto_tit_acr / Movimento do Título ACR | movfin.movto_tit_acr.dat_transacao >= today - 730 |
movfin | tit_acr / Título Contas a Receber | movfin.tit_acr.dat_emis_docto >= today - 730 |
movfin | movto_tit_ap / Movimento Título AP | movfin.movto_tit_ap.dat_transacao >= today - 730 |
movfin | nota_devol_tit_acr / Relacionamento Notas Devolução | movfin.nota_devol_tit_acr.dat_emis_docto >= today - 730 |
movfin | rat_movto_tit_acr / Rateio Movimento Título ACR | x |
movfin | rat_movto_tit_ap / Rateio Movimento Título AP | x |
movfin | tit_ap / Título Contas a Pagar | movfin.tit_ap.dat_emis_docto >= today - 730 |
movfin | movto_cta_corren / Movimento de Conta Corrente | movfin.movto_cta_corren.dat_transacao >= today - 730 |
movfin | aprop_ctbl_cmg / Apropriação Contábil Caixa e Bancos | x |
movfin | aprop_ctbl_acr / Apropriação Contábil ACR | x |
movfin | val_movto_tit_acr / Valor do Movto ACR | x |
movfin | aprop_ctbl_ap / Apropriação Contábil APB | x |
movfin | val_tit_ap / Valor Título Contas a Pagar | x |
movfin | val_movto_ap / Valores do movimento do APB | x |
movfin | movto_acr_gesplan / Movimentos do ACR enviados para Gesplan | x |
movfin | movto_apb_gesplan / Movimentos do APB enviados para Gesplan | x |
movfin | movto_cta_corren_gesplan / Movimentos do Caixa e Bancos enviados para Gesplan | x |
movfin | rat_financ_cmg / Rateio Financeiro Caixa e Bancos | x |
As tabelas |
3.2 INSTALAÇÃO E MONITORAMENTO DO DATASYNC
Para que a estratégia de integração Upstream Data Sharing funcione corretamente, é fundamental que o serviço Data Sync esteja instalado e executando conforme o esperado.O Data Sync Service é o componente central responsável por monitorar continuamente as tabelas do ERP, detectando criações, alterações e exclusões de dados nas entidades autenticadas pelo RAC.
Atenção: Caso o serviço Data Sync não esteja ativo ou corretamente configurado, nenhuma alteração nas tabelas será capturada para envio. Com isso, os dados não serão transmitidos ao SmartLink Client, interrompendo todo o fluxo de integração com o Gesplan. |
Para mais detalhes sobre a instalação e ativação do serviço, consulte o link abaixo:
3.3 ENVIO DE INFORMAÇÕES PARA O GESPLAN
A integração entre o ERP Datasul e o módulo Gestão de Caixa e Tesouraria do Gesplan contempla o envio contínuo de dados das movimentações dos módulos Contas a Pagar, Contas a Receber e Caixa e Bancos.
Para isso, o Datasul conta com a rotina Parâmetros Integração Cash Gesplan(html.cashGesplanIntegration ) que realiza a população das tabelas intermediárias:
movto_apb_gesplan (Contas a Pagar)
movto_acr_gesplan (Contas a Receber)
movto_cta_corren_gesplan (Movimentos Bancários).
Essa rotina garante que todas as alterações nas tabelas financeiras do ERP sejam refletidas nas tabelas utilizadas para sincronização com a Gesplan. A execução correta dessa rotina é fundamental para que o DataSync capture os dados atualizados e os envie ao SmartLink Client, garantindo o sucesso da integração.
A rotina deve ser configurada para:
Realizar a carga inicial das informações;
Agendar o envio contínuo dos dados, conforme os parâmetros definidos na tela Parâmetros de Gestão de Caixa e Tesouraria.
Para detalhes da configuração e execução da rotina, consulte o link abaixo:
Integração Gestão de Caixa e Tesouraria
3.4 FLUXOGRAMA DA INTEGRAÇÃO