Ver informe de categorías
Consulta el rendimiento de las categorías de producto de una ubicación por periodo, con unidades vendidas y dinero ganado a partir de las ventas TPV registradas en tickets.
En este artículo
El informe de categorías ayuda a entender qué familias de producto pesan más en la venta real del local. En Marea Gran Via, la vista agrupa los tickets vendidos por categoría de producto y muestra unidades e ingresos en formato de reporte.
La consulta siempre trabaja sobre una ubicación y un periodo concretos. Puedes abrirla desde Reportes > Catálogo > Categorías o mediante una ruta directa con uno o varios periodos codificados.
Antes de empezar
- Sesión iniciada en Antylogic con organización y ubicación seleccionadas, por ejemplo Grupo Marea Demo y Marea Gran Via.
- Permiso de ubicación suficiente para acceder a reportes: al menos uno de `reports:view`, `tpv:view`, `tpv:use`, `catalog:view`, `reservation:view` o `staff:view`.
- La ubicación debe existir y tener una zona horaria válida; si no se puede leer, el cálculo de periodos cae a UTC.
- Para ver filas con datos, el periodo debe contener sesiones de servicio, tickets no anulados y líneas de ticket no canceladas.
- Los productos vendidos deben estar asociados a un tipo de producto o tener `KitchenName`; si no, el informe los agrupa como `Sin categoría`.
Instrucciones
- 1.
Abrir el informe de categorías
Desde la ubicación Marea Gran Via, entra en Reportes > Catálogo > Categorías. La ruta directa es `/:orgId/:locationId/reporting/catalog/categories` y muestra datos solo de la ubicación seleccionada.
- 2.
Seleccionar el periodo de consulta
Usa el filtro de periodos para revisar una semana, varios días o una comparación. El formato de ruta es `YYYY-MM-DD_YYYY-MM-DD`; varios rangos se separan con `~`.
- 3.
Leer el resumen
Revisa `Unidades vendidas` y `Dinero ganado`. Estos totales proceden de tickets e items vendidos dentro del rango, no del catálogo maestro por sí solo.
- 4.
Consultar la tabla por categoría
La tabla muestra `Nombre de categoría`, `Unidades vendidas` y `Dinero ganado`. La búsqueda filtra localmente por nombre de categoría y no lanza una nueva consulta al backend.
- 5.
Comparar periodos
Añade un segundo periodo para ver cada métrica como serie por rango. Si una categoría no tuvo ventas en un periodo concreto, ese periodo se muestra con `0` y `0,00 €`.
- 6.
Exportar resultados en web
En web, abre el menú de la tarjeta de tabla para descargar las filas visibles como CSV, Excel o PNG. En nativo, la exportación se bloquea con el aviso `Exportación no disponible`.
Validaciones y límites
- Sin organización o ubicación seleccionada, la pantalla muestra `Selecciona una ubicación para consultar reportes.` y no consulta datos.
- Sin permisos suficientes, la pantalla muestra `No tienes permisos para ver reportes en esta ubicación.`; el backend también valida el acceso.
- Durante la carga se muestra `Cargando reportes...`; si falla la consulta, se muestra `No pudimos cargar los datos del reporte.`.
- La API usada es `GET /api/app/{orgId}/{locationId}/reports?periods=...`; la página extrae `pages.categories` del dashboard completo.
- No existe un endpoint específico de categorías ni filtros backend por categoría, producto, orden, paginación o búsqueda.
- Solo entran tickets cuyo estado no sea `void` y líneas cuyo `ProductionStatus` no sea `cancelled`.
- Las categorías se resuelven por tipo de producto, luego por `TicketItem.KitchenName` y finalmente por `Sin categoría`.
- Las filas se ordenan por ingresos del último periodo, de mayor a menor; los empates se ordenan alfabéticamente.
- La acción es de solo lectura: no crea, edita ni elimina categorías, productos, tickets ni líneas.
Resultado esperado
El responsable del local puede revisar qué categorías concentran unidades e ingresos en el periodo seleccionado y comparar su peso entre rangos sin salir del dashboard de reporting.