Commandes en échec : caisse hors ligne

C’est l’échec de commande Lightspeed le plus courant. Il revient toujours à la même cause : Lightspeed ne livre une commande en ligne qu’à un seul iPad — l’Active Device — et cet iPad n’était pas en ligne pour la recevoir. storekit envoie la commande à Lightspeed Cloud avec succès, accompagnée d’une fenêtre pendant laquelle la commande doit atteindre la caisse. Lightspeed la retient pour l’Active Device configuré pour recevoir les commandes en ligne. Si cet appareil est en veille, éteint, sorti de l’application Lightspeed, déconnecté, hors Wi-Fi ou autrement injoignable depuis Lightspeed Cloud, la fenêtre se ferme et Lightspeed signale la commande à storekit comme échouée — la validity dans le message d’erreur, c’est cette fenêtre. La fenêtre dépend de l’écart entre l’envoi et l’heure demandée : une minute pour une commande voulue maintenant, deux minutes pour une pré-commande à moins d’une heure et jusqu’à six heures pour une commande à plus d’une semaine. Une commande ASAP ne laisse donc aucune marge à un iPad en veille. Rien ne cloche dans votre configuration storekit, votre menu ou vos SKU. La solution consiste à remettre l’iPad en ligne, puis à renvoyer la commande.

​

Les erreurs qui correspondent à ce problème

Ouvrez la commande dans storekit (Live Orders ou All Orders → la commande) et lisez la bannière rouge : Something went wrong sending this order to the POS: …. Chacune de ces raisons correspond au même problème : Lorsque la raison est exactement Not processed before validity ended, la page de la commande affiche un bouton Fix it à côté de la bannière, qui ouvre la checklist How to fix Lightspeed timeout errors avec les mêmes vidéos que celles présentées ci-dessous. Toute autre raison affiche Get help à la place, qui ouvre le chat en direct.

​

Ce que storekit fait automatiquement

• storekit envoie la commande jusqu’à 5 tentatives au total — l’envoi initial plus quatre relances. Pendant les relances, la commande reste au statut Retrying (affiché Retrying x2, x3… sur la commande).
• Après le 5ᵉ échec, la commande est marquée Failed, l’e-mail d’échec de commande de l’établissement est envoyé (avec les instructions correspondant à l’erreur), et la commande est imprimée comme échouée si l’établissement dispose d’imprimantes.
• Les commandes ajoutées à une addition existante ne sont jamais relancées — un ajout à l’addition en échec doit être renvoyé manuellement ou saisi sur le POS.

Une caisse qui revient en ligne en quelques minutes récupère donc souvent d’elle-même. Une caisse hors ligne pour le reste du service fera échouer toutes les commandes qui lui seront envoyées.

​

Remettre l’iPad en ligne

Faites ceci sur l’Active Device Lightspeed — l’iPad maître configuré pour recevoir les commandes en ligne — dans cet ordre :

1. Réveillez l’iPad et ouvrez l’application Lightspeed. Elle doit être ouverte au premier plan et connectée. Un iPad sur l’écran d’accueil, l’écran de verrouillage ou avec l’application en arrière-plan est hors ligne du point de vue des commandes en ligne.
2. Vérifiez que l’iPad est chargé et branché. Un iPad déchargé ou en mode économie d’énergie est la cause racine la plus fréquente.
3. Vérifiez la connexion internet vers Lightspeed Cloud. Dans l’application Lightspeed, appuyez sur les quatre points en bas à droite et confirmez que la connexion à Lightspeed Cloud est saine. Si ce n’est pas le cas, corrigez le Wi-Fi et reconnectez-vous.
4. Appliquez toute mise à jour de configuration en attente. Dans la même vue à quatre points de l’application Lightspeed, appuyez sur l’icône de rafraîchissement pour que l’appareil récupère la dernière configuration depuis Lightspeed.
5. Confirmez qu’un appareil est bien configuré pour recevoir les commandes en ligne. Si vous voyez All active devices are offline, or none is configured to receive payments or orders, c’est l’assignation de l’Active Device elle-même qu’il faut vérifier dans Lightspeed — cette configuration est côté Lightspeed, donc contactez Lightspeed ou le support storekit si aucun appareil n’est assigné.

​

Renvoyer ensuite la commande en échec

Une fois l’application ouverte et connectée :

1. Ouvrez la commande en échec — Live Orders → la commande, ou All Orders → la commande.
2. Cliquez sur More actions → Resend order to POS. Vous verrez Queued POS order injection retry.
3. Surveillez le statut de la commande. Il doit passer à Accepted dès que Lightspeed la confirme. Si elle échoue à nouveau avec la même raison, l’appareil n’est toujours pas connecté — reprenez la checklist ci-dessus.

Les commandes faisant partie d’un ajout à une addition doivent être saisies sur le POS ou refaites en tant que nouvelle commande.

​

« Cette commande a déjà été envoyée au POS »

Parfois le renvoi est refusé au lieu d’être mis en file : This order has already been sent to the POS. Resending it would create a duplicate POS order. Cela signifie que Lightspeed Cloud a confirmé à storekit avoir reçu la commande — lors de l’envoi initial ou d’une des relances — et storekit a enregistré cette confirmation sur la commande. storekit ne renvoie pas une commande que Lightspeed a déjà acceptée, car Lightspeed la traiterait comme une nouvelle commande et la caisse l’imprimerait deux fois. La caisse peut malgré tout être vide. Lightspeed Cloud accepte la commande, puis essaie de la transmettre à l’Active Device. Si l’iPad était hors ligne pendant cette tentative, la fenêtre de livraison s’est refermée : la commande est acceptée côté Lightspeed mais jamais imprimée. Remettre l’iPad en ligne maintenant ne la rejoue pas. Marche à suivre :

1. Vérifiez que Lightspeed a bien la commande : cherchez-la dans la liste des commandes en ligne de l’application Lightspeed sur l’Active Device, ou dans Lightspeed Back Office, avec le numéro de commande storekit.
2. Si elle y est, la caisse l’a — il n’y a rien de plus à faire côté storekit.
3. Sinon, saisissez les articles à la main dans Lightspeed depuis les détails de la commande dans storekit, pour que la cuisine ait son ticket et que votre fin de journée reste juste. Le client a déjà payé via storekit (sauf si la commande indique qu’elle a été passée en espèces), donc ne prenez pas le paiement une seconde fois.
4. Passez ensuite par Remettre l’iPad en ligne pour que la prochaine commande ne se perde pas de la même manière.

​

Vérifier que tout est rentré dans l’ordre

• Passez une petite commande de test et vérifiez qu’elle arrive à la caisse.
• Surveillez Live Orders pendant quelques minutes — aucune nouvelle commande ne devrait passer en Retrying.
• Si vous recevez des e-mails d’échec pour chaque commande, considérez la caisse comme hors ligne tant qu’une commande de test n’est pas arrivée.

​

Empêcher que ça se reproduise

L’Active Device Lightspeed configuré pour recevoir les commandes en ligne doit être traité comme une infrastructure, pas comme un iPad d’appoint :

• Laissez-le en charge en permanence. Cela seul élimine la plupart de ces échecs.
• Gardez-le sur l’application Lightspeed. Ne l’utilisez pas pour autre chose et ne laissez pas le personnel sortir de l’application.
• Activez l’Apple Guided Access sur cet iPad pour que l’application Lightspeed ne puisse pas être quittée, et désactivez le verrouillage automatique.
• Donnez-lui un Wi-Fi stable. Si la caisse est en bordure de couverture, la session tombe par intermittence et vous verrez des erreurs de connectivité comme NIOCore.ChannelError 0.
• Ne l’emportez pas chez vous ni hors site, et ne comptez pas sur un appareil qui sert aussi de terminal de prise de commande mobile.

​

Commandes en ligne désactivées dans Lightspeed

Si la raison de l’échec est Business location doesn't accept online orders at the moment. ou Ordering_disabled, l’iPad est en ligne mais les commandes en ligne sont en pause dans l’application Lightspeed. Un renvoi ne servira à rien tant qu’elles ne sont pas réactivées :

1. Appuyez sur les quatre points de la barre de navigation (onglet Status Preview).
2. Appuyez sur l’icône du sac de courses dans le menu d’état.
3. Utilisez l’invite pour activer les commandes en ligne.

Renvoyez ensuite la commande avec More actions → Resend order to POS.

​

Toujours en échec

Si l’iPad est chargé, ouvert, connecté et configuré pour recevoir les commandes en ligne, et que les commandes échouent quand même :

• Vérifiez que Integration Status dans Stores → votre établissement → Settings → Integrations → Lightspeed K-Series affiche Enabled - sending orders to Lightspeed.
• Vérifiez les autres causes d’échec de commande dans le Dépannage Lightspeed — un profil de compte manquant ou un code produit absent fait échouer les commandes avec une raison différente.
• Contactez le support storekit avec un numéro de commande d’exemple. Des timeouts répétés sur un appareil qui semble sain nécessitent en général que Lightspeed examine la session de l’appareil.