Exibir origem

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

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

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

Parâmetros EAI: Verificar os parâmetros de integração EAI

Parâmetros EAI
Nome	Descrição	Valor
MV_EAIURL2	Endereço do WebService RM	Exemplo: http://bhd000001894:8051/EAIService/IConWSEAIService
MV_EAIWS	Nome do Client WebSevice do EAI para envio a outro EAI	WSEAISERVICE
MV_EAIUSER	Usuário para autenticação no RM.	Exemplo: mestre
MV_EAIPASS	Senha do usuário para autenticação no RM.	Exemplo: totvs
MV_EAIMETH	Método de envio do EAI para envio a outro EAI.	RECEIVEMESSAGE

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

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.

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.

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.

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