Catálogo de reportes: cómo usarlo
Para qué sirve
El Catálogo de reportes reúne 47 reportes listos para usar, agrupados por tema (ventas, playa, inventario, rentabilidad, crédito, compras, tesorería, tributario y fidelización). Todos funcionan igual: eliges el reporte, pones la estación y el rango de fechas (y si quieres, un turno), pulsas Consultar y lo ves en pantalla con sus totales; si tienes permiso, lo exportas a Excel o PDF. Los reportes son de solo lectura: no cambian nada en el sistema.
Dónde está
/reportesCada reporte tiene su propia dirección, por ejemplo /reportes/ventas_por_producto, que puedes guardar
en favoritos.
Quién puede
Cada grupo del catálogo tiene su propio permiso. Solo verás los grupos (y los reportes) que tu rol tiene y que tu plan incluye:
| Grupo | Permiso |
|---|---|
| Ventas | Permisoreportes.ventas |
| Playa | Permisoreportes.playa |
| Inventario | Permisoreportes.inventario |
| Rentabilidad | Permisoreportes.rentabilidad |
| Crédito | Permisoreportes.credito |
| Compras y pagos | Permisoreportes.compras |
| Tesorería | Permisoreportes.tesoreria |
| Tributario y regulatorio | Permisoreportes.tributario |
| Fidelización | Permisoreportes.fidelizacion |
| Exportar a Excel o PDF (cualquier grupo) | Permisoreportes.exportar |
Además, tu plan debe incluir el módulo Reportes y, para algunos reportes, el módulo de donde salen los datos (por ejemplo, los de crédito exigen el módulo Créditos o Cobranzas; el comparativo de estaciones, el módulo multi-estación del plan Full).
Roles por defecto:
| Rol | Grupos que ve |
|---|---|
| Administrador | Todos, con exportación. |
| Administrador de Estación | Todos, con exportación. |
| Jefe de Playa | Playa y Ventas (sin exportar). |
| Cajero | Tesorería. |
| Créditos y Cobranzas | Crédito. |
| Almacén | Inventario y Compras y pagos. |
| Solo lectura (contador) | Todos los grupos de su plan, con exportación. |
Conceptos
- Rango de fechas: todos los reportes se filtran por Desde y Hasta (ambos incluidos). El rango máximo es de 366 días. Por defecto se propone del día 1 del mes actual hasta hoy.
- Fecha de negocio: las fechas son en hora de Lima. Los reportes de turnos usan la fecha operativa del turno; los de ventas por hora usan la hora real de la venta.
- Estación: el visor muestra tus estaciones asignadas y propone la activa. Si tienes acceso a dos o más estaciones, la lista empieza con Todas las estaciones, que suma los datos de todas las que tienes permitidas. Algunos reportes son de toda la empresa (cuentas por pagar, cuentas por cobrar, SIRE, fidelización): en ellos el filtro de estación no aplica y verás un aviso.
- Turno (opcional): puedes acotar el reporte a un turno concreto, combinado con el rango de fechas. Solo los reportes de ventas y algunos de playa usan este filtro; en los demás no cambia el resultado.
- Qué ventas cuentan: en los reportes de ventas solo cuentan las ventas emitidas (se excluyen las anuladas y las reemplazadas; el reemplazo cuenta como venta propia) y no los consumos internos. "Galones" suma combustibles líquidos y GLP vehicular; el GNV va aparte en m³.
- Totales del filtro completo: al pie verás los totales de todas las filas del filtro, no solo de la página que estás viendo. En promedios y porcentajes (ticket promedio, margen %, etc.) el total se recalcula sobre las sumas, no es un promedio de promedios.
- Decimales: galones con 3 decimales, soles con 2, precios y costos unitarios con 4, porcentajes con 2.
Paso a paso
Abrir un reporte
- Entra al catálogoMenú Reportes › Catálogo de reportes. Verás una tarjeta por grupo (Ventas, Playa, Inventario…) con el número de reportes disponibles.
- Elige el reportePulsa su nombre. Se abre el visor con el título del reporte.
Consultar
- Elige la estaciónEn Estación viene la activa. Con dos o más estaciones puedes elegir Todas las estaciones.
- Pon el rangoDesde y Hasta. Máximo 366 días.
- (Opcional) Elige un turnoEn Turno (opcional) escribe o elige el código del turno (se listan los últimos 50 de la estación). Para quitarlo pulsa Quitar turno. Al cambiar de estación el turno se limpia.
- Pulsa «Consultar»Verás, en este orden: los avisos (si hay), un gráfico de barras (si el reporte lo permite), la tabla paginada de 50 en 50 y la tarjeta Totales del filtro completo.
Antes de consultar, el visor muestra: "Elige el rango (y opcionalmente un turno) y pulsa Consultar." Si el filtro no devuelve nada: "El reporte no tiene datos con esos filtros."
El gráfico aparece automáticamente cuando el reporte tiene una columna de texto o fecha y una de soles (o galones), y hay 31 filas o menos (por ejemplo, ventas por producto o por hora). Con más filas no se dibuja para que sea legible.
Exportar a Excel o PDF
- Deja los filtros listosMismos filtros que usarías para consultar.
- Pulsa «Excel» o «PDF»Arriba a la derecha del visor. El botón se desactiva mientras se genera el archivo.
- Abre el archivoSe descarga como
reporte-<clave>-<desde>_<hasta>.xlsx(o-turno-<n>si filtraste por turno).
- Excel: todas las filas del filtro (máximo 50,000).
- PDF: hoja horizontal, máximo 2,000 filas. Para más datos usa Excel.
- La exportación no depende de la página que estés viendo: siempre lleva el filtro completo.
- Cada exportación queda registrada en la Auditoría (quién, qué reporte, qué filtros).
Volver al catálogo
Pulsa Catálogo (arriba a la izquierda del visor).
Reportes con PDF por fila
Algunos reportes tienen una columna con el botón Ver PDF que descarga un documento ya generado por el sistema (no se regenera): Liquidación de turno (PDF del cierre de turno), Parte diario (PDF del parte del día) y Estados de cuenta (PDF del estado de cuenta del cliente).
Campos del visor
| Campo | ¿Obligatorio? | Descripción |
|---|---|---|
| EstaciónLista | No | Tus estaciones asignadas. Por defecto, la activa. Con 2 o más estaciones aparece primero Todas las estaciones. |
| DesdeFecha | Sí | Primer día del rango. Por defecto, el día 1 del mes. |
| HastaFecha | Sí | Último día del rango. Por defecto, hoy. No puede ser anterior a Desde ni superar 366 días de rango. |
| Turno (opcional)Lista con búsqueda | No | Un turno de la estación elegida. Vacío = "Todos los turnos". |
Avisos dentro del reporte
Algunos reportes muestran un recuadro amarillo con avisos escritos en frases:
| Aviso (texto que verás) | Reporte | Qué significa |
|---|---|---|
| "Este reporte no se puede filtrar por estación: muestra los datos de todas tus estaciones." | Notas de despacho por canjear | El reporte abarca todas tus estaciones permitidas, aunque hayas elegido una. |
| "Hay movimientos anteriores a la primera descarga registrada del tanque: se valorizaron con su costo promedio actual, así que los montos son aproximados." | Variaciones y mermas valorizadas y reportes de margen | Para algún tanque el costo del día no estaba guardado y se reconstruyó: toma los montos como aproximados. |
| "Las ventas de GNV no se incluyen en el margen porque aún no tienen costo por tanque." | Reportes de margen | El GNV queda fuera del cálculo del margen. |
Mensajes de error frecuentes y qué hacer
| Mensaje | Por qué pasa | Qué hacer |
|---|---|---|
| "Indica el rango de fechas." | Falta Desde o Hasta. | Completa ambas fechas. |
| "La fecha "desde" no puede ser posterior a "hasta"." o "La fecha «hasta» debe ser igual o posterior a «desde»." | El rango está invertido. | Corrige las fechas. |
| "El rango no puede superar 366 días." | Rango demasiado largo. | Divide la consulta en dos periodos. |
| "No tienes reportes disponibles en tu plan o con tus permisos." | Tu rol no tiene ningún permiso de reportes o tu plan no incluye el módulo. | Pide al administrador los permisos reportes.*. |
| "El reporte no existe o no está disponible para ti." | Abriste un enlace a un reporte fuera de tu catálogo. | Vuelve al Catálogo y elige uno de la lista. |
| "No tienes permiso para exportar reportes." | Te falta Permisoreportes.exportar. | Consulta en pantalla o pide el permiso. |
| "Tu empresa superó el uso del plan: los exportes están suspendidos. El reporte en pantalla sigue disponible." | La empresa pasó el excedente de gracia de su plan. | Consulta en pantalla o amplía el plan. |
| "El exporte supera el máximo de 2000 filas." (PDF) o "…50000 filas." (Excel) | Demasiadas filas para el formato. | Acota el rango o usa Excel. |
| "Demasiadas exportaciones seguidas. Espera un minuto e inténtalo de nuevo." | Más de 30 exportaciones por minuto. | Espera un minuto. |
| "No se pudo cargar el reporte." + Reintentar | Falló la conexión. | Pulsa Reintentar. |
Lista de reportes por grupo
- Reportes de ventas y de playa — 16 reportes.
- Reportes de inventario y rentabilidad — 9 reportes.
- Reportes de crédito, compras y tesorería — 14 reportes.
- Reportes tributarios y de fidelización — 8 reportes.
Relación con otros módulos
- Parte diario — también disponible como reporte del grupo Playa.
- Auditoría — registra cada exportación.
- Indicadores (Dashboard) — la misma forma de contar ventas.
Ejemplo
El contador quiere las ventas de septiembre por producto para cuadrar con SIRE:
- Abre Ventas › Ventas por producto, estación "Grifo Central", Desde 01/09/2026, Hasta 30/09/2026.
- Pulsa Consultar: Diésel B5 S-50 — 36,410.250 gal — Valor venta S/ 509,393.27 — IGV S/ 91,690.79 — Total S/ 601,084.06; con el gráfico de barras por producto.
- Pulsa Excel y obtiene
reporte-ventas_por_producto-2026-09-01_2026-09-30.xlsx.