TISSL

Die TISSL-Integration ermöglicht die automatische Order Injection in Ihren TISSL-POS und vollständige Pay-at-Table-Funktionalität. Anders als bei Menü-Sync-Integrationen nutzt TISSL manuelle Produktverknüpfung per Product IDs (PLUs) – Sie erstellen Ihr Menü in storekit und verknüpfen Produkte mit ihren TISSL-Gegenstücken.

​

Voraussetzungen

Vor der Einrichtung von TISSL:

• Aktives TISSL-POS-System
• TISSL API Key
• TISSL Organisation ID
• Liste der Product IDs für Ihre Menüartikel
• Admin-Zugriff auf Ihr storekit-Dashboard

​

Verbindung einrichten

​

Schritt 1: TISSL verbinden

1. Gehen Sie in Ihrem storekit-Dashboard zu Store-Einstellungen > Integrationen
2. Suchen Sie TISSL und klicken Sie auf Verbinden
3. Geben Sie Ihre TISSL-Zugangsdaten ein:
   • API Key – Ihr TISSL-API-Authentifizierungsschlüssel
   • Organisation ID – Ihre TISSL-Organisationskennung
4. Klicken Sie auf Verbinden

storekit verifiziert die Zugangsdaten durch Prüfung Ihres TISSL-Live-Status vor dem Speichern.

​

Schritt 2: Site auswählen

Nach der Authentifizierung:

1. storekit kann verfügbare Sites aus Ihrer TISSL-Organisation abrufen
2. Wählen Sie die Site, die zu diesem storekit-Venue passt
3. Die Site ID wird für die Bestellweiterleitung gespeichert

​

Schritt 3: Integrationseinstellungen konfigurieren

Konfigurieren Sie die erforderlichen TISSL-Einstellungen:

​

Schritt 4: Produkte verknüpfen

Für jedes Produkt in Ihrem storekit-Menü:

1. Gehen Sie zu Menü und wählen Sie ein Produkt aus
2. Suchen Sie das Feld POS-ID
3. Geben Sie die exakte Product ID aus TISSL ein
4. Speichern Sie das Produkt

Wiederholen Sie dies für alle Produkte und Modifikatoren.

​

Wie die Produktverknüpfung funktioniert

TISSL verwendet manuelle Verknüpfung – Produkte werden nicht automatisch synchronisiert:

1. Sie erstellen Ihr Menü in storekit
2. Sie geben die TISSL Product ID für jeden Artikel ein
3. Bei Bestellungen sendet storekit die Product IDs
4. TISSL ordnet die IDs Produkten zu und verarbeitet die Bestellung

Dies gibt Ihnen die volle Kontrolle über die Präsentation Ihres Online-Menüs bei gleichzeitiger POS-Kompatibilität.

​

Modifikatoren verknüpfen

Modifikatoren benötigen sowohl Product ID als auch Group ID:

1. Gehen Sie in storekit zu Ihren Modifikatorgruppen
2. Geben Sie für jede Modifikatorgruppe die TISSL-Group Name/ID ein
3. Geben Sie für jede Modifikator-Option die TISSL-Product ID ein
4. Speichern Sie die Änderungen

storekit sendet Modifikatoren im von TISSL erwarteten Format:

• modifierGroups: Array von Gruppennamen
• modifiers: Array mit Paaren aus Gruppenname und Modifikatorname

​

Order Injection

Wenn ein Kunde eine Bestellung aufgibt, sendet storekit sie an TISSLs /order-Endpunkt.

​

Bestellkanäle

​

Was TISSL empfängt

Jede Bestellung enthält:

• Organisation ID und Site ID
• Externe Bestell-ID (storekit-Bestell-ID)
• Bestellbeschreibung (Bestellcode oder Tischnummer)
• Anzahl der Gäste
• Bestellart
• Servicegebühren-Einstellungen
• Alle Artikel mit:
  • Product ID
  • Menge
  • Brutto- und Nettopreisen
  • Gangzuweisung
  • Artikelnotizen
  • Modifikatorgruppen und Modifikatoren
• Zahlungspositionen (bei bargeldlosen Bestellungen)
• Kundendetails mit Adresse
• Bestellnotizen

​

Puffer für Vorbestellungen

Bei geplanten Bestellungen können Sie das Puffern aktivieren:

• Buffer Orders – Aktivieren, um die Order Injection zu verzögern
• Bestellungen werden bis näher zur Erfüllungszeit zurückgehalten
• Ein Jitter wird hinzugefügt, um zu verhindern, dass gleichzeitige Bestellungen fehlschlagen

​

Liefergebühr & Rabatte

Bei Bedarf fügt storekit Positionen hinzu für:

• Liefergebühr: Verwendet die konfigurierte Delivery-Fee-Product-ID
• Rabatte: Verwendet die konfigurierte Discount-Product-ID mit negativem Preis

​

Zu bestehender Rechnung hinzufügen

Bei Dine-in-Bestellungen prüft storekit auf eine bestehende Rechnung am Tisch:

• Wenn gefunden, wird die Bestellung zur bestehenden Rechnung hinzugefügt
• Wenn nicht, wird eine neue Rechnung erstellt

Konfigurieren Sie All Orders Add To Bill, um dieses Verhalten zu steuern.

​

Pay at Table

TISSL unterstützt eine vollständige Pay-at-Table-Integration:

​

Funktionsweise

1. Kunde scannt QR-Code am Tisch
2. storekit ruft die offene Rechnung aus TISSL über /order/table/{tableId}/{orgId}/{siteId} ab
3. Kunde sieht die Positionen und wählt aus, was er bezahlen möchte
4. Zahlung wird verarbeitet und über /order/payment an TISSL gesendet
5. Rechnungsstatus wird in Echtzeit synchronisiert

​

Rechnungssynchronisation

storekit hält Rechnungen mit TISSL synchron:

• In TISSL hinzugefügte/entfernte Positionen werden automatisch aktualisiert
• Am POS getätigte Zahlungen werden erfasst
• Zwischen Tischen verschobene Rechnungen werden nachverfolgt
• Servicegebühren und Rabatte werden korrekt synchronisiert
• Steuerpositionen werden pro Artikel synchronisiert

​

Konfiguration

​

Tisch-Synchronisation

Rufen Sie Ihr Tischlayout aus TISSL ab:

1. Gehen Sie zu Stores → Ihrem Store → Einstellungen → Integrationen → Tissl
2. Klicken Sie auf Grundriss synchronisieren und bestätigen Sie
3. Trading Zones und Places werden als Bereiche und Tische importiert

Tische enthalten:

• Zonen-/Bereichsnamen und -ID
• Tischname und -ID
• Kapazität
• Aktiv-Status

​

Referenz zu Integrationseinstellungen

​

Integration testen

​

Checkliste vor dem Start

1. Verbindung
   • API Key und Organisation ID verifiziert
   • Site korrekt ausgewählt
2. Konfiguration
   • Order Type existiert in TISSL
   • Payment Type konfiguriert
   • Course zugewiesen
   • Delivery-Fee-Produkt erstellt (bei Lieferung)
   • Discount-Produkt erstellt (bei Rabatten)
3. Produktverknüpfung
   • Alle Produkte haben TISSL Product IDs
   • Alle Modifikatoren haben Product IDs
   • Modifikatorgruppen haben Group Names
4. Bestellablauf
   • Testbestellung aufgeben
   • Artikel erscheinen korrekt in TISSL
   • Modifikatoren werden korrekt angezeigt
   • Preise stimmen überein
5. Pay at Table (falls verwendet)
   • Tische synchronisiert
   • Rechnung in TISSL öffnen
   • Rechnung über storekit anzeigen
   • Testzahlung abschließen

​

Fehlerbehebung

​

Verbindung fehlgeschlagen

• Prüfen Sie, ob der API Key korrekt und aktiv ist
• Prüfen Sie, ob die Organisation ID zu Ihrem Konto passt
• Bestätigen Sie, dass das TISSL-System online ist (Live-Statusprüfung)

​

Bestellungen erscheinen nicht

• Prüfen Sie, ob die Integration aktiviert ist
• Prüfen Sie, ob die Site ID korrekt ist
• Prüfen Sie die Bestellung im Dashboard auf Fehlermeldungen
• Bestätigen Sie, dass Order Type und Payment Type in TISSL existieren

​

Fehlende Artikel

• Prüfen Sie, ob Product IDs korrekt eingegeben sind
• Überprüfen Sie, ob die Produkte in TISSL existieren
• Artikel ohne Product IDs werden mit einer Warnung übersprungen

​

Modifikator-Probleme

• Stellen Sie sicher, dass Modifikatorgruppen Group Names/IDs haben
• Prüfen Sie, ob Modifikator-Product-IDs in TISSL existieren
• Prüfen Sie die Zuordnung der Modifikatorgruppen

​

Falsche Preise

• Preise werden inklusive Modifikatoren berechnet
• Prüfen Sie, ob Steuereinstellungen übereinstimmen (storekit sendet Brutto und Netto)
• Prüfen Sie die Servicegebühren-Konfiguration

​

Pay-at-Table-Fehler

• „no_open_bills”: Keine aktive Rechnung an diesem Tisch in TISSL
• „already_exists”: Rechnung bereits verarbeitet/geschlossen
• Prüfen Sie, ob die Tisch-POS-ID mit der TISSL-Tisch-ID übereinstimmt

​

Einschränkungen

Mit der TISSL-Integration:

• Keine automatische Menü-Synchronisation: Menü in storekit erstellen, mit TISSL-IDs verknüpfen
• Keine Echtzeit-Bestandssynchronisation: Verfügbarkeit in storekit verwaltet
• Manuelle Produktzuordnung: ID-Zuordnungen für alle Artikel pflegen

Für weitere Unterstützung kontaktieren Sie den Support.

​

Unterstützte Funktionen