Contexto do Negócio e da Integração

Com o objetivo de integrar os controles de Ponto e Folha dos Funcionários, que é realizado no Protheus com o TOTVS Construção Obras e Projetos, foi desenvolvida a integração por mensagem única entre Protheus e RM, ambos comercializados pela TOTVS.

Para a integração Protheus com o sistema RM, é necessária a utilização do Enterprise Application Integration (EAI). Desta forma, os sistemas se comunicam através de uma mensagem única, utilizando XSD´s pré-aprovados de acordo com as regras de mensageria padrão definidas pela TOTVS.

A integração dos módulos SIGAGPE e SIGAPON do Protheus com RM foi implementada com o objetivo de melhorar a gestão e facilitar alguns processos, para atender aos clientes que possuem o modulo de Mobilidade do Totvs Construção Obras e Projetos da RM e outros módulos que utilizam informações do RH implantados no Protheus.
No RM a integração responsável pelo o sincronismo das informações é a Totvs Folha Pagamento x Mobilidade (1006).

Sistemas Envolvidos

  • Sistema RM – Totvs Construção Obras e Projetos para acesso a informações de ponto e folha de pagamento do modulo de Mobilidade.
  • Sistema Protheus – as funcionalidades utilizadas estão contidas no módulo SIGAGPE (Gestão de Pessoal): funcionários, verbas, funções, transferências e marcações de ponto.

Escopo

A integração TotvsFolha Pagamento x Mobilidade atuará nas áreas de controle de ponto e gestão de pessoal.
As informações serão enviadas no formato XML via EAI/WebService entre os ERPs RM e Protheus, utilizando os dados trafegados nas mensagens para as operações.
Cada mensagem XML possuirá um cabeçalho, que diferenciará a rotina utilizada, por isso a importância do correto cadastramento de ADAPTERS na base de dados do Protheus e a ativação da integração TOTVS Folha Pagamento x Mobilidade no RM.

Os processos integrados serão:

  1. Funcionários;
  2. Verbas;
  3. Funções;
  4. Transferências;
  5. Marcações de Ponto;
  6. Lançamentos Acumulados.

Funções
Ao efetuar a manutenção (inclusão/alteração/exclusão) de funções no Protheus, as respectivas informações serão enviadas para o RM através de mensagem única.

 Verbas
Ao efetuar a manutenção (inclusão/alteração/exclusão) de verbas no Protheus, as respectivas informações serão enviadas para o RM através de mensagem única.

 Funcionários
Para o envio do cadastro de Funcionários, é necessário que o ERP RM já tenha feito o envio dos cadastros de Turno de Trabalho, Horário Padrão, Cargo, Função e Centro de Custo.

Os cadastros de funcionários, verbas, funções são realizados exclusivamente no módulo Gestão de Pessoal (SIGAGPE).

No RM para estes cadastros deve existir somente permissão para consulta. As informações de custo do funcionário e deP onto Eletrônico (SIGAPON) são sincronizados ao ERP RM, quando solicitado.

Transferências de Funcionários
Ao efetuar a transferência de funcionários no Protheus, as respectivas informações serão enviadas para o RM através de mensagem única.

Status de Funcionários
A mensagem de Status de Funcionários é disparada através de uma solicitação feita pelo ERP RM, são geradas informações de todos os funcionários que possuem afastamento, férias, rescisão ou transferência no período solicitado.

 Marcações de Ponto
A mensagem de Marcações de Ponto é disparada através de uma solicitação feita pelo ERP RM, são geradas informações de todos os funcionários que possuem marcações e apontamentos no período solicitado.

Horas Trabalhadas

A mensagem de Horas Trabalhadas é disparada através de uma solicitação feita pelo ERP RM, são geradas informações de todos os funcionários que possuem marcações e apontamentos no período solicitado.

Custo do Funcionário
A mensagem de Custo de Funcionários é disparada através de uma solicitação feita pelo ERP RM, são geradas informações de todos os funcionários que possuem folha de pagamento calculada e fechada no período solicitado.
Para que seja possível efetuar o cálculo do custo do funcionário, as verbas que foram informadas na solicitação feita pelo ERP RM deverão estar configuradas com o campo Agrega Custo ao Projeto (RV_CUSTEMP)

    • "Sim", caso contrário não serão consideradas. Esta configuração é efetuada no Protheus por meio da rotina Cadastro de Verbas, aba Incidências.

Pré-requisitos instalação/ implantação

Ter o Protheus instalado e configurado

Ter o RM instalado e configurado

Os produtos envolvidos utilizam o modelo de licenciamento padrão (License Server).

1.1.   Pré-requisitos Linha Protheus

Utilizar a versão 12.1.33 ou superior

Os WebServices exigem uma licença específica “TOTVS I”

1.2.   Pré-requisitos Linha RM

Utilizar a versão 12.1.2209 ou superior.

É imprescindivel realizar uma analise de compatibilidade do cliente nos niveis de compatibilidade das tabelas usadas na integração.

Caso possua customizações também é importante verificar pois pode inviabilizar o funcionamento adequado da integração.


Passos importantes para configurar a integração Folha de Pagamento -Protheus _TCOP - Totvs Construção Obras e Projetos

* Antes de tudo é importante verificar o nível de compartilhamento das tabelas utilizadas nessa integração se estão de acordo com o padrão de compatibilidade da integração. Saiba mais,

Limitações/ Restrições Gerais

O ERP RM possui uma função que não surtirá efeito no Protheus, que é a alteração de matrícula. Caso essa operação seja realizada no ERP RM, os dados no Protheus não sofrerão qualquer tipo de alteração.