Lightspeed K-Series

Lightspeed K-Series (ehemals iKentoo) ist eine voll ausgestattete POS-Integration mit bidirektionaler Menü-Synchronisation, automatischer Order Injection, Echtzeit-Bestandsaktualisierungen, Grundriss-Synchronisation und Pay-at-Table-Unterstützung.

​

Voraussetzungen

Bevor Sie Lightspeed K-Series verbinden, stellen Sie sicher, dass Sie über Folgendes verfügen:

• Aktives Lightspeed K-Series-Abonnement mit API-Zugriff
• Admin-Zugriff auf Ihr storekit-Dashboard
• Ihre Lightspeed-Backoffice-Zugangsdaten

​

Verbindung einrichten

​

Schritt 1: storekit autorisieren

Die Verbindung nutzt OAuth, sodass Sie storekit für den Zugriff auf Ihr Lightspeed-Konto autorisieren:

1. Gehen Sie in Ihrem storekit-Dashboard zu Store-Einstellungen > Integrationen
2. Suchen Sie Lightspeed K-Series und klicken Sie auf Verbinden
3. Sie werden zu Lightspeed weitergeleitet, um sich anzumelden und den Zugriff zu autorisieren
4. Nach der Autorisierung kehren Sie zu storekit zurück

​

Schritt 2: Business-Standort auswählen

Nach der Autorisierung wählen Sie aus, welcher Lightspeed-Business-Standort verbunden werden soll:

1. storekit zeigt Ihre verfügbaren Lightspeed-Businesses an
2. Wählen Sie den Business-Standort, der zu diesem Venue passt
3. Klicken Sie auf Verbinden, um den Standort zu verknüpfen

​

Schritt 3: Menü synchronisieren

Sobald die Verbindung besteht, importieren Sie Ihr Menü aus Lightspeed:

1. Gehen Sie in Ihrem Dashboard zu Menü
2. Klicken Sie auf Menü synchronisieren
3. Wählen Sie aus, welches Lightspeed-Menü importiert werden soll
4. Warten Sie, bis der Sync abgeschlossen ist

Der Sync importiert:

• Kategorien (optional inklusive Subscreens)
• Produkte mit Namen, Beschreibungen und Preisen
• Menü-Deals und Kombiartikel
• Modifikatorgruppen und Produktionsanweisungen
• Allergeninformationen
• Produktbilder (aus Lightspeed Rich Content)

​

Schritt 4: Integrationseinstellungen konfigurieren

Verfeinern Sie das Verhalten der Integration:

​

Native Rabattcodes

Wenn Native Discounts aktiviert ist, sendet storekit Rabattcodes direkt an Lightspeed, statt eine Discount-SKU-Position hinzuzufügen. Dies erfordert:

1. Rabattcodes in storekit müssen ein POS-ID-Feld mit der passenden Lightspeed-Rabattcode-ID haben
2. Der Lightspeed-Rabattcode muss konfiguriert und aktiv sein
3. Der Rabatt wird auf alle Artikel der Bestellung auf POS-Ebene angewendet

Wenn ein Rabattcode keine POS-ID hat oder der Lightspeed-Rabattcode nicht gefunden wird, fällt storekit auf die Discount-SKU-Position zurück.

​

Menü-Synchronisation

​

Was synchronisiert wird

​

Sync-Optionen

Bestehende Inhalte beibehalten:

• Bilder nicht aktualisieren – Manuell hinzugefügte Bilder beim Sync behalten
• Beschreibungen nicht aktualisieren – Manuell bearbeitete Beschreibungen behalten

Subscreens als Kategorien: Aktivieren Sie dies, um Lightspeed-Subscreens als separate Kategorien in storekit zu behandeln. Menu-Load-Account-Profil: Geben Sie ein Konto-Profil an, um menüspezifische Preise für Online-Bestellungen zu laden. Bevorzugte Sprache: Wählen Sie, welche Sprache für Produktnamen verwendet werden soll, wenn mehrere Übersetzungen existieren.

​

Manueller vs. geplanter Sync

Manueller Sync: Auslösen jederzeit über die Menü-Seite nach Änderungen in Lightspeed. Geplanter Sync: Richten Sie einen automatischen Sync zu bestimmten Zeiten ein:

1. Gehen Sie zu Store-Einstellungen > Integrationen > Lightspeed K-Series
2. Konfigurieren Sie Ihren Sync-Zeitplan
3. Empfohlen: Planung in Ruhezeiten (z. B. 5 Uhr morgens)

​

Order Injection

Wenn ein Kunde eine Bestellung aufgibt, wird sie automatisch an Lightspeed gesendet.

​

Bestellarten

​

Was Lightspeed empfängt

Jede Bestellung enthält:

• Alle Artikel mit SKUs und Preisen
• Modifikatoren (als Unterartikel oder Modifikator-IDs)
• Kundenname, E-Mail, Telefon
• Abholcode (8 Zeichen)
• Erfüllungszeit in Bestellnotizen
• Lieferadresse (bei Lieferbestellungen)
• Tischnummer (bei Dine-in-Bestellungen)
• Trinkgelder und Servicegebühren

​

Puffer für Vorbestellungen

Bei geplanten Bestellungen können Sie steuern, wann sie eingespielt werden:

• Sofortige Injection: Bestellung wird direkt nach Zahlung an POS gesendet
• Gepufferte Injection: Bestellung wird X Minuten vor dem angeforderten Zeitpunkt gesendet

Dies verhindert, dass Vorbestellungen Ihre Küchen-Warteschlange Stunden im Voraus überlasten.

​

Retry-Logik

Wenn Lightspeed vorübergehend nicht erreichbar ist:

• storekit wiederholt mit exponentiellem Backoff (bis zu 6 Wiederholungen)
• Das Retry-Timing passt sich an, wie weit die Bestellung zeitlich entfernt ist
• Fehlgeschlagene Bestellungen lösen E-Mail-Benachrichtigungen an Ihre Venue-E-Mail-Adresse aus

​

Echtzeit-Bestandsaktualisierungen

Lightspeed K-Series unterstützt Echtzeit-Inventarupdates per Webhook:

1. Wenn Sie einen Artikel als eingeschränkt markieren oder den Bestand in Lightspeed aktualisieren
2. Sendet Lightspeed einen Webhook an storekit
3. storekit aktualisiert die Verfügbarkeit sofort
4. Der Menü-Cache wird geleert, damit Kunden die aktuelle Verfügbarkeit sehen

​

Auto-Snooze bei Bestellfehler

Wenn eine Bestellung aufgrund einer Verkaufseinschränkung (Artikel nicht verfügbar) fehlschlägt, macht storekit automatisch Folgendes:

1. Betroffene Artikel bis 8 Uhr am nächsten Tag pausieren (Snooze)
2. Das Snooze-Ereignis mit Quelle lightspeed protokollieren
3. Den Menü-Cache leeren
4. Weitere Bestellungen für nicht verfügbare Artikel verhindern

Alle Auto-Snooze-Ereignisse werden im Snooze-Bericht erfasst, um Transparenz über Bestandsprobleme zu bieten.

​

Grundriss-Synchronisation

Synchronisieren Sie Ihr Tischlayout von Lightspeed für Dine-in und Pay-at-Table:

1. Gehen Sie zu Stores → Ihrem Store → Einstellungen → Integrationen → Lightspeed K-Series
2. Klicken Sie unter Lightspeed-Grundriss abrufen auf Grundriss synchronisieren und bestätigen Sie
3. Bereiche und Tische werden mit ihren Lightspeed-IDs importiert

Änderungen werden automatisch synchronisiert:

• Neue Bereiche und Tische werden erstellt
• Umbenannte Tische werden aktualisiert
• Entfernte Tische werden archiviert

​

Pay at Table

Lightspeed K-Series unterstützt eine vollständige Pay-at-Table-Integration:

​

Funktionsweise

1. Kunde scannt QR-Code am Tisch
2. storekit ruft die offene Rechnung aus Lightspeed ab
3. Kunde sieht die Positionen und wählt aus, was er bezahlen möchte
4. Zahlung wird verarbeitet und auf die Lightspeed-Rechnung angewendet
5. Der Rechnungsstatus wird in Echtzeit synchronisiert

​

Konfiguration

​

Rechnungssynchronisation

storekit hält Rechnungen mit Lightspeed synchron:

• In Lightspeed hinzugefügte/entfernte Positionen werden automatisch aktualisiert
• Am POS getätigte Zahlungen werden abgebildet
• Zwischen Tischen verschobene Rechnungen werden nachverfolgt
• Servicegebühren und Rabatte werden korrekt synchronisiert

​

Integration testen

​

Checkliste vor dem Start

1. Menü-Sync
   • Alle Kategorien korrekt importiert
   • Produkte haben korrekte Namen und Preise
   • Modifikatoren erscheinen bei den richtigen Produkten
   • Bilder werden angezeigt (bei Nutzung von Lightspeed-Bildern)
2. Bestellablauf
   • Test-Abholbestellung aufgeben
   • Bestellung erscheint in Lightspeed
   • Artikel, Modifikatoren und Notizen sind korrekt
   • Abholcode wird angezeigt
3. Bestandsupdates
   • Artikel in Lightspeed als eingeschränkt markieren
   • Innerhalb weniger Minuten aus dem storekit-Menü verschwunden
4. Pay at Table (falls verwendet)
   • Rechnung in Lightspeed öffnen
   • QR-Code scannen, um die Rechnung anzuzeigen
   • Testzahlung abschließen
   • Zahlung erscheint in Lightspeed

​

Fehlerbehebung

​

Verbindung abgelaufen

Wenn Sie Autorisierungsfehler sehen:

• Das Refresh Token ist möglicherweise abgelaufen
• Gehen Sie zu Store-Einstellungen > Integrationen und erneut autorisieren

​

Menü synchronisiert nicht

• Stellen Sie sicher, dass das Menü in Lightspeed veröffentlicht ist
• Prüfen Sie, ob Produkte aktiv sind und Kategorien zugewiesen wurden
• Überprüfen Sie, ob das richtige Menü in storekit ausgewählt ist
• Prüfen Sie auf Sync-Fehler im Dashboard

​

Bestellungen erscheinen nicht

• Prüfen Sie, ob die Integration aktiviert (nicht nur verbunden) ist
• Prüfen Sie, ob die Konto-Profile in Lightspeed existieren
• Stellen Sie sicher, dass die erforderlichen SKUs existieren (STOREKIT_DELIVERY, STOREKIT_DISCOUNT usw.)
• Prüfen Sie die Bestellung im storekit-Dashboard auf Fehlermeldungen

​

Falsche Artikel in Bestellungen

• Prüfen Sie, ob die SKUs zwischen den Systemen übereinstimmen
• Vergewissern Sie sich, dass Modifikatorgruppen korrekt synchronisiert wurden
• Bei Menü-Deals: Stellen Sie sicher, dass die Deal-Struktur übereinstimmt

​

Bestand wird nicht aktualisiert

• Prüfen Sie, ob Webhooks korrekt konfiguriert sind
• Prüfen Sie, ob der Business-Standort dem Webhook hinzugefügt wurde
• Bestätigen Sie, dass Artikel-SKUs zwischen den Systemen übereinstimmen

Für weitere Unterstützung kontaktieren Sie den Support.

​

Unterstützte Funktionen