Een Python-script dat je contactexports omzet in een schone CSV, klaar om te importeren in je mailingdienst

Voorbeeldresultaat

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Folder: sales/2026-10, 9 files found
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284 rows
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 rows
2026-11-02 09:14:04 WARN  shop-07.csv: 3 rows without a price skipped (lines 88, 412, 913)
2026-11-02 09:14:05 INFO  Done: 10,412 rows -> report-2026-10.xlsx (sheets "Sales" and "Totals")

[columns]
date = Date, Sale date, Day
product = Product, Item, Name
quantity = Qty, Quantity, Pcs
price = Price, Unit price

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Reads one shop's file and gives it the report's column names."""
    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 column for '{name}' (looked for {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Over deze dienst

Contacten die zijn geëxporteerd uit een webshop, een CRM of aanmeldingen voor een evenement passen zelden bij wat een mailingdienst wil importeren: andere kolomnamen, voor- en achternaam in één cel, tags op rare plekken, mensen die zich afmeldden staan nog op de lijst. Dit Python-script leest je exports en schrijft één schone CSV in de importindeling van je dienst: namen gesplitst als dat nodig is, velden en tags gekoppeld, ongeldige e-mailadressen en dubbelen weggelaten en, vanaf Standaard, alleen mensen met een toestemmingsmarkering bewaard en afgemelde mensen verwijderd, met een bestand van weggelaten rijen om te controleren. Het is voor je eigen contacten die ermee instemden van je te horen, nooit voor gekochte of gescrapete lijsten. Het draait op je computer en maakt geen verbinding met de dienst; je importeert het bestand zelf.

Wat is inbegrepen

• Wat je krijgtEen ZIP-archief met het Python-script, een README met stapsgewijze instructies en, vanaf Standaard, een instellingenbestand met de koppeling van velden en tags; de code staat ook op de bestelpagina.
• De indeling van je dienstVolgens het importsjabloon of een voorbeeldbestand
• Toestemming gerespecteerdVanaf Standaard alleen mensen die akkoord gingen, geen afgemelde
• Dubbelen en typfouten eruitOngeldige adressen en herhalingen weggelaten
• Weggelaten rijen bewaardEen apart bestand dat laat zien wat er is weggelaten en waarom
• Leesbare codeMet commentaar, later makkelijk een veld toe te voegen

Hoe het werkt

1. 1
   VoorbeeldenJe stuurt verzonnen rijen uit elke export en het importformaat van je dienst
2. 2
   CodeWij schrijven het script en de handleiding om het uit te voeren
3. 3
   UitproberenJe voert het uit, bekijkt de weggelaten rijen en importeert een kleine testlijst
4. 4
   WijzigingenJe vraagt binnen je pakket om wijzigingen en stuurt een eventuele foutmelding mee

Wat we van je nodig hebben

De kopregel en 10-20 rijen van elke export met verzonnen namen en e-mailadressen maar dezelfde indeling, welke kolom de toestemming toont en welke de afmelding, de mailingdienst die je gebruikt en het importsjabloon of een link naar de helppagina over importeren, en hoe tags of segmenten ingesteld moeten worden. Hoe de contacten verzameld zijn (je webshop, een aanmeldformulier, evenementen). Stuur nooit de echte lijst.

We vragen je:

• Waar komen de contacten vandaan?
• In welke mailingdienst ga je importeren?
• Hoe wordt toestemming vastgelegd?
• Heb je tags of segmenten nodig?

Pakketten vergelijken

Vragen en antwoorden

Staat je antwoord er niet bij? Vraag het ons