Minimale bestelhoeveelheid en verpakkingseenheden: documentatie DataFirefly Minimums

Installatie

Installeer de module via Modules > Modulebeheer > Module uploaden met het ZIP-bestand, of plaats de map dfminimums in de map /modules/ van uw winkel en klik op Installeren.

Bij de installatie maakt de module twee tabellen aan (hoeveelheidsregels en minimum bestelbedragen), registreert ze haar hooks en voegt ze twee tabbladen toe in het menu Catalogus: Minimums en veelvouden en Minimale bestelling.

Module-instellingen

De configuratiepagina van de module bevat zes instellingen.

Aankoopregels inschakelen

Hoofdschakelaar. Uitgeschakeld wordt geen enkele regel getoond of toegepast in de winkel. De regels blijven bewaard.

Hoeveelheden automatisch aanpassen

Als een klant een hoeveelheid toevoegt die een regel overtreedt, vervangt de module die door de dichtstbijzijnde toegestane hoeveelheid: omhoog bij toevoegen, omlaag bij verwijderen. 7 stuks van een product dat per 6 wordt verkocht, wordt 12; van 12 naar 11 wordt 6. Gepersonaliseerde regels worden nooit gewijzigd. Uitgeschakeld blijft de hoeveelheid zoals ze is en is de winkelwagen geblokkeerd tot de klant corrigeert.

Voorwaarden tonen op de productpagina

Toont onder de knop In winkelwagen een kader met het minimum, het veelvoud en het maximum voor de ingelogde klant. Het kader verschijnt ook in de snelle weergave.

Label tonen in productlijsten

Voegt onder de prijs van de productminiaturen een kort label toe, bijvoorbeeld „Per 6 verkocht” of „Min. 12”.

Voorwaarden tonen onder elke winkelwagenregel

Herhaalt de voorwaarde van elke regel en toont de fout in rood als de hoeveelheid niet is toegestaan.

Klant in meerdere groepen

Bepaalt welk minimum bestelbedrag geldt als een klant tot meerdere groepen met elk een eigen minimum behoort: dat van zijn standaardgroep, het hoogste of het laagste.

Een hoeveelheidsregel aanmaken

Open Catalogus > Minimums en veelvouden en klik op Regel toevoegen.

Van toepassing op

• Een product: zoek het product op naam, referentie, EAN of ID en kies eventueel een combinatie. Een regel voor een combinatie gaat voor op een regel voor het hele product.
• Een categorie: kies de categorie en geef aan of subcategorieën meetellen. Alle producten die aan de categorie gekoppeld zijn, vallen eronder, ongeacht hun standaardcategorie.
• Alle producten: de regel geldt voor de hele catalogus.

Klantgroep

Laat „Alle klantgroepen” staan of kies een groep. Een groepsregel geldt voor elke klant die tot die groep behoort, ook als het niet zijn standaardgroep is.

Minimum, veelvoud en maximum

• Minimale hoeveelheid: 0 of 1 betekent geen minimum. Als er een veelvoud is ingesteld en het minimum daar geen veelvoud van is, wordt het naar boven afgerond: minimum 10 per 6 wordt 12.
• Verkocht in veelvouden van: 1 laat de hoeveelheid vrij, 6 accepteert alleen 6, 12, 18 enzovoort.
• Maximale hoeveelheid: 0 betekent geen maximum. Het maximum moet een veelvoud van het gekozen veelvoud zijn en groter dan of gelijk aan het minimum.

Een regel moet minstens een minimum boven 1, een veelvoud boven 1 of een maximum instellen.

Welke regel geldt

Voor elk product in de winkelwagen geldt één productregel. De module kiest die in deze volgorde:

1. de hoogste prioriteit;
2. bij gelijke prioriteit de meest specifieke regel: combinatie, dan product, dan categorie (de diepste eerst), dan alle producten;
3. bij gelijke specificiteit een klantgroepregel vóór een regel voor alle groepen.

Voorbeeld: een regel „Wijnen, per 6 verkocht” voor alle klanten en een regel „Wijnen, per 12 verkocht” voor de groep Zakelijk. Een zakelijke klant bestelt per 12, een particulier per 6.

Het modulepaneel in het tabblad Modules van de productfiche toont de regels die direct op het product gericht zijn en de categorie- of catalogusregels die ook kunnen gelden.

Vrij combineren per categorie

Bij een categorieregel biedt het veld Telwijze twee waarden.

• Elk product afzonderlijk: de regel geldt voor elk product van de categorie, zoals een productregel.
• Alle producten van de categorie samen (vrij combineren): het minimum, het veelvoud en het maximum gelden voor de som van de hoeveelheden van alle producten van de categorie in de winkelwagen.

Voorbeeld: minimum 12 en veelvoud 6 met vrij combineren op de categorie Wijnen. De klant kan 4 rode, 4 witte en 4 rosé wijnen nemen. Met in totaal 13 flessen is de winkelwagen geblokkeerd.

Regels met vrij combineren worden gecontroleerd naast de eigen regel van elk product. Een wijn die per stuk wordt verkocht, blijft per stuk verkrijgbaar, zolang het totaal van de categorie aan de regel voldoet.

Minimum bestelbedragen per groep

Open Catalogus > Minimale bestelling en klik op Minimum bestelbedrag toevoegen.

• Klantgroep: één minimum per groep. De regel „Alle klanten (standaard)” geldt voor klanten van wie de groepen geen eigen minimum hebben.
• Minimumbedrag: ingevoerd in de standaardvaluta van de winkel, automatisch omgerekend voor winkelwagens in een andere valuta. Verzendkosten zijn nooit inbegrepen.
• Bedrag incl. btw: Nee vergelijkt met het producttotaal excl. btw, gebruikelijk in B2B.
• Kortingsbonnen aftrekken: Ja neemt het totaal na winkelwagenregels en kortingsbonnen.

Wat de klant ziet

Als de winkelwagen een regel overtreedt, vult de module de sleutel minimalPurchaseRequired van de winkelwagen, die PrestaShop gebruikt voor zijn eigen minimumbedrag. De bestelknop wordt uitgeschakeld en de native waarschuwing in de winkelwagen toont „Uw winkelwagen voldoet nog niet aan de aankoopvoorwaarden.”, gevolgd door de details van elk probleem: niet toegestane hoeveelheid met de mogelijke hoeveelheden, totaal van een categorie met vrij combineren, ontbrekend bedrag tot het minimum bestelbedrag.

Bij het openen van de bestelpagina wordt opnieuw gecontroleerd: een klant die de pagina rechtstreeks opent, wordt teruggestuurd naar de winkelwagen.

In de winkel volgen de hoeveelheidsvelden de regel. Op het Classic-thema springen de TouchSpin-knoppen met het veelvoud. Op Hummingbird springen de knoppen +/- direct naar de volgende of vorige toegestane hoeveelheid.

CSV-import en -export

De import staat bovenaan de lijst met regels. Het bestand accepteert het scheidingsteken ; of , en heeft een kopregel nodig met minstens de kolom scope. Herkende kolommen:

• name: interne naam, gegenereerd als die leeg is;
• scope: product, category of all;
• product_id of product_reference;
• combination_reference: referentie van de combinatie;
• category_id en include_subcategories (0 of 1);
• apply_mode: per_product of cumulative (vrij combineren);
• group_id: 0 voor alle groepen;
• min_qty, multiple, max_qty, priority, active.

Het vakje „Eerst alle bestaande regels van deze winkel verwijderen” vervangt de volledige set regels. Foute regels worden met hun nummer vermeld en houden de andere niet tegen. De knop CSV exporteren maakt hetzelfde formaat, handig om regels van de ene winkel naar de andere over te zetten. Een voorbeeldbestand is te downloaden vanuit het importblok.

Goede praktijken

• Begin met een brede regel (categorie of catalogus) en voeg daarna uitzonderingen per product toe: de meest specifieke regel wint zonder dat u de prioriteit aanpast.
• Gebruik de prioriteit alleen als een minder specifieke regel moet winnen, bijvoorbeeld een categorieregel die voor al haar producten moet gelden.
• Test met een klantaccount uit elke betrokken groep: groepsregels zijn niet zichtbaar voor een niet-ingelogde bezoeker.
• Leeg na een wijziging de cache als uw winkel een module voor volledige paginacache gebruikt.

Probleemoplossing

De klant kan niet onder een hoeveelheid gaan, hoewel geen regel dat vereist

Controleer de native minimale hoeveelheid op de productfiche (tabblad Voorraad of Hoeveelheden, afhankelijk van de versie) en zet die terug op 1.

De winkelwagen is geblokkeerd met de native melding over het minimumbedrag

Dat is het native minimum uit Winkelinstellingen > Bestellingen. Zet het op 0 als alleen de minima per groep moeten tellen.

De knoppen +/- verspringen per 1

Het thema gebruikt niet de standaardselectors van Classic of Hummingbird. De regel wordt aan serverzijde toch toegepast: de winkelwagen wordt gecorrigeerd of geblokkeerd. Neem contact op met de naam van het thema voor een aanpassing.

Een one page checkout-module laat de bestelling door

De module van derden negeert minimalPurchaseRequired. Test die op een testwinkel en neem contact op met de naam van de module.

Compatibiliteit

• PrestaShop 8.0 tot 9.x, hetzelfde ZIP-bestand voor beide versies.
• Thema’s Classic en Hummingbird.
• Multistore: regels en minima worden per winkel opgeslagen.
• Architectuur ModuleAdminController, zonder Composer-afhankelijkheid, PHP 7.2 en hoger.
• Interface beschikbaar in het Engels, Frans, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees.