Histórico da Página

CONTEÚDO

01. VISÃO GERAL

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 RM ou Protheus, 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 operadora 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 à operadora 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.

...

O processo de ativação é simples, porem,  deve ser realizado com cautela para garantir a saúde do envio dos dados para nuvem.

Este processo é iniciado após provisionamento dos ambientes do cliente. Após o cliente receber as credenciais de acesso, através de email enviado ao final da preparação do ambiente SaaS, o responsável deverá seguir os passos abaixo para garantir o cumprimento dos requisitos bem como habilitar as credenciais no erp nos passos indicados abaixo.

Normalmente este procedimento é realizado por profissional da área de TI responsável.

02. PRÉ-CONDIÇÕES PARA CONEXÃO

Os seguintes requisitos são necessários para implantação do produto:

• • RM
    • versão
12.1.28 ou superior;
• • • erp
      • Versão contemplada conforme Ciclo de Vida dos produtos TOTVS. 
      •  recomendado: Ultimo patch da versão principal instalado
    • Estar
Está
• • • aderente à portabilidade das versões do RM (verificar item
08
• • • 05. LINKS ÚTEIS,
 desse
• • •  desse documento);
    • Utilizar ambiente 3 camadas;

• Protheus
  • versão 12.1.25 ou superior;
  • DBAccess versão BUILD-20191119 ou superior;
  • APPSERVER_BUILD-17.3.1.18 ou APPSERVER_BUILD-19.3.0.4 ou superior;
  • SMARTCLIENT_BUILD-17.3.0.16 ou SMARTCLIENT_BUILD-19.3.0.5 ou superior;

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

...

...

• • • Caso não tenha acessado o parametrizador dos Serviços Globais após a atualização do ambiente, é necessário executá-lo até o final, ainda que não faça nenhuma alteração. Isso é necessário para criação de parâmetros internos.

• • Totvs App (Ativação):
    • Para banco de dados Oracle a versão do banco tem que ser 12.2C ou superior
    • Para que seja possível utilizar o TOTVS Consignado é importante estar de posse das credenciais enviadas por email pela TOTVS, para integração entre as plataformas. A ativação ocorrerá por:

Ativação por RACID

Parâmetros necessários : clientid e clientsecret (credenciais enviadas por email)

Importante: Leia as seguintes instruções sobre a funcionalidade de subida de dados

• • • Integração TOTVS App: https://tdn.totvs.com/pages/viewpage.action?pageId=561643159
      

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

No parametrizador do TOTVS RM - Folha de Pagamento (Configurações > Parametrizador > Integrações > TOTVS Consignado > Etapa 1/2), deverá ser informado os dados de integração do ERP com o Totvs Consignado, conforme detalhamento dos campos a seguir:

Image Removed

• Configurações de Conexão:  Todos os dados são autoexplicativos e devem ser inseridos pela equipe técnica responsável pela manutenção de acessos na base do ERP evento do tipo "Desconto / Valor" tendo obrigatoriamente o código de cálculo 438 informado.
• Evento de base de cálculo do valor a ser descontado:  evento do tipo "Base de cálculo / Valor" tendo obrigatoriamente o código de cálculo 439 informado.
• Utiliza rateio da Margem Consignável:  Esse parâmetro poderá ser utilizado se existir contrato de parceria de Empréstimo Consignado com mais de uma operadora de crédito, e o usuário desejar ratear a margem consignável entre as operadoras de crédito. Ao marcar este campo será habilitado o campo "Fator de Rateio" que  nesse caso terá seu preenchimento obrigatório. 
  • Fator de rateio:  deverá informar nesse campo o fator de divisão entre as operadoras de crédito.

Exemplo: A empresa possui parceria entre a operadora de crédito A e B. O funcionário possui margem consignável de R$1.000,00. Marcando o parâmetro e informando o fator de rateio igual a 2, será enviado para cada operadora de crédito a margem consignável de R$500,00.

Image Removed
Figura 1 - Exemplo de cadastro de evento com código de cálculo 438.

...

03. FUNCIONAMENTO DO MVP

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 URLs 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 granularização dos mesmos, antes da disponibilização para a operadora 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.

Com a execução desse job, os dados ficam disponíveis para que o parceiro possa acessá-lo por uma API e possa usar esses dados para as ofertas e negociações referentes ao empréstimo consignado.

Assim como o middleware possibilita que esses dados sejam disponibilizados ao parceiro, ele permite que seja feito o caminho reverso e que os dados do parceiro, referentes à contração de empréstimo consignado por funcionários do cliente, sejam disponibilizados na nuvem.

Do mesmo modo que os dados são disponibilizados do ERP para o parceiro, os dados disponibilizados pelo parceiro precisam ser tratados dentro da Carol, para que sejam organizados em um arquivo no formato .txt, para upload dentro do ERP. No caso do RM, no menu Folha Mensal, em Importação > Importação do Movimento.

04. TELA DO WIZARD  DE INTEGRAÇÃO COM TOTVS APP

O passo-a-passo para configuração do assistente de ativação Totvs App, pode ser visto a seguir.

05. TELA PARA DOWNLOAD DO ARQUIVO .TXT

Para realizar o download do arquivo contendo os dados vindos do parceiro de crédito, é preciso acessar uma URL utilizando os respectivos dados de login, selecionar o arquivo que deseja-se baixar e, após a exibição da opção de download, clicar em “Arquivo pronto para download”, para ter o arquivo em formato .txt referente ao período em aberto.

06. TELA DE IMPORTAÇÃO DO MOVIMENTO

Para que os dados vindos do parceiro de crédito sejam utilizados no ERP, é feito o upload do arquivo .txt gerado na Carol e baixado conforme demonstrado no item anterior. Esse upload deve ser feito no menu Folha Mensal > Importação > Importação do Movimento.

Atenção: 

...

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 correspondentes as credenciais, 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 para as regras de consistência dos dados, em especial aqueles que não são padronizados pelo erp, garantindo assim a subida destes dados 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 (caso não exista um email funcional na tela de identificação no cadastro do funcionário. quando realizado o processo de solicitação você poderá informar um email pessoal durante este processo)

- Data de nascimento válida

- Nro de um documento oficial com Orgão emissor e Data de emissão válida (podendo ser RG e/ou CNH)

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

        - Salário > 0 

04. ATIVAÇÃO DE NOVA COLIGADA

O procedimento para habilitar uma nova coligada no erp deve seguir as seguintes ações:

1. 1. Realizar a "Ativação do Convênio" conforme item 02deste documento
   2. Aguardar liberação da solicitação do time Techfin do b2b
   3. Aguardar liberação da solicitação do time Techfin realizada ao parceiro para habilitação dos novos CNPJ's
      

      Atenção: As solicitações de habilitação de novas coligadas, ocorrem através da equipe Techfin que deve ser acionada pelo cliente;

      
      

05. TABELAS UTILIZADAS

As seguintes tabelas do RM são utilizadas nesse projeto:

PPESSOA 
• • GTOTVSAPP
PFUNC 
• • GTOTVSAPPCONCEITO
PFPERFF 
• • GTOTVSAPPCONCEITOHST
• PFFINANC 
• PSECAO 
• PFEMPRT 
• PFHSTAFT
• PPARAM 
• PPARAMADICIONAIS
• PFCONSIGNADODISTMARGEM
• PCONSOPERADORAS

...

• • GPERFIL

06. LINKS ÚTEIS

• Integração TOTVS App
• Documento Portabilidade RM

Código de Cálculo 438

...

• Portal - Empréstimos
• TOTVS Consignado
• 0 - FAQ - Perguntas e Respostas

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...