Documentación del Sistema

Appearance

🧾 Especificación técnica — Informe: Ventas por provincias por rubros ​

1. Ubicación y propósito funcional ​

Ubicación: Ventas → Informes → Ventas por provincias → Por rubros
Objetivo: Presentar un resumen de todas las ventas agrupadas por rubro, con totalización por provincia y porcentaje relativo del total general.
El informe permite identificar la distribución geográfica de las ventas por categoría de producto.

2. Arquitectura y desarrollo ​

El desarrollo se realiza sobre la plataforma Legacy (PHP SSR).
El informe se implementa como un modal simple, invocado desde la sección de Ventas por provincias, reutilizando la lógica de generación y exportación de reportes ya existente.

Características técnicas:

  • No es una vista completa; se abre en un modal dentro del formulario principal.
  • Desarrollado sobre el mismo entorno de históricos de ventas y reportes estadísticos.
  • Compatible con la exportación PDF actual del sistema.
  • Utiliza helpers y plantillas comunes del módulo de informes (mod-ventas).

3. Formulario de parámetros ​

Rango de rubros

  • Campos: Desde y Hasta.
  • Se completan automáticamente con el primer y último rubro disponibles.
  • Permite delimitar el conjunto de rubros a incluir en el reporte.
  • Autocompletado legacy por nombre o código de rubro.

Rango de fechas

  • Campos: Desde y Hasta.
  • Obligatorios para la generación del informe.

Notas:

  • No posee checks adicionales ni condiciones de venta.
  • Estructura simple orientada a selección y ejecución inmediata.

4. Formato del informe (según PDF de ejemplo) ​

Encabezado

  • Razón social de la empresa.
  • Rango de fechas.
  • Fecha de impresión y número de página.
  • Título del reporte: “Listado de ventas por Rubro y Provincia”.

Cuerpo

  • Agrupación principal por Provincia.
  • Dentro de cada provincia, listado de rubros con sus importes.
  • Totales parciales por provincia y total general final.

Columnas

  • Rubro
  • Importe

Totales

  • Subtotal por provincia: suma de importes provinciales.
  • Total general: suma de todas las provincias.

5. Observaciones ​

  • Modal Legacy PHP con render SSR.
  • Usa la misma estructura de exportación y estilos del resto de los informes de ventas.
  • Permite futura extensión para filtrar por zona o vendedor, manteniendo la base funcional.
  • Compatible con impresión y exportación directa a PDF.
  • Contemplar correcta lógica de salto de página.
  • Las ventas están compuestas por Facturas (Ventas propiamente concretadas) y Notas de crédito (Ajustes de la factura o devolución). Si hay devolución esto impacta negativamente en las ventas realizadas.