Histórico da Página

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.

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

• Estas 4 bibliotecas devem ser inseridas no início do propath do AppServer e do RPW.

<%DLC%>\gui\OpenEdge.BusinessLogic.pl

<%DLC%>\gui\OpenEdge.Core.pl

<%DLC%>\gui\OpenEdge.ServerAdmin.pl

<%DLC%>\gui\netlib\OpenEdge.Net.pl

• Os propaths podem ser alterados nos arquivos .ini do diretório *<diretório-instalação>\ERP\scripts-8X80*

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.

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:

• No Jboss:
  • Acesse os Parâmetros gerais do modulo básico (btb946aa), selecione a aba Integrações e informe os dados conforme orientação do manual.
  • Deverá ser configurada a jornalização, ainda nos Parâmetros gerais do modulo básico (btb946aa), acesse a aba Jornalização e informe os dados conforme orientação do manual.

• No Tomcat (DTS4THF):
  • Nas propriedades do sistema, localize as Propriedades de integrações TOTVS e informe os dados conforme orientação do manual.
  • Nas propriedades do sistema, localize as Propriedades de Jornalização e informe os dados conforme orientação do manual

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:

1. Acessar em um navegador a URL sugerida para o serviço Carol;
2. Selecionar o ícone de cadeado;
3. 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;

Figura 2

5. Acessar a aba de Detalhes (Details) e selecionar o botão Copiar para arquivo (Copy to File) conforme Figura 3;

Figura 3

6. Será exibida tela inicial do Assistente para Exportação de Certificados, selecionar o botão Avançar duas vezes.

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.

Figura 5

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.

Figura 6

• No programa Servidor de Execução (bas_ped_exec) inclua um novo servidor de execução:

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

Figura 9

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

6.Configuração do Módulo Audit Trail

No programa AU0009 - Parametrização do Audit Trail informe o servidor RPW configurado no passo anterior.

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.

Figura 13

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.

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.

Confira no diretório configurado no AU0001 se as triggers foram geradas.

Figura 15

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.

Figura 16

Para programar o horário de execução do agendamento, selecione o programa AU0109 e utilize o botão Programar Horários.

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.

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.

Figura 19

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.

Figura 20

Observe que um pedido foi gerado na tela de Ativação Servidor RPW.

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.

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.

Figura 22

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.

Figura 23

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.

Figura 24

Permite filtrar para qual estabelecimento será aplicada a carga.

Figura 25

Figura 26

Informe as matrículas desejadas ou deixe em branco para importação de todos os registros encontrados na carga.

Figura 27

Demonstrativo do Log de Importação da carga integrada do TOTVS Consignado para TOTVS HCM Datasul.

Figura 28 – Dados Fictícios Exemplo 1

Figura 29 – Dados Fictícios Exemplo 2

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

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.

Figura 31 - Dados Fictícios Exemplo 1

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