CONTEÚDO


01. VISÃO GERAL

Quer saber mais e contratar o TOTVS Consignado? Acesse o nosso site https://www.totvs.com/techfin/consignado, clique em "Ligamos para você" para prosseguir com a contratação do TOTVS Consignado! Ou ainda, contate o Executivo de Serviços e Negócios da sua conta para mais esclarecimentos.


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:


Para ter essas novas funcionalidades na base do Protheus, é importante realizar a atualização do dicionário de dados, via UPDDISTR, e estar com o pacote de expedição contínua aplicado na base, conforme última versão disponibilizada na Central de Downloads.


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.


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


O acesso ao Wizard é feito pelo SmartClient, chamando o programa CONFIGCONSIGNADO, pelo campo de “Programa inicial”.

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

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:

Tela de “Boas vindas” do Wizard, com DBAccess incompatível

Na tela de autenticação, devem ser inseridos o usuário e senha do sistema. Apenas é possível avançar para a próxima tela se os dados de ambos os campos forem inseridos corretamente. Caso contrário, o sistema exibe alertas para que os dados sejam informados, caso tenham ficado em branco, ou para que sejam corrigidos o(s) campo(s) com preenchimento incorreto.

Preenchendo os campos com os dados corretos e com a seleção do grupo de empresas realizada, o usuário pode seguir para a próxima tela, para preenchimento dos dados da plataforma.

Tela com os campos de usuário, senha e seleção de grupo de empresa, para autenticação do acesso

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.

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.

Validação de campos vazios

Campos preenchidos com informações inválidas

Com os dados preenchidos corretamente, é possível avançar e verificar o status da ativação da integração, na última tela do Wizard.

 

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.

No configurador do Protheus (SIGACFG > Ambiente > Schedule > Schedule), realizar o Agendamento da execução da rotina FWTECHFINJOB, com Padrão de recorrência “Sempre Ativo”, conforme exemplo abaixo:

Exemplo de Schedule que deve ser configurado


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. COMUNICAÇÃO DA RESCISÃO PARA INSTITUIÇÃO DE CRÉDITO

Pré-requisitos

  • Atualização de dicionário de dados via UPDDISTR para criação de novos campos e tabelas envolvidos nesta funcionalidade;
  • Configuração do novo item de Menu para a nova rotina de Comunicar a rescisão (CONSIG005).
    • Em caso de dúvidas, consultar a documentação  exemplo de como importar um menu.


A implementação terá efeito apenas se existir o cálculo da rescisão com o lançamento da verba identificada na tabela de cálculo S137 (Verbas - Empréstimo Consignado).


  • Acesse a rotina em Gestão de Pessoal→ Miscelânea → Consignação → Comunicar Rescisão


  • Ao acessar a rotina será solicitado informar os parâmetros para consultar as rescisões calculadas no período informado.

  • Será apresentado todas as instituições de crédito cadastradas na tabela S137 (Verbas - Empréstimo Consignado) e os colaboradores com a rescisão calculada no período informado.
  • Ao marcar ou desmarcar uma instituição de crédito os funcionários com rescisão calculada são filtrados.
  • É permitido a seleção de várias instituição de crédito ou funcionário ao clique do cabeçalho da coluna de marcação.

  • Após a seleção dos funcionários é necessário confirmar a execução da rotina, que apresentará todos os funcionários selecionados para validação.
  • Após a validação dos funcionários selecionados é necessário avançar, é informado que o processo é irreversível.

  • O Sucesso ou erro no processo é apresentado para análise/correção em cada linha.


Após fechar, as legendas de processamento são ajustadas.

  • Chave do Consignado Desativada ao entrar na rotina.


  • Nenhuma verba configurada com a Instituição de Crédito.


  • Consulta de funcionários e rescisões não encontraram registros para os filtros/período selecionado.


  • Nenhum registro selecionado para comunicação.


  • Registro já comunicado




09. TABELAS UTILIZADAS

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

10. LINKS ÚTEIS

11. ASSUNTOS RELACIONADOS




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