Nomenclature / BOM — Kits & Assemblage — Guide complet
Installer, configurer et exploiter les nomenclatures (BOM) : kits virtuels à stock calculé, décrément des composants à la vente, ordres d'assemblage, prix calculé et composition en front-office pour PrestaShop 8 et 9.
Présentation et prérequis
Le module Nomenclature / BOM ajoute à PrestaShop une gestion de Bill of Materials : chaque produit peut déclarer la liste de ses composants avec leurs quantités, et la boutique en tire automatiquement les conséquences sur le stock et le prix. Deux logiques sont disponibles selon votre activité : le kit virtuel (stock calculé, décrément des composants à la vente) et l’assemblage physique (ordres de fabrication qui produisent du stock de produit fini).
- Compatible PrestaShop 8.0 à 9.x, thème Classic et thèmes dérivés.
- PHP 7.4 à 8.3.
- Multiboutique et multilingue.
- Composants avec déclinaisons, nomenclatures multi-niveaux, protection anti-références circulaires.
- Architecture conforme PrestaShop (ModuleAdminController, ObjectModel), sans dépendance Composer.
En mode kit virtuel, le stock du produit n’est plus saisi manuellement : le module le calcule comme le minimum permis par les composants et le met à jour à chaque mouvement.
Installation
Installez le module comme n’importe quel module PrestaShop :
- Téléchargez l’archive
datafireflybom.zipdepuis votre compte client. - Dans le back-office, allez dans Modules > Gestionnaire de modules.
- Cliquez sur Installer un module et déposez l’archive.
- Une fois installé, cliquez sur Configurer si vous souhaitez ajuster les réglages globaux.
À l’installation, le module crée ses tables (dfbom, dfbom_component, dfbom_assembly_log), enregistre ses hooks et ajoute l’onglet Nomenclatures / BOM sous Catalogue. La gestion des nomenclatures se fait ensuite depuis chaque fiche produit.
Réglages généraux du module
La page de configuration (Modules > DataFirefly BOM > Configurer) regroupe les réglages globaux et la liste des nomenclatures existantes :
- Synchronisation en temps réel : recalcule automatiquement le stock des kits virtuels et les prix calculés dès qu’un composant change de stock ou de prix. Activée par défaut.
- Autoriser les stocks négatifs : permet d’assembler ou de vendre même si le stock des composants est insuffisant (flux tendu). Désactivée par défaut.
- Resynchroniser tous les stocks / prix : un bouton qui recalcule d’un coup le stock et le prix de toutes les nomenclatures actives. Utile après un import ou une reprise de données.
Créer une nomenclature
Ouvrez une fiche produit, puis l’onglet Modules : le panneau Nomenclature / BOM s’affiche. Activez la nomenclature avec l’interrupteur en haut, puis suivez les étapes numérotées.
1. Choisir le mode de stock
- Kit virtuel : le stock du produit est calculé automatiquement à partir des composants et chaque vente les décrémente. Idéal pour les coffrets et packs préparés à la commande.
- Assemblage physique : le produit fini a son propre stock, alimenté par des ordres d’assemblage. Idéal pour la fabrication en série.
2. Choisir le mode de prix
- Prix fixe : le prix reste celui défini sur la fiche produit. Aucun recalcul.
- Prix calculé : le prix devient la somme des prix des composants, moins une remise en pourcentage que vous saisissez. Recalculé automatiquement quand un composant change de prix.
3. Ajouter les composants
Utilisez le champ de recherche pour trouver un produit par nom, référence ou ID. Les résultats affichent la vignette, la référence, le stock et le prix ; cliquez pour ajouter le composant. Chaque ligne permet de régler la quantité requise avec les boutons +/−. Vous pouvez ajouter une déclinaison précise comme composant (elle apparaît séparément dans la recherche).
Les quatre indicateurs en haut du panneau (composants, quantité assemblable, coût des composants, prix calculé) se mettent à jour en direct pendant que vous ajustez quantités et remise, avant même d’enregistrer.
4. Enregistrer
Cliquez sur Enregistrer la nomenclature. Le module sauvegarde la nomenclature, recalcule immédiatement le stock du kit (mode virtuel) et applique le prix calculé le cas échéant.
Le mode kit virtuel
En mode kit virtuel, le stock du produit est le minimum de ce que permettent ses composants : pour un coffret demandant 2 marteaux et 1 mallette, avec 120 marteaux et 40 mallettes en stock, le kit affiche 40 unités disponibles.
- À la validation d’une commande, le stock de chaque composant est décrémenté selon les quantités de la nomenclature, puis le stock du kit — et de tous les kits partageant ces composants — est recalculé.
- En cas d’annulation ou de remboursement d’une ligne, les composants sont automatiquement restitués.
- Si la synchronisation temps réel est active, tout changement de stock d’un composant (vente directe, réappro, autre kit) met à jour le stock des kits concernés.
Le mode kit virtuel suppose que le kit lui-même est un produit sans déclinaisons : le stock calculé est posé sur le produit (déclinaison 0). Les composants, eux, peuvent être des déclinaisons.
Le mode assemblage physique
En mode assemblage, le produit fini conserve son propre stock. Vous l’alimentez avec des ordres d’assemblage depuis le panneau de la fiche produit :
- Saisissez une quantité (le bouton Max indique combien votre stock de composants permet de fabriquer).
- Cliquez sur Assembler : les composants sont consommés et le stock du produit fini augmente.
- Cliquez sur Désassembler pour l’opération inverse : le produit fini est décrémenté et les composants restitués.
Chaque opération est tracée dans un historique avec l’employé, la date, l’opération et la quantité. L’historique complet est consultable sous Catalogue > Nomenclatures / BOM.
Si les stocks négatifs ne sont pas autorisés, l’assemblage est bloqué lorsque le stock des composants est insuffisant, et le désassemblage lorsque le stock du produit fini est insuffisant. Un message indique le maximum possible.
Le prix calculé
En mode prix calculé, le prix HT du kit est égal à la somme des prix HT de ses composants (multipliés par leurs quantités), moins la remise en pourcentage définie. Ce prix est écrit sur la fiche produit et recalculé :
- à chaque enregistrement de la nomenclature ;
- quand le prix d’un composant change, si la synchronisation temps réel est active ;
- lors d’une resynchronisation globale depuis la page de configuration.
En mode prix fixe, le module ne touche jamais au prix de votre fiche produit. Le prix calculé reste affiché à titre indicatif dans le panneau, mais n’est pas appliqué.
Nomenclatures multi-niveaux et déclinaisons
Un composant peut être une déclinaison précise d’un produit (taille, couleur…) ou lui-même un kit disposant de sa propre nomenclature. Les sous-ensembles s’imbriquent alors sur plusieurs niveaux et les calculs de stock se propagent en cascade. Le module détecte et bloque les références circulaires, même indirectes, au moment de l’enregistrement : un kit ne peut pas se contenir lui-même.
La composition en front-office
Une case « Afficher l’onglet Composition sur la fiche produit en boutique » permet, produit par produit, de présenter le contenu du kit à vos clients. Un onglet Composition liste alors chaque composant avec son image, sa quantité et un lien vers sa fiche. Désactivée, la nomenclature reste totalement invisible côté boutique.
FAQ et dépannage
Le stock du kit ne se met pas à jour
Vérifiez que la nomenclature est active, en mode kit virtuel, et que la synchronisation temps réel est activée dans les réglages. Un bouton Resynchroniser tous les stocks / prix sur la page de configuration force un recalcul complet.
Le prix calculé n’est pas appliqué
Le prix n’est écrit sur la fiche produit qu’en mode prix calculé. En mode prix fixe, la valeur affichée est indicative. Vérifiez aussi que les composants ont bien un prix renseigné.
Je ne peux pas assembler
Sans autorisation des stocks négatifs, l’assemblage est limité par le stock des composants. Le bouton Max indique la quantité maximale possible. Activez l’option Autoriser les stocks négatifs dans les réglages si votre flux le nécessite.
Un message de référence circulaire apparaît
Vous tentez d’ajouter comme composant un produit qui contient déjà (directement ou via un sous-kit) le produit en cours d’édition. Retirez ce composant ou réorganisez votre arborescence de nomenclatures.
Puis-je vendre les composants séparément ?
Oui, c’est le scénario type. Chaque composant reste un produit normal, vendable individuellement. Le module maintient la cohérence : toute vente, du composant seul ou du kit, met à jour les stocks et les quantités assemblables de tous les kits concernés.
Que se passe-t-il à la désinstallation ?
La désinstallation supprime l’onglet et les hooks du module, retire ses tables (dfbom, dfbom_component, dfbom_assembly_log) et ses variables de configuration. Les stocks et prix déjà écrits sur les fiches produits restent en l’état.