Caso de uso clássico: sua empresa usa folha de pagamento externa
(Domínio Sistemas, Sage, ContabilQuasar, ERP próprio) e precisa que
a frequência do Pontua reflita lá diariamente para fechamento mensal.
Este guia mostra o padrão cron noturno + cursor incremental que
roda à 1h da manhã, puxa frequências de D-1 e popula seu ERP.
Estratégia
Implementação Node.js
Tratamento de retry
Se o cron falhar (rede, timeout), use backoff exponencial + idempotência:
A idempotência vem do upsert no ERP: rodar o cron 2x no mesmo dia
não cria duplicatas (colaboradorCpf + data é a chave natural).
Catch-up de períodos esquecidos
Cron pode ter ficado quebrado por dias. Para alcançar atrasados:
Recomendação de horário
Se você atende múltiplas UNs (contador), distribua os jobs em
janelas de 5-10 min para não saturar.
Gotchas
Se D-1 ainda está em período de fechamento aberto, a frequência
pode mudar com aprovações de ajuste posteriores. Para snapshot
imutável, use GET /relatorio/<tipo> após o fechamento concluir —
ver Relatórios.
Colaborador faltou ontem, sync trouxe status: FALTA, mas hoje o
RH aprovou atestado retroativo. Próximo sync vai mudar o status —
seu ERP precisa aceitar update do mesmo registro, não criar duplicata.
data no response é date pura (yyyy-MM-dd) sem timezone. Já
representa BRT. Não converta para UTC ao salvar no seu DB se ele
trata como timestamp — pode resultar em “dia anterior” depending no fuso.
Veja também