Cómo ver vacaciones por empleado
Consulta los días de vacaciones aprobados y solicitados por empleado para una ubicación y uno o varios periodos.
En este artículo
Este reporte está pensado para responsables de personal, operaciones y administración de ubicación que necesitan revisar la cobertura del equipo sin salir de Antylogic. En el demo ES se documenta sobre Grupo Marea Demo y la ubicación Marea Gran Via.
La pantalla es de solo lectura: no aprueba, rechaza ni modifica vacaciones. Toma los datos del dashboard agregado de reporting y muestra la página `employee-vacations` con un resumen de días y una tabla por empleado.
Antes de empezar
- Iniciar sesión en la app con una cuenta que pueda acceder a la ubicación.
- Seleccionar la organización Grupo Marea Demo y la ubicación Marea Gran Via en el runtime ES.
- Tener al menos uno de estos permisos en la ubicación: `reports:view`, `tpv:view`, `tpv:use`, `catalog:view`, `reservation:view` o `staff:view`.
- Para ver filas con datos, deben existir vacaciones de personal dentro del periodo consultado.
Instrucciones
- 1.
Abre el reporte
Desde el menú lateral, entra en Reportes > Empleados > Vacaciones. También puede abrirse con la ruta `/:orgId/:locationId/reporting/employees/vacations` cuando la organización y la ubicación ya están seleccionadas.
- 2.
Confirma el periodo consultado
Revisa el panel de filtros. Si la pantalla se abre sin `periods` en la URL, Antylogic usa la semana actual y escribe el rango en formato `YYYY-MM-DD_YYYY-MM-DD`.
- 3.
Lee el resumen Vacaciones
La tarjeta Vacaciones muestra, para cada periodo, `Días aprobados`, `Días solicitados` y `Empleados con vacaciones`.
- 4.
Interpreta la tabla Por empleado
La tabla muestra `Nombre empleado`, `Días aprobados` y `Días solicitados`. Los empleados se combinan entre los periodos consultados y se ordenan por el total de días del periodo más reciente.
- 5.
Compara varios periodos
Añade un periodo para comparar semanas o rangos. La pantalla añade un periodo anterior al primero con la misma duración y actualiza `periods` separando los rangos con `~`.
- 6.
Exporta resultados en web
En web, cada tarjeta del reporte puede exportarse como CSV, Excel o PNG. En plataformas nativas la app muestra una alerta de exportación no disponible.
Validaciones y límites
- Si falta organización o ubicación seleccionada, la pantalla muestra `Selecciona una ubicación para consultar reportes.` y no carga el dashboard.
- Si el usuario no tiene permisos suficientes, muestra `No tienes permisos para ver reportes en esta ubicación.` y no consulta el reporte.
- Durante la carga aparece `Cargando reportes...`; si falla la query aparece `No pudimos cargar los datos del reporte.`.
- Si el dashboard no incluye `pages.employee-vacations`, aparece `No encontramos la configuración de este reporte.`.
- Si el bloque `by-employee` no tiene filas, la tabla muestra `No hay vacaciones registradas para los filtros seleccionados.`.
- El parámetro `periods` acepta rangos `YYYY-MM-DD_YYYY-MM-DD` separados por `~`; los rangos inválidos se descartan y, si no queda ninguno válido, el backend usa periodos por defecto.
- Solo cuentan `calendar_events` con `kind == "staff_vacation"`; las vacaciones de ubicación, bloqueos de vacaciones, prorrateos y eventos rechazados no suman en este reporte.
- Los estados `accepted` y `approved` suman como días aprobados; cualquier otro estado no rechazado suma como días solicitados.
- Los nombres se muestran en mayúsculas desde `staff.full_name`; si no hay empleado resoluble aparece `SIN ASIGNAR`.
- El reporte está limitado a una ubicación y depende de `GET /api/app/{orgId}/{locationId}/reports`; no existe un endpoint específico `employee-vacations`.
Resultado esperado
El responsable obtiene una lectura por empleado de vacaciones aprobadas y solicitadas para la ubicación y los periodos elegidos, con opción de comparar rangos y exportar las tarjetas cuando trabaja en web.