Un script de Python que convierte sus exportaciones de contactos en un CSV limpio listo para importar en su servicio de email marketing

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

Los contactos exportados de una tienda, un CRM o las inscripciones a un evento rara vez coinciden con lo que un servicio de email marketing quiere importar: otros nombres de columna, nombre y apellidos en una celda, etiquetas en sitios raros, personas que se dieron de baja aún en la lista. Este script de Python lee sus exportaciones y escribe un CSV limpio con la estructura de importación de su servicio: nombres separados si hace falta, campos y etiquetas asignados, correos mal formados y duplicados excluidos y, desde Estándar, solo las personas con marca de consentimiento, sin las dadas de baja, con un archivo de filas descartadas para que usted lo revise. Es para sus propios contactos que aceptaron recibir noticias suyas, nunca para listas compradas o extraídas de webs. Funciona en su ordenador y no se conecta al servicio; usted importa el archivo.

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 la correspondencia de campos y etiquetas; el código también se muestra en la página del pedido.
• La estructura de su servicioSegún su plantilla de importación o un archivo de muestra
• Consentimiento respetadoDesde Estándar, solo quien aceptó, sin bajas
• Fuera duplicados y erratasDirecciones mal formadas y repeticiones excluidas
• Filas descartadas guardadasUn archivo aparte que muestra qué se excluyó y por qué
• Código legibleCon comentarios, fácil añadir un campo más adelante

Cómo funciona

1. 1
   MuestrasUsted envía filas inventadas de cada exportación y el formato de importación de su servicio
2. 2
   CódigoEscribimos el script y la guía para ejecutarlo
3. 3
   PruébeloLo ejecuta, revisa las filas descartadas e importa una pequeña lista de prueba
4. 4
   CambiosPide cambios dentro de su paquete y nos envía cualquier mensaje de error

Qué necesitamos de usted

El encabezado y 10-20 filas de cada exportación con nombres y correos inventados pero la misma estructura, qué columna indica el consentimiento y cuál la baja, el servicio de email marketing que usa y su plantilla de importación o un enlace a su página de ayuda de importación, y cómo deben configurarse las etiquetas o segmentos. Cómo se recogieron los contactos (su tienda, formulario de alta, eventos). No envíe nunca la lista real.

Le preguntaremos:

• ¿De dónde salen los contactos?
• ¿En qué servicio de email marketing los importará?
• ¿Cómo se registra el consentimiento?
• ¿Necesita etiquetas o segmentos?

Comparar paquetes

Preguntas y respuestas

¿No encontró su respuesta? Pregúntenos