Minimale bestelhoeveelheid en verpakkingseenheden: documentatie DataFirefly Minimums
Installatie, hoeveelheidsregels (minimum, veelvoud, maximum), prioriteiten en simulator, minimale bestellingen per groep, controles op de server, CSV-import en probleemoplossing.
Wat de module doet
DataFirefly Minimums legt een minimum, een verplicht veelvoud (per 6, per 12 verkocht) en een maximum vast per product, combinatie, categorie, merk of voor de hele catalogus, eventueel voor één klantgroep en een periode. Daarnaast legt de module een minimaal bestelbedrag per klantgroep vast. Elke regel wordt op de server opnieuw gecontroleerd, van het toevoegen aan de winkelwagen tot het aanmaken van de bestelling: een direct verzoek kan haar niet omzeilen.

Installatie
Installeer de ZIP via Modules > Modulebeheer > Een module uploaden. De module maakt haar tabellen aan, registreert haar hooks en voegt twee tabbladen toe onder Catalogus: Minimums en veelvouden en Minimale bestelling. Versie 2.0.0 werkt op PrestaShop 1.7.8, 8 en 9 met dezelfde ZIP.
Bijwerken vanaf 1.0.0: upload de ZIP 2.0.0 over de oude heen. Uw regels en minimale bestellingen blijven behouden, de nieuwe kolommen en instellingen worden automatisch toegevoegd.
Overzicht
De configuratiepagina opent met een overzicht: aantal actieve regels per doel, minimale bestellingen, lijst van de controles op de server, gebeurtenissen van de laatste 30 dagen (aangepaste hoeveelheden, geweigerde wijzigingen, geblokkeerde bestelpagina’s, geweigerde bestellingen) en consistentiecontroles. De module telt alleen echte gebeurtenissen: ze schat geen effect op de omzet.

De consistentiecontroles melden regels die een verwijderd product, categorie, merk of groep beogen, verlopen regels, afgeronde minimums, genegeerde maximums, dubbelzinnige regels (hetzelfde doel, dezelfde groep en prioriteit), producten met een voorraad onder het minimum en de standaard minimale hoeveelheid van productpagina’s.
Instellingen

- Aankoopregels inschakelen: hoofdschakelaar. Uitgeschakeld wordt niets getoond of toegepast; de regels blijven bewaard.
- Niet toegestane hoeveelheid bij toevoegen aan winkelwagen: aanpassen naar de dichtstbijzijnde toegestane hoeveelheid en de klant informeren (naar boven bij toevoegen, naar beneden bij verwijderen), of de wijziging weigeren en de toegestane hoeveelheden vermelden.
- Hoeveelheidskeuze per veelvoud: de knoppen + en – van de productpagina, het snelle overzicht, de productlijsten (Hummingbird) en de winkelwagen springen van de ene toegestane hoeveelheid naar de volgende.
- Voorwaarden op de productpagina, badge in lijsten, voorwaarden onder winkelwagenregels, voortgangsbalk: elke weergave kan worden uitgeschakeld.
- Klant in meerdere groepen: minimale bestelling van de standaardgroep, de hoogste of de laagste.
- Standaard minimaal aankoopbedrag: beide gelden, of het minimum van de module vervangt het standaardminimum voor klanten die er een hebben.
- Bestellingen via webservice en back-office: webservicebestellingen worden standaard gecontroleerd en met een duidelijke fout geweigerd; back-officebestellingen standaard niet, voor telefonische bestellingen en uitzonderingen.
- Aanpassingen en blokkeringen meten: alleen het winkelwagen-ID wordt bewaard, gegevens worden na 90 dagen verwijderd.
- Regels behouden bij het verwijderen.
Hoeveelheidsregels
Open Catalogus > Minimums en veelvouden. De lijst toont doel, klantgroep, voorwaarden, periode en prioriteit van elke regel. Regels kunnen worden gedupliceerd en in bulk in- of uitgeschakeld.

Een regel aanmaken
- Geldt voor: een product (zoeken op naam, referentie, EAN of ID, daarna eventueel één combinatie), een categorie (met of zonder subcategorieën), een merk of alle producten.
- Telwijze: elk product en elke combinatie afzonderlijk; elk product met de combinaties opgeteld (maten en kleuren gemengd); of alle beoogde producten samen (gemengd).
- Klantgroep: alle groepen of één groep. Niet-ingelogde bezoekers horen bij de groep Bezoeker, gastbestellingen bij de groep Gast.
- Minimum, veelvoud, maximum: het minimum wordt naar boven afgerond op het veelvoud (5 per 6 geeft 6). Het maximum moet een veelvoud zijn en minstens de kleinste toegestane hoeveelheid: anders weigert het formulier het en stelt twee waarden voor.
- Naam van de verpakking, per taal: „doos” geeft „Verkocht per doos van 6”.
- Prioriteit en optionele periode (vanaf / tot).
Het blok Wat klanten zien toont de meldingen en de badge tijdens het invullen, met de waarschuwingen.

Welke regel geldt
Voor elke productregel in de winkelwagen geldt één regel. Die wordt in deze volgorde gekozen:
- de hoogste prioriteit;
- het meest specifieke doel: combinatie, product, categorie (de diepste eerst), merk, hele catalogus;
- een regel voor een groep van de klant vóór een regel voor alle groepen;
- de nieuwste regel.
Gemengde regels worden daarnaast gecontroleerd: ze tellen alle producten van een categorie, een merk of de hele bestelling op. De standaard minimale hoeveelheid van de productpagina blijft behouden: als die hoger is, verhoogt ze het minimum van de regel, afgerond op het veelvoud.
De Simulator beantwoordt de vraag voor een product, een combinatie, een klantgroep of een klant (e-mail) en een hoeveelheid: hij toont elke kandidaat-regel, de toegepaste, waarom de andere niet gelden, de geldende voorwaarden, het oordeel voor de hoeveelheid, de voorraad en de minimale bestelling.

Het tabblad Modules van de productpagina toont de geldende voorwaarden per klantgroep, de regels van het product en de overgenomen regels.

Minimale bestellingen per groep
Open Catalogus > Minimale bestelling. Eén minimum per groep, plus een optioneel standaardminimum voor alle klanten zonder eigen minimum. Elk minimum kiest zijn basis: incl. of excl. btw, vóór of na waardebonnen, met of zonder de in de winkelwagen geschatte verzendkosten. Bedragen worden in de standaardvaluta ingevoerd en tegen de actuele wisselkoers omgerekend.

Wat de klant ziet
De productpagina toont de aankoopvoorwaarden, de toegestane hoeveelheden en het aantal verpakkingen. De hoeveelheidskeuze begint op een toegestane hoeveelheid en springt per veelvoud.

Als de voorraad onder het minimum ligt en bestellingen zonder voorraad niet zijn toegestaan, ziet de klant waarom en is de knop voor de winkelwagen uitgeschakeld.

Productlijsten tonen een badge („Per 6 verkocht”, „Min. 4”). Met Hummingbird volgt ook de hoeveelheidskeuze van de miniaturen de regel.

In de winkelwagen herhaalt elke regel haar voorwaarde. Een niet toegestane hoeveelheid wordt uitgelegd, met knoppen naar de dichtstbijzijnde toegestane hoeveelheden, en de bestelknop is uitgeschakeld met de reden.

Een voortgangsbalk toont het bedrag dat nog ontbreekt tot de minimale bestelling van de klant, op computer en mobiel.


Als een hoeveelheid automatisch wordt aangepast, krijgt de klant één keer een melding in het winkelwagenoverzicht.

Controles op de server
- Toevoegen aan winkelwagen en hoeveelheidswijzigingen, via AJAX of directe URL: aangepast of geweigerd volgens de instelling.
- Bestelpagina: een winkelwagen die een regel overtreedt, wordt met de redenen teruggestuurd naar de winkelwagen.
- Directe toegang tot een betaalmodule (bijvoorbeeld de bevestigingspagina van de overschrijving): doorverwijzing naar de winkelwagen, er wordt geen bestelling aangemaakt.
- Aanmaken van de bestelling: laatste controle vóór het opslaan, ongeacht het toegangspunt. Meldingen van een betaalprovider zonder de sessie van de klant worden nooit geblokkeerd, omdat de klant misschien al betaald heeft: ze worden vastgelegd.
- Webservice en back-office: volgens de instellingen.
Ook het standaard minimale aankoopbedrag van PrestaShop wordt bij het aanmaken van de bestelling afgedwongen, terwijl PrestaShop het zelf alleen op de bestelpagina controleert.
CSV-import en -export
Open Importeren / exporteren. Het bestandstype wordt herkend aan de kopregel: hoeveelheidsregels (kolom scope) of minimale bestellingen (kolom amount). Alleen controleren is standaard aangevinkt: het rapport toont elke regel als OK of met fout en er wordt niets opgeslagen. De bestaande regels worden alleen vervangen als alle regels geldig zijn, in één transactie. Exports neutraliseren spreadsheetformules en kunnen ongewijzigd opnieuw worden geïmporteerd.

Kolommen van de hoeveelheidsregels: name, scope (product, category, manufacturer, all), product_id of product_reference, combination_reference, category_id, include_subcategories, manufacturer_id, apply_mode (per_product, product_total, cumulative), group_id, min_qty, multiple, max_qty, priority, active, date_from, date_to, pack_label_xx. Kolommen van de minimale bestellingen: group_id, amount, tax_incl, after_discounts, include_shipping, active. Bestanden van versie 1.0.0 worden geaccepteerd.
Problemen oplossen
Het minimum is hoger dan dat van de regel
De standaard minimale hoeveelheid van de productpagina is hoger: die wint, afgerond op het veelvoud. De simulator en de consistentiecontroles tonen dit.
De klant kan het minimum niet bereiken
De voorraad ligt onder het minimum en bestellingen zonder voorraad zijn niet toegestaan. Vul de voorraad aan, sta bestellingen zonder voorraad toe of verlaag het minimum.
De winkelwagen is geblokkeerd door de melding van het standaardminimum
Dat is het minimale aankoopbedrag van Winkelparameters > Bestelinstellingen. Zet het op 0 of kies „vervangen” in de instellingen.
De knoppen +/- springen per 1
Het thema gebruikt niet de standaardselectors. De regel blijft op de server gelden: de hoeveelheid wordt aangepast of geweigerd en de bestelling geblokkeerd.
Compatibiliteit
- PrestaShop 1.7.8, 8.x en 9.x, dezelfde ZIP (getest met PHP 7.4, 8.1 en 8.5).
- Thema’s Classic en Hummingbird.
- Multistore: regels en minimums worden per winkel opgeslagen.
- Meerdere valuta: bedragen omgerekend tegen de actuele wisselkoers.
- Interface in het Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.