# Liefertermin und Zeitfenster für PrestaShop: Moduldokumentation

> Dieses Modul ergänzt den Checkout von PrestaShop 8 und 9 um eine Pflichtauswahl von Liefertermin und Zeitfenster, begrenzt durch die reale Kapazität Ihrer Werkstatt, mit Lieferzonen nach Wochentag, Grußkarte, Abholung…

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

Dieses Modul ergänzt den Checkout von PrestaShop 8 und 9 um eine Pflichtauswahl von Liefertermin und Zeitfenster, begrenzt durch die reale Kapazität Ihrer Werkstatt, mit Lieferzonen nach Wochentag, Grußkarte, Abholung im Geschäft und Lieferzuschlägen. Technischer Name: `dfflorist`.

## Installation

1. Klicken Sie unter **Module > Modulverwaltung** auf **Modul hochladen** und ziehen Sie die ZIP-Datei hinein.
2. Bei der Installation legt das Modul seine Tabellen an, zwei Demo-Zeitfenster (Vormittag 09:00-12:00 und Nachmittag 14:00-18:00), vier illustrierte Kartenmotive und einen versteckten Artikel **Lieferzuschlag** (Artikelnummer `DFFLO-SURCHARGE`).
3. Ein neuer Menüpunkt **Bestellungen > Floristik-Lieferungen** erscheint. Die Navigationsleiste des Moduls führt zu Planung, Zonen, Zeitfenstern, Schließtagen, Karten, Werkstattauslastung und Einstellungen.

Löschen Sie den Artikel Lieferzuschlag nicht aus dem Katalog: Er trägt die Zuschläge im Warenkorb. Name, Bild und Steuerregel können Sie ändern.

## Allgemeine Einstellungen

### Geltungsbereich

- **Betroffene Produkte**: alle Produkte oder nur die der angekreuzten Kategorien (Schnittblumen, Pflanzen, Frischware).
- **Betroffene Versanddienste**: nichts ankreuzen, um die Planung auf alle anzuwenden. Bei einer Auswahl fragen die übrigen Versanddienste (Trockenblumen per Paket zum Beispiel) kein Datum ab.
- **Versanddienste für Abholung im Geschäft**: siehe unten.
- **Nur innerhalb der Zonen liefern**: sobald eine Zone aktiv ist, kann eine Postleitzahl außerhalb aller Zonen mit einem betroffenen Versanddienst nicht bestellen.
- **Badge auf der Produktseite** und **Akzentfarbe** des Checkout-Blocks.

### Liefertermin und Vorlaufzeiten

- **Datum erforderlich** und **Lieferzeit erforderlich** (gilt nur, wenn es für den gewählten Tag Zeitfenster gibt).
- **Lieferung am selben Tag** und ihr **Annahmeschluss** (HH:MM, Zeitzone des Shops).
- **Täglicher Bestellschluss** (optional): Bestellungen nach dieser Uhrzeit zählen ab dem nächsten Tag. Beispiel: 16:00 bei einem Tag Vorlauf, eine Bestellung am Montag um 17:00 kann nicht am Dienstag geliefert werden.
- **Mindestvorlaufzeit** in Tagen, **Vorbereitungszeit vor einem Zeitfenster** bei Bestellungen für denselben Tag, **Buchungszeitraum** in Tagen.

### Werkstattkapazität

- **Liefertage** der Werkstatt und **Kapazität pro Wochentag** in Einheiten (0 = kein Tageslimit).
- **Standardauslastung pro Produkt**: Einheiten pro Artikel. Eine abweichende Auslastung pro Produkt legen Sie unter **Werkstattauslastung** fest.
- **Reservierung während des Checkouts** (standardmäßig 20 Minuten): Warenkörbe mit gewähltem Zeitfenster halten es so lange fest.
- **Warnung bei wenigen freien Plätzen** und **Bestellstatus, die Kapazität freigeben** (standardmäßig storniert, Zahlungsfehler, erstattet).

### Grußkarte und Empfänger

Aktivieren Sie die Karte, machen Sie die Nachricht bei Bedarf zur Pflicht, legen Sie die maximale Länge fest und bieten Sie Unterschrift und anonyme Karte an. Das Telefon des Empfängers kann ausgeblendet, optional oder erforderlich sein.

## Lieferzonen

Eine Zone fasst Postleitzahlen und die Tage zusammen, an denen sie beliefert wird. Zulässige Muster, eines pro Zeile oder durch Kommas getrennt:

- exakte PLZ: `80331`
- Präfix: `80*`
- Bereich: `80331..80999`

Das Land ist optional. Die **zusätzliche Vorlaufzeit** wird bei entfernten Zonen zur Mindestvorlaufzeit addiert und deaktiviert dort die Lieferung am selben Tag. Passen mehrere Zonen, gilt die erste aktive Zone der Liste.

## Zeitfenster

Jedes Zeitfenster hat eine übersetzbare Bezeichnung, Start- und Endzeit, Wochentage, eine Kapazität in Einheiten (0 = nur die Tageskapazität gilt), einen optionalen **Zuschlag inkl. MwSt.** und bei Bedarf eine Beschränkung auf bestimmte Zonen. Ohne aktives Zeitfenster wählt der Kunde nur ein Datum.

## Schließtage und Spitzentage

- **Geschlossen**: das Datum ist gesperrt (Urlaub, Inventur).
- **Spitzentag oder Sonderöffnung**: die Tageskapazität wird durch Ihre ersetzt (0 = unbegrenzt), und der Tag öffnet auch, wenn er normalerweise geschlossen ist. Gibt es für diesen Wochentag kein Zeitfenster, werden alle aktiven Zeitfenster angeboten.

## Grußkarten

Jedes Motiv hat einen Namen, einen Textvorschlag, der die Nachricht vorbefüllt, wenn der Kunde die Karte wählt, und ein Bild in JPG, PNG oder WebP bis 2 MB, empfohlenes Format 3:2. Die vier mitgelieferten Motive (Geburtstag, Liebe, Danke, Beileid) sind bearbeitbar.

## Werkstattauslastung pro Produkt

Geben Sie für jedes Produkt die **Einheiten pro Artikel** an (0 für eine Vase oder Pralinen ohne Vorbereitung) sowie eine **zusätzliche Vorbereitung** in Tagen für Artikel auf Bestellung. Liegt ein solcher Artikel im Warenkorb, verlängert sich die Vorlaufzeit entsprechend und die Lieferung am selben Tag entfällt.

## Was der Kunde im Checkout sieht

Im Schritt Versand erscheint der Block unter der Liste der Versanddienste, über dem Weiter-Button. Der Kunde wählt einen Tag im Kalender (die Anzeige zeigt die Auslastung, ein „+“ kennzeichnet einen Zuschlag) und dann ein Zeitfenster mit den letzten Plätzen und seinem Zuschlag. Anschließend wählt er ein Kartenmotiv, schreibt Nachricht und Unterschrift und sieht die Kartenvorschau live. Die Auswahl wird automatisch gespeichert.

Der Weiter-Button bleibt gesperrt, solange Pflichtangaben fehlen, und der Server prüft alles beim Abschluss des Schritts erneut.

## Abholung im Geschäft

Kreuzen Sie Ihre Click-&-Collect-Versanddienste unter **Versanddienste für Abholung im Geschäft** an. Für diese wird der Block zu **Abholtermin**: keine Zone, kein Telefon des Empfängers, kein Zuschlag. Auf Zonen beschränkte Zeitfenster werden nicht angeboten. Wechselt der Kunde den Versanddienst, lädt der Block neu und der Zuschlag wird dem Warenkorb hinzugefügt oder entfernt.

## Lieferzuschläge

Drei Quellen werden addiert, alle inkl. MwSt. in der Standardwährung:

- der Zuschlag des gewählten **Zeitfensters** (Express, Fixzeit);
- der Zuschlag des **Wochentags** (zum Beispiel Sonntag);
- der Zuschlag für **denselben Tag**.

Die Summe wird dem Warenkorb als Zeile **Lieferzuschlag** mit der Steuerregel des versteckten Artikels hinzugefügt und erscheint in der Übersicht, der Bestellung und der Rechnung. Der Zuschlag wird automatisch entfernt, wenn der Kunde zur Abholung wechselt oder der Warenkorb kein betroffenes Produkt mehr enthält.

## Planung und Druck

Die Seite **Planung** zeigt eine 14-Tage-Leiste mit Auslastung, die Auslastung des gewählten Tages pro Zeitfenster, die von laufenden Warenkörben reservierten Einheiten und die Liste der Lieferungen (Uhrzeit, Zone oder Vermerk Abholung im Geschäft, Empfänger, Adresse, Artikel, Karte). Drei Aktionen:

- **Grußkarten drucken**: A6-Karten, vier pro A4-Blatt mit Schnittlinien, danach als Gedruckt markiert;
- **Lieferliste**: Tour nach Zeitfenster, Abholungen in einem eigenen Abschnitt;
- **CSV exportieren**: Semikolon als Trennzeichen, Excel-kompatibel.

## Bestellungen, E-Mails und PDF

- Die Bestellübersicht im Back-Office erhält eine sortierbare Spalte **Liefertermin** mit Datumsbereichsfilter.
- Die Bestellseite zeigt ein Panel mit Datum, Zeitfenster, Zone, Zuschlag und Karte und erlaubt deren Änderung (ohne Kapazitätsprüfung).
- In den Standard-E-Mails wird das Datum nach dem Namen des Versanddienstes eingefügt, in der Sprache der Bestellung. Variablen für Ihre Vorlagen: `{dfflo_delivery_date}`, `{dfflo_delivery_slot}`, `{dfflo_card_message}`.
- Die PDF-Rechnung zeigt Datum und Telefon des Empfängers, der Lieferschein zusätzlich die Nachricht.

## Update von 1.0.0

Laden Sie das ZIP 1.1.0 in der Modulverwaltung über die vorhandene Version. Das Update-Skript ergänzt die neuen Spalten und Einstellungen, legt den Artikel Lieferzuschlag an und weist den Demo-Karten ihre Motive zu. Zonen, Zeitfenster und Bestellungen bleiben erhalten.

## Häufige Fragen

### Der Block erscheint nicht im Checkout

Prüfen Sie, ob das Modul in den Einstellungen aktiviert ist, ob der Warenkorb ein betroffenes Produkt enthält und ob der gewählte Versanddienst betroffen oder als Abholung eingetragen ist.

### Es wird kein Datum angeboten

Prüfen Sie die Liefertage der Werkstatt, die Liefertage der Zone des Kunden, die Mindestvorlaufzeit und den Buchungszeitraum. Ein Produkt mit zusätzlicher Vorbereitung verschiebt ebenfalls das erste Datum.

### Was passiert bei der Deinstallation?

Zonen, Zeitfenster, Karten und die an Bestellungen gespeicherten Termine werden gelöscht, ebenso der Artikel Lieferzuschlag. Bereits berechnete Zuschlagszeilen bleiben in den Bestellungen.
