TOTVS RH Ponto Eletrônico (Linha Ahgora) - PontoWeb - Como realizar a apuração de divergências por meio do Retrocálculo (Offcycle)

Tempo aproximado para leitura: 00:05:00 min

Dúvida
Como realizar a apuração de divergências por meio do Retrocálculo (Offcycle)?

Ambiente
TOTVS RH Ponto Eletrônico (Linha Ahgora) - PontoWeb  - Todas as versões

Solução
O Retrocálculo (Offcycle) é responsável por comparar dados de apuração passados com dados atuais e gerar prévias de valores a pagar e/ou descontar. Para realizar o retrocálculo, é necessário armazenar os resultados dos fechamentos anteriores, permitindo sua posterior consulta e a validação de eventuais alterações nos eventos.

Importante:

• Os principais eventos analisados durante o retrocálculo são: Horas Extras, Adicional Noturno, Faltas e Afastamentos;

• O Banco de Horas não é considerado no retrocálculo, pois não possui pagamento mensal e, quando utilizado, aplica-se o evento de hora extra;

• A execução do retrocálculo deve ser realizada sempre antes do próximo fechamento.

Para utilizar o Retrocálculo siga os passos abaixo:

1. Para armazenar os dados de fechamento necessários para comparação da apuração, realize uma requisição POST para o endpoint: [https://api.ahgora.com.br/reckons/process/start];


2. No corpo (body) da requisição, o parâmetro payroll deve ser definido como true quando a requisição tiver como objetivo realizar o fechamento da folha. Para todas as demais requisições, esse parâmetro deve ser definido como false. Segue abaixo um exemplo de body;

4. Em seguida clique na opção Log localizada no menu lateral esquerdo;

5. Na tela de Logs, será possível visualizar todos os registros de log;

6. Após a conclusão da requisição do tipo Resultados – Resultados Mensais e da realização de eventuais alterações na apuração dos funcionários, acesse o painel do PontoWeb. Em seguida, no menu lateral esquerdo, selecione a opção Documentos e, na sequência, clique em Retrocálculos de eventos;

7. Na tela inicial de Retrocálculo, selecione a competência desejada no filtro Competência, que é de preenchimento obrigatório. É possível escolher até 6 competências anteriores à competência atual. Se necessário, utilize também os demais filtros disponíveis, como Localização, Departamento e Cargo. Após selecionar a competência, clique em Apurar divergências;

8. O sistema realizará uma nova apuração e a comparará com o resultado do fechamento previamente salvo. As divergências identificadas serão exibidas na tela para conferência. Caso deseje, também é possível fazer o download do relatório de divergências clicando em Baixar;

9. Após conferir todas as informações, clique em Salvar Resultados para que os dados sejam disponibilizados para consulta por meio da integração;

10. Os resultados salvos podem ser acessados no indicador Salvos no topo da página;

11. Após salvar os resultados, é hora de enviar os mesmos via integração. Para isso, faz-se necessário uma nova requisição via API Reckons [https://api.ahgora.com.br/reckons/process/start] com o parâmetro “payroll” igual a “false” e o parâmetro “infotype” como “offcycle” e realiza o disparo da requisição. Segue um exemplo abaixo;

{

    "rescission": false,

    "month": "06",

    "year": "2026",

    "includeEmptyCode": true,

    "registers": [],

    "locations": [],

    "rubrics": [],

    "allowEmpty": false,

    "infotype": "offcycle",

    "payroll": false

}

12. Após a conclusão da requisição, será possível acompanhar o progresso novamente na tela de Logs.

Importante: Abaixo segue um modelo de retorno dos eventos para Offcycle:

    {

        "employee": "1990",

        "paymentDate": "2026-06-01",

        "infotype": "0267",

        "results": [

            {

                "name": "Horas Trabalhadas",

                "event": "0001",

                "value": "47:56",

                "type": "hours"

            },

            {

                "name": "FALTA",

                "event": "9T35",

                "value": "08:00",

                "type": "hours"

            },

            {

                "name": "Horas Extras 50% (noturno)",

                "event": "9071",

                "value": "06:58",

                "type": "hours"

            },

            {

                "name": "Horas Extras 50%",

                "event": "1111",

                "value": "09:00",

                "type": "hours"

            }

        ]

    }

]