RH - Linha Protheus - GPE x Suricato - Integração de Férias ao Suricato

Tempo aproximado para leitura: 00:05:00 min

Dúvida
Como funciona a integração de Férias do Protheus para o Suricato?

Ambiente
TOTVS RH - TOTVS RH (Linha Protheus) - Gestão de Pessoal - A partir da versão 12.1.23

Solução
As Férias calculadas dentro do Protheus geram integração automática para o Suricato, para que seja feito o bloqueio do Acesso do funcionário no período de ausência.

Para que sejam gerados os XMLs da integração como demonstrados nesta documentação, é necessário que o conteúdo do parâmetro MV_TSATLOG esteja como 5. Os arquivos serão gerados dentro da pasta System do ambiente com nomes contendo um número sequencial + SND (XML de envio do Protheus) e número sequencial + RCV (XML de retorno do Suricato):




OBS: o parâmetro MV_TSATLOG também permite que o usuário gere os logs da integração através de Email ou Arquivo. Para isso, basta deixar o conteúdo do parâmetro como 1 = Email, 2=Arquivo, 3=Ambos, porém, para análise dos times de Suporte da TOTVS e Telematica, serão solicitados os arquivos XMLs, gerados através do conteúdo do parâmetro como 5.

Para os casos de Férias, o XML que trás estes dados é o que possui a tag AbsenceReason. Para inclusões, a tag virá como insertUserAbsenceReason:


Para exclusões de Férias, virá como removeUserAbsenceReason:


Para uma Férias calculada dentro do mês vigente, por exemplo, mês de Agosto/23, considerando Férias do dia 14.08.2023 ao dia 28.03.2023, e que o cálculo tenha sido feito no máximo até um dia antes da data de saída do descanso do funcionário, ou seja, dia 14, será gerado o XML para integração dos dados ao Suricato:



OBS: neste cenário, não serão gerados os XMLs de pessoa física e com os dados do funcionário, conforme exemplos abaixo:

- XML de pessoa física:


- XML com os dados do funcionário:



Para uma Férias que esteja sendo calculada durante o período de gozo do funcionário, por exemplo: hoje é dia 11, e o período de gozo é de 01 à 20, será gerado apenas o XML contendo os dados do afastamento:





Para uma Férias que esteja sendo calculada para um período que o funcionário já tenha saída e voltado, por exemplo, o cálculo está sendo feito no dia 11 e o período de Férias foi de 01 à 10, serão gerados os XMLs do afastamento, pessoa física e funcionário, porém, o Suricato não terá nenhuma ação, visto que o Controle de Acesso do funcionário deve estar liberado:





Para uma Férias que ocorrerá no mês seguinte, por exemplo, o cálculo está sendo feito em Agosto mas a saída efetiva será apenas em Setembro, para que o XML de afastamento seja gerado, o usuário deverá integrar, calcular e fechar o período de Agosto da Folha. Com esta ação, o XML será gerado e o Suricato recebe a informação (neste caso, não serão gerados os XMLs de pessoa física e funcionário):





Quando uma Férias é calculada no Protheus, e a pessoa encontra-se ausente, existe uma rotina no Suricato chamada Processo Online, que faz uma varredura nos dados recebidos do Protheus, para que sejam feitos os bloqueios de acesso e atualizados os status dos funcionários afastados.
Este processo deve ser parametrizado pelo cliente, com uma recorrência que o melhor atenda.






Saiba Mais:
Acesso e Segurança by Suricato
Integração Protheus x Suricato
Pacote de Expedição Contínua - Acumulado de RH