Ayuda: Reportes por Período

Visión general

Los reportes por período agrupan las ventas según intervalos de tiempo, desde el detalle línea por línea hasta resúmenes mensuales.

Reporte	Nivel de detalle	Permiso	Uso típico
Detalladas	Cada línea de cada factura	502	Auditoría, verificar artículos vendidos
Por Día	Total por fecha	503	Control diario de ventas
Por Semana	Total por semana	505	Tendencia semanal
Por Mes	Total por mes	506	Comparar meses, planificación

Notas de crédito Las notas de crédito (tipo 03) se restan automáticamente de los totales. Aparecen con valores negativos en los reportes.

Ventas Detalladas

Muestra cada línea de cada factura: artículo, cantidad, precio, descuento, IVA y total. Es el reporte más granular.

Vista de una sola fila (2026-04-20) A diferencia del resto de reportes, VE-002 muestra todos los campos en una sola fila con 28 columnas visibles a la vez (sin acordeón). La tabla se desplaza horizontalmente dentro del contenedor. Esto permite ver todos los datos de cada línea sin hacer clic para expandir.

Columnas (28 en total, en orden)

Fecha — Fecha/hora de la factura
Factura — Número de documento (clic abre detalle)
Cliente — Nombre del cliente (clic abre modal)
Artículo — [Código] Nombre (clic abre modal)
Cant. — Unidades vendidas
Subtotal — Venta menos descuento
Total — Monto final de la línea
Tipo — FE, TIQ, NC, ND, FCO, FEX
Id — Código del cliente
N.Com — Nombre comercial
Ced — Cédula del cliente
Costo — Costo total de la línea
Venta — Monto bruto (antes de descuento)
Desc — Descuento aplicado
Desc% — Descuento como porcentaje
Util — Utilidad (Subtotal − Costo)
Util% — Utilidad sobre costo
Grav — Monto gravado
Exen — Monto exento
Exon — Monto exonerado
IVA — Impuesto calculado
IVADev — IVA devuelto (Hacienda)
Disp.NC — Cantidad disponible para NC (solo facturas)
Disp.ND — Cantidad disponible para ND (solo facturas)
Usr — Usuario que facturó
Ag — Agente de la factura
Zona — Zona del cliente
Cat — Categoría > Subcategoría del artículo

Filtros adicionales

Artículo — Buscar un producto específico (código o nombre)
Detalle — Texto dentro del detalle de la factura
Zona — Filtrar por zona del cliente
Categoría — Modal con árbol categoría/subcategoría
Utilidad — Filtrar por operador (>, >=, <, <=, =, <>) y un valor

Ordenamiento

Clic en los encabezados Fecha, Factura, Artículo, Cant., Subtotal, Total para ordenar ascendente/descendente.

Tip Use este reporte para verificar exactamente qué se vendió, a quién y a qué precio. Ideal para auditorías, conciliaciones y análisis de utilidad por línea. Para notas de crédito (NC) los montos aparecen con signo negativo.

Tabla ancha La tabla tiene 28 columnas; hay scroll horizontal dentro del contenedor. En pantallas pequeñas puede ser más cómodo exportar a Excel o usar el botón de impresión.

Ventas por Día

Agrupa las ventas por fecha. Muestra una fila por cada día con los totales consolidados.

Columnas

Fecha — El día
Día — Nombre del día de la semana (Lunes, Martes...)
Docs — Cantidad de documentos emitidos
Costo / Venta / Descuento / Subtotal — Montos agregados
Utilidad — Ganancia del día
Gravado / Exento / Exonerado / IVA — Desglose fiscal
Total — Venta total del día

Rango por defecto Al abrir muestra el día de hoy. Cambie las fechas para ver otros períodos.

Ventas por Semana

Agrupa por número de semana del año. Cada fila muestra la fecha de inicio y fin de la semana.

¿Cómo se calculan las semanas?

Se usa el estándar SQL Server DATEPART(WEEK). La semana 1 comienza el primer domingo del año. Cada fila muestra las fechas exactas de inicio y fin para evitar confusiones.

Columnas

Las mismas que "Por Día", pero agrupadas por semana: Docs, Costo, Venta, Descuento, Subtotal, Utilidad, Gravado, Exento, Exonerado, IVA, Total.

Rango por defecto Muestra los últimos 3 meses al abrir.

Ventas por Mes v2.3 — Vista comparativa

Reporte comparativo por periodo (año). Muestra una fila por mes (Enero → Diciembre) con columnas de Documentos, Total y Utilidad para cada año seleccionado, además de una columna Variación que indica si las ventas subieron o bajaron respecto al año anterior.

Filtros de Periodo

En vez de fechas individuales, se eligen dos años:

Filtro	Descripción
Periodo desde	Año más viejo a comparar (default: año actual)
Periodo hasta	Año más reciente a comparar (default: año actual)

El sistema lista automáticamente los años disponibles en la base de datos. Si Desde = Hasta, se ve solo un año (sin columna de variación).

Cómo leer la tabla

Columna	Significado
Mes	Nombre del mes (Enero, Febrero, …, Diciembre). Ordenados de Enero a Diciembre.
Docs (por año)	Cantidad de documentos emitidos ese mes/año
Total (por año)	Total facturado en colones
Util (por año)	Utilidad (Subtotal − Costo) en colones
Variación	▲ X% = aumentó · ▼ X% = bajó · — = sin comparación o sin cambio

La fila TOTAL al pie suma los doce meses por año, con su variación global.

Ejemplo

Si seleccionás Periodo Desde 2025 y Periodo Hasta 2026:

Verás 12 filas (Enero a Diciembre).
Cada fila muestra los datos de 2026 y de 2025 lado a lado.
La columna Variación indica cuánto creció (o bajó) el Total de 2026 vs 2025 en ese mes específico.

Si un mes solo tiene datos en un año, las columnas del otro aparecen con "—" (sin venta).

Versión móvil En celular (ancho ≤ 900px) se muestra una card por mes con los años apilados verticalmente, también con la variación al lado. Misma información, layout vertical optimizado.

Tip Para ver un solo año en detalle, pone Periodo Desde = Periodo Hasta (ej. 2026 a 2026). Para comparar varios años, elegí el rango y el sistema agrupa todo en la misma tabla.

Filtros comunes

Todos los reportes de la familia comparten un conjunto estándar de 18 filtros, agrupados por tipo:

Período y documento

Filtro	Descripción
Fecha desde / hasta	Rango de fechas a consultar (obligatorio)
Doc. desde / Doc. hasta	Rango de números de documento
Tipo Doc.	Factura (01), Tiquete (04), Exportación (09), NC (03), ND (02)
Estado	Por defecto muestra "Procesada" (estado 2). Cambiar para incluir borradores, anuladas, etc.

Cliente y vendedor

Filtro	Descripción
Cód. Cliente / Nombre Cliente	Filtrar por cliente específico
Tipo Cliente	Segmenta por la clasificación del cliente (Mayorista, Minorista, Distribuidor, etc. — según el catálogo configurado en Tipos de Cliente). Útil en Ventas por Mes (VE-005) para comparar cómo se comporta cada segmento de clientes mes a mes.
Usuario	Cajero que emitió la factura
Agente	Vendedor asignado a la factura

Pago y ubicación

Filtro	Descripción
Forma Pago	Contado, crédito, etc.
Medio Pago	Efectivo, tarjeta, transferencia
Caja	Número de caja
Moneda	CRC o USD. Las facturas en USD se convierten al tipo de cambio del día de cada factura
Modo Entrega	Local, a domicilio, retiro en tienda
Sucursal / Bodega	Sucursal o bodega específica

Filtro de categoría (modal)

El filtro de Categoría / Subcategoría abre un modal con el árbol de categorías del catálogo. Permite buscar las ventas de un grupo específico de artículos aunque haya miles de productos distintos.

Seleccione la categoría para ver todas sus subcategorías
Opcionalmente seleccione una subcategoría específica
El filtro se aplica como condición EXISTS sobre las líneas de la factura

Filtros específicos adicionales

Ventas Detalladas agrega filtros de Artículo, Zona del cliente y Utilidad (por operador).
Reportes específicos como Por Proveedor o Por Territorio añaden campos propios (proveedor, provincia/cantón/distrito).

Totales y fórmulas

Regla crítica Los totales siempre se calculan desde las líneas de detalle (Vista_Venta_Hija), nunca desde el encabezado de la factura. Esto garantiza exactitud.

Fórmulas

Campo	Fórmula
VentaReal	Venta − Descuento
Utilidad	Venta − Descuento − Costo
% Utilidad	(Utilidad ÷ Costo) × 100 — margen sobre costo
Total	Gravado + Exento + Exonerado + IVA − IVA devuelto

% Utilidad sobre costo El porcentaje de utilidad se calcula sobre el costo (no sobre la venta). Ejemplo: si el costo es ₡1,000 y la utilidad es ₡500, el margen es 50%.

Exportar datos

Todos los reportes tienen botón de exportación:

Excel — Descarga un archivo .xlsx con todos los datos de la tabla, incluyendo los totales
PDF — Genera un PDF con el reporte formateado para imprimir

Tip Para análisis avanzado, exporte a Excel y use tablas dinámicas para cruzar datos de diferentes formas.

Consejos

Empezar por lo general, ir al detalle: Comience con "Por Mes" para ver la tendencia, luego "Por Día" para identificar días específicos, y "Detalladas" para ver las líneas exactas.
Filtrar por sucursal: Si tiene varias sucursales, compare el rendimiento de cada una usando el filtro de sucursal.
Cuidado con las NC: Las notas de crédito aparecen con valores negativos y se restan del total. Si ve un día con venta baja, revise si hubo muchas NC.
Moneda USD: Las facturas en dólares se convierten a colones al tipo de cambio del día de la factura. El total siempre se muestra en la moneda seleccionada en el filtro.
Rango amplio: No consulte rangos mayores a 6 meses en "Detalladas" ya que puede generar miles de filas y tardar en cargar.

Permisos del módulo

Cada reporte por período 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
`502`	Ventas Detalladas	Acceso al reporte de ventas línea por línea (artículo, cantidad, precio, descuento, IVA y total por línea).	VE-002
`503`	Ventas por Día	Acceso al reporte agrupado por fecha de emisión.	VE-003
`505`	Ventas por Semana	Acceso al reporte agrupado por semana calendario.	VE-004
`506`	Ventas por Mes	Acceso al reporte agrupado por mes y año.	VE-005

Sin permiso: acceso denegado Si el usuario no tiene el permiso del reporte, 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.	Texto libre
`66`	Cédula jurídica	Número de cédula que aparece en el encabezado de la exportación PDF.	Texto (ej: `3-101-123456`)
`249`	Moneda nacional	Moneda base de la empresa. Los reportes muestran los totales en la moneda seleccionada en el filtro, usando el tipo de cambio del día de cada factura para convertir.	Código ISO (ej: `CRC`, `USD`)