🐍 Automatización de Reportes Excel con Python

Script de automatización desarrollado en Python que procesa archivos Excel de ventas, valida la estructura de datos, calcula totales automáticamente y genera reportes consolidados por cliente.

---

📸 Demo — Output en consola

============================================================
   SISTEMA DE AUTOMATIZACIÓN DE VENTAS - REPORTE FINAL
============================================================

✅ Archivo cargado correctamente: ventas.xlsx
✅ Estructura válida: 4 columnas encontradas
✅ Total calculado automáticamente por registro

------------------------------------------------------------
🏆 TOP 3 CLIENTES POR VENTA TOTAL
------------------------------------------------------------
1. Empresa ABC         →  $ 4,850,000
2. Distribuidora XYZ   →  $ 3,120,000
3. Comercial Norte     →  $ 2,740,000

------------------------------------------------------------
📊 ESTADÍSTICAS GENERALES
------------------------------------------------------------
Total de registros procesados : 45
Venta total acumulada         : $ 18,430,000
Promedio por cliente          : $ 1,536,000

------------------------------------------------------------
📁 ARCHIVOS GENERADOS EN /output
------------------------------------------------------------
✅ ventas_procesadas.xlsx
✅ resumen_clientes.xlsx
✅ estadisticas_generales.xlsx

============================================================

---

✅ Funcionalidades

• Lectura de archivo Excel con pandas
• Validación de existencia del archivo de entrada
• Validación de columnas obligatorias antes de procesar
• Cálculo automático de columna total por registro
• Generación de archivo Excel procesado
• Generación de resumen consolidado por cliente
• Ordenamiento de clientes por mayor venta total
• Generación de estadísticas generales (total, promedio, conteo)
• Visualización del top 3 de clientes en consola

---

🛠️ Tecnologías utilizadas

• Python 3 — lógica de automatización y procesamiento
• pandas — manipulación y análisis de datos
• openpyxl — lectura y escritura de archivos Excel

---

📁 Estructura del proyecto

python-excel-automation/
│
├── input/
│   └── ventas.xlsx          ← archivo Excel de entrada con los datos de ventas
│
├── output/                  ← carpeta generada automáticamente al ejecutar
│   ├── ventas_procesadas.xlsx
│   ├── resumen_clientes.xlsx
│   └── estadisticas_generales.xlsx
│
├── main.py                  ← script principal
├── requirements.txt         ← dependencias del proyecto
└── .gitignore

---

⚙️ Cómo ejecutar este proyecto

Requisitos previos

• Python 3.8 o superior instalado
• pip disponible en la terminal

Paso 1 — Clonar el repositorio

git clone https://github.com/sergiocl21/python-excel-automation.git
cd python-excel-automation

Paso 2 — Instalar las dependencias

pip install -r requirements.txt

Paso 3 — Preparar el archivo de entrada

Coloca tu archivo Excel dentro de la carpeta input/ con el nombre ventas.xlsx.

El archivo debe tener estas columnas obligatorias:

cliente	producto	cantidad	precio_unitario
Empresa ABC	Producto 1	10	50000
Distribuidora XYZ	Producto 2	5	80000

Paso 4 — Ejecutar el script

python main.py

Los archivos procesados se generan automáticamente en la carpeta output/.

---

📊 Archivos de salida generados

Archivo	Contenido
ventas_procesadas.xlsx	Datos originales con columna total calculada
resumen_clientes.xlsx	Venta total por cliente, ordenada de mayor a menor
estadisticas_generales.xlsx	Total acumulado, promedio y conteo de registros

---

💡 Qué demuestra este proyecto

• Automatización de procesos manuales con Python
• Manipulación y limpieza de datos con pandas
• Validación de estructura de datos antes de procesar
• Generación automática de reportes en Excel
• Organización de código en un script funcional y documentado

---

👤 Autor

Sergio Calderón

• GitHub: @sergiocl21
• Email: sergiocl21@gmail.com
• Medellín, Colombia

---

📄 Licencia

Este proyecto es de uso libre para fines educativos y de portafolio.