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.
...
O processo de ativação é simples, porem, deve ser realizado com cautela para garantir a saúde do envio dos dados para nuvem.
Este processo é iniciado após provisionamento dos ambientes do cliente. Após o cliente receber as credenciais de acesso, através de email enviado ao final da preparação do ambiente SaaS, o responsável deverá seguir os passos abaixo para garantir o cumprimento dos requisitos bem como habilitar as credenciais no erp nos passos indicados abaixo.
Normalmente este procedimento é realizado por profissional da área de TI responsável.
02. PRÉ-CONDIÇÕES PARA CONEXÃO
Os seguintes requisitos são necessários para implantação do produto:
versão 12.1.25 ou superior;DBAccess versão BUILD-20191119 - DBAccess versão TOTVS DBACCESS - BUILD 20.1.1.2 (20200606) ou superior;
- APPSERVER_BUILD-
1718 ou - 7 ou superior;
- SMARTCLIENT
APPSERVER0 ou - SMARTCLIENT_BUILD-17.3.0.16 ou SMARTCLIENT_BUILD-19.3.0.5 ou superior;
Configuração dos Parâmetros (SIGACFG > - 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):
Preencher com .T. para a ativação 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- 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).
ATENÇÃO: 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:
Informações |
---|
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 deste processo. |
Totvs custom tabs box |
---|
tabs | Configuração o do Wizard,Agendamento da execução da rotina FWTECHFINJOB,Tabela S137 - Verbas - Empréstimo Consignado |
---|
ids | 1,2,3 |
---|
|
Totvs custom tabs box items |
---|
| É Para ativar o TOTVS Consignado em seu erp é necessário realizar a configuração do Wizard para conexão e exportação dos dados do ERP para a nuvemo ambiente em 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.
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. info | 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 WZDMAISSALDOprograma CONFIGCONSIGNADO, pelo campo de “Programa inicial”. Image Removed
Figura 1 – Image AddedFigura 01 - Chamada do Wizard, no SmartClient
Totvs custom tabs box |
---|
tabs | Boas Vindas,Autenticação,Dados de PlataformaIntegração,Ativando a Integração |
---|
ids | 4,5,6,7 |
---|
| Totvs custom tabs box items |
---|
| 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. Image Added
Figura 02 - 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: Image AddedFigura 03 -
Image Removed
Figura 2 – Tela de “Boas vindas” do Wizard, com DBAccess incompatível
|
Totvs custom tabs box items |
---|
| 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. Image Removed Image Added
Figura 3 – 04 - Tela com os campos de usuário, senha e seleção de grupo de empresa, para autenticação do acesso
|
Totvs custom tabs box items |
---|
| A tela para preenchimento com os dados para acesso à plataforma contém seis de integração contém dois campos, onde devem ser informados : URL os dados da Carol, URL da Plataforma, ID do Conector da Carol, Token da Carol, RAC plataforma, que são: Client ID e RAC Client Secret. Image Removed Image Added
Figura 4 – 05 -Tela com os campos de para inserção dos dados para que possibilitam o acesso à plataforma
Nesse ponto, são exemplificadas ocorrem algumas validações, por exemplo, como se algum dos campos não tiver sido preenchido ou se o campo teve o seu preenchimento feito com dados incorretos. Image Removed Image Added
Figura 5 – 06 - Validação de campos vazios
Image Removed Image Added
Figura 6 – Com todos os campos preenchidos, menos a URL da Plataforma Image Removed
Figura 7 – Com todos os campos preenchidos, menos o ID do Conector da Carol Image Removed
Figura 8 – Com todos os campos preenchidos, menos o RAC Client ID Image Removed
Figura 9 – Com todos os campos preenchidos, com a URL da Carol incorreta Image Removed
Figura 10 – Com todos os campos preenchidos, com o RAC Client Secret incorreto Image Removed Figura 11 – Com todos os campos preenchidos corretamente07 - Campos preenchidos com informações inválidas
|
Totvs custom tabs box items |
---|
| Com os dados preenchidos corretamente, é possível avançar e verificar o status da ativação da integração, na última tela do Wizard. Image Added Image Added
Telas com o status da ativação da integração do ERP com a plataforma Figura 08 Figura09
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. |
|
Totvs custom tabs box items |
---|
| 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: ![](/download/attachments/568942187/TelaJob.png?version=1&modificationDate=1603199233483&api=v2)
Figura 12 – 10 - Exemplo de Schedule que deve ser configurado | Totvs custom tabs box items |
---|
| 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. Image RemovedFigura 13 - Tabela S137 - Retorno da consulta às operadoras de crédito
Image Removed
Figura 14 - Tabela S137 - Com filial não especificada Os registros podem ser criados sem especificar ou especificando a filial relacionada. Para a seleção da filial a ser especificada, é importante levar em consideração o compartilhamento das tabelas RCB e RCC, sendo que as duas devem ter o mesmo tipo de compartilhamento configurado. Image Removed
Figura 15 - Tabela S137 - Com filial específica
|
|
Obs. 1: Para mais informações de como configurar o schedule, verificar item 0805. LINKS ÚTEIS, desse documento;
Obs. 2: O schedule deve ser configurado após a configuração do Wizard;Wizard.
IMPORTANTE: Após finalizar o Wizard realize a conferência da habilitação da chave de ativação do TOTVS Consignado conforme abaixo:
Image Added
Figura 11 - Acesso ao programa
Image Added
Figura 12 - Seleção da localização do parâmetro
Image Added
Figura 13 - Busca do parâmetro
Image Added
Figura 14 - Seleção do parâmetro
Image Added
Figura 15 - Validação da habilitação do parâmetro = .T.
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 (caso não exista um email funcional na tela de identificação no cadastro do funcionário. quando realizado o processo de solicitação você poderá informar um email pessoal durante este processo)
- Data de nascimento válida
- Nro de um documento oficial com Orgão emissor e Data de emissão válida (podendo ser RG e/ou CNH)
- Nome da mãe (mesmo que identificação de Mãe Desconhecida)
- Salário > 0
04. ATIVAÇÃO DE NOVO GRUPO DE EMPRESAS
O procedimento para habilitar um novo grupo de empresa no erp deve seguir as seguintes ações:
- Realizar novamente a configuração do wizard e apontar o novo grupo de empresa conforme item 02 deste documento. Este procedimento deve ser realizado com o job em modo exclusivo e depois retornar para normal.
- Aguardar liberação da solicitação do time Techfin do b2b
- Aguardar liberação da solicitação do time Techfin realizada ao parceiro para habilitação dos novos CNPJ's
Atenção: As solicitações de habilitação de novas coligadas, ocorrem através da equipe Techfin que deve ser acionada pelo cliente;
...
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. TELA XXXXX
Principais Campos e Parâmetros
...
Card documentos |
---|
Informacao | Use esse box para destacar informações relevantes e/ou de destaque. |
---|
Titulo | IMPORTANTE! |
---|
|
...
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
- CONFIGCONSIGNADO
- FWTECHFINJOB
- SX6 - Parâmetros do Sistema
- SGX - Configuração de Consignação
- 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
...
05. LINKS ÚTEIS
...
HTML |
---|
<!-- 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>
|
...