Un script Python qui transforme vos exports de contacts en un CSV propre, prêt à importer dans votre service d’e-mailing

Exemple de résultat

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Dossier : sales/2026-10, 9 fichiers trouvés
2026-11-02 09:14:03 INFO  shop-01.csv : 1 284 lignes
2026-11-02 09:14:04 INFO  shop-02.xlsx : 967 lignes
2026-11-02 09:14:04 WARN  shop-07.csv : 3 lignes sans prix ignorées (lignes 88, 412, 913)
2026-11-02 09:14:05 INFO  Terminé : 10 412 lignes -> report-2026-10.xlsx (feuilles « Ventes » et « Totaux »)

[columns]
date = Date, Date de vente, Jour
product = Produit, Article, Désignation
quantity = Qté, Quantité, Pièces
price = Prix, Prix unitaire

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lit le fichier d’une boutique et lui donne les noms de colonnes du rapport."""
    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} : aucune colonne pour '{name}' (recherché : {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

À propos de ce service

Les contacts exportés d’une boutique, d’un CRM ou d’inscriptions à un événement correspondent rarement à ce qu’un service d’e-mailing veut importer : autres noms de colonnes, prénom et nom dans une même cellule, tags mal placés, personnes désinscrites encore dans la liste. Ce script Python lit vos exports et écrit un seul CSV propre dans la structure d’import de votre service : noms séparés si besoin, champs et tags mis en correspondance, e-mails mal formés et doublons écartés et, dès Standard, seules les personnes avec une marque de consentement gardées et les désinscrits retirés, avec un fichier des lignes écartées à vérifier. Il est destiné à vos propres contacts qui ont accepté d’avoir de vos nouvelles, jamais à des listes achetées ou aspirées. Il tourne sur votre ordinateur et ne se connecte pas au service ; vous importez le fichier vous-même.

Ce qui est inclus

• Ce que vous recevezUne archive ZIP avec le script Python, un README avec des instructions pas à pas et, dès Standard, un fichier de paramètres avec la correspondance des champs et des tags ; le code est aussi affiché sur la page de la commande.
• La structure de votre serviceD’après son modèle d’import ou un fichier d’exemple
• Consentement respectéDès Standard, uniquement les personnes qui ont accepté, sans les désinscrits
• Doublons et fautes écartésAdresses mal formées et répétitions écartées
• Lignes écartées conservéesUn fichier séparé montrant ce qui a été écarté et pourquoi
• Code lisibleAvec des commentaires, pour ajouter facilement un champ plus tard

Comment ça marche

1. 1
   ExemplesVous envoyez des lignes fictives de chaque export et le format d’import de votre service
2. 2
   CodeNous écrivons le script et le guide pour le lancer
3. 3
   Testez-leVous le lancez, parcourez les lignes écartées et importez une petite liste de test
4. 4
   RetouchesVous demandez des retouches selon votre formule et envoyez les éventuels messages d’erreur

Ce dont nous avons besoin

L’en-tête et 10 à 20 lignes de chaque export avec des noms et e-mails fictifs mais la même structure, la colonne qui indique le consentement et celle qui indique la désinscription, le service d’e-mailing utilisé et son modèle d’import ou un lien vers sa page d’aide à l’import, et la façon de définir tags ou segments. La façon dont les contacts ont été collectés (votre boutique, un formulaire d’inscription, des événements). N’envoyez jamais la vraie liste.

Nous vous demanderons :

• D’où viennent les contacts ?
• Dans quel service d’e-mailing allez-vous importer ?
• Comment le consentement est-il enregistré ?
• Vous faut-il des tags ou des segments ?

Comparer les formules

Questions et réponses

Vous n’avez pas trouvé la réponse ? Posez-nous la question