> ## 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 Bestellungen & Routing

> Wie storekit Bestellungen in Lightspeed K-Series einspielt: Kontoprofil-Routing, Zahlungsmethoden, Rabatte, Servicegebühren und Vorbestell-Pufferung.

storekit stellt jede Online-Bestellung für Lightspeed in die Warteschlange, sobald sie aufgegeben wird – Sie müssen sie nicht zuerst annehmen. Vorbestellungen können mit **Buffer Orders** zurückgehalten werden.

## Wie eine Bestellung Lightspeed erreicht

| Bestelltyp | Lightspeed-Bestellung | Zusätzlich übermittelte Details |
| - | - | - |
| Pickup | To-go-Bestellung | Abholcode, Abholzeit im Bestellhinweis |
| Delivery | To-go-Bestellung | Lieferadresse, Liefergebühr-Position, Abholcode, Lieferzeit im Bestellhinweis |
| In Store | Lokale Bestellung | Tischnummer (die Lightspeed-POS-ID des Tisches) |
| Add to Bill | Bestehende Lightspeed-Rechnung | Der Account-Identifier der Rechnung statt einer neuen Bestellung |

Jede Bestellung enthält außerdem Name, E-Mail und Telefonnummer des Kunden, die Artikel mit ihren SKUs und Modifiern, das Trinkgeld und den generierten Bestellhinweis.

> [!NOTE]
>
> Der Abholcode, den Lightspeed anzeigt, ist der storekit-Bestellcode – Lightspeed begrenzt ihn auf 8 Zeichen.

## Routing über Kontoprofile

Unter **Account Profile Codes** auf **Stores** → Ihr Store → **Settings** → **Integrations** → **Lightspeed K-Series** ordnen Sie jedem Fulfillment-Typ ein Lightspeed-Kontoprofil zu. Die vier Zeilen sind fest: **Pickup**, **Delivery**, **In Store** und **Add to Bill**. Jedes Dropdown listet die Kontoprofile aus Ihrem Lightspeed-Standort auf.

Wenn eine Zeile nicht gesetzt ist, sendet storekit den Kontoprofilcode `storekit`, der in Lightspeed existieren muss. Wird eine Bestellung einer bestehenden Rechnung hinzugefügt, hat das **Add to Bill**-Profil Vorrang vor dem Fulfillment-Typ-Profil.

## Zahlung, Rabatte und Gebühren

* **Payment Method** – die Lightspeed-Zahlungsmethode, unter der die Zahlung der Bestellung erfasst wird. Standard ist `STOREKIT`, wenn nichts ausgewählt ist.
* **Send cash payments as paid** – standardmäßig aus: Barzahlungsbestellungen werden ohne angewandte Zahlung gesendet, damit das Personal einen offenen Betrag sieht und beim Kassieren begleicht. Aktivieren Sie es, um Barzahlungsbestellungen bereits als bezahlt zu senden. Karten- und andere vorausbezahlte Bestellungen werden immer als bezahlt gesendet. Siehe [Bar- und Bezahl-bei-Abholung-Bestellungen](/docs/de/guides/payments/cash-payments).
* **Discount Product Code (SKU)** – wird für eine negative Rabattposition verwendet. Hat der storekit-Rabattcode eine **POS ID**, die einem Lightspeed-Rabattcode entspricht, wendet storekit diesen nativen Lightspeed-Rabatt auf die Artikel der Bestellung an, statt die Position hinzuzufügen. Rabatte auf kostenlose Lieferung fügen gar keine Rabattzeile hinzu, weil die 0-€-Lieferposition die entfallene Gebühr bereits abbildet.
* **Service Charge Product Code (SKU)** – Position, die für die Servicegebühr der Bestellung verwendet wird.
* **Delivery Product Code (SKU)** – Position, die für die Liefergebühr bei Lieferbestellungen verwendet wird.
* **Don't send customer email address to Lightspeed** – sendet eine leere E-Mail-Adresse, für Standorte, die keine Kunden-E-Mails im POS haben möchten. Name und Telefonnummer werden weiterhin gesendet.

> [!WARNING]
>
> Diese Produktcodes müssen in Ihrem Lightspeed-Menü existieren. Eine fehlende SKU führt dazu, dass Lightspeed die gesamte Bestellung ablehnt.

Bei Vor-Ort-Bestellungen sendet storekit außerdem für jeden Artikel dessen [Gangnummer](/docs/de/guides/menu/course-assignments), damit Lightspeed die Bestellung nach Gängen abrufen kann.

## Bestellhinweise

**Order Note Template** auf der Lightspeed-Einstellungsseite steuert den Hinweis, der mit jeder Bestellung gesendet wird (bis zu 250 Zeichen). Klicken Sie auf **Insert Variable**, um die verfügbaren Variablen zu sehen, und auf **Preview**, um das Ergebnis mit Beispieldaten zu prüfen. storekit hängt die Abhol- oder Lieferzeit automatisch an den Hinweis an.

## Vorbestell-Pufferung

Standardmäßig wird eine Vorbestellung sofort an Lightspeed gesendet, was die Küche Stunden im Voraus überfüllen kann. Um sie zu verzögern:

1. Aktivieren Sie **Buffer Orders**.
2. Setzen Sie optional **Buffer (in minutes)** (0–720) – die Bestellung wird so viele Minuten vor der gewünschten Fulfillment-Zeit eingespielt.

Wenn **Buffer Orders** aktiviert und **Buffer (in minutes)** leer ist, verwendet storekit die normale Prep-Time-Berechnung des Stores, um zu entscheiden, wann eingespielt wird. Bestellungen ohne gewünschte Zeit werden nie gepuffert.

> [!TIP]
>
> 15–30 Minuten sind ein guter Startwert für eine ausgelastete Küche.

## Add to Bill

Für Vor-Ort-Bestellungen an Tischen in einem Bereich, der Pay at Table akzeptiert, sendet **Add to bill batching for all orders** jede Bestellung auf die offene Lightspeed-Rechnung des Tisches, statt eine separate Bestellung zu erstellen. Das **Add to Bill**-Kontoprofil wird verwendet, und die Zahlung wird nicht an der Bestellung angebracht, weil sie gegen die Rechnung beglichen wird. Siehe [Pay at Table](/docs/de/guides/integrations/pos/lightspeed/pay-at-table).

## Wenn eine Bestellung fehlschlägt

Lightspeed meldet das Ergebnis jeder Bestellung per Webhook:

* **Success** – die Bestellung wird in storekit als **Accepted** markiert und die Lightspeed-Beleg-Referenz gespeichert.
* **Failure** – storekit stellt die Bestellung wieder in die Warteschlange und versucht es erneut. Eine sofortige Bestellung wird nach 5 Versuchen als **Failed** markiert; eine Vorbestellung wird weiter wiederholt, bis ihre gewünschte Zeit nahe rückt, und dann als **Failed** markiert. Sobald die Bestellung als **Failed** markiert ist, wird der Fehlergrund gespeichert, der Store per E-Mail informiert und – falls Drucker im Store vorhanden sind – ein Ticket für die fehlgeschlagene Bestellung gedruckt. Bestellungen, die einer bestehenden Rechnung hinzugefügt werden, sowie Fehler, deren Grund darin liegt, dass der Artikel nicht hinzugefügt werden konnte, werden nicht wiederholt – sie werden beim ersten Fehlschlag als **Failed** markiert.
* Wenn der Fehlergrund eine Verkaufsbeschränkung ist, snoozed storekit außerdem die betroffenen Artikel – siehe [Bestand & Verfügbarkeit](/docs/de/guides/integrations/pos/lightspeed/stock-and-availability).

storekit gibt Lightspeed außerdem eine Frist für das Annehmen der Bestellung, die sich danach richtet, wie weit entfernt eine Vorbestellung liegt: eine Minute für sofortige Bestellungen, bis zu sechs Stunden für Bestellungen, die mehr als eine Woche entfernt sind.

Wenn Lightspeed den Zugriff von storekit ablehnt (ein 403), schlägt die Bestellung mit *"Our access to your Lightspeed account has been disabled, please re-enable the integration user or speak to support"* fehl – siehe [Fehlerbehebung](/docs/de/guides/integrations/pos/lightspeed/troubleshooting).

### Die Failed-Order-E-Mail

Die E-Mail wird einmal gesendet, wenn die Bestellung schließlich als **Failed** markiert wird – nicht bei jedem erneuten Versuch – mit dem Betreff `Lightspeed Issue: Order #<order number> for store: <store name>` und dem Fehlergrund im Text. Sie geht an die **Email address**-Liste des Stores unter **Stores** → Ihr Store → **Settings** → **General** (die erste Adresse als Empfänger, die übrigen als Blindkopien) und an sonst niemanden: Die E-Mail-Adresse, mit der Sie sich am Dashboard anmelden, erhält nichts, es sei denn, sie steht in dieser Liste. Ist die Liste leer, wird keine E-Mail gesendet. Siehe [Ich erhalte keine Failed-Order-E-Mails](/docs/de/guides/integrations/pos/lightspeed/troubleshooting#ich-erhalte-keine-failed-order-e-mails).

Jeder andere Fehlergrund ist Lightspeeds eigene Meldung, wortwörtlich gespeichert. Die drei, die Sie am wahrscheinlichsten sehen, sind *"Not processed before validity ended"* (das Active Device war offline – siehe [Bestellfehler: Kasse offline](/docs/de/guides/integrations/pos/lightspeed/till-offline)), *"…one of the items in the order has a Disconnected status in Lightspeed"* (Lightspeed behandelt einen Artikel der Bestellung nicht als am Standort aktiv – siehe [Fehlerbehebung](/docs/de/guides/integrations/pos/lightspeed/troubleshooting#eine-bestellung-ist-fehlgeschlagen-weil-ein-artikel-in-lightspeed-den-status-disconnected-hat)) und *"Failed to sync order Validation failed for method … placeToGoOrder …"* im Zeitverlauf der Bestellung (Lightspeed hat den Inhalt der Bestellung abgelehnt, bevor sie angenommen wurde, sodass die oben beschriebenen Wiederholungs- und E-Mail-Regeln nie starten – siehe [Fehlerbehebung](/docs/de/guides/integrations/pos/lightspeed/troubleshooting#eine-bestellung-ist-mit-validation-failed-for-method--placetogoorder-fehlgeschlagen)).

## Nächste Schritte

> **[Bestand & Verfügbarkeit](/docs/de/guides/integrations/pos/lightspeed/stock-and-availability)**
>
> Ausverkaufte Artikel vom Menü fernhalten

> **[Pay at Table](/docs/de/guides/integrations/pos/lightspeed/pay-at-table)**
>
> Rechnungen, Zahlungen und Add to Bill


## Related topics

- [Lightspeed Bestand & Verfügbarkeit](/docs/de/guides/integrations/pos/lightspeed/stock-and-availability.md)
- [Toast Bestellungen & Routing](/docs/de/guides/integrations/pos/toast/orders.md)
- [Lightspeed K-Series](/docs/de/guides/integrations/pos/lightspeed/overview.md)
- [Lightspeed Fehlerbehebung](/docs/de/guides/integrations/pos/lightspeed/troubleshooting.md)
- [Bestellfehler: Kasse offline](/docs/de/guides/integrations/pos/lightspeed/till-offline.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.