Simulateur

Le simulateur est affiché en permanence à droite de l’éditeur d’offre. Il rejoue un ticket sur un moteur réel du workspace sans rien écrire : aucun point crédité, aucun coupon réservé, aucune limite consommée.

Ce qu’il évalue

• toutes les offres publiées du workspace ;
• plus la version en cours d’édition de l’offre ouverte (brouillon injecté), pour voir l’effet d’une modification avant publication ;
• éventuellement, une sélection restreinte d’offres (options.offerIds).

Le ticket

Trois sources :

1. un ticket d’exemple enregistré dans le workspace (les exemples de cette documentation sont proposés par défaut) ;
2. un ticket saisi dans le formulaire (en-tête, client, lignes, paiements, coupons présentés) ;
3. un ticket réel retrouvé dans l’historique, copié dans le simulateur.

Les montants sont en centimes ; le formulaire les affiche en euros.

Le résultat

Zone	Contenu
Totaux	brut, remise totale (ticket et lignes), net indicatif
Lignes	remise par ligne, offres qui y contribuent, quantité concernée
Lignes ajoutées	produits offerts que la caisse doit ajouter à 0 €
Offres appliquées	niveau, mode, valeur, détail de chaque action, explication en clair
Offres refusées	raison (criteria_not_met, lost_best_offer, customer_limit_reached…), critère en cause, offre gagnante
Points	mouvements projetés et soldes après ticket
Coupons	coupons émis (projetés), coupons présentés acceptés ou refusés
Messages	textes à imprimer ou afficher
Avertissements	incohérence lignes/total, carte créée, magasin inconnu…

En mode simulation, la trace des critères (criteriaTrace) détaille chaque nœud de l’arbre : vrai ou faux, lignes retenues, détail de la comparaison. C’est l’outil le plus rapide pour comprendre pourquoi une offre ne s’applique pas.

Bonnes pratiques

• Gardez un jeu de tickets types par enseigne : panier moyen, gros panier, panier sans carte, ticket avec coupon.
• Après chaque modification d’une offre en best_offer, vérifiez les autres offres du même niveau : l’une d’elles peut perdre.
• Le simulateur passe par le hub, qui appelle POST /mgmt/v1/simulate sur un moteur sain (délai maximal 2 s).