Générer des Codes Promo en Masse sur PrestaShop 8 & 9 : documentation

Présentation

Le module crée des lots de codes de réduction uniques qui partagent les mêmes règles. Chaque code est une règle panier native de PrestaShop. Les codes se distribuent par email, par impression PDF avec QR code ou par export CSV, et chaque lot dispose de ses statistiques d’utilisation.

Installation

1. Dans Modules > Gestionnaire de modules, cliquez sur Téléverser un module et sélectionnez le fichier dfbulkcoupons-1.1.0.zip.
2. L’installation crée l’onglet Catalogue > Réductions > Codes promo en masse. Le bouton Configurer du module y mène aussi.
3. Le module active la fonctionnalité des règles panier si elle était désactivée.

Créer un lot

Cliquez sur Nouveau lot. Le formulaire se remplit de haut en bas.

Lot

Le nom du lot sert dans les statistiques et les exports. Le canal indique où les codes seront diffusés (email, newsletter, SMS, réseaux sociaux, influenceurs, affiliés, imprimés, magasin, service client, autre ou un nom libre). Il sert à comparer les campagnes dans le tableau de performance par canal.

Format des codes

Un code se compose d’un préfixe, d’une partie aléatoire et d’un suffixe. Dans la partie aléatoire, X est une lettre ou un chiffre, A une lettre et # un chiffre. Les autres caractères, comme les tirets, sont conservés. Exemple : préfixe ETE- et partie XXXX-XXXX donnent ETE-K7MQ-3HWD.

Le jeu de caractères « Faciles à lire » exclut 0, O, 1, I et L pour éviter les erreurs de saisie. Il faut au moins 4 caractères aléatoires, et le format doit offrir au moins 20 fois plus de combinaisons que de codes demandés : l’aperçu et le compteur de combinaisons l’indiquent pendant la saisie.

Destinataires et quantité

• Codes anonymes : vous indiquez le nombre de codes, de 1 à 200 000. Ils se distribuent librement.
• Un code personnel par client des groupes sélectionnés : un code par client actif des groupes cochés, avec l’option « Abonnés à la newsletter uniquement ».
• Un code personnel par client d’une liste d’emails : collez les adresses, une par ligne ou séparées par des virgules. Les adresses sans compte client sont ignorées et leur nombre est affiché.

Un code personnel ne fonctionne que pour le compte client auquel il est attribué.

Réduction

Le nom affiché aux clients apparaît dans le panier et sur la facture, dans chaque langue. Types : pourcentage, montant fixe (HT ou TTC, dans une devise), livraison offerte ou cadeau (la déclinaison par défaut du produit est offerte). Un pourcentage ou un montant s’applique à toute la commande hors livraison ou à un produit précis. Un pourcentage peut aussi s’appliquer au produit le moins cher ou aux produits de la restriction.

Validité et utilisation

Dates de début et de fin, utilisations par code et utilisations par client : indiquez 1 et 1 pour des codes à usage unique. Montant minimum de commande (avec devise, taxes et livraison), priorité, option « Non cumulable avec d’autres réductions », affichage du code dans le panier de son titulaire (codes personnels uniquement) et activation immédiate.

Restrictions

Restriction par produits, catégories ou marques avec une quantité minimum de produits correspondants, groupes de clients autorisés, pays de livraison autorisés et, en multiboutique, boutiques autorisées. Un champ laissé vide n’impose aucune restriction.

Génération des codes

Après validation, la page de génération crée les codes par blocs de 250 avec une barre de progression. Gardez la page ouverte. Si elle est fermée, la génération reprend où elle s’était arrêtée à la prochaine ouverture du lot (lien Reprendre dans la liste). Chaque code est une règle panier dont la description commence par [DFBC#id], visible dans Catalogue > Réductions.

Page du lot

Statistiques

Codes générés, codes utilisés et taux d’utilisation, commandes validées, commandes de nouveaux clients (clients sans commande validée antérieure), CA HT et panier moyen, réduction accordée HT et ratio CA sur réduction, codes encore utilisables. Suivent un graphique des utilisations par jour, les 15 codes les plus utilisés et les 30 dernières commandes. Seules les commandes validées comptent dans le CA et la réduction, convertis dans la devise par défaut.

Gérer le lot

• Informations : nom, canal et note interne. Le nouveau nom est reporté dans la description des règles panier.
• Fin de validité : s’applique à tous les codes du lot.
• Ajouter des codes : pour un lot de codes anonymes, avec le même format et les mêmes règles.
• Désactiver ou activer tous les codes, supprimer les codes jamais utilisés, dupliquer le lot ou le supprimer. Les commandes passées gardent leur réduction.

Liste des codes

Le bouton Parcourir les codes affiche les codes par pages de 50, avec des onglets par statut : disponible, utilisé, épuisé, expiré, désactivé. La recherche porte sur le début du code ou l’email du client. Pour chaque code : copie du code ou de son lien direct, utilisations, utilisations restantes, date d’envoi, dernière commande, activation ou désactivation, et lien vers la règle panier native.

Envoyer les codes par email

Disponible pour les lots de codes personnels, depuis le panneau Diffusion de la page du lot.

1. Pour chaque langue, modifiez l’objet et le message. Variables disponibles : {firstname}, {lastname}, {code}, {discount}, {valid_until}, {shop_name}, {link}. L’email affiche toujours le code encadré, la réduction, la date de fin et un bouton qui applique le code au panier.
2. Cliquez sur M’envoyer un email de test : il part à votre adresse d’employé, dans votre langue, avec un code du lot.
3. Choisissez les destinataires : codes pas encore envoyés (et codes en échec), ou tous les codes à nouveau pour une relance. L’option « Seulement les clients qui ont accepté la newsletter » est cochée par défaut.
4. Réglez le nombre d’emails par minute pour rester sous la limite de votre serveur mail ou de votre fournisseur SMTP, puis cliquez sur Enregistrer et envoyer.

L’envoi se fait par paquets de 10, avec une barre de progression et un bouton pause. Chaque client reçoit la version de la langue de son compte. Les codes déjà utilisés, désactivés ou expirés et les comptes supprimés ou désactivés sont ignorés. Les emails refusés par le serveur sont listés et retentés au prochain envoi des codes non envoyés.

Imprimer les codes

Le bouton Imprimer les codes génère un PDF A4 :

• Cartes : 10 par page (95 x 55 mm), avec traits de coupe.
• Étiquettes : 21 par planche (63,5 x 38,1 mm, planches 3 x 7 courantes).
• Flyers : 4 par page au format A6, avec traits de coupe.

Choisissez les codes (non utilisés jamais imprimés, tous les non utilisés ou tous), leur nombre (2 000 par fichier au maximum) et le nombre de codes à ignorer au début. Réglez l’accroche, les conditions (variables {valid_until}, {shop_name}, {customer}), la couleur d’accent, le QR code, le nom de la boutique et, pour les codes personnels, le nom du client. L’option « Marquer ces codes comme imprimés » évite de réimprimer les mêmes codes.

Lien direct et QR code

Chaque code a une adresse de la forme https://votre-boutique.com/module/dfbulkcoupons/apply?code=CODE. Elle ouvre la boutique et applique le code au panier. Si le visiteur n’a pas encore de panier, ou si le panier ne remplit pas les conditions (montant minimum, produits, compte du titulaire), le code est gardé 30 jours dans son cookie et appliqué dès que le panier les remplit. Ce lien se trouve derrière les QR codes imprimés, sur le bouton des emails, dans la liste des codes et dans l’export CSV.

Exports CSV

Les fichiers sont en UTF-8 avec séparateur point-virgule, lisibles directement dans Excel.

• Codes (tous, non utilisés ou utilisés) : code, statut, utilisations, utilisations restantes, dates de validité, email, prénom et nom du client, dernière utilisation, dernière commande, date d’envoi, date d’impression, lien direct.
• Utilisation par commande : date, ID, référence et statut de la commande, commande validée ou non, code, client, réduction et total HT et TTC, devise.

Performance par canal

Dès que plusieurs canaux sont utilisés, la liste des lots affiche un tableau par canal : nombre de lots et de codes, codes utilisés, taux, commandes, CA HT et réduction HT, trié par CA.

Désinstallation

La désinstallation supprime les tables du module (lots, historique d’envoi et d’impression). Les codes déjà générés restent des règles panier actives dans Catalogue > Réductions.

Dépannage

• La génération s’arrête : rouvrez le lot, la génération reprend. Un message d’erreur précis s’affiche si la base refuse les insertions.
• « Ce format laisse trop peu de combinaisons » : ajoutez des caractères aléatoires ou passez à l’alphabet complet.
• Emails en échec : vérifiez Paramètres avancés > E-mail avec un email de test, puis relancez l’envoi des codes non envoyés.
• Le QR code ne réduit pas le panier : ouvrez le panier, le code est appliqué dès que ses conditions sont remplies. Pour un code personnel, le client doit être connecté à son compte.