Skip to main content
Este guia mostra o fluxo geral de geração e download da folha de pagamento via API. Para o schema exato dos parâmetros (nomes de campos, formato de retorno), consulte a Referência da API com try-it interativo.
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

A última etapa fecha o ciclo de auditoria — marca como 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