Exibir origem

Contexto de negócio (Introdução)
Sistemas Envolvidos
Integração
Escopo
Pré-requisitos instalação/ implantação
Protheus
RM
Instalação/ Atualização
Protheus
RM
Informações Trafegadas por Mensagem
Tabela Auxiliar – De/Para Afastamento – Situação
Pré-requisitos utilização / Geração das mensagens
Comum a todas transações
Funções
Verbas
Funcionários
Transferências de Funcionários
Status de Funcionários
Marcações de Ponto
Horas Trabalhadas
Custo do Funcionário
Controle de Versão
Suporte
Limitações/ Restrições Gerais
Checklist de Suporte da Aplicação

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:

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 deP onto Eletrônico (SIGAPON) são sincronizados ao ERP RM, quando solicitado.

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.

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

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

Estando o compartilhamento conforme o que é indicado para o bom funcionamento da integração pode-se seguir para o próximo passo.
Executar o configurador que ativa o pacote da integração
Caso deseje consultar as informações do adapters usados nessa intregação basta consultar aqui : Adapters Integração Folha de Pagamento_Protheus _TCOP _ Totvs Construção Obras e Projetos _Mobilidade

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

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

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

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

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>

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

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

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