Histórico da Página
CONTEÚDO
| Índice |
|---|
01. VISÃO GERAL
| Painel | |||||
|---|---|---|---|---|---|
|
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 houve 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:
- RM
- versão erp
- Versão contemplada conforme Ciclo de Vida dos produtos TOTVS.
- recomendado: Ultimo patch da versão principal instalado
- Estar aderente à portabilidade das versões do RM (verificar item 09. LINKS ÚTEIS, desse documento);
- Utilizar ambiente 3 camadas;
- 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.
- versão erp
- 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)
| Informações |
|---|
Os valores usados para o preenchimento dos campos são específicos para cada cliente e serão disponibilizados para que sejam realizadas as validações. Os dados usados na validação dos campos das imagens são apenas exemplos, para demonstração do funcionamento do assistente. |
...
| tabs | Permissão de Acesso, Ativação das Credenciais, Ativação do Convênio, Processo de Desativação da Integração |
|---|---|
| ids | 1,2,3,4 |
...
| default | yes |
|---|---|
| referencia | 1 |
Para acessar o Totvs App, é necessário fornecer permissão para o perfil do usuário. No RM, acesse a opção Serviços Globais > Segurança > Perfis > Sistema: Integração.
Figura 1 - Tela de permissão para acesso ao Totvs App.
...
| default | no |
|---|---|
| referencia | 2 |
Após a permissão fornecida, o acesso ao Totvs App é feito através do sistema Integração > Totvs App > Ativação Totvs App.
O assistente de ativação apresentará telas diferente conforme verão aplicada, onde deve ser informado os dados de conexão conforme necessário, considerando:
12.1.32.XXX
- Marque o checkbox "Consignado", para ativar o processo de integração.
- Conforme a Ativação disponibilizada preencha os campos chave (ou a primeira ativação ou a segunda conforme credenciais recebidas):
- Ativação por RACID ( RAC Client Id e RAC Client Secret (credenciais enviadas por email)
Figura 2 - Tela do Processo de Ativação do Totvs App.
Caso algum dos campos RAC Client Id e RAC Client Secret não sejam preenchidos com as credenciais enviadas no email, ao finalizar a execução o processo finalizará com falha, como mostra o exemplo a seguir:
Figura 3 - Tela com log de erro.
12.1.33.XXX
- Conforme a Ativação disponibilizada preencha os campos chave (ou a primeira ativação ou a segunda conforme credenciais recebidas):
- Ativação por RACID ( RAC Client Id e RAC Client Secret (credenciais enviadas por email)
- Marque o botão "Buscar Apps" . Ao clicar para Buscar Apps, serão retornados somente os Apps disponíveis em cada Client Id e Client Secret.
Ex.: Caso seja informado um Client Id e um Client Secret que possui somente o App "Consignado", só o mesmo será retornado na busca. - Após visualizar a apresentação do App Consignado para ativação, clique em Avançar para concluir o processo de integração.
Figura 4 - Tela com log de erro.
Após a execução do processo de ativação, será criado um job, que executará em background, os conceitos criados enviando os dados para integração com a plataforma Carol.
...
| default | no |
|---|---|
| referencia | 3 |
Para ativação do convênio da empresa erp com a instituição de crédito parceira, deverá ser aplicada a chave de ativação disponibilizada pela Techfin no menu Folha Mensal(opção deve estar liberada na segurança de menus) a seguinte opção:
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. Nesta documentação vamos tratar a Margem Personalizada ou seja o cálculo do valor desejado para esta variável que é de responsabilidade do departamento responsável pela folha de pagamento da empresa, que são definidos seja através da aplicação de regras internas de gestão de pessoas, políticas de departamento pessoal ou mesmo limitações específicas que permeiam as diretrizes da organização.
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.
Em resumo, para que seja possível uma análise mais consistente pela instituição de crédito no que tange delimitar o score de seus clientes, o TOTVS Consignado permite que a empresa detentora do erp, defina o valor de margem consignável a ser considerado para o funcionário. Desta forma, conforme os critérios da empresa aplicados é possível dar clareza do valor de análise da instituição de crédito, devendo a regra da fórmula delimitar o percentual do líquido para contratação de empréstimo ao teto estabelecido pela legislação vigente.
| Informações |
|---|
Os valores usados para o preenchimento dos campos são específicos para cada cliente e serão disponibilizados para que sejam realizadas as validações. Os dados usados na validação dos campos das imagens são apenas exemplos, para demonstração do funcionamento do assistente. |
02. PRÉ-CONDIÇÕES
- Ativação do TOTVS Consignado
- Parametrização do TOTVS Consignado no ERP
- Domínio do recuso de "Fórmula" que será de responsabilidade e autonomia da empresa. Como a mesma é responsável por esta variável, a pessoa que irá criar ou dar manutenção na variável, deverá ter expertise no manuseio da ferramenta e deverá garantir que o teto estabelecido e todas as condições necessárias estarão sendo tratadas na mesma.
03. CONFIGURANDO A MARGEM CUSTOMIZADA
Após atendida os requisitos citados no item 02. Pré-Condições, para personalizar a margem consignável com a regra de cálculo aplicada como política na empresa, siga os passos a seguir:
03.01: Cadastro da Fórmula: No RM Labore (Administração de Pessoal > Fórmulas).
Figura 1 - Menu de acesso cadastro de Fórmulas
Como o cadastro de fórmula é muito flexível, permitirá realizar a configuração conforme sua demanda necessitando apenas de expertise da funcionalidade. Realize o cadastro da fórmula tratando todas as situações específicas e a situação padrão para o resultante, pois, todos os funcionários devem ter pela regra o retorno do valor desejado. Caso não ocorra o tratamento da situação especifica e da padrão o resultado do funcionário deverá ser zero podendo interferir no valor consumido para análise do score. Para facilitar sua compreensão clique aqui para conhecer alguns modelos de fórmula sugeridos.
03.02: Cadastro de Evento: No RM Labore (Administração de Pessoal > Eventos > Eventos), deverá ser cadastrado o evento com os seguinte código de cálculo 444.
Figura 2 - Menu de acesso cadastro de Eventos
Figura 3 - Exemplo de cadastro de evento com código de cálculo 444.
O nome do campo descrição e o código e Nome do campo "Fórmula Valor" são apenas sugestão deste modelo o importante é que exista o código de cálculo vinculado 444, o tipo do evento seja definido como "Base de Cálculo" e a forma de cálculo seja pelo "Valor". Obrigatório o preenchimento da Fórmula de Valor neste evento atendendo a todos os critérios citados no item 02. Pré-Condições.
Atenção: Demais campos do cadastro não citados no exemplo em questão, devem seguir a rotina demandada pelo departamento responsável da folha de pagamento.
04. PARAMETRIZAÇÃO DA MARGEM CUSTOMIZADA
Após atendida os requisitos citados no item 03. Configurando a margem customizada, para que a mesma seja enviada ao TOTVS Consignado a verba deverá estar no movimento mensal, para isto siga os passos a seguir:
04.01: Grupo de Eventos: No RM Labore (Administração de Pessoal > Fórmulas).
Figura 4 - Menu de acesso cadastro de Grupo de Eventos
Para que seja possível análise da margem a partir deste valor pela instituição de crédito, o TOTVS Consignado precisa receber esta informação em nuvem após a virada de competência e para tanto o evento citado precisa estar com valor no movimento atual mensal. Após completar as etapas do Valor e que vinculado a uma Chave desativada, conforme parâmetros. Obrigatório informar este evento na pasta de "Eventos do grupo" no processo de lançamento de Grupos de evento para os movimentos de Folha de Pagamento mensal para que o mesmo seja enviado para a ficha financeira e consequentemente para a Carol.
Figura 7 - Exemplo de cadastro de Eventos do Grupo
Abaixo segue três exemplos como sugestão de cadastro da fórmula:
- Exemplo de fórmula: 30% da folha do funcionário no movimento financeiro do mês anterior.
/*Variável PERIODO deve receber o número do período de Fopagto Mensal*/
SE MES=1
E LIQUIDOFF(ANO-1,12,PERIODO) > 0
ENTAO LIQUIDOFF(ANO-1,12,PERIODO) * 0.3
SENAO
SE MES<>1
E LIQUIDOFF(ANO,MES-1,PERIODO) > 0
ENTAO LIQUIDOFF(ANO,MES-1,PERIODO) * 0.3
SENAO RC * 0.3
FIMSE
FIMSE
FIMSE; - Exemplo de fórmula: 30% da folha do funcionário no movimento financeiro atual.
L * 0.3
- Exemplo de fórmula: 30% do salário nominal.
RC * 0.3
Fórmula Valor - Cálculo do Evento Desconto (c.c: 438)
Para que seja garantida a legalidade do débito limitado a 30% do líquido para desconto do empréstimo, deverá ser criada uma Fórmula de Cálculo para receber a regra de cálculo desejada para apuração do desconto. Abaixo segue um exemplo como sugestão de uso. Lembre-se o evento carregará integralmente o valor da parcela imputada para desconto pelo parceiro de crédito no TOTVS Consignado e este valor conforme contrato poderá ter um numerário acima da Margem Consignável aceita para desconto em folha de pagamento laboral.
Exemplo de fórmula: 30% da folha do funcionário no movimento atual.
/* Onde 'XXXX' deve ser o código do evento de base de cálculo com código de cálculo 439 - BASE DE CÁLCULO EMPRÉSTIMO CONSIGNADO PLATAF.TOTVS */
Se C('XXXX') > 0
entao
Se C('XXXX')>= (L*0.3)
entao L*0.3
Senao C('XXXX')
FimSe;
Figura 8 - Exemplo de cadastro de evento com código de cálculo 439.
Atenção:
Para os eventos com código de cálculo 442 - DESCONTO DE EMPRÉSTIMO CONSIGNADO RESCISÃO, o cálculo também poderá ser customizável por fórmula conforme o entendimento do usuário.
...
| default | no |
|---|---|
| referencia | 4 |
Após ativado, a qualquer momento será possível desativar, conforme imagem a baixo:
Figura 5 - Tela para habilitar Ativação.
Observação:
Uma vez que a processo de desativar seja executado, todos os dados de configuração serão perdidos. Para reativá-lo, será necessário realizar o processo de configuração novamente, conforme mostrado anteriormente.
Atenção:
...
| tabs | Conceitos - Envio da Carga de Dados |
|---|---|
| ids | 5 |
...
| default | yes |
|---|---|
| referencia | 5 |
Para que seja possível utilizar a integração do ERP com o Totvs App é importante ter atenção para a carga dos Conceitos que serão responsáveis pelo envio de dados para Carol e TotvsApps . Esses "Conceitos" serão processados via Jobserver conforme configurado em sua estrutura de criação e serão consumidos seguindo o processo de ativação da integração:
Ativação por RACID
Parâmetros necessários : clientid e clientsecret
Após a leitura das credenciais do RAC será acionado processo de baixar os arquivos atualizados com a versão disponibilizada na nuvem ( "totvsAppConfig","Conceitos"), inserindo a configuração de execução na tabela GTOTVSAPP e na tabela GTOTVSAPPCONCEITO os Conceitos responsáveis pela subida de dados para a Carol, podendo este processamento ser acompanhado através do recurso para Gerenciamento de Job (GTOTVSAPPCONCEITOHST) .
Para maiores informações clique aqui!
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 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
04. CONFIGURAÇÕES PARA INTEGRAÇÃO ERP X TOTVS APP
...
| Totvs custom tabs box | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||
|
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas