Histórico da Página

...

01. VISÃO GERAL

Âncora
_heading h.gjdgxs

Para amadurecer o produto, antes de colocá-lo em grande escala é muito comum, no segmento de tecnologia da informação, as empresas realizarem testes pilotos prévios, de modo a garantir a adequação e robustez da solução. A fim de endereçar isso, são liberadas versões intermediárias do produto para testes em campo. A versão do produto tratada aqui, se enquadra nesse contexto e contamos com a sua empresa para nos ajudar nessa jornada.

A plataforma TOTVS Consignado tem como objetivo facilitar e automatizar os processos de contratação e cobrança de empréstimo consignado para empresas que tenham sua folha de pagamento controlada, via Datasul, Protheus ou RM  módulos RH, criando uma nova experiência na contratação do crédito.

Com a plataforma, é possível tornar mais rápido esse contato da instituição de crédito com o colaborador, já que a mesma terá algumas informações à sua disposição.

Por ser uma plataforma na nuvem, o TOTVS Consignado precisa que os dados sejam extraídos dos ERP's, compartilhados e enviados para a plataforma. Já na nuvem, eles serão filtrados e tratados – sendo que esse tratamento pode ser feito de forma manual ou agendada – e, assim, serão disponibilizados para acesso e repasse à instituição de crédito, quando necessário. Para isso, é utilizada uma integração do ERP, que será o responsável por fazer o sincronismo de base de dados.

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:

• Datasul

  • versão 12.1.22.05 ou superior;

  • Progress Openedge na versão 11.7.5 ou superior no produto Datasul e RPW;

  • Disponibilizar as seguintes bibliotecas do Progress Openedge 11.7.5 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

  • Dados de acesso e certificados dos serviços:

    • Totvs RAC

    • Totvs Apps

    • Totvs Carol

  • Servidor RPW configurado e ativo

  • Módulo Audit Trail instalado e ativo e configurado conforme esta documentação (disponíveis nas abas listadas abaixo)

  • Geração das triggers (AU0108)

  • Configuração agenda automática (CD8600)

  • Sincronização dos dados Datasul x Totvs Apps (AU0109)

ATENÇÃO: Caso não exista o('s) programa('s) descrito('s) neste documento ou os menu('s) relacionados a este('s),  solicite a atualização dos pacotes através do Console Datasul.

Importante: Leia as seguintes instruções

• Assistente de configuração para integração com Totvs Apps (ConfigAppsWizard)
• Matriz de Compatibilidade - Ciclo Vida Datasul e Tecnologias Associadas

• Também são necessárias algumas configurações prévias:

...

...

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 Image Removed .

• 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;

...

Nesta página será apresentado em detalhes demonstrando sempre que possível exemplos (fictícios) de como realizar a configuração deste erp para pleno funcionamento da plataforma TOTVS Consignado.

02

Figura 2

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

Figura 3

...

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.

Image Removed Figura 8

Image Removed

Figura 9

Image Removed

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.

...

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

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

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

Image Removed

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.

...

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.
Image Removed

Figura 16

...

Image Removed

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.

Image Removed

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.
Image Removed

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.

Image Removed

...

Figura 20

...

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.

Os dados brutos são armazenados na nuvem, em tabelas mapeadas. Entretanto, é necessário que seja feito um tratamento e uma normalização dos mesmos, antes da disponibilização para a instituição de crédito parceira. O tratamento é feito por meio da execução de um job, dentro da Carol - plataforma de dados e inteligência artificial da TOTVS -, por uma execução agendada, mas que também pode ser feita de forma manual, conforme necessidade.

O TOTVS Consignado consome os dados, disponibilizados pela Carol, trata e os envia para os parceiros, realizando a conciliação das parcelas que foram enviada para o ERP.

Atenção: 

Existem dados do funcionário que são exigidos para consumo da instituição de crédito (necessários para análises de crédito e geração de objeto contratual) e devem estar na base de dados do ERP de forma integra para que sejam validados e não interfiram na consistência do processo de solicitação do empréstimo consignado. 

Para tanto faz-se necessária a realização de consistência destes dados onde é apresentada mensagem de validação no processo de simulação/solicitação; deve-se ter atenção especial para as regras de consistência dos dados em especial os que não são padronizados pelo erp para que os mesmos sejam carregados para a base de dados do Consignado de forma integra no consumo das instituições parceiras.

Regras (campos obrigatórios informados no vínculo funcional do erp) :

- DDD e Telefone - pelo menos um telefone com DDD válido (numérico de 10 a 99)  

- email funcional

- Data de nascimento

- Nro RG, Orgão emissor e Data de emissão

- Nome da mãe  (mesmo que identificação de Mãe Desconhecida) 

        - Salário > 0 

...

. 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.

...