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:
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 | |||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||
O acesso ao Wizard é feito pelo SmartClient, chamando o programa CONFIGCONSIGNADO, pelo campo de “Programa inicial”. Chamada do Wizard, no SmartClient Totvs custom tabs box |
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. 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 |
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 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.
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.
|
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 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 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.
Com a execução desse job, o TOTVS Consignado consome os dados tratados na Carol e os disponibiliza para as instituições 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 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.
...
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 |
Totvs custom tabs box items | ||||
---|---|---|---|---|
| ||||
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.
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, neste documento (02. PRÉ-CONDIÇÕES PARA CONEXÃO), é preciso estar com as configurações realizadas. 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 > Miscelanea > 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 MG 01, o período para importação de 202008 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 202008 parametrizado.
No caso deste exemplo, são retornadas 5 parcelas disponíveis para importação no período de 20208:
Rotina de Import. Parcelas com as parcelas disponíveis para 202008.
É 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 |
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 202008 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. |
...
default | no |
---|---|
referencia | 10 |
Após a chamada da API, uma das cinco 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.: 091250.
...
default | no |
---|---|
referencia | 11 |
Após a chamada da API, duas das três 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.: 091250.
Lançamentos por funcionário com a parcela importada - Mat.: 091230.
...
default | no |
---|---|
referencia | 12 |
Após a chamada da API, cinco 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.: 091250.
Lançamentos por funcionário com a parcela importada - Funcionário em situação normal - Mat.: 091230.
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:
...
tabs | Campo RV_TCMARG = 1-Sim - Verba de base,Margem calculada com verbas de provento,Margem calculada com verbas de provento e desconto |
---|---|
ids | 19,20,21 |
Totvs custom tabs box items | ||||
---|---|---|---|---|
| ||||
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 |
...
default | no |
---|---|
referencia | 20 |
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.
|
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:
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.
...
default | no |
---|---|
referencia | 21 |
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.
As seguintes tabelas do Protheus são utilizadas nesse projeto:
...
...
...