Justificación¶

Qué es¶

Justificación Son registros que explican ocurrencias o inconsistencias en las marcas de punto — faltas, retrasos, salidas anticipadas u otros eventos que necesitan ser documentados para fines de hoja y auditoría.

Por qué esto importa en una integración¶

Justificativas originadas en ERP/RH (p. ej.: consulta médica aprobada, visita externa) deben reflejarse en Pontotel para evitar que el sistema contabilize como falta
Integración con flujo de aprobación: algunas empresas aprueban justificativas en el sistema de RH y sincronizan con Pontotel
Historial de auditoría: justificaciones garantizan la trazabilidad de los ajustes

Reglas de negocio¶

Una justificación siempre está vinculada a un empleado y a una fecha específica
Justificativas pueden tener estado de aprobación: pendente, aprovado, reprovado
El tipo de justificación debe estar pre-cadastrado (configuración de la empresa)

Operaciones disponibles¶

Método	Variable	Descripción
GET	`/justificativas/`	Listar justificaciones
POST	`/justificativas/`	Registrar justificación
GET	`/justificativas/{id}/`	Obtener justificación
PATCH	`/justificativas/{id}/`	Actualizar (por ejemplo: aprobar)

Campos¶

Campo	Tipo	Obligatorio	Descripción
`id`	Integer	—	ID interno
`empregado_id`	Integer	Gálatas	ID del empleado
`data`	date	Gálatas	Fecha de la ocurrencia
`tipo`	string	Gálatas	Tipo de justificación (según el registro de la empresa)
`motivo`	string	Gálatas	Descripción del motivo
`status`	string	—	`pendente` \

Tipos comunes de justificación¶

Tipo	Descripción
`FALTA`	Ausencia en el día
`ATRASO`	Llegada después de horario
`SAIDA_ANTECIPADA`	Salida antes del horario
`HORA_EXTRA`	Trabajo además de la jornada
`ESQUECIMENTO`	olvido de marcado

Ejemplo: Registrar Justificativa¶

Solicitud¶

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"
}

Respuesta (201 Created)¶

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