CONTEÚDO
Índice |
---|
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 e contamos com a sua empresa para nos ajudar nessa jornada.
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ódulos 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 sejam extraídos dos ERP's, compartilhados e enviados para a plataforma. Já na nuvem, eles serão filtrados e tratados – sendo que esse tratamento pode ser feito de forma manual ou agendada – e, 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 mesmo, no 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 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 seguintes requisitos são necessários para implantação do produto:
Ativação por RACID ( Preferencial - Pré-condição, versões: 12.1.31.104 ou superior.)
Parâmetros necessários : clientid e clientsecret (credenciais enviadas por email)
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 assistente. |
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:
Ativação por RACID
Parâmetros necessários : clientid e clientsecret (credenciais enviadas por email)
Importante: Leia as seguintes instruções sobre a funcionalidade de subida de dados
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 deste processo. |
Totvs custom tabs box | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
| ||||||||||||||||||||||||
Totvs custom tabs box | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
|
Atenção:
...
tabs | Conceitos - Envio da Carga de Dados |
---|---|
ids | 5 |
...
default | yes |
---|---|
referencia | 5 |
Para que seja possível utilizar a integração do ERP com o Totvs App é importante ter atenção para a carga dos Conceitos que serão responsáveis pelo envio de dados para Carol e TotvsApps . Esses "Conceitos" serão processados via Jobserver conforme configurado em sua estrutura de criação e serão consumidos seguindo o processo de ativação da integração, podendo ser:
Ativação por ConnectorID
Parâmetros necessários : connectorid e token
Versões enquadradas na pré-condição do produto e inferiores as versões habilitadas para uso do RAC (12.1.31.104 ou superiores).
Caso esta seja a ativação da integração, através do processamento do arquivo totvsAppConfig (executado obrigatoriamente ao ativar a integração com o TOTVS Apps que deverá estar no diretório /RM.NET caminho sugerido ="C:\totvs\CorporeRM\RM.Net\Conceitos" /> ) , será acionado processo de baixar os "Conceitos" atualizados da versão disponibilizada na nuvem , inserindo-os na tabela GTOTVSAPPCONCEITO e podendo ser acompanhado processamento através do recurso para Gerenciamento de Job (GTOTVSAPPCONCEITOHST) .
Ativação por RACID ( Preferencial )
Parâmetros necessários : clientid e clientsecret
Pré-condição, versões: 12.1.31.104 ou superior.
Caso esta seja a ativação da integração, após a leitura das credenciais do RAC será acionado processo de baixar o arquivo totvsAppConfig (executado obrigatoriamente ao ativar a integração com o TOTVS Apps ) e os "Conceitos" atualizados da versão disponibilizada na nuvem, inserindo-os na tabela GTOTVSAPPCONCEITO e podendo ser acompanhado processamento através do recurso para Gerenciamento de Job (GTOTVSAPPCONCEITOHST) .
O ERP terá seus dados transmitidos para a nuvem por meio de uma conexão estabelecida pela chamada de um assistente de ativação - 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 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.
O TOTVS Consignado consome os dados, disponibilizados pela Carol e disponibiliza para os parceiros, realizando a conciliação das parcelas que foram enviada para o ERP.
Para que seja realizada a integração dos dados obtidos pela integração com a instituição de crédito realizando a carga para descontos em folha de pagamento é necessário a configuração prévia de alguns cadastros e parâmetros que permitiram a comunicação dos dados. Para isto siga os passo abaixo:
...
tabs | Eventos integração Folha de Pagamento, Parametrização RM-Ativação e Integração na Folha de Pagamento, Distribuição margem consignável por funcionário |
---|---|
ids | 6,7,8 |
...
default | yes |
---|---|
referencia | 6 |
No RM Labore (Administração de Pessoal > Eventos > Eventos), deverá ser cadastrado eventos com código de cálculo 438, 439, 442, 443 e opcionalmente 444 . (verificar item 08. LINKS ÚTEIS, desse documento) para cada parceiro de crédito existente, ou seja, cada parceiro Habilitado terá um agrupamento de eventos a serem cadastrados com numeração do código desejada e diferenciada.
Figura 6 - Exemplo de cadastro de evento com código de cálculo 438.
Atenção:
Para que seja garantida a legalidade do débito limitado a 30% do líquido para desconto do empréstimo, deverá ser criada uma Fórmula de Cálculo para receber a regra de cálculo desejada para apuração do desconto. Abaixo segue um exemplo como sugestão de uso.
Lembre-se o evento carregará integralmente o valor da parcela imputada para desconto pelo parceiro de crédito no TOTVS Consignado e este valor conforme contrato poderá ter um numerário acima da Margem Consignável aceita para desconto em folha de pagamento laboral.
Exemplo de fórmula: 30% da folha do funcionário. (Sugestão)
...
Se C('XXXX') > 0
entao
Se C('XXXX')>= (L*0.3)
entao L*0.3
Senao C('XXXX')
FimSe;
* Onde 'XXXX' deve ser o código do evento de base de cálculo com código de cálculo 439 - BASE DE CÁLCULO EMPRÉSTIMO CONSIGNADO PLATAF.TOTVS
Figura 7 - Exemplo de cadastro de evento com código de cálculo 439.
Atenção:
Para os eventos com código de cálculo 442 - DESCONTO DE EMPRÉSTIMO CONSIGNADO RESCISÃO e 444 - MARGEM CONSIGNÁVEL, o cálculo também poderá ser customizável por fórmula conforme o entendimento do usuário.
...
default | no |
---|---|
referencia | 7 |
No parametrizador do TOTVS RM - Folha de Pagamento (Configurações > Parametrizador > , deverá ser informado os dados necessários para a configuração inicial para realização do processo de integração do ERP com o TOTVS Consignado, conforme detalhamento dos campos a seguir:
Figura 8 - Acesso ao Parametrizador.
Figura 9 - Etapas de Configuração da Conexão e definição dos Eventos pertinentes a integração.
Exemplo: A empresa possui parceria entre a instituição de crédito A e B. O funcionário possui margem consignável de R$1.000,00. Marcando o parâmetro e informando o fator de rateio igual a 2, será enviado para cada instituição de crédito a margem consignável de R$500,00.
Figura 10 - Exemplo da tela de configuração da conexão.
Figura 11 - Exemplo da tela de configuração do evento de Margem Consignável.
Figura 12 – Parametrização da integração com o TOTVS Consignado.
IMPORTANTE: Para cada instituição de crédito, informe os eventos de desconto e base de cálculo que devem ser específicos para cada parceiro, ou seja, não poderá ser utilizado o mesmo evento em instituições de crédito diferentes. Cada uma deverá ter o seu evento distinto respeitando as regras citadas acima de cadastro. Exemplo:
Figura 13 – Configuração dos Eventos Desconto e Base por Instituição de Crédito
Figura 14 - Etapa do Parametrizador pertinente
...
default | no |
---|---|
referencia | 8 |
Figura 15 – Parametrização da Distribuição do rateio da margem consignável.
IMPORTANTE: Para acessar a Distribuição da margem consignável , é necessário fornecer permissão para o perfil do usuário. No RM, acesse a opção Serviços Globais > Segurança > Perfis > Sistema > RH : Folha de Pagamento.
Figura 16 – Liberação de Acesso no Perfil de Usuários.
Figura 17 – Cadastro do rateio de distribuição da margem consignável.
Fator de Rateio: 2, só que o funcionário deseja dividir sua margem em:
Instituição de crédito 1 = 50% Instituição de crédito 2 = 25% Instituição de crédito 3 = 25%
Nesse exemplo os valores de margem consignável para cada instituição financeira será:
Instituição de crédito 1 = R$150,00 Instituição de crédito 2 = R$75,00 Instituição de crédito 3 = R$75,00
Figura 18 – Visão da Distribuição do rateio da margem consignável para funcionário selecionado.
IMPORTANTE: Todo rateio deve respeitar a distribuição de 100% de seu percentual, desta forma, na tela de edição irá apresentar uma informação orientativa em destaque, até que toda distribuição seja realizada.
Figura 19 – Cadastro do rateio de distribuição da margem consignável. Tela de alerta
|
Atenção:
Totvs custom tabs box | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
O ERP terá seus dados transmitidos para a nuvem por meio de uma conexão estabelecida pela chamada de um assistente de ativação - TOTVS App -, onde devem ser configurados os campos correspondentes as credenciais, 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 para as regras de consistência dos dados, em especial aqueles que não são padronizados pelo erp, garantindo assim a subida destes dados para a base de dados do Consignado de forma integra no consumo das instituições parceiras.
Regras (campos obrigatórios informados no vínculo 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
O procedimento para habilitar uma nova coligada 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 RM são utilizadas nesse projeto:
...
Esse assistente permitirá realizar a integração dos dados apurados no TOTVS Consignado com o ERP RM RH, através das considerações a seguir:
...
tabs | Processo de Integração, Logs de Exceção, Consulta Movimento de Integração |
---|---|
ids | 9,10,11 |
No Totvs RM Folha de Pagamento, o acesso ao Wizard é feito pelo menu Folha Mensal, chamando o ícone "Integração TOTVS Consignado", conforme imagem abaixo.
Figura 20 - Tela de acesso ao Wizard.
...
default | yes |
---|---|
referencia | 9 |
O processo de integração dos dados do TOTVS Consignado com o ERP é simples e não precisa de interação do usuário além das configurações realizadas nas etapas anteriores citadas neste documento. Apenas é solicitado a confirmação de realização do processo por tabelas internas serão preenchidas neste momento, considerando os dados apurados no TOTVS Consignado para a competência em questão.
Figura 21 - Tela de confirmação do processo de integração.
Figura 22 - Tela de acompanhamento do Progresso de execução do processo.
Figura 23 - Tela esperada após conclusão do processo de integração.
IMPORTANTE: Caso não for concluído com sucesso a validação da integração, verifique a exceção apresentada conforme Log de Exceções apresentados neste documento.
...
default | no |
---|---|
referencia | 10 |
Após a finalização do processo de integração, você poderá acompanhar os movimentos que formam importados para a base do ERP (tabela PFMOVTEMP) , bem como possíveis causas de insucesso na conclusão do processo, conforme detalhamento a seguir:
- Na obtenção dos dados plataforma Consignado:
- Algum dos dados da integração com o TOTVS Consignado não está preenchido.
- Na obtenção de seções centralizadoras:
- Nenhuma seção centralizadora encontrada.
- Na obtenção do token do rac:
- O token de acesso não pode ser obtido.
- Código 404 (not found) na obtenção do token de acesso, possivelmente existe uma parametrização errada na sua URL da plataforma do RAC.
- Código 400 (bad request) na obtenção do token de acesso, possivelmente existe uma parametrização errada nos dados de cliend_id e client_secret.
- Código 500 (internal server error) ocorreu um erro inesperado do lado do servidor do RAC.
- Na obtenção das parcelas do consignado:
- Nenhum evento de folha cadastrado.
- Nenhuma parcela a ser consumida do TOTVS Consignado na competência {0}/{1}.
- Integração TOTVS Consignado
- Foram encontradas {0} parcelas para serem importadas na competência {1}/{2}.
- Uma parcela de valor {0} na competência {1}/{2}, para a matrícula de funcionário {3}, não foi inserida.
Figura 24 - Exemplo da Tela de Logs
...
default | no |
---|---|
referencia | 11 |
Para acompanhar os movimentos integrados pela plataforma TOTVS Consignado (tabela PFMOVTEMP) , utilize a ferramenta abaixo que permitirá um acompanhamento do que irá ser gravado na tabela financeira dos funcionários para a competência em questão.
Figura 25 - Tela de acesso a consulta
Figura 26 - Exemplo da Consulta de Movimento Integração (tabela PFMOVTEMP), carregada pela integração a ser consumida no Grupo de Eventos
Para que os dados vindos do parceiro de crédito através do processo de integração do TOTVS Consignado com o ERP sejam carregados no movimento da competência atual para desconto em Folha de Pagamento, é necessário a geração de movimento via Grupo de Eventos. Deverá ser marcado no Grupo de Eventos em questão, as flags indicadas a seguir:
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. |
...
tabs | Grupo de Eventos, Lançamento do Funcionário |
---|---|
ids | 12,13 |
...
default | yes |
---|---|
referencia | 12 |
Para a importação para a folha de pagamento, o grupo de eventos de lançamento de movimento deve ser marcado os campos em destaque abaixo para que a integração TOTVS Consignado (arquivo PFMOVTEMP) sejam carregados no movimento do Funcionário para a competência em questão.
Figura 27 – Tela de Grupo de Eventos - Lançar eventos de integração com outros aplicativos.
Figura 28 – Tela de Grupo de Eventos - TOTVS Consignado
...
default | no |
---|---|
referencia | 13 |
Para verificar o lançamento da verba de empréstimo na folha do funcionário, basta acessar o Envelope de Pagamento: Anexos > Movimento > Envelope de Pagamento.
Figura 29 – Verba de Empréstimo importada pela integração para a folha do funcionário.
IMPORTANTE: Pode-se acompanhar o andamento das concessões através do Portal - Empréstimos
Para que as instituições de crédito possam ter previsibilidade de encerramento dos contratos de funcionários vinculados ao ERP, é necessário realizar uma autorização de envio destes dados para a mesma. Este envio pode ser realizado de duas formas:
...
IMPORTANTE: Em qualquer um dos processos acima, este recurso somente será liberado caso existe integração com Totvs App ativa.
...
tabs | Processo Manual,Processo em Lote |
---|---|
ids | 14,15 |
...
default | yes |
---|---|
referencia | 14 |
Realizado através do cadastro de rescisão individual do funcionário. Após realizar o preenchimento dos dados referente ao aviso, na aba Rescisão será apresentado o campo: "Enviar dados para o TOTVS Consignado".
Figura 30 – Menu de cadastro de rescisão.
Como padrão, o campo já vem preenchido como Não (enum=1) identificando que a instituição somente será avisada da rescisão ao liberar a competência e caso o RH desejar que a rescisão em questão seja informada antecipadamente, deverá alterar o campo para Sim (enum=2).
ATENÇÃO: Para rescisões do tipo 5 e 6, o campo não será exibido.
Figura 31 – Campo para envio dos dados dentro do cadastro de rescisão.
IMPORTANTE: As rescisões que não forem enviadas antecipadamente, serão enviadas como confirmadas (enum=4) quando for realizada a liberação de competência.
...
default | no |
---|---|
referencia | 15 |
Para facilitar o envio de informações para a instituição de crédito de forma global, permitindo assim que o RH da empresa por contrato possa se organizar no envio destes dados e realizá-lo em grupo de dados, será possível a utilização do processo de "Autorização envio de dados da rescisão para o TOTVS Consignado". Neste caso, poderá aplicar filtros, definindo assim o grupo de pessoas que se deseja enviar de forma antecipada para a credora.
Os campos de data vão contemplar as rescisões que estão cadastradas dentro do período informado. A data deve estar dentro do intervalo do primeiro dia da competência atual até o último dia da próxima competência.
Ao confirmar o processo de autorização será enviado de forma antecipada os dados para a instituição de crédito como previsibilidade (poderá ser reversível pela revogação antes da virada de competência). O processo de revogação cancelará esse envio antecipado, contudo, os dados serão enviados como confirmados após a liberação de competência.
Figura 32 – Processo de autorização e revogação de envio de dados da rescisão.
Figura 33 – Tela do processo de autorização e revogação de envio de dados da rescisão.
As seguintes tabelas do RM são utilizadas nesse projeto:
...
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> |
...