> ## 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.
# Lightspeed K-Series
> Connectez Lightspeed K-Series (anciennement iKentoo) à storekit pour la synchronisation complète du menu, l'injection de commande, les mises à jour de stock en temps réel, la sync du plan de salle et le pay at table.
Lightspeed K-Series (anciennement iKentoo) est une intégration POS complète offrant une synchronisation bidirectionnelle du menu, l'injection automatique de commande, les mises à jour de stock en temps réel, la synchronisation du plan de salle et la prise en charge du pay at table.
## Prérequis
Avant de connecter Lightspeed K-Series, assurez-vous d'avoir :
* Un abonnement Lightspeed K-Series actif avec accès API
* Un accès admin à votre tableau de bord storekit
* Vos identifiants de back office Lightspeed
## Configuration de la connexion
### Étape 1 : Autoriser storekit
La connexion utilise OAuth, vous autoriserez donc storekit à accéder à votre compte Lightspeed :
1. Allez dans **Paramètres de la boutique > Intégrations** dans votre tableau de bord storekit
2. Trouvez **Lightspeed K-Series** et cliquez sur **Connecter**
3. Vous serez redirigé vers Lightspeed pour vous connecter et autoriser l'accès
4. Après autorisation, vous reviendrez à storekit
### Étape 2 : Sélectionner votre emplacement d'entreprise
Après autorisation, sélectionnez quel emplacement d'entreprise Lightspeed connecter :
1. storekit affichera vos entreprises Lightspeed disponibles
2. Sélectionnez l'emplacement d'entreprise qui correspond à cet établissement
3. Cliquez sur **Connecter** pour lier l'emplacement
Chaque établissement storekit se connecte à un emplacement d'entreprise Lightspeed. Pour les configurations multi-emplacements, connectez chaque établissement séparément.
### Étape 3 : Synchroniser votre menu
Une fois connecté, importez votre menu depuis Lightspeed :
1. Allez dans **Menu** dans votre tableau de bord
2. Cliquez sur **Synchroniser le menu**
3. Sélectionnez quel menu Lightspeed importer
4. Attendez la fin de la synchronisation
La synchronisation importe :
* Catégories (avec sous-écrans en option)
* Produits avec noms, descriptions et prix
* Offres de menu et articles combo
* Groupes de modificateurs et instructions de production
* Informations sur les allergènes
* Images de produits (à partir du contenu enrichi de Lightspeed)
### Étape 4 : Configurer les paramètres d'intégration
Ajustez le comportement de l'intégration :
| Paramètre | Description |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Delivery Fee SKU** | SKU pour les frais de livraison (par défaut : `STOREKIT_DELIVERY`) |
| **Discount SKU** | SKU pour les remises (par défaut : `STOREKIT_DISCOUNT`) |
| **Service Charge SKU** | SKU pour les frais de service (par défaut : `STOREKIT_SERVICE_CHARGE`) |
| **Payment Method** | Code de mode de paiement pour les commandes en ligne (par défaut : `STOREKIT`) |
| **Buffer Orders** | Retarder l'injection des précommandes jusqu'à plus près de l'heure de traitement |
| **Buffer Time** | Minutes avant l'heure de précommande pour injecter la commande |
| **Native Discounts** | Utiliser les codes de remise Lightspeed au lieu des lignes SKU de remise |
| **Send cash payments as paid** | Envoyer les commandes en espèces à Lightspeed avec le paiement déjà appliqué. Laissez désactivé si le personnel doit voir un solde ouvert et le régler lorsque le client paie — voir [commandes en espèces et paiement au retrait](/docs/fr/guides/payments/cash-payments) |
Les SKU doivent exister dans votre menu Lightspeed. Créez des articles avec ces SKU dans Lightspeed avant d'activer l'intégration.
### Codes de remise natifs
Lorsque **Native Discounts** est activé, storekit envoie les codes de remise directement à Lightspeed au lieu d'ajouter une ligne SKU de remise. Cela nécessite :
1. Les codes de remise dans storekit doivent avoir un champ **POS ID** rempli avec l'ID de code de remise Lightspeed correspondant
2. Le code de remise Lightspeed doit être configuré et actif
3. La remise sera appliquée à tous les articles de la commande au niveau du POS
Si un code de remise n'a pas de POS ID ou si le code de remise Lightspeed n'est pas trouvé, storekit revient à l'utilisation de la ligne SKU de remise.
Les remises natives offrent un meilleur reporting dans Lightspeed et garantissent que les remises sont appliquées de manière cohérente avec les règles de remise de votre POS.
## Synchronisation du menu
### Ce qui est synchronisé
| Donnée | Synchronisée |
| -------------------------- | ------------------------------------------ |
| Catégories | Oui |
| Produits | Oui |
| Prix | Oui |
| Descriptions | Oui (peut être désactivé) |
| Images | Oui (peut être désactivé) |
| Modificateurs | Oui |
| Instructions de production | Oui (en tant que groupes de modificateurs) |
| Offres de menu | Oui |
| Allergènes | Oui |
| Contenu multilingue | Oui |
### Options de synchronisation
**Préserver le contenu existant :**
* **Ne pas mettre à jour les images** — Conserver les images ajoutées manuellement pendant la synchronisation
* **Ne pas mettre à jour les descriptions** — Conserver les descriptions modifiées manuellement
**Sous-écrans en tant que catégories :**
Activez ceci pour traiter les sous-écrans Lightspeed comme des catégories distinctes dans storekit.
**Profil de compte pour le chargement du menu :**
Spécifiez un profil de compte pour charger les prix du menu spécifiques à la commande en ligne.
**Langue préférée :**
Sélectionnez la langue à utiliser pour les noms de produits lorsque plusieurs traductions existent.
### Synchronisation manuelle vs planifiée
**Synchronisation manuelle :** Déclenchez à tout moment depuis la page Menu après avoir apporté des modifications dans Lightspeed.
**Synchronisation planifiée :** Configurez une synchronisation automatique à des horaires spécifiques :
1. Allez dans **Paramètres de la boutique > Intégrations > Lightspeed K-Series**
2. Configurez votre planification de synchronisation
3. Recommandation : planifiez pendant les heures creuses (par ex. 5h du matin)
## Injection de commande
Lorsqu'un client passe une commande, elle est automatiquement envoyée à Lightspeed.
### Types de commande
| Type de commande | Endpoint Lightspeed | Profil de compte |
| ---------------- | ------------------- | -------------------------------------- |
| Retrait | To-Go Order | Configurable (par défaut : `storekit`) |
| Livraison | To-Go Order | Configurable (par défaut : `storekit`) |
| Sur place | Local Order | Configurable (par défaut : `storekit`) |
### Ce que reçoit Lightspeed
Chaque commande inclut :
* Tous les articles avec SKU et prix
* Modificateurs (en tant que sous-articles ou IDs de modificateur)
* Nom, email, téléphone du client
* Code de retrait (8 caractères)
* Heure de traitement dans les notes de commande
* Adresse de livraison (pour les commandes de livraison)
* Numéro de table (pour les commandes sur place)
* Pourboires et frais de service
### Mise en tampon des précommandes
Pour les commandes planifiées, vous pouvez contrôler quand elles sont injectées :
* **Injection immédiate** : Commande envoyée au POS juste après paiement
* **Injection en tampon** : Commande envoyée X minutes avant l'heure demandée
Cela empêche les précommandes d'encombrer votre file d'attente cuisine des heures à l'avance.
Pour les établissements très fréquentés, mettez en tampon les précommandes pour qu'elles s'injectent 15 à 30 minutes avant l'heure demandée.
### Logique de nouvelle tentative
Si Lightspeed est temporairement inaccessible :
* storekit réessaie avec un délai exponentiel (jusqu'à 6 tentatives)
* Le timing des tentatives s'adapte selon l'éloignement de la commande planifiée
* Les commandes échouées déclenchent des notifications par email vers l'adresse email de votre établissement
Les notifications par email incluent la raison spécifique de l'erreur, les détails de la commande et un lien direct pour consulter la commande dans votre tableau de bord. Cela garantit que vous ne manquez jamais une commande nécessitant une attention manuelle.
## Mises à jour de stock en temps réel
Lightspeed K-Series prend en charge les mises à jour d'inventaire en temps réel via webhooks :
1. Lorsque vous marquez un article comme restreint ou mettez à jour le stock dans Lightspeed
2. Lightspeed envoie un webhook à storekit
3. storekit met à jour la disponibilité immédiatement
4. Le cache du menu est vidé afin que les clients voient la disponibilité actuelle
### Mise en pause automatique en cas d'échec de commande
Si une commande échoue en raison d'une restriction de vente (article indisponible), storekit :
1. Met en pause automatiquement les articles concernés jusqu'à 8h le lendemain
2. Enregistre l'événement de mise en pause avec la source `lightspeed`
3. Vide le cache du menu
4. Empêche d'autres commandes pour les articles indisponibles
Tous les événements de mise en pause automatique sont suivis dans le rapport de mise en pause pour la visibilité des problèmes de stock.
## Synchronisation du plan de salle
Synchronisez la disposition de vos tables depuis Lightspeed pour les commandes sur place et le pay at table :
1. Allez dans **Boutiques** → votre boutique → **Paramètres** → **Intégrations** → **Lightspeed K-Series**
2. Sous **Fetch Lightspeed Floorplan**, cliquez sur **Sync floorplan** et confirmez
3. Les zones et tables sont importées avec leurs IDs Lightspeed
Les modifications se synchronisent automatiquement :
* Les nouvelles zones et tables sont créées
* Les tables renommées sont mises à jour
* Les tables supprimées sont archivées
## Pay at Table
Lightspeed K-Series prend en charge une intégration pay at table complète :
### Fonctionnement
1. Le client scanne le QR code à sa table
2. storekit récupère l'addition ouverte depuis Lightspeed
3. Le client consulte les articles et sélectionne ce qu'il veut payer
4. Le paiement est traité et appliqué à l'addition Lightspeed
5. Le statut de l'addition se synchronise en temps réel
### Configuration
| Paramètre | Description |
| ---------------------------- | ------------------------------------------------------------------------ |
| **PAT Payment Method** | Code de mode de paiement pour les paiements à table (par défaut : `APM`) |
| **Gift Card Payment Method** | Mode de paiement séparé pour les paiements par carte-cadeau/fidélité |
| **Ignore Free Items** | Ne pas afficher les articles à prix zéro sur l'addition |
| **Auto-close Bills Delay** | Temps d'attente avant de vérifier si l'addition est entièrement payée |
### Synchronisation des additions
storekit maintient les additions synchronisées avec Lightspeed :
* Les articles ajoutés/supprimés dans Lightspeed se mettent à jour automatiquement
* Les paiements effectués au POS sont reflétés
* Les additions déplacées entre les tables sont suivies
* Les frais de service et remises se synchronisent correctement
## Tester votre intégration
### Liste de vérification avant lancement
1. **Synchronisation du menu**
* [ ] Toutes les catégories importées correctement
* [ ] Les produits ont les bons noms et prix
* [ ] Les modificateurs apparaissent sur les bons produits
* [ ] Les images s'affichent (si utilisation des images Lightspeed)
2. **Flux de commande**
* [ ] Passez une commande de retrait test
* [ ] Vérifiez que la commande apparaît dans Lightspeed
* [ ] Vérifiez que les articles, modificateurs et notes sont corrects
* [ ] Confirmez que le code de retrait apparaît
3. **Mises à jour de stock**
* [ ] Marquez un article comme restreint dans Lightspeed
* [ ] Vérifiez qu'il se masque du menu storekit en quelques minutes
4. **Pay at table** (si utilisé)
* [ ] Ouvrez une addition dans Lightspeed
* [ ] Scannez le QR code pour consulter l'addition
* [ ] Finalisez un paiement test
* [ ] Vérifiez que le paiement apparaît dans Lightspeed
## Dépannage
### Connexion expirée
Si vous voyez des erreurs d'autorisation :
* Le refresh token peut avoir expiré
* Allez dans Paramètres de la boutique > Intégrations et réautorisez
### Le menu ne se synchronise pas
* Assurez-vous que le menu est publié dans Lightspeed
* Vérifiez que les produits sont actifs et assignés à des catégories
* Vérifiez que le bon menu est sélectionné dans storekit
* Consultez les erreurs de synchronisation dans le tableau de bord
### Les commandes n'apparaissent pas
* Vérifiez que l'intégration est activée (pas seulement connectée)
* Vérifiez que les profils de compte existent dans Lightspeed
* Assurez-vous que les SKU requis existent (`STOREKIT_DELIVERY`, `STOREKIT_DISCOUNT`, etc.)
* Consultez la commande dans le tableau de bord storekit pour les messages d'erreur
### Articles erronés dans les commandes
* Vérifiez que les SKU correspondent entre les systèmes
* Vérifiez que les groupes de modificateurs sont correctement synchronisés
* Pour les offres de menu, assurez-vous que la structure de l'offre correspond
### Le stock ne se met pas à jour
* Vérifiez que les webhooks sont correctement configurés
* Vérifiez que l'emplacement d'entreprise est ajouté au webhook
* Confirmez que les SKU d'articles correspondent entre les systèmes
Pour toute assistance supplémentaire, [contactez le support](/docs/fr/getting-started/contact-support).
## Fonctionnalités prises en charge
| Fonctionnalité | Prise en charge |
| --------------------------------------- | :-------------: |
| Sync menu automatique | ✓ |
| Sync allégée (prix uniquement) | ✗ |
| Images produits | ✓ |
| Allergènes | ✓ |
| Calories | ✓ |
| Modificateurs imbriqués | ✓ |
| Sous-catégories | ✓ |
| Horaires de disponibilité par catégorie | ✗ |
| Portions / tailles | ✗ |
| Plats | ✗ |
| Instructions de production | ✓ |
| Offres de menu | ✓ |
| Contenu multilingue | ✓ |
| Statut du stock | ✓ |
| Fonctionnalité | Prise en charge |
| --------------------------------------- | :-------------: |
| Injection de commande | ✓ |
| Précommandes | ✓ |
| Mise en tampon des commandes | ✓ |
| Validation du panier | ✗ |
| Mise en pause auto des articles épuisés | ✗ |
| Remises | ✓ |
| Pourboires | ✓ |
| Frais de service | ✓ |
| Notes de commande personnalisées | ✗ |
| Détails de livraison | ✓ |
| Fonctionnalité | Prise en charge |
| ------------------------------------- | :-------------: |
| Sync addition en direct | ✓ |
| Application de paiements à l'addition | ✓ |
| Paiements partagés | ✓ |
| Suivi des paiements terminal POS | ✓ |
| Ajout à une addition existante | ✗ |
| Paiements par carte-cadeau | ✓ |
| Fonctionnalité | Prise en charge |
| ----------------------------------- | :-------------: |
| Sync plan de salle | ✓ |
| Mises à jour de stock en temps réel | ✓ |
| Prise en charge multi-sites | ✓ |
## Related topics
- [Injection de commande](/docs/fr/guides/integrations/pos/order-injection.md)
- [Affectation aux services](/docs/fr/guides/menu/course-assignments.md)
- [Vue d'ensemble des intégrations](/docs/fr/guides/integrations/overview.md)
- [Gérer les commandes en direct](/docs/fr/guides/orders/managing-live-orders.md)
- [Imprimer les modificateurs comme des produits](/docs/fr/guides/menu/print-modifiers-as-products.md)