Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO

Índice


01. VISÃO GERAL

Painel
Informações
titleInformações

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

02. PRÉ-CONDIÇÕES PARA CONEXÃO

Os seguintes requisitos são necessários para implantação do produto:

  • RM
    • versão 12.1.31.104 ou superior.
    • Estar aderente à portabilidade das versões do RM (verificar item 08. LINKS ÚTEISdesse documento);
    • Utilizar ambiente 3 camadas;
    • Caso não tenha acessado o parametrizador dos Serviços Globais após a atualização do ambiente, é necessário executá-lo até o final, ainda que não faça nenhuma alteração. Isso é necessário para criação de parâmetros internos.
    • Caso não tenha acessado o parametrizador do Totvs Folha de Pagamento após a atualização do do ambiente, é necessário executá-lo até o final, ainda que não faça nenhuma alteração. Isso é necessário para criação de parâmetros internos.
  • Ativação do Totvs App, pode ser visto a seguir.
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.


02. PRÉ-CONDIÇÕES PARA CONEXÃO

Os seguintes requisitos são necessários para implantação do produto:

    • RM
      • versão erp
      • Estar aderente à portabilidade das versões do RM (verificar item 05. LINKS ÚTEIS, desse documento);
      • Utilizar ambiente 3 camadas;
      • Caso não tenha acessado o parametrizador dos Serviços Globais após a atualização do ambiente, é necessário executá-lo até o final, ainda que não faça nenhuma alteração. Isso é necessário para criação de parâmetros internos.
    • Totvs App (Ativação):
      • Para banco de dados Oracle a versão do banco tem que ser 12.2C ou superior
      • Para que seja possível utilizar o TOTVS Consignado é importante estar de posse das credenciais enviadas por email pela TOTVS, para integração entre as plataformas. A ativação ocorrerá por:

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


  • Também são necessárias algumas configurações prévias:


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
tabsPermissão de Acesso, Ativação das Credenciais, Ativação do Convênio, Processo de Desativação da Integração
ids1,2,3,4
Totvs custom tabs box items
defaultyes
referencia1

Para acessar o Totvs App, é necessário fornecer permissão para o perfil do usuário responsável pela ativação da integração.

Estando no erp RM, acesse a opção Serviços Globais > Segurança > Perfis > Sistema: Integração, edite o perfil desejado e na pasta "Acesso a Menus" habilite o acesso conforme imagem abaixo:


Image AddedFigura 1 - Tela de permissão para acesso ao Totvs App.


Totvs custom tabs box items
defaultno
referencia2

Após a permissão fornecida,  através das opções de menu a esquerda, escolha o sistema Integração > Totvs App > Ativação Totvs App.

Será apresentada tela do wizard de ativação para que você preencha os campos chave, conforme credenciais enviadas no email de provisionamento do ambiente encaminhado ao destinatário administrador da plataforma.

Este processo deve ser executado apenas na empresa coligada principal.

    • Credenciais para ativação por RACID ( RAC Client Id e RAC Client Secret (credenciais recebidas por email) )
    • Marque o botão "Buscar Apps" . Ao clicar para Buscar Apps, serão retornados somente os Apps disponíveis em cada Client Id e Client Secret. 
      Ex.: Caso seja informado um Client Id e um Client Secret que possui somente o App "Consignado", só o mesmo será retornado na busca.
    • Após a leitura das credenciais do RAC será acionado processo de criação do serviço de execução continua, para o envio de dados; para isso, todos os arquivos atualizados com a versão disponibilizada na nuvem ( "totvsAppConfig","Conceitos") serão baixados para o servidor e inseridos na tabela GTOTVSAPP a configuração de execução do processo em questão e na tabela GTOTVSAPPCONCEITO, os "Conceitos" responsáveis pela subida de dados para o ambiente em nuvem Carol, podendo este processamento ser acompanhado através do recurso para Gerenciamento de Job (GTOTVSAPPCONCEITOHST) .

     Para maiores informações clique aqui!

    • Após visualizar a apresentação do App Consignado para ativação, clique em Avançar para concluir o processo de integração. 

Image Added

Figura 2 - Tela para ativação das credenciais no TOTVS App.


Após a execução do processo

Totvs custom tabs box
tabsPermissão de Acesso, Ativação das Credenciais, Processo de Desativação da Integração
ids1,2,3

Para acessar o Totvs App, é necessário fornecer permissão para o perfil do usuário. No RM, acesse a opção Serviços Globais > Segurança > Perfis > Sistema: Integração.

Image RemovedFigura 16 - Tela de permissão para acesso ao Totvs App.

Totvs custom tabs box items
defaultyes
referencia1
Totvs custom tabs box items
defaultno
referencia2

Após a permissão fornecida, o acesso ao Totvs App é feito através do sistema Integração > Totvs App > Ativação Totvs App. O assistente de ativação possui apenas uma tela, onde deve ser informado os dados de conexão: URL da Carol, Id do Connector da Carol, Token da Carol e o checkbox "Consignado", que ativa o processo de integração.

Image Removed

Figura 17 - Tela do Processo de Ativação do Totvs App.

Caso algum campo não seja preenchido, o processo finalizará com falha, como mostra o exemplo a seguir:

Image Removed

Figura 18: Tela de configuração do Totvs App sem o campo Token Carol preenchido.

Image Removed
Figura 19 - Tela com log de erro.

Após a execução do processo de ativação, será criado um job, que executará em background , enviando os que executará a cada 5 minutos os conceitos criados responsáveis pelo envio dos dados para integração com a plataforma Carol.


Após ativado, a qualquer momento será possível desativar, conforme imagem a baixo:

Image Removed

Figura 20 - Tela para habilitar Ativação.

Obs.: Uma vez que a processo de desativar seja executado, todos os dados de configuração serão perdidos. Para ativá-lo, será necessário realizar o processo de configuração novamente, conforme mostrado anteriormente.

Totvs custom tabs box items
defaultno
referencia3
  • Também são necessárias algumas configurações prévias como pré-condição:

Para ativação do convênio da empresa erp com a instituição de crédito parceira, deverá ser aplicada a chave de ativação disponibilizada pela Techfin no menu Folha Mensal (opção deve estar liberada na segurança de menus dos perfis de acesso). Selecione o ícone "Ativação de Convênio TOTVS Consignado" conforme imagem a seguir e informe a senha de ativação do convênio.

Este processo deverá ser feito identificando quais empresas coligadas terão a integração com o TOTVS Consignado.


Image Added

Figura 3 - Tela para ativação do convênio da empresa com a instituição de crédito parceira

Totvs custom tabs box items
defaultno
referencia4

Após ativado, através da opção de menu sistema Integração > Totvs App > Ativação Totvs App, será possível desativar a integração com o TOTVS Consignado caso desejado , conforme imagem a baixo:

Image Added

Figura 4 - Tela para habilitar Ativação.

Observação:

Uma vez que a processo de desativar seja executado, todos os dados de configuração serão perdidos. Para reativá-lo, será necessário realizar o processo de configuração novamente, conforme mostrado anteriormente.



Atenção: 

É necessário realizar a execução do script personalizado enviado pela equipe técnica, para que seja habilitado nas Configurações do RM Labore (Parametrizador > Integrações > TOTVS Consignado), com os campos relacionados ao processo de integração do Totvs Consignado com o ERP, habilitando assim as Instituições de Crédito parceiras.
Totvs custom tabs box
tabsConceitos - Envio da Carga de Dados
ids5
Totvs custom tabs box
tabsHabilitar Integração Parceiro, Conceitos
ids4,5
Totvs custom tabs box items
defaultyes
referencia4
Totvs custom tabs box items
defaultnoyes
referencia5

Para que seja possível utilizar a integração do ERP com o Totvs TOTVS App  é importante ter atenção para a carga dos Conceitos que serão responsáveis pelo envio de dados para Carol e TotvsApps nuvem. 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) .

03. FUNCIONAMENTO DO MVP

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

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.

04. CONFIGURANDO A INTEGRAÇÃO ERP X TOTVS APP

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:

...

tabsEventos 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
ids6,7,8

...

defaultyes
referencia6

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.

Image Removed
Figura 2 - Exemplo de cadastro de evento com código de cálculo 438.

(ideia)Atenção:

  • Fórmula de Cálculo - Evento Desconto (c.c: 438)

 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

Image Removed
Figura 3 - Exemplo de cadastro de evento com código de cálculo 439.

(ideia)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. 

...

defaultno
referencia7

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:

Image RemovedFigura 4 - Acesso ao Parametrizador.

Image Removed

Figura53 - Etapas de Configuração da Conexão e definição dos Eventos pertinentes a integração.

  • TOTVS Consignado 1/2
    • Configurações de Conexão:  Dados de acesso ao RAC. Todos os dados são autoexplicativos e devem ser inseridos pela equipe técnica responsável pela manutenção de acessos na base do ERP.
    • Utiliza rateio da Margem Consignável:  Esse parâmetro poderá ser utilizado se existir contrato de parceria de Empréstimo Consignado com mais de uma operadora de crédito, e o usuário desejar ratear a margem consignável entre as operadoras de crédito. Ao marcar este campo será habilitado o campo "Fator de Rateio" que  nesse caso terá seu preenchimento obrigatório. 
      • Fator de rateio:  deverá informar nesse campo o fator de divisão entre as operadoras de crédito.
      • Exemplo: A empresa possui parceria entre a operadora 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 operadora de crédito a margem consignável de R$500,00.

Image Removed
Figura 6 - Exemplo da tela de configuração da conexão.

  • TOTVS Consignado 2/2
    • Evento de margem consignável: Informe aqui através da digitação do código ou da pesquisa de eventos pelo botão de pesquisa Image Removed o evento cadastrado do tipo Valor, Base de Cálculo com o código de cálculo 444 que poderá ter uma fórmula definida para apuração do Valor da Margem Consignável a ser enviada ao TOTVS Consignado. Os eventos de desconto e base de cálculo do Empréstimo Consignado deverão ser definidos por operadora de crédito na Etapa 3 desse processo ( TOTVS Consignado - Eventos Integração)

Image RemovedFigura 7 - Exemplo da tela de configuração do evento de Margem Consignável.

  •  TOTVS Consignado - Eventos Integração
    Deverão ser informados os eventos cadastrados com os devidos códigos de cálculo do consignado para serem vinculados aos parceiros de crédito,  conforme detalhamento dos campos a seguir:
    • Evento de desconto de Crédito Consignado:  evento do tipo "Desconto / Valor" tendo obrigatoriamente o código de cálculo 438 informado. Esse evento pode ser calculado por fórmula conforme entendimento do usuário, tirando como base o evento com código de cálculo 439.
    • Evento de base de cálculo do valor a ser descontado:  evento do tipo "Base de cálculo / Valor" tendo obrigatoriamente o código de cálculo 439 informado. Esse evento terá o valor original do empréstimo consignado a ser lançado na folha de pagamento. 
    • Evento de desconto de Crédito Consignado - Rescisão:  evento do tipo "Desconto / Valor" tendo obrigatoriamente o código de cálculo 442 informado. Esse evento pode ser calculado por fórmula conforme entendimento do usuário, tirando como base o evento com código de cálculo 443.
    • Evento de base de cálculo do valor a ser descontado - Rescisão:  evento do tipo "Base de cálculo / Valor" tendo obrigatoriamente o código de cálculo 443 informado. Esse evento terá o valor original a ser lançado na rescisão do funcionário.
    • Evento de margem consignável:  evento do tipo "Base de cálculo / Valor" tendo obrigatoriamente o código de cálculo 444 informado. O evento com esse código de cálculo não é obrigatório. Deve ser calculado por fórmula, conforme entendimento do usuário. Caso não seja informado na parametrização, o cálculo nativo do sistema será o valor líquido do mês anterior * 30%.

Image Removed

Figura 8 – Parametrização da integração com o TOTVS Consignado.

IMPORTANTE:  Para cada operadora 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 operadoras diferentes. Cada uma deverá ter o seu evento distinto respeitando as regras citadas acima de cadastro. Exemplo:

Image Removed

Figura 9 – Configuração dos Eventos Desconto e Base por Operadora

  • Etapa 54 - Eventos de Integração
    • Deverá ser marcado a flag referente ao TOTVS Consignado para que seja possível a integração dos descontos em folha de pagamento via Grupo de Eventos, conforme imagem abaixo:

Image Removed

Figura 10 - Etapa do Parametrizador pertinente

...

defaultno
referencia8
  • Caso seja definido a utilização de Rateio de Margem consignável entre os parceiros de crédito, faz-se necessário a distribuição do percentual referente a margem através do cadastro do funcionário configurado de forma individual. Para isso acesse o cadastro de funcionários(Administração de Pessoal > Funcionários) através da opção Anexos > Folha de Pagamento > Distribuição da margem consignável ,  conforme detalhamento dos passos a seguir:

Image Removed

Figura 11 – 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.

Image RemovedFigura 12 – Liberação de Acesso no Perfil de Usuários.

  • Ao incluir um novo registro, será apresentada a tela de edição para informar o percentual de rateio das margens. Selecione a operadora pelo botão [... através das opções disponibilizadas. 
  • No campo Percentual informe o valor a ser estabelecido para apuração daquela operadora selecionada. A soma de todos os rateios distribuídos deverá alcançar o total de 100%.
    • Exemplo 1: Funcionário não deseja ratear sua margem consignável e deseja que seja considerado o total em 100% para determinada Operadora de Crédito.

Image Removed

 Figura 13 – Cadastro do rateio de distribuição da margem consignável.

  • Exemplo 2: Líquido do Funcionário X no mês MM/AAAA    -     Liquido R$1.000,00           Margem consignável calculada: 300,00             

  Fator de Rateio: 2, só que o funcionário deseja dividir sua margem em:

                            Operadora 1 = 50%         Operadora 2 = 25%       Operadora 3 = 25%

Nesse exemplo os valores de margem consignável para cada operadora será:

     Operadora 1 = R$150,00         Operadora 2 = R$75,00       Operadora 3 = R$75,00

Image Removed

Figura 14 – 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.

Image Removed Figura 15 – Cadastro do rateio de distribuição da margem consignável. Tela de alerta

o processo de ativação da integração:


Importante

O serviço nunca deve ser interrompido sem a autorização da TOTVS pois este processo inviabiliza o correto uso dos dados pelo TOTVS Consignado


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

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 


04. ATIVAÇÃO DE NOVA COLIGADA

O procedimento para habilitar uma nova coligada no erp deve seguir as seguintes ações:

    1. Realizar a "Ativação do Convênio" conforme item 02deste documento
    2. Aguardar liberação da solicitação do time Techfin do b2b
    3. 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;


05. TABELAS UTILIZADAS

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

    • GTOTVSAPP
    • GTOTVSAPPCONCEITO
    • GTOTVSAPPCONCEITOHST
    • GPERFIL


06. LINKS ÚTEIS

...

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:

...

tabsProcesso de Integração, Logs de Exceção, Consulta Movimento de Integração
ids9,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.

Image RemovedFigura 21 - Tela de acesso ao Wizard.

...

defaultyes
referencia9

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.

Image Removed

Figura 22 - Tela de confirmação do processo de integração.

Image Removed

Figura 23 - Tela de acompanhamento do Progresso de execução do processo.

Image Removed

Figura 24 - 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.

...

defaultno
referencia10

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:

  • Exceções consideradas e tratadas com as seguintes mensagens:

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

                           

  • Eventos descritos no Log resultante do processo de integração:

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

Image Removed

Figura 25 - Exemplo da Tela de Logs

...

defaultno
referencia11

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.

Image Removed    Figura 26 - Tela de acesso a consulta

  • Para facilitar a busca, você poderá criar um filtro aplicando apenas a regra da Origem do Evento = TOTVS Consignado ou Tipo Lançamento = Parcela do empréstimo consignado conforme abaixo :

Image Removed             Figura 27 - Exemplo da Consulta de Movimento Integração (tabela PFMOVTEMP), carregada pela integração a ser consumida no Grupo de Eventos

06. TELA DE IMPORTAÇÃO DO MOVIMENTO INTEGRADO

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.

...

tabsGrupo de Eventos, Lançamento do Funcionário
ids11,12

...

defaultyes
referencia11

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.

Image Removed
Figura 28 – Tela de Grupo de Eventos - Lançar eventos de integração com outros aplicativos.

Image Removed
Figura 29 – Tela de Grupo de Eventos - TOTVS Consignado

...

defaultno
referencia12

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.

Image Removed

Figura 30 – 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

07. ENVIO ANTECIPADO DE RESCISÃO

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.

...

tabsProcesso Manual,Processo em Lote
ids13,14

...

defaultyes
referencia13

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

Image RemovedFigura 31 – 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.

Image RemovedFigura 32 – 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.

...

defaultno
referencia14

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.

Image Removed
Figura 33 – Processo de autorização e revogação de envio de dados da rescisão.

Image Removed
Figura 34 – Tela do processo de autorização e revogação de envio de dados da rescisão.

08. TABELAS UTILIZADAS

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

  • PPESSOA 
  • PFUNC 
  • PFPERFF 
  • PFFINANC 
  • PSECAO 
  • PFEMPRT 
  • PFHSTAFT
  • PPARAM 
  • PPARAMADICIONAIS
  • PFCONSIGNADODISTMARGEM
  • PCONSOPERADORAS
  • PFMOVTEMP
  • PGRPLANC
  • PTIPOLANCEVT
  • PCONSIGNADOEVENTOSOPERADORA

09. LINKS ÚTEIS

Documento Portabilidade RM

Código de Cálculo 438

Código de Cálculo 439

Código de Cálculo 442

Código de Cálculo 443

Código de Cálculo 444

...



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>

...