Tempo aproximado para leitura: 00:05:00 min
Dúvida
O que validar quando a marcação consta na Carol/Clock In mas não foi para o Protheus?
Ambiente
TOTVS RH - TOTVS RH (Linha Protheus) - Ponto Eletrônico - Todas as versões
Solução
Nestes casos, é importante avaliarmos os passos abaixo:
1 - Na Carol, ir em Explore - Clock In Records:
Avaliar se a marcação que não foi integrada no Protheus, consta nesta tela com NSR gerado:
Importante: o Protheus só consegue consumir a marcação quando ela aparece nesta tela, ou seja, se ela aparece no Mapa de Marcações mas não consta aqui, o sistema não consegue localizar este dado. Para que a marcação apareça aqui, é necessário que ela tenha passado pelo processo de geração de NSR, validação de fraudes, e etc.
Cabe ressaltar que esta opção só fica disponível no menu da Carol para um usuário que seja Tenant Admin.
2 - É importante avaliar se o cadastro do dispositivo que o funcionário usou para fazer a marcação de Ponto está habilitado para integração com o RH, caso contrário, mesmo tendo NSR a marcação não seria integrada. Para validar este cadastro, retorne ao menu da Carol e clique em Carol Apps - TOTVS RH Clock In Backoffice:
Clique no link gerado no Web App:
No menu à esquerda, clique na opção Dispositivos:
Faça a busca pelo código do dispositivo que o funcionário utilizou para fazer a marcação de Ponto, e veja se a opção Integra RH está como SIM, desta forma, garantimos que o Protheus conseguirá localizar o dado e consumir essa marcação:
3 - Com os dados da Carol corretos, podemos partir para as validações no Protheus.
Inicialmente, verifique se a marcação realmente não consta na tabela RR1 ou MSA_CONTROL_MARCAC (só recomendamos a gravação dos dados na MSA_CONTROL_MARCAC se você também utilizar a integração com o Suricato via WS).
Em caso negativo, recomendamos que execute a rotina PONAPI01 no menu do SIGAPON, pois esta rotina é a responsável por fazer a busca das marcações na Carol e gravação na tabela do Protheus:
Neste exemplo, após a execução da rotina, a marcação de NSR 138058 não consta na RR1:
Neste caso, recomendamos que altere o conteúdo do parâmetro MV_APICLOB para .T.
Este parâmetro existe para que seja possível fazer uma varredura em todos os registros existentes nos Clock In Records da Carol com NSR, ou seja, se existir qualquer marcação/NSR nesta rotina da Carol que não exista ainda na tabela do Protheus, este dado será gravado independente da data ou número do NSR.
IMPORTANTE: o parâmetro onera a performance do Protheus, visto que será feita uma varredura completa em todos os registros da Carol, portanto, recomendamos o uso do parâmetro como .T. somente nos casos pontuais onde a marcação consta na Carol mas não foi gravada na tabela do Protheus. Após a execução da PONAPI01 e gravação do dado na tabela, retorne o conteúdo do parâmetro para .F.
Após a alteração no conteúdo do parâmetro e uma nova execução da rotina PONAPI01, a marcação foi gravada com sucesso na tabela RR1:
Caso exista alguma marcação que mesmo com o MV_APICLOB = .T. não seja gravada na tabela do Protheus, recomendamos então que o parâmetro MV_APICLOC fique com conteúdo .T. também, para que durante a execução da PONAPI01, seja gravado um log em TXT dentro da pasta System do ambiente, chamado Integração Carol ou Carol Integration:
Neste log, é possível fazer uma busca pelo código do dispositivo + NSR para verificar se a Carol enviou o dado para o Protheus ou não:
Caso o NSR/dispositivo não apareça neste log, será necessário o suporte por parte do time de Carol/Clock In, para avaliarem diretamente no ambiente se existe alguma inconsistência.
O MV_APICLOC com conteúdo .T. também onera a performance do Protheus, portanto, recomendamos que após a geração do log para buscar as informações necessárias, o conteúdo dele fique como .F.
4 - Com a marcação na tabela do Protheus, para que seja possível executar a Leitura dos dados é necessário que seja feito o cadastro de um relógio que integre com a Carol, conforme esta documentação.
Com todos os passos conferidos, basta executar a rotina de Leitura/Apontamento no SIGAPON.
Saiba mais
Manual do Ponto Eletrônico
Pacote de Expedição Contínua Acumulado de RH
Integração Protheus x Carol
0 Comentários