Bestellingen die mislukken met “Not processed before validity ended”, “K-Series iPad App is off” of “All active devices are offline” wijzen allemaal op hetzelfde — het Lightspeed Active Device was niet online. Daar is een aparte pagina voor: Bestellingen mislukken: kassa offline. Een bestelling die mislukt omdat een item “has a Disconnected status in Lightspeed” is een ander probleem — zie hieronder. Een tijdlijnvermelding met “Failed to sync order Validation failed for method … placeToGoOrder …” is nog weer iets anders — Lightspeed heeft de inhoud van de bestelling geweigerd — zie hieronder.
Verbinding
”Lightspeed K-Series” staat niet in mijn Integrations-lijst
De integratie is nog niet ingeschakeld voor je account. Neem contact op met support om deze in te schakelen.Bestellingen mislukken met “Our access to your Lightspeed account has been disabled”
Lightspeed weigert de toegang van storekit. De integration user in Lightspeed is meestal uitgeschakeld of zijn permissies zijn gewijzigd — zet deze in de Lightspeed back office weer aan, klik daarna op Disconnect Auth en vervolgens weer op Connect to Lightspeed op Stores → jouw vestiging → Settings → Integrations → Lightspeed K-Series.Ik heb de verkeerde Lightspeed-locatie verbonden
Klik op Disconnect Auth, vervolgens op Connect to Lightspeed en kies de juiste locatie op het scherm Select your Lightspeed location:.Menu-sync
Er is geen Sync-knop op het menu
De balk Connected to Lightspeed (met View in POS en Sync) verschijnt alleen als de POS-provider van de vestiging Lightspeed is en het menu is gekoppeld aan een Lightspeed-menu. Selecteer het menu in Lightspeed Menu op de Lightspeed-instellingenpagina en klik op Save.De sync mislukt halverwege
De voortgangsbalk toont de fase die mislukte. Veelvoorkomende oorzaken:- Het menu bestaat niet meer in Lightspeed, of is niet meer beschikbaar op de verbonden business location — kies het opnieuw in Lightspeed Menu.
- De autorisatie is verlopen of ingetrokken — verbind opnieuw (zie hierboven).
- Het accountprofiel in Specify account profile when syncing menu bestaat niet meer in Lightspeed — zet het terug op No profile of kies een actueel profiel.
Sommige items zijn niet geïmporteerd
- Items waarvan de Lightspeed-prijsstrategie de prijs positief, negatief of een percentage van het totaal maakt, worden bewust overgeslagen — ze hebben geen vaste prijs om te importeren.
- Items in sub-screens landen in de bovenliggende categorie, tenzij Import Sub-screens as categories aan staat.
- Producten in de menu entry group
integration(de storekit-producten voor bezorging, korting en servicetoeslag) worden met opzet overgeslagen.
Namen of beschrijvingen staan in de verkeerde taal
Zet Language op de Lightspeed-locale die je wilt. storekit valt terug open voor items zonder tekst in die locale.
Mijn storekit-afbeeldingen of -beschrijvingen zijn overschreven
Zet Don’t update menu images en Don’t update menu description aan. Al het andere in het menu wordt bij elke sync opnieuw vanuit Lightspeed geschreven.Bestellingen
Bestellingen mislukken met “Not processed before validity ended”
Het Lightspeed Active Device — je master-iPad — was niet online om de bestelling op te halen. Zie Bestellingen mislukken: kassa offline voor de volledige checklist en hoe je de bestelling opnieuw verstuurt. Wordt het opnieuw versturen geweigerd met “This order has already been sent to the POS”, dan heeft Lightspeed de bestelling geaccepteerd maar heeft de kassa hem nooit geprint — volg wat je moet doen in plaats van opnieuw op Resend order to POS te klikken.Bestellingen komen helemaal niet in Lightspeed aan
- Controleer of Integration Status aan staat — het label zou Enabled - sending orders to Lightspeed moeten lezen.
- Controleer of de vestiging aan de juiste business location is gekoppeld.
- Open de bestelling in storekit en lees de reden voor mislukking die eraan is gekoppeld.
Bestellingen worden meteen bij verzending geweigerd
- De accountprofielcode moet in Lightspeed bestaan. Als een rij onder Account Profile Codes leeg is, stuurt storekit
storekit— maak dat profiel aan in Lightspeed of selecteer een echt profiel voor Pickup, Delivery, In Store en Add to Bill. - De producten voor bezorging, korting en servicetoeslag moeten in Lightspeed bestaan met de SKU’s die staan ingesteld in Delivery Product Code (SKU), Discount Product Code (SKU) en Service Charge Product Code (SKU) (standaardwaarden:
STOREKIT_DELIVERY,STOREKIT_DISCOUNT,STOREKIT_SERVICE_CHARGE). Een ontbrekende SKU laat de hele bestelling mislukken. - Item-SKU’s moeten nog steeds overeenkomen. Sync het menu opnieuw nadat je SKU’s in Lightspeed hebt gewijzigd.
Een bestelling is mislukt omdat een artikel de status Disconnected heeft in Lightspeed
De reden voor mislukking luidt “…one of the items in the order has a Disconnected status in Lightspeed”. Dit is de eigen melding van Lightspeed, woord voor woord opgeslagen bij de bestelling: Lightspeed weigerde de bestelling omdat het een van de items niet behandelt als een actief, bestelbaar item op de gekoppelde business location. In het geval dat storekit support heeft gezien, ging het om een item dat net in Lightspeed was aangemaakt en door de menu-sync van de vorige dag was geïmporteerd. Het is niet de kassa-offline-mislukking. Er hoeft niets aan de iPad te gebeuren — kijk alleen naar Bestellingen mislukken: kassa offline als de reden “Not processed before validity ended” is.1
Sync het menu opnieuw
Open het menu onder Menus en klik op Sync in de balk Connected to Lightspeed, zodat storekit het huidige Lightspeed-item ophaalt. Zie Menu-sync.
2
Controleer het item in Lightspeed
Klik op View in POS en bevestig dat het item nog steeds bestaat in het menu waaraan storekit is gekoppeld en actief is op deze business location. Als het is verwijderd en opnieuw aangemaakt, moet het nieuwe item in dat menu staan.
3
Verstuur de bestelling opnieuw
Open de bestelling en klik op More actions → Resend order to POS. De bestelling wordt opnieuw verstuurd met het vers gesynchroniseerde item.
4
Nog steeds mislukt? Neem contact op met support
Als het opnieuw versturen met dezelfde reden mislukt, neem contact op met storekit support en vermeld het bestelnummer en de naam van het item. De koppeling tussen het storekit-item en het Lightspeed-item moet mogelijk aan onze kant opnieuw worden opgebouwd — een door support uitgevoerde sync heeft cases opgelost waarbij een door de merchant uitgevoerde sync dat niet deed.
Een bestelling is mislukt met “Validation failed for method … placeToGoOrder”
De tijdlijn van de bestelling toont “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”. Dit is de eigen respons van Lightspeed, woord voor woord opgeslagen: Lightspeed weigerde de bestelling überhaupt te accepteren omdat iets in wat storekit stuurde — de klantgegevens, een item- of modifier-code, de business location of de betalingsregel — de controle niet doorstond. Error count is het aantal velden waartegen Lightspeed bezwaar had. Het is niet de kassa-offline-mislukking. De bestelling heeft de iPad nooit bereikt, dus het herstarten van de Lightspeed-app of het opnieuw laden van de iPad verandert niets, en op More actions → Resend order to POS klikken zonder wijzigingen stuurt dezelfde inhoud en mislukt op dezelfde manier. Omdat Lightspeed de bestelling nooit heeft aangenomen, lopen de retry- en failed-order-e-mailregels die worden beschreven in Wanneer een bestelling mislukt niet — de weigering wordt vastgelegd in de tijdlijn van de bestelling en de bestelling wordt niet op de kassa afgedrukt. Controleer deze punten voordat je opnieuw verstuurt:- Een item in de bestelling bestaat alleen in storekit. Een item of modifier die handmatig in storekit is toegevoegd, heeft geen Lightspeed-code, dus Lightspeed weigert de bestelling. Maak het item eerst aan in het Lightspeed-menu waaraan de vestiging is gekoppeld, open het menu vervolgens onder Menus en klik op Sync in de balk Connected to Lightspeed zodat storekit de code overneemt, en verstuur de bestelling opnieuw. Een sync op zich verwijdert alleen-in-storekit-items in plaats van ze in Lightspeed aan te maken — zie Menusynchronisatie.
- Een modifier- of itemcode bestaat niet meer in Lightspeed. Als de code sinds de laatste sync in Lightspeed is verwijderd, opnieuw aangemaakt of van SKU is gewijzigd, synchroniseer het menu dan opnieuw zodat storekit de huidige code stuurt. De bezorg-, kortings- en service charge-SKU’s onder Delivery Product Code (SKU), Discount Product Code (SKU) en Service Charge Product Code (SKU) moeten ook nog steeds in Lightspeed bestaan.
- Het telefoonnummer van de klant. storekit geeft het telefoonnummer van de klant aan Lightspeed door in het veld dat Lightspeed reserveert voor internationale (E.164-)nummers. Als de weigering een klantgegevensveld betreft, vraag support dan te controleren of het nummer op de bestelling is waar Lightspeed bezwaar tegen maakte.
Een bestelling is mislukt omdat een item beperkt is
Lightspeed weigerde de bestelling onder een sales restriction. storekit snoozet de betrokken items tot 8 uur de volgende dag en mailt de vestiging; controleer de voorraad of restrictie van het item in Lightspeed en unsnoozet het daarna in storekit.Bestellingen mislukken en stoppen dan met opnieuw proberen
storekit stuurt een directe bestelling in totaal maximaal 5 pogingen (de oorspronkelijke verzending plus vier retries) voordat deze als Failed wordt gemarkeerd. Een pre-order wordt opnieuw geprobeerd zolang de gewenste tijd nog ver weg is, dus een pre-order voor later op de dag kan om de paar minuten mislukken, opnieuw geprobeerd worden en weer mislukken, totdat deze uiteindelijk kort voor de gewenste tijd als Failed wordt gemarkeerd. Bestellingen die aan een bestaande rekening worden toegevoegd, en mislukkingen die worden gemeld als een item dat niet kon worden toegevoegd, worden helemaal niet opnieuw geprobeerd. Zodra de oorzaak is verholpen, verstuur je de bestelling opnieuw met More actions → Resend order to POS.Ik ontvang geen failed-order-e-mails
Bestellingen worden in het dashboard als Failed getoond maar er komt geen e-mail binnen. Controleer dit op volgorde:- De e-mailadressen van de vestiging. De failed-order-e-mail gaat alleen naar de adressen in Email address op Stores → jouw vestiging → Settings → General — het eerste adres is de ontvanger en de rest zijn blind copies. Er wordt niets verstuurd naar het e-mailadres waarmee je op het dashboard inlogt, naar de account owner, of naar andere personeelsleden, tenzij hun adres in die lijst staat. Als de lijst leeg is, wordt er helemaal geen e-mail verstuurd. Voeg de adressen toe die gewaarschuwd moeten worden en klik op Save. Er is in het dashboard geen aparte instelling voor wie failed-order-e-mails ontvangt.
- De bestelling is nog niet definitief mislukt. De e-mail wordt één keer verstuurd, wanneer storekit stopt met opnieuw proberen en de bestelling als Failed markeert. Dit gebeurt niet bij elke mislukte poging. Een directe bestelling wordt na de 5e mislukking gemaild; een pre-order wordt opnieuw geprobeerd tot kort voor de gewenste tijd, dus een bestelling die nog wordt geprobeerd, of een pre-order voor later vandaag, is nog niet gemaild. Bestellingen die aan een bestaande rekening worden toegevoegd en “item kon niet worden toegevoegd”-mislukkingen worden bij de eerste mislukking gemaild omdat ze niet opnieuw worden geprobeerd.
- Je spamfolder en afzender. De e-mail komt van het verzendadres van je storekit-partner met als onderwerp
Lightspeed Issue: Order #<order number> for store: <store name>.
- Open de bestelling onder Orders — een Failed-bestelling toont de banner “Something went wrong sending this order to the POS:” gevolgd door de reden van Lightspeed.
- Zet in Live Orders de filter Show failed orders only aan om alleen de mislukte bestellingen te zien.
- Logs → POS Errors (paginatitel Integration Errors) toont een dagelijkse telling van bestellingen met een POS-fout en hun totalen, filterbaar op vestiging en datumbereik. Het geeft niet de reden per bestelling weer — daarvoor open je de bestelling zelf.
- Kijk niet onder Logs → Blocked Orders: die pagina toont bestellingen die storekit al in eerste instantie heeft geweigerd (regels en filters), niet bestellingen die door Lightspeed zijn afgewezen.
Pre-orders komen te vroeg of te laat aan
Buffer Orders regelt dit. Met Buffer (in minutes) ingesteld wordt de bestelling zoveel minuten voor de gewenste tijd geïnjecteerd; zonder waarde gebruikt storekit de prep-time-berekening van de vestiging.De verkeerde tafel wordt gebruikt voor ter plaatse-bestellingen
storekit stuurt de POS ID van de tafel als Lightspeed-tafelnummer. Als slechts een paar tafels verkeerd zijn, corrigeer dan hun POS ID onder Stores → jouw vestiging → Settings → Tables — zie Tafels bewerken. Voer Sync floorplan alleen opnieuw uit wanneer de hele plattegrond verzoend moet worden: dat bestrijkt elk gebied in de vestiging en overschrijft handmatig aangepaste tafels, zoals beschreven in Plattegrond & tafels.Voorraad & beschikbaarheid
Uitverkochte items zijn nog steeds bestelbaar
- Stock Webhook moet aan staan — het label zou Enabled - stocks updated automatically moeten lezen.
- storekit matcht voorraadupdates op SKU en op de verbonden business location, dus een item met een verschillende SKU tussen de systemen wordt niet bijgewerkt. Sync het menu opnieuw.
De vestiging blijft zichzelf sluiten
Dat is Sync order readiness: Lightspeed meldt dat de locatie niet klaar is voor online bestellingen, dus storekit sluit de vestiging en heropent deze wanneer Lightspeed meldt dat hij weer klaar is. Zet de instelling uit als je niet wilt dat de POS de beschikbaarheid van de vestiging bepaalt, en zet Order readiness emails uit om de meldingen te stoppen. Die e-mails gaan naar de Email address-lijst van de vestiging, maximaal één per 30 minuten en alleen terwijl de vestiging open is — zie Orderbeschikbaarheid.Klanten worden niet gewaarschuwd dat hun bestelling klaar is
Ready for pickup notifications moet aan staan zodat Lightspeed de ready-for-pickup-status kan aansturen.Pay at Table
De gast ziet geen rekening
- De tafel moet in beide systemen bestaan met hetzelfde nummer — voer Sync floorplan uit.
- Er moet een open check op die tafel in Lightspeed staan.
Betalingen mislukken
- Controleer of Payment Method PAT verwijst naar een Lightspeed-betaalmethode die nog actief is. Als er niets is geselecteerd, rapporteert storekit betalingen als
APM, wat in Lightspeed moet bestaan. - Cadeaubon- en loyalty-betalingen gebruiken Gift Card Payment Method — hetzelfde geldt hiervoor.
- De reden voor mislukking van Lightspeed wordt bij de betaling opgeslagen; mislukte betalingen worden gevoid en de rekening wordt geflagd zodat personeel deze op de POS kan afhandelen.