Stuklijst / BOM: kits en assemblage, volledige gids

Overzicht en vereisten

De module Stuklijst / BOM voegt aan PrestaShop een beheer van de Bill of Materials toe: elk product kan de lijst van zijn onderdelen met hun aantallen opgeven, en de winkel trekt daaruit automatisch de gevolgen voor de voorraad en de prijs. Er zijn twee logica’s, naargelang uw activiteit: de virtuele kit (berekende voorraad, de onderdelen worden bij de verkoop afgeboekt) en de fysieke assemblage (productieorders die voorraad van het eindproduct opleveren).

• Geschikt voor PrestaShop 8.0 tot 9.x, het Classic-thema en afgeleiden.
• PHP 7.4 tot 8.3.
• Multistore en meertalig.
• Onderdelen met varianten, stuklijsten op meerdere niveaus, en bescherming tegen kringverwijzingen.
• Architectuur volgens de regels van PrestaShop (ModuleAdminController, ObjectModel), zonder Composer-afhankelijkheid.

Installatie

Installeer de module zoals elke andere PrestaShop-module:

1. Download het archief datafireflybom.zip vanuit uw klantaccount.
2. Ga in de backoffice naar Modules > Modulebeheer.
3. Klik op Een module installeren en plaats het archief.
4. Klik na de installatie op Configureren als u de algemene instellingen wilt bijstellen.

Bij de installatie maakt de module zijn tabellen aan (dfbom, dfbom_component en dfbom_assembly_log), registreert hij zijn hooks en voegt hij het tabblad Stuklijsten / BOM toe onder Catalogus. Het beheer van de stuklijsten gebeurt daarna vanaf elke productfiche.

Algemene instellingen van de module

De configuratiepagina (Modules > DataFirefly BOM > Configureren) bundelt de algemene instellingen en de lijst met bestaande stuklijsten:

• Synchronisatie in real time: berekent de voorraad van de virtuele kits en de berekende prijzen automatisch opnieuw zodra de voorraad of de prijs van een onderdeel wijzigt. Standaard aan.
• Negatieve voorraden toestaan: laat toe te assembleren of te verkopen ook al is de voorraad van de onderdelen ontoereikend (just-in-time). Standaard uit.
• Alle voorraden en prijzen opnieuw synchroniseren: een knop die de voorraad en de prijs van alle actieve stuklijsten in één keer herberekent. Handig na een import of een gegevensovername.

Een stuklijst maken

Open een productfiche en daarna het tabblad Modules: het paneel Stuklijst / BOM verschijnt. Zet de stuklijst met de schakelaar bovenaan aan en volg daarna de genummerde stappen.

1. De voorraadmodus kiezen

• Virtuele kit: de voorraad van het product wordt automatisch uit de onderdelen berekend en elke verkoop boekt die af. Ideaal voor geschenkdozen en pakketten die op bestelling worden klaargemaakt.
• Fysieke assemblage: het eindproduct heeft zijn eigen voorraad, die met productieorders wordt aangevuld. Ideaal voor serieproductie.

2. De prijsmodus kiezen

• Vaste prijs: de prijs blijft die van de productfiche. Er wordt niets herberekend.
• Berekende prijs: de prijs wordt de som van de prijzen van de onderdelen, min een korting in procent die u invult. Die wordt automatisch herberekend wanneer de prijs van een onderdeel wijzigt.

3. De onderdelen toevoegen

Zoek met het zoekveld een product op naam, referentie of ID. De resultaten tonen de miniatuur, de referentie, de voorraad en de prijs; klik om het onderdeel toe te voegen. Op elke regel stelt u de benodigde hoeveelheid in met de knoppen + en −. U kunt ook een specifieke variant als onderdeel toevoegen (die verschijnt apart in de zoekresultaten).

4. Bewaren

Klik op De stuklijst bewaren. De module bewaart de stuklijst, herberekent meteen de voorraad van de kit (in de virtuele modus) en past waar nodig de berekende prijs toe.

De modus virtuele kit

In de modus virtuele kit is de voorraad van het product het minimum van wat de onderdelen toelaten: bij een doos met 2 hamers en 1 koffer, met 120 hamers en 40 koffers op voorraad, toont de kit 40 beschikbare stuks.

• Bij de validatie van een bestelling wordt de voorraad van elk onderdeel volgens de aantallen uit de stuklijst afgeboekt, en daarna wordt de voorraad van de kit herberekend, samen met die van alle kits die die onderdelen delen.
• Bij een annulering of een terugbetaling van een regel komen de onderdelen automatisch terug.
• Staat de synchronisatie in real time aan, dan werkt elke voorraadwijziging van een onderdeel (een rechtstreekse verkoop, een herbevoorrading, een andere kit) de voorraad van de betrokken kits bij.

De modus fysieke assemblage

In de assemblagemodus houdt het eindproduct zijn eigen voorraad. U vult die aan met productieorders vanuit het paneel op de productfiche:

1. Voer een hoeveelheid in (de knop Max geeft aan hoeveel uw voorraad onderdelen toelaat te maken).
2. Klik op Assembleren: de onderdelen worden verbruikt en de voorraad van het eindproduct stijgt.
3. Klik op Demonteren voor de omgekeerde bewerking: het eindproduct wordt afgeboekt en de onderdelen komen terug.

Elke bewerking komt in een historiek met de medewerker, de datum, de bewerking en de hoeveelheid. De volledige historiek staat onder Catalogus > Stuklijsten / BOM.

De berekende prijs

In de modus berekende prijs is de prijs van de kit exclusief btw gelijk aan de som van de prijzen exclusief btw van zijn onderdelen (maal hun aantallen), min de ingestelde korting in procent. Die prijs komt op de productfiche te staan en wordt herberekend:

• telkens wanneer de stuklijst wordt bewaard;
• wanneer de prijs van een onderdeel wijzigt, als de synchronisatie in real time aanstaat;
• bij een algemene hersynchronisatie vanaf de configuratiepagina.

Stuklijsten op meerdere niveaus en varianten

Een onderdeel kan een specifieke variant van een product zijn (maat, kleur en zo verder) of zelf een kit met een eigen stuklijst. De deelgehelen nesten dan over meerdere niveaus en de voorraadberekeningen werken in cascade door. De module herkent en blokkeert kringverwijzingen, ook onrechtstreekse, op het moment van bewaren: een kit kan zichzelf niet bevatten.

De samenstelling aan de frontzijde

Met het vakje « Het tabblad Samenstelling op de productfiche in de winkel tonen » toont u de inhoud van de kit per product aan uw klanten. Er verschijnt dan een tabblad Samenstelling met elk onderdeel, zijn afbeelding, zijn hoeveelheid en een link naar zijn fiche. Staat dat uit, dan blijft de stuklijst aan winkelzijde volledig onzichtbaar.

FAQ en probleemoplossing

De voorraad van de kit wordt niet bijgewerkt

Controleer of de stuklijst actief is, in de modus virtuele kit staat, en of de synchronisatie in real time in de instellingen aanstaat. Met de knop Alle voorraden en prijzen opnieuw synchroniseren op de configuratiepagina dwingt u een volledige herberekening af.

De berekende prijs wordt niet toegepast

De prijs komt alleen in de modus berekende prijs op de productfiche te staan. In de modus vaste prijs is de getoonde waarde louter informatief. Controleer ook of bij de onderdelen wel een prijs is ingevuld.

Ik kan niet assembleren

Zonder toelating voor negatieve voorraden wordt het assembleren door de voorraad onderdelen begrensd. De knop Max geeft de maximaal mogelijke hoeveelheid aan. Schakel de optie Negatieve voorraden toestaan in de instellingen in als uw werkwijze dat vraagt.

Er verschijnt een melding over een kringverwijzing

U probeert een product als onderdeel toe te voegen dat het product dat u bewerkt al bevat, rechtstreeks of via een subkit. Haal dat onderdeel weg of herschik uw structuur van stuklijsten.

Kan ik de onderdelen apart verkopen?

Ja, dat is het typische geval. Elk onderdeel blijft een gewoon product dat u afzonderlijk verkoopt. De module bewaakt de samenhang: elke verkoop, van het losse onderdeel of van de kit, werkt de voorraden en de assembleerbare hoeveelheden van alle betrokken kits bij.

Wat gebeurt er bij het verwijderen?

Het verwijderen wist het tabblad en de hooks van de module, haalt zijn tabellen weg (dfbom, dfbom_component en dfbom_assembly_log) en ook zijn configuratievariabelen. De voorraden en prijzen die al op de productfiches staan, blijven zoals ze zijn.