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.

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

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

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

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

• 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;
• Configuração dos Parâmetros (SIGACFG > Ambiente > Cadastros > Parâmetros): 
  • MV_CONSIG - Preencher com .T. para a ativação da importação de parcelas do TOTVS Consignado, em sua base;
  • MV_CSAUTID e MV_CSAUTSE - Preencher com os dados de autenticação de cada cliente, para integração da base do Protheus à plataforma do TOTVS Consignado.

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

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

O ERP terá seus dados transmitidos para a nuvem por meio de uma conexão estabelecida pela chamada de um wizard, 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, o TOTVS Consignado consome os dados tratados na Carol e os disponibiliza para as operadoras de crédito.

Em relação às parcelas, estas são enviadas pelas parceiras de crédito, via API, para o TOTVS Consignado que as disponibiliza, também via API para importação dentro do Protheus, por meio da rotina Import. Parcelas. Para fazer essa importação, o analista deve acessar a rotina na filial onde se deseja realizar a importação e informar o período de consulta. A API retornará as parcelas abertas disponíveis para importação no período em questão. As parcelas selecionadas e importadas ficam gravadas na rotina Lançamentos por funcionário ((SIGAGPE > Atualizações > Lançamentos > Por Funcionário) - RGB, com o código da verba configurada na tabela S137 - Verbas - Empréstimo Consignado (Manutenção de Tabelas (SIGAGPE > Atualizações > Definições Cálculos > Manutenção tabelas)).

Essa parcela importada precisa ser retornada ao parceiro de crédito, para que o mesmo saiba o valor que foi ou não averbado na folha do funcionário. Para isso, com a(s) parcela(s) importada(s) na RGB, basta que o analista siga com o fluxo já conhecido de integração, cálculo e fechamento da folha. Com o Job FWTECHFINJOB e o wizard configurados corretamente, o valor averbado será enviado para a Carol, na tabela SRD, permitindo que o mesmo seja consumido e tratado no TOTVS Consignado, para realização da conciliação do empréstimo e disponibilização de dados atualizados da parcela à operadora de crédito.

04. TABELA S137 - VERBAS - EMPRÉSTIMO CONSIGNADO

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.

Nesta tabela, devem conter qual a operadora de crédito que está relacionada com cada filial (via consulta específica), verba para desconto na folha e verba para desconto no rescisão (via consulta padrão da tabela SRV).

A consulta específica ocorre via API, que lista quais são as opções de operadoras de crédito disponíveis para o relacionamento no cadastro.

05. IMPORTAÇÃO DE PARCELAS

Para que os dados vindos do parceiro de crédito sejam utilizados no ERP, é necessário realizar a importação das parcelas. Como explicado anteriormente, neste documento (02. PRÉ-CONDIÇÕES PARA CONEXÃO), é preciso estar com os parâmetros e a S137 configurados. Segue abaixo exemplo de preenchimento da S137, utilizada para realização da importação.

Figura 17 - Tabela S137, configurada para a D MG 01.

Ao acessar a rotina pelo menu de Import. Parcelas (SIGAGPE > Miscelanea > Consignação > Import. Parcelas), o sistema exibirá ao usuário a tela com a parametrização para consulta à API. Será necessário informar o período (no formato AAAAMM) e quais as situações do funcionário (RA_SITFOLH) no qual se deseja realizar a importação. O CNPJ será considerado conforme a filial que o usuário está logado para disponibilização das parcelas, com status "Aberta", que serão importadas.

Para exemplificar o uso da rotina de Import. Parcelas, será usada a filial D MG 01, o período para importação de 202008 e todas as situações da folha selecionadas, que são os parâmetros para consulta das parcelas em aberto disponíveis na API, aptas para importação na RGB (Lançamentos por funcionário ((SIGAGPE > Atualizações > Lançamentos > Por Funcionário). Com esses dados e com os parâmetros configurados, o usuário pode clicar no Ok e verificar a disponibilidade de parcelas para importação e posterior desconto na folha do funcionário.

Figura 18 - Rotina de Import. Parcelas com o período 202008 parametrizado.

No caso deste exemplo, são retornadas 5 parcelas disponíveis para importação no período de 20208:

Figura 19 - Rotina de Import. Parcelas com as parcelas disponíveis para 202008.

É possível selecionar todas as parcelas ou apenas uma ou mais, conforme necessidade do analista. Existem diferentes tratamentos para diferentes situações que podem ocorrer durante a utilização dessa rotina:

Após o processo de importação da parcela, cálculo e fechamento da folha, os dados referentes ao pagamento da parcela são enviados à Carol, na tabela SRD, para consumo e tratamento no TOTVS Consignado, para disponibilização de dados atualizados da parcela conciliada à operadora de crédito.

06. MARGEM CONSIGNÁVEL PERSONALIZADA - ROTEIRO FOL

Os clientes do TOTVS Consignado terão a possibilidade de personalizar o cálculo da margem consignável no roteiro de cálculo da folha (FOL) e, com isso, disponibilizar ao parceiro de crédito o valor da margem consignável dos funcionários que atenda às particularidades de cada cliente.

Para usar tal funcionalidade, é necessário:

• Habilitar o parâmetro MV_CONSIG (MV_CONSIG = .T.);
• Configurar o mnemônico P_CSMARG, deixando-o com o conteúdo igual à .T.;
• Ter uma verba do tipo Base (Provento), para a margem consignável configurada (identificador de cálculo com código 1857);
• Definir o percentual da verba de margem consignável (CODFOL = 1857), limitado em 30%, seguindo a legislação;
• Ter o campo Marg. Cons. (RV_TCMARG) criado (via atualização de dicionário de dados) na aba Outros da tabela SRV;
• Configurar cada uma das verbas que deseje que sejam consideradas no cálculo da margem consignável e mudar o valor desse campo para 1-Sim. Serão consideradas apenas verbas dos tipos Provento e Desconto.

Novo identificador de cálculo - código 1857

Campo Marg. Cons. (RV_TCMARG), na aba Outros da SRV

Após o cliente ter indicado quais verbas serão consideradas no cálculo da margem consignável, o cálculo da folha de pagamento poderá ser realizado como de costume. 

O valor da nova verba de margem consignável será lançado na folha do funcionário, podendo ser consultado via tela, pela rotina: Consulta de Cálculo por Funcionário (módulo 07 do SIGAGPE, no menu: Consultas > Cálculos > Por Funcionário), ou pela consulta à tabela SRC.

Abaixo, estão alguns exemplos de utilização:

Totvs custom tabs box
tabs Campo RV_TCMARG = 1-Sim - Verba de base,Margem calculada com verbas de provento,Margem calculada com verbas de provento e desconto ids 19,20,21
Totvs custom tabs box items default yes referencia 19 A personalização da margem consignável será feita considerando apenas as verbas que sejam do tipo Provento e Desconto. Caso o cliente tente configurar uma verba do tipo Base, seja base de provento ou base de desconto, o sistema exibirá uma mensagem alertando-o sobre o assunto e impedindo a gravação da verba com essa configuração, como pode ser visto nas imagens abaixo: Verba do tipo Base com campo Marg. Cons. = 1-Sim Totvs custom tabs box items default no referencia 20 Margem consignável calculada na folha do funcionário, considerando apenas as verbas de provento. As verbas de provento utilizadas neste exemplo serão a de Salário Mensalista e Periculosidade, configuradas com o campo Marg. Cons. = 1-Sim, conforme imagens abaixo: Exemplo de verbas de provento configuradas com o campo Marg. Cons. = 1-Sim: Verba de Salário Mensalista configurada com o campo Marg. Cons. = 1-Sim. Verba de Periculosidade configurada com o campo Marg. Cons. = 1-Sim. Após a realização do cálculo do roteiro FOL, a verba de margem consignável pode ser consultada na Consulta de Cálculo por Funcionário: Consulta de Cálculo por Funcionário com verba de Margem Consignável personalizada A margem consignável foi calculada considerando 30%, conforme configuração da verba (identificador de cálculo = 1857) , da soma de verbas de proventos configurados com Marg. Cons. = 1-Sim. Validação do Cálculo: Salário Mensalista + Periculosidade 5000 + 1500 = 6500 6500 * 0,30 = 1950 A29 - Margem consignável = R$1950,00 Obs.: Apenas duas verbas foram configuradas para que fossem consideradas na margem consignável. O cliente pode configurar as verbas que forem pertinentes a ele e que componham o cálculo do roteiro FOL. Totvs custom tabs box items default no referencia 21 Margem consignável calculada na folha do funcionário, considerando as verbas de provento e as verbas de desconto. A verba de provento utilizada neste exemplo será a de Salário Mensalista e a verba de desconto será a de Almoço, configuradas com o campo Marg. Cons. = 1-Sim, conforme imagens abaixo: Exemplo de verbas de provento e de desconto configuradas com o campo Marg. Cons. = 1-Sim. Verba de Salário Mensalista configurada com o campo Marg. Cons. = 1-Sim. Verba de Almoço configurada com o campo Marg. Cons. = 1-Sim. Após a realização do cálculo do roteiro FOL, a verba de margem consignável pode ser consultada na Consulta de Cálculo por Funcionário: Consulta de Cálculo por Funcionário com verba de Margem Consignável personalizada A margem consignável foi calculada considerando 30%, conforme configuração da verba (identificador de cálculo = 1857) , da soma de verbas de proventos e descontos configurados com Marg. Cons. = 1-Sim. Validação do Cálculo: Salário Mensalista - Almoço 5000 + 200 = 4800 4800 * 0,30 = 1440 A29 - Margem consignável = R$1440,00 Obs.: Apenas duas verbas foram configuradas para que fossem consideradas na margem consignável. O cliente pode configurar as verbas que forem pertinentes a ele e que componham o cálculo do roteiro FOL.

Caso deseje saber mais detalhes sobre a margem personalizada, acesse o documento disponibilizado no item 09. ASSUNTOS RELACIONADOS.

07. TABELAS UTILIZADAS

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

• RCB - Configuração de Parâmetros
• RCC - Parâmetros 
• RGB - Incidências
• SX6 - Parâmetros do Sistema
• SR8 - Controle de Ausências
• SRA - Funcionários
• SRD - Históricos de Movimentos
• SRG - Rescisões
• SRK - Movimento de Valores futuros
• SRR - Itens de Férias e Rescisões
• SRV - Verbas

08. LINKS ÚTEIS

• Schedule - Como agendar a execução de rotinas

09. ASSUNTOS RELACIONADOS

• TOTVS Consignado - Manutenção de tabelas - Verbas do Consignado
• TOTVS Consignado - Importação de Parcelas
• TOTVS Consignado - Parâmetros MV_CSAUTID e MV_CSAUTSE
• TOTVS Consignado - Parâmetro MV_CONSIG

• TOTVS Consignado - Margem consignável personalizada no roteiro FOL

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