Commande Rapide B2B (Quick Order) — Guide complet
Installer, configurer et exploiter la commande rapide B2B : grille SKU avec autocomplétion, import CSV, collage Excel, listes de réachat et recommande en un clic pour PrestaShop 8 et 9.
Présentation
Le module Commande Rapide B2B (dfquickorder) ajoute une page de saisie rapide où vos clients professionnels composent une commande directement à partir de leurs références (SKU), sans parcourir le catalogue. Ils peuvent saisir les références une à une avec autocomplétion, coller deux colonnes depuis Excel, importer un fichier CSV, recharger une liste de réachat enregistrée ou recommander une commande passée, puis tout ajouter au panier en un clic.
Conçu pour le réassort B2B et les acheteurs pressés : un grossiste qui connaît ses références gagne un temps considérable par rapport à la navigation produit par produit. La grille résout chaque SKU en temps réel (nom, prix selon le groupe, stock, quantité minimum, déclinaison).
Compatibilité
- PrestaShop 8.0 à 9.x
- PHP 7.4 à 8.3
- Mono-boutique et multi-boutique
- 5 langues : FR, EN, ES, DE, IT
- Thème Classic et thèmes personnalisés (grille en JavaScript natif, sans dépendance jQuery)
- Aucune dépendance (ni Composer ni framework)
Installation
- Dans le back-office, ouvrez Modules > Gestionnaire de modules.
- Cliquez sur Installer un module puis sélectionnez le fichier
dfquickorder.zip. - Une fois installé, cliquez sur Configurer.
À l’installation, le module crée sa table de listes de réachat, enregistre ses hooks (displayCustomerAccount, displayNav2 et le hook personnalisé displayQuickOrderBlock) et initialise ses réglages par défaut. Un lien Commande rapide apparaît alors dans l’espace client.
Configuration
Accès et restriction
- Groupes de clients autorisés : laissez vide pour ouvrir la commande rapide à tout le monde, ou sélectionnez un ou plusieurs groupes pour la réserver à vos clients B2B. Les visiteurs non autorisés sont redirigés vers leur compte.
Saisie et import
- Séparateur CSV : point-virgule, virgule, tabulation ou barre verticale, selon le format exporté par vos clients.
- Nombre de lignes par défaut : nombre de lignes vides affichées à l’ouverture de la grille.
- Lignes maximum par CSV / collage : garde-fou contre les imports trop volumineux ; les lignes au-delà de la limite sont ignorées avec un avertissement.
Affichage et fonctionnalités
- Afficher le prix et le sous-total : affiche le prix unitaire, le total par ligne et le total estimé, calculés selon la méthode fiscale du groupe (HT ou TTC).
- Collage depuis Excel : active l’onglet de collage de deux colonnes (référence et quantité).
- Listes de réachat : active l’enregistrement et le rechargement de listes nommées par client.
- Recommande en un clic : active le rechargement d’une commande passée dans la grille.
- Bouton « Convertir en devis » : affiché uniquement si le module
dfb2bquoteest installé et actif (pont avec la gamme devis B2B).
Utilisation
La grille de saisie SKU
Le client saisit une référence : un menu d’autocomplétion propose les produits et déclinaisons correspondants (par référence ou par nom). À la validation, la ligne est résolue en temps réel et affiche le nom du produit, le libellé de la déclinaison, le prix unitaire selon son groupe, le total de ligne et un badge de statut. Une nouvelle ligne vide est ajoutée automatiquement au fur et à mesure.
Les statuts de ligne
- Vert : référence valide, stock suffisant.
- Orange : quantité ajustée (stock partiel disponible, ou quantité minimum de vente atteinte).
- Rouge : référence inconnue, produit indisponible ou rupture de stock.
La résolution gère les déclinaisons : une référence de déclinaison renvoie le bon id_product_attribute et son libellé d’attributs. La recherche se fait sur la référence puis, en repli, sur le code-barres EAN13, en respectant la boutique courante et les produits actifs.
Coller depuis Excel
Dans l’onglet Coller depuis Excel, le client colle deux colonnes (référence et quantité) directement depuis son tableur. Chaque ligne est analysée et résolue, puis injectée dans la grille avec son statut. Une éventuelle ligne d’en-tête (« sku », « référence »…) est détectée et ignorée.
Import CSV
Dans l’onglet Import CSV, le client charge un fichier à deux colonnes. Le fichier est lu côté navigateur puis envoyé pour résolution. Un modèle CSV téléchargeable est fourni pour guider le format attendu. Le séparateur configuré dans le back-office est appliqué, avec repli automatique sur les séparateurs courants.
Listes de réachat
Un client connecté peut enregistrer la grille en cours comme liste nommée (par exemple « Réassort mensuel ») et la recharger à tout moment depuis l’onglet Mes listes. Chaque liste appartient au client et à la boutique ; elle peut être chargée dans la grille ou supprimée.
Recommander une commande passée
L’onglet Recommander liste les dernières commandes valides du client. Un clic recharge l’intégralité des références et quantités de la commande dans la grille, prêtes à être ajustées puis ajoutées au panier.
Ajouter au panier et convertir en devis
Le bouton Tout ajouter au panier ajoute en une fois toutes les lignes valides au panier, en respectant les quantités. Si le module dfb2bquote est actif, le bouton Convertir en devis ajoute les lignes au panier puis bascule vers le parcours devis.
Accès à la commande rapide
Le lien Commande rapide est disponible dans l’espace client. Vous pouvez aussi l’afficher dans la navigation haute et, via le hook personnalisé displayQuickOrderBlock, insérer un bloc d’appel à l’action où vous le souhaitez sur votre boutique.
FAQ et dépannage
La grille affiche une erreur « JSON invalide » ou ne résout pas les références
Videz le cache de PrestaShop (Paramètres avancés > Performances) et, pendant vos tests, désactivez la combinaison/compression des fichiers (CCC). Les réponses de la grille sont du JSON strict : le module purge toute sortie parasite avant de répondre, ce qui évite qu’un message PHP ne corrompe la réponse.
Comment réserver la commande rapide à mes clients professionnels ?
Dans la configuration, sélectionnez le ou les groupes autorisés dans Groupes de clients autorisés. Tous les autres visiteurs n’auront pas accès à la page.
Les déclinaisons sont-elles gérées ?
Oui. Une référence de déclinaison est résolue vers la bonne combinaison, avec son libellé d’attributs, son prix et son stock propres. Le code-barres EAN13 est également accepté comme référence.
Que se passe-t-il si une quantité dépasse le stock ?
Selon le réglage de gestion des ruptures du produit, la quantité est ajustée au stock disponible (statut orange) ou la ligne est marquée en rupture (statut rouge). Les références introuvables sont signalées sans bloquer le reste de la grille.
Les listes et la recommande nécessitent-elles un compte ?
Oui : l’enregistrement de listes et la recommande de commandes passées requièrent que le client soit connecté. La saisie SKU, le collage et l’import CSV fonctionnent aussi pour les visiteurs autorisés.
Est-ce compatible PrestaShop 9 ?
Oui. Le module est compatible PrestaShop 8 et 9, en multi-boutique et multilingue (FR, EN, ES, DE, IT).