Histórico da Página
...
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
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. Escopo A integração TOTVS Folha Pagamento x Mobilidade atuará nas áreas de controle de ponto e gestão de pessoal. Os processos integrados serão:
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 | ||
---|---|---|
| ||
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. |
...
Nota | ||
---|---|---|
| ||
* 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 Configurador EAI 2.0 - RM x PROTHEUS
- Caso deseje consultar as informações do adapters usados nessa intregação basta consultar aqui : Folha Pagamento Protheus_Mobilidade RM
...
Funções 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 Marcações de Ponto 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
|
...
- 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
- 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
...
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
...
Mensagem Padrão
...
PROTHEUS
...
RM
...
Tabela
...
Campo
...
Tabela
...
Campo
...
CompanyId
...
SRJ
...
RJ_FILIAL
...
PFUNCAO
...
CODCOLIGADA
Informações | ||
---|---|---|
| ||
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
Nota | ||
---|---|---|
| ||
* 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 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 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:
...
BranchId
...
SRJ
...
RJ_FILIAL
...
PFUNCAO
...
-
...
Code
...
SRJ
...
RJ_FUNCAO
...
PFUNCAO
...
CODIGO
...
Description
...
SRJ
...
RJ_DESC
...
PFUNCAO
...
NOME
...
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
...
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
...
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>
...
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>
...
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>
...
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
...
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>
...
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>
...
Mensagem Padrão
...
PROTHEUS
...
RM
...
Tabela
...
Campo
...
Tabela
...
Campo
...
SituationCode
...
SR8
...
R8_TIPO
...
PFUNC
...
CODSITUACAO
...
SituationMeaning
...
-
...
Conforme Tabela Abaixo
...
-
...
-
...
AbsenteeismType
...
SP2
...
Conforme Tabela Abaixo
...
-
...
-
...
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
...
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.