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

# Centegra

> Connectez le POS Centegra à storekit pour l'injection de commandes. Liez les produits avec les PLU pour envoyer les commandes en ligne à vos caisses existantes, avec les tables mappées par ID POS.

Centegra est un système POS d'entreprise couramment utilisé dans l'hôtellerie. L'intégration storekit permet l'injection automatique de commandes. La gestion du menu utilise la liaison manuelle des produits — vous construisez votre menu dans storekit et liez les produits à leurs IDs Centegra.

## Ce que vous obtenez

* **Injection de commande** — Commandes en ligne envoyées directement à Centegra
* **Mappage des tables** — Routage des commandes sur place vers une Location Centegra et une table par ID POS
* **Liaison manuelle des produits** — Contrôle total sur la présentation de votre menu en ligne

## Pour commencer

### Ce qu'il vous faut

Contactez votre responsable de compte Centegra pour obtenir :

* **Secure Key** — Votre clé API au niveau de l'entreprise
* **Site ID** — Identifie votre emplacement spécifique

Vous devrez également configurer les paramètres spécifiques à l'établissement dans le tableau de bord storekit après la connexion.

### Connexion à Centegra

1. Allez dans **Paramètres > Intégrations** dans votre tableau de bord storekit
2. Sélectionnez **Centegra**
3. Saisissez votre **Secure Key**
4. Cliquez sur **Connecter**

### Sélection de votre site

Après la connexion au niveau du compte :

1. Allez dans **Boutiques** → votre boutique → **Paramètres** → **Intégrations** → **Centegra**
2. Sélectionnez votre **Site** Centegra parmi les options disponibles
3. Le Site ID est enregistré pour le routage des commandes

### Configuration des paramètres d'établissement

Chaque établissement nécessite des paramètres Centegra spécifiques :

| Paramètre           | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| **Location**        | La zone/emplacement au sein de votre site pour les commandes |
| **Till**            | Quelle caisse reçoit les commandes en ligne                  |
| **Till Secure Key** | Clé d'authentification pour la caisse sélectionnée           |
| **Clerk**           | L'ID clerk utilisé pour les commandes en ligne               |
| **Media**           | Type de média de paiement pour les paiements en ligne        |
| **Source**          | Identifiant de source pour les commandes en ligne            |
| **Price Level**     | Quel niveau de prix utiliser pour les articles de commande   |

<Warning>
  Tous les paramètres doivent correspondre à des valeurs valides dans votre système Centegra. Une configuration incorrecte entraînera l'échec des commandes.
</Warning>

## Liaison des produits

Centegra utilise la **liaison manuelle des produits** — les produits ne sont pas synchronisés automatiquement depuis votre POS.

### Fonctionnement

1. Créez votre menu dans storekit avec catégories, produits et modificateurs
2. Pour chaque produit, saisissez son **Centegra Product ID** dans le champ POS ID
3. Pour chaque modificateur, saisissez son **Centegra Product ID**
4. Lorsque des commandes sont passées, storekit envoie les Product IDs à Centegra

### Trouver les IDs de produit

Vos IDs de produit Centegra se trouvent :

* Dans le back office Centegra sous Produits
* Dans les rapports d'export de produits
* En contactant votre équipe de support Centegra

### Liaison des modificateurs

Les modificateurs ont également besoin d'IDs de produit de Centegra :

1. Allez dans vos groupes de modificateurs dans storekit
2. Pour chaque option de modificateur, saisissez son Centegra Product ID
3. Les modificateurs sont envoyés en tant qu'articles enfants liés à leur produit parent

## Fonctionnement des commandes

### Flux de commande

1. Le client passe une commande sur votre boutique storekit
2. La commande est validée auprès de Centegra (`TransactionValidate`)
3. Si valide, la commande est soumise (`Transaction`)
4. La commande apparaît dans Centegra sur la caisse configurée
5. Le client reçoit une confirmation avec l'ID de transaction

<Info>
  Si une commande échoue à se synchroniser avec Centegra, vous recevrez une notification par email avec les détails de l'erreur et un lien direct vers la commande dans votre tableau de bord.
</Info>

### Types de commande

| Commande en ligne | Type de transaction Centegra |
| ----------------- | ---------------------------- |
| Retrait           | Type 2                       |
| Livraison         | Type 3                       |

### Ce que reçoit Centegra

Chaque commande inclut :

* ID de transaction externe (basé sur l'horodatage)
* IDs de Location, till et clerk
* Tous les articles avec Product IDs, quantités et prix
* Modificateurs en tant qu'articles enfants liés aux parents
* Remises calculées réparties sur les articles
* Détails du paiement avec ID de média
* Nom, email, téléphone du client
* Numéro de référence de la commande
* Heure de début de préparation (pour la planification)
* Notes de commande

### Remises

Lorsqu'une remise est appliquée :

* Le montant de la remise est réparti proportionnellement sur tous les articles
* Chaque article affiche son prix unitaire, son total brut et le montant de la remise
* Centegra reçoit la ventilation complète de la remise

### Pourboires

Les pourboires sont traités comme un poste de paiement négatif, gardant le total de la commande précis tout en suivant la gratification séparément.

## Tables et routage sur place

La page de paramètres Centegra n'a pas de plan de salle ni de bouton de synchronisation des tables. Créez vos zones et tables dans storekit (voir [tables sur place](/docs/fr/guides/fulfillment/dine-in-tables)) et attribuez à chaque table l'ID POS Centegra correspondant, afin que les commandes sur place soient routées vers la bonne table dans la **Location** configurée.

## Dépannage

### Problèmes de connexion

**« Secure Key not found »**

* Vérifiez que votre Secure Key est correctement saisie au niveau du compte
* Contactez le support Centegra pour confirmer votre accès API

**« Site not found »**

* Vérifiez que le Site ID correspond à votre emplacement dans Centegra
* Assurez-vous que votre Secure Key a accès à ce site

### Problèmes de commande

**Commandes échouant à la validation**

* Vérifiez que tous les paramètres d'établissement sont configurés (location, till, clerk, etc.)
* Vérifiez que la Till Secure Key est correcte
* Assurez-vous que tous les produits ont des Centegra Product IDs valides

**« Product doesn't have posId »**

* L'article défaillant n'a pas de Centegra Product ID
* Modifiez le produit dans storekit et ajoutez le POS ID

**« Modifier doesn't have posId »**

* Une option de modificateur n'a pas de Product ID
* Modifiez le modificateur et ajoutez le Centegra Product ID

### Articles ou prix erronés

* Vérifiez que les Product IDs correspondent entre storekit et Centegra
* Vérifiez que le paramètre Price Level est correct pour votre menu en ligne
* Assurez-vous que les taux de taxe sont configurés sur les produits

### Les commandes sur place n'arrivent pas à la bonne table

* Confirmez que votre établissement a un Site ID (posId) valide
* Vérifiez que la **Location** sélectionnée dans les paramètres storekit Centegra existe dans Centegra
* Vérifiez que chaque table storekit porte l'ID POS de la table Centegra correspondante

## Liste de vérification avant lancement

Avant le lancement :

* [ ] Secure Key saisie au niveau du compte
* [ ] Paramètres d'établissement configurés (location, till, clerk, media, source, price level)
* [ ] Tous les produits ont des Centegra Product IDs
* [ ] Tous les modificateurs ont des Centegra Product IDs
* [ ] Passez une commande de retrait test
* [ ] Vérifiez que la commande apparaît sur la bonne caisse dans Centegra
* [ ] Vérifiez que les articles, modificateurs et prix sont corrects
* [ ] Testez une commande de livraison avec adresse complète
* [ ] Créez des tables dans storekit avec leurs IDs POS Centegra (si utilisation sur place)

## Fonctionnalités prises en charge

<AccordionGroup>
  <Accordion title="Synchronisation du menu">
    | Fonctionnalité                | Prise en charge |
    | ----------------------------- | :-------------: |
    | Sync menu automatique         |        ✗        |
    | Liaison manuelle des produits |        ✓        |
    | Images produits               |        ✗        |
    | Allergènes                    |        ✗        |
    | Informations nutritionnelles  |        ✗        |
    | Modificateurs imbriqués       |        ✗        |
    | Sous-catégories               |        ✗        |
    | Statut du stock               |        ✗        |

    Centegra utilise la liaison manuelle des produits. Créez votre menu dans storekit et saisissez le Centegra Product ID 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>

## Ressources associées

* [Vue d'ensemble de l'intégration POS](/docs/fr/guides/integrations/pos/overview)
* [Guide de mappage des PLU](/docs/fr/guides/integrations/pos/advanced/plu-mapping)
* [Dépannage des problèmes POS](/docs/fr/guides/integrations/pos/advanced/troubleshooting)


## Related topics

- [Synchronisation du menu POS](/docs/fr/guides/menu/pos-menu-sync.md)
- [Ajouter et configurer les produits du menu](/docs/fr/guides/menu/products.md)
- [Vue d'ensemble de l'intégration POS](/docs/fr/guides/integrations/pos/overview.md)
- [Guide de mappage des PLU](/docs/fr/guides/integrations/pos/advanced/plu-mapping.md)
- [Magasin POS-Connected](/docs/fr/getting-started/store-types/pos-connected-store.md)