Pré-requisito: o layout de exportação da sua folha precisa estar
cadastrado no dashboard Pontua antes da primeira execução.
Visão geral do fluxo
processado no
lado da Pontua, evitando re-exportações acidentais.
Implementação geral
Os campos exatos do request/response variam por endpoint. Consulte a Referência interativa para os nomes corretos antes de implementar:Listar exports anteriores
GET /payment-sheet/export retorna a lista de exports gerados na UN, com
status. Útil para:
- Auditoria — quem disparou export quando
- Re-download — pegar arquivo de mês anterior sem regenerar
Boas práticas
Rode em horário noturno
Geração de folha consolida todas as batidas + ajustes do mês — é
trabalhoso. Faça em horário de baixa carga (22h–6h BRT).
Não disparar 2x o mesmo
A Pontua não dedup automaticamente — disparos repetidos geram exports
diferentes. Cache o
exportId do seu lado e cheque antes de retentar.Não exporte com fechamento aberto
Cheque que o período está fechado antes de exportar — exportar com
ajustes em curso pode gerar dados que mudam depois.
Guarde o arquivo no seu lado
Por questões fiscais, mantenha cópia do arquivo gerado pela API por
pelo menos 5 anos no seu sistema. Não dependa só da Pontua para
auditoria histórica.
Veja também
- Referência: Relatórios — outros relatórios além de folha
- Idempotência — não disparar 2x o mesmo export