Ein Python-Skript, das Ihre Kontaktexporte in eine saubere CSV verwandelt, bereit für den Import in Ihren Newsletter-Dienst

Beispielergebnis

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Ordner: sales/2026-10, 9 Dateien gefunden
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 Zeilen
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 Zeilen
2026-11-02 09:14:04 WARN  shop-07.csv: 3 Zeilen ohne Preis übersprungen (Zeilen 88, 412, 913)
2026-11-02 09:14:05 INFO  Fertig: 10.412 Zeilen -> report-2026-10.xlsx (Tabellenblätter „Verkäufe“ und „Summen“)

[columns]
date = Datum, Verkaufsdatum, Tag
product = Artikel, Produkt, Bezeichnung
quantity = Menge, Anzahl, Stk.
price = Preis, Einzelpreis

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Liest die Datei eines Ladens ein und gibt ihr die Spaltennamen des Berichts."""
    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}: keine Spalte für '{name}' (gesucht wurde nach {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Über diese Leistung

Kontakte, die aus einem Shop, einem CRM oder Event-Anmeldungen exportiert wurden, passen selten zu dem, was ein Newsletter-Dienst importieren möchte: andere Spaltennamen, Vor- und Nachname in einer Zelle, Tags an seltsamen Stellen, abgemeldete Personen noch auf der Liste. Dieses Python-Skript liest Ihre Exporte und schreibt eine saubere CSV im Importaufbau Ihres Dienstes: Namen bei Bedarf getrennt, Felder und Tags zugeordnet, fehlerhafte E-Mails und Duplikate ausgelassen und ab Standard nur Personen mit Einwilligungsvermerk behalten und abgemeldete entfernt, mit einer Datei der ausgelassenen Zeilen zur Prüfung. Es ist für Ihre eigenen Kontakte gedacht, die zugestimmt haben, von Ihnen zu hören, nie für gekaufte oder abgegriffene Listen. Es läuft auf Ihrem Computer und verbindet sich nicht mit dem Dienst; die Datei importieren Sie selbst.

Was enthalten ist

• Das erhalten SieEin ZIP-Archiv mit dem Python-Skript, einer README mit Schritt-für-Schritt-Anleitung und ab Standard einer Einstellungsdatei mit der Zuordnung von Feldern und Tags; der Code wird auch auf der Bestellseite angezeigt.
• Der Aufbau Ihres DienstesNach seiner Importvorlage oder Beispieldatei
• Einwilligung respektiertAb Standard nur Personen, die zugestimmt haben, keine abgemeldeten
• Duplikate und Tippfehler rausFehlerhafte Adressen und Wiederholungen ausgelassen
• Ausgelassene Zeilen bleiben erhaltenEine separate Datei, die zeigt, was ausgelassen wurde und warum
• Lesbarer CodeMit Kommentaren, ein Feld lässt sich später leicht ergänzen

So funktioniert es

1. 1
   BeispieleSie schicken erfundene Zeilen aus jedem Export und das Importformat Ihres Dienstes
2. 2
   CodeWir schreiben das Skript und die Anleitung zum Ausführen
3. 3
   AusprobierenSie starten es, sehen die ausgelassenen Zeilen durch und importieren eine kleine Testliste
4. 4
   ÜberarbeitungenSie wünschen Überarbeitungen im Rahmen Ihres Pakets und schicken etwaige Fehlermeldungen

Was wir von Ihnen brauchen

Die Kopfzeile und 10–20 Zeilen jedes Exports mit erfundenen Namen und E-Mails, aber demselben Aufbau, welche Spalte die Einwilligung und welche die Abmeldung zeigt, der Newsletter-Dienst, den Sie nutzen, und seine Importvorlage oder ein Link zu seiner Hilfeseite zum Import, und wie Tags oder Segmente gesetzt werden sollen. Wie die Kontakte gesammelt wurden (Ihr Shop, Anmeldeformular, Events). Schicken Sie nie die echte Liste.

Wir fragen Sie:

• Woher stammen die Kontakte?
• In welchen Newsletter-Dienst importieren Sie?
• Wie ist die Einwilligung vermerkt?
• Brauchen Sie Tags oder Segmente?

Pakete vergleichen

Fragen und Antworten

Keine Antwort gefunden? Fragen Sie uns