Un script de Python que combina muchos archivos CSV y Excel en una sola tabla, con las columnas alineadas

Ejemplo de resultado

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Carpeta: sales/2026-10, 9 archivos encontrados
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 filas
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 filas
2026-11-02 09:14:04 WARN  shop-07.csv: 3 filas sin precio omitidas (líneas 88, 412, 913)
2026-11-02 09:14:05 INFO  Listo: 10.412 filas -> report-2026-10.xlsx (hojas “Ventas” y “Totales”)

[columns]
date = Fecha, Fecha de venta, Día
product = Producto, Artículo, Nombre
quantity = Cant., Cantidad, Uds.
price = Precio, Precio unitario

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lee el archivo de una tienda y le da los nombres de columna del informe."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: no hay columna para '{name}' (se buscó {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Acerca de este servicio

Exportaciones mensuales, informes de sucursales, archivos de varios proveedores: cuando los mismos datos llegan en decenas de archivos CSV y Excel, copiarlos a mano en una tabla es lento y fácil de hacer mal. Este script de Python lee todos los archivos de la carpeta que indique, incluidas varias hojas de un mismo libro, alinea las columnas por nombre, añade una columna con el archivo de origen y guarda un solo archivo CSV o Excel. Desde Estándar admite columnas con nombres distintos en distintos archivos y lleva un registro de las filas que no pudo leer. Envíenos dos o tres archivos de ejemplo con unas pocas filas cada uno. Lo ejecuta usted en su ordenador. Excel admite hasta 1.048.576 filas por hoja, así que un resultado mayor se guarda como CSV.

Qué incluye

• Qué recibeUn archivo ZIP con el script de Python, un README con instrucciones paso a paso y, desde Estándar, un archivo de configuración con su carpeta y los nombres de columnas; el código también se muestra en la página del pedido.
• CSV y Excel juntosArchivos de ambos tipos en una carpeta, varias hojas por libro
• Columnas alineadasPor nombre, aunque el orden cambie entre archivos
• Columna de origenCada fila indica de qué archivo procede
• Codificaciones y separadoresComas o puntos y coma, UTF-8 o codificaciones antiguas de Windows
• Código legibleCon comentarios, fácil añadir una columna más adelante

Cómo funciona

1. 1
   EjemplosUsted envía dos o tres archivos de ejemplo y dice cómo debe ser el resultado
2. 2
   CódigoEscribimos el script y la guía para ejecutarlo
3. 3
   PruébeloLo ejecuta con una copia de su carpeta y comprueba los totales
4. 4
   CambiosPide cambios dentro de su paquete y nos envía cualquier mensaje de error

Qué necesitamos de usted

Dos o tres de los archivos que combina, reducidos a unas pocas filas (cambie nombres o importes reales si quiere), cuántos archivos hay aproximadamente y de qué tamaño, y cómo debe ser el resultado: CSV o Excel, qué columnas y en qué orden, y si deben quedarse las filas repetidas. Si los archivos difieren (otros nombres de columna, filas de encabezado extra), un ejemplo de cada tipo. Su sistema: Windows, macOS o Linux.

Le preguntaremos:

• ¿Qué archivos combina?
• ¿Cómo debe ser el resultado?
• ¿Difieren los archivos?
• ¿Dónde se ejecutará?

Comparar paquetes

Preguntas y respuestas

¿No encontró su respuesta? Pregúntenos