> ## 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.
# Lightspeed K-Series
> Verbind Lightspeed K-Series (voorheen iKentoo) met storekit voor volledige menu-sync, order injection, realtime voorraadupdates, floor plan-sync en pay at table.
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
Elke storekit-vestiging verbindt met één Lightspeed business location. Voor multi-locatie-setups verbind je elke vestiging afzonderlijk.
### 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:
| Instelling | Beschrijving |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Delivery Fee SKU** | SKU voor bezorgkosten (standaard: `STOREKIT_DELIVERY`) |
| **Discount SKU** | SKU voor kortingen (standaard: `STOREKIT_DISCOUNT`) |
| **Service Charge SKU** | SKU voor servicekosten (standaard: `STOREKIT_SERVICE_CHARGE`) |
| **Payment Method** | Betaalmethode-code voor online bestellingen (standaard: `STOREKIT`) |
| **Buffer Orders** | Vertraag pre-order-injectie tot dichter bij fulfillment-tijd |
| **Buffer Time** | Minuten voor pre-order-tijd om de bestelling te injecteren |
| **Native Discounts** | Gebruik Lightspeed-kortingscodes in plaats van discount SKU-regelitems |
| **Send cash payments as paid** | Stuur cashbestellingen naar Lightspeed met de betaling reeds toegepast. Laat uit als personeel een open saldo moet zien en het moet settelen wanneer de klant betaalt — zie [cash- en pay-on-collection-bestellingen](/docs/nl/guides/payments/cash-payments) |
De SKU's moeten bestaan in je Lightspeed-menu. Maak items met deze SKU's in Lightspeed aan voordat je de integratie inschakelt.
### 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.
Native discounts bieden betere rapportage in Lightspeed en zorgen ervoor dat kortingen consistent worden toegepast met je POS-kortingsregels.
## Menu-sync
### Wat wordt gesynchroniseerd
| Data | Gesynchroniseerd |
| ----------------------- | ----------------------------- |
| Categorieën | Ja |
| Producten | Ja |
| Prijzen | Ja |
| Beschrijvingen | Ja (kan worden uitgeschakeld) |
| Afbeeldingen | Ja (kan worden uitgeschakeld) |
| Modifiers | Ja |
| Production instructions | Ja (als modifier-groepen) |
| Menu deals | Ja |
| Allergenen | Ja |
| Meertalige content | Ja |
### 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
| Ordertype | Lightspeed-endpoint | Account profile |
| ----------- | ------------------- | --------------------------------------- |
| Afhalen | To-Go Order | Configureerbaar (standaard: `storekit`) |
| Bezorging | To-Go Order | Configureerbaar (standaard: `storekit`) |
| Ter plaatse | Local Order | Configureerbaar (standaard: `storekit`) |
### 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.
Voor drukke vestigingen, buffer pre-orders om 15-30 minuten voor de gevraagde tijd te injecteren.
### 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
E-mailmeldingen bevatten de specifieke foutreden, orderdetails en een directe link om de bestelling in je dashboard te bekijken. Zo mis je nooit een bestelling die handmatige aandacht nodig heeft.
## 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
| Instelling | Beschrijving |
| ---------------------------- | ---------------------------------------------------------------------- |
| **PAT Payment Method** | Betaalmethode-code voor tafelbetalingen (standaard: `APM`) |
| **Gift Card Payment Method** | Aparte betaalmethode voor cadeaubon/loyalty-betalingen |
| **Ignore Free Items** | Toon geen items met prijs nul op de rekening |
| **Auto-close Bills Delay** | Tijd om te wachten voor te controleren of rekening volledig is betaald |
### 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](/docs/nl/getting-started/contact-support).
## Ondersteunde functies
| Functie | Ondersteund |
| ---------------------------------- | :---------: |
| Automatische menu-sync | ✓ |
| Lichtgewicht sync (alleen prijzen) | ✗ |
| Productafbeeldingen | ✓ |
| Allergenen | ✓ |
| Calorieën | ✓ |
| Geneste modifiers | ✓ |
| Subcategorieën | ✓ |
| Categorie-beschikbaarheidsuren | ✗ |
| Portions / sizes | ✗ |
| Courses | ✗ |
| Production instructions | ✓ |
| Menu deals | ✓ |
| Meertalige content | ✓ |
| Voorraadstatus | ✓ |
| Functie | Ondersteund |
| ------------------------------ | :---------: |
| Order injection | ✓ |
| Pre-orders | ✓ |
| Order buffering | ✓ |
| Basketvalidatie | ✗ |
| Auto-snooze uitverkochte items | ✗ |
| Kortingen | ✓ |
| Fooien | ✓ |
| Servicekosten | ✓ |
| Aangepaste ordernotities | ✗ |
| Bezorgdetails | ✓ |
| Functie | Ondersteund |
| -------------------------------- | :---------: |
| Live rekeningsync | ✓ |
| Betalingen toepassen op rekening | ✓ |
| Gesplitste betalingen | ✓ |
| POS-terminalbetalingen volgen | ✓ |
| Toevoegen aan bestaande rekening | ✗ |
| Cadeaubonbetalingen | ✓ |
| Functie | Ondersteund |
| --------------------------------------- | :---------: |
| Floor plan-sync | ✓ |
| Realtime voorraadupdates | ✓ |
| Ondersteuning voor meerdere vestigingen | ✓ |
## Related topics
- [Order injection](/docs/nl/guides/integrations/pos/order-injection.md)
- [Gangtoewijzingen](/docs/nl/guides/menu/course-assignments.md)
- [Overzicht van integraties](/docs/nl/guides/integrations/overview.md)
- [Live bestellingen beheren](/docs/nl/guides/orders/managing-live-orders.md)
- [Modifiers afdrukken als producten](/docs/nl/guides/menu/print-modifiers-as-products.md)