Multi-Entrepôt & Routage Stock — Documentation
Installer, configurer et exploiter le routage automatique des commandes vers le bon entrepôt selon le stock et la géographie.
Présentation
Multi-Entrepôt & Routage Stock affecte automatiquement chaque commande validée à l’entrepôt le plus pertinent, en croisant le stock réellement disponible et la zone de livraison du client. Le module gère ses propres entrepôts, un stock indépendant par entrepôt et des règles de couverture géographique, sans aucune dépendance à une API de géocodage externe.
L’affectation se fait sur un entrepôt par commande. Lorsqu’aucun entrepôt ne couvre la totalité de la commande, celle-ci est marquée comme partielle et confiée à l’entrepôt le plus complet, pour traitement manuel.
Prérequis et compatibilité
- PrestaShop 1.7.6 à 9.x (compatible PrestaShop 8 et 9)
- PHP 7.2 à 8.x
- Compatible multiboutique et multilingue (FR, EN, ES, DE, IT)
- Aucune dépendance externe, aucune clé d’API requise
Installation
- Dans le back-office, ouvrez Modules > Module Manager puis cliquez sur Installer un module.
- Sélectionnez l’archive ZIP du module et lancez l’installation.
- Une fois installé, un menu Multi-Entrepot apparaît sous Commandes, avec quatre sous-pages : Entrepôts, Zones de couverture, Stock par entrepôt et Routage des commandes.
L’installation crée automatiquement les tables et les onglets nécessaires. La désinstallation supprime proprement les onglets et les données du module.
Configuration générale
Ouvrez la page de configuration du module pour définir la stratégie de routage et les options de stock.
Stratégies de routage
- Géographie d’abord (par défaut) : privilégie l’entrepôt le plus proche disposant de la totalité du stock.
- Stock d’abord : retient en priorité un entrepôt capable de servir l’intégralité de la commande, puis départage par proximité.
- Priorité d’entrepôt : suit l’ordre de priorité que vous définissez, en ignorant la géographie.
Options
- Couverture globale de repli : si aucune règle ne correspond, l’entrepôt reste éligible en dernier recours.
- Décrément du stock : déduit le stock de l’entrepôt à l’affectation.
- Synchronisation vers PrestaShop : remonte la somme des entrepôts vers le stock PrestaShop (optionnel, désactivé par défaut).
- Autoriser les commandes partielles : affecte malgré tout l’entrepôt le plus complet quand aucun ne couvre tout.
Créer un entrepôt
Dans Multi-Entrepot > Entrepôts, ajoutez un entrepôt avec son nom, son pays, une priorité (plus la valeur est basse, plus l’entrepôt est prioritaire) et son statut actif. Les coordonnées latitude/longitude sont facultatives et purement informatives.
Définir les zones de couverture
Dans Multi-Entrepot > Zones de couverture, associez à chaque entrepôt une ou plusieurs règles :
- Code postal : un ou plusieurs préfixes séparés par des virgules (par exemple 06, 13, 83).
- Pays : couverture d’un pays entier.
- Zone : couverture d’une zone PrestaShop.
Un entrepôt sans aucune règle est considéré comme à couverture globale : il couvre toutes les destinations. La proximité est hiérarchisée du plus précis au plus large : code postal, puis pays, puis zone, puis couverture globale.
Gérer le stock par entrepôt
Dans Multi-Entrepot > Stock par entrepôt, saisissez les quantités par produit et par entrepôt. Vous pouvez importer en un clic le stock PrestaShop existant vers un entrepôt de votre choix, puis l’ajuster.
Si la synchronisation vers PrestaShop est activée, le stock PrestaShop d’un produit est remplacé par la somme des quantités de cet article dans tous les entrepôts. Vérifiez votre paramétrage avant d’activer cette option en production.
Comprendre le routage
À la validation d’une commande, le module évalue chaque entrepôt actif selon deux axes : le palier géographique (proximité) et la capacité à servir les lignes de la commande. Selon la stratégie choisie, il sélectionne un entrepôt et lui attribue un statut.
- Automatique : un entrepôt couvre toute la commande, affectation sans intervention.
- Manuel : l’entrepôt a été choisi manuellement depuis la fiche commande.
- Partiel : aucun entrepôt ne couvre tout, le plus complet est retenu pour traitement manuel.
- Non routé : aucun entrepôt éligible (par exemple si les commandes partielles sont désactivées).
Suivre et ré-affecter les commandes
La liste Multi-Entrepot > Routage des commandes récapitule l’entrepôt affecté et le statut de chaque commande. Un panneau dédié s’affiche également dans la fiche commande du back-office : entrepôt affecté, statut, disponibilité ligne par ligne, ré-affectation manuelle et recalcul automatique en un clic.
Lors d’une ré-affectation, le stock précédemment réservé est re-crédité à l’entrepôt d’origine selon l’allocation exacte mémorisée, puis débité du nouvel entrepôt : aucune perte ni double comptage.
Dépannage
- Une commande reste non routée : vérifiez qu’au moins un entrepôt est actif et éligible, et que les commandes partielles sont autorisées si aucun entrepôt ne couvre tout.
- Le stock ne diminue pas : assurez-vous que l’option de décrément est activée dans la configuration.
- Une destination n’est jamais couverte : ajoutez une règle de couverture adaptée, ou activez la couverture globale de repli.
Le routage est encapsulé de manière sécurisée : en cas d’anomalie, l’incident est journalisé et la commande est créée normalement, sans jamais bloquer le tunnel de commande.