Lightspeed K-Series

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

​

É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 :

​

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.

​

Synchronisation du menu

​

Ce qui est synchronisé

​

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

​

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.

​

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

​

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

​

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.

​

Fonctionnalités prises en charge