Introdução
Além da integração com vários módulos do backoffice e com o Gestão de Pessoal da linha Protheus, o módulo de Gestão de Serviços está preparado para integrar-se com as mais diversas ferramentas de Gestão de Recursos Humanos e Gestão de Pessoal disponíveis no mercado, utilizando o que há de mais recente no quesito de tecnologias e de práticas de mercado.
O objetivo desta documentação é demonstrar como configurar a integração entre o módulo Gestão de Serviços e o RH da linha RM, além de detalhar pontos relevantes e as funcionalidades da integração.
Pré-requisitos
- Gestão de Serviços na versão 12.1.23 ou superior;
- Webservice (wsDataServer/IwsDataServer) configurado no RM;
- Parâmetro MV_GSOUT com o valor 1;
- Parâmetro MV_GSXINT com o valor 3;
- Parâmetro MV_GSURLIN com a URL do webservice do RM ( por exemplo, http://<ip/hostname>:<porta>. Não é necessário informar wsDataServer/IwsDataServer neste parâmetro);
- Parâmetro MV_GSUSRIN preenchido com o usuário RM utilizado na autenticação dos webservices (por exemplo, "mestre")
- Parâmetro MV_GSPWDIN preenchido com a senha do usuário RM informado no parâmetro MV_GSUSRIN;
- Parâmetro MV_TECXRH desligado (.F.);
- Fonte TECWSDLRM.prw compilado no RPO. Fontes TECXFUNB.PRW / TECA960.PRW na versão 13/08/2019 ou superior. Fonte TECA012.PRW na versão 12/08/2019 ou superior.
- Mensagem Única (EAI) configurada entre RM e Protheus. É necessário realizar a integração e o De/Para dos dados de Centro de Custo e Verbas;
- Cadastro de De/Para para Empresa/Filial entre as empresas RM e Protheus (APCFG050);
- Tabela TXB configurada no dicionários de dados (SX2 / SX3 / SX7 ) e criada no ambiente;
- O campo AA1_CDFUNC, na tabela de Atendentes deve possuir o mesmo tamanho (X3_TAMANHO) que o campo "Chapa" no RM.
Utilização
O Gestão de Serviços consome diretamente os dados do RM, sem a necessidade de configurar o RH da linha Protheus como intermediário.
O Gestão de Serviços RECEBE as seguintes informações do RM:
- Funcionários
- Afastamentos / Férias / Demissão
O Gestão de Serviços ENVIA as seguintes informações para o RM:
- Rateio por Centro de Custo (Rateio Fixo)
- Lançamentos diretos na folha (Verbas)
O Gestão de Serviços GERA o arquivo texto (txt) com as batidas de ponto, de acordo com o operacional do módulo.
Comparativo: Integração RH Protheus x Integração RH RM
Funcionalidade | RH Protheus | RH RM |
---|---|---|
Projeção de agenda integrada com eventos de RH (Afastamento, férias, demissão) | Integrado nativamente, no momento da projeção da agenda | RH RM envia informações referentes aos afastamentos através de um web service. Após este envio, as projeções do Prestadores de Serviços consideram as restrições. Caso o envio ocorra depois das projeções, os conflitos podem ser consultados na rotina de Conflitos de Alocação |
Integração com o Envio de Marcações Eletrônicas | Integrado nativamente, podendo ser enviado através da mesa operacional. As marcações também podem ser obtidas do relógio de ponto (REP) ou aplicativos mobile, como Carol Clock-in e o app Meu RH. Neste caso, a Mesa Operacional é atualizada com as informações do ponto (não há necessidade de enviar informação de ponto da mesa para o RH) | O sistema Prestadores de Serviços gera um arquivo texto, com a relação de dia e horário de cada atendente, que pode ser importado no RH RM para geração das marcações |
Integração com Benefícios | Possível vincular benefícios em três entidades do GS para o cálculo: Cliente, Posto ou Local de Atendimento. O cálculo é integrado nativamente, consultando possíveis eventos operacionais (faltas, atrasos, hora extra) para o pagamento. | Não integrado. |
Integração com periculosidade e insalubridade | No Orçamento de Serviços, é possível informar se um posto (TFF) possui insalubridade ou periculosidade. Possível utilizar a funcionalidade de envio de periculosidade e insalubridade, para gerar o evento na folha do atendente, já proporcionalizado de acordo com a alocação (Envio de Adicional de Periculosidade / Insalubridade - TECA353 - Gestão de Serviços - P12) | Não integrado |
Integração com o calendário / Turno do atendente | Integração nativa. Ao alocar um atendente cadastrado como 5x2 em um posto 12x36, o sistema monta automaticamente a projeção da agenda no padrão 12x36, no momento do apontamento das marcações, para calculo dos eventos da folha. | Durante a geração do arquivo texto para importação das marcações, o sistema Prestadores de Serviços envia através de um web service uma possível troca de turno do atendente, caso encontre uma diferença entre o turno cadastrado no funcionário e o turno alocado na Mesa Operacional. |
Envio do Rateio por Centro de Custo | Os CCs são proporcionalizados conforme alocação e enviados através da rotina de Envio de Programação de Rateio (Programação de rateio - TECA960 - Gestão de Serviços - P12) | Os CCs são proporcionalizados conforme alocação e enviados através da rotina de Envio de Programação de Rateio (Programação de rateio - TECA960 - Gestão de Serviços - P12). Necessário configurar a Mensagem Única de Centro de Custo, para que as informações entre os dois sistemas sejam equivalentes |
Envio de Verbas Adicionais | As verbas configuradas no Orçamento de Serviços podem ser enviadas para a folha do atendente, conforme alocações. O envio é realizado através da rotina de Gravação de Benefícios para o RH (Geração de Benefícios para RH - TECA351 - Gestão de Serviços - P12) | As verbas configuradas no Orçamento de Serviços podem ser enviadas para a folha do atendente, conforme alocações. O envio é realizado através da rotina de Gravação de Benefícios para o RH (Geração de Benefícios para RH - TECA351 - Gestão de Serviços - P12). Necessário configurar a Mensagem Única de cadastro de Verbas, para que as informações entre os dois sistemas sejam equivalentes |
Na rotina de "Cadastro de Atendentes", acessar a opção "Outras Ações" e "Importação de Funcionários":
O sistema consultará os funcionários do sistema RM para gerar os atendentes:
Ao selecionar a opção "+ Gerar", o sistema cadastrará os atendentes:
Na rotina de "Restrições", acessar a opção "Outras Ações" e "Importação de Restrições":
Esta Opção também esta disponível em "Outras Ações" dentro de cada atendente, para importação individual.
O sistema exibirá a seguinte tela com opções de importação:
Ao escolher a opção "Selecionar Atendentes", o sistema apresentará uma próxima janela com opções de seleção de todos os atendentes (tabela AA1):
Após escolher selecionar os atendentes ou "importa Todos", o sistema consultará o RM através dos WebServices para cadastrar os Afastamentos / Demissões e Férias:
Após importar, o registro será incluído na tabela TXB:
Terminado a inclusão, o sistema exibirá um log de processamento:
Registros incluídos:
Para maiores informações sobre o afastamento, visualize o campo "Observação"(memo):
Um funcionário pode ser alocado, durante a mesma competência da folha de pagamento, em vários clientes/locais de atendimento. Neste cenário, é comum que cada Local de Atendimento represente um Centro de Custo diferente. O envio do rateio por centro de custo atende a necessidade de proporcionalizar o centro de custo do funcionário de acordo com a quantidade de horas trabalhadas em cada local de atendimento. As imagens abaixo demonstram como essa funcionalidade pode ser utilizada:
O atendente de código TEC01900001139 trabalhou em dois Locais de Atendimento: TOTVS - SANTO ANDRE e TOTVS - MATRIZ:
Cada um destes locais possui um Centro de Custo diferente. O centro de custo da TOTVS - MATRIZ é o 000000001. O centro de custo da TOTVS - SANTO ANDRE é o CC0000001:
É necessário verificar se no cadastro de De/Para de Centro de Custos entre RM e Protheus possuí os dois códigos:
De acordo com o cadastro de De/Para, o centro de custo 000000001 no Protheus representa o centro de custo 02.1.1.7 no RM, e o centro de custo CC0000001 no Protheus representa o centro de custo 02.2.2.4 no RM.
Verifique no RM que o atendente ainda não possuí o rateio cadastrado:
No Protheus, após a confirmação do atendimento das agendas, acesse a rotina "Envio da Programação do Rateio" (TECA960) para enviar para o sistema da RM o percentual de rateio de cada centro de custo:
Após o envio, verifique no sistema RM:
Na rotina "Envio da Programação do Rateio" (TECA960), também é possível apagar o rateio do atendente. Também é possível informar se a rotina deve ou não sobrescrever o rateio já cadastrado do atendente.
Enviar marcações de benefícios dos atendentes para o sistema RM, baseando-se nos atendimentos de Ordens de Serviços.
Ao acessar o configurador, é necessário cadastrar os de-para (APCFG070), caso não possua.
Ao clicar em Incluir será mostrada a seguinte tela:
Exemplo de cadastro para o Centro de Custo:
- Referência – RM
- Tabela - Nome físico da Tabela CTTT10
- Alias - CTT
- Campo - CTT_CUSTO
- Mensagem Única – Centro de Custo
- Valor Externo - [empresa de-para de filiais RM]|[Filial de-para RM]|[codigo do centro de Custo RM], EX: 1|02.1.1.7
- Valor interno - [empresa de-para de filiais Protheuus]|[Filial de-para Protheus]|[codigo do centro de Custo Protheus], EX: T1|D MG 01|000000001
Obs: este cadastro é para o Centro de Custo.
Exemplo de cadastro para VERBA:
- Referência – RM
- Tabela - Nome físico da Tabela SRVT10
- Alias - SRV
- Campo – RV_COD
- Mensagem Única – VERBA
- Valor Externo - [empresa de-para de filiais RM]|[Filial de-para RM]|[codigo da verba RM], EX: 1|1|0001
- Valor interno - [empresa de-para de filiais Protheuus]|[Filial de-para Protheus]|[codigo da verba Protheus], EX: T1|D MG 01|103
Obs: este cadastro é para VERBA.
No módulo de Gestão de Serviços, ao fazer um orçamento para realizar o envio de verbas, é necessário preencher os campos da Aba “Verbas Adicionais”,
Na rotina de Geração de Benefícios para o RH, preencha os parâmetros com as informações corretas e o sistema enviará as informações para o sistema RM.
Ao abrir o RM, clicar em Folha Mensal, ir em Consulta, selecionar "Consulta Movimento da integração" e verificar se a verba foi enviada.
Cadastrar no RM o terminal de coleta em Entrada de Dados | Cadastro no sistema de Ponto Eletrônico
Após, Configurar o layout de importação das Marcações em LayOut de Relógio
Na aba layout: Informar os campos seguindo a regra abaixo, após selecionar a opção Salvar
Parâmetro | Posição | Tamanho |
---|---|---|
Coligada | 1 | <Informar o tamanho do campo Empresa configurado no cadastro de-para de Empresa/Filial RM no configurador Protheus APCFG070> |
Chapa | <Tamanho do Parâmetro Coligada>+2 | <Informar tamanho do campo AA1_CDFUNC informado no Configurador Protheus> |
Ano | <Tamanho do Parâmetro Chapa>+<Posicao Parâmetro Chapa>+1 | 4 |
Mês | <Posição Parâmetro Ano>+5 | 2 |
Dia | <Posição Parâmetro Mês>+3 | 2 |
Hora | <Posição Parâmetro Dia>+3 | 5 |
Acessar o Protheus para enviar marcações de ponto dos atendentes para o sistema RM, baseando-se nos atendimentos de Ordens de Serviços, por meio da rotina de Geração de Marcações (TECA910) (Atualizações | Prestação de Serviços | Efetivo Operacional
Preencher os parâmetros com as informações dos atendentes e período de apontamentos e operação de envio.
Verificar a geração do arquivo rm_marc_3_[AAAAMMDDHHMMSS].txt, gravado no local definido no parâmetro MV_GSRHDIR onde, AAAAMMDD é Data/Hora da geração do Arquivo.
Importar o arquivo gerado para o RM, selecionando rotina Importar da aba Entrada de Dados do Módulo Ponto Eletrônico
No campo Arquivo para importação, informe o arquivo de Marcações gerado pelo Protheus
Na Layout do relógio, selecione o layout cadastrado
No período de importação, informe o período de geração das marcações
No terminal de coleta de dados, informe o terminal cadastrado.
Verificar se as batidas foram importadas selecionando a opção Espelho do ponto no Cadastro do funcionário selecionado no RM
Importante: somente é gerado o arquivo de envio de marcações para RM no Processamento de Inclusão na rotina de Geração de Marcações (TECA910)
A opção de Exclusão da mesma é para desmarcar a sinalização do apontamento enviado para marcação.
Para excluir a marcação que foi importada com sucesso na RM, deve ser utilizado no RM a rotina Processo | Cancelar Movimento
Na seleção de Datas informe o período de marcação e selecione executar
Para cadastro de Troca de Turno é necessário a criação de dois campos no Protheus:
Tabela | Campo | Tipo | Tamanho | Contexto | Propriedade | Titulo |
---|---|---|---|---|---|---|
TDW | TDW_CODHOR | 1 - Caracter | Tamanho do campo Código do Horário no RM | 1 - Real | 1 - Alterar | Código RM |
TDX | TDX_INIHOR | 1 - Caracter | Tamanho do Campo Índice no RM | 1 - Real | 1 - Alterar | Índice RM |
Para identificar os horários cadastrados no RM, acesse o Cadastro de Horários por Intervalo
Figura 1 - Cadastro de Horários no RM
No cadastro de escalas do Protheus, deve-se realizar o preenchimento desses campos campos:
Figura 2 - Campos utilizados na Integração RM
Com isso, é possível fazer amarração entre a escala no Protheus e a escala no RM.
O envio do histórico de turnos para o RM é realizado no por meio da rotina de Geração de Marcações (TECA910) (Atualizações | Prestação de Serviços | Efetivo Operacional), selecionando a operação de Inclusão
A rotina identifica as alocações do tipo EFETIVO (001) para o atendente no período e verifica se a mesma necessitam ser enviadas para o RM.
Figura 3 - Inclusão das marcações no Protheus.
Para visualizar o histórico de horários no RM, utilizaremos o exemplo abaixo:
Figura 4 - Visualizar no RM os horários.
Figura 5 - Visualizar os horários incluídos no RM.
Para enviar o exclusão do turno enviada anteriormente, basta executar a rotina Geração de Marcações (TECA910) (Atualizações | Prestação de Serviços | Efetivo Operacional), selecionando a operação de Exclusão
O processo de exclusão ira deletar o turno cadastrado
Figura 5 - Exclusão do horário no RM.