Lightspeed Fehlerbehebung

Häufige Lightspeed-K-Series-Probleme und wie Sie sie beheben. Wenn Sie immer noch nicht weiterkommen, wenden Sie sich an den storekit-Support.

​

Verbindung

​

„Lightspeed K-Series” erscheint nicht in meiner Integrations-Liste

Die Integration ist für Ihren Account nicht aktiviert. Wenden Sie sich an den Support, um sie freischalten zu lassen.

​

Bestellungen schlagen mit „Our access to your Lightspeed account has been disabled” fehl

Lightspeed lehnt den Zugriff von storekit ab. Meist wurde der Integration-Nutzer in Lightspeed deaktiviert oder seine Berechtigungen wurden geändert – reaktivieren Sie ihn im Lightspeed-Back-Office, klicken Sie dann auf Disconnect Auth und erneut auf Connect to Lightspeed unter Stores → Ihr Store → Settings → Integrations → Lightspeed K-Series.

​

Ich habe den falschen Lightspeed-Standort verbunden

Klicken Sie auf Disconnect Auth, dann auf Connect to Lightspeed und wählen Sie auf dem Bildschirm Select your Lightspeed location: den richtigen Standort aus.

​

Menü-Sync

​

Es gibt keinen Sync-Button am Menü

Die Connected to Lightspeed-Leiste (mit View in POS und Sync) erscheint nur, wenn der POS-Provider des Stores Lightspeed ist und das Menü mit einem Lightspeed-Menü verknüpft ist. Wählen Sie das Menü in Lightspeed Menu auf der Lightspeed-Einstellungsseite aus und klicken Sie auf Save.

​

Der Sync bricht mittendrin ab

Der Fortschrittsbalken zeigt die Phase, in der es fehlgeschlagen ist. Häufige Ursachen:

• Das Menü existiert in Lightspeed nicht mehr oder ist am verbundenen Standort nicht mehr verfügbar – wählen Sie es unter Lightspeed Menu erneut aus.
• Die Autorisierung ist abgelaufen oder wurde widerrufen – erneut verbinden (siehe oben).
• Das Kontoprofil in Specify account profile when syncing menu existiert in Lightspeed nicht mehr – setzen Sie es auf No profile zurück oder wählen Sie ein aktuelles.

​

Einige Artikel wurden nicht importiert

• Artikel, deren Lightspeed-Preisstrategie den Preis positiv, negativ oder als Prozentsatz des Gesamtwerts festlegt, werden bewusst übersprungen – sie haben keinen festen Preis zum Importieren.
• Artikel innerhalb von Sub-Screens landen in der übergeordneten Kategorie, sofern Import Sub-screens as categories nicht aktiviert ist.
• Produkte in der Menu Entry Group integration (die storekit-Liefer-, -Rabatt- und -Servicegebühren-Produkte) werden absichtlich übersprungen.

​

Namen oder Beschreibungen sind in der falschen Sprache

Setzen Sie Language auf das gewünschte Lightspeed-Locale. storekit greift auf en zurück für Artikel, die keinen Text in diesem Locale haben.

​

Meine storekit-Bilder oder -Beschreibungen wurden überschrieben

Aktivieren Sie Don’t update menu images und Don’t update menu description. Alles andere im Menü wird bei jedem Sync aus Lightspeed neu geschrieben.

​

Bestellungen

​

Bestellungen schlagen mit „Not processed before validity ended” fehl

Das Lightspeed Active Device – Ihr Master-iPad – war nicht online, um die Bestellung entgegenzunehmen. Die vollständige Checkliste und wie Sie die Bestellung erneut senden, finden Sie unter Bestellfehler: Kasse offline. Wird das erneute Senden mit „This order has already been sent to the POS” abgelehnt, hat Lightspeed die Bestellung angenommen, die Kasse hat sie aber nie gedruckt – folgen Sie den Schritten, statt erneut auf Resend order to POS zu klicken.

​

Bestellungen erreichen Lightspeed überhaupt nicht

• Prüfen Sie, dass Integration Status eingeschaltet ist – das Label sollte Enabled - sending orders to Lightspeed anzeigen.
• Prüfen Sie, ob der Store mit dem richtigen Standort verknüpft ist.
• Öffnen Sie die Bestellung in storekit und lesen Sie den dort erfassten Fehlergrund.

​

Bestellungen werden sofort nach dem Senden abgelehnt

• Der Kontoprofilcode muss in Lightspeed existieren. Wenn eine Zeile unter Account Profile Codes leer ist, sendet storekit storekit – legen Sie entweder dieses Profil in Lightspeed an oder wählen Sie ein echtes für Pickup, Delivery, In Store und Add to Bill.
• Die Liefer-, Rabatt- und Servicegebührenprodukte müssen in Lightspeed mit den SKUs existieren, die in Delivery Product Code (SKU), Discount Product Code (SKU) und Service Charge Product Code (SKU) gesetzt sind (Standardwerte: STOREKIT_DELIVERY, STOREKIT_DISCOUNT, STOREKIT_SERVICE_CHARGE). Eine fehlende SKU lässt die gesamte Bestellung scheitern.
• Artikel-SKUs müssen weiterhin übereinstimmen. Synchronisieren Sie das Menü nach Änderungen an SKUs in Lightspeed erneut.

​

Eine Bestellung ist fehlgeschlagen, weil ein Artikel in Lightspeed den Status Disconnected hat

Der Fehlergrund lautet “…one of the items in the order has a Disconnected status in Lightspeed”. Das ist Lightspeeds eigene Meldung, wortwörtlich an der Bestellung gespeichert: Lightspeed hat die Bestellung abgelehnt, weil es einen der Artikel nicht als aktiven, bestellbaren Artikel am verbundenen Business Location behandelt. Der Fall, den der storekit-Support gesehen hat, betraf einen Artikel, der neu in Lightspeed angelegt und vom Menü-Sync des Vortags importiert worden war. Es handelt sich nicht um den Kasse-offline-Fehler. Am iPad muss nichts unternommen werden – ziehen Sie Bestellfehler: Kasse offline nur heran, wenn der Grund “Not processed before validity ended” lautet.

​

Eine Bestellung ist mit “Validation failed for method … placeToGoOrder” fehlgeschlagen

Der Zeitverlauf der Bestellung zeigt “Failed to sync order Validation failed for method=‘public com.ikentoo.ape.dto.SubmissionResponseDto com.ikentoo.ape.controllers.OrderSubmissionController.placeToGoOrder(com.lightspeedhq.ape.dto.rest.ToGoOrder)’. Error count: N”. Das ist Lightspeeds eigene Antwort, wortwörtlich gespeichert: Lightspeed hat sich geweigert, die Bestellung überhaupt anzunehmen, weil etwas in dem, was storekit gesendet hat – die Kundendaten, ein Artikel- oder Modifikator-Code, die Business Location oder die Zahlungszeile – die Prüfungen nicht bestanden hat. Error count ist die Anzahl der beanstandeten Felder. Es ist nicht der Kasse-offline-Fehler. Die Bestellung hat das iPad nie erreicht, also ändert ein Neustart der Lightspeed-App oder ein Neuladen des iPads nichts, und ein Klick auf More actions → Resend order to POS ohne Änderungen sendet denselben Inhalt und schlägt auf dieselbe Weise fehl. Da Lightspeed die Bestellung nie angenommen hat, laufen die in Wenn eine Bestellung fehlschlägt beschriebenen Wiederholungs- und Failed-Order-E-Mail-Regeln nicht – die Ablehnung wird im Zeitverlauf der Bestellung protokolliert und die Bestellung wird auf der Kasse nicht gedruckt. Prüfen Sie vor dem erneuten Senden Folgendes:

• Ein Artikel in der Bestellung existiert nur in storekit. Ein per Hand in storekit hinzugefügter Artikel oder Modifikator hat keinen Lightspeed-Code, sodass Lightspeed die Bestellung ablehnt. Legen Sie den Artikel zuerst im Lightspeed-Menü an, mit dem der Store verbunden ist, öffnen Sie dann das Menü unter Menus und klicken Sie in der Leiste Connected to Lightspeed auf Sync, damit storekit den Code übernimmt, und senden Sie die Bestellung dann erneut. Eine Synchronisierung allein entfernt storekit-only-Artikel, statt sie in Lightspeed anzulegen – siehe Menü-Synchronisierung.
• Ein Modifikator- oder Artikel-Code existiert in Lightspeed nicht mehr. Wenn er seit der letzten Synchronisierung in Lightspeed gelöscht, neu erstellt oder mit einer geänderten SKU versehen wurde, synchronisieren Sie das Menü erneut, damit storekit den aktuellen Code sendet. Die Liefer-, Rabatt- und Service-Charge-SKUs unter Delivery Product Code (SKU), Discount Product Code (SKU) und Service Charge Product Code (SKU) müssen ebenfalls weiterhin in Lightspeed existieren.
• Die Telefonnummer des Kunden. storekit übergibt die Telefonnummer des Kunden an Lightspeed in dem Feld, das Lightspeed für Nummern im internationalen Format (E.164) reserviert. Wenn die Ablehnung ein Kundendatenfeld betrifft, bitten Sie den Support zu prüfen, ob die Nummer der Bestellung das ist, was Lightspeed beanstandet hat.

Wenn das erneute Senden mit demselben Grund fehlschlägt, nachdem das Menü neu synchronisiert wurde, wenden Sie sich an den storekit-Support und geben Sie die Bestellnummer an. storekit speichert bei der Bestellung nur die Zusammenfassungszeile von Lightspeed; die feldweisen Details dazu, was Lightspeed abgelehnt hat, werden in unseren Logs vorgehalten, und der Support kann diese lesen und Ihnen sagen, welcher Artikel oder welches Feld zu korrigieren ist.

​

Eine Bestellung ist fehlgeschlagen, weil ein Artikel beschränkt ist

Lightspeed hat die Bestellung wegen einer Verkaufsbeschränkung abgelehnt. storekit snoozed die betroffenen Artikel bis 8 Uhr des nächsten Tages und benachrichtigt den Store per E-Mail. Prüfen Sie den Bestand oder die Beschränkung des Artikels in Lightspeed und heben Sie die Snooze dann in storekit auf.

​

Bestellungen schlagen fehl und werden nicht mehr wiederholt

storekit sendet eine sofortige Bestellung insgesamt bis zu 5 Mal (die ursprüngliche Übermittlung plus vier Wiederholungen), bevor sie als Failed markiert wird. Eine Vorbestellung wird so lange wiederholt, wie ihre gewünschte Zeit noch etwas entfernt ist, sodass eine Vorbestellung für später am Tag alle paar Minuten fehlschlagen, wiederholt werden und erneut fehlschlagen kann, bis sie schließlich kurz vor Fälligkeit als Failed markiert wird. Bestellungen, die einer bestehenden Rechnung hinzugefügt werden, sowie Fehler, die als „Artikel nicht hinzufügbar” gemeldet werden, werden gar nicht wiederholt. Ist die Ursache behoben, senden Sie die Bestellung mit More actions → Resend order to POS erneut.

​

Ich erhalte keine Failed-Order-E-Mails

Bestellungen erscheinen im Dashboard als Failed, aber es kommt keine E-Mail an. Prüfen Sie diese Punkte der Reihe nach:

1. Die E-Mail-Adressen des Stores. Die Failed-Order-E-Mail geht ausschließlich an die Adressen unter Email address auf Stores → Ihr Store → Settings → General – die erste Adresse ist der Empfänger, die übrigen sind Blindkopien. An die E-Mail-Adresse, mit der Sie sich am Dashboard anmelden, an den Account-Inhaber oder an andere Mitarbeitende wird nichts gesendet, sofern deren Adresse nicht in dieser Liste steht. Ist die Liste leer, wird gar keine E-Mail gesendet. Tragen Sie die Adressen ein, die informiert werden sollen, und klicken Sie auf Save. Es gibt im Dashboard keine separate Einstellung dafür, wer Failed-Order-E-Mails erhält.
2. Die Bestellung ist noch nicht endgültig fehlgeschlagen. Die E-Mail wird einmal gesendet, wenn storekit die Wiederholungen einstellt und die Bestellung als Failed markiert. Sie wird nicht bei jedem einzelnen fehlgeschlagenen Versuch gesendet. Eine sofortige Bestellung wird nach dem 5. Fehlschlag per E-Mail gemeldet; eine Vorbestellung wird bis kurz vor ihrer gewünschten Zeit wiederholt, sodass eine Bestellung, die als „wiederholend” angezeigt wird, oder eine Vorbestellung für später am Tag noch nicht per E-Mail gemeldet wurde. Bestellungen, die einer bestehenden Rechnung hinzugefügt werden, sowie „Artikel konnte nicht hinzugefügt werden”-Fehler werden beim ersten Fehlschlag per E-Mail gemeldet, weil sie nicht wiederholt werden.
3. Ihr Spam-Ordner und der Absender. Die E-Mail kommt von der Absenderadresse Ihres storekit-Partners mit dem Betreff Lightspeed Issue: Order #<order number> for store: <store name>.

Die “Lightspeed Not Ready”-E-Mail ist eine andere Nachricht mit eigenen Regeln – siehe Der Store schließt sich immer wieder selbst und Bestellbereitschaft. Sie ist bewusst auf eine E-Mail pro Store alle 30 Minuten begrenzt und wird nicht gesendet, während Ihre Öffnungszeiten den Store als geschlossen ausweisen, sodass eine Häufung von Bereitschaftsfehlern keine Flut von E-Mails auslöst und über Nacht keine ankommen. Während Sie die E-Mails in Ordnung bringen, sind die Fehlschläge immer im Dashboard sichtbar:

• Öffnen Sie die Bestellung unter Orders – eine Failed-Bestellung zeigt das Banner “Something went wrong sending this order to the POS:” gefolgt von Lightspeeds Grund.
• Aktivieren Sie in den Filtern von Live Orders die Option Show failed orders only, um nur die fehlgeschlagenen Bestellungen aufzulisten.
• Logs → POS Errors (Seitentitel Integration Errors) zeigt eine tägliche Zählung der Bestellungen mit einem POS-Fehler und deren Gesamtwerte, filterbar nach Store und Zeitraum. Der Grund pro Bestellung wird dort nicht aufgeführt – öffnen Sie dazu die Bestellung.
• Schauen Sie nicht unter Logs → Blocked Orders nach: Diese Seite listet Bestellungen auf, die storekit von vornherein nicht erstellt hat (Regeln und Filter), nicht Bestellungen, die Lightspeed abgelehnt hat.

Wenn die Adressen korrekt sind und eine endgültig fehlgeschlagene Bestellung trotzdem keine E-Mail ausgelöst hat, wenden Sie sich an den storekit-Support und nennen Sie die Bestellnummer – eine Kopie jeder Failed-Order-E-Mail wird bei uns aufbewahrt.

​

Vorbestellungen kommen zu früh oder zu spät

Das steuert Buffer Orders. Ist Buffer (in minutes) gesetzt, wird die Bestellung so viele Minuten vor der gewünschten Zeit eingespielt; ist es leer, verwendet storekit die Prep-Time-Berechnung des Stores.

​

Für Vor-Ort-Bestellungen wird der falsche Tisch verwendet

storekit sendet die POS-ID des Tisches als Lightspeed-Tischnummer. Wenn nur einige wenige Tische falsch sind, korrigieren Sie deren POS ID unter Stores → Ihr Store → Settings → Tables — siehe Tische bearbeiten. Führen Sie Sync floorplan nur dann erneut aus, wenn der gesamte Grundriss abgeglichen werden muss: Es umfasst jeden Bereich im Store und überschreibt manuell angepasste Tische, wie unter Grundriss & Tische beschrieben.

​

Bestand & Verfügbarkeit

​

Ausverkaufte Artikel sind weiterhin bestellbar

• Stock Webhook muss eingeschaltet sein – das Label sollte Enabled - stocks updated automatically anzeigen.
• storekit ordnet Bestandsupdates über SKU und den verbundenen Standort zu, sodass ein Artikel, dessen SKU sich zwischen den Systemen unterscheidet, nicht aktualisiert wird. Synchronisieren Sie das Menü erneut.

​

Der Store schließt sich immer wieder selbst

Das ist Sync order readiness: Lightspeed meldet den Standort als nicht bereit für Online-Bestellungen, und storekit schließt den Store und öffnet ihn wieder, sobald Lightspeed ihn wieder als bereit meldet. Schalten Sie die Einstellung aus, wenn der POS die Store-Verfügbarkeit nicht steuern soll, und deaktivieren Sie Order readiness emails, um die Benachrichtigungen zu stoppen. Diese E-Mails gehen an die Email address-Liste des Stores, höchstens eine alle 30 Minuten und nur während der Store geöffnet ist – siehe Bestellbereitschaft.

​

Kunden werden nicht darüber informiert, dass ihre Bestellung bereit ist

Ready for pickup notifications muss aktiviert sein, damit Lightspeed den Ready-for-pickup-Status steuern kann.

​

Pay at Table

​

Der Gast sieht keine Rechnung

• Der Tisch muss in beiden Systemen mit derselben Nummer existieren – führen Sie Sync floorplan aus.
• Es muss ein offener Check auf diesem Tisch in Lightspeed geben.

​

Zahlungen schlagen fehl

• Prüfen Sie, dass Payment Method PAT auf eine Lightspeed-Zahlungsmethode zeigt, die noch aktiv ist. Ist nichts ausgewählt, meldet storekit Zahlungen als APM, was in Lightspeed existieren muss.
• Gutschein- und Loyalty-Zahlungen verwenden Gift Card Payment Method – dasselbe gilt für diese Einstellung.
• Der Fehlergrund von Lightspeed wird an der Zahlung gespeichert, und die Rechnung wird markiert, damit das Personal sie am POS begleichen kann.

​

Eine Getränkerunde hat es nicht auf die Rechnung geschafft

Bestellungen, die einer offenen Rechnung hinzugefügt werden, werden nicht wiederholt. Prüfen Sie den Fehlergrund der Bestellung in storekit und fügen Sie die Artikel bei Bedarf am POS hinzu. Für alles Weitere wenden Sie sich an den Support.