> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# TISSL

> Verbinden Sie TISSL POS mit storekit für Order Injection und Pay-at-Table über manuelle Produktverknüpfung. Senden Sie Online-Bestellungen direkt an Ihre bestehenden TISSL-Kassen.

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

<Note>
  Wenden Sie sich an den TISSL-Support, um Ihren API Key und Ihre Organisation ID zu erhalten. Diese sind für die Integration erforderlich.
</Note>

## 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:

| Einstellung              | Beschreibung                              |
| ------------------------ | ----------------------------------------- |
| **Order Type**           | TISSL-Bestellart für Online-Bestellungen  |
| **Payment Type**         | Zahlungstyp für bezahlte Bestellungen     |
| **Course**               | Standard-Gang für alle Artikel            |
| **Delivery Fee Product** | Product ID für Liefergebühren             |
| **Discount Product**     | Product ID/Name für Rabattpositionen      |
| **Service Charge**       | Servicegebühr als Betrag oder Prozentsatz |

<Warning>
  Der Order Type, Payment Type, Course und die Product IDs müssen in Ihrem TISSL-System existieren. Prüfen Sie diese Einstellungen vor dem Go-Live.
</Warning>

### 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

| Erfüllung | TISSL-Kanal     |
| --------- | --------------- |
| Vor Ort   | Pay At Table    |
| Abholung  | Click & Collect |
| Lieferung | Delivery        |

### 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

<Info>
  TISSL kann gleichzeitige Bestellungen mit demselben Betrag verwerfen. Der Jitter (zufällige Verzögerung basierend auf der Bestell-ID) hilft, dies zu verhindern.
</Info>

### 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

| Einstellung                       | Beschreibung                                                  |
| --------------------------------- | ------------------------------------------------------------- |
| **Payment Type**                  | Zahlungstyp für storekit-Zahlungen                            |
| **Kostenlose Artikel ignorieren** | Zeigen Sie Artikel mit Preis Null nicht auf der Rechnung      |
| **Auto-Close Bills Delay**        | Zeit vor der Prüfung, ob die Rechnung vollständig bezahlt ist |

## 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

| Einstellung                | Beschreibung                                            | Standard                   |
| -------------------------- | ------------------------------------------------------- | -------------------------- |
| **Order Type**             | TISSL-Bestellart-Objekt                                 | Erforderlich               |
| **Payment Type**           | Zahlungstyp für Online-Bestellungen                     | Erforderlich               |
| **Course**                 | Standard-Gang für Artikel                               | No Course                  |
| **Delivery Fee**           | Produkt für Liefergebühren                              | Erforderlich für Lieferung |
| **Discount**               | Produkt/Name für Rabatte                                | Erforderlich für Rabatte   |
| **Service Charge**         | Betrag oder Prozentsatz                                 | 0                          |
| **Buffer Orders**          | Verzögert Vorbestellungs-Injection                      | false                      |
| **Remove Email**           | Keine Kunden-E-Mail senden                              | false                      |
| **All Orders Add To Bill** | Dine-in-Bestellungen zu bestehender Rechnung hinzufügen | false                      |
| **Ignore Free Items**      | Kostenlose Artikel in Rechnungsansicht ausblenden       | false                      |
| **Order Note Template**    | Benutzerdefinierte Vorlage für Bestellnotizen           | Keine                      |

## 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](/docs/de/getting-started/contact-support).

## Unterstützte Funktionen

<AccordionGroup>
  <Accordion title="Menü-Synchronisation">
    | Funktion                          | Unterstützt |
    | --------------------------------- | :---------: |
    | Automatische Menü-Synchronisation |      ✗      |
    | Manuelle Produktverknüpfung       |      ✓      |

    TISSL verwendet manuelle Produktverknüpfung. Erstellen Sie Ihr Menü in storekit und geben Sie für jeden Artikel die TISSL Product ID ein.
  </Accordion>

  <Accordion title="Bestellungen">
    | Funktion                          | Unterstützt |
    | --------------------------------- | :---------: |
    | Order Injection                   |      ✓      |
    | Vorbestellungen                   |      ✓      |
    | Order Buffering                   |      ✓      |
    | Warenkorb-Validierung             |      ✗      |
    | Auto-Snooze ausverkaufter Artikel |      ✗      |
    | Rabatte                           |      ✗      |
    | Trinkgelder                       |      ✗      |
    | Servicegebühr                     |      ✗      |
    | Benutzerdefinierte Bestellnotizen |      ✗      |
    | Lieferdetails                     |      ✓      |
  </Accordion>

  <Accordion title="Pay at Table">
    | Funktion                            | Unterstützt |
    | ----------------------------------- | :---------: |
    | Live-Rechnungssynchronisation       |      ✓      |
    | Zahlungen auf Rechnung anwenden     |      ✓      |
    | Split Payments                      |      ✓      |
    | Zahlungen am POS-Terminal verfolgen |      ✓      |
    | Zu bestehender Rechnung hinzufügen  |      ✓      |
  </Accordion>

  <Accordion title="Venue-Einrichtung">
    | Funktion                          | Unterstützt |
    | --------------------------------- | :---------: |
    | Grundriss-Synchronisation         |      ✓      |
    | Echtzeit-Bestandsaktualisierungen |      ✗      |
    | Multi-Standort-Unterstützung      |      ✓      |
  </Accordion>
</AccordionGroup>


## Related topics

- [POS-Menüsynchronisation](/docs/de/guides/menu/pos-menu-sync.md)
- [Gang-Zuweisungen](/docs/de/guides/menu/course-assignments.md)
- [Order Injection](/docs/de/guides/integrations/pos/order-injection.md)
- [Integrationen – Übersicht](/docs/de/guides/integrations/overview.md)
- [Live-Bestellungen verwalten](/docs/de/guides/orders/managing-live-orders.md)