Lightspeed K-Series

Lightspeed K-Series (voorheen iKentoo) is een uitgebreide POS-integratie die bi-directionele menu-sync, automatische order injection, realtime voorraadupdates, floor plan-sync en pay-at-table-ondersteuning biedt.

​

Vereisten

Voordat je Lightspeed K-Series verbindt, zorg dat je hebt:

• Actief Lightspeed K-Series-abonnement met API-toegang
• Admin-toegang tot je storekit-dashboard
• Je Lightspeed back office-gegevens

​

De verbinding opzetten

​

Stap 1: Autoriseer storekit

De verbinding gebruikt OAuth, dus je autoriseert storekit om toegang te krijgen tot je Lightspeed-account:

1. Ga naar Store Settings > Integrations in je storekit-dashboard
2. Zoek Lightspeed K-Series en klik op Connect
3. Je wordt doorgestuurd naar Lightspeed om in te loggen en toegang te autoriseren
4. Na autorisatie keer je terug naar storekit

​

Stap 2: Selecteer je business location

Na autorisatie selecteer je welke Lightspeed business location je wilt verbinden:

1. storekit toont je beschikbare Lightspeed-businesses
2. Selecteer de business location die matcht met deze vestiging
3. Klik op Connect om de locatie te koppelen

​

Stap 3: Synchroniseer je menu

Zodra verbonden, importeer je je menu uit Lightspeed:

1. Ga naar Menu in je dashboard
2. Klik op Sync Menu
3. Selecteer welk Lightspeed-menu je wilt importeren
4. Wacht tot de sync is voltooid

De sync importeert:

• Categorieën (inclusief subscreens optioneel)
• Producten met namen, beschrijvingen en prijzen
• Menu deals en combo-items
• Modifier-groepen en production instructions
• Allergeneninformatie
• Productafbeeldingen (uit Lightspeed rich content)

​

Stap 4: Configureer integratie-instellingen

Fijnafstemming hoe de integratie zich gedraagt:

​

Native discount codes

Wanneer Native Discounts is ingeschakeld, stuurt storekit kortingscodes direct naar Lightspeed in plaats van een discount SKU-regelitem toe te voegen. Dit vereist:

1. Kortingscodes in storekit moeten een POS-ID-veld gevuld hebben met de matchende Lightspeed discount code-ID
2. De Lightspeed-kortingscode moet geconfigureerd en actief zijn
3. De korting wordt toegepast op alle items in de bestelling op POS-niveau

Als een kortingscode geen POS-ID heeft of de Lightspeed-kortingscode niet wordt gevonden, valt storekit terug op het gebruik van het discount SKU-regelitem.

​

Menu-sync

​

Wat wordt gesynchroniseerd

​

Syncopties

Bestaande content behouden:

• Don’t update images - Behoud handmatig toegevoegde afbeeldingen tijdens sync
• Don’t update descriptions - Behoud handmatig bewerkte beschrijvingen

Subscreens als categorieën: Schakel dit in om Lightspeed-subscreens te behandelen als afzonderlijke categorieën in storekit. Menu load account profile: Specificeer een account profile om menuprijzen te laden die specifiek zijn voor online bestellen. Voorkeurstaal: Selecteer welke taal je wilt gebruiken voor productnamen wanneer er meerdere vertalingen bestaan.

​

Handmatige vs geplande sync

Handmatige sync: Trigger op elk moment vanaf de Menu-pagina na wijzigingen in Lightspeed. Geplande sync: Zet automatische sync op specifieke tijden op:

1. Ga naar Store Settings > Integrations > Lightspeed K-Series
2. Configureer je syncschema
3. Aanbevolen: Plan tijdens rustige uren (bijv. 5 uur ‘s ochtends)

​

Order injection

Wanneer een klant een bestelling plaatst, wordt deze automatisch naar Lightspeed gestuurd.

​

Ordertypes

​

Wat Lightspeed ontvangt

Elke bestelling bevat:

• Alle items met SKU’s en prijzen
• Modifiers (als sub-items of modifier-ID’s)
• Klantnaam, e-mail, telefoon
• Collection code (8 tekens)
• Fulfillment-tijd in ordernotities
• Bezorgadres (voor bezorgorders)
• Tafelnummer (voor ter plaatse-orders)
• Fooien en servicekosten

​

Pre-order buffering

Voor geplande bestellingen kun je bepalen wanneer ze worden geïnjecteerd:

• Directe injectie: Bestelling verstuurd naar POS direct na betaling
• Gebufferde injectie: Bestelling verstuurd X minuten voor de gevraagde tijd

Dit voorkomt dat pre-orders je keukenwachtrij uren van tevoren volproppen.

​

Retry-logica

Als Lightspeed tijdelijk onbereikbaar is:

• storekit probeert opnieuw met exponentiële backoff (tot 6 retries)
• Retry-timing past zich aan op basis van hoe ver weg de bestelling is gepland
• Mislukte bestellingen triggeren e-mailmeldingen naar je vestiging-e-mailadres

​

Realtime voorraadupdates

Lightspeed K-Series ondersteunt realtime voorraadupdates via webhooks:

1. Wanneer je een item als restricted markeert of voorraad bijwerkt in Lightspeed
2. Lightspeed stuurt een webhook naar storekit
3. storekit werkt beschikbaarheid direct bij
4. Menu-cache wordt gewist, zodat klanten actuele beschikbaarheid zien

​

Auto-snooze bij ordermislukking

Als een bestelling mislukt vanwege een sales restriction (item niet beschikbaar), doet storekit automatisch:

1. Snoozet de betreffende items tot 8 uur de volgende dag
2. Logt het snooze-event met source lightspeed
3. Wist de menu-cache
4. Voorkomt verdere bestellingen voor niet-beschikbare items

Alle auto-snooze events worden bijgehouden in het snooze-rapport voor inzicht in voorraadproblemen.

​

Floor plan-sync

Synchroniseer je tafelindeling vanuit Lightspeed voor ter plaatse en pay-at-table:

1. Ga naar Stores → je store → Settings → Integrations → Lightspeed K-Series
2. Onder Fetch Lightspeed Floorplan klik op Sync floorplan en bevestig
3. Areas en tafels worden geïmporteerd met hun Lightspeed-ID’s

Wijzigingen synchroniseren automatisch:

• Nieuwe areas en tafels worden aangemaakt
• Hernoemde tafels worden bijgewerkt
• Verwijderde tafels worden gearchiveerd

​

Pay at table

Lightspeed K-Series ondersteunt volledige pay-at-table-integratie:

​

Hoe het werkt

1. Klant scant QR-code aan tafel
2. storekit haalt de open rekening op uit Lightspeed
3. Klant bekijkt items en selecteert wat te betalen
4. Betaling wordt verwerkt en toegepast op de Lightspeed-rekening
5. Rekeningstatusupdates synchroniseren real-time

​

Configuratie

​

Rekeningsynchronisatie

storekit houdt rekeningen synchroon met Lightspeed:

• Items toegevoegd/verwijderd in Lightspeed worden automatisch bijgewerkt
• Betalingen gedaan op de POS worden weerspiegeld
• Rekeningen verplaatst tussen tafels worden bijgehouden
• Servicekosten en kortingen synchroniseren correct

​

Je integratie testen

​

Pre-launch checklist

1. Menu-sync
   • Alle categorieën correct geïmporteerd
   • Producten hebben correcte namen en prijzen
   • Modifiers verschijnen op de juiste producten
   • Afbeeldingen worden weergegeven (bij gebruik van Lightspeed-afbeeldingen)
2. Orderflow
   • Plaats een testafhaalorder
   • Verifieer dat de bestelling in Lightspeed verschijnt
   • Controleer of items, modifiers en notities correct zijn
   • Bevestig dat collection code verschijnt
3. Voorraadupdates
   • Markeer een item als restricted in Lightspeed
   • Verifieer dat het binnen enkele minuten verdwijnt uit storekit-menu
4. Pay at table (indien gebruikt)
   • Open een rekening in Lightspeed
   • Scan QR-code om rekening te bekijken
   • Voltooi een testbetaling
   • Verifieer dat betaling in Lightspeed verschijnt

​

Troubleshooting

​

Verbinding verlopen

Als je autorisatiefouten ziet:

• De refresh token is mogelijk verlopen
• Ga naar Store Settings > Integrations en autoriseer opnieuw

​

Menu synchroniseert niet

• Zorg dat het menu is gepubliceerd in Lightspeed
• Controleer of producten actief en toegewezen zijn aan categorieën
• Verifieer dat het juiste menu is geselecteerd in storekit
• Controleer op syncfouten in het dashboard

​

Bestellingen verschijnen niet

• Verifieer dat integratie is ingeschakeld (niet alleen verbonden)
• Controleer of account profiles bestaan in Lightspeed
• Zorg dat vereiste SKU’s bestaan (STOREKIT_DELIVERY, STOREKIT_DISCOUNT, enz.)
• Bekijk bestelling in storekit-dashboard voor foutmeldingen

​

Verkeerde items op bestellingen

• Controleer of SKU’s overeenkomen tussen systemen
• Verifieer dat modifier-groepen correct zijn gesynchroniseerd
• Voor menu deals: zorg dat deal-structuur overeenkomt

​

Voorraad wordt niet bijgewerkt

• Verifieer dat webhooks correct zijn geconfigureerd
• Controleer dat de business location is toegevoegd aan de webhook
• Bevestig dat item-SKU’s overeenkomen tussen systemen

Voor verdere hulp, neem contact op met support.

​

Ondersteunde functies