Uno script Python che trasforma le esportazioni dei suoi contatti in un CSV pulito, pronto da importare nel suo servizio di newsletter

Esempio di risultato

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Cartella: sales/2026-10, 9 file trovati
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 righe
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 righe
2026-11-02 09:14:04 WARN  shop-07.csv: saltate 3 righe senza prezzo (righe 88, 412, 913)
2026-11-02 09:14:05 INFO  Fatto: 10.412 righe -> report-2026-10.xlsx (fogli "Vendite" e "Totali")

[columns]
date = Data, Data vendita, Giorno
product = Prodotto, Articolo, Descrizione
quantity = Q.tà, Quantità, Pz
price = Prezzo, Prezzo unitario

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Legge il file di un negozio e gli dà i nomi di colonna del report."""
    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}: nessuna colonna per '{name}' (cercate: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Informazioni sul servizio

I contatti esportati da un negozio, da un CRM o dalle iscrizioni agli eventi raramente corrispondono a ciò che un servizio di newsletter vuole importare: altri nomi di colonna, nome e cognome nella stessa cella, tag in posti strani, persone disiscritte ancora in lista. Questo script Python legge le sue esportazioni e scrive un unico CSV pulito nella struttura di importazione del suo servizio: nomi separati se serve, campi e tag abbinati, email scritte male e duplicati esclusi e, dallo Standard, tenute solo le persone con il consenso e rimosse quelle disiscritte, con un file delle righe scartate da controllare. È per i suoi contatti che hanno accettato di ricevere le sue comunicazioni, mai per liste acquistate o raccolte dal web. Gira sul suo computer e non si collega al servizio; il file lo importa lei.

Cosa è incluso

• Cosa riceveUn archivio ZIP con lo script Python, un README con le istruzioni passo passo e, dallo Standard, un file di impostazioni con l'abbinamento di campi e tag; il codice è visibile anche nella pagina dell'ordine.
• La struttura del suo servizioSecondo il suo modello di importazione o un file di esempio
• Consenso rispettatoDallo Standard, solo chi ha acconsentito, nessun disiscritto
• Fuori duplicati e refusiIndirizzi scritti male e ripetizioni esclusi
• Righe scartate conservateUn file separato che mostra cosa è stato escluso e perché
• Codice leggibileCon commenti, facile aggiungere un campo in seguito

Come funziona

1. 1
   EsempiLei invia righe inventate da ogni esportazione e il formato di importazione del suo servizio
2. 2
   CodiceScriviamo lo script e la guida per eseguirlo
3. 3
   Lo proviLo esegue, controlla le righe scartate e importa una piccola lista di prova
4. 4
   ModificheChiede modifiche nei limiti del pacchetto e invia eventuali messaggi di errore

Cosa ci serve da lei

L'intestazione e 10-20 righe di ogni esportazione con nomi ed email inventati ma con la stessa struttura, quale colonna indica il consenso e quale la disiscrizione, il servizio di newsletter che usa e il suo modello di importazione o un link alla pagina di aiuto sull'importazione, e come impostare tag o segmenti. Come sono stati raccolti i contatti (il suo negozio, un modulo di iscrizione, eventi). Non invii mai la lista reale.

Le chiederemo:

• Da dove vengono i contatti?
• In quale servizio di newsletter li importerà?
• Come è registrato il consenso?
• Le servono tag o segmenti?

Confronto dei pacchetti

Domande e risposte

Non hai trovato la risposta? Chiedi a noi