21c

QR-Code-Management (Self-Ordering)

Wozu dient das?#

Das QR-Code-Management generiert und verwaltet eindeutige, tischbezogene QR-Codes für das digitale Self-Ordering Ihrer Gäste. Auf Aufstellern oder Aufklebern am Tisch angebracht, ermöglichen diese Codes Ihren Gästen, die digitale Speisekarte direkt auf dem eigenen Smartphone aufzurufen, Produkte auszuwählen und Bestellanforderungen an die Kasse oder Küche zu senden – kontaktlos, ohne App-Download und ohne Registrierung.

Voraussetzungen#

• Bereits angelegte Tische und Bereiche im Kassensystem (→ Kapitel 21b).
• Aktiviertes Self-Ordering-Modul für Ihren Mandanten.
• Ein Drucksystem zum Ausdrucken der Tischaufsteller oder Vorlagen.

Rollen & Berechtigungen#

Bildschirm für Bildschirm (QRManagement.tsx)#

• 1 Alle QR-Blätter drucken öffnet die druckoptimierte Übersicht für alle Tische.
• 2 Die Tabelle der Tische mit TISCH-NUMMER (zum Beispiel Tisch 1) und KAPAZITÄT (zum Beispiel 2 Gäste).
• 3 QR anzeigen zeigt rechts den QR-Code dieses Tisches.
• 4 Die Karte Self-Ordering QR-Code mit dem Code. Ist noch kein Tisch gewählt, steht dort Wählen Sie einen Tisch aus, um seinen QR-Code anzuzeigen.
• 5 PNG herunterladen speichert den Code als Bilddatei.
• 6 Vorschau öffnen öffnet das Bestellportal der Gäste in einem neuen Tab zum Ausprobieren.
• Kopfzeile:
  • Titel: QR-Icon mit der Überschrift QR-Code-Management (qr_code_management).
  • Untertitel: QR-Codes für das Self-Ordering an Tischen generieren und verwalten. (generate_and_manage_qr_codes_for_selford).
  • Sammeldruck-Schaltfläche: Alle QR-Blätter drucken (print_all_qr_sheets) mit Drucker-Icon – öffnet die druckoptimierte Übersicht für alle Tische.
• Linker Bereich: Tisch-Tabelle
  • Spaltenüberschriften:
    • Tisch-Nummer (table_number)
    • Kapazität (capacity)
    • Aktionen (actions)
  • Tabellenzeilen: Listet alle Tische des aktuellen Standorts auf.
    • Tischnummer wird im Format table_number_label (Tisch 4) gerendert.
    • Kapazität wird als {{count}} Gäste (guests_count) angezeigt (z. B. "4 Gäste").
    • In der Spalte Aktionen befindet sich die Schaltfläche QR anzeigen (view_qr).
  • Ladeindikator: Während Daten vom Server abgerufen werden, erscheint der Hinweis Tische werden geladen... (loading_tables).
• Rechter Bereich: QR-Vorschaukarte (Sticker-Vorschau)
  • Inaktiver Zustand (Kein Tisch ausgewählt): QR-Icon mit dem Hinweistext Wählen Sie einen Tisch aus, um seinen QR-Code anzuzeigen (select_a_table_to_view_its_qr_code).
  • Aktiver Zustand (Tisch gewählt):
    • Karten-Titel: Tischnummer im Format table_number_label (z. B. "Tisch 4").
    • Karten-Untertitel: Self-Ordering QR-Code (selfordering_qr_code).
    • QR-Grafik: Vektorbasierte QR-Code-Darstellung (#qr-svg) mit weißem Rand.
    • Aktions-Buttons:
      • PNG herunterladen (download_png): Lädt die QR-Grafik als hochauflösende PNG-Datei herunter.
      • Vorschau öffnen (open_preview): Öffnet das digitale Gast-Bestellportal in einem neuen Tab zum Testen.

Schritt für Schritt (mit Verzweigungen)#

1. QR-Code-Management aufrufen#

1. Melden Sie sich im Backoffice an.
2. Wählen Sie im Navigationsmenü den Punkt QR-Code-Management (qr_code_management).
3. Das System zeigt die Tabelle aller Tische Ihres Standorts.

2. QR-Code für einen bestimmten Tisch aufrufen#

1. Suchen Sie den gewünschten Tisch in der Tabelle.
2. Klicken Sie in der Spalte Aktionen (actions) auf QR anzeigen (view_qr).
3. Die rechte Vorschaukarte zeigt den generierten QR-Code für diesen Tisch.

3. Gast-Ansicht im Browser testen#

1. Klicken Sie in der Vorschaukarte auf Vorschau öffnen (open_preview).
2. Es öffnet sich ein neuer Tab mit der mobilen Speisekarte, wie sie ein Gast auf seinem Smartphone sieht.

4. Einzelnen QR-Code als Grafik herunterladen (für eigene Druckvorlagen)#

1. Klicken Sie in der Vorschaukarte auf PNG herunterladen (download_png).
2. Das System generiert eine PNG-Datei (z. B. QR_Table_4.png) und lädt diese herunter.
3. Sie können dieses Bild in Ihre eigenen Grafikprogramme oder Tischaufsteller-Layouts einfügen.

5. Alle QR-Codes auf einmal ausdrucken (Sammeldruck)#

1. Klicken Sie in der oberen rechten Ecke auf Alle QR-Blätter drucken (print_all_qr_sheets).
2. Der Browser öffnet die Druckansicht mit allen Tisch-QR-Codes.
3. Wählen Sie Ihren lokalen Drucker aus und drucken Sie die Vorlagen aus.

Was passiert im Hintergrund#

• Jeder Tisch besitzt in der Datenbank-Tabelle tables einen eindeutigen, kryptographisch erzeugten Token (qr_token).
• Der QR-Code verweist auf die Web-Adresse des Gastportals mit dem Token im URL-Pfad: https://<Ihre-Domain>/self-order?token=....
• Scann ein Gast den Code, validiert das self_order-Backend den Token und weist alle eingehenden Bestellungen automatisch dem korrekten Tisch und Standort zu.

Häufige Probleme#

1. Fehlermeldung: Table not found#

• Ursache: Der aufgerufene Tisch existiert nicht mehr im System oder der QR-Token ist ungültig.
• Lösung: Generieren Sie den QR-Code im Backoffice neu und tauschen Sie den Tischaufsteller aus.

2. Fehlermeldung: No open bill found for this table#

• Ursache: Ein Gast versucht über den QR-Code eine Rechnung einzusehen, obwohl am Tisch noch keine Bestellung gebucht wurde.
• Lösung: Der Gast muss zunächst Artikel über die digitale Speisekarte auswählen und bestellen.

3. Fehlermeldung: No open order found for this table#

• Ursache: Am Tisch liegt keine aktive offene Bestellung vor.
• Lösung: Starten Sie eine neue Bestellung über die Self-Order-Oberfläche.

4. Fehlermeldung: Order not found for this table#

• Ursache: Die aufgerufene Bestell-ID ist ungültig oder wurde bereits storniert.
• Lösung: Rufen Sie die Hauptseite des Self-Ordering-Portals über den QR-Code neu auf.

5. Fehlermeldung: Seat {seat} is not valid for this table (1-{table.capacity})#

• Ursache: Bei sitzplatzbezogenen Bestellungen wurde eine Sitzplatznummer eingegeben, die die hinterlegte Tisch-Kapazität überschreitet.
• Lösung: Überprüfen und erhöhen Sie die Tisch-Kapazität (capacity) in den Tisch-Stammdaten (→ Kapitel 21b).

6. Fehlermeldung: Too many active orders for this table#

• Ursache: Ein Sicherheitslimit gegen Missbrauch hat gegriffen, weil zu viele unbestätigte Bestellungen in kurzer Zeit für denselben Tisch gesendet wurden.
• Lösung: Prüfen Sie die eingehenden Bestellungen an der Kasse und schließen oder bestätigen Sie offene Positionen.

7. Fehlermeldung: Token expired#

• Ursache: Der temporäre Gast-Session-Token ist abgelaufen.
• Lösung: Der Gast muss den Tisch-QR-Code erneut mit seinem Smartphone scannen.

8. Fehlermeldung: Token is inactive#

• Ursache: Der QR-Code für diesen Tisch wurde im Backoffice deaktiviert oder neu generiert.
• Lösung: Drucken Sie den aktuellen QR-Code aus dem QR-Code-Management neu aus und ersetzen Sie den Aufsteller am Tisch.

Grenzen#

• Keine automatische Tisch-Zuordnung bei Tischwechsel: Setzen sich Gäste im Raum an einen anderen Tisch, müssen sie den QR-Code des neuen Tisches scannen; die Kasse führt offene Bons nicht automatisch zusammen.
• Gäste-Kartenzahlung: Die direkte Kartenzahlung am Tisch über das Smartphone erfordert ein angebundenes E-Commerce-/Online-Payment-Gateway.

Dieses Kapitel gehört zum Merkuron-Handbuch für Inhaber und Servicepersonal.