> ## 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.

# TISSL

> Connectez le POS TISSL à storekit pour l'injection de commande et le pay at table via liaison manuelle des produits. Envoyez les commandes en ligne directement à vos caisses TISSL existantes.

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

<Note>
  Contactez le support TISSL pour obtenir votre API Key et Organisation ID. Ils sont requis pour l'intégration.
</Note>

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

| Paramètre                | Description                                        |
| ------------------------ | -------------------------------------------------- |
| **Order Type**           | Type de commande TISSL pour les commandes en ligne |
| **Payment Type**         | Type de paiement pour les commandes payées         |
| **Course**               | Plat par défaut pour tous les articles             |
| **Delivery Fee Product** | ID de produit pour les frais de livraison          |
| **Discount Product**     | ID/nom de produit pour les lignes de remise        |
| **Service Charge**       | Montant ou pourcentage des frais de service        |

<Warning>
  Les Order Type, Payment Type, Course et IDs de produit doivent exister dans votre système TISSL. Vérifiez ces paramètres avant la mise en production.
</Warning>

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

| Traitement | Canal TISSL     |
| ---------- | --------------- |
| Sur place  | Pay At Table    |
| Retrait    | Click & Collect |
| Livraison  | Delivery        |

### 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

<Info>
  TISSL peut rejeter les commandes simultanées pour le même montant. Le décalage (délai aléatoire basé sur l'ID de commande) aide à prévenir cela.
</Info>

### 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

| Paramètre                  | Description                                                 |
| -------------------------- | ----------------------------------------------------------- |
| **Payment Type**           | Type de paiement pour les paiements storekit                |
| **Ignore Free Items**      | Ne pas afficher les articles à prix zéro sur l'addition     |
| **Auto-close Bills Delay** | Temps avant de vérifier si l'addition est entièrement payée |

## 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

| Paramètre                  | Description                                            | Défaut                        |
| -------------------------- | ------------------------------------------------------ | ----------------------------- |
| **Order Type**             | Objet de type de commande TISSL                        | Obligatoire                   |
| **Payment Type**           | Type de paiement pour les commandes en ligne           | Obligatoire                   |
| **Course**                 | Plat par défaut pour les articles                      | No Course                     |
| **Delivery Fee**           | Produit pour les frais de livraison                    | Obligatoire pour la livraison |
| **Discount**               | Produit/nom pour les remises                           | Obligatoire pour les remises  |
| **Service Charge**         | Montant ou pourcentage                                 | 0                             |
| **Buffer Orders**          | Retarder l'injection des précommandes                  | false                         |
| **Remove Email**           | Ne pas envoyer l'email du client                       | false                         |
| **All Orders Add To Bill** | Ajouter les commandes sur place à l'addition existante | false                         |
| **Ignore Free Items**      | Masquer les articles gratuits dans la vue addition     | false                         |
| **Order Note Template**    | Modèle personnalisé pour les notes de commande         | Aucun                         |

## 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](/docs/fr/getting-started/contact-support).

## Fonctionnalités prises en charge

<AccordionGroup>
  <Accordion title="Synchronisation du menu">
    | Fonctionnalité                | Prise en charge |
    | ----------------------------- | :-------------: |
    | Sync menu automatique         |        ✗        |
    | Liaison manuelle des produits |        ✓        |

    TISSL utilise la liaison manuelle des produits. Créez votre menu dans storekit et saisissez l'ID de produit TISSL pour chaque article.
  </Accordion>

  <Accordion title="Commandes">
    | 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                    |        ✓        |
  </Accordion>

  <Accordion title="Pay at Table">
    | 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        |        ✓        |
  </Accordion>

  <Accordion title="Configuration de l'établissement">
    | Fonctionnalité                      | Prise en charge |
    | ----------------------------------- | :-------------: |
    | Sync plan de salle                  |        ✓        |
    | Mises à jour de stock en temps réel |        ✗        |
    | Prise en charge multi-sites         |        ✓        |
  </Accordion>
</AccordionGroup>


## Related topics

- [Synchronisation du menu POS](/docs/fr/guides/menu/pos-menu-sync.md)
- [Affectation aux services](/docs/fr/guides/menu/course-assignments.md)
- [Injection de commande](/docs/fr/guides/integrations/pos/order-injection.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)