Bezorgdatum en tijdvak voor PrestaShop: documentatie van de module

Deze module voegt aan de checkout van PrestaShop 8 en 9 een verplichte keuze van bezorgdatum en tijdvak toe, begrensd door de werkelijke capaciteit van je atelier, met bezorgzones per weekdag, een wenskaartje, afhalen in de winkel en bezorgtoeslagen. Technische naam: dfflorist.

Installatie

1. Klik in Modules > Modulebeheer op Module uploaden en sleep het ZIP-bestand erin.
2. Bij de installatie maakt de module zijn tabellen aan, twee voorbeeldtijdvakken (Ochtend 09:00-12:00 en Middag 14:00-18:00), vier geïllustreerde kaartontwerpen en een verborgen product Toeslag bezorging (referentie DFFLO-SURCHARGE).
3. Er verschijnt een nieuw tabblad Bestellingen > Bloemistbezorgingen. De navigatiebalk van de module leidt naar planning, zones, tijdvakken, sluitingen, kaartjes, atelierbelasting en instellingen.

Algemene instellingen

Toepassingsgebied

• Betrokken producten: alle producten of alleen die uit de aangevinkte categorieën (snijbloemen, planten, verse producten).
• Betrokken vervoerders: laat alles leeg om de planning op alle vervoerders toe te passen. Met een selectie vragen de andere vervoerders (droogbloemen per pakket, bijvoorbeeld) geen datum.
• Vervoerders voor afhalen in de winkel: zie verderop.
• Alleen binnen de zones bezorgen: zodra er een zone actief is, kan een postcode buiten alle zones niet bestellen met een betrokken vervoerder.
• Badge op de productpagina en accentkleur van het checkoutblok.

Bezorgdatum en doorlooptijden

• Bezorgdatum verplicht en bezorgtijd verplicht (alleen als er tijdvakken zijn voor de gekozen dag).
• Bezorging op dezelfde dag en het uiterste tijdstip daarvoor (HH:MM, tijdzone van de winkel).
• Dagelijks uiterste besteltijdstip (optioneel): bestellingen na dit tijdstip tellen vanaf de volgende dag. Voorbeeld: 16:00 met een doorlooptijd van een dag, een bestelling op maandag om 17:00 kan niet op dinsdag worden bezorgd.
• Minimale doorlooptijd in dagen, voorbereidingstijd vóór een tijdvak voor bestellingen op dezelfde dag, boekingsperiode in dagen.

Ateliercapaciteit

• Bezorgdagen van het atelier en capaciteit per weekdag in eenheden (0 = geen daglimiet).
• Standaardbelasting per product: eenheden per artikel. Stel een andere belasting per product in onder Atelierbelasting.
• Vasthouden tijdens de checkout (standaard 20 minuten): winkelwagens met een gekozen tijdvak houden het zo lang vast.
• Waarschuwing bij weinig plaatsen en bestelstatussen die capaciteit vrijgeven (standaard geannuleerd, betaalfout, terugbetaald).

Wenskaartje en ontvanger

Schakel het kaartje in, maak het bericht zo nodig verplicht, stel de maximale lengte in en bied ondertekening en een anoniem kaartje aan. De telefoon van de ontvanger kan verborgen, optioneel of verplicht zijn.

Bezorgzones

Een zone bundelt postcodes en de dagen waarop ze wordt bezorgd. Toegestane patronen, één per regel of gescheiden door komma’s:

• exacte code: 3511
• prefix: 35*
• bereik: 3511..3584

Het land is optioneel. De extra doorlooptijd wordt voor verre zones opgeteld bij de minimale doorlooptijd en schakelt daar bezorging op dezelfde dag uit. Als meerdere zones passen, geldt de eerste actieve zone uit de lijst.

Tijdvakken

Elk tijdvak heeft een vertaalbaar label, een begin- en eindtijd, weekdagen, een capaciteit in eenheden (0 = alleen de dagcapaciteit geldt), een optionele toeslag incl. btw en zo nodig een beperking tot bepaalde zones. Zonder actief tijdvak kiest de klant alleen een datum.

Sluitingen en piekdagen

• Gesloten: de datum is geblokkeerd (vakantie, inventaris).
• Piekdag of uitzonderlijke opening: de dagcapaciteit wordt vervangen door de jouwe (0 = onbeperkt) en de dag gaat open, ook als hij normaal gesloten is. Zijn er voor die weekdag geen tijdvakken, dan worden alle actieve tijdvakken aangeboden.

Wenskaartjes

Elk ontwerp heeft een naam, een voorgestelde tekst die het bericht invult wanneer de klant het kaartje kiest, en een afbeelding in JPG, PNG of WebP tot 2 MB, aanbevolen verhouding 3:2. De vier meegeleverde ontwerpen (Verjaardag, Liefde, Bedankt, Deelneming) zijn aanpasbaar.

Atelierbelasting per product

Geef per product de eenheden per artikel op (0 voor een vaas of chocolade zonder voorbereiding) en een extra voorbereiding in dagen voor artikelen op bestelling. Zit zo’n product in de winkelwagen, dan wordt de doorlooptijd langer en vervalt bezorging op dezelfde dag.

Wat de klant ziet in de checkout

In de stap Verzending staat het blok onder de lijst met vervoerders, boven de knop Doorgaan. De klant kiest een dag in de kalender (de meter toont de belasting, een „+” geeft een toeslag aan) en daarna een tijdvak met de laatste plaatsen en de toeslag. Vervolgens kiest hij een kaartontwerp, schrijft bericht en ondertekening en ziet het voorbeeld meteen bijwerken. De keuze wordt automatisch opgeslagen.

De knop Doorgaan blijft geblokkeerd zolang verplichte gegevens ontbreken, en de server controleert alles opnieuw bij het bevestigen van de stap.

Afhalen in de winkel

Vink je Click & collect-vervoerders aan bij Vervoerders voor afhalen in de winkel. Voor hen wordt het blok Afhaaldatum: geen zone, geen telefoon van de ontvanger, geen toeslag. Tijdvakken die beperkt zijn tot zones worden niet aangeboden. Wisselt de klant van vervoerder, dan laadt het blok opnieuw en wordt de toeslag toegevoegd aan of verwijderd uit de winkelwagen.

Bezorgtoeslagen

Drie bronnen worden opgeteld, allemaal incl. btw in de standaardvaluta:

• de toeslag van het gekozen tijdvak (expres, vast tijdstip);
• de toeslag van de weekdag (bijvoorbeeld zondag);
• de toeslag voor dezelfde dag.

Het totaal komt als regel Toeslag bezorging in de winkelwagen, met de belastingregel van het verborgen product. Het staat in het overzicht, de bestelling en de factuur. De toeslag wordt automatisch verwijderd als de klant kiest voor afhalen of als de winkelwagen geen betrokken product meer bevat.

Planning en afdrukken

De pagina Planning toont een strook van 14 dagen met hun bezetting, de belasting van de gekozen dag per tijdvak, de eenheden die door lopende winkelwagens worden vastgehouden en de lijst met bezorgingen (tijd, zone of vermelding Afhalen in de winkel, ontvanger, adres, artikelen, kaartje). Drie acties:

• Wenskaartjes afdrukken: kaartjes op A6, vier per A4-vel met snijlijnen, daarna gemarkeerd als Afgedrukt;
• Bezorglijst: ronde per tijdvak, afhalingen in een aparte sectie;
• CSV exporteren: puntkomma als scheidingsteken, Excel-compatibel.

Bestellingen, e-mails en pdf

• De bestellijst in de back-office krijgt een sorteerbare kolom Bezorgdatum met een datumbereikfilter.
• De bestelpagina toont een paneel met datum, tijdvak, zone, toeslag en kaartje, die je daar kunt wijzigen (zonder capaciteitscontrole).
• In de standaard e-mails wordt de datum toegevoegd na de naam van de vervoerder, in de taal van de bestelling. Variabelen voor je sjablonen: {dfflo_delivery_date}, {dfflo_delivery_slot}, {dfflo_card_message}.
• De pdf-factuur toont de datum en de telefoon van de ontvanger, de pakbon ook het bericht.

Update vanaf 1.0.0

Upload de ZIP 1.1.0 over de bestaande versie in Modulebeheer. Het updatescript voegt de nieuwe kolommen en instellingen toe, maakt het product Toeslag bezorging aan en koppelt de afbeeldingen aan de voorbeeldkaartjes. Zones, tijdvakken en bestellingen blijven behouden.

Veelgestelde vragen

Het blok verschijnt niet in de checkout

Controleer of de module is ingeschakeld in de instellingen, of de winkelwagen een betrokken product bevat en of de gekozen vervoerder betrokken is of als afhalen is ingesteld.

Er wordt geen datum aangeboden

Controleer de bezorgdagen van het atelier, de bezorgdagen van de zone van de klant, de minimale doorlooptijd en de boekingsperiode. Een product met extra voorbereiding schuift ook de eerste datum op.

Wat gebeurt er bij het verwijderen?

Zones, tijdvakken, kaartjes en de datums bij bestellingen worden verwijderd, samen met het product Toeslag bezorging. Toeslagregels die al gefactureerd zijn, blijven op de bestellingen staan.