2.2.1.0 Importação de Movimento do TOTVS Consignado

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

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) 

        - Salário > 0 

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 instituição 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). Sobre o cadastro das verbas utilizadas, é importante considerar:

• Que a verba cadastrada na S137 esteja cadastrada na filial onde se realizará a importação das parcelas;
• Que a verba cadastrada na S137 esteja com o campo Qtde.Lancto (RV_QTDLANC) com o preenchimento respeitando a quantidade de lançamentos que serão feitos por funcionário. Recomenda-se que o campo Qtde.Lancto (RV_QTDLANC) esteja com o preenchimento igual à nove (RV_QTDLANC=9);
• Que a verba cadastrada na S137 esteja com o campo Lcto Diario (RV_LCTODIA) esteja com o preenchimento igual à "N - Nao".

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

Para que seja possível efetuar o desconto do empréstimo consignado proporcional nas férias, caso o empréstimo tenha sido gerado pelo Totvs Consignado será necessário preencher os campos específicos para esta finalidade na tabela S137:

• No campo "Verba Férias Mês" deve ser preenchido a verba correspondente ao desconto do empréstimo consignado nas férias para os dias que caem no mês.
• No campo "Verba Férias Mês Seg" deve ser preenchido a verba correspondente ao desconto do empréstimo consignado nas férias para os dias que caem no mês seguinte.
• No campo "Verba Corr Fol Mês" deve ser preenchido a verba correspondente ao provento do empréstimo consignado para os dias que caem no mês.
• No campo "Verba Corr Fol Mês Seg" deve ser preenchido a verba correspondente ao provento do empréstimo consignado para os dias que caem no mês seguinte.

 Para mais informações deste processo click aqui!

Para que seja possível efetuar o desconto do saldo devedor do empréstimo consignado na rescisão será necessário preencher os campos específicos para esta finalidade na tabela S137:

• No campo "Cod.da Verba na Rescisão" deve ser preenchido a verba correspondente ao desconto do empréstimo consignado na rescisão. 

Para que seja garantida a legalidade do débito limitado a 30% 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:

O mnemônico P_PERCONS deve estar preenchido com o percentual a ser descontado na rescisão, para isso, valide na rotina Mnemônicos pelo caminho >Atualização >Definição de cálculos >Mnemônicos:

05. IMPORTAÇÃO DE PARCELAS

As parcelas 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 instituição 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 à instituição de crédito.

Para que os dados vindos do instituição de crédito sejam utilizados no ERP, é necessário realizar a importação das parcelas. Como explicado anteriormente. Também é necessário que se observe os seguintes itens:

• Que a instituição de crédito parceira tenha enviado as parcelas para a plataforma do TOTVS Consignado, para que elas possam ser disponibilizadas ao cliente, via API;
• Que o período de cálculo selecionado para importação esteja aberto e ativo;
• Que a configuração da tabela S137, na Manutenção de Tabelas, esteja correta. Ou seja, é necessário que haja a configuração das verbas e da instituição de crédito, que deve ser a mesma do contrato da parcela. Para maiores informações, consultar o documento TOTVS Consignado - Manutenção de tabelas - Verbas do Consignado;
• Que a verba cadastrada na S137 esteja cadastrada na filial onde se realizará a importação das parcelas;
• Que a verba cadastrada na S137 esteja com o campo Qtde.Lancto (RV_QTDLANC) com o preenchimento respeitando a quantidade de lançamentos que serão feitos por funcionário. Recomenda-se que o campo Qtde.Lancto (RV_QTDLANC) esteja com o preenchimento igual ao valor máximo permitido pelo sistema (9);
• Que a verba cadastrada na S137 esteja com o campo Lcto Diario (RV_LCTODIA) esteja com o preenchimento igual à "N - Nao".

Segue exemplo de preenchimento da S137, utilizada para realização da importação.

Tabela S137, configurada para a D MG 01.

Ao acessar a rotina pelo menu de Import. Parcelas (SIGAGPE > Miscelânea > 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 PR 01, o período para importação de 202201 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.

Foi criado um parâmetro (MV_IMPMFIL) que se habilitado (possuir valor igual a .T.), possibilita a ativação da rotina de Importação para Múltiplas filiais, uma vez que o parâmetro é ativado, será possível escolher as Filiais que deseja buscar as parcelas e realizar a importação. Importante ressaltar que por padrão o parâmetro estará desabilitado. Dessa forma a importação atual seguirá apenas para os funcionários da filial logada.

No caso abaixo o valor da MV_IMPMFIL está setado como .F.

Parâmetros:

Rotina de Import. Parcelas com o período 202201 parametrizado.

No caso deste exemplo, são retornadas as parcelas disponíveis (ordenados por contrato) para importação no período de 202201:

Rotina de Import. Parcelas com as parcelas disponíveis para 202201.

Para o caso do parâmetro MV_IMPMFIL setado como .T. irá aparecer a tela de seleção de Filial antes da tela de seleção de parcelas e logo após selecionar o período:

Rotina de Import. Parcelas com as Filiais.

É possível selecionar todas as parcelas/filiais 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 à instituição de crédito.

06. INTEGRAÇÃO SALDO DEVEDOR TOTVS CONSIGNADO

Após realizar a criação no Portal RH do lote das consultas do saldo devedor. Para fazer essa integração o analista deve acessar a rotina Integrar Saldo Devedor pelo caminho  >Miscelanea>Consignação>Integrar Saldo Devedor. Para ter acesso ao menu é necessário baixar o arquivo (sigagpe.xnu) e realizar a importação via configurador. Para mais detalhes de como realizar a importação clique aqui.

Acessando o menu deverá preencher na tela integrar o saldo devedor Totvs Consignado, o Mês e Ano da competência do lote a ser importado e após selecione o botão Buscar. Assim será listado todos os lotes da competência que foi selecionada, após escolher o lote selecione o botão Importar. 

                                                                                                                                                                                                                  Tela  integrar saldo devedor Totvs Consignado.

Após a execução será apresentado o log com os detalhes da importação: 

                                                                                                                                                                                                                         Log gerado após execução da integração saldo devedor

• • Após a finalização do processo de integração, você poderá acompanhar os movimentos que foram importados na RGB (Lançamentos por funcionário ((SIGAGPE > Atualizações > Lançamentos > Por Funcionário).

IMPORTANTE: Caso não for concluído com sucesso a validação da integração, verifique a exceção apresentada conforme Log da integração apresentados neste documento.                                         

07. 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 a instituição de crédito o valor da margem consignável dos funcionários que atenda às particularidades de cada cliente.

Para usar tal funcionalidade no contexto padrão (definição das verbas incidentes), é 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:

• Campo RV_TCMARG = 1-Sim - Verba de base
• Margem calculada com verbas de provento
• Margem calculada com verbas de provento e desconto

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

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.

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.

08. 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
• SRC - Movimento do Período
• SRD - Históricos de Movimentos
• SRG - Rescisões
• SRK - Movimento de Valores futuros
• SRR - Itens de Férias e Rescisões
• SRV - Verbas

09. LINKS ÚTEIS

• Schedule - Como agendar a execução de rotinas
• TOTVS Consignado
• 0 - FAQ - Perguntas e Respostas

10. ASSUNTOS RELACIONADOS

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

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

• TOTVS Consignado - Envio da rescisão para a instituição de crédito