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 Protheus ou via 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 06. LINKS ÚTEIS, desse documento;

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

03. FUNCIONAMENTO DO MVP

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. 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 apenas o período no qual se deseja realizar a importação (no formato AAAAMM), pois será considerada a filial que o usuário está logado para disponibilização das parcelas que serão importadas.

Para exemplificar o uso da rotina de Import. Parcelas, será usada a filial D MG 01 e o período para importação de 202007. 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 202007 parametrizado.

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

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

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

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

06. LINKS ÚTEIS

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

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