Quantité minimum et vente par multiple : documentation DataFirefly Minimums

Installation

Installez le module depuis Modules > Gestionnaire de modules > Installer un module avec le fichier ZIP, ou déposez le dossier dfminimums dans le répertoire /modules/ de la boutique puis cliquez sur Installer.

À l’installation, le module crée deux tables (règles de quantité et minimums de commande), enregistre ses hooks et ajoute deux onglets dans le menu Catalogue : Minimums et multiples et Minimums de commande.

Réglages du module

La page de configuration du module réunit six réglages.

Activer les règles d’achat

Interrupteur général. Désactivé, aucune règle n’est affichée ni appliquée en boutique. Les règles restent enregistrées.

Ajuster les quantités automatiquement

Quand un client ajoute au panier une quantité qui ne respecte pas une règle, le module la remplace par la quantité autorisée la plus proche : vers le haut à l’ajout, vers le bas au retrait. Un ajout de 7 sur un produit vendu par 6 donne 12, un passage de 12 à 11 donne 6. Les lignes personnalisées ne sont jamais modifiées. Désactivé, la quantité reste telle quelle et le panier est bloqué jusqu’à correction par le client.

Afficher les conditions sur la fiche produit

Affiche un encadré sous le bouton d’ajout au panier avec le minimum, le multiple et le maximum qui s’appliquent au client connecté. L’encadré apparaît aussi dans la vue rapide.

Afficher un badge dans les listes de produits

Ajoute un badge court sous le prix des miniatures produit, par exemple « Vendu par 6 » ou « Min. 12 ».

Afficher les conditions sous chaque ligne du panier

Rappelle la condition de chaque ligne et affiche l’erreur en rouge quand la quantité n’est pas autorisée.

Client dans plusieurs groupes

Détermine le minimum de commande retenu quand un client appartient à plusieurs groupes ayant chacun un minimum : celui de son groupe par défaut, le plus élevé ou le plus bas.

Créer une règle de quantité

Ouvrez Catalogue > Minimums et multiples et cliquez sur Ajouter une règle.

S’applique à

• Un produit : recherchez le produit par nom, référence, EAN ou ID, puis choisissez éventuellement une déclinaison. Une règle sur une déclinaison est prioritaire sur une règle portant sur tout le produit.
• Une catégorie : choisissez la catégorie et indiquez si les sous-catégories sont incluses. Tous les produits associés à la catégorie sont concernés, quelle que soit leur catégorie par défaut.
• Tous les produits : la règle vise tout le catalogue.

Groupe client

Laissez « Tous les groupes clients » ou choisissez un groupe. Une règle de groupe s’applique à tout client qui appartient à ce groupe, même si ce n’est pas son groupe par défaut.

Minimum, multiple et maximum

• Quantité minimum : 0 ou 1 signifie pas de minimum. Si un multiple est défini et que le minimum n’en est pas un, il est arrondi au multiple supérieur : minimum 10 par 6 donne 12.
• Vendu par multiples de : 1 laisse la quantité libre, 6 n’accepte que 6, 12, 18 et ainsi de suite.
• Quantité maximum : 0 signifie pas de maximum. Le maximum doit être un multiple du multiple choisi et supérieur ou égal au minimum.

Une règle doit définir au moins un minimum supérieur à 1, un multiple supérieur à 1 ou un maximum.

Quelle règle s’applique

Pour chaque produit du panier, une seule règle « par produit » s’applique. Le module la choisit dans cet ordre :

1. la priorité la plus haute ;
2. à priorité égale, la règle la plus spécifique : déclinaison, puis produit, puis catégorie (la plus profonde d’abord), puis tous les produits ;
3. à spécificité égale, une règle de groupe client avant une règle pour tous les groupes.

Exemple : une règle « Vins, vendu par 6 » pour tous les clients et une règle « Vins, vendu par 12 » pour le groupe Professionnels. Un professionnel commande par 12, un particulier par 6.

Le panneau du module dans l’onglet Modules de la fiche produit liste les règles qui visent directement le produit et celles de catégorie ou de catalogue qui peuvent aussi s’appliquer.

Panachage par catégorie

Sur une règle de catégorie, le champ Mode de comptage propose deux valeurs.

• Chaque produit séparément : la règle s’applique à chaque produit de la catégorie, comme une règle produit.
• Tous les produits de la catégorie ensemble (panachage) : le minimum, le multiple et le maximum portent sur la somme des quantités de tous les produits de la catégorie présents dans le panier.

Exemple : minimum 12 et multiple 6 en panachage sur la catégorie Vins. Le client peut prendre 4 rouges, 4 blancs et 4 rosés. Avec 13 bouteilles au total, le panier est bloqué.

Les règles en panachage sont vérifiées en plus de la règle propre de chaque produit. Un vin vendu à l’unité reste vendable à l’unité, à condition que le total de la catégorie respecte la règle de panachage.

Minimums de commande par groupe

Ouvrez Catalogue > Minimums de commande et cliquez sur Ajouter un minimum de commande.

• Groupe client : un minimum par groupe. L’entrée « Tous les clients (par défaut) » s’applique aux clients dont les groupes n’ont pas de minimum dédié.
• Montant minimum : saisi dans la devise par défaut de la boutique, converti automatiquement pour les paniers dans une autre devise. Les frais de port ne sont jamais inclus.
• Montant TTC : Non compare le montant au total des produits HT, ce qui est l’usage en B2B.
• Déduire les bons de réduction : Oui prend le total après règles panier et bons de réduction.

Ce que voit le client

Quand le panier ne respecte pas une règle, le module renseigne la clé minimalPurchaseRequired du panier, celle que PrestaShop utilise pour son propre montant minimum. Le bouton de commande est désactivé et l’alerte native du panier affiche la phrase « Votre panier ne remplit pas encore les conditions d’achat. » suivie du détail de chaque problème : quantité non autorisée avec les quantités possibles, total d’une catégorie en panachage, montant restant à ajouter pour atteindre le minimum de commande.

Le contrôle est refait à l’ouverture de la page de commande : un client qui tente d’y accéder directement est renvoyé au panier.

En front, les champs quantité suivent la règle. Sur le thème Classic, les boutons TouchSpin avancent par pas du multiple. Sur Hummingbird, les boutons +/- passent directement à la quantité autorisée suivante ou précédente.

Import et export CSV

L’import se trouve en haut de la liste des règles. Le fichier accepte le séparateur ; ou , et doit contenir une ligne d’en-tête avec au moins la colonne scope. Colonnes reconnues :

• name : nom interne, généré s’il est vide ;
• scope : product, category ou all ;
• product_id ou product_reference ;
• combination_reference : référence de déclinaison ;
• category_id et include_subcategories (0 ou 1) ;
• apply_mode : per_product ou cumulative (panachage) ;
• group_id : 0 pour tous les groupes ;
• min_qty, multiple, max_qty, priority, active.

La case « Supprimer d’abord toutes les règles existantes de cette boutique » remplace l’ensemble des règles. Les lignes en erreur sont listées avec leur numéro et ne bloquent pas les autres. Le bouton Exporter en CSV produit le même format, pratique pour dupliquer des règles d’une boutique à l’autre. Un fichier d’exemple est téléchargeable depuis le bloc d’import.

Bonnes pratiques

• Commencez par une règle large (catégorie ou catalogue) puis ajoutez les exceptions produit : la règle la plus spécifique l’emporte sans toucher à la priorité.
• Réservez la priorité aux cas où une règle moins spécifique doit gagner, par exemple une règle de catégorie qui doit s’imposer à tous ses produits.
• Testez avec un compte client de chaque groupe concerné : les règles de groupe ne sont pas visibles pour un visiteur non connecté.
• Après une modification, videz le cache si votre boutique utilise un module de cache pleine page.

Dépannage

Le client ne peut pas descendre sous une quantité alors qu’aucune règle ne l’impose

Vérifiez la quantité minimum native de la fiche produit (onglet Stocks ou Quantités selon la version) et remettez-la à 1.

Le panier est bloqué avec le message natif de montant minimum

C’est le minimum natif de Paramètres de la boutique > Commandes. Mettez-le à 0 si seuls les minimums par groupe doivent compter.

Les boutons +/- avancent de 1 en 1

Le thème n’utilise pas les sélecteurs standards de Classic ou Hummingbird. La règle reste appliquée côté serveur : le panier est corrigé ou bloqué. Contactez-nous avec le nom du thème pour une adaptation.

Un module de commande en une page laisse passer la commande

Le module tiers ignore minimalPurchaseRequired. Testez-le sur une boutique de préproduction et contactez-nous avec son nom.

Compatibilité

• PrestaShop 8.0 à 9.x, le même ZIP couvre les deux branches.
• Thèmes Classic et Hummingbird.
• Multiboutique : les règles et minimums sont enregistrés par boutique.
• Architecture ModuleAdminController, sans dépendance Composer, PHP 7.2 et plus.
• Interface disponible en anglais, français, espagnol, allemand, italien, néerlandais, polonais et portugais.