Ayuda: Reportes por Dimensión

Visión general

Los reportes por dimensión agrupan las ventas según diferentes criterios de análisis. A diferencia de los reportes por período (que agrupan por tiempo), estos agrupan por quién vendió, qué se vendió, a quién y dónde.

Reporte	Agrupa por	Permiso	Pregunta que responde
Por artículo	Producto	507	¿Qué productos se venden más?
Por cliente	Cliente	508	¿Quiénes son mis mejores clientes?
Comparativo	Cliente × mes	508	¿Qué clientes gané o perdí?
Por agente	Vendedor	515	¿Cuánto vendió cada agente?
Contado agente	Vendedor (contado)	105	¿Cuánto en contado por agente?
Por usuario	Cajero	514	¿Quién facturó cada venta?
Por sucursal	Sucursal	516	¿Qué sucursal vende más?
Por categoría	Categoría producto	511	¿Qué líneas de producto rinden?
Por proveedor	Proveedor	517	¿Qué marcas/proveedores se venden?
Por territorio	Zona geográfica	520	¿Dónde están mis ventas?
Por actividad	Act. económica	518	¿Cómo se distribuyen por actividad?

Ventas por Artículo

Agrupa las ventas por producto. Muestra cuántas unidades se vendieron de cada artículo, el monto total y la utilidad.

Columnas principales

Código / Nombre — Identificación del artículo
Cantidad — Unidades vendidas en el período
Venta — Monto bruto vendido
Descuento — Descuentos otorgados
Costo — Costo total de las unidades vendidas
Utilidad — Ganancia (Venta − Descuento − Costo)
IVA — Impuesto generado

Tip Use este reporte para identificar sus productos estrella y los que generan más utilidad. No siempre el más vendido es el más rentable.

Fila de detalle (2026-05-13) Cada artículo tiene una segunda fila con información extendida: Costo, Venta, Descuento (% y monto), Utilidad (% y monto), Gravado, Exento, Exonerado, IVA y, si aplica, IVA Devuelto. Por default está recogida para mantener la tabla limpia. Usá el botón del extremo derecho del encabezado de tabla para expandir todas a la vez; volvé a tocarlo (icono cambia a ) para recoger.

Fix Categoría/SubCategoría (2026-05-13) En las bases de datos migradas al sistema nuevo de Categorías como texto libre (migración 771, ej. instalaciones con CABYS por palabras clave), las columnas Categoría y SubCategoría aparecían vacías en este reporte. Ahora se leen correctamente desde el artículo y se muestran tanto en pantalla como en los exports Excel/PDF.

Ventas por Cliente

Agrupa las ventas por cliente. Muestra cuánto compró cada cliente en el período.

Columnas principales

Código / Nombre / Cédula — Datos del cliente
Docs — Cantidad de facturas
Venta / Descuento / Costo / Utilidad — Montos acumulados
Gravado / Exento / IVA / Total — Desglose fiscal

Regla 80/20 Típicamente el 20% de sus clientes genera el 80% de sus ventas. Este reporte le ayuda a identificar quiénes son esos clientes clave.

Cliente × Artículo

Cruza clientes con artículos. Muestra qué productos compra cada cliente y en qué cantidades. Es el detalle máximo del análisis por cliente.

¿Para qué sirve?

Detectar los artículos favoritos de cada cliente
Identificar oportunidades de venta cruzada (si un cliente compra A pero no B)
Entender patrones de consumo para sugerencias personalizadas

Permiso Usa el mismo permiso 508 que "Por Cliente".

Caso de uso: Llamada proactiva Si un cliente solía comprar un artículo cada mes y dejó de hacerlo, este reporte se lo muestra. Perfecto para hacer seguimiento y reactivar ventas.

Comparativo de Clientes por Mes

Compara las compras de cada cliente mes a mes. Permite detectar clientes nuevos, clientes que dejaron de comprar y cambios en el volumen.

¿Cómo leerlo?

Cada fila es un cliente, cada columna es un mes
Las celdas muestran el total de compras de ese cliente en ese mes
Celdas vacías indican que el cliente no compró ese mes

Atención Si un cliente habitual aparece sin compras en los últimos meses, es una señal de alerta. Contacte al cliente para retenerlo.

Ventas por Agente

Agrupa por agente de ventas (vendedor asignado). Muestra el rendimiento de cada vendedor.

Columnas

Agente — Código y nombre del vendedor
Docs — Facturas generadas
Venta / Descuento / Utilidad — Montos del agente
Total — Venta neta con IVA

Tip Compare los descuentos otorgados por cada agente. Un agente con muchos descuentos puede estar usando rebajas para cerrar ventas, reduciendo la utilidad.

Ventas Contado por Agente

Similar a "Por Agente" pero solo muestra ventas de contado (no crédito). Útil para saber cuánto efectivo/tarjeta gestiona cada vendedor.

Permiso Requiere permiso 105 (mismo que consulta de facturas).

Ventas por Usuario

Agrupa por el usuario que facturó (cajero). Es diferente al agente: el usuario es quien operó el sistema, el agente es el vendedor asignado.

Diferencia entre Usuario y Agente

Concepto	Usuario	Agente
¿Quién es?	Quien creó la factura en el sistema	Vendedor asignado al cliente o a la factura
Ejemplo	La cajera María que digitó la venta	El vendedor Carlos que atendió al cliente
Puede ser distinto?	Sí. María puede facturar una venta de Carlos

Ventas por Sucursal

Agrupa por sucursal o punto de venta. Ideal para empresas con varias ubicaciones.

¿Para qué sirve?

Comparar rendimiento entre sucursales
Identificar la sucursal más y menos rentable
Planificar inventario por ubicación

Ventas por Categoría

Agrupa por la categoría del producto (ej: Alimentos, Bebidas, Electrónica). Muestra qué líneas de negocio generan más ingresos.

Tip Si una categoría tiene alta venta pero baja utilidad, revise los precios o costos de esos productos. Puede estar vendiendo volumen sin ganancia.

Ventas por Proveedor

Agrupa las ventas según el proveedor del artículo vendido. Muestra qué proveedores generan más ventas.

¿Para qué sirve?

Negociar mejores condiciones con proveedores de alto volumen
Identificar dependencia de un solo proveedor
Evaluar qué marcas prefieren los clientes

Ver los artículos de un proveedor En cada fila hay un botón Ver ventas (también podés hacer doble clic sobre la fila). Se abre en una pestaña nueva el reporte Ventas por Artículo ya filtrado a ese proveedor, mostrando el detalle de cada producto vendido (cantidad, costo, venta, utilidad, IVA). Se conservan las fechas y demás filtros que tengas aplicados.

Ventas por Territorio

Agrupa por la zona geográfica del cliente. Muestra de dónde vienen las ventas.

¿Para qué sirve?

Planificar rutas de distribución
Identificar zonas con potencial de crecimiento
Asignar agentes por zona según volumen

Requisito Las zonas deben estar asignadas a los clientes en el catálogo de clientes (módulo Clientes → Zonas).

Ventas por Actividad Económica

Agrupa según la actividad económica del emisor. Útil para empresas con múltiples actividades registradas ante Hacienda.

¿Para qué sirve?

Saber cuánto genera cada actividad económica
Preparar la declaración D104 por actividad
Evaluar si conviene mantener o cerrar alguna actividad

Filtros y exportación

Los reportes por dimensión comparten el mismo conjunto de 18 filtros estándar. La barra completa incluye:

Filtros comunes

Grupo	Filtros
Período	Fecha desde, Fecha hasta, Doc. desde, Doc. hasta
Documento	Tipo Doc., Estado (por defecto "Procesada")
Cliente	Cód. Cliente, Nombre Cliente
Vendedor	Usuario (cajero), Agente
Pago	Forma Pago, Medio Pago, Caja, Moneda
Ubicación	Modo Entrega, Sucursal, Bodega
Producto	Categoría / Subcategoría (modal de árbol)

Filtros específicos por reporte

Reporte	Filtros adicionales
Por Artículo	Código y nombre de artículo
Por Proveedor	Selector de proveedor
Por Territorio	Provincia, Cantón, Distrito, Barrio (encadenados)

Exportación

Excel (.xlsx) — Descarga con encabezado de empresa (parámetros 62 y 66), columnas completas y totales
PDF — Versión imprimible del reporte

Combine reportes Exporte varios reportes a Excel y cruce los datos con tablas dinámicas. Por ejemplo: combine "Por Artículo" con "Por Cliente" usando Cliente × Artículo como referencia.

Notas de crédito Todos los reportes restan automáticamente las notas de crédito (tipo 03). Si un agente o cliente recibió muchas NC, verá totales más bajos que la venta bruta.

Permisos del módulo

Cada reporte por dimensión tiene su propio permiso de acceso. Se asignan al grupo de usuarios desde el módulo de Seguridad (SE-001).

Código	Nombre	Qué autoriza	Módulo
`507`	Ventas por Artículo	Acceso al reporte agrupado por artículo con cantidad vendida, subtotal, IVA y utilidad.	VE-006
`508`	Ventas por Cliente	Acceso al reporte agrupado por cliente con totales y utilidad. Aplica también al reporte "Por Cliente-Artículo".	VE-007
`528`	Comparativo Clientes por Mes	Acceso al reporte de comparación mes a mes por cliente.	VE-010
`515`	Ventas por Agente	Acceso al reporte de ventas agrupado por agente de ventas con comisiones y utilidad.	VE-013
`519`	Ventas Contado por Agente	Acceso al reporte de ventas de contado desglosado por agente.	VE-014
`514`	Ventas por Usuario	Acceso al reporte agrupado por usuario del sistema (operador de caja).	VE-015
`516`	Ventas por Sucursal	Acceso al reporte agrupado por sucursal u oficina.	VE-016
`511`	Ventas por Categoría	Acceso al reporte agrupado por categoría y subcategoría de artículo.	VE-017
`517`	Ventas por Proveedor	Acceso al reporte agrupado por proveedor de los artículos vendidos.	VE-018
`520`	Ventas por Territorio	Acceso al reporte agrupado por zona geográfica asignada al cliente.	VE-019
`518`	Ventas por Actividad Económica	Acceso al reporte agrupado por actividad económica del emisor declarada en Hacienda.	VE-021

Sin permiso: acceso denegado Si el usuario no tiene el permiso del reporte específico, al intentar acceder es redirigido al menú principal con un mensaje de acceso denegado.

Parámetros de empresa

Los parámetros son valores globales por empresa que afectan el comportamiento de los reportes. Se configuran desde Configuración → Parámetros (CF-004).

Código	Nombre	Qué controla	Valores
`62`	Nombre comercial	Nombre de la empresa que aparece en el encabezado del PDF y del Excel exportado en todos los reportes por dimensión.	Texto libre
`249`	Moneda nacional	Moneda base de la empresa. Los reportes muestran los totales convertidos a esta moneda salvo que el usuario cambie el filtro.	Código ISO (ej: `CRC`, `USD`)
`77`	Cuenta contable de ventas por defecto	Código de cuenta contable usado en el reporte "Por Medio de Pago" para agrupar las ventas por cuenta. Afecta cómo se consolidan los montos cuando hay varios medios de pago asociados a la misma cuenta.	Código de cuenta (ej: `4101010001`)