> ## Documentation Index > Fetch the complete documentation index at: https://storekit.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Dépannage Lightspeed > Résolvez les problèmes Lightspeed K-Series dans storekit : erreurs d'autorisation, sync de menu, commandes rejetées, stock non mis à jour et pay-at-table. Problèmes courants de Lightspeed K-Series et comment les résoudre. Si vous êtes toujours bloqué, [contactez le support storekit](/docs/fr/getting-started/contact-support). > [!NOTE] > > 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](/docs/fr/guides/integrations/pos/lightspeed/till-offline). Une commande qui échoue parce qu'un article *"has a Disconnected status in Lightspeed"* est un autre problème — voir [ci-dessous](#une-commande-a-echoue-car-un-article-a-le-statut-disconnected-dans-lightspeed). 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](#une-commande-a-echoue-avec-validation-failed-for-method--placetogoorder). ## 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](/docs/fr/getting-started/contact-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 sur `en` 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](/docs/fr/guides/integrations/pos/lightspeed/till-offline) 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](/docs/fr/guides/integrations/pos/lightspeed/till-offline#cette-commande-a-deja-ete-envoyee-au-pos) 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](/docs/fr/guides/integrations/pos/lightspeed/till-offline) 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](/docs/fr/guides/integrations/pos/lightspeed/menu-sync). **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](/docs/fr/getting-started/contact-support) 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. > [!WARNING] > > La commande est déjà confirmée au client, et s'il a payé en ligne l'argent a été prélevé. Si la commande ne peut pas être renvoyée avec succès, saisissez-la manuellement dans Lightspeed à partir des détails de la commande dans storekit pour que la cuisine la reçoive quand même, et n'encaissez le paiement au retrait que si la commande storekit indique qu'elle a été passée comme commande en espèces. ### 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](/docs/fr/guides/integrations/pos/lightspeed/orders#lorsquune-commande-echoue) 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](/docs/fr/guides/integrations/pos/lightspeed/menu-sync#limitations). * *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é. Si le renvoi échoue avec la même raison après que le menu a été resynchronisé, [contactez le support storekit](/docs/fr/getting-started/contact-support) et indiquez le numéro de la commande. storekit ne stocke que la ligne de résumé de Lightspeed avec la commande ; le détail champ par champ de ce que Lightspeed a refusé est conservé dans nos logs, et le support peut le lire et vous dire quel article ou champ corriger. > [!WARNING] > > La commande est déjà confirmée au client, et s'il a payé en ligne l'argent a été prélevé. Si elle ne peut pas être renvoyée avec succès, saisissez-la à la main dans Lightspeed à partir des détails de la commande dans storekit pour que la cuisine la reçoive quand même. ### 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 : 1. *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. 2. *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. 3. *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 # for store: `. L'email *"Lightspeed Not Ready"* est un message différent avec ses propres règles — voir [L'établissement se ferme tout seul](#letablissement-se-ferme-tout-seul) et [État de préparation](/docs/fr/guides/integrations/pos/lightspeed/stock-and-availability#etat-de-preparation). Il est délibérément limité à un email par établissement toutes les 30 minutes et n'est pas envoyé lorsque vos horaires d'ouverture indiquent que l'établissement est fermé, de sorte qu'une rafale d'échecs de préparation ne produit pas une rafale d'emails, et qu'aucun n'arrive pendant la nuit. Pendant que vous réglez les emails, les échecs sont toujours visibles dans le tableau de bord : * 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. Si les adresses sont correctes et qu'une commande définitivement en échec n'a produit aucun email, [contactez le support storekit](/docs/fr/getting-started/contact-support) avec le numéro de commande — une copie de chaque email d'échec de commande est conservée de notre côté. ### 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](/docs/fr/guides/fulfillment/dine-in-tables#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](/docs/fr/guides/integrations/pos/lightspeed/dine-in#re-synchronisation). ## 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](/docs/fr/guides/integrations/pos/lightspeed/stock-and-availability#etat-de-preparation). ### 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. ### Une tournée de boissons n'est pas arrivée sur l'addition Les commandes ajoutées à une addition ouverte ne sont pas relancées. Consultez la raison de l'échec de la commande dans storekit et ajoutez les articles sur le POS si nécessaire. Pour toute autre question, [contactez le support](/docs/fr/getting-started/contact-support). ## Related topics - [Dépannage](/docs/fr/guides/integrations/pos/comtrex/troubleshooting.md) - [Pay at Table Lightspeed](/docs/fr/guides/integrations/pos/lightspeed/pay-at-table.md) - [Synchronisation du menu Lightspeed](/docs/fr/guides/integrations/pos/lightspeed/menu-sync.md) - [Stock et disponibilité Lightspeed](/docs/fr/guides/integrations/pos/lightspeed/stock-and-availability.md) - [Commandes et routage Lightspeed](/docs/fr/guides/integrations/pos/lightspeed/orders.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.