Houdbaarheid en batchbeheer: documentatie
TGT- en THT-batches, leveranciersdozen, kosten, FEFO, kortingsschijven, CSV-import en voorraadcontrole.
Overzicht
De module Partijen en houdbaarheidsdata (uiterste consumptiedatum / datum van minimale houdbaarheid) (dfdlc) beheert uw producten per partij: nummer, datumtype, datum, hoeveelheid, inkoopprijs en leverancier. Elke bestelregel neemt zijn eenheden uit de partij die het eerst vervalt (FEFO), partijen met een verstreken uiterste consumptiedatum gaan uit de verkoop, en u ziet op elk moment wie welke partij heeft ontvangen.
Nieuw in 2.0.0: compatibiliteit met PrestaShop 1.7.8, automatische afboeking bij een verstreken uiterste consumptiedatum zonder op de cron te wachten, FEFO per bestelregel (terugbetalingen, retouren, wijzigingen, pakketten), snelle ontvangst met GS1-128-scanner, traceerbaarheid en terugroeping van partijen, dashboard, voorraadcontrole met afstemming, kortingen ‘alle eenheden met korte houdbaarheid’, multistore met gedeelde voorraad, wettelijke datumbenamingen, 8 talen, REST-API (JSON).
Compatibiliteit
- PrestaShop 1.7.8 tot 9.x (getest op 1.7.8.11, 8.2.1 en 9.1.5; PHP 7.4, 8.1 en 8.5)
- Thema’s Classic en Hummingbird
- Multistore, met of zonder gedeelde voorraad tussen de winkels
- Niet ondersteund: het geavanceerde voorraadbeheer van PrestaShop 1.7 (magazijnen)
Installatie en update
- Klik in Modules > Modulebeheer op Upload een module en sleep het bestand
dfdlc-2.0.0.ziperin. - Het menu Verkopen > Partijen & data verschijnt: Dashboard, Partijen, Snelle ontvangst, Traceerbaarheid & terugroeping, Leveranciersverpakkingen. De instellingen zijn bereikbaar via hetzelfde menu.
Update vanaf 1.x: upload de zip 2.0.0 over de oude module heen. Partijen, bewegingen, kosten, verpakkingen en instellingen blijven behouden; de oude tabbladen in het menu Catalogus verhuizen naar het nieuwe menu. Eenheden van partijen met een verstreken uiterste consumptiedatum die onder 1.x op voorraad zijn gebleven, worden bij het eerste bezoek uit de verkoop gehaald. Gewijzigde instellingen van 1.x worden overgenomen: verkoop na de datum van minimale houdbaarheid ingeschakeld, kortingsmodus ‘zodra de volgende partij een korte houdbaarheid heeft’.
Uiterste consumptiedatum en datum van minimale houdbaarheid: wat de module doet
- Uiterste consumptiedatum (‘te gebruiken tot’): de dag na de datum worden de eenheden van de partij afgeboekt uit de partij en de PrestaShop-voorraad. De afboeking gebeurt bij het eerste bezoek van de dag: toevoegen aan de winkelwagen (voordat PrestaShop de voorraad controleert), bevestiging van een bestelling, winkelpagina, back-office of cron. Ze hangt dus niet af van de cron.
- Datum van minimale houdbaarheid (‘ten minste houdbaar tot’): instelling Partijen met een datum van minimale houdbaarheid (THT) na hun datum blijven verkopen. Uitgeschakeld worden deze partijen afgeboekt zoals bij een uiterste consumptiedatum; ingeschakeld blijven ze in de verkoop en vermeldt de productpagina dat de datum verstreken is.
- Een eenheid die wordt teruggezet in een partij die al verlopen is (annulering, retour), wordt meteen opnieuw afgeboekt. Een partij met een verstreken uiterste consumptiedatum kan niet worden aangemaakt.
De module past de regels toe die u instelt. De datum van eenheden in de PrestaShop-voorraad die bij geen enkele partij horen, kent ze niet: het dashboard en de voorraadcontrole melden ze. Het naleven van de regelgeving blijft uw verantwoordelijkheid.
Dashboard
Het dashboard bundelt de eenheden die hun datum binnen 2 dagen en binnen de meldingsperiode bereiken, de inkoopwaarde van de voorraad in partijen, de afgeboekte eenheden over 30 dagen (berekend op basis van de bewegingen), de actieve kortingen, een vervalplanning over 8 weken en de laatste bewegingen. De aandachtspunten (achterstallige cron, voorraadverschillen, bestellingen die op een partij wachten) staan bovenaan met een link naar het betreffende scherm.


Een levering ontvangen
Snelle ontvangst met de scanner
Open Snelle ontvangst en scan het etiket van de doos, of typ een EAN of referentie en druk op Enter.
- GS1-128- of DataMatrix-code: de module leest de GTIN (01 of 02), het partijnummer (10), de vervaldatum (17) of de datum van minimale houdbaarheid (15) en het aantal eenheden (37). De FNC1-scheidingstekens kunnen worden doorgegeven als GS-teken,
~,|of^, of de code kan worden ingevoerd in de vorm(01)…(17)…(10)…. - De GTIN-14 van een doos die in de leveranciersverpakkingen is aangemaakt, selecteert die verpakking: de hoeveelheid wordt in dozen ingevoerd en omgerekend naar eenheden.
- Kies de combinatie als het product combinaties heeft en controleer de gegevens; Ctrl+Enter slaat op. Esc begint opnieuw.
- Deze eenheden aan de PrestaShop-voorraad toevoegen: ja voor een nieuwe levering, nee voor voorraad die al geteld is.
- Opgeslagen partijen komen in de lijst van de sessie; Ongedaan maken verwijdert ze zolang er geen beweging op is geweest.


Bestellingen die zonder voorraad zijn geplaatst, krijgen automatisch eenheden toegewezen uit de partij die u net hebt ontvangen.
Volledig formulier en verpakkingen
De knop Partij toevoegen in de lijst van partijen opent het volledige formulier (ontvangst per eenheid of in dozen, leverancier, ontvangstdatum, notitie). Leg in Leveranciersverpakkingen één keer per product de doos vast: referentie en EAN, eenheden per doos, gebruikelijke kostprijs. 3 dozen van 12 stuks à € 30 geven 36 eenheden à € 2,50.

Partijen importeren via CSV
De knop Importeren (CSV) accepteert een bestand met puntkomma, komma of tab als scheidingsteken (maximaal 5 MB en 5.000 regels). Laat Alleen controleren aangevinkt voor een eerste ronde: elke regel wordt gecontroleerd, er wordt niets opgeslagen. Kolommen: reference, ean13, combination_reference, combination_ean13 of id_product + id_product_attribute; lot_number en expiry_date (JJJJ-MM-DD of DD/MM/JJJJ) verplicht; date_type (dlc = uiterste consumptiedatum of ddm = datum van minimale houdbaarheid); quantity en unit_cost, of boxes, box_reference en box_cost; supplier_ref en note. Er is een voorbeeldbestand om te downloaden.
Partijen en bewegingen
De lijst van partijen kan met één klik worden gefilterd: in verkoop, binnen de meldingsperiode, datum van minimale houdbaarheid verstreken en in verkoop, met korting, afgeboekt, uitverkocht. De detailpagina van een partij toont de volledige geschiedenis (ontvangst, bestellingen, retouren, afboekingen, afstemmingen, met de medewerker) en biedt de actie Eenheden afboeken: verlies, beschadiging, donatie of terugroeping. Afgeboekte eenheden verlaten de partij en de PrestaShop-voorraad.


Het product van een partij kan na het aanmaken niet meer worden gewijzigd. Een partij waaruit al is verkocht, kan niet worden verwijderd: deactiveer haar. Bij een product met combinaties hoort elke partij bij één combinatie.
Bestellingen: first expired, first out
Bij de bevestiging van een bestelling neemt elke regel zijn eenheden uit de verkoopbare partijen van de bestelde combinatie, van de vroegste tot de laatste datum. Pakketten boeken hun onderdelen af volgens het voorraadtype van het pakket. De gewogen gemiddelde kostprijs van de verbruikte partijen wordt op de regel vastgelegd (optie De kostprijs van de partij op elke bestelregel vastleggen).
Daarna volgt de module wat PrestaShop met de voorraad doet:
- annulering of betalingsfout: de eenheden gaan terug naar hun partijen; heractivering: ze worden opnieuw genomen;
- gedeeltelijke terugbetaling of retour met terugboeking naar de voorraad: de eenheden gaan terug naar de partij van de regel met de vroegste datum; zonder terugboeking naar de voorraad veranderen de partijen niet;
- toevoegen, verwijderen of aantal wijzigen in een bestelling: het verschil wordt genomen of teruggegeven;
- regels die naar een andere bestelling van dezelfde winkelwagen worden verplaatst (modules voor het splitsen van bestellingen of voor marktplaatsen): ze behouden hun partijen.
De berekening is idempotent: dezelfde gebeurtenis die twee keer wordt verwerkt, boekt nooit twee keer terug. Twee bestellingen die op hetzelfde moment worden geplaatst, nemen nooit dezelfde eenheid.
Op de bestelpagina toont het blok Te picken partijen de partij van elke regel en de eenheden die nog geen partij hebben. De pakbon drukt de partijen af in de taal van de bestelling (net als de factuur als de optie is ingeschakeld).


Als er geen geldige partij beschikbaar is (bestelling zonder voorraad, partij uitverkocht of verlopen), wachten de eenheden ‘op een partij’ en krijgen ze bij de volgende ontvangst een partij toegewezen. Het scherm Bestellingen die op eenheden wachten en het dashboard tonen ze.
Voorraadcontrole
De voorraadcontrole vergelijkt de verkoopbare eenheden van de partijen met de beschikbare voorraad van PrestaShop, per winkel of per groep winkels die hun voorraad delen.
- Meer in partijen: er heeft een verkoop of voorraadwijziging buiten een bestelling plaatsgevonden (kassa, marktplaats, leveranciersfeed, handmatige correctie). Partijen afstemmen boekt het verschil af, te beginnen bij de vroegste datum. De instelling Partijen automatisch afstemmen op de voorraad doet dat elke nacht.
- Eenheden zonder partij: er is voorraad zonder partij; Een partij registreren opent de vooraf ingevulde snelle ontvangst.

Traceerbaarheid en terugroeping van partijen
Zoek in Traceerbaarheid & terugroeping op een partijnummer, een leveranciersreferentie of een product, vink de betrokken partijen aan en klik op Geselecteerde partijen traceren: ontvangen, nog op voorraad liggende, verkochte en niet-verzonden eenheden, betrokken bestellingen en klanten, herkomst van de partij (leverancier, referentie, ontvangstdatum).


- Contactgegevens worden op het scherm gemaskeerd.
- Exporteren (CSV) is voorbehouden aan medewerkers met bewerkingsrechten op dit scherm: u moet een reden opgeven en de noodzaak bevestigen. De export bevat de bestelling, de eenheden, de naam, het e-mailadres, de postcode en het land, en het telefoonnummer alleen als u daarom vraagt. Elke export wordt met uw naam in het logboek vastgelegd.
- Uit de verkoop halen boekt alle resterende eenheden van de geselecteerde partijen af uit de voorraad.
De module neemt nooit contact op met uw klanten. Ze geeft u de informatie; de procedure voor het uit de handel nemen of terugroepen blijft uw verantwoordelijkheid.
Kortingen bij korte houdbaarheid
Schakel in de instellingen Automatische kortingen toepassen in en stel staffels in: bijvoorbeeld 20% wanneer de datum over 7 dagen is, 40% bij 3 dagen. De simulator toont de prijs op elke dag vóór de datum, en de tabel eronder wat uw huidige partijen zouden krijgen.

- Alleen wanneer alle eenheden op voorraad een korte houdbaarheid hebben (aanbevolen): een vers product wordt nooit tegen de verlaagde prijs verkocht.
- Zodra de volgende te verzenden partij een korte houdbaarheid heeft: het hele product krijgt korting tot die partij is uitverkocht (gedrag van 1.x).
- De korting is een specifieke PrestaShop-prijs, één per winkel, die eindigt op de datum van de partij en verdwijnt zodra de partij is verkocht of afgeboekt. De DataFirefly-module voor het opschonen van specifieke prijzen verwijdert deze prijzen niet.
- Als andere kortingsmodules actief zijn (staffelaanbiedingen, abonnementen, pakketten…), meldt een kader dat: een winkelwagenregel komt bovenop de prijs met korting, een andere specifieke prijs kan die vervangen.

Aankondigingen van prijsverlagingen zijn wettelijk geregeld (in Frankrijk bijvoorbeeld door artikel L112-1-1 van de Franse Code de la consommation: de referentieprijs is de laagste prijs van de afgelopen 30 dagen, behalve voor bederfelijke producten die snel kunnen bederven). Controleer de regels die voor uw activiteit gelden.
In de winkel
De productpagina toont voor de gekozen combinatie de datum van de partij die het eerst wordt verzonden (‘Te gebruiken tot’ of ‘Ten minste houdbaar tot’), een badge ‘Korte houdbaarheid’ en de korting, en de datum van de volgende partij als een bestelling beide kan bevatten. Een verstreken datum van minimale houdbaarheid die nog in de verkoop is, wordt duidelijk vermeld. In lijsten geeft een badge een korte houdbaarheid aan, met één enkele query per pagina.



Productpagina in de back-office
Het tabblad Modules van de productpagina (PrestaShop 8 en 9) toont de partijen van het product, hun status, kostprijs en korting, en de vergelijking met de PrestaShop-voorraad.

Instellingen
- Data en verkoop: verkoop na de datum van minimale houdbaarheid; product deactiveren wanneer de laatste verkoopbare partij wordt afgeboekt.
- Weergave in de winkel: datum op de productpagina, datum van de volgende partij, badge in lijsten, drempel voor korte houdbaarheid.
- Kortingen bij korte houdbaarheid: zie hierboven.
- Voorraad, bestellingen en documenten: standaard toevoegen aan de voorraad bij ontvangst, kostprijs van de partij op de bestelregels, partijen op pakbonnen en facturen, automatisch afstemmen, bestellingen van bepaalde modules uitgesloten van de partijen.
- Meldingen: meldingsperiode in dagen en ontvanger van de e-mail.
Cronjob en meldingen
Roep het adres dat in de instellingen wordt getoond één keer per dag aan (bijvoorbeeld om 00:15). Het boekt partijen met een verstreken datum af, werkt de kortingen bij, wijst eenheden toe aan wachtende bestellingen, stemt de partijen af als de optie is ingeschakeld en verstuurt de meldingsmail (één keer per partij, per winkel, in de taal van de winkel). De knop Nieuw token genereren maakt het oude adres onbruikbaar.

REST-API
Met de API kan een ERP, een scanner-app of magazijnsoftware partijen lezen en ontvangsten, afboekingen en afstemmingen vastleggen, met dezelfde regels als de back-office: voorraad, mutaties, vroegste datum eerst, partijen met een uiterste consumptiedatum nooit verkocht na hun datum.
- Open in de navigatiebalk van de module REST-API (naast Instellingen).
- Geef de sleutel een naam (bijvoorbeeld de tool die hem gebruikt), kies de winkel en de toestemmingen en klik op Sleutel aanmaken.
- Kopieer de sleutel: hij wordt maar één keer getoond; alleen een vingerafdruk wordt bewaard.
Stuur de sleutel in de header Authorization: Bearer …, nooit in het adres. Basisadres: https://uw-winkel/module/dfdlc/api.
GET /lots,GET /lots/{id},GET /lots/{id}/movements,GET /expiring,GET /stock-check,GET /orders/{id}/lots,GET /lookup?gs1=…: toestemming Gegevens lezen.POST /lots: ontvangst (product, partijnummer, datum, eenheden of dozen, of een GS1-128-code); toestemming Partijen ontvangen.POST /lots/{id}/withdraw: eenheden afboeken (verlies, breuk, schenking, terugroeping, verlopen); toestemming Eenheden afboeken.POST /stock-check/align: stemt de partijen van een product af op de PrestaShop-voorraad; toestemming Partijen afstemmen op voorraad.GET /lots/{id}/recall: bestellingen die de partij ontvingen; klantgegevens vereisen de toestemming Terugroeping: klantgegevens en een doel, dat in het logboek wordt vastgelegd.
Een sleutel geldt voor één winkel en geeft nooit meer rechten dan de medewerker die hem aanmaakt. Trek hem in zodra een tool hem niet meer nodig heeft; hij werkt ook niet meer als die medewerker wordt gedeactiveerd. Limiet: 120 aanroepen per minuut per sleutel. Elke schrijfactie wordt met het sleutelnummer vastgelegd in het logboek van de pagina Traceerbaarheid & terugroeping.

Rechten van medewerkers en beveiliging
- Elk scherm respecteert de PrestaShop-rechten (bekijken, toevoegen, bewerken, verwijderen); een medewerker met alleen leesrechten ziet alles zonder iets te kunnen wijzigen.
- Acties die gegevens wijzigen, accepteren alleen POST-verzoeken met het token van de back-office.
- In multistore ziet en wijzigt een medewerker alleen de partijen van de geselecteerde winkels.
- Partijnummers worden gecontroleerd (letters, cijfers en
. _ - / # ( ) +); CSV-exports neutraliseren formules. - De cron controleert zijn token in constante tijd en wordt nooit twee keer tegelijk uitgevoerd.
Compatibiliteit met andere modules
- Kassaverkopen, marktplaatsen, leveranciersfeeds: verschillen worden door de voorraadcontrole gedetecteerd; u kunt de bestellingen van een module in de instellingen uitsluiten.
- Modules die zelf onderdelen afboeken buiten de bestelregels (sommige boxen of pakketten ‘op één regel’): hun onderdelen worden niet uit de partijen genomen; de voorraadcontrole meldt het verschil.
Veelgestelde vragen
Is een cronjob nodig?
Het afboeken bij een verstreken uiterste consumptiedatum, FEFO, traceerbaarheid en import werken zonder cron. De cron verstuurt de meldingen, werkt de kortingen bij en wijst eenheden toe aan wachtende bestellingen.
Vervangt de module de PrestaShop-voorraad?
Nee. De PrestaShop-voorraad blijft de referentie voor de verkoop; de module verdeelt hem over partijen met een datum, corrigeert hem wanneer een partij wordt afgeboekt en meldt verschillen.
Wat gebeurt er bij het deïnstalleren?
De tabellen van de module, de instellingen en de kortingen worden verwijderd. Exporteer uw bewegingen vooraf als u ze moet bewaren.