Skip to main content
Registro de ponto é o evento de marcação de jornada de um colaborador — entrada, saída, intervalos. É a fonte primária para todo cálculo de frequência, horas extras, banco de horas e folha de pagamento da plataforma. A API permite que sistemas externos (REPs customizados homologados, apps próprios, integradores de jornada) registrem batidas, importem arquivos AFD pré-existentes e consultem históricos.

Contexto regulatório

A Pontua atua como REP-P (Registrador Eletrônico de Ponto via Programa) homologado pelo INPI sob a Portaria MTP 671/2021 e Portaria 1.486/2022. Isso traz obrigações inegociáveis para qualquer integração que manipula registros:

NSR — Número Sequencial de Registro

Cada batida recebe um NSR sequencial gerado pelo Pontua, nunca pelo cliente. Esse número entra no AFD/AEJ e nos comprovantes assinados. Sequência inválida (gaps, duplicatas) configura irregularidade.

Comprovante de registro

Para cada batida registrada, o colaborador tem direito a um comprovante assinado digitalmente (PAdES embed). O comprovante contém o NSR + hash SHA-256 + metadata INPI.

AFD e AEJ assinados

Arquivos exportados (AFD, AEJ) recebem assinatura digital CAdES detached (.p7s). Os arquivos têm encoding ISO 8859-1 e estrutura fixa por tipo (1 cabeçalho, 3 marcações, 99 trailer no AFD).

Soft-delete obrigatório

Registros nunca podem ser fisicamente removidos. Correções via API geram novo registro com flag de ajuste + motivo + auditoria. O histórico original é preservado por 5 anos (Art. 98).

Origens de registro

Cada registro carrega o campo origem indicando como foi capturado. A integração de cliente externo tipicamente registra apenas API ou AFD:

Endpoints públicos

Registrar batidas

POST /registro-ponto — Registra uma batida pontual.Quando usar:
  • REP customizado próprio (cliente que tem hardware homologado)
  • App de RH/onboarding que precisa registrar entrada manualmente
  • Sistema de portaria/controle de acesso integrado
Quando NÃO usar:
  • Sincronizar batidas históricas de outro sistema (use AFD em vez)
  • Importar grandes lotes de uma só vez (use AFD)
  • Eventos do app Pontua oficial (já passa por outra rota interna)
A jornada esperada do colaborador (turno) é validada no momento. Batidas fora da janela de tolerância podem cair em status PENDENTE aguardando aprovação de gestor. Veja Frequência.

Consultar registros

GET /registro-ponto — Lista registros com filtros.Filtros típicos: colaboradorId, dataInicio, dataFim, status, origem, departamentoId. Use paginação pagina + limite para iterar grandes volumes — ver Paginação.Para sync incremental com seu sistema, salve um cursor de timestamp e filtre por data crescente — ver Webhooks (polling).

Modelo de dados (campos chave)

Fluxos típicos

Registrar batida em REP customizado

Sync incremental de batidas para BI

Gerar comprovantes mensais

Gotchas conhecidos

Não tente enviar nsr no payload de POST /registro-ponto — é ignorado ou rejeitado. O backend gera sequencial conforme Art. 80 da Portaria 671. Misturar fontes de NSR é violação regulatória.
Sempre envie dataHora com offset explícito (ex: 2026-04-26T08:30:00-03:00). Strings sem timezone são interpretadas como BRT, mas isso pode falhar em horário de verão (ainda que abolido em 2019, alguns ambientes legados têm problemas). Para máxima portabilidade: sempre com offset.
Se o período da dataHora está em fechamento concluído, o registro é rejeitado ou cai em fluxo de ajuste com aprovação. Verifique o status do fechamento antes de bulk-import histórico — ver Fechamento.
São dados pessoais sensíveis. Sua integração deve:
  • Tratar com base legal explícita (consentimento ou execução de contrato)
  • Não trafegar fora do Brasil sem AIPD (Avaliação de Impacto)
  • Implementar política de retenção curta (URLs S3 com TTL no seu lado também)
GET /registro-ponto/gestao/dashboard, GET /registro-ponto/gestao/minha-equipe, GET /registro-ponto/frequencias e variantes estão deprecated. Use a tag Frequency para agregados — ver Frequência.

Endpoints expostos publicamente

Schema completo + try-it em Referência da API.

Veja também