- 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:
| Filtro | Quando usar |
|---|---|
colaboradorIds | Relatório de demitido ou subset específico |
departamentoIds | Relatório por departamento (folha de gerente) |
formato: 'CSV' | Análise em planilha em vez de PDF |
dataInicio / dataFim | Sempre — define o período de cálculo |
Quando usar PDF vs CSV
| Caso | Formato |
|---|---|
| Anexar em recibo / arquivo do colaborador | PDF (assinado PAdES) |
| Análise em Excel / BI | CSV |
| Auditoria oficial / fiscalização | PDF (tem assinatura digital) |
| Importar para outro sistema | 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