Registro de ponto é o evento de marcação de jornada de um colaborador
— entrada, saída, intervalos. A API permite que sistemas externos (REPs
customizados, apps próprios, integradores de jornada) registrem batidas
e consultem históricos.
Conformidade legal: registros de ponto na Pontua são tratados em
conformidade com a Portaria 671 do Ministério do Trabalho. Mudanças
em registros após o período de fechamento ficam auditadas, e geração de
AFD (Arquivo Fonte de Dados) preserva o trilho de modificações.Sua integração deve ser conservadora ao criar registros — duplicação
ou registros fora do horário de jornada do colaborador podem disparar
ocorrências automáticas que afetam folha de pagamento.
Endpoints principais
Registro de batida
| Método | Rota | Descrição |
|---|
| POST | /registro-ponto | Registra batida individual (origem app/portal) |
| POST | /registro-ponto/relogio | Registra batidas vindas de relógio de ponto (REP) |
| POST | /registro-ponto/afd | Importa arquivo AFD (Portaria 671) |
| POST | /registro-ponto/recibo | Cria recibos PDF dos registros |
Consultas
| Método | Rota | Descrição |
|---|
| GET | /registro-ponto | Lista registros de ponto (filtros por colaborador, período, status) |
| GET | /registro-ponto/ultimos | Últimos registros de um colaborador |
| GET | /registro-ponto/localizacoes | Localizações dos registros de uma jornada |
| GET | /registro-ponto/fotos | Fotos dos registros de uma jornada |
Endpoints excluídos da doc pública
Existem outras rotas em /registro-ponto/* que não fazem sentido para
integração server-to-server e ficaram fora do escopo público:
- Coletivo / offline (
/registro-ponto/coletivo, /offline,
/offline/coletivo) — específicas do app mobile e coletor coletivo
- Dashboard de gestão deprecated (
/registro-ponto/gestao/*,
/registro-ponto/frequencias*) — substituídos pela tag Frequency,
ver Frequência
Localização e fotos (LGPD)
Localização GPS e fotos de batida são dados pessoais sob LGPD. Sua
integração deve:
- Coletar só com consentimento do colaborador (já gerenciado pelo dashboard)
- Não armazenar localização/foto fora da Pontua se não for necessário
- Tratar URLs de fotos como temporárias (expirar conforme política do bucket)
GET /registro-ponto/localizacoes e GET /registro-ponto/fotos retornam
esses dados quando o colaborador autorizou. Se a UN tem política de não
coletar GPS/foto, esses endpoints retornam vazio mesmo para registros
válidos.
Veja também
