Ver informe de productos
Consulta qué productos se han vendido en una ubicación, cuántas unidades han salido, cuánto dinero han generado y cuánto tardan de media en cocina.
En este artículo
El informe de productos reúne la lectura comercial y operativa de la carta vendida. En Marea Gran Via permite revisar unidades, ingresos y tiempo medio de cocina por producto a partir de tickets reales del TPV.
La vista trabaja siempre sobre una ubicación y uno o varios periodos. Se abre desde Reportes > Catálogo > Productos y permite comparar rangos, buscar por nombre y exportar las filas visibles en web.
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`.
- Actividad TPV dentro del periodo consultado, con tickets y líneas no canceladas, para que la tabla muestre productos vendidos.
- Productos y categorías configurados en el catálogo para mostrar `Nombre de categoría`; si falta la relación, el informe usa el fallback operativo disponible.
Instrucciones
- 1.
Abrir el informe de productos
Desde la ubicación seleccionada, entra en Reportes > Catálogo > Productos. La ruta directa es `/:orgId/:locationId/reporting/catalog/products` y carga datos solo de esa ubicación.
- 2.
Revisar el resumen de ventas
Comprueba el bloque de totales para ver `Unidades vendidas` y `Dinero ganado` en el periodo activo. Si la URL no trae periodo, la pantalla usa por defecto la semana actual.
- 3.
Analizar productos vendidos
Lee la tabla `Productos vendidos`: muestra nombre, categoría, unidades, dinero ganado por unidad, dinero ganado total y tiempo medio de cocina. En Marea Gran Via, ejemplos de catálogo son Croquetas de jamon, Patatas bravas Marea, Pulpo a la brasa y Arroz meloso de carabinero cuando existan ventas en el periodo.
- 4.
Cambiar o comparar periodos
Ajusta el filtro para cambiar el rango o añadir otro periodo. Los enlaces conservan los rangos en `periods` con formato `YYYY-MM-DD_YYYY-MM-DD`; varios periodos se separan con `~`.
- 5.
Buscar un producto
Usa el buscador de la tabla para localizar productos por nombre. La búsqueda filtra localmente las filas visibles y no modifica el dashboard recibido.
- 6.
Exportar lo visible en web
En web, abre el menú de exportación de la tabla para descargar CSV, Excel o PNG con las filas que siguen visibles después de aplicar la búsqueda.
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 página consume `GET /api/app/{orgId}/{locationId}/reports?periods=...` y extrae `pages.products` del dashboard completo.
- Los items cancelados no entran en la agregación y las unidades vendidas no suman cantidades negativas.
- El tiempo medio de cocina solo usa items que requieren cocina y tienen marcas válidas de inicio y fin.
- Si no hay productos vendidos en el periodo, la tabla muestra `No hay productos vendidos para los filtros seleccionados.`.
- La búsqueda solo filtra por la primera celda de cada fila, el nombre del producto; no filtra por categoría, ingresos ni tiempo de cocina.
- La acción es de solo lectura: no crea, edita ni elimina productos, tickets ni líneas.
- Las exportaciones están disponibles solo en web; en nativo se muestra `Exportación no disponible`.
Resultado esperado
El responsable del local puede detectar qué productos concentran unidades e ingresos, revisar su tiempo medio de cocina y comparar el rendimiento entre periodos sin salir del dashboard de reporting.