Páginas filhas
  • DI_MANUAL_TOTVS_Folha de Pagamento - Protheus x Mobilidade (App Minha Obra) (TCOP -Totvs Construção Obras e Projetos)

Contexto do Negócio

Com o objetivo de integrar os controles de Ponto e Folha dos Funcionários, que é realizado no RM com a Gestão de Pessoal do ERP Protheus, 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.

Sistemas Envolvidos

  • Sistema RM – TOTVS 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.

Integração

A integração dos módulos SIGAGPE e SIGAPON do ERP Protheus com ERP 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 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).

Escopo

A integração TOTVS Folha 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.

Importante

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

Atenção

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

  • Compartilhamento de tabelas: Estando o compartilhamento conforme o que é indicado para o bom funcionamento da integração pode-se seguir para o próximo passo.
  • Agent/Agendamento: Verificar se o agent e agendamento no Protheus esta devidamente configurado 1 - CONFIGURAÇÃO#-1254809030
  • Webservice: Verificar se os serviços de webservice estao devidamente configurados.Configurando o webservice : Como Expor os Web Services do RM através do Host (recomendado)
  • Configurador: Executar o configurador que ativa o pacote 1006 da integração Configurador EAI 2.0 - RM x PROTHEUS
  • Adapters: Caso deseje consultar as informações do adapters usados nessa intregação basta consultar aqui : Folha Pagamento Protheus_Mobilidade RM
  • Campos integrados mapeados: Cada mensagem trafegada nessa integração possui campos mapeados informando quais serão considerados na integração.
  • E importante avaliar se ultiliza algum campo diferente como obrigatório pois esse comportamento poderá inviabilizar o funcionamento da integração. EAI2 - Campos mapeados nas mensagens integradas Detalhamento - Campos Integrados
  • Parâmetros EAI: Verificar os parâmetros de integração EAI 

    Parâmetros EAI
    NomeDescriçãoValor
    MV_EAIURL2Endereço do WebService RMExemplo: http://bhd000001894:8051/EAIService/IConWSEAIService                                                                                                                                                     
    MV_EAIWSNome do Client WebSevice do EAI para envio a outro EAIWSEAISERVICE
    MV_EAIUSERUsuário para autenticação no RM.Exemplo: mestre
    MV_EAIPASSSenha do usuário para autenticação no RM.Exemplo: totvs
    MV_EAIMETHMétodo de envio do EAI para envio a outro EAI.RECEIVEMESSAGE
    FOP_PERMITEINFORMARMATRICULA

    Para concatenar a chapa do funcionário e retornar a filial e a matrícula do Protheus,

    Exemplo: 1;345657.

    ATENÇÃO: Este parâmetro é essencial para tratar com a diferença entre os sistemas: no Protheus, é permitido ter chapas iguais entre filiais, enquanto no RM não é.

    Orientações de criação do parâmetro de integração

    • Coligada: 0
    • Nome do parâmetro:  FOL_PERMITEINFORMARMATRICULA
    • Tipo: Lógico



Limitações/ Restrições Gerais

  • Cadastro de Funcionários:

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.





  • Sem rótulos