Justificativas¶

O que é¶

Justificativas são registros que explicam ocorrências ou inconsistências nas marcações de ponto — faltas, atrasos, saídas antecipadas ou outros eventos que precisam ser documentados para fins de folha e auditoria.

Por que isso importa numa integração¶

Justificativas originadas no ERP/RH (ex.: consulta médica aprovada, visita externa) devem ser refletidas na Pontotel para evitar que o sistema contabilize como falta
Integração com fluxo de aprovação: algumas empresas aprovam justificativas no sistema de RH e sincronizam com a Pontotel
Histórico de auditoria: justificativas garantem rastreabilidade de ajustes

Regras de Negócio¶

Uma justificativa está sempre vinculada a um empregado e a uma data específica
Justificativas podem ter status de aprovação: pendente, aprovado, reprovado
O tipo de justificativa deve estar pré-cadastrado (configuração da empresa)

Operações Disponíveis¶

Método	Endpoint	Descrição
GET	`/justificativas/`	Listar justificativas
POST	`/justificativas/`	Registrar justificativa
GET	`/justificativas/{id}/`	Obter justificativa
PATCH	`/justificativas/{id}/`	Atualizar (ex.: aprovar)

Campos¶

Campo	Tipo	Obrigatório	Descrição
`id`	integer	—	ID interno
`empregado_id`	integer	✅	ID do empregado
`data`	date	✅	Data da ocorrência
`tipo`	string	✅	Tipo de justificativa (conforme cadastro da empresa)
`motivo`	string	✅	Descrição do motivo
`status`	string	—	`pendente` \| `aprovado` \| `reprovado`

Tipos Comuns de Justificativa¶

Tipo	Descrição
`FALTA`	Ausência no dia
`ATRASO`	Chegada após horário
`SAIDA_ANTECIPADA`	Saída antes do horário
`HORA_EXTRA`	Trabalho além da jornada
`ESQUECIMENTO`	Esquecimento de marcação

Exemplo: Registrar Justificativa¶

Requisição¶

HTTP
POST /pontotel/api/v4/justificativas/
Authorization: Bearer {token}
Content-Type: application/json

{
  "empregado_id": 500,
  "data": "2025-01-31",
  "tipo": "FALTA",
  "motivo": "Consulta médica agendada"
}

Resposta (201 Created)¶

JSON
{
  "id": 111,
  "empregado_id": 500,
  "data": "2025-01-31",
  "tipo": "FALTA",
  "motivo": "Consulta médica agendada",
  "status": "pendente"
}