CONTEÚDO
01. VISÃO GERAL
Painel |
---|
Informações |
---|
| Quer saber mais e contratar o TOTVS Consignado? Acesse o nosso site https://www.totvs.com/techfin/consignado, clique em "Ligamos para você" para prosseguir com a contratação do TOTVS Consignado! Ou ainda, contate o Executivo de Serviços e Negócios da sua conta para mais esclarecimentos. |
|
...
A instituição de crédito terá à sua disposição dados do colaborador necessários para o consignado, como nome, data de admissão, salário, matrícula, margem consignável, se houver geração de folha de pagamento para o mesmo, no período, além de dados rescisórios de colaboradores que já tenham empréstimos vigentes e conciliações do empréstimo. Terá ainda dados da empresa, como quantidade de funcionários por faixa salarial, a média salarial e o turnover anual, que influenciam nas ofertas de propostas, diferenciação de taxas, entre outros.
02. PRÉ-CONDIÇÕES PARA CONEXÃO
Os seguintes requisitos são necessários para implantação do produto:
...
Totvs custom tabs box |
---|
tabs | Pré-Requisitos , Parâmetros Integração, Config.Servidor RPW, Config.Módulo Audit Trail, Geração Triggers, Agendamento Automático, Sincronização Dados |
---|
ids | 1,2,3,4,5,6,7 |
---|
|
Totvs custom tabs box items |
---|
|
1.Progress Openedge versão 11.7.5 A versão do seu Progress deve ser conferida abrindo com um editor de texto o arquivo <unidade>\dlc117\version, por exemplo, C:\dlc117\version. Utilize o botão direito do mouse em cima do arquivo, opção Abrir com, escolha Notepad.
2.Bibliotecas no início do propath <%DLC%>\gui\OpenEdge.BusinessLogic.pl
<%DLC%>\gui\OpenEdge.Core.pl
<%DLC%>\gui\OpenEdge.ServerAdmin.pl
<%DLC%>\gui\netlib\OpenEdge.Net.pl
3.Datasul 12.1.32 ou superior No canto superior direito clique no botão Ajuda . Selecione Suporte, novas opções devem aparecer, selecione Informações do sistema. Na nova janela apresentada procure por Versão do Produto.
|
Totvs custom tabs box items |
---|
|
4.Dados de acessos parâmetros de integração Para que seja possível utilizar a integração do ERP com o TOTVS App (mais detalhes no item 04. PARÂMETROS PARA INTEGRAÇÃO deste documento) , é importante ter atenção para a carga dos certificados que serão responsáveis pela ativação das credenciais para autenticação da plataforma com os serviços utilizados no processo da integração (acesso ao RAC e Carol). Estas credenciais serão enviadas através de um e-mail de registro dos dados provisionados para a equipe técnica do cliente. Os certificados precisam ser baixados e importados para o progress através dos passos abaixo descritos neste documento:
Parâmetros de integração (Equipe TI cliente): O erp Datasul deve rodar com um dos servidores: Jboss(btb946aa) ou Tomcat(THF) que deverão ter parametrizados seus serviços conforme abaixo para integração com o TOTVS Consignado:
Para quaisquer servidores que estejam instalados a equipe técnica deverá: - Baixar e importar certificados dos serviços
- Acesse os 3 serviços (TOTVS RAC, TOTVS Apps e TOTVS Carol) através do seu navegador e baixe o certificado, faça o mesmo procedimento para os 3 serviços, seguindo os passos abaixo:
- Acessar em um navegador a URL sugerida para o serviço Carol;
- Selecionar o ícone de cadeado;
- Selecionar Certificado;
Figura 1
4. Selecionar Caminho de Certificação (Certification Path), selecionar o primeiro certificado e selecionar Exibir Certificado (View Certificate) comforme imagem da Figura 2;
![](/download/attachments/737574019/worddav75d7a6290657f687009f1296ea63ebf9.png?version=1&modificationDate=1675861112357&api=v2)
Figura 2
5. Acessar a aba de Detalhes (Details) e selecionar o botão Copiar para arquivo (Copy to File) conforme Figura 3;
![](/download/attachments/737574019/worddav7eb07a230deac2319135edd3d2d9a12c.png?version=1&modificationDate=1675861111763&api=v2) Figura 3
6. Será exibida tela inicial do Assistente para Exportação de Certificados, selecionar o botão Avançar duas vezes.
![](/download/attachments/737574019/worddav8f12d7f3ac74bbef9fd248e1366a8cec.png?version=1&modificationDate=1675861112100&api=v2)
Figura 4
7. Salvar o certificado no diretório de sua preferência e Concluir. Após fazer este procedimento para os 3 serviços, execute o arquivo C:\dlc117\bin\proenv.bat em modo Administrador. Uma tela DOS deve ser aberta, então execute o comando certutil –format DER –import <diretório-do-certificado> para cada certificado anteriormente salvo.
![](/download/attachments/737574019/worddavb8e9839fc6ba72acd646e96abe6551b9.png?version=1&modificationDate=1675861111500&api=v2)
Figura 5 |
Totvs custom tabs box items |
---|
|
5.Servidor RPW Caso já utilize um servidor RPW, você tem a opção de utilizá-lo também para esta configuração e pode pular para a próxima etapa Configuração do Módulo Audit Trail. - Criando .pf para o rpw
Acesse o diretório que contém os arquivos .pf, normalmente <diretório-instalação>\ERP\scripts-8X80\, clique com o botão direito do mouse e selecione Editar, o arquivo será aberto com o bloco de notas, na opção Arquivo escolha Salvar como, salve o arquivo no mesmo diretório porém com outro nome, por exemplo, rpw.pf. Apague todas as linhas de conexão de banco, são as linhas iniciadas por -db, exceto a linha do banco emsfnd, -db emsfnd. Na linha de configuração do clientlog altere o nome do arquivo .txt como desejar e salve o arquivo.
- Criando .ini para o rpw
Acesse o diretório que contém os arquivos .ini, normalmente <diretório-instalação>\ERP\scripts-8X80\, clique com o botão direito do mouse e selecione Editar, o arquivo será aberto com o bloco de notas, na opção Arquivo escolha Salvar como, salve o arquivo no mesmo diretório porém com outro nome, por exemplo, rpw.ini.
![](/download/attachments/737574019/worddav07b931c64b8887b96913e50ed6a5f334.png?version=1&modificationDate=1675861111917&api=v2)
Figura 6
- No programa Servidor de Execução (bas_ped_exec) inclua um novo servidor de execução:
![](/download/attachments/737574019/worddavd98c9234fc5921e7f52a150d13e62480.png?version=1&modificationDate=1675861111620&api=v2)
Figura 7
- Crie um atalho para ativar o servidor seguindo o padrão:
C:\dlc117\bin\prowin32.exe -cpterm iso8859-1 -cpstream ibm850 -pf <diretório>\rpw.pf -ininame <diretório>\rpw.ini -p btb\btb908za.p -param TEC,BTB,nomedorpw,usuário,senha Usuário e senha que devem ser colocados no atalho deve ser o mesmo indicado como supervisor na inclusão do servidor de execução. O nomedorpw deve ser o nome indicado no campo Servidor Execução. rpw.pf e rpw.ini são os arquivos criados anteriormente.
Figura 8
![](/download/attachments/737574019/worddav71abaf8daf9b13342069097520a6e751.png?version=1&modificationDate=1675861111203&api=v2)
Figura 9
![](/download/attachments/737574019/worddav1e0910ed0dce217fdc9ccbc1361b68fd.png?version=1&modificationDate=1675861110927&api=v2)
Figura 10
- Execute o atalho, a tela de ativação do servidor irá abrir, para ativar basta clicar no botão Ativa. Quando estiver ativo o servidor RPW ficará com status Aguardando Execução de Pedidos.
Figura 11
|
Totvs custom tabs box items |
---|
|
6.Configuração do Módulo Audit Trail No programa AU0009 - Parametrização do Audit Trail informe o servidor RPW configurado no passo anterior.
![](/download/attachments/737574019/worddav23ec7078e6f8f79fa292046a5a0f8d71.png?version=1&modificationDate=1675861110767&api=v2) Figura 12
No programa AU0001 - Manutenção Base de Dados configure as duas bases de dados necessárias para o TOTVS Consignado. Os campos Base Dados, Descrição e Nome Lógico devem ser os mesmos das imagens abaixo. O valor do campo Nome Físico pode ser encontrado no arquivo de alias no diretório <diretório-instalação>\ERP\scripts-8X80* normalmente nomeado *alias.p, abra o arquivo com um editor de texto e procure por CREATE ALIAS dthrpyc FOR DATABASE, o nome após DATABASE é o valor que usamos no campo Nome Físico. Faça o mesmo procurando desta vez por CREATE ALIAS mguni FOR DATABASE. Caso não encontre essas bases de dados no arquivo de alias, utilize dthrpyc e mguni.
![](/download/attachments/737574019/worddavf8421d77c0adb8187e149c80df6779d8.png?version=1&modificationDate=1675861110617&api=v2)
Figura 13
![](/download/attachments/737574019/worddav89e45b09c26470e7802a4aceb314a3cc.png?version=1&modificationDate=1675861110143&api=v2)
Figura 14
IMPORTANTE: - O diretório que está no campo Diretório Triggers, será onde as triggers serão geradas e este diretório deve estar apontado no Propath do servidor RPW e Appserver. Os propaths podem ser alterados nos arquivos .ini do diretório <diretório-instalação>\ERP\scripts-8X80\.
- Para correto funcionamento do módulo Audit Trail no arquivo .pf do appserver e do RPW altere o valor do parâmetro -tok para 32000. Se essa alteração não for feita no próximo passo será apresentado erro em tela.
|
Totvs custom tabs box items |
---|
|
7.Geração das triggers Após todas estas configurações, é necessária a geração das triggers ou policies. Para isso devemos executar a tarefa AU0108 - Geração das Triggers. Atenção: Para este procedimento nenhum usuário pode estar conectado a base de dados ou a mesma deva estar em modo mono usuário. Desative e feche a tela de ativação do servidor RPW caso esteja aberta.
Na aba Digitação dê 2 cliques nas bases de dados que acabamos de configurar e clique em Executar.
![](/download/attachments/737574019/worddavffd5b8bc7348bd98ef5c400fba081d93.png?version=1&modificationDate=1675861110473&api=v2) Confira no diretório configurado no AU0001 se as triggers foram geradas.
Figura 15 |
Totvs custom tabs box items |
---|
|
8.Configuração agenda automática (CD8600) Realize o cadastro do agendamento do programa. Para isso, acesse o programa de CD8600 - Agenda Automática, selecione a guia Genéricos e clique em Incluir. Ao abrir a nova tela, informe o código do programa AU0109 no campo Programa e em Calendário selecione a opção semanal.
![](/download/attachments/737574019/worddav99ac937ccccef74be9c2cb9071a32abe.png?version=1&modificationDate=1675861110330&api=v2) Figura 16 Para programar o horário de execução do agendamento, selecione o programa AU0109 e utilize o botão Programar Horários.
![](/download/attachments/737574019/worddav76a4a6f6446ebbe7756bf45f87d1b40a.png?version=1&modificationDate=1675861109873&api=v2)
Figura 17
Clique no botão Faixa para realizar a distribuição dos horários de forma automática. Na imagem abaixo configuramos para que o AU0109 seja executado a cada 5 minutos de Domingo a Sábado das 00:00 às 23:59. Para manter os dados do TOTVS Apps fiéis ao Datasul, recomendamos a execução do AU0109 entre 1 à 5 minutos. Para mais informações consulte Agenda Automática (CD8600) - Genéricos. ![](/download/attachments/737574019/worddavf64530a26521bcacf7ed2d07741590e2.png?version=1&modificationDate=1675861109997&api=v2)
Figura 18 Para finalizar a configuração da agenda automática basta clicar em OK em todas as telas abertas, ao final deve ser exibida a tela Salvando Grade.
![](/download/attachments/737574019/worddav8088c62da13f9ff7bbe13dbdb6e6d9b4.png?version=1&modificationDate=1675861109747&api=v2) Figura 19 |
Totvs custom tabs box items |
---|
|
9.Sincronização dos dados Datasul x TOTVS Apps Ative o servidor RPW como mostrado anteriormente no passo 5. Abra o programa AU0109 - Sincronização de Dados Datasul x TOTVS Apps (programa do erp, responsável pela sincronização de dados com a Carol), clique em Executar informando o servidor RPW configurado anteriormente e marcando a opção "Utiliza Agenda Automática" (em destaque na Figura 20). A marcação deste parâmetro fará com que o programa CD8600 - Agenda Automática execute automaticamente o programa de sincronização "AU0109" para que os dados modificados nas tabelas sejam enviados para a Carol. IMPORTANTE: Certifique-se que a opção "Utiliza Agenda Automática" esteja marcada. ![](/download/attachments/737574019/image2021-3-12_17-35-5.png?version=1&modificationDate=1675861107840&api=v2)
![](/download/attachments/737574019/worddav8844d219cf70aed41af05c84dddef004.png?version=1&modificationDate=1675861109610&api=v2)
Figura 20 Observe que um pedido foi gerado na tela de Ativação Servidor RPW.
![](/download/attachments/737574019/worddavf500c3a1bc531e0e3f3a7b024b92e4f8.png?version=1&modificationDate=1675861109490&api=v2)
Figura 21
Instalação/Atualização Quando houver atualização do produto Datasul deve-se atentar para as seguintes necessidades: - Executar novamente a tarefa AU0108 - Geração das Triggers;
- Quando houver utilização do Openedge CDC, antes de gerar novas policies, é necessário garantir que os dados estejam integrados executando a tarefa AU0109 - Sincronização de Dados Datasul x TOTVS Apps.
|
|
03. FUNCIONAMENTO DA CARGA DE DADOS
O ERP terá seus dados transmitidos para a nuvem por meio de uma conexão estabelecida pela chamada de um assistente de ativação - TOTVS App -, onde devem ser configurados os campos com as URL's correspondentes, responsáveis por essa conexão e parametrização do endpoint.
...
- Nome da mãe (mesmo que identificação de Mãe Desconhecida)
- Salário > 0
04. PARAMETROS PARA INTEGRAÇÃO
O passo-a-passo para configuração da ativação da integração TOTVS HCM Datasul x Totvs App, pode ser visto a seguir.
...
Totvs custom tabs box |
---|
tabs | FP0530 – Regras de Empréstimo Consignado, FP0530A – Pasta Cadastral, FP0530A – Pasta Margem |
---|
ids | 8,9,10 |
---|
|
Definição das regras de apuração desconto das verbas a serem consideradas após integração do TOTVS Consignado com o erp TOTVS HCM Datasul através da Manutenção Empréstimo Consignado por Funcionário - FP0535. Para isso é importante considerar a configuração de alguns programas necessários como seguem abaixo:
Totvs custom tabs box items |
---|
| FP0530 – Manutenção das Regras de Empréstimo Consignado: Devem ser considerados os dados correspondentes a instituição de crédito em questão, neste processo identificada como “Banco” bem como os demais dados vinculados a esta como agência, sindicato e estabelecimento. ![](/download/attachments/737574019/image2021-3-8_11-23-24.png?version=1&modificationDate=1675861109377&api=v2)
Figura 22 |
Totvs custom tabs box items |
---|
| FP0530A – Regras de Empréstimo Consignado Pasta Cadastral: Através desta janela será feita a parametrização das informações importantes para cadastro das regras de cálculo do processo de Empréstimo Consignado devendo ser ressaltada para a integração entre as aplicações: - Evento Desconto: informe o código do evento que será utilizado para demonstrar o valor do empréstimo consignado que foi descontado do funcionário no momento mensal.
- Considera Margem Mensal: Se marcado este campo o sistema irá identificar após efetuar o cálculo da margem consignável, se o valor obtido permite ou não efetuar o desconto do valor da parcela de empréstimo do funcionário.
Importante: Caso o valor obtido com a margem disponível, seja inferior ao valor a ser descontado, é possível efetuar o desconto proporcional a margem obtida. - Parceiro TOTVS Consignado: identifica que esta regra será utilizada no programa de importação do desconto da(‘s) parcela(‘s) a ser(‘em) integrada(‘s) com o app TOTVS Consignado.
Importante: Obrigatória esta definição para diferenciar um empréstimo organizacional habitual do vinculado a instituição de crédito parceira da empresa via app TOTVS Consignado. ![](/download/attachments/737574019/image2021-3-8_11-26-59.png?version=1&modificationDate=1675861109263&api=v2)
Figura 23 |
Totvs custom tabs box items |
---|
| FP0530A – Regras de Empréstimo Consignado Pasta Margem: Através desta janela será feita a parametrização das informações necessárias para encontrar o valor da Margem Consignável permitida para comprometimento do pagamento do empréstimo em questão. Esta Margem é importante pois a mesma é enviada a título informativo para a Instituição de Crédito Parceira identificar a saúde financeira funcional do colaborador e definir a aprovação ou não da “Solicitação do Empréstimo” enviada via app TOTVS Consignado. ![](/download/attachments/737574019/image2021-3-8_11-28-27.png?version=1&modificationDate=1675861109000&api=v2)
Figura 24 |
|
05. TELA DE IMPORTAÇÃO DO MOVIMENTO INTEGRADO
Para que os dados vindos do parceiro de crédito através do processo de integração do TOTVS Consignado com o ERP sejam carregados no movimento da competência atual para desconto em Folha de Pagamento, é necessário a geração do processo de importação e movimento mensal do funcionário.
...
Totvs custom tabs box |
---|
tabs | Seleção,Parâmetros,Digitação,Impressão |
---|
ids | 11,12,13,14 |
---|
|
FP3035 – Importação TOTVS Consignado: Considera-se neste programa a busca das parcelas enviadas pela instituição de crédito via TOTVS Consignado que deverão ser integradas no TOTVS HCM Datasul. Para isso você deverá fazer a carga das parcelas no erp, utilizando os recursos abaixo: Totvs custom tabs box items |
---|
| Permite filtrar para qual estabelecimento será aplicada a carga. Figura 25
|
Totvs custom tabs box items |
---|
| Informe o mês a ser verificado na integração para ser importada a carga de parcelas no TOTVS HCM Datasul. ![](/download/attachments/737574019/image2021-3-8_11-41-24.png?version=1&modificationDate=1675861108867&api=v2)
Figura 26 |
Totvs custom tabs box items |
---|
| Informe as matrículas desejadas ou deixe em branco para importação de todos os registros encontrados na carga. ![](/download/attachments/737574019/image2021-3-8_11-44-48.png?version=1&modificationDate=1675861108753&api=v2)
Figura 27 |
Totvs custom tabs box items |
---|
| Demonstrativo do Log de Importação da carga integrada do TOTVS Consignado para TOTVS HCM Datasul. ![](/download/attachments/737574019/image2021-3-8_11-45-26.png?version=1&modificationDate=1675861108623&api=v2)
Figura 28 – Dados Fictícios Exemplo 1
![](/download/attachments/737574019/image2021-3-8_11-47-2.png?version=1&modificationDate=1675861108507&api=v2)
Figura 29 – Dados Fictícios Exemplo 2
|
|
06. MANUTENÇÃO POR FUNCIONÁRIO - Empréstimos Consignados
Considera-se neste programa o controle do(‘s) empréstimo(‘s) vinculado(‘s) ao funcionário bem como as parcelas pertinentes ao contrato em questão, para que seja realizado o acompanhamento e controle dos mesmos.
...
Totvs custom tabs box |
---|
tabs | Empréstimos Funcionário, Log Exemplo |
---|
ids | 15,16 |
---|
|
Para que seja possível realizar este cadastro é necessário que tenha sido realizado previamente a definição das Regra de Empréstimo Consignado - FP0530. Após a importação da carga pertinente a competência do movimento desejado será possível visualizar no cadastro de Empréstimos Funcionários os registros de carga integrados. Totvs custom tabs box items |
---|
| Permite visualizar para o funcionário pesquisado as parcelas importadas para o movimento em questão, conforme envio da instituição de crédito. F
Figura 30- Dados Fictícios Exemplo 1 |
Totvs custom tabs box items |
---|
| Log do Demonstrativo de Cálculo do movimento da folha de pagamento erp TOTVS HCM Datasul demonstrando desconto parcial do valor do empréstimo conforme regras pré-estabelecidas cadastradas.
![](/download/attachments/737574019/image2021-3-8_11-57-26.png?version=1&modificationDate=1675861108277&api=v2)
Figura 31 - Dados Fictícios Exemplo 1 |
|
07. CARGA PARA TOTVS CONSIGNADO
Considera-se neste programa o envio das informações operacionalizadas no TOTVS HCM Datasul para serem conciliadas no TOTVS Consignado.
...
Totvs custom tabs box |
---|
tabs | Carga de descontos dos Empréstimos do Movimento |
---|
ids | 17 |
---|
|
Para isso você deverá fazer o envio da carga das parcelas pagas através do erp, utilizando os recursos abaixo: Totvs custom tabs box items |
---|
| Execute a operação para os Estabelecimentos desejados para que seja enviado ao TOTVS Consignado os reais valores de desconto para conciliação automática do Empréstimo Consignado do movimento. Figura 32
|
|
08. TABELAS UTILIZADAS
Os seguintes programas são utilizados nesse projeto:
- FP0530
- FP0530A
- FP3035
- FP0535
- FP3036
- FP0840
09. LINKS ÚTEIS
...