Les commandes qui échouent avec “Not processed before validity ended”, “K-Series iPad App is off” ou “All active devices are offline” signifient toutes la même chose — l’Active Device Lightspeed n’était pas en ligne. Ce cas a sa propre page : Commandes en échec : caisse hors ligne. Une commande qui échoue parce qu’un article “has a Disconnected status in Lightspeed” est un autre problème — voir ci-dessous. Une entrée du fil indiquant “Failed to sync order Validation failed for method … placeToGoOrder …” est encore un cas différent — Lightspeed a refusé le contenu de la commande — voir ci-dessous.
Connexion
« Lightspeed K-Series » n’apparaît pas dans ma liste Integrations
L’intégration n’est pas activée sur votre compte. Contactez le support pour la faire activer.Les commandes échouent avec « Our access to your Lightspeed account has been disabled »
Lightspeed rejette l’accès de storekit. L’utilisateur d’intégration dans Lightspeed a généralement été désactivé ou ses permissions ont changé — réactivez-le dans le back office Lightspeed, puis cliquez sur Disconnect Auth et à nouveau sur Connect to Lightspeed dans Stores → votre établissement → Settings → Integrations → Lightspeed K-Series.Je me suis connecté à la mauvaise location Lightspeed
Cliquez sur Disconnect Auth, puis sur Connect to Lightspeed, et choisissez la bonne location sur l’écran Select your Lightspeed location:.Synchronisation du menu
Il n’y a pas de bouton Sync sur le menu
La barre Connected to Lightspeed (avec View in POS et Sync) n’apparaît que lorsque le fournisseur POS de l’établissement est Lightspeed et que le menu est lié à un menu Lightspeed. Sélectionnez le menu dans Lightspeed Menu sur la page des paramètres Lightspeed et cliquez sur Save.La synchronisation échoue en cours de route
La barre de progression indique l’étape qui a échoué. Causes courantes :- Le menu n’existe plus dans Lightspeed ou n’est plus disponible sur la business location connectée — resélectionnez-le dans Lightspeed Menu.
- L’autorisation a expiré ou a été révoquée — reconnectez-vous (ci-dessus).
- Le profil de compte dans Specify account profile when syncing menu n’existe plus dans Lightspeed — remettez-le sur No profile ou choisissez un profil à jour.
Certains articles n’ont pas été importés
- Les articles dont la stratégie de tarification Lightspeed rend le prix positif, négatif ou un pourcentage du total sont volontairement ignorés — ils n’ont pas de prix fixe à importer.
- Les articles à l’intérieur de sub-screens arrivent dans la catégorie parente sauf si Import Sub-screens as categories est activé.
- Les produits du menu entry group
integration(les produits de livraison, remise et frais de service storekit) sont ignorés à dessein.
Les noms ou descriptions sont dans la mauvaise langue
Réglez Language sur la locale Lightspeed souhaitée. storekit se rabat suren pour les articles sans texte dans cette locale.
Mes images ou descriptions storekit ont été écrasées
Activez Don’t update menu images et Don’t update menu description. Tout le reste du menu est réécrit depuis Lightspeed à chaque synchronisation.Commandes
Les commandes échouent avec « Not processed before validity ended »
L’Active Device Lightspeed — votre iPad maître — n’était pas en ligne pour récupérer la commande. Consultez Commandes en échec : caisse hors ligne pour la checklist complète et la marche à suivre pour renvoyer la commande. Si le renvoi est refusé avec « This order has already been sent to the POS », Lightspeed a accepté la commande mais la caisse ne l’a jamais imprimée — suivez la marche à suivre plutôt que de cliquer à nouveau sur Resend order to POS.Les commandes n’arrivent pas du tout à Lightspeed
- Vérifiez que Integration Status est activé — le libellé doit indiquer Enabled - sending orders to Lightspeed.
- Vérifiez que l’établissement est lié à la bonne business location.
- Ouvrez la commande dans storekit et lisez la raison de l’échec qui y est enregistrée.
Les commandes sont rejetées dès leur envoi
- Le code de profil de compte doit exister dans Lightspeed. Si une ligne sous Account Profile Codes est vide, storekit envoie
storekit— créez ce profil dans Lightspeed ou sélectionnez-en un existant pour Pickup, Delivery, In Store et Add to Bill. - Les produits de livraison, de remise et de frais de service doivent exister dans Lightspeed avec les SKU définis dans Delivery Product Code (SKU), Discount Product Code (SKU) et Service Charge Product Code (SKU) (par défaut :
STOREKIT_DELIVERY,STOREKIT_DISCOUNT,STOREKIT_SERVICE_CHARGE). Un SKU manquant fait échouer toute la commande. - Les SKU des articles doivent toujours correspondre. Re-synchronisez le menu après avoir modifié des SKU dans Lightspeed.
Une commande a échoué car un article a le statut Disconnected dans Lightspeed
La raison de l’échec indique “…one of the items in the order has a Disconnected status in Lightspeed”. C’est le message propre à Lightspeed, enregistré mot pour mot avec la commande : Lightspeed a refusé la commande parce qu’il ne considère pas l’un des articles comme un article actif et commandable sur la business location connectée. Le cas rencontré par le support storekit concernait un article nouvellement créé dans Lightspeed et importé par la synchronisation du menu de la veille. Ce n’est pas l’échec de caisse hors ligne. Rien à faire sur l’iPad — consultez Commandes en échec : caisse hors ligne uniquement si la raison est “Not processed before validity ended”.1
Re-synchroniser le menu
Ouvrez le menu sous Menus et cliquez sur Sync dans la barre Connected to Lightspeed pour que storekit récupère l’article Lightspeed actuel. Voir Synchronisation du menu.
2
Vérifier l'article dans Lightspeed
Cliquez sur View in POS et vérifiez que l’article existe toujours dans le menu auquel storekit est lié et qu’il est actif sur cette business location. S’il a été supprimé puis recréé, le nouvel article doit se trouver dans ce menu.
3
Renvoyer la commande
Ouvrez la commande et cliquez sur More actions → Resend order to POS. La commande est renvoyée avec l’article fraîchement synchronisé.
4
Toujours en échec ? Contactez le support
Si le renvoi échoue avec la même raison, contactez le support storekit et indiquez le numéro de commande et le nom de l’article. Le lien entre l’article storekit et l’article Lightspeed peut avoir besoin d’être reconstruit de notre côté — une synchronisation lancée par le support a résolu des cas où une synchronisation lancée par le marchand n’y était pas parvenue.
Une commande a échoué avec “Validation failed for method … placeToGoOrder”
Le fil de la commande indique “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”. C’est la réponse propre à Lightspeed, enregistrée mot pour mot : Lightspeed a refusé d’accepter la commande parce que quelque chose dans ce que storekit a envoyé — les détails du client, un code d’article ou de modificateur, la business location ou la ligne de paiement — n’a pas passé ses contrôles. Error count est le nombre de champs auxquels il s’est opposé. Ce n’est pas l’échec caisse hors ligne. La commande n’a jamais atteint l’iPad, donc redémarrer l’application Lightspeed ou recharger l’iPad ne change rien, et cliquer sur More actions → Resend order to POS sans rien modifier envoie le même contenu et échoue de la même manière. Comme Lightspeed n’a jamais pris la commande, les règles de nouvelle tentative et d’email d’échec décrites dans Lorsqu’une commande échoue ne s’exécutent pas — le refus est consigné dans le fil de la commande et la commande ne s’imprime pas sur la caisse. Vérifiez ces points avant de renvoyer :- Un article de la commande n’existe que dans storekit. Un article ou modificateur ajouté à la main dans storekit n’a pas de code Lightspeed, donc Lightspeed refuse la commande. Créez d’abord l’article dans le menu Lightspeed auquel l’établissement est lié, puis ouvrez le menu sous Menus et cliquez sur Sync dans la barre Connected to Lightspeed pour que storekit récupère son code, puis renvoyez la commande. Une synchronisation seule supprime les articles uniquement présents dans storekit plutôt que de les créer dans Lightspeed — voir Synchronisation du menu.
- Un code de modificateur ou d’article n’existe plus dans Lightspeed. S’il a été supprimé, recréé ou si sa SKU a été modifiée dans Lightspeed depuis la dernière synchronisation, resynchronisez le menu pour que storekit envoie le code actuel. Les SKUs de livraison, remise et service charge sous Delivery Product Code (SKU), Discount Product Code (SKU) et Service Charge Product Code (SKU) doivent également toujours exister dans Lightspeed.
- Le numéro de téléphone du client. storekit transmet le numéro de téléphone du client à Lightspeed dans le champ réservé aux numéros au format international (E.164). Si le refus porte sur un champ de coordonnées client, demandez au support de vérifier si le numéro de la commande est bien celui auquel Lightspeed s’est opposé.
Une commande a échoué parce qu’un article est restreint
Lightspeed a refusé la commande à cause d’une restriction de vente. storekit met en veille les articles concernés jusqu’à 8h le lendemain et envoie un email à l’établissement ; vérifiez le stock ou la restriction de l’article dans Lightspeed, puis réactivez-le dans storekit.Les commandes échouent puis cessent d’être relancées
storekit envoie une commande immédiate jusqu’à 5 tentatives au total (l’envoi initial plus quatre relances) avant de la marquer Failed. Une pré-commande est relancée tant que son heure demandée est encore assez éloignée, de sorte qu’une pré-commande pour plus tard dans la journée peut échouer, être relancée et échouer à nouveau toutes les quelques minutes jusqu’à ce qu’elle soit finalement marquée Failed peu avant son échéance. Les commandes ajoutées à une addition existante et les échecs signalés comme article non ajoutable ne sont pas relancés du tout. Une fois la cause corrigée, renvoyez la commande avec More actions → Resend order to POS.Je ne reçois pas les emails d’échec de commande
Les commandes s’affichent comme Failed dans le tableau de bord mais aucun email n’arrive. Vérifiez ces points dans l’ordre :- Les adresses email de l’établissement. L’email d’échec de commande est envoyé uniquement aux adresses de Email address dans Stores → votre établissement → Settings → General — la première adresse est le destinataire et les autres sont en copie cachée. Rien n’est envoyé à l’email avec lequel vous vous connectez au tableau de bord, au propriétaire du compte ni aux autres membres du personnel à moins que leur adresse ne figure dans cette liste. Si la liste est vide, aucun email n’est envoyé du tout. Ajoutez les adresses à alerter et cliquez sur Save. Il n’existe pas de réglage séparé dans le tableau de bord pour qui reçoit les emails d’échec de commande.
- La commande n’est pas encore définitivement en échec. L’email est envoyé une seule fois, lorsque storekit cesse de relancer et marque la commande Failed — pas à chaque tentative échouée. Une commande immédiate est envoyée par email après son 5ᵉ échec ; une pré-commande est relancée jusqu’à peu avant son heure demandée, donc une commande qui s’affiche comme en cours de relance, ou une pré-commande pour plus tard dans la journée, n’a pas encore fait l’objet d’un email. Les commandes ajoutées à une addition existante et les échecs « item could not be added » sont envoyés par email dès le premier échec car ils ne sont pas relancés.
- Votre dossier spam et l’expéditeur. L’email provient de l’adresse d’envoi de votre partenaire storekit avec le sujet
Lightspeed Issue: Order #<order number> for store: <store name>.
- Ouvrez la commande sous Orders — une commande Failed affiche la bannière “Something went wrong sending this order to the POS:” suivie de la raison donnée par Lightspeed.
- Sur Live Orders, activez Show failed orders only dans les filtres pour ne lister que les commandes en échec.
- Logs → POS Errors (titre de page Integration Errors) affiche un compte quotidien des commandes avec une erreur POS et leurs totaux, filtrable par établissement et par plage de dates. Il ne liste pas la raison pour chaque commande — ouvrez la commande pour cela.
- Ne regardez pas sous Logs → Blocked Orders : cette page liste les commandes que storekit a refusé de créer dès le départ (règles et filtres), pas les commandes rejetées par Lightspeed.
Les pré-commandes arrivent trop tôt ou trop tard
Buffer Orders contrôle cela. Avec Buffer (in minutes) défini, la commande est injectée ce nombre de minutes avant l’heure demandée ; s’il est vide, storekit utilise le calcul du temps de préparation de l’établissement.La mauvaise table est utilisée pour les commandes sur place
storekit envoie le POS ID de la table comme numéro de table Lightspeed. Si seules quelques tables sont incorrectes, corrigez leur POS ID sous Stores → votre établissement → Settings → Tables — voir Modifier des tables. Ne relancez Sync floorplan que lorsque tout le plan de salle a besoin d’être réconcilié : elle couvre toutes les zones du magasin et écrase les tables ajustées à la main, comme décrit dans Plan de salle et tables.Stock et disponibilité
Les articles épuisés restent commandables
- Stock Webhook doit être activé — le libellé doit indiquer Enabled - stocks updated automatically.
- storekit fait correspondre les mises à jour de stock sur le SKU et sur la business location connectée ; un article dont le SKU diffère entre les systèmes ne sera donc pas mis à jour. Re-synchronisez le menu.
L’établissement se ferme tout seul
C’est Sync order readiness : Lightspeed signale la location comme non prête pour les commandes en ligne, alors storekit ferme l’établissement et le rouvre lorsque Lightspeed le signale à nouveau prêt. Désactivez le paramètre si vous ne voulez pas que le POS pilote la disponibilité de l’établissement, et désactivez Order readiness emails pour arrêter les notifications. Ces emails sont envoyés à la liste Email address de l’établissement, au plus un toutes les 30 minutes et uniquement lorsque l’établissement est ouvert — voir État de préparation.Les clients ne sont pas informés que leur commande est prête
Ready for pickup notifications doit être activé pour que Lightspeed pilote le statut « prêt au retrait ».Pay at Table
Le client ne voit pas d’addition
- La table doit exister dans les deux systèmes avec le même numéro — lancez Sync floorplan.
- Il doit y avoir une addition ouverte sur cette table dans Lightspeed.
Les paiements échouent
- Vérifiez que Payment Method PAT pointe vers un mode de paiement Lightspeed toujours actif. Sans sélection, storekit remonte les paiements comme
APM, qui doit exister dans Lightspeed. - Les paiements par carte-cadeau et de fidélité utilisent Gift Card Payment Method — la même règle s’applique.
- La raison de l’échec de Lightspeed est enregistrée avec le paiement ; les paiements en échec sont annulés et l’addition est signalée pour que le personnel puisse la régler sur le POS.