# Dokumentation des PrestaShop Vorbestellung Moduls (dfpreorder)

> Das Modul DataFirefly Pre-Orders (dfpreorder) verkauft Produkte, bevor sie im Lager eintreffen, unter PrestaShop 8 und 9. Diese Seite behandelt Installation, Einstellungen, Regeln, Wareneingang und Fehlerbehebung. Installation Laden Sie das…

- Seite: <https://www.datafirefly.com/de/documentation/dfpreorder/>
- Sprache: de
- Aktualisiert am: 2026-10-07
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfpreorder/index.md), [en](https://www.datafirefly.com/en/documentation/dfpreorder/index.md), [es](https://www.datafirefly.com/es/documentation/dfpreorder/index.md), [it](https://www.datafirefly.com/it/documentation/dfpreorder/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfpreorder/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfpreorder/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfpreorder/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

Das Modul **DataFirefly Pre-Orders** (dfpreorder) verkauft Produkte, bevor sie im Lager eintreffen, unter PrestaShop 8 und 9. Diese Seite behandelt Installation, Einstellungen, Regeln, Wareneingang und Fehlerbehebung.

## Installation

1. Laden Sie das ZIP in Ihrem DataFirefly-Kundenkonto herunter.
2. Gehen Sie im Backoffice zu _Module > Modul-Manager > Modul hochladen_ und senden Sie das ZIP.
3. Bei der Installation legt das Modul seine Tabellen, seine drei Bestellstatus und zwei Menüpunkte an: _Katalog > Vorbestellungen_ für die Regeln und _Bestellungen > Vorbestellungen_ für die Nachverfolgung.
4. Öffnen Sie die Modulkonfiguration, prüfen Sie die allgemeinen Einstellungen und kopieren Sie die Cron-URL.

Das Modul läuft von PrestaShop 8.0 bis 9.x mit demselben ZIP, im Multishop und mehrsprachig. Die Texte liegen auf Deutsch, Englisch, Französisch, Spanisch, Italienisch, Niederländisch, Polnisch und Portugiesisch vor.

## Allgemeine Einstellungen

- **Standard-Button-Text** und **Badge-Text**, je Sprache. Jede Regel kann sie überschreiben.
- **Warenkörbe mit Vorbestellungen und Lagerware**: ohne Hinweis erlauben, mit dem Hinweis erlauben, dass die Bestellung in einer Sendung geliefert wird, oder die Mischung verbieten.
- **Zustimmungs-Checkbox im Checkout**: fügt ein Pflichtfeld hinzu, wenn der Warenkorb eine Vorbestellung enthält. Der Text unterstützt den Platzhalter `%date%`, der durch das späteste voraussichtliche Versanddatum des Warenkorbs ersetzt wird. Der Zeitstempel wird an jeder Vorbestellposition gespeichert.
- **E-Mails** für Bestätigung und Verfügbarkeit, einzeln schaltbar.
- **Automatische Zuteilung** des eingegangenen Bestands und der **Bestellstatus**, der gilt, sobald alle Positionen zugeteilt sind.
- **Benachrichtigen-Formular** bei nicht bestellbaren oder ausgebuchten Produkten.
- **Versand gemischter Bestellungen**: eine Sendung, sobald alles verfügbar ist, Teillieferung (Lagerartikel zuerst, eine Bestellung und eine Rechnung) oder Aufteilung in zwei Bestellungen mit gleicher Referenz im Checkout. Bei der Aufteilung legen Sie fest, ob der Kunde im Warenkorb entscheidet oder ob jeder gemischte Warenkorb aufgeteilt wird.
- **E-Mail zur Teillieferung** mit der Liste der versandten Artikel und dem Tracking-Link.
- **Strukturierte Daten PreOrder**, standardmäßig aus: nur aktivieren, wenn Ihr Theme oder SEO-Modul nicht bereits Produkt-JSON-LD ausgibt.

## Eine Vorbestellregel anlegen

Gehen Sie zu _Katalog > Vorbestellungen_ und dann auf _Regel hinzufügen_. Eine Regel gilt für ein Produkt oder für eine bestimmte Variante. Der Modus wird über drei Karten gewählt, und eine Spalte rechts zeigt beim Tippen eine Vorschau des Shop-Blocks sowie die offenen Vorbestellungen der Regel und ihren Terminverlauf.

### Die drei Modi

- **Bei fehlendem Bestand**: Die Vorbestellung startet bei Bestand null und endet mit dem Wareneingang. Das ist der Modus für Lieferengpässe.
- **Erzwungen**: Das Produkt bleibt vorbestellbar, solange die Regel aktiv ist, auch mit Bestand. Das ist der Modus für einen Produktlaunch.
- **Zeitfenster**: Die Vorbestellung öffnet und schließt zu den eingetragenen Terminen. Das Schließen übernimmt die Cron-Aufgabe und ersatzweise jeder Aufruf der Produktseite.

### Die weiteren Felder

- **Voraussichtliches Versanddatum**: erscheint auf der Produktseite, im Warenkorb, im Kundenkonto, auf der Rechnung und in den E-Mails.
- **Höchstmenge** und **Maximum pro Kunde**: 0 bedeutet unbegrenzt. Die Limits werden serverseitig bei jedem Speichern des Warenkorbs geprüft.
- **Vorbestellrabatt** in Prozent oder als Betrag: verfügbar in den Modi erzwungen und Zeitfenster, in denen der Zeitraum vorab bekannt ist. Er erzeugt einen Sonderpreis, der mit dem Ende der Regel entfernt wird.
- **Button-Text** und **Hinweistext** je Sprache, speziell für die Regel.
- **Countdown** (bis zum Ende oder bis zum Launch) und **Balken der reservierten Einheiten**, der eine Höchstmenge voraussetzt.

### Viele Regeln auf einmal

Die Schaltfläche _Massenzuweisung und CSV-Import_ öffnet zwei Formulare. Das erste betrifft alle Produkte einer Kategorie, einer Marke oder eines Lieferanten (die Kriterien addieren sich). Für Produkte mit bestehenden Regeln wählen Sie _Nur das voraussichtliche Versanddatum aktualisieren_ (Standard), _Alle Einstellungen ersetzen_ oder _Unverändert lassen_, und ob Produkte ohne Regel eine erhalten.

Das zweite importiert eine CSV mit den Spalten `product` (ID oder Artikelnummer), `combination` (optional), `mode`, `release_date`, `max_qty`, `max_per_customer`, `date_start`, `date_end`. Bei bestehenden Regeln werden nur vorhandene und ausgefüllte Spalten geändert.

### Den Liefertermin eines Lieferanten verschieben

Wählen Sie in der Massenzuweisung den Lieferanten, geben Sie das neue voraussichtliche Versanddatum ein, behalten Sie _Nur das voraussichtliche Versanddatum aktualisieren_ und _Kunden bei Terminänderung benachrichtigen_ bei und wenden Sie an. Alle Regeln der Produkte des Lieferanten werden verschoben, auch Variantenregeln; Modi, Limits und Zeitfenster bleiben unberührt. Die wartenden Vorbestellungen übernehmen den neuen Termin, die Kunden erhalten die Verzögerungs-E-Mail mit Stornolink und die Änderung steht im Verlauf jeder Regel. Eine CSV nur mit `product` und `release_date` erledigt dasselbe Produkt für Produkt.

## Was der Kunde sieht

Bei einem vorbestellbaren Produkt trägt der Warenkorb-Button den gewählten Text, ein Badge erscheint auf den Bildern in Listen und auf der Produktseite, und ein Kasten zeigt den voraussichtlichen Termin, Ihren Hinweis, den Countdown und den Balken der reservierten Einheiten. Der Block aktualisiert sich beim Wechsel der Variante.

Im Warenkorb ist jede betroffene Position mit dem Termin gekennzeichnet. Im Checkout wiederholt die Zustimmungs-Checkbox den Termin. Nach der Bestellung verfolgt der Kunde seine Vorbestellungen unter _Mein Konto > Meine Vorbestellungen_ und kann für wartende Positionen eine Stornierung beantragen.

## Versand gemischter Bestellungen

Die Einstellung _Versand gemischter Bestellungen_ bestimmt, was passiert, wenn eine Bestellung Lagerartikel und vorbestellte Artikel enthält.

- **Eine Sendung** (Standard): Die ganze Bestellung wartet in _Vorbestellung: wartet auf Bestand_ und geht raus, sobald alles verfügbar ist.
- **Teillieferung**: Die Bestellseite zeigt die Lagerartikel mit einem Feld für die Sendungsnummer und der Schaltfläche _Als teilweise versandt markieren_. Die Bestellung wechselt zu _Vorbestellung: teilweise versandt_, das den Lieferschein erlaubt, und der Kunde erhält die Liste der versandten Artikel, den Tracking-Link und die restlichen Artikel mit ihren Terminen. Das Dashboard listet alle Bestellungen, deren vorrätiger Teil jetzt raus kann. Eine Bestellung, eine Rechnung; das zweite Paket nutzt die native Sendungsnummer von PrestaShop.
- **Aufteilung in zwei Bestellungen**: PrestaShop legt im Checkout eine Bestellung für die Lagerartikel und eine für die Vorbestellungen mit gleicher Referenz an, über den nativen Paketmechanismus (ohne Override). Eine teilweise vorrätige Position wird geteilt. Die Versandkosten fallen je Paket an. Mit der Option Kundenwahl kann der Kunde die Aufteilung per Häkchen im Warenkorb anfordern; andernfalls wird jeder gemischte Warenkorb aufgeteilt.

Testen Sie die Aufteilung mit Ihren Zahlungsmodulen in einer Testumgebung, bevor Sie sie aktivieren. Ein Produkt im Modus Erzwungen mit vorhandenem Bestand gilt für PrestaShop als vorrätig und wird nicht abgetrennt.

### Spalte Vorbestellung in der Bestellliste

Die native Liste _Bestellungen_ erhält eine Spalte _Vorbestellung_ mit Filter: alle Vorbestellungen, wartet auf Bestand, versandbereit, Stornierung beantragt. So finden Sie mit einem Klick die Bestellungen, die auf Bestand warten.

## Nachverfolgung und Zuteilung

_Bestellungen > Vorbestellungen_ bündelt die Nachverfolgung.

### Dashboard

Die Kennzahlen zeigen wartende Einheiten, betroffene Bestellungen, reservierten Umsatz inkl. MwSt., bereits zugeteilte Einheiten und Stornierungsanfragen. Die Produkttabelle nennt je Produkt oder Variante die wartenden Einheiten, den PrestaShop-Bestand, die sofort zuteilbaren Einheiten und die beim Lieferanten zu bestellende Menge. Der CSV-Export nutzt dieselben Spalten.

### Einen Wareneingang zuteilen

Eine Vorbestellung senkt den Bestand bereits bei der Bestellung und drückt ihn unter null. Die physisch für Vorbestellungen verfügbaren Einheiten sind daher: wartende Einheiten + aktueller Bestand. Nach einem Wareneingang bedient die Schaltfläche _Zuteilen (älteste zuerst)_ die Bestellungen nach Bestelldatum, oder _Bestellungen wählen_ öffnet die Zuteilungsmaske mit vorausgewählten, änderbaren Positionen. Die Summe der Auswahl wird live aktualisiert, mit einer Warnung, wenn sie die physisch verfügbaren Einheiten übersteigt.

Sind alle vorbestellten Positionen einer Bestellung zugeteilt, wechselt die Bestellung in den konfigurierten Status (standardmäßig _Vorbestellung: versandbereit_) und der Kunde erhält eine E-Mail. Danach bereiten Sie die Bestellung wie gewohnt vor.

Die automatische Zuteilung bedient Vorbestellungen ohne manuelle Freigabe, aber nie vor dem angekündigten Termin einer erzwungenen Regel oder einer Regel mit Zeitfenster.

## Eine Verzögerung bearbeiten

Öffnen Sie die Regel, ändern Sie das voraussichtliche Versanddatum und lassen Sie _Kunden bei Terminänderung benachrichtigen_ aktiviert. Die wartenden Vorbestellungen werden aktualisiert und jeder betroffene Kunde erhält eine E-Mail mit dem neuen Termin und einem Link zur Stornierungsanfrage. Die Zahl der benachrichtigten Kunden erscheint nach dem Speichern, der Verlauf der angekündigten Termine steht unter dem Formular.

Stornierungsanfragen landen im Dashboard. _Stornierung bestätigen_ gibt die reservierten Einheiten frei; die Erstattung erfolgt weiterhin über die Bestellseite mit Ihrer Zahlungsart. _Vorbestellung behalten_ setzt die Positionen zurück auf wartend.

## Cron-Aufgabe

Die Modulkonfiguration zeigt eine URL mit Token. Planen Sie sie bei Ihrem Hoster alle 15 Minuten ein. Sie öffnet und schließt Zeitfenster pünktlich und bedient bei aktiver automatischer Zuteilung die Vorbestellungen, deren Bestand eingetroffen ist.

## Häufige Fragen

### Zahlt der Kunde den vollen Betrag?

Ja. Der Kunde zahlt den vollen Betrag bei der Bestellung über Ihre üblichen Zahlarten.

### Kann Lagerware vor den Vorbestellungen versandt werden?

Ja, mit der Teillieferung oder der Aufteilung, beschrieben unter Versand gemischter Bestellungen. Im Modus Eine Sendung wartet die Bestellung, bis alles verfügbar ist.

### Warum wechselt eine Bestellung zu Vorbestellung: wartet auf Bestand?

Das Modul setzt diesen Status, sobald die Bestellung bezahlt ist und mindestens eine vorbestellte Position enthält. Der Status ist bezahlt und nicht versandfähig, damit keine unvollständige Bestellung in die Vorbereitung geht.

### Wirkt sich eine Regel auf einer Variante auf die anderen aus?

PrestaShop verwaltet die Einstellung für Bestellungen ohne Bestand nur auf Produktebene. Das Modul setzt sie deshalb am Produkt und sperrt anschließend im Shop und im Warenkorb die nicht vorrätigen Varianten ohne Regel, damit das ursprüngliche Shopverhalten erhalten bleibt.

### Der Countdown erscheint nicht

Er erscheint nur, wenn das Enddatum (Modus Zeitfenster) oder das voraussichtliche Versanddatum in der Zukunft liegt und die Option in der Regel aktiviert ist.

### Der Button behält seinen ursprünglichen Text

Das Modul ersetzt den Text des Warenkorb-Buttons in Standard-Themes. Bei einem stark angepassten Theme wenden Sie sich mit der Produkt-URL an den Support: Der Selektor des Buttons lässt sich anpassen.
