Passer au contenu principal

Guide d'intégration | Lightspeed K-Series vers Stayntouch

Ce document fournit un guide étape par étape pour configurer l'intégration entre Lightspeed K-Series et Stayntouch dans notre système, le DataHub.

Aperçu du guide

Ce guide propose des instructions complètes pour établir et personnaliser l'intégration entre Lightspeed K-Series → Stayntouch via le DataHub. Il comprend les sections suivantes :

  • Accéder au DataHub :

    • Étapes détaillées pour accéder à notre système, le DataHub.

  • Configurer les paramètres du POS (Lightspeed K-Series) :

    • Conseils approfondis pour configurer vos paramètres POS dans le DataHub.

  • Configurer les paramètres du backend Lightspeed :

    • Après la configuration des paramètres Lightspeed spécifiques dans le DataHub, des ajustements sont nécessaires dans le backend Lightspeed.

  • Configurer les paramètres Stayntouch :

    • Instructions détaillées pour configurer et personnaliser vos paramètres Stayntouch dans le DataHub.

  • Configurer le mappage dans le DataHub :

    • Instructions précises pour aligner les groupes de produits du POS avec les codes de charge (charge codes) de Stayntouch.

Veuillez suivre chaque section avec attention afin de garantir une configuration d'intégration fluide et efficace.

Exigences pour la configuration de l'intégration

Pour établir l'intégration Lightspeed K-Series → Stayntouch, les informations suivantes sont nécessaires :

1. Catégories comptables dans Stayntouch

Avant de commencer le processus d'intégration, les catégories comptables suivantes doivent être créées dans Stayntouch :

  • Un compte paymaster dans Stayntouch nommé Lightspeed

  • Un code de charge nommé Fallback Revenue Lightspeed

  • Un code de charge nommé Fallback Payments Lightspeed

  • Un code de charge nommé Service Charge Lightspeed

  • Un code de charge nommé Gratuity Lightspeed

De plus, pendant le processus d'intégration, il est essentiel de lier vos catégories de produits et vos modes de paiement de Lightspeed à un code de charge. Par exemple, si vous avez une catégorie de produits nommée « Beer », assurez-vous qu'il existe un code de charge nommé « Beverages » ou « Alcohol ». De même, pour les modes de paiement comme Visa, créez un code de charge nommé « Visa » ou « Credit Card ». Veuillez vous assurer que ces codes de charge sont créés avant l'intégration, car vous en aurez besoin pendant le processus de mappage.

Accéder au DataHub

Pour accéder au DataHub, suivez ces étapes :

  1. Obtenir les identifiants de connexion :

    • Assurez-vous d'avoir reçu des identifiants de connexion d'un agent du support Omniboost. Si vous ne les avez pas reçus, veuillez les demander à votre contact désigné chez Omniboost.

  2. Accéder au DataHub :

  3. Saisir vos identifiants :

    • E-mail : Saisissez l'adresse e-mail que vous avez utilisée pour créer le compte.

    • Mot de passe : Saisissez le mot de passe que vous avez reçu par e-mail.

  4. Sélectionner « Remember Me » (Se souvenir de moi) :

    • Cochez la case Remember me pour enregistrer vos identifiants de connexion pour un accès ultérieur.

  5. Cliquer sur « Login » (Connexion) :

    • Appuyez sur le bouton Login pour continuer.

Remarque : Pour un guide visuel, veuillez vous référer à l'image ci-dessous pour plus d'informations.

Configurer l'authentification à deux facteurs (2FA)

  1. Se connecter au DataHub :

    • Assurez-vous d'être connecté au DataHub avec vos identifiants.

  2. Lancer la configuration de la 2FA :

    • Localisez et cliquez sur le bouton Enable (Activer) pour démarrer le processus de configuration de l'authentification à deux facteurs (2FA).

  3. Suivre les instructions :

    • Suivez les instructions à l'écran pour terminer la configuration de la 2FA. Cela implique de lier votre compte à une application d'authentification (par ex. Google Authenticator, Authy) sur votre téléphone et de saisir un code de vérification.

  4. Terminer la configuration :

    • Une fois la configuration de la 2FA terminée, confirmez les étapes ou paramètres supplémentaires selon les invites.

Important : L'activation de la 2FA est une étape cruciale pour renforcer la sécurité de votre compte. Veillez à suivre attentivement toutes les instructions afin de vous assurer que la 2FA est correctement configurée. Si vous ignorez cette étape, vous ne pourrez plus vous reconnecter. Si cela vous arrive accidentellement, veuillez contacter pos-support@omniboost.io

Étapes pour configurer la 2FA :

  1. Scanner le QR code :

    • Sur l'écran où vous avez cliqué sur Enable, vous verrez un QR code.

    • Téléchargez une application 2FA telle que Google Authenticator ou Authy sur votre smartphone.

    • Ouvrez l'application et utilisez-la pour scanner le QR code affiché à l'écran. Ce QR code configurera vos codes 2FA.

  2. Générer et saisir le code 2FA :

    • L'application 2FA commencera à générer un nouveau code d'authentification toutes les 30 secondes.

    • Saisissez le code actuel de votre application dans le champ prévu à cet effet sur l'écran du DataHub pour terminer la configuration.

  3. Enregistrer les codes de récupération :

    • Veillez à noter les codes de récupération affichés à l'écran.

    • Ces codes de récupération peuvent être utilisés pour accéder à votre compte si vous perdez l'accès à votre application 2FA.

  4. Terminer la configuration :

    • Suivez les invites supplémentaires pour finaliser la configuration de la 2FA.

Important : Assurez-vous de conserver vos codes de récupération en lieu sûr. Ils sont essentiels pour accéder à votre compte si vous perdez un jour l'accès à votre application 2FA.

Démarrer la configuration de l'intégration

  1. Accéder à l'écran suivant :

    • Après avoir créé votre utilisateur et configuré l'authentification à deux facteurs (2FA), vous serez dirigé vers l'écran suivant.

  2. Cliquer sur « Start Setup » (Démarrer la configuration) :

    • Sur cet écran, repérez et cliquez sur le bouton Start setup pour commencer à configurer l'intégration.

Remarque : Pour un guide visuel, veuillez vous référer à l'image ci-dessous pour plus d'informations.

Configurer les paramètres de Lightspeed K-Series (POS)

  1. Se connecter à Lightspeed K-Series :

    • Sur l'écran de configuration, repérez et cliquez sur le bouton Connect (Connexion) pour initier la connexion à Lightspeed K-Series.

  2. Se connecter avec vos identifiants :

    • Saisissez vos identifiants de connexion Lightspeed K-Series lorsque vous y êtes invité.

  3. Autoriser :

    • Une fois connecté, sélectionnez tous les curseurs (sliders) et appuyez sur Authorize (Autoriser).

Dépannage : Si vous rencontrez une erreur serveur, veuillez vérifier que votre mot de passe est correct. Si vous êtes certain que le mot de passe est exact mais que vous rencontrez toujours des problèmes, essayez de vous connecter en utilisant une fenêtre de navigation privée ou incognito pour contourner d'éventuels problèmes de cache.

Remarque : Pour un guide visuel, veuillez vous référer à l'image ci-dessous pour plus d'informations.

Paramètres Lightspeed (POS)

Maintenant que vous êtes connecté avec Lightspeed, vous arriverez sur l'écran de configuration. Ci-dessous, vous trouverez des explications sur les paramètres et les informations à saisir, illustrées par un exemple simple pour plus de clarté :

  1. Sélectionner votre société Lightspeed :

    • Commencez par choisir la société Lightspeed correspondant à l'emplacement commercial spécifique où vous utiliserez l'intégration Lightspeed K-Series vers Stayntouch.

  2. Sélectionner le « On Room Payment Type » (type de paiement sur chambre) :

    • À cette étape, vous devez sélectionner le type de paiement associé aux Room Charges (imputations sur chambre). Dans la plupart des cas, ce bouton s'appelle Room Charge ou On Room.

      • Vous pouvez le vérifier dans votre back-office Lightspeed en accédant à : Configurations → Settings → Payment methods (Configurations → Paramètres → Modes de paiement)

  3. Configurer le « Tip Name » (nom du pourboire) :

    • Selon vos préférences, personnalisez la description des pourboires. Elle peut être nommée Tips, Gratuity ou tout autre terme de votre choix.

      • Cette description sera utilisée pour envoyer les pourboires à Stayntouch.

  4. Utiliser les périodes de repas (Meal Periods) :

    • Au sein de cette intégration, il est possible de travailler avec des périodes de repas, qui peuvent être configurées selon des plages horaires spécifiques. Si vous souhaitez utiliser cette fonctionnalité, il vous suffit de cocher la case correspondante.

  5. Sélectionner les périodes de repas :

    • Si vous souhaitez utiliser cette fonctionnalité, veuillez vous assurer d'avoir une couverture sur 24 heures, c'est-à-dire que chaque nouvelle période de repas doit commencer exactement au moment où la précédente se termine. (Voir l'exemple ci-dessous d'un tableau de périodes de repas correctement configuré.)

Remarque : Pour un guide visuel, veuillez vous référer à l'image ci-dessous pour plus d'informations.

Configurer les paramètres du backend Lightspeed

Maintenant que les paramètres Lightspeed sont configurés dans le DataHub, nous devons effectuer quelques ajustements dans votre backend Lightspeed. Suivez ces étapes :

  1. Accéder au backend Lightspeed :

  2. Accéder aux paramètres de configuration :

    • Allez dans Configurations depuis le menu principal.

  3. Accéder aux modes de paiement :

    • Cliquez sur Settings (Paramètres), puis repérez et sélectionnez Payment methods (Modes de paiement).

Remarque : Pour un guide visuel, veuillez vous référer à l'image ci-dessous pour plus d'informations.

Ajuster les paramètres des modes de paiement dans Lightspeed

Maintenant que vous êtes dans la section Payment Methods du backend Lightspeed, suivez ces étapes détaillées pour configurer le mode de paiement Room Charge :

  1. Localiser le mode de paiement Room Charge :

    • Parcourez la liste des modes de paiement pour trouver celui associé aux imputations sur chambre. Il peut être étiqueté « Room Charge » ou similaire.

    • Sinon, créez un nouveau mode de paiement pour les Room Charges.

  2. Définir le mode de paiement :

    • Assurez-vous que le mode de paiement est défini sur Charge to room (imputer sur la chambre).

  3. Sélectionner le serveur PMS :

    • Définissez le serveur PMS sur Other (Autre).

  4. Vérifier les options supplémentaires :

    • Examinez attentivement toutes les autres options disponibles liées à ce mode de paiement afin de vous assurer qu'elles répondent aux besoins de votre entreprise.

  5. Enregistrer les paramètres :

    • Une fois tous les paramètres correctement ajustés, faites défiler jusqu'en bas de la page.

    • Cliquez sur le bouton Save (Enregistrer) pour sauvegarder vos modifications.

Remarque : Pour un guide visuel, veuillez vous référer à l'image ci-dessous pour plus d'informations.

Configurer les paramètres de Stayntouch (PMS)

Les étapes suivantes consistent à configurer les paramètres du PMS, spécifiquement pour Stayntouch. Voici un guide détaillé pour vous accompagner dans ce processus.

  1. Sélectionner un code de charge pour le Default Analysis Code (code d'analyse par défaut) :

    • Dans ce menu déroulant, choisissez le Fallback Revenue dont la création avait été demandée.

      • Objectif : Le Fallback Revenue agit comme un filet de sécurité au cas où une nouvelle catégorie de produits serait générée dans Lightspeed mais non mappée dans le DataHub. Si des données aboutissent dans cette catégorie, veuillez vous reconnecter et vérifier votre mappage.

  2. Sélectionner un code de charge pour le Default Payment Code (code de paiement par défaut) :

    • Dans ce menu déroulant, optez pour le Fallback Payments dont la création avait été demandée.

      • Objectif : Comme pour le Fallback Revenue, le Fallback Payments agit comme une précaution pour les modes de paiement incorrectement mappés dans le DataHub, afin d'éviter toute perte de données.

  3. Sélectionner le bon compte de paiement (Payment Account) :

    • Ici, vous pouvez sélectionner le paymaster que vous avez déjà créé (paymaster « Lightspeed »). Si vous préférez mapper chaque type de paiement séparément, vous pouvez créer un paymaster distinct pour chaque mode de paiement.

  4. Sélectionner le fuseau horaire (Timezone) :

    • Assurez-vous de sélectionner le fuseau horaire correct pour votre établissement.

  5. Sélectionner le code de pourboire (Tip Code) :

    • Dans ce menu déroulant, désignez le code de charge auquel les Tips/Gratuities (pourboires) seront affectés.

  6. Sélectionner le code de frais de service (Service Charge Code) :

    • Dans la plupart des cas, vous pouvez également désigner ici le code de pourboire.

      • Le Service Charge n'est applicable que dans les régions où il est inclus dans la facture. S'il est utilisé, veuillez créer dans Stayntouch un code de charge nommé Service Charge.

  7. Sélectionner le code de frais de service avec TVA (Service Charge with VAT Code) :

    • Dans la plupart des cas, vous pouvez également indiquer ici le code de charge Service Charge. Si vous n'utilisez pas cette option, veuillez attribuer ici le code de charge Tip (pourboire).

      • Le Service Charge n'est pertinent que dans les régions où il est inclus dans la facture. S'il est utilisé, veuillez établir dans Stayntouch un code de charge appelé Service Charge.

  8. Sélectionner VAT/TAX Inc. (TVA/Taxe incluse) :

    • Cochez la case « VAT/TAX inc. » si la TVA/taxe est incluse dans le prix (couramment utilisé en Europe).

Remarque : Une fois les étapes ci-dessus terminées, veuillez cliquer sur Submit (Soumettre) et poursuivre avec les actions suivantes.

Configurer le mappage entre Lightspeed K-Series et Stayntouch

Maintenant que nous avons terminé la configuration des paramètres de Lightspeed K-Series (POS) et de Stayntouch (PMS), la dernière étape consiste à configurer le mappage. Cela garantit que les transactions et les données de Lightspeed sont correctement catégorisées et enregistrées dans Stayntouch.

Instructions étape par étape

  1. Accéder aux paramètres de mappage :

    • Accédez aux paramètres de mappage dans le DataHub. En haut, vous verrez vos étages Lightspeed. Chaque étage peut avoir son propre mappage, mais vous pouvez aussi utiliser le même mappage pour tous les étages en définissant le mappage du premier étage comme mappage par défaut.

  2. Aperçu du mappage :

    • Sur le côté gauche, vous trouverez les catégories de produits de Lightspeed.

    • Sur le côté droit, vous trouverez un menu déroulant avec vos codes de charge Stayntouch.

  3. Créer des mappages logiques :

    • Reliez les groupes de produits de Lightspeed aux codes de charge Stayntouch correspondants.

    • Assurez-vous que votre mappage suit une logique afin de faciliter un transfert et un enregistrement précis des données.

  4. Exemples de scénarios de mappage :

    • Scénario 1 : Mappage direct de catégorie

      • Si vous avez un groupe de produits Lightspeed nommé « Hot Drinks » (relié à des produits comme le chocolat chaud, le café, le thé), assurez-vous qu'il existe un code de charge Stayntouch nommé « Hot Drinks ». Mappez la catégorie Lightspeed « Hot Drinks » à ce code de charge.

    • Scénario 2 : Mappage de catégorie générale

      • Vous pourriez aussi créer un code de charge Stayntouch général nommé « Drinks » et mapper plusieurs groupes de produits Lightspeed (par ex. boissons chaudes, boissons froides, sodas) à cet unique code de charge.

    • Scénario 3 : Mappage simplifié

      • Pour plus de simplicité, vous pourriez mapper tous les groupes de produits Lightspeed liés à la nourriture et aux boissons à un code de charge Stayntouch général nommé « F&B (Food and Beverage) ».

  5. Configurer le mappage (avec les périodes de repas) :

    1. Veuillez mapper tous les étages en haut qui sont liés aux périodes de repas ; vous n'avez pas besoin de mapper les premiers. Retournez à l'« Étape 1 » si vous souhaitez savoir comment configurer les périodes de repas.

      • Cliquez sur « Save Mapping » (Enregistrer le mappage) en bas de l'écran et répétez l'opération pour les autres étages comportant des périodes de repas.

  6. Vérifier et ajuster :

    • Vérifiez le mappage pour vous assurer qu'il correspond aux besoins de votre entreprise.

    • Vous pouvez revoir et ajuster le mappage à tout moment, à mesure que votre entreprise évolue ou que vous trouvez des moyens plus efficaces de catégoriser vos transactions.

Exemple de configuration

Voici un exemple de configuration :

  • Groupe de produits Lightspeed : Hot Drinks

    • Code de charge Stayntouch : Hot Drinks

  • Groupe de produits Lightspeed : Soft Drinks

    • Code de charge Stayntouch : Drinks

  • Groupe de produits Lightspeed : Desserts

    • Code de charge Stayntouch : F&B ou Food

Étapes finales

Après avoir configuré le mappage, vérifiez tous les paramètres pour vous assurer de leur exactitude. Une fois satisfait, vous pouvez procéder au test de l'intégration afin de confirmer que les données circulent correctement entre Lightspeed K-Series et Stayntouch. Cela permettra d'identifier d'éventuels problèmes et de garantir un fonctionnement fluide par la suite. Si vous avez besoin d'aide, veuillez contacter votre interlocuteur chez Omniboost ou envoyer un e-mail à pos-support@omniboost.io

Remarque : Pour un guide visuel, veuillez vous référer à l'image ci-dessous pour plus d'informations.

Avez-vous trouvé la réponse à votre question ?