Seleccionar y comparar periodos
Elige uno o varios rangos de fechas en un informe de ubicación para recalcular el dashboard, comparar resultados y conservar el filtro al cambiar entre informes.
En este artículo
Este flujo sirve para revisar Reservas, Facturación, Productos u Horas trabajadas con un periodo concreto o con varios rangos comparables.
El filtro se aplica desde Filtros, viaja en el parámetro `periods` de la ruta y recarga el informe sin guardar preferencias permanentes.
Antes de empezar
- Sesión iniciada en Antylogic.
- Organización Grupo Marea Demo y ubicación Marea Gran Via seleccionadas.
- Acceso a reporting mediante `reports:view` o permisos equivalentes de TPV, catálogo, reservas o personal.
- Estar en una página de reporting de ubicación, como Reservas, Facturación, Productos u Horas trabajadas.
Instrucciones
- 1.
Abre un informe
Desde Marea Gran Via, entra en Reporting y abre un informe, por ejemplo Rendimiento > Reservas. La pantalla debe mostrar Filtros sobre los bloques del dashboard.
- 2.
Revisa el periodo activo
Cada tarjeta muestra Periodo 1, Periodo 2 si existe, su color de leyenda y el rango de fechas. Si la ruta no trae `periods`, la aplicación usa la semana actual de lunes a domingo y sincroniza ese valor en la ruta.
- 3.
Cambia un rango
Abre el selector de fechas del periodo, elige fecha inicial y fecha final, y confirma. Al completar el rango, el informe vuelve a cargar `GET /api/app/{orgId}/{locationId}/reports` con el nuevo `periods`.
- 4.
Añade una comparación
Pulsa Añadir periodo para crear un rango anterior al primero con la misma duración. Por ejemplo, `2026-06-01_2026-06-07` propone `2026-05-25_2026-05-31` como comparación.
- 5.
Quita periodos
Cuando hay más de un rango, usa Quitar en la tarjeta correspondiente. La interfaz mantiene siempre al menos un periodo visible y recarga el informe con la lista restante.
- 6.
Cambia de informe
Usa el menú lateral de Reporting para pasar a Facturación, Productos u otro informe. Los enlaces conservan `periods` cuando no está vacío y cada página recalcula sus propios bloques con los mismos rangos.
Validaciones y límites
- Formato esperado: `periods=YYYY-MM-DD_YYYY-MM-DD`; varios periodos se separan con `~`.
- Si falta fecha inicial o final, el cambio no se aplica.
- Si la fecha final queda antes de la inicial, la aplicación normaliza el rango para terminar en el mismo día de inicio.
- Los periodos se interpretan con la zona horaria de la ubicación, `Europe/Madrid` para Marea Gran Via.
- Si no hay ubicación seleccionada, la pantalla pide seleccionar una ubicación para consultar reportes.
- Si no hay permisos, la pantalla indica que no puedes ver reportes en esta ubicación.
- No hay validación explícita de solapamiento, fechas futuras, longitud máxima ni número máximo de periodos.
- Si `periods` es inválido, la interfaz puede mostrar la semana actual mientras el backend usa su fallback de dos periodos de 9 días.
Resultado esperado
El informe queda recalculado con los periodos seleccionados, la comparación usa los dos últimos rangos disponibles y el mismo filtro se conserva al navegar entre páginas de reporting.