Cómo consultar el dashboard de Reportes por periodos
Abre una página de Reportes de una ubicación y compara sus indicadores agregados por uno o varios periodos. En el demo ES, el ejemplo usa Grupo Marea Demo, Marea Gran Via y dos semanas comparadas en Reservas o Facturación.
En este artículo
El dashboard de Reportes siempre trabaja sobre la ubicación activa. Aunque el responsable esté viendo una página concreta, como Reservas o Facturación, Antylogic carga el conjunto agregado de secciones y páginas disponibles para esa ubicación.
Este flujo ayuda a revisar qué cambió entre semanas sin exportar archivos: el filtro de periodos se mantiene al cambiar de reporte y cada pantalla muestra los bloques que corresponden a su ruta.
Antes de empezar
- Tener sesión iniciada con organización y ubicación seleccionadas.
- Para reproducir el ejemplo del demo ES, usar Grupo Marea Demo y la ubicación Marea Gran Via.
- Tener en la ubicación alguno de estos permisos: `reports:view`, `tpv:view`, `tpv:use`, `catalog:view`, `reservation:view` o `staff:view`.
- Abrir una pantalla de Reportes desde el menú lateral o mediante una ruta directa de reporting.
Instrucciones
- 1.
Abre Reportes
Desde Marea Gran Via, entra en el menú lateral Reportes y abre una página como Rendimiento > Reservas o Ventas > Facturación. La consulta siempre queda limitada a la ubicación activa.
- 2.
Revisa los periodos
Comprueba el filtro superior. Para el ejemplo documentado, usa `2026-06-01_2026-06-07~2026-05-25_2026-05-31`, que la pantalla presenta como Periodo 1 y Periodo 2.
- 3.
Carga el dashboard
Al abrir la página o cambiar los rangos, Antylogic consulta `GET /api/app/{orgId}/{locationId}/reports` con el query `periods`. La respuesta trae las secciones y páginas de reporting, y la pantalla muestra la página que corresponde a la ruta activa.
- 4.
Analiza la página activa
En Reservas, revisa el resumen, la tabla por origen y la distribución por horarios. En Facturación, revisa los bloques financieros derivados de tickets, pagos e invoices para los mismos rangos.
- 5.
Cambia de reporte con los mismos rangos
Al pasar a otra página de Reportes, la navegación conserva `periods`. Así puedes comparar Reservas y Facturación sin volver a configurar las fechas.
Validaciones y límites
- Si no hay organización o ubicación seleccionada, la pantalla muestra: `Selecciona una ubicación para consultar reportes.`
- Si el usuario no tiene un permiso admitido, la pantalla muestra: `No tienes permisos para ver reportes en esta ubicación.`
- Los periodos se representan como rangos `YYYY-MM-DD_YYYY-MM-DD` separados por `~`.
- Si la ruta no trae periodos, la pantalla crea un periodo semanal por defecto.
- Durante la consulta aparece: `Cargando reportes...`; si falla, aparece: `No pudimos cargar los datos del reporte.`
- Si la respuesta no contiene la página esperada, la pantalla muestra: `No encontramos la configuración de este reporte.`
- Las secciones implementadas son `sales`, `catalog`, `performance` y `employees`.
- El endpoint es de solo lectura y no genera exportaciones ni descargas; la exportación de bloques pertenece a `reporting.export-card`.
Resultado esperado
El dashboard de la ubicación queda cargado con los periodos comparados, la página activa muestra sus bloques de reporting y el responsable puede cambiar a otro reporte conservando los mismos rangos.