Un script de Python que pone en orden su propia lista de contactos: un formato para nombres, teléfonos y correos, y sin duplicados

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

Una lista de contactos reunida durante años desde una tienda, un CRM y hojas de cálculo acaba con la misma persona tres veces, teléfonos escritos de cinco formas y correos con espacios o erratas. Este script de Python limpia su propia lista en su ordenador: quita espacios, corrige mayúsculas, escribe los teléfonos en un solo formato, marca los correos con formato incorrecto y encuentra duplicados por correo o teléfono; después guarda un archivo limpio y otro aparte con lo que ha quitado, para que usted lo revise. Envíenos unas filas con nombres, teléfonos y correos inventados que se parezcan a los suyos, y sus reglas. La lista nunca nos llega, y el script nunca envía nada a ningún sitio. Comprueba el formato de una dirección, no si el buzón existe.

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 sus reglas de limpieza; el código también se muestra en la página del pedido.
• Duplicados localizadosPor correo, por teléfono o por ambos
• Un formato de teléfonoCon el prefijo de país que fije para los números que no lo tengan
• Filas eliminadas guardadasUn archivo aparte con cada fila eliminada o fusionada
• Se queda en su ordenadorSu lista nunca se sube ni se envía
• Código legibleCon comentarios, fácil cambiar una regla más adelante

Cómo funciona

1. 1
   NormasUsted envía filas de muestra inventadas y sus reglas para los duplicados
2. 2
   CódigoEscribimos el script y la guía para ejecutarlo
3. 3
   PruébeloLo ejecuta con una copia de su lista y revisa las filas eliminadas
4. 4
   CambiosPide cambios dentro de su paquete y nos envía cualquier mensaje de error

Qué necesitamos de usted

Los nombres de columna de su lista y 10-20 filas con nombres, teléfonos y correos inventados, escritos como aparecen en sus datos reales (con el mismo tipo de desorden). Sus reglas: qué cuenta como duplicado, qué fila conservar (la más reciente, la más completa), el prefijo de país para los teléfonos locales y cómo deben escribirse los teléfonos. CSV o Excel, y su sistema: Windows, macOS o Linux. No envíe nunca la lista real.

Le preguntaremos:

• ¿De dónde sale la lista?
• ¿Qué cuenta como duplicado?
• ¿Qué fila debe quedarse?
• ¿Cómo deben ser los teléfonos?

Comparar paquetes

Preguntas y respuestas

¿No encontró su respuesta? Pregúntenos