> ## 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 et routage Lightspeed

> Comment storekit injecte les commandes dans Lightspeed K-Series : routage par profil de compte, paiements, remises et bufferisation des pré-commandes.

storekit met chaque commande en ligne en file d'attente pour Lightspeed dès qu'elle est passée — vous n'avez pas besoin de l'accepter au préalable. Les pré-commandes peuvent être retenues avec **Buffer Orders**.

## Comment une commande arrive à Lightspeed

| Type de commande | Commande Lightspeed | Détails supplémentaires envoyés |
| - | - | - |
| Retrait | Commande to-go | Code de retrait, heure de retrait dans la note de commande |
| Livraison | Commande to-go | Adresse de livraison, ligne d'article des frais de livraison, code de retrait, heure de livraison dans la note de commande |
| Sur place | Commande locale | Numéro de table (POS ID Lightspeed de la table) |
| Ajout à l'addition | Addition Lightspeed existante | L'identifiant de compte de l'addition à la place d'une nouvelle commande |

Chaque commande transmet également le nom, l'email et le numéro de téléphone du client, les articles avec leurs SKU et modificateurs, le pourboire et la note de commande générée.

> [!NOTE]
>
> Le code de retrait affiché par Lightspeed correspond au code de commande storekit — Lightspeed le limite à 8 caractères.

## Routage par profil de compte

Sous **Account Profile Codes** dans **Stores** → votre établissement → **Settings** → **Integrations** → **Lightspeed K-Series**, vous mappez chaque type de traitement à un profil de compte Lightspeed. Les quatre lignes sont fixes : **Pickup**, **Delivery**, **In Store** et **Add to Bill**. Chaque liste déroulante affiche les profils de compte issus de votre business location Lightspeed.

Si une ligne n'est pas renseignée, storekit envoie le code de profil de compte `storekit`, qui doit exister dans Lightspeed. Lorsqu'une commande est ajoutée à une addition existante, le profil **Add to Bill** l'emporte sur le profil du type de traitement.

## Paiement, remises et frais

* **Payment Method** — le mode de paiement Lightspeed sur lequel le paiement de la commande est enregistré. Par défaut à `STOREKIT` si rien n'est sélectionné.
* **Send cash payments as paid** — désactivé par défaut : les commandes en espèces sont envoyées sans paiement appliqué, de sorte que le personnel voit un solde ouvert et l'encaisse lorsque le client paie. Activez-le pour envoyer les commandes en espèces comme déjà payées. Les commandes par carte et autres commandes prépayées sont toujours envoyées comme payées. Voir [commandes en espèces et à régler au retrait](/docs/fr/guides/payments/cash-payments).
* **Discount Product Code (SKU)** — utilisé pour une ligne d'article de remise négative. Si le code de remise storekit possède un **POS ID** correspondant à un code de remise Lightspeed, storekit applique cette remise Lightspeed native aux articles de la commande au lieu d'ajouter la ligne d'article. Les remises de type livraison gratuite n'ajoutent pas de ligne de remise, car la ligne de livraison à 0 £ reflète déjà les frais annulés.
* **Service Charge Product Code (SKU)** — ligne d'article utilisée pour les frais de service de la commande.
* **Delivery Product Code (SKU)** — ligne d'article utilisée pour les frais de livraison sur les commandes de livraison.
* **Don't send customer email address to Lightspeed** — envoie une adresse email vide, pour les établissements qui ne souhaitent pas voir les emails clients dans le POS. Le nom et le numéro de téléphone sont tout de même envoyés.

> [!WARNING]
>
> Ces codes produits doivent exister dans votre menu Lightspeed. Un SKU manquant fait rejeter toute la commande par Lightspeed.

Sur les commandes sur place, storekit envoie également le [numéro de cours](/docs/fr/guides/menu/course-assignments) de chaque article afin que Lightspeed puisse déclencher la commande par cours.

## Notes de commande

**Order Note Template** sur la page des paramètres Lightspeed contrôle la note envoyée avec chaque commande (jusqu'à 250 caractères). Cliquez sur **Insert Variable** pour voir les variables disponibles et sur **Preview** pour vérifier le résultat avec des données d'exemple. storekit ajoute automatiquement l'heure de retrait ou de livraison à la note.

## Bufferisation des pré-commandes

Par défaut, une pré-commande est envoyée à Lightspeed immédiatement, ce qui peut encombrer la cuisine des heures à l'avance. Pour la retarder :

1. Activez **Buffer Orders**.
2. Définissez éventuellement **Buffer (in minutes)** (0–720) — la commande est injectée ce nombre de minutes avant l'heure de traitement demandée.

Avec **Buffer Orders** activé et **Buffer (in minutes)** vide, storekit utilise le calcul normal du temps de préparation de l'établissement pour décider du moment de l'injection. Les commandes sans heure demandée ne sont jamais bufferisées.

> [!TIP]
>
> 15 à 30 minutes est un bon point de départ pour une cuisine chargée.

## Ajout à l'addition

Pour les commandes sur place sur des tables dans une zone qui accepte le pay-at-table, **Add to bill batching for all orders** envoie chaque commande sur l'addition Lightspeed ouverte de la table plutôt que de créer une commande séparée. Le profil de compte **Add to Bill** est utilisé, et le paiement n'est pas appliqué à la commande car il est réglé sur l'addition. Voir [Pay at Table](/docs/fr/guides/integrations/pos/lightspeed/pay-at-table).

## Lorsqu'une commande échoue

Lightspeed signale le résultat de chaque commande par webhook :

* **Succès** — la commande est marquée **Accepted** dans storekit et la référence du ticket Lightspeed est enregistrée.
* **Échec** — storekit remet la commande en file d'attente et relance. Une commande immédiate est marquée **Failed** après 5 tentatives ; une pré-commande continue d'être relancée jusqu'à ce que son heure demandée soit proche, puis elle est marquée **Failed**. Une fois la commande **Failed**, la raison de l'échec est enregistrée avec elle, un email est envoyé à l'établissement et un ticket d'échec est imprimé si l'établissement dispose d'imprimantes. Les commandes ajoutées à une addition existante, ainsi que les échecs dont la raison est que l'article n'a pas pu être ajouté, ne sont pas relancées — elles sont marquées **Failed** dès le premier échec.
* Si la raison de l'échec est une restriction de vente, storekit met également en veille les articles concernés — voir [Stock et disponibilité](/docs/fr/guides/integrations/pos/lightspeed/stock-and-availability).

storekit donne également à Lightspeed un délai d'acceptation de la commande qui varie selon l'éloignement d'une pré-commande : une minute pour les commandes immédiates, jusqu'à six heures pour les commandes prévues à plus d'une semaine.

Si Lightspeed rejette l'accès de storekit (un 403), la commande échoue avec *"Our access to your Lightspeed account has been disabled, please re-enable the integration user or speak to support"* — voir [Dépannage](/docs/fr/guides/integrations/pos/lightspeed/troubleshooting).

### L'email d'échec de commande

L'email est envoyé une seule fois, lorsque la commande est finalement marquée **Failed** — pas à chaque relance. Le sujet est `Lightspeed Issue: Order #<order number> for store: <store name>` et la raison de l'échec figure dans le corps. Il est envoyé à la liste **Email address** de l'établissement dans **Stores** → votre établissement → **Settings** → **General** (la première adresse comme destinataire, les autres en copie cachée), et à personne d'autre : l'email avec lequel vous vous connectez au tableau de bord ne reçoit rien à moins de figurer dans cette liste. Si cette liste est vide, aucun email n'est envoyé. Voir [Je ne reçois pas les emails d'échec de commande](/docs/fr/guides/integrations/pos/lightspeed/troubleshooting#je-ne-recois-pas-les-emails-dechec-de-commande).

Toute autre raison d'échec est le message propre à Lightspeed, enregistré mot pour mot. Les trois que vous êtes le plus susceptible de voir sont *"Not processed before validity ended"* (l'Active Device était hors ligne — voir [Commandes en échec : caisse hors ligne](/docs/fr/guides/integrations/pos/lightspeed/till-offline)), *"…one of the items in the order has a Disconnected status in Lightspeed"* (Lightspeed ne considère pas un article de la commande comme actif sur la location — voir [Dépannage](/docs/fr/guides/integrations/pos/lightspeed/troubleshooting#une-commande-a-echoue-car-un-article-a-le-statut-disconnected-dans-lightspeed)) et *"Failed to sync order Validation failed for method … placeToGoOrder …"* dans le fil de la commande (Lightspeed a refusé le contenu de la commande avant de l'accepter, donc les règles de nouvelle tentative et d'e-mail ci-dessus ne se déclenchent jamais — voir [Dépannage](/docs/fr/guides/integrations/pos/lightspeed/troubleshooting#une-commande-a-echoue-avec-validation-failed-for-method--placetogoorder)).

## Étapes suivantes

> **[Stock et disponibilité](/docs/fr/guides/integrations/pos/lightspeed/stock-and-availability)**
>
> Empêchez les articles épuisés d'apparaître au menu

> **[Pay at Table](/docs/fr/guides/integrations/pos/lightspeed/pay-at-table)**
>
> Additions, paiements et ajout à l'addition


## Related topics

- [Stock et disponibilité Lightspeed](/docs/fr/guides/integrations/pos/lightspeed/stock-and-availability.md)
- [Commandes et routage Toast](/docs/fr/guides/integrations/pos/toast/orders.md)
- [Connecter Lightspeed](/docs/fr/guides/integrations/pos/lightspeed/connect.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)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.