Integrações

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

Versões comparadas

Versão antiga 11

changes.mady.by.user Elis Regina Ferreira Dos Santos

Gravado em

comparado com

Nova versão 12

changes.mady.by.user Elis Regina Ferreira Dos Santos

Gravado em

Chave

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

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.

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.

Informações
titleImportante

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

Sumário                                                                                                                                                                

...

Informações

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.

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.

Informações
titleImportante

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

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

A versão minima RM  exigida é 12.1.28 ou Superior

Aversão minima Protheus exigida é 12.1.25 (Lobo Guará) 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.

...

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 _Mobilidade

Nota
titleAtençã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
  • 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
Nota
titleAtençã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,


 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.

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

...


O grupo TOTVS, representado por suas marcas, administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes, o prazo de liberação de release.
Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento. Elas somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.
Limitações/ Restrições Gerais

  • Cadastro de Funcionários:

...

definidas pelo Comitê de Integração TOTVS.


Limitações/ Restrições Gerais

  • Cadastro de Funcionários:

Checklist de Suporte da Aplicação
Checklist de Verificações: Não se esqueça de garantir que essas configurções estejam feitas para o funcionamento correto da integração

...

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.





Cadastro de Funcionários


Mensagem Padrão




PROTHEUS






RM























Tabela



Campo



Tabela



Campo


















CompanyId



SRA



RA_FILIAL



PFUNC



CODCOLIGADA


















BranchId



SRA



RA_FILIAL



PFUNC



CODFILIAL


















CompanyInternalId


-




CompanyId



PFUNC



CODCOLIGADA









BranchId






CODFILIAL

































Code



SRA



RA_MAT



PFUNC



CHAPA
























CompanyId






CODCOLIGADA



InternalId


-




BranchId



PFUNC


















CHAPA









Code







































FullNasme



SRA



RA_NOMECMP



PFUNC



NOME


















Name



SRA



RA_NOME



PFUNC



NOME


















DepartamentCode



SRA



RA_DEPTO



PSECAO



CODDEPTO


















DepartamentInternalId


-



-



-



-



















RoleCode



SRA



RA_CODFUNC



PFUNC



CODFUNCAO







































CompanyId






CODCOLIGADA



RoleInternalId


-




BranchId



PFUNC


















CODFUNCAO









RoleCode







































HiringDate



SRA



RA_ADMISSA



PFUNC



DATAADMISSAO


















WorhShiftCode



SRA



RA_TNOTRAB



PFUNC



CODHORARIO







































CompanyId






CODCOLIGADA



WorkShiftInternalId


-




BranchId



PFUNC


















CODHORARIO









WorhShiftCode







































SalaryCategory



SRA



RA_CATFUNC



PFUNC



CODRECEBIMENTO

































Salary


-



-




PFUNC



SALARIO

































DemissionDate



SRA



RA_DEMISSA



PFUNC



DATADEMISSAO

































CostCenterCode



SRA



RA_CC



PSECAO



NROCENCUSTOCONT







































CompanyId






CODCOLIGADA



CostCenterInternalId


-




BranchId



PSECAO


















NROCENCUSTOCONT









CostCenterCode







































BirthDate



SRA



RA_NASC



PPESSOA



DTNASCIMENTO


















Gender



SRA



RA_SEXO



PPESSOA



SEXO


















HomeState



SRA



RA_NATURAL



PPESSOA



ESTADONATAL


















NaturalCity


-



-




PPESSOA



NATURALIDADE


















Email


-



-




PPESSOA



EMAIL


















EmployeeSituation



SRA



RA_SITFOLH
























MonthlyWorkingHours


-



-




PFUNC



JORNADAMENSAL
























RA_TABELA






CODTABELASALARIAL



WageTableInternalId



SRA



RA_NIVEL



PFUNC



CODNIVELSAL









RA_FAIXA






GRUPOSALARIAL


















WorkShiftSequence



SRA



RA_SEQTURN



PFHSTHOR



INDINICIOHOR

















...