Gérer les règles panier et les codes promo

ps_manage_cart_rules

ProTellMyShop Pro uniquement
Écriture · aperçu + validation
Enregistre: interrupteur Ventes (jusqu’à désactivation)
Ventes · interrupteur, jusqu’à désactivation
Visible dès l’installation

Crée des codes promo, y compris des séries de codes à usage unique, et les active ou les désactive. Les nouveaux codes démarrent désactivés.

TellMyShop Free: Non. Cet outil fait uniquement partie de TellMyShop Pro. TellMyShop Free ne contient que des rapports prêts à l’emploi qui lisent votre boutique.

Demandez au chat

« Crée le code BIENVENUE10 : -10 % sur les commandes de plus de 200 PLN, valable jusqu’à la fin de l’année, une fois par client. »

Exemple d’aperçu

Nouvelle règle panier « Bienvenue 10 % », code BIENVENUE10, 10 %, min. 200 PLN TTC, du 2026-10-05 au 2026-12-31, 1 par client, 1000 utilisations. Créée INACTIVE : activez-la avec set_active après vérification.

Détails techniques

Codes promo (règles panier). action=list (avec le nombre d’utilisations) et action=get (détails avec restrictions). action=create crée un code : pourcentage, montant ou livraison gratuite, montant minimal du panier, dates, nombre total d’utilisations et utilisations par client, restrictions facultatives à des catégories, produits ou fabricants, groupes de clients, exclusive (ne se cumule pas avec d’autres codes), exclude_discounted, et pour les remises en pourcentage apply_to (commande entière, produits sélectionnés ou produit le moins cher). action=generate crée une série de codes uniques À USAGE UNIQUE avec un préfixe (par exemple 200 codes pour la newsletter, count jusqu’à 500) avec les mêmes conditions. action=update modifie le code, les dates, les limites, la valeur ou le nom. action=set_active active ou désactive un code. action=delete supprime un code qui n’a JAMAIS été utilisé dans une commande (un code utilisé ne peut qu’être désactivé). Les nouveaux codes démarrent INACTIFS, sauf avec activate=true. Une règle sans code s’applique automatiquement à chaque client et exige auto_apply=true.

Paramètres

Nom	Type	Obligatoire	Description
action	enum: list \| get \| create \| update \| set_active \| generate \| delete	oui	list \| get \| create \| update \| set_active \| generate \| delete.
shop_id	integer	non	ID de la boutique dans une installation multiboutique. Par défaut, la boutique de l’adresse du connecteur. Les ID sont listés par ps_get_shop_info.
cart_rule_id	integer	quand	get/update/set_active/delete : ID tiré de action=list.
name	string	non	create/generate/update : nom affiché dans le panier du client (par exemple « Soldes d’automne -10 % »). 254 caractères maximum.
code	string	non	create/update : le code à saisir dans le panier (lettres, chiffres, - et _).
auto_apply	boolean	non	create : true = une règle SANS code, appliquée automatiquement à tous ceux qui remplissent les conditions. Par défaut false.
reduction_percent	number	non	remise en % (create/generate/update). 100 maximum.
reduction_amount	number	non	remise en montant dans la devise de la boutique (create/generate/update). 1 000 000 maximum.
amount_tax_included	boolean	non	create/generate : la remise en montant est TTC (par défaut).
free_shipping	boolean	non	livraison gratuite (create/generate/update).
minimum_amount	number	non	montant minimal du panier TTC, 0 = pas de minimum (create/generate/update).
date_from	string (YYYY-MM-DD)	non	valable à partir du (create/generate : par défaut aujourd’hui), AAAA-MM-JJ.
date_to	string (YYYY-MM-DD)	quand	valable jusqu’au (create/generate : obligatoire), AAAA-MM-JJ.
quantity	integer	quand	create : nombre total d’utilisations (obligatoire) ; update : nombre d’utilisations restantes. De 0 à 1 000 000.
quantity_per_user	integer	non	utilisations par client (1 par défaut). De 1 à 1000.
category_ids	array of integer	non	create/generate : le code ne fonctionne que si le panier contient un produit de ces catégories (ID tirés de ps_get_category_tree). 50 éléments maximum.
products	array of string	non	create/generate : le code ne fonctionne qu’avec ces produits. 100 éléments maximum.
manufacturer_ids	array of integer	non	create/generate : le code ne fonctionne qu’avec les produits de ces fabricants. 50 éléments maximum.
min_products	integer	non	create/generate : combien de ces produits doivent être dans le panier. De 1 à 1000. 1 par défaut.
apply_to	enum: order \| selected_products \| cheapest	non	create/generate (remise en pourcentage uniquement) : order = panier entier, selected_products = uniquement les produits concernés par les restrictions, cheapest = le produit le moins cher. Par défaut order.
exclude_discounted	boolean	non	create/generate/update : la remise ignore les produits déjà en promotion.
customer_group_ids	array of integer	non	create/generate : uniquement pour ces groupes de clients. 20 éléments maximum.
exclusive	boolean	non	create/generate : ne peut pas être combiné avec d’autres codes promo. Par défaut false.
highlight	boolean	non	create/update : suggérer le code dans le panier quand le client remplit les conditions.
partial_use	boolean	non	create/update (remise en montant) : la partie non utilisée du montant reste au client sous forme de nouveau code.
description	string	non	create/generate/update : description interne (back office uniquement). 254 caractères maximum.
activate	boolean	non	create/generate : actif tout de suite (non par défaut : vous l’activez après vérification).
count	integer	quand	generate : nombre de codes (chacun à usage unique). De 1 à 500.
prefix	string	quand	generate : préfixe du code (par exemple NEWS10 -> NEWS10-7KQ3XW9P).
code_length	integer	non	generate : longueur de la partie aléatoire du code. De 6 à 16. 8 par défaut.
active	boolean	quand	set_active : true = activer, false = désactiver.
only_active	boolean	non	list : actifs uniquement. Par défaut false.
search	string	non	list : fragment du nom ou du code. 100 caractères maximum.
limit	integer	non	Nombre maximal de lignes (50 par défaut, 200 maximum).
offset	integer	non	Lignes à sauter, pour la pagination (0 par défaut).
confirm	boolean	non	false (par défaut) renvoie un aperçu et n’enregistre rien. true exécute, uniquement après que l’utilisateur a validé l’aperçu, avec change_token.
change_token	string	quand	Jeton issu de l’aperçu. Obligatoire avec confirm=true. Valable 30 minutes, à usage unique, lié aux arguments et à l’état des données de l’aperçu.

Limites

Les nouveaux codes démarrent inactifs, sauf avec activate=true. generate : jusqu’à 500 codes à usage unique par appel. delete uniquement pour les codes jamais utilisés dans une commande. Une règle sans code exige auto_apply. Liste de 200 lignes maximum (50 par défaut). C’est un outil d’écriture : sans licence active, il est masqué, list compris ; les modifications exigent l’interrupteur Ventes. Droits vérifiés par action (AdminCartRules). Annulable avec ps_revert_change.

Ce que vous voyez avant tout enregistrement

Le chat appelle d’abord l’outil sans le confirmer. Le module renvoie un aperçu (valeurs actuelles et nouvelles) et un jeton à usage unique valable 30 minutes. Le chat vous montre l’aperçu et n’enregistre la modification qu’après votre oui.

Outils liés

Promotions par catégorie et par marque (règles de prix catalogue) ps_manage_catalog_price_rules
Gérer les prix promotionnels (prix spécifiques) ps_manage_specific_prices
Annuler une modification ps_revert_change

Cas d’usage avec cet outil

Dernière mise à jour: 2026-10-11