Ir al contenido principal
Explorar temas
calidad de datos

De una tabla de ventas a un reporte mensual confiable en PostgreSQL

Diagrama del proceso que transforma registros de ventas en un reporte mensual mediante reglas de negocio, agrupación y validación.
Un reporte mensual confiable combina reglas de negocio explícitas, agrupación por mes y controles sobre los datos.

De una tabla de ventas a un reporte mensual confiable en PostgreSQL

Un reporte mensual útil empieza con un acuerdo sobre qué se cuenta y cuándo. Antes de sumar importes, define la venta, los estados incluidos, la zona horaria y el tratamiento de impuestos y devoluciones. Después, comprueba que los datos y los totales responden a esas reglas.

1. Define el alcance del reporte

Documenta si cada fila representa una venta, un pedido o una línea de pedido: esa decisión determina qué significa contar filas. Acuerda también la moneda, el importe que se va a sumar, el período y la fecha que asigna cada operación a un mes.

Para importes decimales exactos, PostgreSQL ofrece numeric y decimal. La tabla 8.2 y la sección 8.1.2 de la documentación de tipos numéricos los describen como tipos exactos de precisión seleccionable y recomiendan numeric para importes monetarios. Elige la precisión, la escala y la política de redondeo según el dominio.

2. Agrupa por el comienzo del mes

Usar el inicio del mes como clave conserva el año y el mes, de modo que enero de un año no se mezcla con enero de otro. La sección 9.9.2 sobre date_trunc incluye month como precisión y permite especificar una zona horaria para una marca de tiempo con zona. Si no se especifica, se utiliza TimeZone de la sesión.

Por ejemplo, date_trunc('month', fecha_venta, 'America/Mexico_City') trunca una columna de tipo timestamp with time zone al inicio del mes en esa zona. La zona es ilustrativa y debe sustituirse por la acordada para el negocio.

3. Interpreta los conteos y los importes nulos

La tabla 9.62 de funciones agregadas indica que count(*) cuenta filas, count(importe) cuenta los importes no nulos y sum(importe) suma los valores no nulos. Calcula ambos conteos sobre las filas reales de ventas: si count(importe) es menor que count(*), hay importes faltantes.

Cuando un mes combina importes conocidos y nulos, la suma comprende solo los conocidos. Una regla prudente es mostrar ese resultado como total incompleto, junto con el número de importes faltantes, para que no se confunda con el total de todas las ventas del mes.

La sección 9.21 también indica que sum devuelve NULL cuando no hay filas de entrada. El mismo resultado para un grupo con todos los importes nulos se deduce de que los agregados integrados normalmente descartan entradas nulas, según la sección 4.2.7 sobre expresiones de agregación; los pasajes disponibles no presentan un ejemplo explícito de ese caso. No conviertas automáticamente todo NULL en cero: un mes sin ventas y uno con ventas de importe desconocido requieren una interpretación acordada.

4. Incluye los meses sin registros

Una forma de mostrar todos los meses del período es generar un calendario con generate_series, descrita en la tabla 9.69, agregar las ventas por mes y unir ambos resultados con un LEFT OUTER JOIN, descrito en la sección 7.2.1.1. La primera función admite marcas de tiempo de inicio y fin y un intervalo; la unión conserva cada fila del calendario aunque no encuentre una venta agregada correspondiente.

Como criterio de presentación, puedes mostrar cero para un mes sin ventas si esa es la regla acordada. Si existen ventas pero sus importes son desconocidos, conviene mostrar el importe como pendiente. Si solo faltan algunos importes, muestra la suma conocida como incompleta.

Cuatro casos de presentación mensual: total completo, mes sin ventas, importes pendientes y suma conocida incompleta.
Un mes sin ventas y uno con importes desconocidos requieren interpretaciones distintas; una suma parcial debe identificarse como incompleta.

5. Valida antes de distribuir el resultado

  • Revisa posibles duplicados según el identificador y el nivel de detalle definidos para la venta.
  • Cuenta los importes y fechas faltantes y acuerda cómo se tratarán.
  • Comprueba que los filtros de estado y el tratamiento de devoluciones coincidan con las reglas del negocio.
  • Revisa operaciones cercanas al cambio de mes en la zona horaria acordada.
  • Concilia los conteos y totales con una fuente de referencia apropiada y explica las diferencias.

Estos controles son recomendaciones prácticas. No se proporcionaron esquema, datos, versión instalada ni reglas concretas, por lo que no se ha ejecutado ni validado una consulta para este caso. Los enlaces corresponden a PostgreSQL 18; consulta la documentación de la versión instalada antes de implementar el reporte.

Comentarios

Buscar este blog