Lightspeed K-Series: integratieproblemen oplossen

Dit artikel helpt als de Lightspeed K-Series-integratie niet meer doet wat hij moet doen. Elk onderdeel begint bij wat je aan de kassa ziet en zet op volgorde wat je kunt controleren. Voor de installatie zelf, zie De Lightspeed K-Series-integratie installeren.

De Leat-knop op de kassa werkt niet

Controleer of de integratie actief is. Ga in het Business Dashboard naar Apps → Integraties en open Lightspeed K-Series onder Geïnstalleerd in de zijbalk. Staat op de knop bovenaan de pagina Activeren, dan staat de integratie uit: klik erop.
Is de verbinding met Lightspeed verbroken, klik dan op Configureer opnieuw en doorloop de stap Authenticeren opnieuw.
Controleer de URL van de webextensie. Kopieer op het tabblad Web Extensions van de integratie de All-in-One - Web extension URL. Ga in je Lightspeed-backoffice naar Operations > Web extensions, open de Leat-webextensie en controleer of die precies deze URL gebruikt.
Controleer in dezelfde webextensie of Provide a JavaScript context to the loaded page aanstaat en klik daarna op Save.
Herlaad het apparaat en probeer de knop opnieuw.

Een beloning kan niet worden geclaimd aan de kassa

Ga naar Loyalty → Beloningen en open de beloning.
Klik in de zijbalk op Kortingslogica en zoek het onderdeel Lightspeed K-Series.
Staat er Nog geen korting gekoppeld, dan weet de kassa niet welke korting hij moet geven en kan de beloning niet werken. Klik op Koppel een korting, kies de korting bij Korting Lightspeed K-Series en kies bij Van toepassing op waarop hij geldt: Volledige bestelling, Item op een specifieke locatie, Artikel op alle locaties of Artikel in een specifieke categorie. Wil je een korting wijzigen die al gekoppeld is, klik dan op Kortingsinstellingen bewerken. Zie Kortingen voor beloningen en vouchers instellen voor Lightspeed K-Series.
Controleer de korting in Lightspeed. Met Gebruik Lightspeed-kortingen als Kortingsstrategie weigert de kassa een korting die niet zo is ingesteld:
- Alle accounting groups (boekhoudgroepen) zijn geselecteerd voor de korting, ook als hij maar op bepaalde artikelen geldt.
- De korting is toegevoegd aan de POS configuration die je iPads gebruiken.
Haal na een wijziging de nieuwste configuratie op elk kassa-apparaat op. Zolang je dat niet doet, verandert er niets op de kassa.
Controleer de Kortingsstrategie van de integratie op het tabblad Settings. Staat die op Gebruik negatieve prijsartikelen, dan heeft je Lightspeed-backoffice een item nodig met de SKU LEAT-DISCOUNT-ITEM en het prijstype Manually-entered negative price. Zonder dat item kunnen beloningen niet worden ingewisseld.
Controleer de naam van de korting in Lightspeed. Gebruik geen hoofdletters, geen spaties en geen speciale tekens zoals @, $ of %. Een naam als leat_discount werkt; namen als Leat Discount of LEAT-Reward% kunnen ervoor zorgen dat de integratie hem niet herkent.

Een voucher kan niet worden ingewisseld aan de kassa

Zet de items op de rekening voordat je de voucher inwisselt. Een voucher met een vast bedrag of een percentage wordt berekend over wat er op de rekening staat, dus inwisselen op een lege rekening geeft geen korting.
Werkt het dan nog steeds niet, ga dan naar Loyalty → Promoties & Vouchers, open de promotie waar de voucher bij hoort en controleer de Kortingslogica op dezelfde manier als bij een beloning.

Bestellingen uit Lightspeed komen niet in Leat binnen

Lightspeed stuurt pas bestellingen naar Leat als het supportteam van Lightspeed realtime meldingen voor je locaties heeft aangezet. Krijgen contacten geen punten op hun bestellingen, dan is dit bijna altijd de oorzaak.

Open het tabblad Locations van de integratie. De kolom Bestellingen laat per locatie zien of de bestellingen Leat bereiken:
- Bestellingen ontvangen: de afgelopen 7 dagen zijn er bestellingen binnengekomen, met het tijdstip van de Laatste bestelling.
- Rustig: er kwamen eerder bestellingen binnen, maar de afgelopen 7 dagen niet.
- Wachten op eerste bestelling: de locatie is minder dan een dag geleden in Lightspeed toegevoegd.
- Geen bestellingen ontvangen: Leat heeft nog nooit een bestelling van deze locatie ontvangen.
- Niet gekoppeld: de locatie is niet aan een bedrijfsprofiel gekoppeld, dus de bestellingen ervan worden genegeerd.
Kies voor een locatie met Niet gekoppeld een bedrijfsprofiel en klik op Opslaan.
Klik bij een locatie met Geen bestellingen ontvangen in die rij op Lightspeed e-mailen. Gaat het om meerdere locaties, dan heeft de melding bovenaan het tabblad een knop Lightspeed e-mailen voor allemaal tegelijk. Daarmee open je een kant-en-klare e-mail aan k-series.support@lightspeedhq.com waarin je Lightspeed vraagt om realtime meldingen voor Leat aan te zetten. De ID's van de locaties, je URL voor realtime meldingen en de voorwaarde this.notificationType == 'CLOSE' staan er al in.
Vraag Lightspeed op dezelfde manier of realtime meldingen nog aanstaan voor een locatie met Rustig die wel open was.

Schrijf je de e-mail liever zelf, kopieer dan de URL voor realtime meldingen op het tabblad Algemeen van de integratie en geef Lightspeed de naam van de integratie (Leat), die URL, de ID's van je locaties en de voorwaarde hierboven.

Iemand bij Lightspeed moet dit instellen, dus houd rekening met wat tijd voordat je antwoord krijgt.

Bestellingen van een nieuwe locatie komen niet in Leat binnen

Voeg je na het installeren van de integratie een locatie toe in Lightspeed, dan moet Leat die leren kennen en moet Lightspeed de bestellingen ervan gaan sturen:

Open het tabblad Synchroniseren van de integratie en klik op Synchroniseer artikelen en kortingen.
Verschijnt de pop-up Nieuwe Lightspeed-vestigingen gevonden, klik dan op E-mail versturen, of kopieer de e-mail en stuur hem naar k-series.support@lightspeedhq.com. Klik daarna op Begrepen.
Open het tabblad Locations, koppel de nieuwe locatie aan een bedrijfsprofiel en klik op Opslaan.

Heeft Lightspeed de realtime meldingen aangezet, dan verandert de status van de locatie na de eerste bestelling in Bestellingen ontvangen. Meer over het tabblad en de statussen lees je in Lightspeed K-Series-instellingen: de tabbladen Settings, Advanced en Locations uitgelegd.

Bij het opwaarderen van een cadeaukaart staat er een negatief bedrag op de rekening

Het opwaardeeritem in Lightspeed is verkeerd ingesteld. Zoek in je Lightspeed-backoffice het item met de SKU LEAT-PRODUCT-ITEM:

Bestaat het, open het dan en zet het prijstype op Manually-entered price.
Bestaat het niet, maak het dan aan met als naam en SKU LEAT-PRODUCT-ITEM en het prijstype Manually-entered price.

Herlaad daarna je apparaten.

Een opwaardering komt niet op de rekening

Waarderen je medewerkers een cadeaukaart of prepaid saldo op en zet de kassa de opwaardering niet op de rekening, dan zien ze deze melding: The POS did not add LEAT-PRODUCT-ITEM to the order, so nothing was topped up. De melding is in het Engels, in welke taal je kassa ook staat. Er komt niets op de kaart of het saldo, dus je hoeft niets terug te draaien.

Dit komt door hoe het item LEAT-PRODUCT-ITEM in je Lightspeed-backoffice is ingesteld. Open het item op de locatie van het apparaat en controleer deze twee dingen:

Bij POS settings, onder Additional options, staat Allow item to be renamed uit. Staat het aan, dan negeert de kassa de opwaardering zonder melding, ook al kunnen je medewerkers het item nog wel met de hand op een rekening zetten.
Het item bestaat op de locatie van het apparaat, met het prijstype Manually-entered price. Elke locatie heeft er een eigen nodig.

Klik op Save, herlaad het apparaat zodat het de wijziging oppikt, en probeer de opwaardering opnieuw.