Skip to main content
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