> ## 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.
# Commandes en échec : caisse hors ligne
> Corrigez l'échec de commande Lightspeed K-Series le plus courant : l'Active Device (iPad maître) hors ligne. Remettez l'iPad en ligne et renvoyez la commande.
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 :
| Erreur remontée par Lightspeed | Ce que ça veut dire |
| - | - |
| `Not processed before validity ended` | L'Active Device n'a jamais récupéré la commande avant l'expiration de la fenêtre Lightspeed. De loin la plus fréquente. |
| `Failed to process the order because the K-Series iPad App is off.` | Lightspeed constate que l'application sur l'Active Device n'est pas en cours d'exécution. |
| `All active devices are offline, or none is configured to receive payments or orders` | Aucun appareil n'est en ligne, ou aucun appareil n'est configuré pour recevoir les commandes en ligne. |
| `NIOCore.ChannelError 0` (souvent à l'intérieur d'un message Lightspeed plus long) | La connexion ou la session de l'Active Device vers les serveurs Lightspeed a été coupée. |
> [!NOTE]
>
> `Business location doesn't accept online orders at the moment.` et `Ordering_disabled` **ne relèvent pas** de ce problème — l'iPad est en ligne mais les commandes en ligne ont été désactivées dans l'application Lightspeed. Voir [Commandes en ligne désactivées dans Lightspeed](#commandes-en-ligne-desactivees-dans-lightspeed) plus bas.
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](https://www.lightspeedhq.com/) ou [le support storekit](/docs/fr/getting-started/contact-support) 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.
> [!NOTE]
>
> **Resend order to POS** n'apparaît que tant que la commande n'a pas de référence de ticket POS. Si la commande a déjà atteint Lightspeed, il n'y a rien à renvoyer — vérifiez la caisse. Si l'option est bien présente mais le renvoi est refusé, voir [« Cette commande a déjà été envoyée au POS »](#cette-commande-a-deja-ete-envoyee-au-pos) plus bas.
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](#remettre-lipad-en-ligne) pour que la prochaine commande ne se perde pas de la même manière.
> [!WARNING]
>
> Cliquer à nouveau sur **Resend order to POS** ne sert à rien ici. Chaque clic met en file une nouvelle tentative et toutes sont refusées avec le même message. Si vous avez besoin de la commande sur la caisse, saisissez-la à la main.
## 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](/docs/fr/guides/integrations/pos/lightspeed/troubleshooting) — un profil de compte manquant ou un code produit absent fait échouer les commandes avec une raison différente.
* [Contactez le support storekit](/docs/fr/getting-started/contact-support) 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.
## Related topics
- [Dépannage Lightspeed](/docs/fr/guides/integrations/pos/lightspeed/troubleshooting.md)
- [Commandes et routage Lightspeed](/docs/fr/guides/integrations/pos/lightspeed/orders.md)
- [Injection de commande](/docs/fr/guides/integrations/pos/order-injection.md)
- [Lightspeed K-Series](/docs/fr/guides/integrations/pos/lightspeed/overview.md)
- [Commandes en échec : caisse endormie](/docs/fr/guides/integrations/pos/syrve/till-offline.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.