TISSL

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

​

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:

​

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

​

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

​

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

​

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

​

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.

​

Ondersteunde functies