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 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 pelos ERP'S TOTVS nos módulos RH, bem como proporcionar a melhor experiência no acompanhamento e controle dos mesmos na rotina do RH. 

Com a plataforma, é possível tornar mais rápido a integração da instituição de crédito com o RH, no momento de encerramento do contrato de trabalho do colaborador com a empresa, permitindo o  resgate de forma sincronizada, dos valores pertinentes a quitação do saldo devedor do empréstimo consignado para desconto na rescisão. 

O RH não precisará realizar consulta dos valores de quitação no site da operadora de crédito, pois, a rotina nativa do ERP através da integração do saldo de quitação na rescisão irá realizar a consulta dos valores pendentes no contrato e aplicar o desconto permitido por lei no movimento rescisório di funcionário de forma automática e ágil, sem que precise ser feita qualquer outra ação. Desta forma proporcionamos a melhor experiência ao usuário de forma direta no processo rotineiro de rescisão contratual nativo do ERP.

02. PRÉ-CONDIÇÕES

Ativação do TOTVS Consignado

Parametrização do TOTVS Consignado no ERP

Movimento financeiro fechado no mês anterior ao cálculo da rotina, com a verba parametrizada de Desconto Mensal de empréstimo Consignado. (Desconto Mensal anterior identifica existência de Consignado na integração)

...

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;

...

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. 

Após a configuração citada no item 02. Pré-Condições, toda vez que é movimentado um desligamento no ERP TOTVS do módulo de folha de pagamento, o ambiente em nuvem é atualizado com estes dados, realizando atualização em nossa plataforma da nova situação funcional.

O processo rescisório poderá ocorrer de forma coletiva ou individual conforme demandado pelo usuário do RH no processo nativo do ERP. As informações ficam disponíveis para consumo da instituição de crédito parceira analisar e retornar via endpoints os devidos saldos para quitação de contrato consignado com o funcionário pesquisado. A partir deste momento o registro funcional pesquisado, ficará indisponível para novas simulações.

A integração somente reconhece movimento de folha fechada para baixar o saldo de quitação. Desta forma, a parcela referente ao desconto mensal do mês relacionado a rescisão, estará compondo o saldo de quitação, ou seja, caso já tenha sido realizado a importação dos descontos no movimento mensal, a verba referente a este desconto, deverá ser removida para que não seja duplicado o valor na quitação após consulta durante o cálculo da rescisão.

Importante: No processo de buscar o saldo de quitação diretamente no cadastro/cálculo da rescisão, caso exista quaisquer instabilidades de comunicação na consulta do saldo de quitação junto a instituição de crédito parceira, não ocorrerá instabilidade do cálculo nativo, permitindo assim o cálculo da rescisão sem os valores de quitação que poderão ser consultados em posterior momento oportuno.

Atenção: 

Existem dados do funcionário que são exigidos e validados para consumo da instituição de crédito (necessários para análises de crédito e geração de objeto contratual)  retornar o saldo de quitação e devem estar na base de dados do ERP de forma integra, bem como nos canais da operadora para que sejam validados e não interfiram na consistência do processo de solicitação do saldo de quitaçã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) 

        - Salário > 0 

...

CPF do registro funcional

- CNPJ vinculado

04. INTEGRAÇÃO DE MOVIMENTO 

O RH irá utilizar a busca do saldo de quitação na rescisão, através de consulta realizada pela integração com a instituição financeira, pelo processo de rescisão contratual nativo do ERP, proporcionando a melhor experiência ao usuário de forma direta e ágil pela rotina nativa.

Para que os dados consultados no parceiro de crédito, através do processo de integração do TOTVS Consignado com o ERP, sejam carregados para desconto no movimento da competência atual das rescisões desejadas, deve-se ter atenção a parametrização prévia indicada no item 02. PRÉ-REQUISITOS deste documento . 

A consulta do saldo de quitação, ocorre nas duas formas de calcular a rescisão, sendo: 

A tabela é acessada pelo menu de Manutenção de Tabelas (SIGAGPE > Atualizações > Definições Cálculos > Manutenção tabelas) e é para uso dos clientes do TOTVS Consignado.

...

Para que seja garantida a legalidade do débito limitado a 30% do ao  % limite definido pela legislação do líquido para desconto do  saldo devedor para quitação do empréstimo,  o cadastro da verba de desconto de empréstimo consignado rescisão na rotina de Verbas pelo caminho  >Atualizações >Definições de cálculos >Verbas, ela deve estar com o campo Emp. Cons. com SIM:

...