Crear vacaciones de empleado
Registra vacaciones para un empleado desde el calendario de la ubicación. En el flujo de gestor, Antylogic crea un evento staff_vacation aceptado por defecto.
En este artículo
Esta guía explica cómo un gestor registra vacaciones de empleado en Grupo Marea Demo, usando Marea Gran Via como ubicación de ejemplo.
El flujo crea un evento de día completo en calendar_events con kind staff_vacation. La solicitud propia de vacaciones y el cierre total de ubicación pertenecen a otros procedimientos.
Antes de empezar
- Tener una organización y una ubicación activas, como Grupo Marea Demo y Marea Gran Via.
- Contar con permiso vacation:manage en la ubicación.
- Tener al menos un empleado disponible, por ejemplo Marta Ruiz, Lucia Navarro, Diego Serrano o Alba Castro.
- Elegir un periodo que no solape un vacation_blackout aplicable y que no supere el límite anual de vacaciones del empleado.
Instrucciones
- 1.
Abre el calendario de vacaciones
Desde Marea Gran Via, entra en el calendario de vacaciones de la ubicación y usa la acción de creación. También puedes abrir directamente la ruta de creación con kind=staff_vacation.
- 2.
Mantén vacaciones de empleado
Conserva la opción Vacaciones de un empleado. No actives Cierre total por vacaciones, porque esa opción crea un cierre de ubicación y corresponde a otro flujo.
- 3.
Selecciona el empleado
Elige el empleado al que se asigna el periodo, por ejemplo Marta Ruiz. Si el formulario se abrió con returnStaffId desde un calendario o ficha de empleado, el empleado aparece fijado y no se cambia desde el selector.
- 4.
Indica comienzo y fin
Define las fechas del periodo. La app guarda estas vacaciones como evento de día completo en la zona horaria de la ubicación, Europe/Madrid para Marea Gran Via.
- 5.
Añade notas opcionales
Si hace falta contexto operativo, añade una nota breve. El formulario de vacaciones no guarda una descripción separada: las notas se registran como reason del evento.
- 6.
Crea las vacaciones
Pulsa Crear vacaciones. Si la validación es correcta, Antylogic crea el evento accepted, muestra Evento creado correctamente y vuelve al calendario indicado por la ruta de retorno.
- 7.
Comprueba el calendario
Al volver al calendario de vacaciones, revisa que el periodo aparece como vacaciones de empleado. Las cachés del calendario se actualizan tras crear el evento.
Validaciones y límites
- El usuario debe tener vacation:manage para crear vacaciones accepted de otro empleado.
- El empleado es obligatorio para staff_vacation, salvo que venga fijado por returnStaffId en la ruta.
- Las fechas de comienzo y fin deben existir y el comienzo debe ser anterior al fin.
- El periodo no puede solapar un vacation_blackout aplicable al empleado, rol o ubicación.
- El periodo no puede superar el límite anual de vacaciones del empleado.
- La creación usa POST /api/app/{orgId}/{locationId}/calendar-events con kind staff_vacation, all_day, staff_id, timezone y payload de vacaciones.
- La UI de gestor no expone un selector de estado: accepted es el estado por defecto.
- No se admite recurrencia para staff_vacation.
Resultado esperado
El calendario de la ubicación queda actualizado con un evento de vacaciones de empleado aceptado. Si el empleado tiene usuario vinculado y aplica la regla de notificación, Antylogic puede crear la notificación correspondiente.