RH - Linha Protheus - PON x Suricato - Leitura de Marcações vindas do Suricato

Tempo aproximado para leitura: 00:05:00 min

Dúvida
Como funciona a leitura de marcações vindas do Suricato?

Ambiente
TOTVS RH - TOTVS RH (Linha Protheus) - Ponto Eletrônico - A partir da versão 12.1.23

Solução
Para efetuar a leitura de marcações a partir do Suricato, deve-se incluir um cadastro do relógio e informar o conteúdo “R” no campo Tipo Arquivo (P0_TIPOARQ). Ao iniciar o processo de leitura de marcações, a rotina irá buscar os registros da tabela MSA_CONTROL_MARCAC ou RR1 de determinada data de/até, que contém o campo LOG_IMPORT_PRODUT = 0.

Para que as marcações salvas na MSA/RR1 sejam processadas corretamente, o código do REP, no cadastro do Protheus, deverá ser o mesmo código salvo no campo COD_REP na tabela MSA/RR1. Por exemplo, se o Suricato salvar o código 5001030033938 no campo COD_REP da MSA, o campo REP do cadastro de relógio do Protheus deverá ser salvo com o conteúdo 5001030033938.

Com a portaria 671 é necessário informar o tipo do REP (1510, REP-A, REP-C e REP-P). Para um relógio do Suricato teremos apenas duas opções: 1510 ou REP-C. É necessário verificar qual o tipo do REP do Suricato e preencher corretamente o cadastro do relógio, para que a leitura seja feita através do PIS ou CPF do funcionário.

Exemplo de configuração dos campos no Cadastro de Relógio para integração de marcações do Suricato:
Para leitura por PIS:

Para leitura por CPF:


PORTARIA 671
Com a portaria 671/2021, surgiu a necessidade de realizar duas alterações no Protheus para que o sistema consiga realizar corretamente a integração de marcações vindas do Suricato.
A primeira alteração foi a estrutura das tabelas MSA_CONTROL_MARCAC/RR1, que armazenam as marcações.
A segunda alteração foi a API recordClockMarkings, ela foi atualizada para receber os novos campos da Portaria 671/2021. A utilização da API recordClockMarkings é apenas para as marcações serem integradas na RR1. Caso a integração das marcações seja feita via banco de dados utilizando a MSA_CONTROL_MARCAC, o processo continuará o mesmo, porém, será necessária  a criação dos novos campos.

CAMPOS DA TABELA RR1/MSA_CONTROL_MARCAC
Se a tabela utilizada for a MSA_CONTROL_MARCAC, será necessária a atualização do ambiente com o pacote de expedição contínua Acumulado de RH e a execução do UPPDISTR. Após a execução do pacote de dicionários, será criada a pergunta Atualiza Tabela MSA? na rotina de Carga Inicial (PONM430). Esta pergunta será responsável para dizer se o sistema deve ou não atualizar a MSA_CONTROL_MARCAC com os novos campos. A pergunta terá apenas duas respostas, sendo: 1 - Sim e 2 - Não, caso seja preenchida com 1 - Sim, o sistema irá criar o novos campos da MSA_CONTROL_MARCAC, caso ela esteja preenchida com não, o sistema não irá atualizar a tabela.

Com a pergunta preenchida com Sim, as demais perguntas podem ficar em branco e o sistema irá desconsiderar as demais perguntas, fazendo assim com que a execução da rotina seja exclusivamente para a criação dos novos campos na MSA_CONTROL_MARCAC. 

Caso a tabela MSA_CONTROL_MARCAC já exista no banco de dados, ao executar a rotina de Carga Inicial (PONM430) preenchendo apenas a pergunta Atualiza Tabela MSA? com Sim, será realizada a criação dos novos campos.

Caso a tabela MSA_CONTROL_MARCAC não exista no banco de dados, ao executar a rotina de Carga Inicial (PONM430), preenchendo apenas a pergunta Atualiza Tabela MSA? com Sim, será realizada a criação da tabela com os novos campos.

Após a execução da rotina, os novos campos serão criados:

As marcações são gravadas na tabela MSA_CONTROL_MARCAC conforme exemplo abaixo:





Caso a tabela responsável por armazenar as marcações seja a RR1, será necessária a atualização do ambiente com o pacote de expedição contínua Acumulado de RH e a execução do UPPDISTR.
Após a execução do UPPDISTR, os seguintes campos serão criados na tabela RR1:

Observação: O Suricato não grava o horário da marcação em horas e minutos no campo NUM_HORAR_MARCAC_ACES das tabelas MSA_CONTROL_MARCAC/RR1. É necessário converter o conteúdo para horas e minutos efetuando a seguinte conta:
- NUM_HORAR_MARCAC_ACES / 3600 para encontrar as horas;
- Resto da divisão X 60 para encontrar os minutos;
- Resto da divisão X 60 para encontrar os segundos.
Exemplo: NUM_HORAR_MARCAC_ACES = 59730:
59730 / 3600 = 16,59166666666667;
0,59166666666667 X 60 = 35,5;
0,5 X 60 = 30.
Resultado: 16:35:30.

As marcações são gravadas na tabela RR1 desta forma:


Cabe ressaltar que as marcações são gravadas nas tabelas após envio por parte do Suricato.

ALTERAÇÃO DA API RECORDCLOCKMARKINGS
A APIrecordClockMarkings, foi alterada para receber, validar e salvar os dados nos novos campos da RR1. Se as marcações a serem integradas forem referentes a Portaria 671, antes de consumir a API será necessário validar se os novos campos, mencionados anteriormente, já foram criados no Protheus. Para isso foi criada uma nova API que irá dizer para o Suricato se o Protheus já possui os novos campos e se poderá ser utilizado os mesmo na API RecordclockMarkings.

RECORDVALIDATEDVERSION
A API RecordValidatedVersion irá verificar no sistema se os novos campos foram criados, respeitando o conteúdo do parâmetro MV_APISUR. Se o parâmetro MV_APISUR estiver configurado com .T. (integração via API) o sistema irá verificar a tabela RR1, nos casos onde o parâmetro estiver com .F. será verificada a tabela MSA_CONTROL_MARCAC.
Para mais informações sobre a API, acesse o link abaixo:
DT API recordValidatedVersion.

Após validar se o sistema possui os novos campos, bastar utilizar a API RecordclockMarkings, informando os novos campos como o exemplo abaixo:

{
    "items": [
                {
                    "codRelogioExtChave": "",
                    "codFuncMsa": "003651",
                    "codNsr": 1,
                    "codPisMsa": "022036983234",
                    "datMarcacAces": "2022-11-01 09:00:00.000",
                    "numHorarMarcacAces": 32400,
                    "codRep": "00000000000000123",
                    "codUnidExtChave": "T1D MG 01",
                    "codUsuarExtChave": "T1D MG 01 003651",
                    "codFuso": "-0300",
                    "codCPF": "16046091098",
                    "numVersLayout": 3,
                    "inscrEmp": "11456156000111"
                }
        ]
}

CONFIGURAÇÃO DO SCHEDULE
Após o cadastro do relógio, é possível realizar a configuração do Schedule para que a rotina de Leitura e Apontamento seja executada de tempos em tempos, desta maneira, todas as marcações que foram integradas serão processadas pelo Protheus. O processo também pode ser realizado de forma manual, para isso acesse a rotina de Leitura Apontamento em SIGAPON → Miscelanea → Cálculos → Leitura/Apontamento Marcações, preencha os parâmetros informando o código do relógio cadastrado anteriormente e execute a rotina.

Para a configuração do Schedule siga a documentação:
https://centraldeatendimento.totvs.com/hc/pt-br/articles/360052033373-RH-Linha-Protheus-PON-Como-configurar-o-Schedule-de-Leitura-Apontamento

Saiba Mais:
Acesso e Segurança by Suricato
https://tdn.totvs.com/pages/releaseview.action?pageId=546695095Integração Protheus x Suricato
Schedule - Leitura/Apontamento das Marcações
Pacote de Expedição Contínua - Acumulado RH