Achat Groupé & Prix Dégressif Collectif — Guide complet

Présentation et prérequis

Achat Groupé instaure un prix dégressif collectif : plus il y a d’acheteurs sur un produit, plus le prix unitaire baisse pour tout le monde. Vous définissez des paliers (un seuil d’acheteurs débloque un prix), et le module applique automatiquement le prix du palier atteint via les prix spécifiques natifs de PrestaShop. Le tarif courant s’affiche donc partout sans la moindre modification de votre thème : fiche produit, listings, panier et e-mails.

• Compatible PrestaShop 8.0 à 9.x, thème Classic et thèmes dérivés.
• PHP 7.4 à 8.3.
• Multiboutique et multilingue (FR/EN/ES/DE/IT).
• Aucune tâche CRON requise : le recalcul est piloté par les évènements de commande.
• Architecture conforme PrestaShop (ModuleAdminController, ObjectModel), sans dépendance Composer.

Installation

Installez le module comme n’importe quel module PrestaShop :

1. Téléchargez l’archive dfgroupbuy-1.0.2.zip depuis votre compte client.
2. Dans le back-office, allez dans Modules > Gestionnaire de modules.
3. Cliquez sur Installer un module et déposez l’archive.
4. Une fois installé, cliquez sur Configurer.

À l’installation, le module crée ses tables (campagnes, paliers, participants), enregistre ses hooks et ajoute l’onglet Achat Groupé sous Catalogue. Vous pouvez créer votre première campagne immédiatement.

Réglages généraux du module

La page de configuration regroupe les réglages globaux, communs à toutes les campagnes :

• Couleur principale et couleur d’accent : appliquées au widget de la fiche produit (barre de progression, badges, prix courant).
• Envoyer un e-mail lors d’un remboursement rétroactif : notifie l’acheteur quand un bon lui est attribué.
• Durée de validité des bons : nombre de jours de validité des bons rétroactifs (30 par défaut).
• Intervalle de rafraîchissement : fréquence de mise à jour en direct du widget, en secondes (30 par défaut).

Créer une campagne d’achat groupé

Depuis l’onglet Catalogue > Achat Groupé, cliquez sur Ajouter une campagne. Une campagne associe un produit à une grille de paliers, sur une fenêtre de dates.

• Référence : identifiant interne de la campagne (libre).
• Produit : recherchez et sélectionnez le produit concerné. Vous pouvez cibler une déclinaison précise ou laisser « toutes les déclinaisons ».
• Nom et description : textes traduisibles, affichés dans le widget.
• Mode de comptage : voir la section dédiée ci-dessous.
• Commandes valides uniquement : ne compte que les commandes confirmées (recommandé).
• Prix de référence : le prix de départ (barré) avant tout palier.
• Date de début / fin : fenêtre d’activité de la campagne.
• Remboursement rétroactif : voir la section dédiée.
• Active : active ou suspend la campagne.

Définir les paliers

Chaque palier associe un seuil (nombre d’acheteurs, d’unités ou de clients selon le mode) à un prix unitaire HT. Ajoutez autant de paliers que nécessaire, par exemple :

10 acheteurs  → 18,00 € HT
50 acheteurs  → 15,00 € HT
100 acheteurs → 12,00 € HT

À chaque enregistrement, le module recalcule le palier courant et met à jour le prix spécifique. Les prix doivent être décroissants à mesure que le seuil augmente.

Les modes de comptage

Le mode de comptage détermine ce qui fait progresser le compteur collectif :

• Commandes : nombre de commandes distinctes contenant le produit.
• Unités vendues : quantité totale d’unités du produit vendues.
• Clients distincts : nombre de clients différents ayant acheté le produit.

L’option Commandes valides uniquement restreint le comptage aux commandes considérées comme valides par PrestaShop (paiement accepté, etc.), ce qui évite de compter des commandes annulées ou en attente.

Le prix collectif en temps réel

Dès qu’une commande est validée ou change de statut, le module recompte la campagne, détermine le palier atteint et met à jour le prix spécifique appliqué à tous les acheteurs. Le nouveau prix s’affiche immédiatement partout, sans intervention. Aucun CRON n’est nécessaire : tout est piloté par les évènements de commande.

Prix par palier de quantité (achat en gros)

En mode Unités vendues, un client qui commande une grande quantité d’un coup franchit seul un palier : il obtient alors immédiatement le prix de ce palier sur sa propre commande, sans attendre que le collectif l’atteigne. Par exemple, avec un palier à 10 unités, un client qui met 10 exemplaires au panier paie tout de suite le prix du palier 10.

Cette logique reste « meilleur prix pour tous » : si le prix collectif courant est déjà plus bas que le prix du palier de quantité, c’est le prix collectif qui s’applique. Tout passe par les prix spécifiques natifs (par paliers de quantité), donc le bon tarif s’affiche dès le panier.

Remboursement rétroactif

Quand l’option est activée, le principe « tout le monde au meilleur prix » s’applique : dès qu’un palier inférieur se débloque, les acheteurs précédents reçoivent automatiquement un bon de réduction égal à la différence entre le prix qu’ils ont payé et le nouveau prix, multiplié par la quantité achetée. Un e-mail de notification est envoyé si l’option d’envoi est active.

• Le bon est un code de réduction (CartRule) nominatif, valable le nombre de jours configuré.
• Seuls les acheteurs ayant payé plus cher que le nouveau prix reçoivent un bon.
• Le prix effectif de chaque participant est mis à jour pour éviter tout double remboursement lors des baisses suivantes.

Le widget sur la fiche produit

Sur la fiche produit, le module affiche un widget qui met en scène la dynamique collective :

• Un badge et le prix de référence barré face au prix courant.
• Le compteur collectif et une barre de progression vers le prochain palier.
• L’échelle complète des paliers, le palier courant étant mis en avant.
• Un compte à rebours jusqu’à la fin de la campagne.
• Une note sur le remboursement rétroactif quand l’option est active.

L’ensemble se rafraîchit en direct par AJAX, à l’intervalle défini dans les réglages, sans rechargement de page.

FAQ et dépannage

Le widget ne s’affiche pas sur le produit

Vérifiez qu’une campagne active cible bien ce produit, que la date du jour est comprise entre la date de début et la date de fin, et que la campagne appartient à la boutique courante. Si vous ciblez une déclinaison précise, le widget n’apparaît que pour cette déclinaison.

Le prix ne baisse pas alors que le seuil est atteint

Le recalcul est déclenché par la validation des commandes et les changements de statut. Si vous comptez les commandes valides, assurez-vous que les commandes concernées sont bien dans un état valide. Une simple modification puis sauvegarde de la campagne force également un recalcul.

Un gros acheteur n’obtient pas le prix de sa quantité

Le prix par palier de quantité ne fonctionne qu’en mode Unités vendues, et pour des seuils supérieurs ou égaux à 2. En mode Commandes ou Clients, la quantité d’une commande ne franchit pas de palier à elle seule.

Fonctionne-t-il avec les déclinaisons ?

Oui. Une campagne peut cibler une déclinaison précise ou toutes les déclinaisons d’un produit. Une campagne ciblant une déclinaison précise prime sur une campagne « toutes déclinaisons ».

Que se passe-t-il à la désinstallation ?

La désinstallation retire les prix spécifiques créés par le module, supprime ses hooks et son onglet, et nettoie ses tables. Les bons de réduction déjà émis restent valables côté clients.