- Conferir banco antes de quitação em folha
- Auditar banco vencido (Lei 13.467/2017)
- Anexar em acordo coletivo
Padrão geral aplicável a qualquer relatório
Este fluxo serve para qualquer endpointPOST /relatorio/<tipo>,
não só banco-horas:
Implementação completa
Persistir o arquivo localmente
Você deve guardar uma cópia local do arquivo gerado por questões de auditoria (Portaria 671 exige retenção de 5 anos para registros, 10 anos para folha):Filtros úteis
POST /relatorio/banco-horas aceita filtros que reduzem o tamanho
e o tempo de geração:
Schema completo do payload em Referência da API.
Quando usar PDF vs CSV
Boas práticas
Rode em horário noturno
Geração de relatório do mês todo pode levar minutos. Faça em horário
de baixa carga (22h-6h BRT).
Cache do relatorioId
Se o download falhar, não regenere. Reuse o mesmo
relatorioId
para tentar baixar de novo. Geração custa caro.Filtre máximo possível
Não puxe banco-horas do ano todo se só precisa do mês corrente.
Filtros antes = relatório menor + mais rápido.
Guarde 5+ anos
Por questões fiscais e Portaria 671, mantenha cópia local de cada
relatório por no mínimo 5 anos. Não dependa só do Pontua.
Troubleshooting
Status fica em PROCESSANDO indefinidamente
Tipicamente significa fila acumulada ou erro na geração. Após 30 min sem mudar, abra chamado emtecnologia@pontua.com.br mencionando o
relatorioId.
Relatório veio vazio
Filtros muito restritivos (ex.: período sem movimentação, departamento sem colaboradores). Repita sem filtros para confirmar que dados existem.Erro “fechamento aberto”
Banco de Horas se baseia em saldos consolidados — se o período tem fechamento aberto, alguns valores podem não estar definitivos. Para relatório oficial, gere apósPOST /fechamento/concluir/{id}. Ver
Fechamento.
Veja também
- Relatórios — todos os tipos disponíveis
- Banco de Horas — endpoints de saldo em tempo real
- Fechamento — quando relatórios ficam imutáveis
- Idempotência — não disparar 2x o mesmo