TOTVS Consignado

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Rosana Vieira Alonso Pinto Ramos

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Rosana Vieira Alonso Pinto Ramos

Gravado em

Chave

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

...

Para isto siga os passo abaixo:

PARAMETRIZAÇÃO-ATIVAÇÃO E INTEGRAÇÃO

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 Removed

Figura 01 - Acesso ao Parametrizador.

Selecione a etapa de Integrações 06.02.09; será apresentada as telas para configuração da integração com o TOTVS Consignado.

Image Removed

Figura 02 - Selecionando a parametrização da integração com TOTVS Consignado.

Image Removed

Figura 03 - 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 instituição de crédito e o usuário desejar ratear a margem consignável entre as instituições 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 instituições de crédito.

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

Image Removed

Figura 04 - Exemplo da tela de configuração da conexão

Utilizando Rateio da Margem Consignável, também será possível optar por realizar a distribuição percentual da margem consignável de forma customizada por funcionário; para isso utiliza-se a Distribuição da Margem que podderá ser entendida a seguir: 

...

tabsDistribuição margem consignável por funcionário, Eventos integração Férias, Eventos integração Saldo devedor
ids1

...

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 16 – 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 17 – 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 instituição de crédito pelo botão [...]  através das opções disponibilizadas. 
  • No campo Percentual informe o valor a ser estabelecido para apuração daquela instituição de crédito. 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 instituição de crédito.

Image Removed

 Figura 18 – 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:

                            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

Image Removed

Figura 19 – 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 20 – Cadastro do rateio de distribuição da margem consignável. Tela de alerta

  • 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 deverá 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 instituição de crédito na Etapa 3 desse processo ( TOTVS Consignado - Eventos Integração)"

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

(ideia)Atenção: Abaixo segue três exemplos como sugestão de cadastro da fórmula:

...

/*Variável PERIODO deve receber o número do período de Fopagto Mensal*/  

SE MES=1
  E LIQUIDOFF(ANO-1,12,PERIODO) > 0
ENTAO LIQUIDOFF(ANO-1,12,PERIODO) * 0.3
SENAO
SE MES<>1
  E LIQUIDOFF(ANO,MES-1,PERIODO) > 0
ENTAO LIQUIDOFF(ANO,MES-1,PERIODO) * 0.3
SENAO RC * 0.3
FIMSE
     FIMSE
          FIMSE;

...

RC * 0.3

EVENTOS/VERBAS DE INTEGRAÇÃO COM A FOLHA DE PAGAMENTO MENSAL

No ERP TOTVS > Administração de Pessoal > Eventos > Eventos, deverá ser cadastrados os eventos com os seguintes código de cálculo 438, 439 e 444 ( mais informações no item 04. LINKS ÚTEIS ) .

Para para cada instituição de crédito existente, ou seja, cada parceiro habilitado como conveniado no erp, deverá existir um agrupamento de eventos a serem cadastrados com numeração do código desejada e diferenciada.

    • Os eventos cadastrados com os devidos códigos de cálculo do TOTVS Consignado para serem vinculados as instituições de crédito parceiras nos parâmetros de integração,  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 de desconto do usuário, tirando como base o evento com código de cálculo 439 que é enviado o valor base da parcela a ser informado pela instituição de crédito. 

        • Sugestão de uso de Fórmula Valor no Cálculo do Evento Desconto (c.c: 438)

        Para que seja garantida a legalidade do débito limitado ao % limite definido pela legislação do líquido para desconto do empréstimo,  poderá 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. Ao cadastrar a fórmula vincule-a ao campo Fórmula Valor do cadastro do evento com c.c: 438.

        Exemplo de fórmula:  30% da folha do funcionário no movimento atual. 

        /* 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  */

        Se C('XXXX') > 0
          entao
        Se C('XXXX')>= (L*0.3)
          entao L*0.3
        Senao C('XXXX')
        FimSe;

      • 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 e vinculado a uma Chave desativada. Esse evento terá o valor original do empréstimo consignado a ser lançado na folha de pagamento informado pela instituição de crédito parceira.

      • Evento de base de cálculo do valor da margem consignável customizada:  evento do tipo "Base de cálculo / Valor" tendo obrigatoriamente o código de cálculo 444 informado e vinculado a uma Chave desativada. Esse evento deverá ter uma fórmula de cálculo a critério do usuário que irá calcular o valor da margem consignável a ser informado a instituição de crédito parceira para que a mesma possa fazer análise de crédito e liberação do processo. 

Image Added
Figura 01 - Exemplo de cadastro de evento com código de cálculo 438.

DICA: Para conhecer em detalhes esta funcionalidade clique aqui!


EVENTOS/VERBAS DE INTEGRAÇÃO COM FÉRIAS

No ERP TOTVS > Administração de Pessoal > Eventos > Eventos, deverá ser cadastrados os eventos com os seguintes código de cálculo 453, 454, 455, 456, 466 ( mais informações no item 04. LINKS ÚTEIS ).

Toda regra de cálculo é realizada pelo módulo de Folha de Pagamento e para saber mais clique aqui! 

    • Os eventos cadastrados com os devidos códigos de cálculo do TOTVS Consignado para serem vinculados serão utilizados no processo de cálculo do recibo e lançamento das férias,  conforme detalhamento dos campos a seguir:

      • PROVISÃO EMPRÉSTIMO CONSIGNADO FÉRIAS 1o. MÊS:  evento do tipo "Desconto / Valor" tendo obrigatoriamente o código de cálculo 453 informado. Esse evento buscará o valor do desconto do empréstimo consignado do mês anterior (evento na ficha financeira com código de cálculo 438) e provisionará o próximo desconto referente a competência vigente no recibo de férias, conforme dias dentro do mês

      • PROVISÃO EMPRÉSTIMO CONSIGNADO FÉRIAS 2o. MÊS:  evento do tipo "Desconto / Valor" tendo obrigatoriamente o código de cálculo 454 informado. Esse evento buscará o valor do desconto do empréstimo consignado do mês anterior (evento na ficha financeira com código de cálculo 438) e provisionará o próximo desconto referente a competência vigente no recibo de férias, conforme dias dentro do próximo mês
      • PROVISÃO EMPRÉSTIMO CONSIG.FÉRIAS 1o. MÊS ENVELOPE :  evento do tipo "Provento / Valor" tendo obrigatoriamente o código de cálculo 455 informado. Esse evento buscará o valor do desconto do empréstimo consignado provisionado no recibo de férias (evento com código de cálculo 453) e espelhará o mesmo no envelope de pagamento para ajuste de movimento do adiantamento conforme recibo , referente a competência dos dias de férias no mês vigente (dias dentro do mês) após processo de lançamento das férias
      • PROVISÃO EMPRÉSTIMO CONSIG.FÉRIAS 2o. MÊS ENVELOPE :  evento do tipo "Provento / Valor" tendo obrigatoriamente o código de cálculo 456 informado. Esse evento buscará o valor do desconto do empréstimo consignado provisionado no recibo de férias (evento com código de cálculo 454) e espelhará o mesmo no envelope de pagamento para ajuste de movimento do adiantamento conforme recibo , referente a competência dos dias de férias no próximo mês (dias dentro do próximo mês) após processo de lançamento das férias
      • ADIANTAMENTO PROVISÃO EMPRÉSTIMO CONSIGNADO FÉRIAS :  evento do tipo "Desconto/ Valor" tendo obrigatoriamente o código de cálculo 466 informado. Esse evento será utilizado para desconto do "Adiantamento de Férias" armazenando o valor do empréstimo consignado provisionado no recibo de férias  e não acumulando o valor do desconto do empréstimo de férias no evento com código de cálculo 43. Desta forma será discriminado o valor provisionado no recibo de férias para desconto da parcela do empréstimo consignado.

DICA: Para conhecer em detalhes esta funcionalidade clique aqui!


No parametrizador do TOTVS RM - Folha de Pagamento (Configurações > Parametrizador > , deverá ser informado os dados necessários para a configuração para realização do processo de integração das férias do ERP com o TOTVS Consignado, conforme detalhamento dos campos a seguir:

Image Added

Figura 02 - Acesso ao Parametrizador.


Selecione a etapa de Férias 06.01.04 - Etapa Controle 1/2; será apresentada a telas para configuração da integração com o TOTVS Consignado.

Nesta janela, selecione a opção em destaque abaixo "Lança provisionamento do desconto de empréstimo consignado no recibo de férias", que tem como principal função realizar o lançamento de evento com código de cálculo (podendo ser: 453 ou 454 ) específico do processo, com o valor a ser provisionado no recibo de férias. 

453 - PROVISÃO EMPRÉSTIMO CONSIGNADO FÉRIAS 1o. MÊS (Desconto)
Esse evento buscará o valor do desconto do empréstimo consignado do mês anterior (evento na ficha financeira com código de cálculo 438) e provisionará o próximo desconto referente a competência vigente no recibo de férias, conforme dias dentro do mês

454 - PROVISÃO EMPRÉSTIMO CONSIGNADO FÉRIAS 2o. MÊS (Desconto)
Esse evento buscará o valor do desconto do empréstimo consignado do mês anterior (evento na ficha financeira com código de cálculo 438) e provisionará o próximo desconto referente a competência vigente no recibo de férias, conforme dias dentro do próximo mês


Image Added

Figura 03 - Acesso ao Parametrizador.


EVENTOS/VERBAS DE INTEGRAÇÃO COM RESCISÃO

No ERP TOTVS > Administração de Pessoal > Eventos > Eventos, deverá ser cadastrados os eventos com os seguintes código de cálculo 442 e 443,  ( mais informações no item 04. LINKS ÚTEIS ).

Para saber sobre a integração do saldo devedor para quitação do empréstimo  clique aqui! 

    • Evento de
    •  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
    • 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
          • Sugestão 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.

      Image Removed

      Figura 13 – 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:

      Image Removed

      Figura 14 – Configuração dos Eventos Desconto e Base por Instituição de Crédito

      • 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 15 - Etapa do Parametrizador pertinente

      EVENTOS/VERBAS DE INTEGRAÇÃO COM A FOLHA DE PAGAMENTO

       Distribuição margem consignável por funcionário, Eventos integração Férias, Eventos integração Saldo devedor

      No RM Labore (Administração de Pessoal > Eventos > Eventos), deverá ser cadastrados os eventos com os seguintes código de cálculo 438, 439, 442, 443 e 444 ( mais informações no item 11. LINKS ÚTEIS ).

      Para para cada instituição de crédito existente, ou seja, cada parceiro habilitado como conveniado no erp, deverá existir um agrupamento de eventos a serem cadastrados com numeração do código desejada e diferenciada.

      • Os eventos cadastrados com os devidos códigos de cálculo do TOTVS Consignado para serem vinculados aos parceiros de crédito nos parâmetros de integração,  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 de desconto do usuário, tirando como base o evento com código de cálculo 439 que é enviado o valor base da parcela a ser informado pela instituição de crédito.

        • 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 e vinculado a uma Chave desativada. Esse evento terá o valor original do empréstimo consignado a ser lançado na folha de pagamento informado pela instituição de crédito parceira. 

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

      (ideia)Atenção sobre as Fórmulas:

      • Fórmula Valor - Cálculo do Evento Margem Consignável (c.c: 444)

      Para que seja possível uma análise mais consistente pela instituição de crédito no que tange delimitar o score de seus clientes, o TOTVS Consignado permite que a empresa detentora do erp,  defina o valor de margem consignável a ser considerado para o funcionário. Desta forma, conforme os critérios da empresa aplicados é possível dar clareza do valor de análise da instituição de crédito, podendo a regra da fórmula delimitar a 30% do líquido para contratação de empréstimo como demonstramos no exemplo abaixo.

      Após cadastrar a Fórmula de Cálculo com a regra desejada, informe a mesma no evento com o código de cálculo 444 que deverá ser do tipo Base de Cálculo , Valor e que vinculado a uma Chave desativada, conforme parâmetros. Obrigatório informar este evento na pasta de "Eventos do grupo" no processo de lançamento de Grupos de evento para os movimentos de Folha de Pagamento mensal para que o mesmo seja enviado para a ficha financeira e consequentemente para a Carol.

      Image Removed

      Figura 7 - Exemplo de cadastro de Eventos do Grupo

      Abaixo segue três exemplos como sugestão de cadastro da fórmula:

      ...

      /*Variável PERIODO deve receber o número do período de Fopagto Mensal*/  

      SE MES=1
        E LIQUIDOFF(ANO-1,12,PERIODO) > 0
      ENTAO LIQUIDOFF(ANO-1,12,PERIODO) * 0.3
      SENAO
      SE MES<>1
        E LIQUIDOFF(ANO,MES-1,PERIODO) > 0
      ENTAO LIQUIDOFF(ANO,MES-1,PERIODO) * 0.3
      SENAO RC * 0.3
      FIMSE
           FIMSE
                FIMSE;

      ...

      RC * 0.3

      • Fórmula Valor - Cálculo do 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 no movimento atual. 

      /* 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  */

      Se C('XXXX') > 0
        entao
      Se C('XXXX')>= (L*0.3)
        entao L*0.3
      Senao C('XXXX')
      FimSe;

      Image Removed
      Figura 8 - 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, o cálculo também poderá ser customizável por fórmula conforme o entendimento do usuário. 

      EVENTOS/VERBAS DE INTEGRAÇÃO COM FÉRIAS

      No RM Labore (Administração de Pessoal > Eventos > Eventos), deverá ser cadastrados os eventos com os seguintes código de cálculo 453, 454, 455, 456 ( mais informações no item11. LINKS ÚTEIS ).

      Toda regra de cálculo é realizada pelo módulo de Folha de Pagamento e para saber mais clique aqui! 

      • Os eventos cadastrados com os devidos códigos de cálculo do TOTVS Consignado para serem vinculados serão utilizados no processo de cálculo do recibo e lançamento das férias,  conforme detalhamento dos campos a seguir:

        • PROVISÃO EMPRÉSTIMO CONSIGNADO FÉRIAS 1o. MÊS:  evento do tipo "Desconto / Valor" tendo obrigatoriamente o código de cálculo 453 informado. Esse evento buscará o valor do desconto do empréstimo consignado do mês anterior (evento na ficha financeira com código de cálculo 438) e provisionará o próximo desconto referente a competência vigente no recibo de férias, conforme dias dentro do mês

        • PROVISÃO EMPRÉSTIMO CONSIGNADO FÉRIAS 2o. MÊS:  evento do tipo "Desconto / Valor" tendo obrigatoriamente o código de cálculo 454 informado. Esse evento buscará o valor do desconto do empréstimo consignado do mês anterior (evento na ficha financeira com código de cálculo 438) e provisionará o próximo desconto referente a competência vigente no recibo de férias, conforme dias dentro do próximo mês
        • PROVISÃO EMPRÉSTIMO CONSIG.FÉRIAS 1o. MÊS ENVELOPE :  evento do tipo "Provento / Valor" tendo obrigatoriamente o código de cálculo 455 informado. Esse evento buscará o valor do desconto do empréstimo consignado provisionado no recibo de férias (evento com código de cálculo 453) e espelhará o mesmo no envelope de pagamento para ajuste de movimento do adiantamento conforme recibo , referente a competência dos dias de férias no mês vigente (dias dentro do mês) após processo de lançamento das férias
        • PROVISÃO EMPRÉSTIMO CONSIG.FÉRIAS 2o. MÊS ENVELOPE :  evento do tipo "Provento / Valor" tendo obrigatoriamente o código de cálculo 456 informado. Esse evento buscará o valor do desconto do empréstimo consignado provisionado no recibo de férias (evento com código de cálculo 454) e espelhará o mesmo no envelope de pagamento para ajuste de movimento do adiantamento conforme recibo , referente a competência dos dias de férias no próximo mês (dias dentro do próximo mês) após processo de lançamento das férias

      EVENTOS/VERBAS DE INTEGRAÇÃO COM RESCISÃO

      No RM Labore (Administração de Pessoal > Eventos > Eventos), deverá ser cadastrados os eventos com os seguintes código de cálculo 442 e 443,  ( mais informações no item 11. LINKS ÚTEIS ).

        Para saber sobre a integração do saldo devedor para quitação do empréstimo  clique aqui! 

                        •  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 e vinculado a uma Chave desativada. Esse evento terá o valor original a ser lançado na rescisão do funcionário.

      • Fórmula Valor - Cálculo do Evento Desconto (c.c: 442)

      Para que seja garantida a legalidade do débito limitado a 30% do líquido para desconto do  saldo devedor para quitação 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 do saldo devedor para desconto pelo parceiro de crédito no TOTVS Consignado.

      Exemplo de fórmula:  30% da folha do funcionário no movimento atual. 

      /* Onde 'XXXX' deve ser o código do evento de base de cálculo com código de cálculo 443 - DESCONTO EMPRÉSTIMO CONSIGNADO RESCISAO  */

      Se C('XXXX') > 0
        entao
      Se C('XXXX')>= (L*0.3)
        entao L*0.3
      Senao C('XXXX')
      FimSe;

      ...

      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
      ids30,31,32

      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
      referencia30

      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
      referencia31

      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

          • uso de Fórmula Valor no Cálculo do Evento Desconto (c.c: 443)

            Para que seja garantida a legalidade do débito limitado a 30% do líquido para desconto do  saldo devedor para quitação 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 do saldo devedor para desconto pelo parceiro de crédito no TOTVS Consignado. Ao cadastrar a fórmula vincule-a ao campo Fórmula Valor do cadastro do evento com c.c: 443.

            Exemplo de fórmula:  30% da folha do funcionário no movimento atual. 

            /* Onde 'XXXX' deve ser o código do evento de base de cálculo com código de cálculo 443 - DESCONTO EMPRÉSTIMO CONSIGNADO RESCISAO  */

            Se C('XXXX') > 0
              entao
            Se C('XXXX')>= (L*0.3)
              entao L*0.3
            Senao C('XXXX')
            FimSe;

        • 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 e vinculado a uma Chave desativada. Esse evento terá o valor original a ser lançado na rescisão do funcionário.

      DICA: Para conhecer em detalhes esta funcionalidade clique aqui!


      PARAMETRIZAÇÃO-ATIVAÇÃO E INTEGRAÇÃO

      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 Added

      Figura 02 - Acesso ao Parametrizador.


      Selecione a etapa de Integrações 06.02.09; será apresentada as telas para configuração da integração com o TOTVS Consignado.

      Image Added

      Figura 03 - Selecionando a parametrização da integração com TOTVS Consignado.


      Image Added

      Figura 04 - 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 instituição de crédito e o usuário desejar ratear a margem consignável entre as instituições 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:  caso o parâmetro anterior esteja marcado, deverá informar nesse campo o fator de divisão entre as instituições de crédito.

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

      Image Added

      Figura 05 - Exemplo da tela de configuração da conexão


      Utilizando Rateio da Margem Consignável, também será possível optar por realizar a distribuição percentual da margem consignável de forma customizada por funcionário; para isso utiliza-se a Distribuição da Margem que poderá ser entendida a seguir: 

      Totvs custom tabs box
      tabsLiberando Acesso, Configurando a Distribuição da Margem Consignável
      ids1,2

      Caso seja definido a utilização de rateio de margem consignável entre os parceiros de crédito sendo desejado a flexibilização customizada de tal margem, faz-se necessário a distribuição do percentual referente a margem através do cadastro do funcionário, configurado de forma individual a customização.

      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 ,  e realize a distribuição desejada conforme detalhamento dos passos a seguir:

      ...

      defaultno
      referencia32

      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. INTEGRAÇÃO SALDO DEVEDOR TOTVS CONSIGNADO

      Esse assistente permitirá realizar a integração dos dados do saldo devedor para quitação do empréstimo no TOTVS Consignado com o ERP RM RH, através das considerações a seguir:

      ...

      tabsPermissão de Acesso,Processo de Integração
      ids15,16

      ...

      defaultyes
      referencia16

      No Totvs RM Folha de Pagamento, acesse o menu Rescisão, chamando o ícone "Importar Parcelas Saldo Devedor Totvs Consignado", conforme imagem abaixo.

      Image Removed

      Figura 27 - Tela de acesso a consulta do saldo devedor 

      Acessando o menu deverá preencher na tela importar o saldo devedor Totvs Consignado, o Mês e Ano da competência do lote a ser importado e após selecione o botão Buscar. Assim será listado todos os lotes da competência que foi selecionada, após escolher o lote a ser importado selecione o botão executar. 

      ...

      Figura 28 - Tela de importar saldo devedor Totvs Consignado.

      Image Removed

      Figura 29 - Tela de confirmação da importação do Saldo devedor.

      Image Removed

      Figura 30 - Tela esperada após conclusão do processo de integração.

        • Após a finalização do processo de integração, você poderá acompanhar os movimentos que foram importados para a base do ERP (tabela PFMOVTEMP), acessando a tela Consulta movimento 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.

      ...

      defaultyes
      referencia15

      Para acessar o menu importação saldo devedor Totvs Consignado, é necessário fornecer permissão para o perfil do usuário. No RM, acesse a opção Serviços Globais > Segurança > Perfis > Sistema: Folha de pagamento.

      Image Removed

      Figura 31 - Tela de permissão para acesso a integração do saldo devedor.

      07. AVERBAÇÃO DA PARCELA

      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.

      12,13
      Totvs custom tabs box
      tabsGrupo de Eventos, Lançamento do Funcionário
      ids


      Totvs custom tabs box items
      defaultyes
      referencia12
      yes
      referencia1
      • ACESSO: Para acessar a Distribuição da margem consignável , é necessário fornecer permissão para o perfil do usuário que irá dar manutenção cadastral. No RM, acesse a opção Serviços Globais > Segurança > Perfis > Sistema > RH : Folha de Pagamento conforme imagem abaixo:

      Image Added

      Figura 06 – Liberação de Acesso no Perfil de Usuários.

      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 32 – Tela de Grupo de Eventos - Lançar eventos de integração com outros aplicativos.

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

      Image Removed

      Figura 34- Exemplo de cadastro de Eventos do Grupo

      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 35– Verba de Empréstimo importada pela integração para a folha do funcionário.

      Totvs custom tabs box items
      defaultno
      referencia13

      IMPORTANTE: Pode-se acompanhar o andamento das concessões através do  Portal - Empréstimos

      08. AVERBAÇÃO DO SALDO PARA QUITAÇÃO

      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  para desconto na rescisão, deverá ser marcado no cálculo da rescisão 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.

      ...

      tabsParâmetro da Rescisão, Lançamento do Funcionário
      ids20,21

      ...

      defaultyes
      referencia20

      Para a importação na rescisão deverá ser marcado o campo em destaque abaixo para que a integração TOTVS Consignado (arquivo PFMOVTEMP) sejam carregados no movimento  de rescisão do Funcionário para a competência em questão.

      Image Removed
      Figura 36 – Parâmetros da Rescisão

      ...

      defaultno
      referencia21

      Para verificar o lançamento da verba sado devedor na folha do funcionário, basta acessar o Envelope de Pagamento: Anexos > Movimento > Envelope de Pagamento.

      Image Removed

      Figura 37– Verba de Saldo devedor 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

      09. 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
      ids14,15
      2
      • CADASTRO DE FUNCIONÁRIOS: Será habilitado na tela de visão do cadastro de funcionários em Anexos>Folha de Pagamento a opção Distribuição da margem consignável,  conforme detalhamento dos passos a seguir:

      Image Added

      Figura 07 – Configuração da Distribuição do rateio da margem consignável.


      • Ao acessar esta opção, a tela será dividida para que você cadastre a direita os percentuais a serem aplicados conforme desejado.Image Added

      Figura 08 – Inclusão de uma Distribuição da margem consignável.

      • Ao incluir um novo registro, será apresentada a tela de edição para informar o percentual de rateio das margens. Selecione a instituição de crédito pelo botão Image Added através das opções disponibilizadas que constam habilitadas para parceria deste convênio. 
      • No campo Percentual informe o valor a ser estabelecido para apuração daquela instituição de crédito. 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 instituição de crédito.

      Image Added

       Figura 09 – 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 de forma aleatória como exemplo:

                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

      Image Added

      Figura 10 – 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 Added 

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


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

      Image Added

      Figura 12 - Exemplo da tela de configuração do evento de Margem Consignável.

      Atenção: Caso o cliente não queira customizar o valor de envio da margem customizada, o cálculo da margem a ser consumido pela instituição de crédito financeira será o valor padrão apurada com base na Remuneração Líquida da Ficha Financeira do mês anterior(competência já fechada) ao vigente(competência em aberto) aplicando o  % limite definido pela legislação neste valor.

      DICA: Para conhecer em detalhes esta funcionalidade clique aqui!


      •  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 as instituições financeiras parceiras de crédito consignado,  conforme detalhamento dos campos a seguir:
        • Operadora de Crédito: identifique aqui qual a operadora relacionada as verbas a seguir; lembrando que as verbas/eventos devem ser diferentes por instituição de crédito financeira conveniada. Somente serão listadas as instituições que foram habilitadas para a coligada.
        • 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.

      Image Added

      Figura 13 – 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:

      Image Added

      Figura 14 – Configuração dos Eventos Desconto e Base por Instituição de Crédito



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

      Image Added

      Figura 15 - Etapa do Parametrizador pertinente


      03

      ...

      defaultyes
      referencia14

      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 38 – 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 39– 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
      referencia15

      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 40– Processo de autorização e revogação de envio de dados da rescisão.

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

      ...

      . TABELAS UTILIZADAS

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

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

      ...


      04. LINKS ÚTEIS

      ...