Créer une offre

L’éditeur d’offres du studio est un éditeur visuel : le déclencheur, les critères et les actions sont des blocs reliés entre eux, et le simulateur reste affiché à droite pendant toute l’édition. Chaque modification est enregistrée dans la version de travail ; rien ne part en caisse avant la publication.

1. Partir d’un modèle ou d’une page blanche

Dans Offres → Nouvelle offre, choisissez :

un modèle prêt à l’emploi (« -X % dès Y € », « N achetés, le moins cher offert », « points doublés », « bon d’achat pour la prochaine visite »…) : un assistant demande seulement les valeurs (pourcentage, seuil, dates) ;
une offre vide pour construire l’arbre vous-même ;
la duplication d’une offre existante (y compris depuis un autre workspace, pour l’équipe éditeur).

Renseignez le nom, le code (majuscules, chiffres, - et _, 32 caractères au plus, immuable), un dossier et des étiquettes.

2. Choisir le déclencheur

Déclencheur	Quand l’offre est-elle évaluée ?
Ticket (`transaction`)	À chaque ticket reçu. C’est le cas le plus courant.
Événement (`event`)	Lorsqu’un événement client survient, sans ticket : inscription, création de carte, anniversaire, changement de statut, entrée dans un segment, franchissement d’un seuil de compteur, événement personnalisé.
Coupon (`coupon`)	Uniquement si un coupon d’un modèle, d’une campagne ou un code promo donné est présenté. Le coupon est consommé quand l’offre s’applique.

3. Construire les critères

Les critères sont regroupés dans des groupes ET / OU / NON imbriqués. Un groupe ET vide signifie « toujours ».

Critères au niveau du ticket : montant (brut, hors taxes ou éligible), nombre d’articles ou de lignes, période de dates, plage horaire (qui peut passer minuit), jours de la semaine, magasins ou groupes de magasins, canal (caisse, web, application…), client identifié, attribut client, statut de fidélité, segment, anniversaire (naissance ou inscription), premier achat, coupon présenté, moyen de paiement, solde d’un compteur, nombre d’utilisations précédentes de l’offre, variante de test A/B, filtre sur l’événement déclencheur, expression CEL personnalisée.

Critères à l’article : EAN, référence, liste de produits, catégorie, rayon, univers, marque, attribut d’article, prix, lot. Chaque critère article définit un ensemble de lignes éligibles ; des seuils communs précisent la quantité minimale, le montant minimal ou le nombre de lignes. Les actions peuvent cibler exactement ces lignes.

4. Ajouter les actions

Action	Effet
Remise en € (`discount_amount`)	Montant fixe sur le ticket, réparti sur les lignes ciblées, par ligne ou par unité.
Remise en % (`discount_percent`)	Pourcentage sur le ticket éligible ou sur les lignes ciblées, avec plafond et règle d’arrondi.
Prix barré (`discount_fixed_price`)	Ramène les unités ciblées à un prix fixe.
Le moins cher offert (`cheapest_free`)	« N achetés, M offerts » (ou remisés d’un pourcentage).
Produit offert (`free_product`)	Demande à la caisse d’ajouter une ligne à 0 €, ou offre le produit s’il est déjà dans le ticket.
Prix du lot (`lot_price`)	Fixe le prix de chaque lot complet (« 2 pour 8 € »).
Points fixes (`points_fixed`)	Crédite un nombre fixe d’unités sur un compteur, avec délai d’activation et expiration.
Points par € (`points_per_amount`)	Crédite X points par tranche de Y centimes, sur le brut, l’éligible ou le montant après remises.
Multiplicateur (`points_multiplier`)	Multiplie les points gagnés aux niveaux inférieurs (×2 = `20000`).
Compteur (`counter_update`)	Incrémente, décrémente, fixe ou remet à zéro un compteur technique (visites, tampons).
Coupon (`coupon_issue`)	Émet un coupon au client, avec validité fixe ou glissante, rendu code seul, PNG ou PDF.
Message (`message`)	Texte imprimé sur le ticket ou affiché à l’écran, en français et en anglais, avec variables.
Étiquette client (`customer_tag`)	Ajoute ou retire une étiquette sur la fiche client.
Statut client (`customer_status`)	Fait passer le client à un statut de fidélité (montée seulement par défaut).
Événement (`custom_event`)	Émet un événement client exploitable par d’autres offres et par les webhooks.

Les remises d’une même offre s’additionnent. Une remise ne rend jamais une ligne négative.

5. Régler le cumul, les limites et la validité

Cumul : niveau (0 à 99), mode (cumulative, best_offer, best_line), priorité (0 à 1000, 100 par défaut), exclusions, étiquettes exclusives, offre exclusive. Voir Cumul des offres.
Limites : budget global (utilisations, montant de remise, points, coupons) avec, à épuisement, refus ou suspension automatique de l’offre ; limite par client (par jour, semaine, mois, trimestre, année, sur N jours glissants ou sur la validité) ; limite par magasin ; nombre d’applications par ticket.
Validité : date de début obligatoire, date de fin facultative, fuseau horaire. Hors de cette fenêtre, l’offre n’est même pas chargée par les moteurs. Pour un horaire plus fin (le samedi de 9 h à 12 h), utilisez les critères date, heure et jours.

6. Tester dans le simulateur

Le simulateur à droite rejoue un ticket — saisi à la main ou choisi parmi les tickets d’exemple — avec la version en cours d’édition. Il montre les remises par ligne, les points, les coupons, les offres refusées et la trace de chaque critère. Voir Simulateur.

7. Soumettre, approuver, publier

Soumettre : la version passe « à valider » (rôle marketer).
Approuver ou refuser avec un commentaire (rôle approver).
Publier : la version devient la version publiée, les moteurs la chargent immédiatement. Le résultat de la publication indique, moteur par moteur, si le rechargement a réussi.

En production, gardez à portée de main :

Suspendre (arrêt d’urgence) : l’offre disparaît des moteurs en moins de deux secondes ;
Reprendre : elle revient avec la même version ;
Retour arrière : republie une version antérieure ;
Dépublier : retire la version publiée sans archiver l’offre.

Toutes ces actions sont tracées dans le journal d’audit du workspace.