RH - Linha Protheus - GPE x Suricato - Integração de Afastamentos Médicos ao Suricato

Tempo aproximado para leitura: 00:05:00 min

Dúvida
Como funciona a integração de Afastamentos Médicos 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
O cadastro de qualquer tipo de Afastamento Médico no Protheus, gera integração automática para o Suricato, desde que o registro seja criado até no máximo a data de afastamento do funcionário OU se no momento do cadastro, o funcionário ainda estiver ausente.

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 Afastamentos, o XML que trás estes dados é o que possui a tag AbsenceReason. Para inclusões, a tag virá como insertUserAbsenceReason:



Para exclusões, virá como removeUserAbsenceReason:



Para um afastamento médico apenas no dia 11.08.2023, por exemplo, se o registro for criado no Protheus até o próprio dia 11, ele será integrado via XML ao Suricato:



Se o afastamento for criado no Protheus a partir do dia 12 em diante, não será gerado o XML que trata do afastamento e consequentemente o dado não será integrado ao Suricato.
OBS: serão gerados apenas os XMLs que tratam dos dados de pessoa física e do funcionário, porém, em nenhum destes arquivos o Afastamento será informado.

Exemplo de um XML com dados de pessoa física:



Exemplo de um XML com dados do funcionário:



Nos casos onde for cadastrado um Afastamento e a pessoa ainda estiver ausente, o XML que trata do Afastamento será gerado normalmente. Por exemplo: afastamento médico de 10 dias, a partir de 11.08.2023, se o registro for criado no Protheus até o dia 20.08.2023 (data fim do afastamento), o XML que trata do afastamento será gerado, mas se for feito após esta data, o arquivo não será gerado.



O processo é tratado desta forma, pois deve ser levado em consideração que o intuito do Suricato é administrar o Controle de Acesso das pessoa na empresa, ou seja, nos casos onde o funcionário já se afastou e retornou, o Protheus não gera o XML com a tag AbsenceReason pois para o Suricato não terá nenhuma ação a ser feita.

Quando um Afastamento é cadastrado 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