# B2B-Schnellbestellung (Quick Order) — Vollständige Anleitung

> Überblick Das Modul B2B-Schnellbestellung (dfquickorder) fügt eine Schnellerfassungsseite hinzu, auf der Ihre Geschäftskunden eine Bestellung direkt aus ihren Referenzen (SKUs) zusammenstellen, ohne den Katalog zu durchsuchen. Sie können Referenzen einzeln…

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

## Überblick

Das Modul **B2B-Schnellbestellung** (`dfquickorder`) fügt eine Schnellerfassungsseite hinzu, auf der Ihre Geschäftskunden eine Bestellung direkt aus ihren **Referenzen (SKUs)** zusammenstellen, ohne den Katalog zu durchsuchen. Sie können Referenzen einzeln mit Autovervollständigung eingeben, **zwei Spalten aus Excel einfügen**, **eine CSV-Datei importieren**, eine gespeicherte **Nachbestellliste** erneut laden oder **eine frühere Bestellung wiederholen** und dann alles mit einem Klick in den Warenkorb legen.

Konzipiert für die B2B-Nachbestellung und eilige Einkäufer: Ein Großhändler, der seine Referenzen kennt, spart erheblich Zeit gegenüber dem Durchsuchen Produkt für Produkt. Das Raster löst jede SKU in Echtzeit auf (Name, gruppenabhängiger Preis, Bestand, Mindestmenge, Variante).

## Kompatibilität

- PrestaShop 8.0 bis 9.x
- PHP 7.4 bis 8.3
- Einzelshop und Multistore
- 5 Sprachen: FR, EN, ES, DE, IT
- Classic-Theme und individuelle Themes (Raster in nativem JavaScript, ohne jQuery-Abhängigkeit)
- Keine Abhängigkeiten (weder Composer noch Framework)

## Installation

1. Öffnen Sie im Back Office **Module > Modul-Manager**.
2. Klicken Sie auf **Modul hochladen** und wählen Sie die Datei `dfquickorder.zip` aus.
3. Klicken Sie nach der Installation auf **Konfigurieren**.

Bei der Installation erstellt das Modul seine Tabelle für Nachbestelllisten, registriert seine Hooks (`displayCustomerAccount`, `displayNav2` und den benutzerdefinierten Hook `displayQuickOrderBlock`) und initialisiert seine Standardeinstellungen. Ein Link **Schnellbestellung** erscheint dann im Kundenkonto.

## Konfiguration

### Zugriff und Einschränkung

- **Erlaubte Kundengruppen**: Leer lassen, um die Schnellbestellung für alle zu öffnen, oder eine oder mehrere Gruppen auswählen, um sie Ihren B2B-Kunden vorzubehalten. Nicht autorisierte Besucher werden zu ihrem Konto umgeleitet.

### Eingabe und Import

- **CSV-Trennzeichen**: Semikolon, Komma, Tabulator oder senkrechter Strich, je nach dem von Ihren Kunden exportierten Format.
- **Standardanzahl der Zeilen**: Anzahl der leeren Zeilen, die beim Öffnen des Rasters angezeigt werden.
- **Maximale Zeilen pro CSV / Einfügen**: Schutz gegen zu große Importe; Zeilen über dem Limit werden mit einer Warnung ignoriert.

### Anzeige und Funktionen

- **Preis und Zwischensumme anzeigen**: zeigt den Stückpreis, die Zeilensumme und die geschätzte Gesamtsumme an, berechnet nach der Steuermethode der Gruppe (netto oder brutto).
- **Aus Excel einfügen**: aktiviert die Registerkarte zum Einfügen von zwei Spalten (Referenz und Menge).
- **Nachbestelllisten**: aktiviert das Speichern und erneute Laden benannter Listen pro Kunde.
- **Nachbestellung mit einem Klick**: aktiviert das erneute Laden einer früheren Bestellung in das Raster.
- **Schaltfläche „In Angebot umwandeln“**: wird nur angezeigt, wenn das Modul `dfb2bquote` installiert und aktiv ist (Brücke zur B2B-Angebotsreihe).

## Verwendung

### Das SKU-Eingaberaster

Der Kunde gibt eine Referenz ein: Ein Autovervollständigungsmenü schlägt die passenden Produkte und Varianten vor (nach Referenz oder Name). Bei der Bestätigung wird die Zeile in Echtzeit aufgelöst und zeigt den Produktnamen, die Variantenbezeichnung, den Stückpreis für seine Gruppe, die Zeilensumme und ein Status-Abzeichen an. Eine neue leere Zeile wird fortlaufend automatisch hinzugefügt.

### Die Zeilenstatus

- **Grün**: gültige Referenz, ausreichender Bestand.
- **Orange**: Menge angepasst (Teilbestand verfügbar oder Mindestbestellmenge erreicht).
- **Rot**: unbekannte Referenz, nicht verfügbares Produkt oder nicht auf Lager.

Die Auflösung berücksichtigt **Varianten**: Eine Variantenreferenz gibt das korrekte `id_product_attribute` und seine Attributbezeichnung zurück. Die Suche erfolgt über die Referenz und greift ersatzweise auf den EAN13-Barcode zurück, unter Beachtung des aktuellen Shops und der aktiven Produkte.

### Aus Excel einfügen

Auf der Registerkarte **Aus Excel einfügen** fügt der Kunde zwei Spalten (Referenz und Menge) direkt aus seiner Tabellenkalkulation ein. Jede Zeile wird analysiert und aufgelöst und dann mit ihrem Status in das Raster eingefügt. Eine mögliche Kopfzeile („sku“, „Referenz“ …) wird erkannt und ignoriert.

### CSV-Import

Auf der Registerkarte **CSV-Import** lädt der Kunde eine zweispaltige Datei hoch. Die Datei wird im Browser gelesen und dann zur Auflösung gesendet. Eine herunterladbare **CSV-Vorlage** wird bereitgestellt, um das erwartete Format vorzugeben. Das im Back Office konfigurierte Trennzeichen wird angewendet, mit automatischem Rückgriff auf die gängigen Trennzeichen.

### Nachbestelllisten

Ein angemeldeter Kunde kann **das aktuelle Raster als benannte Liste speichern** (zum Beispiel „Monatliche Nachbestellung“) und sie jederzeit über die Registerkarte **Meine Listen** erneut laden. Jede Liste gehört dem Kunden und dem Shop; sie kann in das Raster geladen oder gelöscht werden.

### Eine frühere Bestellung wiederholen

Die Registerkarte **Nachbestellen** listet die letzten gültigen Bestellungen des Kunden auf. Ein Klick lädt alle Referenzen und Mengen der Bestellung erneut in das Raster, bereit zur Anpassung und zum Hinzufügen in den Warenkorb.

### In den Warenkorb legen und in Angebot umwandeln

Die Schaltfläche **Alles in den Warenkorb legen** fügt alle gültigen Zeilen auf einmal in den Warenkorb ein und berücksichtigt dabei die Mengen. Wenn das Modul `dfb2bquote` aktiv ist, fügt die Schaltfläche **In Angebot umwandeln** die Zeilen in den Warenkorb ein und wechselt dann zum Angebotsprozess.

### Zugriff auf die Schnellbestellung

Der Link **Schnellbestellung** ist im Kundenkonto verfügbar. Sie können ihn auch in der oberen Navigation anzeigen und über den benutzerdefinierten Hook `displayQuickOrderBlock` einen Call-to-Action-Block an beliebiger Stelle in Ihrem Shop einfügen.

## FAQ und Fehlerbehebung

### Das Raster zeigt einen Fehler „ungültiges JSON“ oder löst die Referenzen nicht auf

Leeren Sie den PrestaShop-Cache (Erweiterte Einstellungen > Leistung) und deaktivieren Sie während des Testens die Kombination/Komprimierung von Dateien (CCC). Die Antworten des Rasters sind striktes JSON: Das Modul verwirft jede Störausgabe vor der Antwort, was verhindert, dass eine PHP-Meldung die Antwort beschädigt.

### Wie behalte ich die Schnellbestellung meinen Geschäftskunden vor?

Wählen Sie in der Konfiguration die erlaubte(n) Gruppe(n) unter **Erlaubte Kundengruppen** aus. Alle anderen Besucher haben keinen Zugriff auf die Seite.

### Werden Varianten unterstützt?

Ja. Eine Variantenreferenz wird auf die korrekte Variante aufgelöst, mit eigener Attributbezeichnung, eigenem Preis und Bestand. Der EAN13-Barcode wird ebenfalls als Referenz akzeptiert.

### Was passiert, wenn eine Menge den Bestand übersteigt?

Je nach Einstellung des Produkts zur Behandlung von Ausverkäufen wird die Menge auf den verfügbaren Bestand angepasst (oranger Status) oder die Zeile als nicht vorrätig markiert (roter Status). Nicht gefundene Referenzen werden gekennzeichnet, ohne den Rest des Rasters zu blockieren.

### Erfordern Listen und Nachbestellung ein Konto?

Ja: Das Speichern von Listen und das Wiederholen früherer Bestellungen erfordern, dass der Kunde angemeldet ist. SKU-Eingabe, Einfügen und CSV-Import funktionieren auch für autorisierte Besucher.

### Ist es mit PrestaShop 9 kompatibel?

Ja. Das Modul ist mit PrestaShop 8 und 9 kompatibel, in Multistore- und mehrsprachigen Umgebungen (FR, EN, ES, DE, IT).
