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

> Verbinden Sie Lightspeed K-Series (ehemals iKentoo) mit storekit für vollständige Menü-Synchronisation, Order Injection, Echtzeit-Bestandsaktualisierungen, Grundriss-Synchronisation und Pay at Table.

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

<Info>
  Jedes storekit-Venue verbindet sich mit einem Lightspeed-Business-Standort. Bei Multi-Standort-Setups verbinden Sie jedes Venue separat.
</Info>

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

| Einstellung                             | Beschreibung                                                                                                                                                                                                                                                                  |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Delivery Fee SKU**                    | SKU für Liefergebühren (Standard: `STOREKIT_DELIVERY`)                                                                                                                                                                                                                        |
| **Discount SKU**                        | SKU für Rabatte (Standard: `STOREKIT_DISCOUNT`)                                                                                                                                                                                                                               |
| **Service Charge SKU**                  | SKU für Servicegebühren (Standard: `STOREKIT_SERVICE_CHARGE`)                                                                                                                                                                                                                 |
| **Payment Method**                      | Zahlungsmethoden-Code für Online-Bestellungen (Standard: `STOREKIT`)                                                                                                                                                                                                          |
| **Buffer Orders**                       | Verzögert die Injection von Vorbestellungen bis näher zur Erfüllungszeit                                                                                                                                                                                                      |
| **Buffer Time**                         | Minuten vor der Vorbestellzeit, zu denen die Bestellung eingespielt wird                                                                                                                                                                                                      |
| **Native Discounts**                    | Verwenden Sie Lightspeed-Rabattcodes statt Discount-SKU-Positionen                                                                                                                                                                                                            |
| **Bargeldzahlungen als bezahlt senden** | Bargeldbestellungen mit bereits angewendeter Zahlung an Lightspeed senden. Deaktivieren Sie diese Option, wenn Personal einen offenen Saldo sehen und beim Bezahlen ausgleichen soll – siehe [Bargeld- und Pay-on-Collection-Bestellungen](/docs/de/guides/payments/cash-payments) |

<Warning>
  Die SKUs müssen in Ihrem Lightspeed-Menü existieren. Erstellen Sie Artikel mit diesen SKUs in Lightspeed, bevor Sie die Integration aktivieren.
</Warning>

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

<Tip>
  Native Rabatte bieten besseres Reporting in Lightspeed und stellen sicher, dass Rabatte konsistent mit Ihren POS-Rabattregeln angewendet werden.
</Tip>

## Menü-Synchronisation

### Was synchronisiert wird

| Daten                  | Synchronisiert               |
| ---------------------- | ---------------------------- |
| Kategorien             | Ja                           |
| Produkte               | Ja                           |
| Preise                 | Ja                           |
| Beschreibungen         | Ja (kann deaktiviert werden) |
| Bilder                 | Ja (kann deaktiviert werden) |
| Modifikatoren          | Ja                           |
| Produktionsanweisungen | Ja (als Modifikatorgruppen)  |
| Menü-Deals             | Ja                           |
| Allergene              | Ja                           |
| Mehrsprachige Inhalte  | Ja                           |

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

| Bestellart | Lightspeed-Endpunkt | Konto-Profil                          |
| ---------- | ------------------- | ------------------------------------- |
| Abholung   | To-Go Order         | Konfigurierbar (Standard: `storekit`) |
| Lieferung  | To-Go Order         | Konfigurierbar (Standard: `storekit`) |
| Vor Ort    | Local Order         | Konfigurierbar (Standard: `storekit`) |

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

<Tip>
  Bei stark frequentierten Venues sollten Sie Vorbestellungen so puffern, dass sie 15–30 Minuten vor dem angeforderten Zeitpunkt eingespielt werden.
</Tip>

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

<Info>
  E-Mail-Benachrichtigungen enthalten den spezifischen Fehlergrund, Bestelldetails und einen direkten Link zur Ansicht der Bestellung in Ihrem Dashboard. So verpassen Sie keine Bestellung, die manuell bearbeitet werden muss.
</Info>

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

| Einstellung                       | Beschreibung                                                                         |
| --------------------------------- | ------------------------------------------------------------------------------------ |
| **PAT Payment Method**            | Zahlungsmethode-Code für Tischzahlungen (Standard: `APM`)                            |
| **Gift Card Payment Method**      | Separate Zahlungsmethode für Geschenkkarten-/Treuezahlungen                          |
| **Kostenlose Artikel ignorieren** | Zeigen Sie Artikel mit Preis Null nicht auf der Rechnung                             |
| **Auto-Close-Bill-Delay**         | Zeit, die gewartet wird, bevor geprüft wird, ob die Rechnung vollständig bezahlt ist |

### 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](/docs/de/getting-started/contact-support).

## Unterstützte Funktionen

<AccordionGroup>
  <Accordion title="Menü-Synchronisation">
    | Funktion                                 | Unterstützt |
    | ---------------------------------------- | :---------: |
    | Automatische Menü-Synchronisation        |      ✓      |
    | Lightweight-Synchronisation (nur Preise) |      ✗      |
    | Produktbilder                            |      ✓      |
    | Allergene                                |      ✓      |
    | Kalorien                                 |      ✓      |
    | Verschachtelte Modifikatoren             |      ✓      |
    | Unterkategorien                          |      ✓      |
    | Kategorieverfügbarkeitszeiten            |      ✗      |
    | Portionen / Größen                       |      ✗      |
    | Gänge                                    |      ✗      |
    | Produktionsanweisungen                   |      ✓      |
    | Menü-Deals                               |      ✓      |
    | Mehrsprachige Inhalte                    |      ✓      |
    | Bestandsstatus                           |      ✓      |
  </Accordion>

  <Accordion title="Bestellungen">
    | Funktion                          | Unterstützt |
    | --------------------------------- | :---------: |
    | Order Injection                   |      ✓      |
    | Vorbestellungen                   |      ✓      |
    | Order Buffering                   |      ✓      |
    | Warenkorb-Validierung             |      ✗      |
    | Auto-Snooze ausverkaufter Artikel |      ✗      |
    | Rabatte                           |      ✓      |
    | Trinkgelder                       |      ✓      |
    | Servicegebühr                     |      ✓      |
    | Benutzerdefinierte Bestellnotizen |      ✗      |
    | Lieferdetails                     |      ✓      |
  </Accordion>

  <Accordion title="Pay at Table">
    | Funktion                            | Unterstützt |
    | ----------------------------------- | :---------: |
    | Live-Rechnungssynchronisation       |      ✓      |
    | Zahlungen auf Rechnung anwenden     |      ✓      |
    | Split Payments                      |      ✓      |
    | Zahlungen am POS-Terminal verfolgen |      ✓      |
    | Zu bestehender Rechnung hinzufügen  |      ✗      |
    | Geschenkkartenzahlungen             |      ✓      |
  </Accordion>

  <Accordion title="Venue-Einrichtung">
    | Funktion                          | Unterstützt |
    | --------------------------------- | :---------: |
    | Grundriss-Synchronisation         |      ✓      |
    | Echtzeit-Bestandsaktualisierungen |      ✓      |
    | Multi-Standort-Unterstützung      |      ✓      |
  </Accordion>
</AccordionGroup>


## Related topics

- [Order Injection](/docs/de/guides/integrations/pos/order-injection.md)
- [Gang-Zuweisungen](/docs/de/guides/menu/course-assignments.md)
- [Integrationen – Übersicht](/docs/de/guides/integrations/overview.md)
- [Live-Bestellungen verwalten](/docs/de/guides/orders/managing-live-orders.md)
- [Modifier als Produkte drucken](/docs/de/guides/menu/print-modifiers-as-products.md)