Lightspeed Bestellungen & Routing

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

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.

​

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

Bei Vor-Ort-Bestellungen sendet storekit außerdem für jeden Artikel dessen Gangnummer, 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.

​

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.

​

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.

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.

​

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. 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), “…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) 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).

​

Nächste Schritte