Documentatie van de PrestaShop Voorbestelling module (dfpreorder)

<p>Met de module <strong>DataFirefly Pre-Orders</strong> (dfpreorder) verkoop je producten voordat ze in het magazijn liggen, op PrestaShop 8 en 9. Deze pagina behandelt installatie, instellingen, regels, binnenkomende voorraad en probleemoplossing.</p>

<h2>Installatie</h2>
<ol>
<li>Download de ZIP uit je DataFirefly-klantaccount.</li>
<li>Ga in de back-office naar <em>Modules > Modulebeheer > Een module uploaden</em> en stuur de ZIP.</li>
<li>Bij de installatie maakt de module haar tabellen, haar twee bestelstatussen en twee menu-items aan: <em>Catalogus > Voorbestellingen</em> voor de regels en <em>Bestellingen > Voorbestellingen</em> voor de opvolging.</li>
<li>Open de moduleconfiguratie om de algemene instellingen na te lopen en de cron-URL te kopiëren.</li>
</ol>
<p>De module draait van PrestaShop 8.0 tot 9.x met dezelfde ZIP, in multishop en meertalige opstellingen. De teksten worden geleverd in het Nederlands, Engels, Frans, Spaans, Duits, Italiaans, Pools en Portugees.</p>

<h2>Algemene instellingen</h2>
<ul>
<li><strong>Standaardtekst van de knop</strong> en <strong>tekst van het label</strong>, per taal. Elke regel kan ze overschrijven.</li>
<li><strong>Winkelwagens met voorbestellingen en voorradige artikelen</strong>: toestaan zonder melding, toestaan met de melding dat de bestelling in één keer wordt verzonden, of de combinatie verbieden.</li>
<li><strong>Toestemmingsvinkje bij het afrekenen</strong>: voegt een verplicht vinkje toe zodra de winkelwagen een voorbestelling bevat. De tekst accepteert de plaatshouder <code>%date%</code>, die wordt vervangen door de laatste verwachte verzenddatum van de winkelwagen. De tijdstempel wordt op elke voorbestelregel bewaard.</li>
<li><strong>E-mails</strong> voor bevestiging en beschikbaarheid, afzonderlijk aan te zetten.</li>
<li><strong>Automatische toewijzing</strong> van ontvangen voorraad en de <strong>bestelstatus</strong> die geldt zodra alle regels zijn toegewezen.</li>
<li><strong>Formulier Houd me op de hoogte</strong> bij producten die niet besteld kunnen worden.</li>
<li><strong>Gestructureerde gegevens PreOrder</strong>, standaard uit: zet dit alleen aan als je thema of SEO-module nog geen product-JSON-LD genereert.</li>
</ul>

<h2>Een voorbestelregel maken</h2>
<p>Ga naar <em>Catalogus > Voorbestellingen</em> en daarna naar <em>Regel toevoegen</em>. Een regel geldt voor een product of voor één specifieke combinatie.</p>

<h3>De drie modi</h3>
<ul>
<li><strong>Bij geen voorraad</strong>: voorbestellen start zodra de voorraad nul bereikt en stopt bij aanvulling. Dit is de modus voor leveranciersproblemen.</li>
<li><strong>Geforceerd</strong>: het product blijft voorbestelbaar zolang de regel actief is, ook met voorraad. Dit is de modus voor een productlancering.</li>
<li><strong>Datumvenster</strong>: voorbestellen opent en sluit op de ingestelde datums. Het sluiten gebeurt door de crontaak en, als achtervang, bij elk bezoek aan de productpagina.</li>
</ul>

<h3>De andere velden</h3>
<ul>
<li><strong>Verwachte verzenddatum</strong>: te zien op de productpagina, in de winkelwagen, in het klantaccount, op de factuur en in de e-mails.</li>
<li><strong>Maximaal aantal</strong> en <strong>maximum per klant</strong>: 0 betekent onbeperkt. De limieten worden serverzijde gecontroleerd bij elke opslag van de winkelwagen.</li>
<li><strong>Voorbestelkorting</strong> in procenten of als bedrag: beschikbaar in de modi geforceerd en datumvenster, waar de periode vooraf bekend is. De korting maakt een specifieke prijs aan die verdwijnt zodra de regel eindigt.</li>
<li><strong>Knoptekst</strong> en <strong>bericht</strong> per taal, specifiek voor de regel.</li>
<li><strong>Aftelklok</strong> (tot het sluiten of tot de release) en de <strong>balk met gereserveerde stuks</strong>, waarvoor een maximum nodig is.</li>
</ul>

<h3>Veel regels tegelijk maken</h3>
<p>De knop <em>Bulktoewijzing en CSV-import</em> opent twee formulieren. Het eerste maakt één regel per product dat overeenkomt met een categorie, merk of leverancier, waarbij de criteria optellen. Het tweede importeert een CSV met de kolommen <code>product</code> (ID of referentie), <code>combination</code> (optioneel), <code>mode</code>, <code>release_date</code>, <code>max_qty</code>, <code>max_per_customer</code>, <code>date_start</code>, <code>date_end</code>. Bestaande regels worden bijgewerkt.</p>

<h2>Wat de klant ziet</h2>
<p>Bij een voorbestelproduct krijgt de knop In winkelwagen de gekozen tekst, verschijnt er een label op de afbeeldingen in overzichten en op de productpagina, en toont een kader de verwachte datum, je bericht, de aftelklok en de balk met gereserveerde stuks. Het blok wordt bijgewerkt bij een wissel van combinatie.</p>
<p>In de winkelwagen is elke betrokken regel gemarkeerd met de verwachte datum. Bij het afrekenen herhaalt het toestemmingsvinkje de datum. Na de bestelling volgt de klant zijn voorbestellingen in <em>Mijn account > Mijn voorbestellingen</em> en kan hij annulering aanvragen voor de regels die nog wachten.</p>

<h2>Opvolging en voorraadtoewijzing</h2>
<p><em>Bestellingen > Voorbestellingen</em> bundelt de opvolging.</p>
<h3>Dashboard</h3>
<p>De kengetallen tonen de wachtende stuks, het aantal betrokken bestellingen, de gereserveerde omzet inclusief btw, de al toegewezen stuks en de annuleringsverzoeken. De producttabel toont per product of combinatie de wachtende stuks, de PrestaShop-voorraad, de stuks die nu toegewezen kunnen worden en het aantal dat je bij de leverancier moet bestellen. De CSV-export gebruikt dezelfde kolommen.</p>
<h3>Een levering toewijzen</h3>
<p>Een voorbestelling verlaagt de voorraad al bij het plaatsen van de bestelling, waardoor die onder nul komt. De stuks die fysiek beschikbaar zijn voor voorbestellingen zijn dus: wachtende stuks + huidige voorraad. Na een aanvulling bedient de knop <em>Toewijzen (oudste eerst)</em> de bestellingen op besteldatum, of opent <em>Bestellingen kiezen</em> het toewijzingsscherm met aangevinkte, aanpasbare regels.</p>
<p>Zodra alle voorbestelregels van een bestelling zijn toegewezen, gaat de bestelling naar de ingestelde status (standaard <em>Voorbestelling: klaar voor verzending</em>) en krijgt de klant een e-mail. Daarna maak je de bestelling gewoon klaar.</p>
<div class=”df-callout note”><p>Automatische toewijzing bedient voorbestellingen zonder handmatige bevestiging, maar nooit vóór de aangekondigde datum van een geforceerde regel of een regel met datumvenster.</p></div>

<h2>Een vertraging afhandelen</h2>
<p>Open de regel, wijzig de verwachte verzenddatum en laat de optie <em>Klanten informeren als de datum verandert</em> aan staan. De wachtende voorbestellingen worden bijgewerkt en elke betrokken klant ontvangt een e-mail met de nieuwe datum en een link om annulering aan te vragen. Het aantal geïnformeerde klanten verschijnt na het opslaan, en de geschiedenis van aangekondigde datums staat onder het formulier.</p>
<p>Annuleringsverzoeken komen in het dashboard. <em>Annulering bevestigen</em> maakt de gereserveerde stuks vrij; de terugbetaling doe je nog steeds via de bestelpagina met je betaalmethode. <em>Voorbestelling behouden</em> zet de regels terug op wachtend.</p>

<h2>Crontaak</h2>
<p>De moduleconfiguratie toont een URL met token. Plan die elke 15 minuten in bij je hostingpartij. Hij opent en sluit datumvensters op tijd en bedient, als automatische toewijzing aan staat, de voorbestellingen waarvan de voorraad binnen is.</p>

<h2>Veelgestelde vragen</h2>
<h3>Betaalt de klant het volledige bedrag?</h3>
<p>Ja, in versie 1.0. Een aanbetaling met restbetaling bij beschikbaarheid staat gepland voor versie 1.1.</p>
<h3>Waarom gaat een bestelling naar Voorbestelling: wacht op voorraad?</h3>
<p>De module zet de bestelling in die status zodra ze betaald is en minstens één voorbestelde regel bevat. De status is betaald en niet verzendbaar, zodat een onvolledige bestelling niet in voorbereiding gaat.</p>
<h3>Heeft een regel op één combinatie invloed op de andere?</h3>
<p>PrestaShop regelt de instelling voor bestellen zonder voorraad alleen op productniveau. De module zet die dus op het product en blokkeert vervolgens in de winkel en in de winkelwagen de uitverkochte combinaties zonder regel, zodat het oorspronkelijke gedrag van de winkel behouden blijft.</p>
<h3>De aftelklok verschijnt niet</h3>
<p>Die verschijnt alleen als de einddatum (modus datumvenster) of de verwachte verzenddatum in de toekomst ligt, en als de optie op de regel aan staat.</p>
<h3>De knop behoudt zijn oorspronkelijke tekst</h3>
<p>De module vervangt de tekst van de knop In winkelwagen op standaardthema’s. Neem bij een sterk aangepast thema contact op met de support met de URL van de productpagina: de selector van de knop kan worden aangepast.</p>