Histórico da Página

...

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. 

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ódulo 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 dos ERPs sejam extraídos, compartilhados e enviados do ERP à plataforma. Já na nuvem, eles serão filtrados e tratados. 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 houve geração de folha de pagamento para o funcionário naquele 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 a 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.

Os clientes que utilizam o TOTVS Consignado também têm a opção de usarem uma margem consignável personalizada, informando quais as verbas de provento e desconto que devem ser consideradas nessa personalização. Caso o cliente opte por não personalizar a margem, a mesma será calculada com base no líquido do funcionário.

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

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

• Protheus versão contemplada conforme Ciclo de Vida dos produtos TOTVS. 
• DBAccess versão TOTVS DBACCESS - BUILD 20.1.1.2 (20200606) ou superior;
• APPSERVER_BUILD-19.3.1.7 ou superior;
• SMARTCLIENT_BUILD-19.3.1.4 ou superior;
• Pacote de atualização da LIB >= TECHFIN-2.0.0;
• Ativação da chave do TOTVS Consignado, através da configuração do Parâmetro no configurador (SIGACFG > Ambiente > Cadastros > Parâmetros): 
  • MV_CONSIG - Chave do TOTVS Consignado, deve ser criado manualmente  (preenchido com o valor .T.);
  • Caso o dicionário de dados seja no banco, o parâmetro será criado automaticamente durante a execução do Wizard de Configuração do Conector entre Protheus/Carol.

• Configuração da tabela S137, na rotina de Manutenção de Tabelas;
• Atualização do menu do SIGAGPE, para disponibilização do menu de Importação de Parcelas (solicitar o arquivo ao time de suporte).

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

...

...

É necessário realizar a configuração do Wizard para conexão e exportação dos dados do ERP para a nuvem.

Importante: 

• O wizard deve ser aberto de forma exclusiva, sem que nenhuma outra instância do SmartClient esteja aberta e sem que outros jobs estejam rodando.
• MV_URLRAC e MV_URLPLAT - Com a configuração do wizard, explicada abaixo, estes parâmetros são automaticamente preenchidos com as URLs de produção. Caso o ambiente utilizado seja algum outro, como o de homologação (staging), os conteúdos destes parâmetros devem ser alterados, via configurador, informando o que for recebido no e-mail de provisionamento, contendo as informações para conexão.
• Caso o cliente deseje fazer essa alteração de ambiente de produção para homologação, por exemplo, devem ser incluídos um parâmetro e uma URL na seção referente ao ambiente, no appserver.ini. O parâmetro e a URL em questão são:

fw-tf-registry-endpoint=https://endpoint-registry.ambiente.totvs.app/api/v1/services

Onde ambiente deve ser substituído por staging ou dev, conforme necessidade do cliente. Para ambiente de produção, não há a necessidade dessa URL e nada precisa ser feito.

• Com a atual configuração do Wizard, os dados de conexão do RAC - Client Id e Client Secret, não são mais gravados nos parâmetros MV_CSAUTID e MV_CSAUTSE, respectivamente.

O passo a passo para configuração do Wizard, que pode ter seu processo cancelado em qualquer etapa da execução, pode ser visto a seguir, assim como alguns exemplos de preenchimento incorreto.

O acesso ao Wizard é feito pelo SmartClient, chamando o programa CONFIGCONSIGNADO, pelo campo de “Programa inicial”.

Image RemovedChamada do Wizard, no SmartClient

...

...

Com o Wizard aberto, a tela de boas vindas é exibida. Neste ponto, o usuário pode ou cancelar a ação ou avançar para a tela de autenticação. 

Image Removed

Tela de “Boas vindas” do Wizard

Também é nessa tela que ocorrem as validações da versão da Techfin e dos artefatos. Como exemplo, é possível ver na figura abaixo que o DBAccess utilizado não estava compatível:

Image RemovedTela de “Boas vindas” do Wizard, com DBAccess incompatível

...

A tela para preenchimento com os dados de integração contém dois campos, onde devem ser informados os dados da plataforma, que são: Client ID e Client Secret.

Image Removed

Tela com os campos para inserção dos dados que possibilitam o acesso à plataforma

Nesse ponto, ocorrem algumas validações, por exemplo, se algum dos campos não tiver sido preenchido ou se o campo teve o seu preenchimento feito com dados incorretos.

Image Removed

Validação de campos vazios

Image Removed

Campos preenchidos com informações inválidas

A margem consignável é o valor máximo da renda mensal do colaborador que pode ser comprometida em um empréstimo consignado.

Somente funcionários CLT tem acesso a essa modalidade de empréstimo, que terão as parcelas descontadas direto na folha de pagamento do salário, todo mês, limitado a esse teto – a chamada margem consignável.

A instituição de crédito terá à sua disposição dados do colaborador necessários para análise de aprovação de empréstimo consignado, como por exemplo nome, data de admissão, salário, matrícula, margem consignável, dentre outros.

Por padrão, a margem é sempre calculada sobre o valor da renda mensal líquida, ou seja, excluindo-se todos os descontos já existentes.

De forma resumida, então, a margem consignável representa o limite que pode ser descontado do salário para quitação dos produtos bancários contratados com a instituição de crédito parceira.

Esse teto foi definido nas leis de consolidação de trabalho como forma de evitar o super endividamento dos consumidores. Assim, é possível garantir que mesmo contraindo um empréstimo, o funcionário ainda terá recursos necessários para suas necessidade, e não comprometendo toda a sua remuneração com o pagamento da dívida.

02. PRÉ-CONDIÇÕES 

Ativação do TOTVS Consignado

Parametrização do TOTVS Consignado no ERP

03. FUNCIONAMENTO DA CARGA DE DADOS

Após a configuração citada no item 02. Pré-Condições,  margem consignável toda vez que é movimentada uma folha de pagamento e sua competência é liberada, o ambiente em nuvem é atualizado com estes dados, realizando como cálculo, o percentual padrão de 30% do valor líquido da Folha fechada e enviado como valor da margem consignável.

A margem consignável é o valor máximo da renda mensal do colaborador que pode ser comprometida em um empréstimo consignado informada para a instituição de crédito parceira para analisar o score financeiro do funcionário visando aprovar ou não a solicitação realizada pelo mesmo através dos possíveis canais de solicitação de crédito.

Importante: A margem é atualizada mensalmente após o processo de fechamento da competência e somente para funcionários com líquido no movimento fechado.

Atenção: Não existe nenhuma ação sobre este valor realizada pelo usuário, caso seja necessário realizar o envio de um valor diferente do padrão realizado, você deverá realizar o processo de configuração da Margem Consignável Customizada para personalizar a regra de cálculo aplicada como política na empresa.

04. TABELAS UTILIZADAS

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

• • SRA
  • SRD
  • SRV

05. LINKS ÚTEIS

• Margem Consignável Customizada - RM
• Portal - Empréstimos
• TOTVS Consignado
• 0 - FAQ - Perguntas e Respostas

...

Com os dados preenchidos corretamente, é possível avançar e verificar o status da ativação da integração, na última tela do Wizard.

Image Removed Image Removed

Telas com o status da ativação da integração do ERP com a plataforma

Após a ativação da integração do ERP com a plataforma, ative o job FWTECHFINJOB para que os dados sejam enviados para a Carol.

Obs. 1: Para mais informações de como configurar o schedule, verificar item 09. LINKS ÚTEIS, desse documento;

Obs. 2: O schedule deve ser configurado após a configuração do Wizard.

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 (wizard) - 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 vinculo 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) 

...

04. TABELA S137 - VERBAS - EMPRÉSTIMO CONSIGNADO

...