Vacaciones¶

Qué es¶

Vacaciones es el registro de los períodos de descanso remunerado del colaborador conforme a la legislación laboral vigente (CLT). Sincronizar vacaciones en Pontotel evita inconsistencias en hojas e informes cuando el colaborador esté ausente.

Por qué esto importa en una integración¶

Evita inconsistencias en la hoja: sin el registro, el sistema puede interpretar la ausencia como falta
Sincronización con ERP/RH: sistemas de hoja normalmente controlan períodos de vacaciones — la integración debe reflejar estos datos en Pontotel para evitar lanzamientos manuales
Cumplimiento: mantener historial correcto de vacaciones es requisito legal

Reglas de negocio¶

Las vacaciones pueden ser fracionadas en hasta 3 períodos (según CLT)
Ningún período puede ser inferior a 14 días cordos
Periodos de vacaciones no pueden Sobrescribir unos a otros
El colaborador necesita tener el período ad hoc completo para tener derecho (12 meses)
Las vacaciones de colaborador inactivo todavía pueden ser consultadas

Operaciones disponibles¶

Método	Variable	Descripción
GET	`/ferias/`	Listar vacaciones
POST	`/ferias/`	Registrar período
GET	`/ferias/{id}/`	Obtener período
PATCH	`/ferias/{id}/`	Actualizar
DELETE	`/ferias/{id}/`	Cancelar

Campos¶

Campo	Tipo	Obligatorio	Descripción
`id`	Integer	—	ID interno
`empregado_id`	Integer	Gálatas	ID del empleado
`data_inicio`	date	Gálatas	Inicio del período de vacaciones
`data_fim`	date	Gálatas	Fin del período de vacaciones
`status`	string	—	`pendente` \
`observacao`	string	—	Observación

Ejemplo: Registrar vacaciones¶

Solicitud¶

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

{
  "empregado_id": 500,
  "data_inicio": "2025-07-01",
  "data_fim": "2025-07-30",
  "observacao": "Férias anuais 2025 — 1ª parcela"
}

Respuesta (201 Created)¶

JSON
{
  "id": 77,
  "empregado_id": 500,
  "data_inicio": "2025-07-01",
  "data_fim": "2025-07-30",
  "status": "pendente",
  "observacao": "Férias anuais 2025 — 1ª parcela"
}

Errores comunes¶

Error	Causa	Solución
Faltas indebidas en la hoja	Vacaciones no registradas durante el período	Registra vacaciones antes o junto con el período
Sobreposición de períodos	Dos registros de vacaciones con fechas conflictivas	Compruebe períodos existentes antes de crear
Período inferior a 14 días	Fraccionamiento por debajo del mínimo legal	Garanta mínimo de 14 días corridos por parcela