Stückliste — Sets & Montage — Vollständige Anleitung
Stücklisten (BOM) installieren, konfigurieren und nutzen: virtuelle Sets mit berechnetem Bestand, Komponentenabbuchung beim Verkauf, Montageaufträge, berechneter Preis und Zusammensetzung im Frontend für PrestaShop 8 und 9.
Überblick und Voraussetzungen
Das Modul Stückliste ergänzt PrestaShop um eine Stücklistenverwaltung (BOM): Jedes Produkt kann die Liste seiner Komponenten mit Mengen deklarieren, und der Shop zieht automatisch die Konsequenzen für Bestand und Preis. Je nach Geschäft stehen zwei Logiken zur Verfügung: das virtuelle Set (berechneter Bestand, Komponentenabbuchung beim Verkauf) und die physische Montage (Fertigungsaufträge, die Fertigproduktbestand erzeugen).
- Kompatibel mit PrestaShop 8.0 bis 9.x, Classic-Theme und abgeleiteten Themes.
- PHP 7.4 bis 8.3.
- Multishop und mehrsprachig.
- Komponenten mit Varianten, mehrstufige Stücklisten, Schutz vor Zirkelbezügen.
- PrestaShop-konforme Architektur (ModuleAdminController, ObjectModel), ohne Composer-Abhängigkeit.
Im Modus virtuelles Set wird der Produktbestand nicht mehr manuell eingegeben: Das Modul berechnet ihn als das Minimum, das die Komponenten erlauben, und aktualisiert ihn bei jeder Bewegung.
Installation
Installieren Sie das Modul wie jedes PrestaShop-Modul:
- Laden Sie das Archiv
datafireflybom.zipaus Ihrem Kundenkonto herunter. - Gehen Sie im Back-Office zu Module > Modul-Manager.
- Klicken Sie auf Modul hochladen und legen Sie das Archiv ab.
- Klicken Sie nach der Installation auf Konfigurieren, wenn Sie die globalen Einstellungen anpassen möchten.
Bei der Installation erstellt das Modul seine Tabellen (dfbom, dfbom_component, dfbom_assembly_log), registriert seine Hooks und fügt den Tab Stücklisten / BOM unter Katalog hinzu. Die Stücklisten werden anschließend auf jeder Produktseite verwaltet.
Allgemeine Moduleinstellungen
Die Konfigurationsseite (Module > DataFirefly BOM > Konfigurieren) bündelt die globalen Einstellungen und die Liste der vorhandenen Stücklisten:
- Echtzeit-Synchronisation: berechnet den Bestand virtueller Sets und die berechneten Preise automatisch neu, sobald sich Bestand oder Preis einer Komponente ändert. Standardmäßig aktiviert.
- Negative Bestände erlauben: ermöglicht Montage oder Verkauf, auch wenn der Komponentenbestand nicht ausreicht (Just-in-time). Standardmäßig deaktiviert.
- Alle Bestände / Preise neu synchronisieren: eine Schaltfläche, die Bestand und Preis aller aktiven Stücklisten auf einmal neu berechnet. Nützlich nach einem Import oder einer Datenübernahme.
Eine Stückliste erstellen
Öffnen Sie eine Produktseite, dann den Tab Module: Das Panel Stückliste / BOM erscheint. Aktivieren Sie die Stückliste mit dem Schalter oben und folgen Sie den nummerierten Schritten.
1. Bestandsmodus wählen
- Virtuelles Set: Der Produktbestand wird automatisch aus den Komponenten berechnet und jeder Verkauf bucht sie ab. Ideal für auftragsbezogene Boxen und Bundles.
- Physische Montage: Das Fertigprodukt hat seinen eigenen Bestand, gespeist durch Montageaufträge. Ideal für die Serienfertigung.
2. Preismodus wählen
- Fester Preis: Der Preis bleibt der auf der Produktseite festgelegte. Keine Neuberechnung.
- Berechneter Preis: Der Preis wird zur Summe der Komponentenpreise abzüglich eines prozentualen Rabatts, den Sie eingeben. Wird automatisch neu berechnet, wenn sich ein Komponentenpreis ändert.
3. Komponenten hinzufügen
Nutzen Sie das Suchfeld, um ein Produkt nach Name, Referenz oder ID zu finden. Die Ergebnisse zeigen Vorschaubild, Referenz, Bestand und Preis; klicken Sie, um die Komponente hinzuzufügen. In jeder Zeile lässt sich die benötigte Menge mit den +/−-Schaltflächen einstellen. Sie können eine bestimmte Variante als Komponente hinzufügen (sie erscheint separat in der Suche).
Die vier Kennzahlen oben im Panel (Komponenten, montierbare Menge, Komponentenkosten, berechneter Preis) aktualisieren sich live, während Sie Mengen und Rabatt anpassen — noch vor dem Speichern.
4. Speichern
Klicken Sie auf Stückliste speichern. Das Modul speichert die Stückliste, berechnet sofort den Set-Bestand neu (virtueller Modus) und wendet gegebenenfalls den berechneten Preis an.
Der Modus virtuelles Set
Im Modus virtuelles Set ist der Produktbestand das Minimum, das seine Komponenten erlauben: Für eine Box, die 2 Hämmer und 1 Tasche benötigt, mit 120 Hämmern und 40 Taschen auf Lager, zeigt das Set 40 verfügbare Einheiten.
- Bei der Bestellvalidierung wird der Bestand jeder Komponente gemäß den Stücklistenmengen abgebucht, anschließend wird der Set-Bestand — und der aller Sets, die diese Komponenten teilen — neu berechnet.
- Bei Stornierung oder Erstattung einer Position werden die Komponenten automatisch wiederhergestellt.
- Ist die Echtzeit-Synchronisation aktiv, aktualisiert jede Bestandsänderung einer Komponente (Direktverkauf, Nachschub, anderes Set) den Bestand der betroffenen Sets.
Der Modus virtuelles Set setzt voraus, dass das Set selbst ein Produkt ohne Varianten ist: Der berechnete Bestand wird auf das Produkt gesetzt (Variante 0). Die Komponenten hingegen können Varianten sein.
Der Modus physische Montage
Im Montagemodus behält das Fertigprodukt seinen eigenen Bestand. Sie füllen ihn über Montageaufträge aus dem Panel der Produktseite:
- Geben Sie eine Menge ein (die Max-Schaltfläche zeigt, wie viele Ihr Komponentenbestand zu fertigen erlaubt).
- Klicken Sie auf Montieren: Die Komponenten werden verbraucht und der Fertigproduktbestand steigt.
- Klicken Sie auf Demontieren für den umgekehrten Vorgang: Das Fertigprodukt wird abgebucht und die Komponenten wiederhergestellt.
Jeder Vorgang wird in einer Historie mit Mitarbeiter, Datum, Vorgang und Menge protokolliert. Die vollständige Historie ist unter Katalog > Stücklisten / BOM einsehbar.
Sind negative Bestände nicht erlaubt, wird die Montage blockiert, wenn der Komponentenbestand nicht ausreicht, und die Demontage, wenn der Fertigproduktbestand nicht ausreicht. Eine Meldung zeigt das mögliche Maximum an.
Der berechnete Preis
Im Modus berechneter Preis entspricht der Nettopreis des Sets der Summe der Nettopreise seiner Komponenten (multipliziert mit ihren Mengen) abzüglich des festgelegten Prozentrabatts. Dieser Preis wird auf die Produktseite geschrieben und neu berechnet:
- bei jedem Speichern der Stückliste;
- wenn sich der Preis einer Komponente ändert, sofern die Echtzeit-Synchronisation aktiv ist;
- bei einer globalen Neusynchronisation über die Konfigurationsseite.
Im Modus fester Preis rührt das Modul den Preis Ihrer Produktseite nie an. Der berechnete Preis wird im Panel weiterhin zur Information angezeigt, aber nicht angewendet.
Mehrstufige Stücklisten und Varianten
Eine Komponente kann eine bestimmte Variante eines Produkts (Größe, Farbe …) oder selbst ein Set mit eigener Stückliste sein. Baugruppen verschachteln sich dann über mehrere Ebenen und die Bestandsberechnungen kaskadieren. Das Modul erkennt und blockiert Zirkelbezüge, auch indirekte, beim Speichern: Ein Set kann sich nicht selbst enthalten.
Die Zusammensetzung im Frontend
Ein Kontrollkästchen „Den Tab Zusammensetzung auf der Shop-Produktseite anzeigen“ ermöglicht es Ihnen, pro Produkt den Set-Inhalt Ihren Kunden zu präsentieren. Ein Tab Zusammensetzung listet dann jede Komponente mit Bild, Menge und einem Link zu ihrer Seite auf. Deaktiviert bleibt die Stückliste im Shop völlig unsichtbar.
FAQ und Fehlerbehebung
Der Set-Bestand aktualisiert sich nicht
Prüfen Sie, ob die Stückliste aktiv ist, im Modus virtuelles Set, und ob die Echtzeit-Synchronisation in den Einstellungen aktiviert ist. Eine Schaltfläche Alle Bestände / Preise neu synchronisieren auf der Konfigurationsseite erzwingt eine vollständige Neuberechnung.
Der berechnete Preis wird nicht angewendet
Der Preis wird nur im Modus berechneter Preis auf die Produktseite geschrieben. Im Modus fester Preis ist der angezeigte Wert nur ein Hinweis. Prüfen Sie außerdem, ob die Komponenten einen Preis hinterlegt haben.
Ich kann nicht montieren
Ohne Erlaubnis negativer Bestände ist die Montage durch den Komponentenbestand begrenzt. Die Max-Schaltfläche zeigt die maximal mögliche Menge. Aktivieren Sie die Option Negative Bestände erlauben in den Einstellungen, falls Ihr Ablauf es erfordert.
Eine Zirkelbezug-Meldung erscheint
Sie versuchen, als Komponente ein Produkt hinzuzufügen, das bereits (direkt oder über ein Sub-Set) das gerade bearbeitete Produkt enthält. Entfernen Sie diese Komponente oder ordnen Sie Ihren Stücklistenbaum neu.
Kann ich die Komponenten separat verkaufen?
Ja, das ist das typische Szenario. Jede Komponente bleibt ein normales Produkt, einzeln verkäuflich. Das Modul sorgt für Konsistenz: Jeder Verkauf, der Einzelkomponente oder des Sets, aktualisiert die Bestände und montierbaren Mengen aller betroffenen Sets.
Was passiert bei der Deinstallation?
Die Deinstallation entfernt Tab und Hooks des Moduls, löscht seine Tabellen (dfbom, dfbom_component, dfbom_assembly_log) und seine Konfigurationsvariablen. Bereits auf die Produktseiten geschriebene Bestände und Preise bleiben unverändert.