CONTEÚDO
Índice style none
Painel | |||||
---|---|---|---|---|---|
|
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.
Os seguintes requisitos são necessários para implantação do produto:
Informações |
---|
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:
...
tabs | Configuração do Wizard,Agendamento da execução da rotina FWTECHFINJOB |
---|---|
ids | 1,2 |
...
default | yes |
---|---|
referencia | 1 |
É necessário realizar a configuração do Wizard para conexão e exportação dos dados do ERP para a nuvem.
Importante:
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.
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.
Informações |
---|
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
...
tabs | Boas Vindas,Autenticação,Dados de Integração,Ativando a Integração |
---|---|
ids | 4,5,6,7 |
...
default | yes |
---|---|
referencia | 4 |
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
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. Tela com os campos de usuário, senha e seleção de grupo de empresa, para autenticação do acesso |
...
default | no |
---|---|
referencia | 6 |
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
...
default | no |
---|---|
referencia | 7 |
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.
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: 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.
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
...
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:
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.
...
tabs | Instituições financeiras,Filial não especificada,Filial especificada |
---|---|
ids | 16,17,18 |
...
default | yes |
---|---|
referencia | 16 |
Tabela S137 - Retorno da consulta às instituições de crédito
...
default | no |
---|---|
referencia | 17 |
Tabela S137 - Com filial não especificada
...
default | no |
---|---|
referencia | 18 |
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.
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:
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.
Rotina de Import. Parcelas com o período 202201 parametrizado.
No caso deste exemplo, são retornadas 13 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.
É 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:
...
tabs | Parcelas indisponíveis,Nenhuma parcela selecionada,Seleção de uma parcela,Seleção de mais de uma parcela,Seleção todas as parcela,Importação para diferentes situações na folha,Lançamentos por funcionário e cálculo da folha,Fechamento do período |
---|---|
ids | 8,9,10,11,12,13,14,15 |
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.
Os seguintes requisitos são necessários para implantação do produto:
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.
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 | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||
|
Totvs custom tabs box items | ||||
---|---|---|---|---|
| ||||
No caso de não haver nenhuma parcela disponível para o período selecionado, é exibido o log a seguir:
Rotina de Import. Parcelas com o período 202202 parametrizado e nenhuma parcela disponível para importação no período selecionado. |
Totvs custom tabs box items | ||||
---|---|---|---|---|
| ||||
Após a chamada da API, nenhuma parcela é selecionada e a importação é confirmada: Log de confirmação de importação sem nenhuma seleção de parcela. |
Totvs custom tabs box items | ||||
---|---|---|---|---|
| ||||
No caso de não existir verba associada a uma Instituição de Crédito, é exibido o log a seguir: Log mostrando que não foi encontrado vínculo de verba com Instituição de Crédito. |
Totvs custom tabs box items | ||||
---|---|---|---|---|
| ||||
No caso de não encontrar um roteiro FOL para o período atual, é exibido o log a seguir: Log mostrando que não foi encontrado roteiro FOL para o período atual. |
Totvs custom tabs box items | ||||
---|---|---|---|---|
| ||||
No caso de não encontrar um período ativo/aberto com o valor informado no filtro, é exibido o log a seguir: Log mostrando que não foi possível encontrar um período ativo/aberto. |
Totvs custom tabs box items | ||||
---|---|---|---|---|
| ||||
No caso de não encontrar um Centro de Custo associado ao funcionário que estiver recebendo lançamentos de uma parcela, é exibido o log a seguir: Log mostrando que não foi possível encontrar um Centro de Custo associado ao funcionário que estiver recebendo lançamentos de uma parcela. |
...
default | no |
---|---|
referencia | 10 |
Após a chamada da API, uma das treze parcelas é selecionada e a importação é confirmada:
Rotina de Import. Parcelas com a parcela selecionada.
Log de confirmação de importação da parcela.
Lançamento importado na RGB do funcionário, conforme rotina Lançamentos por funcionário:
Lançamentos por funcionário com a parcela importada - Mat.: 000014.
...
default | no |
---|---|
referencia | 11 |
Após a chamada da API, 2 das treze parcelas são selecionadas e a importação é confirmada:
Rotina de Import. Parcelas com as parcelas selecionadas.
Log de confirmação de importação das parcelas.
Lançamentos importados na RGB do funcionário, conforme rotina Lançamentos por funcionário:
Lançamentos por funcionário com a parcela importada - Mat.: 000014.
Lançamentos por funcionário com a parcela importada - Mat.: 00039.
...
default | no |
---|---|
referencia | 12 |
Após a chamada da API, selecionando doze parcelas são selecionadas e a importação é confirmada:
Rotina de Import. Parcelas com as parcelas selecionadas.
Log de confirmação de importação das parcelas.
Lançamentos importados na RGB do funcionário, conforme rotina Lançamentos por funcionário:
Lançamentos por funcionário com a parcela importada - Funcionário afastado - Mat.: 000014.
Lançamentos por funcionário com a parcela importada - Funcionário em situação normal - Mat.: 00039.
Lançamentos por funcionário com a parcela importada - Funcionário demitido - Mat.: 091500.
Lançamentos por funcionário com a parcela importada - Funcionário transferido - Mat.: 091591.
Lançamentos por funcionário com a parcela importada - Funcionário em férias - Mat.: 091592.
...
default | no |
---|---|
referencia | 13 |
Com o parâmetro "Situações" é possível escolher qual será a situação na folha importada, podendo-se selecionar uma opção ou todas as opções disponíveis.
No exemplo abaixo, será selecionada apenas a opção "Situação Normal":
Parametrização de importação de parcelas considerando o período 202008 e situação normal.
Ao confirmar os parâmetros, é exibida apenas uma parcela disponível para importação com as características solicitadas:
Parcela disponível para importação, considerando o período 202008 e situação normal.
...
default | no |
---|---|
referencia | 14 |
Para exemplificar o cálculo da folha de um funcionário que teve a importação da parcela do consignado, será utilizada a matrícula 091230:
Lançamentos por funcionário com a parcela importada - Mat.: 091230.
Após o cálculo da folha, a parcela importada na RGB é levada para a SRC, conforme rotina Consulta de Cálculo por Funcionário:
Consulta de cálculo por funcionário com a parcela importada - Mat.: 091230.
...
default | no |
---|---|
referencia | 15 |
Para exemplificar o Fechamento do Período da folha de um funcionário que teve a importação da parcela do consignado, será utilizada a matrícula 091341:
Log de fechamento do período.
Após o fechamento, o recibo de pagamento do funcionário pode ser consultado:
Recibo de Pagamento - Mat.: 091341.
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.
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 instituição de crédito o valor da margem consignável dos funcionários que atenda às particularidades de cada cliente.
Informações |
---|
Caso o cliente não use o TOTVS Consignado ou não deseje personalizar a margem consignável, o mnemônico deve ser deixado como .F. |
Para usar tal funcionalidade, é necessário:
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 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
|
Caso deseje saber mais detalhes sobre a margem personalizada, acesse o documento disponibilizado no item 09. ASSUNTOS RELACIONADOS.
As seguintes tabelas do Protheus são utilizadas nesse projeto:
...
|
Obs. 1: Para mais informações de como configurar o schedule, verificar item 05. LINKS ÚTEIS, desse documento;
Obs. 2: O schedule deve ser configurado após a configuração do Wizard.
IMPORTANTE: Após finalizar o Wizard realize a conferência da habilitação da chave de ativação do TOTVS Consignado conforme abaixo:
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
O procedimento para habilitar um novo grupo de empresa no erp deve seguir as seguintes ações:
Atenção: As solicitações de habilitação de novas coligadas, ocorrem através da equipe Techfin que deve ser acionada pelo cliente;
As seguintes tabelas do Protheus são utilizadas nesse projeto:
...
...