Skip to main content
Banco de Horas é dos relatórios mais usados em integrações de RH e contabilidade — mostra saldos, movimentações, datas de prescrição por colaborador no período. Útil para:
  • 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 endpoint POST /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 em tecnologia@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ós POST /fechamento/concluir/{id}. Ver Fechamento.

Veja também