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

> Verbind TISSL POS met storekit voor order injection en pay-at-table met handmatige productkoppeling. Stuur online bestellingen direct naar je bestaande TISSL-kassa's.

De TISSL-integratie maakt automatische order injection naar je TISSL POS en volledige pay-at-table-functionaliteit mogelijk. In tegenstelling tot menu-sync-integraties gebruikt TISSL handmatige productkoppeling via Product-ID's (PLU's) — je bouwt je menu in storekit en koppelt producten aan hun TISSL-tegenhangers.

## Vereisten

Voordat je TISSL opzet:

* Actief TISSL POS-systeem
* TISSL API Key
* TISSL Organisation ID
* Lijst van Product-ID's voor je menu-items
* Admin-toegang tot je storekit-dashboard

<Note>
  Neem contact op met TISSL-support om je API Key en Organisation ID te verkrijgen. Deze zijn vereist voor de integratie.
</Note>

## De verbinding opzetten

### Stap 1: Verbind TISSL

1. Ga naar **Store Settings > Integrations** in je storekit-dashboard
2. Zoek **TISSL** en klik op **Connect**
3. Voer je TISSL-gegevens in:
   * **API Key** - Je TISSL API-authenticatiesleutel
   * **Organisation ID** - Je TISSL-organisatie-identifier
4. Klik op **Connect**

storekit verifieert de gegevens door je TISSL-live-status te controleren voor het opslaan.

### Stap 2: Selecteer je site

Na authenticatie:

1. storekit kan beschikbare sites ophalen uit je TISSL-organisatie
2. Selecteer de site die overeenkomt met deze storekit-vestiging
3. De Site ID wordt opgeslagen voor order routing

### Stap 3: Configureer integratie-instellingen

Configureer de vereiste TISSL-instellingen:

| Instelling               | Beschrijving                             |
| ------------------------ | ---------------------------------------- |
| **Order Type**           | TISSL-ordertype voor online bestellingen |
| **Payment Type**         | Betaaltype voor betaalde bestellingen    |
| **Course**               | Standaard course voor alle items         |
| **Delivery Fee Product** | Product-ID voor bezorgkosten             |
| **Discount Product**     | Product-ID/naam voor kortingsregelitems  |
| **Service Charge**       | Servicekostenbedrag of -percentage       |

<Warning>
  Order Type, Payment Type, Course en product-ID's moeten bestaan in je TISSL-systeem. Verifieer deze instellingen voordat je live gaat.
</Warning>

### Stap 4: Koppel producten

Voor elk product in je storekit-menu:

1. Ga naar **Menu** en selecteer een product
2. Zoek het **POS ID**-veld
3. Voer de exacte Product-ID uit TISSL in
4. Sla het product op

Herhaal voor alle producten en modifiers.

## Hoe productkoppeling werkt

TISSL gebruikt **handmatige koppeling** — producten worden niet automatisch gesynchroniseerd:

1. Je maakt je menu in storekit
2. Je voert de TISSL Product-ID voor elk item in
3. Wanneer bestellingen worden geplaatst, stuurt storekit de Product-ID's
4. TISSL matcht ID's aan producten en verwerkt de bestelling

Dit geeft je volledige controle over de online menu-presentatie met behoud van POS-compatibiliteit.

### Modifiers koppelen

Modifiers vereisen zowel Product-ID als Group-ID:

1. Ga naar je modifier-groepen in storekit
2. Voer voor elke modifier-groep de TISSL **Group Name/ID** in
3. Voer voor elke modifier-optie de TISSL **Product-ID** in
4. Sla wijzigingen op

storekit stuurt modifiers in het formaat dat TISSL verwacht:

* `modifierGroups`: Array van groepsnamen
* `modifiers`: Array met groepsnaam en modifier-naam-paren

## Order injection

Wanneer een klant een bestelling plaatst, stuurt storekit deze naar TISSL's `/order`-endpoint.

### Orderkanalen

| Fulfillment | TISSL-kanaal    |
| ----------- | --------------- |
| Ter plaatse | Pay At Table    |
| Afhalen     | Click & Collect |
| Bezorging   | Delivery        |

### Wat TISSL ontvangt

Elke bestelling bevat:

* Organisation ID en Site ID
* Externe order-ID (storekit order-ID)
* Orderbeschrijving (ordercode of tafelnummer)
* Aantal klanten
* Ordertype
* Servicekosteninstellingen
* Alle items met:
  * Product-ID
  * Hoeveelheid
  * Bruto- en nettoprijzen
  * Course-toewijzing
  * Itemnotities
  * Modifier-groepen en modifiers
* Betalingsitems (voor niet-cashbestellingen)
* Klantgegevens met adres
* Ordernotities

### Pre-order buffering

Voor geplande bestellingen kun je buffering inschakelen:

* **Buffer Orders** - Schakel in om order-injectie te vertragen
* Bestellingen worden vastgehouden tot dichter bij de fulfillment-tijd
* Jitter wordt toegevoegd om te voorkomen dat gelijktijdige bestellingen mislukken

<Info>
  TISSL kan gelijktijdige bestellingen voor hetzelfde bedrag laten vallen. De jitter (gerandomiseerde vertraging op basis van order-ID) helpt dit te voorkomen.
</Info>

### Bezorgkosten & kortingen

Indien van toepassing voegt storekit regelitems toe voor:

* **Bezorgkosten**: Gebruikt het geconfigureerde Delivery Fee Product-ID
* **Kortingen**: Gebruikt het geconfigureerde Discount Product-ID met negatieve prijs

### Toevoegen aan bestaande rekening

Voor ter plaatse-bestellingen controleert storekit op een bestaande rekening aan de tafel:

* Indien gevonden, wordt de bestelling toegevoegd aan de bestaande rekening
* Anders wordt een nieuwe rekening aangemaakt

Configureer **All Orders Add To Bill** om dit gedrag te regelen.

## Pay at table

TISSL ondersteunt volledige pay-at-table-integratie:

### Hoe het werkt

1. Klant scant QR-code aan tafel
2. storekit haalt de open rekening op uit TISSL via `/order/table/{tableId}/{orgId}/{siteId}`
3. Klant bekijkt items en selecteert wat te betalen
4. Betaling wordt verwerkt en naar TISSL gestuurd via `/order/payment`
5. Rekeningstatus synchroniseert real-time

### Rekeningsynchronisatie

storekit houdt rekeningen synchroon met TISSL:

* Items toegevoegd/verwijderd in TISSL worden automatisch bijgewerkt
* Betalingen gedaan op de POS worden gevolgd
* Rekeningen verplaatst tussen tafels worden gevolgd
* Servicekosten en kortingen synchroniseren correct
* Belastingregels zijn per item gesynchroniseerd

### Configuratie

| Instelling                 | Beschrijving                                             |
| -------------------------- | -------------------------------------------------------- |
| **Payment Type**           | Betaaltype voor storekit-betalingen                      |
| **Ignore Free Items**      | Toon geen items met prijs nul op de rekening             |
| **Auto-close Bills Delay** | Tijd voor te controleren of rekening volledig is betaald |

## Tafel-sync

Haal je tafelindeling op uit TISSL:

1. Ga naar **Stores** → je store → **Settings** → **Integrations** → **Tissl**
2. Klik op **Sync floorplan** en bevestig
3. Trading zones en places worden geïmporteerd als areas en tafels

Tafels bevatten:

* Zone-/area-naam en -ID
* Tafelnaam en -ID
* Capaciteit
* Actieve status

## Referentie integratie-instellingen

| Instelling                 | Beschrijving                                             | Standaard              |
| -------------------------- | -------------------------------------------------------- | ---------------------- |
| **Order Type**             | TISSL-ordertype-object                                   | Vereist                |
| **Payment Type**           | Betaaltype voor online bestellingen                      | Vereist                |
| **Course**                 | Standaard course voor items                              | No Course              |
| **Delivery Fee**           | Product voor bezorgkosten                                | Vereist voor bezorging |
| **Discount**               | Product/naam voor kortingen                              | Vereist voor kortingen |
| **Service Charge**         | Bedrag of percentage                                     | 0                      |
| **Buffer Orders**          | Vertraag pre-order-injectie                              | false                  |
| **Remove Email**           | Verstuur geen klant-e-mail                               | false                  |
| **All Orders Add To Bill** | Voeg ter plaatse-bestellingen toe aan bestaande rekening | false                  |
| **Ignore Free Items**      | Verberg gratis items in rekeningweergave                 | false                  |
| **Order Note Template**    | Custom template voor ordernotities                       | Geen                   |

## Je integratie testen

### Pre-launch checklist

1. **Verbinding**
   * [ ] API Key en Organisation ID geverifieerd
   * [ ] Site correct geselecteerd

2. **Configuratie**
   * [ ] Order Type bestaat in TISSL
   * [ ] Payment Type geconfigureerd
   * [ ] Course toegewezen
   * [ ] Delivery Fee-product aangemaakt (indien bezorging gebruikt)
   * [ ] Discount-product aangemaakt (indien kortingen gebruikt)

3. **Productkoppeling**
   * [ ] Alle producten hebben TISSL Product-ID's
   * [ ] Alle modifiers hebben Product-ID's
   * [ ] Modifier-groepen hebben Group Names

4. **Orderflow**
   * [ ] Plaats testbestelling
   * [ ] Verifieer dat items correct verschijnen in TISSL
   * [ ] Controleer dat modifiers correct worden weergegeven
   * [ ] Bevestig dat prijzen overeenkomen

5. **Pay at table** (indien gebruikt)
   * [ ] Tafels gesynchroniseerd
   * [ ] Open rekening in TISSL
   * [ ] Bekijk rekening via storekit
   * [ ] Voltooi testbetaling

## Troubleshooting

### Verbinding mislukt

* Verifieer dat API Key correct en actief is
* Controleer of Organisation ID overeenkomt met je account
* Bevestig dat TISSL-systeem online is (live status check)

### Bestellingen verschijnen niet

* Verifieer dat integratie is ingeschakeld
* Controleer of Site ID correct is
* Bekijk bestelling in dashboard voor foutmeldingen
* Bevestig dat Order Type en Payment Type bestaan in TISSL

### Ontbrekende items

* Controleer of Product-ID's correct zijn ingevoerd
* Verifieer dat producten bestaan in TISSL
* Items zonder Product-ID's worden overgeslagen met een waarschuwing

### Modifier-problemen

* Zorg dat modifier-groepen Group Names/ID's hebben
* Verifieer dat modifier-Product-ID's bestaan in TISSL
* Controleer modifier-groep-associatie

### Verkeerde prijzen

* Prijzen worden berekend inclusief modifiers
* Verifieer dat belastinginstellingen overeenkomen (storekit stuurt bruto en netto)
* Controleer configuratie servicekosten

### Pay at table-fouten

* **"no\_open\_bills"**: Geen actieve rekening aan die tafel in TISSL
* **"already\_exists"**: Rekening al verwerkt/gesloten
* Controleer dat table POS-ID overeenkomt met TISSL table-ID

## Beperkingen

Met TISSL-integratie:

* **Geen automatische menu-sync**: Bouw menu in storekit, koppel aan TISSL-ID's
* **Geen realtime voorraad-sync**: Beschikbaarheid beheerd in storekit
* **Handmatige productmapping**: Onderhoud ID-mappings voor alle items

Voor verdere hulp, [neem contact op met support](/docs/nl/getting-started/contact-support).

## Ondersteunde functies

<AccordionGroup>
  <Accordion title="Menu Sync">
    | Functie                     | Ondersteund |
    | --------------------------- | :---------: |
    | Automatische menu-sync      |      ✗      |
    | Handmatige productkoppeling |      ✓      |

    TISSL gebruikt handmatige productkoppeling. Maak je menu in storekit en voer de TISSL Product-ID voor elk item in.
  </Accordion>

  <Accordion title="Bestellingen">
    | Functie                        | Ondersteund |
    | ------------------------------ | :---------: |
    | Order injection                |      ✓      |
    | Pre-orders                     |      ✓      |
    | Order buffering                |      ✓      |
    | Basketvalidatie                |      ✗      |
    | Auto-snooze uitverkochte items |      ✗      |
    | Kortingen                      |      ✗      |
    | Fooien                         |      ✗      |
    | Servicekosten                  |      ✗      |
    | Aangepaste ordernotities       |      ✗      |
    | Bezorgdetails                  |      ✓      |
  </Accordion>

  <Accordion title="Pay at Table">
    | Functie                          | Ondersteund |
    | -------------------------------- | :---------: |
    | Live rekeningsync                |      ✓      |
    | Betalingen toepassen op rekening |      ✓      |
    | Gesplitste betalingen            |      ✓      |
    | POS-terminalbetalingen volgen    |      ✓      |
    | Toevoegen aan bestaande rekening |      ✓      |
  </Accordion>

  <Accordion title="Venue-setup">
    | Functie                                 | Ondersteund |
    | --------------------------------------- | :---------: |
    | Floor plan-sync                         |      ✓      |
    | Realtime voorraadupdates                |      ✗      |
    | Ondersteuning voor meerdere vestigingen |      ✓      |
  </Accordion>
</AccordionGroup>


## Related topics

- [Gangtoewijzingen](/docs/nl/guides/menu/course-assignments.md)
- [POS Menu Sync](/docs/nl/guides/menu/pos-menu-sync.md)
- [Order injection](/docs/nl/guides/integrations/pos/order-injection.md)
- [Overzicht van integraties](/docs/nl/guides/integrations/overview.md)
- [Live bestellingen beheren](/docs/nl/guides/orders/managing-live-orders.md)