TISSL

L’intégration TISSL permet l’injection automatique de commande vers votre POS TISSL et une fonctionnalité pay at table complète. Contrairement aux intégrations avec synchronisation de menu, TISSL utilise la liaison manuelle des produits via des IDs produit (PLU) — vous construisez votre menu dans storekit et liez les produits à leurs équivalents TISSL.

​

Prérequis

Avant de configurer TISSL :

• Système POS TISSL actif
• Clé API TISSL
• ID d’organisation TISSL
• Liste des IDs de produit pour les articles de votre menu
• Accès admin à votre tableau de bord storekit

​

Configuration de la connexion

​

Étape 1 : Connecter TISSL

1. Allez dans Paramètres de la boutique > Intégrations dans votre tableau de bord storekit
2. Trouvez TISSL et cliquez sur Connecter
3. Saisissez vos identifiants TISSL :
   • API Key — Votre clé d’authentification API TISSL
   • Organisation ID — Votre identifiant d’organisation TISSL
4. Cliquez sur Connecter

storekit vérifie les identifiants en vérifiant le statut live TISSL avant l’enregistrement.

​

Étape 2 : Sélectionner votre site

Après authentification :

1. storekit peut récupérer les sites disponibles dans votre organisation TISSL
2. Sélectionnez le site qui correspond à cet établissement storekit
3. Le Site ID est enregistré pour le routage des commandes

​

Étape 3 : Configurer les paramètres d’intégration

Configurez les paramètres TISSL requis :

​

Étape 4 : Lier les produits

Pour chaque produit dans votre menu storekit :

1. Allez dans Menu et sélectionnez un produit
2. Trouvez le champ POS ID
3. Saisissez l’ID de produit exact de TISSL
4. Enregistrez le produit

Répétez pour tous les produits et modificateurs.

​

Fonctionnement de la liaison des produits

TISSL utilise la liaison manuelle — les produits ne sont pas synchronisés automatiquement :

1. Vous créez votre menu dans storekit
2. Vous saisissez l’ID de produit TISSL pour chaque article
3. Lorsque des commandes sont passées, storekit envoie les IDs de produit
4. TISSL fait correspondre les IDs aux produits et traite la commande

Cela vous donne un contrôle total sur la présentation du menu en ligne tout en maintenant la compatibilité POS.

​

Liaison des modificateurs

Les modificateurs nécessitent à la fois un ID de produit et un ID de groupe :

1. Allez dans vos groupes de modificateurs dans storekit
2. Pour chaque groupe de modificateurs, saisissez le nom/ID de groupe TISSL
3. Pour chaque option de modificateur, saisissez l’ID de produit TISSL
4. Enregistrez les modifications

storekit envoie les modificateurs dans le format que TISSL attend :

• modifierGroups : Tableau de noms de groupes
• modifiers : Tableau avec paires nom de groupe et nom de modificateur

​

Injection de commande

Lorsqu’un client passe une commande, storekit l’envoie à l’endpoint /order de TISSL.

​

Canaux de commande

​

Ce que reçoit TISSL

Chaque commande inclut :

• ID d’organisation et Site ID
• ID de commande externe (ID de commande storekit)
• Description de la commande (code de commande ou numéro de table)
• Nombre de clients
• Type de commande
• Paramètres de frais de service
• Tous les articles avec :
  • ID de produit
  • Quantité
  • Prix brut et net
  • Attribution de plat
  • Notes d’article
  • Groupes de modificateurs et modificateurs
• Articles de paiement (pour les commandes non-espèces)
• Coordonnées du client avec adresse
• Notes de commande

​

Mise en tampon des précommandes

Pour les commandes planifiées, vous pouvez activer la mise en tampon :

• Buffer Orders — Activer pour retarder l’injection de commande
• Les commandes sont retenues jusqu’à plus près de l’heure de traitement
• Un décalage est ajouté pour empêcher les commandes simultanées d’échouer

​

Frais de livraison et remises

Le cas échéant, storekit ajoute des lignes pour :

• Frais de livraison : Utilise l’ID de produit Delivery Fee configuré
• Remises : Utilise l’ID de produit Discount configuré avec un prix négatif

​

Ajout à une addition existante

Pour les commandes sur place, storekit vérifie l’existence d’une addition sur la table :

• Si trouvée, la commande est ajoutée à l’addition existante
• Sinon, une nouvelle addition est créée

Configurez All Orders Add To Bill pour contrôler ce comportement.

​

Pay at Table

TISSL 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 TISSL via /order/table/{tableId}/{orgId}/{siteId}
3. Le client consulte les articles et sélectionne ce qu’il veut payer
4. Le paiement est traité et envoyé à TISSL via /order/payment
5. Le statut de l’addition se synchronise en temps réel

​

Synchronisation des additions

storekit maintient les additions synchronisées avec TISSL :

• Les articles ajoutés/supprimés dans TISSL se mettent à jour automatiquement
• Les paiements effectués au POS sont suivis
• Les additions déplacées entre les tables sont suivies
• Les frais de service et remises se synchronisent correctement
• Les lignes de taxe sont synchronisées par article

​

Configuration

​

Synchronisation des tables

Récupérez la disposition de vos tables depuis TISSL :

1. Allez dans Boutiques → votre boutique → Paramètres → Intégrations → Tissl
2. Cliquez sur Sync floorplan et confirmez
3. Les zones commerciales et emplacements sont importés en tant que zones et tables

Les tables incluent :

• Nom et ID de zone
• Nom et ID de table
• Capacité
• Statut actif

​

Référence des paramètres d’intégration

​

Tester votre intégration

​

Liste de vérification avant lancement

1. Connexion
   • API Key et Organisation ID vérifiés
   • Site sélectionné correctement
2. Configuration
   • Order Type existe dans TISSL
   • Payment Type configuré
   • Course assigné
   • Produit Delivery Fee créé (si livraison)
   • Produit Discount créé (si remises)
3. Liaison des produits
   • Tous les produits ont des IDs de produit TISSL
   • Tous les modificateurs ont des IDs de produit
   • Les groupes de modificateurs ont des noms de groupe
4. Flux de commande
   • Passer une commande test
   • Vérifier que les articles apparaissent correctement dans TISSL
   • Vérifier que les modificateurs s’affichent correctement
   • Confirmer que les prix correspondent
5. Pay at table (si utilisé)
   • Tables synchronisées
   • Ouvrir une addition dans TISSL
   • Consulter l’addition via storekit
   • Finaliser un paiement test

​

Dépannage

​

Échec de connexion

• Vérifiez que l’API Key est correcte et active
• Vérifiez que l’Organisation ID correspond à votre compte
• Confirmez que le système TISSL est en ligne (vérification du statut live)

​

Les commandes n’apparaissent pas

• Vérifiez que l’intégration est activée
• Vérifiez que le Site ID est correct
• Consultez la commande dans le tableau de bord pour les messages d’erreur
• Confirmez que Order Type et Payment Type existent dans TISSL

​

Articles manquants

• Vérifiez que les IDs de produit sont correctement saisis
• Vérifiez que les produits existent dans TISSL
• Les articles sans IDs de produit sont ignorés avec un avertissement

​

Problèmes de modificateurs

• Assurez-vous que les groupes de modificateurs ont des noms/IDs de groupe
• Vérifiez que les IDs de produit de modificateur existent dans TISSL
• Vérifiez l’association du groupe de modificateurs

​

Prix erronés

• Les prix sont calculés en incluant les modificateurs
• Vérifiez que les paramètres de taxe correspondent (storekit envoie brut et net)
• Vérifiez la configuration des frais de service

​

Erreurs Pay at Table

• « no_open_bills » : Aucune addition active sur cette table dans TISSL
• « already_exists » : Addition déjà traitée/fermée
• Vérifiez que le POS ID de la table correspond à l’ID de table TISSL

​

Limitations

Avec l’intégration TISSL :

• Pas de synchronisation automatique du menu : Construisez le menu dans storekit, liez aux IDs TISSL
• Pas de sync stock en temps réel : Disponibilité gérée dans storekit
• Mappage manuel des produits : Maintenir les mappages d’ID pour tous les articles

Pour toute assistance supplémentaire, contactez le support.

​

Fonctionnalités prises en charge