Histórico da Página
...
- Contexto de negócio (Introdução) 3
- Sistemas Envolvidos 3
- Integração 3
- Escopo 3
- Pré-requisitos instalação/ implantação 4
- Instalação/ Atualização 4
- Informações Trafegadas por Mensagem 8
- Tabela Auxiliar – De/Para Afastamento – Situação 13
- Pré-requisitos utilização / Geração das mensagens 14
- Controle de Versão 15
- Suporte 15
- Limitações/ Restrições Gerais 15
- Checklist de Suporte da Aplicação 15
1. Contexto de negócio (Introdução)
Com o objetivo de integrar os controles de
...
Ponto e
...
Folha dos
...
Funcionários, que é realizado no ERP 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 ERP RM – TOTVS Obras e Projetos para acesso a informações de ponto e folha de pagamento do modulo de Mobilidade.
- Sistema ERP 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).
4. 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:
- Funcionários;
- Verbas;
- Funções;
- Transferências;
- Marcações de Ponto;
- 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 de
Ponto Eletrônico (SIGAPON) são sincronizados ao ERP RM, quando solicitado.
5. Pré-requisitos instalação/ implantação
Este documento reúne informações relevantes sobre a Integração do TOTVS Folha Pagamento x Mobilidade do RM e Gestão de Pessoal Protheus. A integração respeita todos os requisitos definidos pelas linhas de produto TOTVS envolvidos.
Os produtos envolvidos utilizam o modelo de licenciamento padrão (License Server). Para pleno funcionamento, as licenças devem ser providenciadas junto à TOTVS, com antecedência.
...
Esta integração está de acordo com as boas práticas recomendadas pelo Comitê de Integração TOTVS e utiliza a arquitetura Mensagem Única e comunicação via WebServices.
...
Adapters Protheus:
...
Acesse o ambiente Configurador (SIGACFG) / Ambiente / Schedule / Adapter E.A.I (CFGA020).
a) Cadastro de Funcionários
Mensagem única: Sim
Rotina: GPEA010
Mensagem: EMPLOYEE
Descrição: Cadastro de Funcionários
Envia: Sim
Recebe: Não
Método: Síncrono
Operações: Todas
Canal Envio: EAI
Versão: 2.003
- Cadastre os (9) Adapters no Protheus do Projeto RM, conforme as informações abaixo. Acesse o ambiente Configurador (SIGACFG) / Ambiente / Schedule / Adapter E.A.I (CFGA020).
...
b) Cadastro de Funções
Mensagem única: Sim
Rotina:
...
GPEA030
Mensagem: ROLE
Descrição: Cadastro de Funções
Envia: Sim
Recebe: Não
Método: Síncrono
Operações: Todas
Canal Envio: EAI
Versão: 1.000
c) Cadastro de Verbas
Mensagem única: Sim
Rotina: GPEA040
Mensagem: PAYROLLAMOUNT
Descrição: Cadastro de Verbas
Envia: Sim
Recebe: Não
Método: Síncrono
Operações: Todas
Canal Envio: EAI
d) Transferência de Funcionários
Mensagem única: Sim
Rotina: GPEA180
Mensagem: SETEMPLOYEEBRANCHTRANFER
Descrição: Transferência de Funcionários
Envia: Sim
Recebe: Não
Método: Síncrono
Operações: Todas
Canal Envio: EAI
Versão: 1.000
e) Folha de Ponto
Mensagem única: Sim
Rotina: PONM040
Mensagem: GETEMPLOYEETIMESHEET
Descrição: Folha de Ponto
Envia: Não
Recebe: Sim
Método: Síncrono
Versão 4.1 | 5 |
Operações: todas
Canal Envio: EAI
Versão: 1.000
f) Horas Trabalhadas
Mensagem única: Sim
Rotina: PONXFUN2
Mensagem: GETEMPLOYEEWORKEDHORS
Descrição: Horas Trabalhadas
Envia: Não
Recebe: Sim
Método: Síncrono
Operações: Todas
Canal Envio: EAI
Versão: 1.000
g) Custo do Funcionário
Mensagem única: Sim
Rotina: GPEXCAL2
Mensagem: GETEMPLOYEECOST
Descrição: Custo do Funcionário
Envia: Não
Recebe: Sim
Método: Síncrono
Operações: todas
Canal Envio: EAI
Versão: 1.000
h) Status de Funcionário
Mensagem única: Sim
Rotina: GPEA240
Mensagem: GETEMPLOYEESITUATIONS
Descrição: Status do Funcionário
Envia: Não
Recebe: Sim
Método: Síncrono
Operações: todas
Canal Envio: EAI
Versão: 1.000
...
- Configure os parâmetros do EAI no configurador do Protheus.
...
- é-requisitos utilização / Geração das mensagens 9.1. Comum a todas transações
...
9.2. 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.
9.3. 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.
9.4. 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.
9.5. 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.
9.6. 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.
9.7. 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.
9.8. Horas Trabalhadas
7. Informações Trafegadas por Mensagem
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.
9.9. 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.
Controle de Versão
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.
11. Suporte
O suporte aos recursos da Integração será de responsabilidade de todas as linhas. Sendo assim, as equipes de suporte dos produtos RH RM e Gestão de Pessoal Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.
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.
Checklist de Suporte da Aplicação
Checklist de Verificações:
- Configuração e teste do WebService;
- Configuração do Schedule;
- Configuração do EAI, parâmetros MV_EAIURL2, MV_EAIWS, MV_EAIUSER, MV_EAIPASS;
- Cadastro dos ADAPTERS das Mensagens Únicas
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 | ||||||||||
- | - | PPESSOA | ||||||||||||
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 | ||||||||||
DateInitialShiftSequence | - | - | PFHSTHOR | DTMUDANCA |
PositionCode | SRA | RA_CARGO | PFUNCAO | CARGO |
CompanyId | CODCOLIGADA | |||
PositionCodeInternalId | BranchId | PFUNCAO | ||
CARGO | ||||
PositionCode | ||||
EmployeeSituation | SRA | RA_SITFOLH | PFUNC | CODSITUACAO |
GovernmentalInformation | SRA | RA_CIC | PPESSOA | CPF |
GovernmentalInformation | SRA | RA_SECP | ||
GovernmentalInformation | SRA | RA_NUMCP | ||
Cadastro de Funções
Mensagem Padrão | PROTHEUS | RM | ||||||||||||
Tabela | Campo | Tabela | Campo | |||||||||||
CompanyId | SRJ | RJ_FILIAL | PFUNCAO | CODCOLIGADA | ||||||||||
BranchId | SRJ | RJ_FILIAL | PFUNCAO | - | ||||||||||
Code | SRJ | RJ_FUNCAO | PFUNCAO | CODIGO | ||||||||||
Description | SRJ | RJ_DESC | PFUNCAO | NOME | ||||||||||
Cadastro de Verbas
Mensagem Padrão | PROTHEUS | RM | |||||||||||||||
Tabela | Campo | Tabela | Campo | ||||||||||||||
CompanyId | SRV | RV_FILIAL | PEVENTO | CODCOLIGADA | |||||||||||||
BranchId | SRV | RV_FILIAL | PEVENTO | - | |||||||||||||
CompanyInternalId | - | CompanyId | BranchId | PEVENTO | CODCOLIGADA | ||||||||||||
Code | SRV | RV_COD | PEVENTO | CODIGO | |||||||||||||
InternalId | - | CompanyId | BranchId | Code | PEVENTO | CODCOLIGADA | CODIGO | ||||||||||
Description | SRV | RV_DESC | PEVENTO | DESCRICAO | |||||||||||||
FundingAmountType | SRV | RV_TIPO | PEVENTO | VALHORDIAREF | |||||||||||||
FundCodeType | SRV | RV_TIPOCOD | PEVENTO | PROVDESCBASE | |||||||||||||
Transferência de Funcionários
Mensagem Padrão | PROTHEUS | RM | ||||||||
Tabela | Campo | Tabela | Campo | |||||||
CompanyId | SRE | RE_FILIAL | PFUNC | CODCOLIGADA | ||||||
BranchId | SRE | RE_FILIAL | PFUNC | CODFILIAL | ||||||
CompanyInternalId | - | CompanyId | BranchId | - | - | |||||
TransferDate | SRE | RE_DATA | PFUNC | DATAADMISSAO | ||||||
EmployeeInternalId | SRE | RE_FILIAL + RE _MAT | - | - | ||||||
Code | SRE | RE _MAT | PFUNC | CHAPA | ||||||
Versão 4.1 | 9 |
DepartamentCode | SRE | RE_DEPTOP | - | - |
DepartamentInternalId | SQB | QB_FILIAL + | - | - |
QB_DEPTO | ||||
CostCenterCode | SRE | RE_CCP | PSECAO | NROCENCUSTOCONT |
CostCenterInternalId | CTT | CTT_FILIAL | - | - |
+CTT_CUSTO | ||||
CompanyId | ||||
BranchId | ||||
CompanyInternalId | ||||
EmployeeInternalId | ||||
EmployeeTransferring | – | Code | PFUNC | - |
DepartamentCode | ||||
DepartamentInternalId | ||||
CostCenterCode | ||||
CostCenterInternalId | ||||
CompanyId | ||||
BranchId | ||||
CompanyInternalId | ||||
EmployeeInternalId | ||||
EmployeeTransfered | - | Code | PFUNC | - |
DepartamentCode | ||||
DepartamentInternalId | ||||
CostCenterCode | ||||
CostCenterInternalId | ||||
Custo do Funcionário
Mensagem Padrão | PROTHEUS | RM | ||||||||||||
Tabela | Campo | Tabela | Campo | |||||||||||
CompanyId | SRD | RD_FILIAL | MPRJ | CODCOLIGADA | ||||||||||
BranchId | SRD | RD_FILIAL | MPRJ | CODFILIAL | ||||||||||
Contry | - | BRA | - | BRA | ||||||||||
StartDate | - | - | - | - | ||||||||||
EndDate | - | - | - | - | ||||||||||
EmployeeInternalId | SRD | RD_MAT | PFUNC | CHAPA | ||||||||||
ListOfEmployee | - | EmployeeInternalID | - | - | ||||||||||
ListOfFounds | SRD | RD_PD | MPRJEVENTOVERBA | CODIGO | ||||||||||
Calculado a partir | ||||||||||||||
CostOfEmployee | - | das verbas e do | - | - | ||||||||||
período informado. | ||||||||||||||
Horas Trabalhadas
Mensagem Padrão | PROTHEUS | RM | |||||||||||||
Tabela | Campo | Tabela | Campo | ||||||||||||
CompanyId | SRA | RA_FILIAL | MPRJ | CODCOLIGADA | |||||||||||
BranchId | SRA | RA_FILIAL | MPRJ | CODFILIAL | |||||||||||
CompanyInternalId | - | CompanyId | BranchId | - | - | ||||||||||
StardDate | - | Informado como parâmetro na requisição | - | - | |||||||||||
FinishDate | - | Informado como parâmetro na requisição | - | - | |||||||||||
ListOfEmployee | <List> | <List> | <List> | <List> | |||||||||||
<ListOfEmployee>
Mensagem Padrão | PROTHEUS | RM | ||||||
Tabela | Campo | Tabela | Campo | |||||
EmployeeCode | SRA | RA_MAT | PFUNC | CHAPA | ||||
EmployeeInternadlD | - | CompanyId + BranchID + EmployeeCode | - | - | ||||
WorkedHours | - | Horas Trabalhadas no período solicitado | - | - | ||||
AbsenceHours | - | Horas de Ausência no período solicitado | - | - | ||||
Folha de Ponto – Marcações |
Mensagem Padrão | PROTHEUS | RM | |||||||||||||
Tabela | Campo | Tabela | Campo | ||||||||||||
CompanyId | SRA | RA_FILIAL | MPRJ | CODCOLIGADA | |||||||||||
BranchId | SRA | RA_FILIAL | MPRJ | CODFILIAL | |||||||||||
CompanyInternalId | - | CompanyId | BranchId | - | - | ||||||||||
TimeSheetStardDate | - | Informado como parâmetro na requisição | - | - | |||||||||||
TimeSheetFinishDate | - | Informado como parâmetro na requisição | - | - | |||||||||||
ListOfEmployeeTimeSheet | <List> | <List> | <List> | <List> | |||||||||||
<ListOfEmployeeTimeSheet>
Mensagem Padrão | PROTHEUS | RM | ||||||||||||
Tabela | Campo | Tabela | Campo | |||||||||||
CompanyId | SRA | RA_FILIAL | MHISTHORASTRABALHO | CODCOLIGADA | ||||||||||
BranchId | SRA | RA_FILIAL | - | - | ||||||||||
EmployeeCode | SRA | RA_MAT | MHISTHORASTRABALHO | CHAPA | ||||||||||
EmployeeInternadlD | - | CompanyId + BranchID + EmployeeCode | - | - | ||||||||||
ListOfTimeSheet | <List> | <List> | <List> | <List> | ||||||||||
Tabela | Campo | Tabela | Campo | |
EvenDate | SPG / SP8 | PG_DATA / P8_DATA | MHISTHORASTRABALHO | DATA |
ListOfInOutTime | <List> | <List> | <List> | <List> |
<ListOfInOutTime>
Mensagem Padrão | PROTHEUS | RM | ||||||||||||
Tabela | Campo | Tabela | Campo | |||||||||||
RegisterTime | SPG / SP8 | PG_HORA / P8_HORA | MHISTHORASTRABALHO | DATA | ||||||||||
RegisterType | SPG / SP8 | PG_TPMARCA / P8_TPMARCA | MHISTHORASTRABALHO | NATUREZA | ||||||||||
Order | SPG / SP8 | PG_TURNO / P8_TURNO | ||||||||||||
Status do Funcionário
Mensagem Padrão | PROTHEUS | RM | ||||||
Tabela | Campo | Tabela | Campo | |||||
CompanyId | SRA | RA_FILIAL | PFUNC | CODCOLIGADA | ||||
BranchId | SRA | RA_FILIAL | PFUNC | CODFILIAL | ||||
InternalId | - | CompanyId | BranchId | - | - | |||
EmployeeCode | SRA | RA_MAT | PFUNC | CHAPA | ||||
WorkCenterCode | SRA | RA_CC | - | - | ||||
SiteCode | - | - | - | - | ||||
ListOfSituation | <List> | <List> | <List> | <List> | ||||
<ListOfSituation>
Mensagem Padrão | PROTHEUS | RM | ||||||
Tabela | Campo | Tabela | Campo | |||||
CommencementDate | SR8 | R8_DATAINI | - | - | ||||
SituationLastDay | SR8 | R8_DATAFIM | - | - | ||||
INSSPaymentCommencement | - | - | - | - | ||||
OriginSituation | - | 2 | - | - | ||||
SituationDay | SR8 | R8_DURACAO | - | - | ||||
SituationTime | - | - | - | - | ||||
SituationScheduleEnd | - | - | - | - | ||||
CIDCode | - | - | - | - | ||||
CommencementSchedule | - | - | - | - | ||||
SituationInformation | <List> | <List> | <List> | <List> | ||||
<SituationInformation>
Mensagem Padrão | PROTHEUS | RM | ||||||||||||
Tabela | Campo | Tabela | Campo | |||||||||||
SituationCode | SR8 | R8_TIPO | PFUNC | CODSITUACAO | ||||||||||
SituationMeaning | - | Conforme Tabela Abaixo | - | - |
AbsenteeismType | SP2 | Conforme Tabela Abaixo | - | - |
8. Tabela Auxiliar – De/Para Afastamento – Situação
Protheus | De Para | RM | |||
Tabela SRA -> | |||||
SituationMeaning | Significado da Situação | RA_SITFOLH | Tabela PCODSITUACAO | ||
enumeration | Código | CODINTERNO | DESCRICAO | ||
1 | Trabalhando | A | Ativo | ||
2 | Afastado | A | |||
3 | Entrada Transferência | ||||
4 | Saída Transferência | D | |||
5 | Férias | F | F | Férias | |
6 | Rescisão Contrato | D | D | Demitido | |
7 | Falta Injustificada | ||||
8 | Jornada Incompleta | ||||
9 | Ausência Justificada | ||||
10 | Contrato Desativado | D | C | Contrato de Trabalho Suspenso | |
AbsenteeismType | Tipo do Afastamento | ||||
Tabela SR8 -> Campo | |||||
enumeration | R8_TIPO | ||||
1 | Ausência | ||||
2 | Doença | P | O | Doença Ocupacional | |
3 | Acidente | O | |||
4 | Maternidade | Q,B,6,7 | E | Licença Mater. | |
5 | Paternidade | ||||
6 | Serviço Militar | R | M | Serv.Militar | |
7 | Licença Remunerada | 8 | R | Licença Remun. | |
8 | Licença não Remunerada | X | |||
1 | I | Apos. Invalidez | |||
P | Af.Previdência | ||||
W | S | Mandato Sindical | |||
T | Af.Ac.Trabalho | ||||
Y | U | Outros | |||
V | Aviso Prévio | ||||
W | Licença Mater. Compl. 180 dias | ||||
X | C/Dem.no mês | ||||
Z | Admissão prox.mês | ||||
Versão 4.1 | 13 |