Envoyer un reporting hebdomadaire par email

Ce use case illustre une utilisation concrète du plugin Biron dans Zapier. Si vous n’êtes pas encore familier avec son fonctionnement (authentification, structure d’une requête, gestion des variables), consultez d’abord le guide Biron × Zapier avant de continuer.

Ce qu’on construit

Un Zap qui se déclenche chaque lundi matin et envoie automatiquement un email à votre board avec :

Performance globale : CA HT sur la semaine, le mois et l’année en cours, avec comparaisons N-1
Tableau par boutique : commandes, CA, marge et réalisation de l’objectif sur la semaine écoulée

Architecture du Zap

Schedule → Calcul des dates → Requête globale → Requête boutiques → Formatage → Gmail

Étapes

Trigger — Schedule by Zapier

Configurez un bloc Schedule by Zapier :

Frequency : Every Week
Day of week : Monday
Time : 10:00 AM

Calcul des dates

Les requêtes Biron nécessitent des dates explicites. Ce bloc les génère dynamiquement à chaque exécution.

Ajoutez un bloc Code by Zapier (Python). Utilisez le prompt suivant pour générer le code, puis collez le résultat dans le bloc :

Rôle : Expert Python pour Zapier.
Objectif : Créer un script de calcul de dates relatives.

Calculer les dates suivantes en gérant les spécificités du calendrier
(années bissextiles, fins de mois) :
- Début et fin de la semaine précédente
- Hier
- Début du mois en cours
- Début de l'année en cours
- Les équivalents N-1 de chacune de ces dates

Sortie : retourner un dictionnaire "output" avec toutes les dates au format YYYY-MM-DD.

Les variables produites seront référencées dans les étapes suivantes.

Requête globale — données agrégées

Créez votre chart dans Biron avec les métriques globales dont vous avez besoin, puis copiez le NexusQL généré.

Dans le bloc Biron Query de Zapier, collez la requête et remplacez chaque date statique par les variables produites à l’étape précédente.

Les données récupérées couvrent :

Métrique	Période
CA HT	Semaine N-1, MTD, YTD
CA HT vs N-1	Semaine N-1, MTD, YTD
Nb commandes facturées	Semaine N-1
% réalisation objectif CA	Semaine N-1

Requête boutiques — données par point de vente

Même principe : créez votre chart Biron avec les dimensions boutique, copiez le NexusQL, et remplacez les dates.

Les données récupérées couvrent :

Dimension / Métrique	Période
Boutique	—
Nb commandes facturées	Semaine N-1
CA HT	Semaine N-1
Marge totale HT	Semaine N-1
% réalisation objectif CA	Semaine N-1

Formatage

Les données Biron ne peuvent pas être injectées directement dans un email — elles doivent être converties en HTML.

Ajoutez un bloc Code by Zapier (Python) et utilisez ce prompt pour générer le code de formatage ainsi que le corps du mail :

Rôle : Expert Python pour Zapier.
Objectif : Formater des données pour un email hebdomadaire à destination d'un board.

Inputs disponibles :
Données globales :
- CA HT (S-1), CA HT (MTD), CA HT (YTD)
- CA HT (S-1) vs N-1, CA HT (MTD) vs N-1, CA HT (YTD) vs N-1
- Nb commandes facturées (S-1)
- % objectif CA HT (S-1)

Tableau boutiques :
- Boutique, Nb commandes facturées (S-1), CA HT (S-1),
  Marge totale HT (S-1), % objectif CA HT (S-1)

Demande :
1. Rédige un corps de mail simple pour un board, avec deux balises
   à remplacer : une pour les données globales, une pour le tableau boutiques.
2. Génère le code Python qui produit les blocs HTML correspondants
   à partir des inputs, prêts à être insérés dans le corps du mail.

Copiez le code Python dans le bloc Code, et le corps du mail dans le bloc Gmail (étape suivante).

Envoi — Gmail

Ajoutez un bloc Gmail et configurez :

To : les destinataires du board
Subject : ex. Reporting hebdomadaire — semaine du {{date_debut_semaine}}
Body : collez le corps de mail généré à l’étape précédente, puis insérez les variables HTML produites par le bloc de formatage aux endroits prévus

Testez le Zap et vérifiez le rendu de l’email avant d’activer.

Résultat attendu

Chaque lundi à 10h, votre board reçoit un email structuré avec les performances de la semaine écoulée, sans aucune action manuelle de votre part.