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

# Dépannage

> Résolvez les problèmes Comtrex courants : caisse injoignable, commandes en erreur POS, articles non enregistrés ou pay at table sans addition trouvée.

La plupart des problèmes Comtrex se résument à trois choses : storekit ne parvient pas à joindre le serveur Comtrex, un ID (article, table ou media) ne correspond pas à ce que la caisse attend, ou l'intégration est désactivée. Parcourez la section qui correspond à ce que vous observez.

## Problèmes de connexion

> **Load from till échoue — *Couldn't reach the till — enter the media IDs manually.***
>
> storekit n'a pas obtenu de réponse du serveur Comtrex à l'adresse **Server IP Address** que vous avez enregistrée.
>
> 1. Vérifiez l'adresse et le port avec Zonal. storekit appelle `http://<address>/v10/jrequest.cgi`, donc le service web RTO doit écouter sur cette adresse et être joignable depuis internet.
> 2. Vérifiez le **Vendor ID** — Comtrex rejette les requêtes d'un vendor inconnu.
> 3. Assurez-vous d'avoir cliqué sur **Save** avant **Load from till** — le bouton utilise les détails enregistrés, pas ce qui est saisi dans les champs.
>
> Si la caisse est réellement injoignable depuis l'extérieur de l'établissement, demandez les media IDs à Zonal et utilisez **Enter ID manually** sous chaque menu déroulant de media à la place.

> **Load from till est désactivé**
>
> Il reste désactivé avec *Save the connection details to load anything from the till.* tant que les **Server IP Address** et **Vendor ID** affichés à l'écran n'ont pas été enregistrés. Cliquez sur **Save**, puis réessayez.

> **Integration Status ne s'active pas — *This venue already has a POS integration…***
>
> Un établissement ne peut avoir qu'une seule intégration POS activée. Ouvrez **Stores** → votre établissement → **Settings** → **Integrations**, trouvez l'autre intégration marquée **Connected**, et désactivez-la là d'abord. Puis activez **Integration Status** pour Comtrex.

> **Les commandes n'atteignent pas du tout la caisse, sans erreur dans storekit**
>
> Vérifiez que **Integration Status** affiche *Enabled - sending orders to Comtrex*. S'il affiche *Disabled - not sending orders to Comtrex*, les commandes sont acceptées par storekit mais jamais envoyées. Activez-le — il est enregistré immédiatement.

## Échecs de commande

Quand Comtrex refuse une commande, ou que storekit ne parvient pas à joindre le serveur, la commande apparaît en échec et la page de commande affiche *Something went wrong sending this order to the POS:* suivi du texte d'erreur de la caisse (ou *no reason provided*). L'adresse email de l'établissement reçoit également un email *Comtrex Issue* avec la même raison.

> **Article / PLU non trouvé ou numéro d'article invalide**
>
> Le **POS ID** d'un produit ou d'un modificateur n'existe pas sur la caisse. Ouvrez l'article dans l'éditeur de menu, comparez le **POS ID** avec le numéro d'article dans le catalogue de la caisse (**Comtrex** → **Load catalogue**) et corrigez-le. Puis utilisez **Resend order to POS** sur la commande.
>
> Rappelez-vous que les modificateurs ont besoin de leurs propres POS IDs, et qu'un override de PLU sur l'article a la priorité sur le **POS ID** si vous en utilisez un.

> **Table non trouvée / table invalide**
>
> Le **POS ID** de la table dans **Stores** → votre établissement → **Settings** → **Tables** n'est pas un numéro de table connu de la caisse. Corrigez-le et renvoyez la commande. Voir [Service sur place : tables](/docs/fr/guides/integrations/pos/comtrex/dine-in).

> **Erreurs de media / paiement / sales type**
>
> L'un de **Tip ID**, **Discount ID**, **Payment Type ID** ou **Sales Type Number** est incorrect ou vide. Cliquez sur **Reload** sous les détails de connexion pour récupérer la liste des media actuelle de la caisse, sélectionnez à nouveau les media types et cliquez sur **Save**. Les commandes avec une remise ont besoin de **Discount ID** ; chaque commande a besoin de **Payment Type ID** pour se clôturer.

> **Réseau / timeout — *Unknown Comtrex error (network/timeout)***
>
> storekit n'a pas obtenu de réponse du serveur Comtrex. Il relance la requête plusieurs fois sur quelques minutes avant d'abandonner. Vérifiez que le serveur est allumé et que l'adresse/port lui redirige toujours, puis **Resend order to POS**.

> **La commande a échoué, mais Resend order to POS n'apparaît pas**
>
> **Resend order to POS** n'apparaît que lorsque la commande n'a pas de numéro de check de la caisse. Si la commande en a déjà un, c'est que Comtrex l'a acceptée — vérifiez le check sur la caisse avant de faire quoi que ce soit d'autre.

> **Articles manquants sur le check**
>
> Les produits ou modificateurs sans **POS ID** (et sans PLU) sont ignorés silencieusement — le reste de la commande passe et le client est facturé pour tout. Regardez la commande dans storekit, trouvez l'article sans POS ID, ajoutez-le, et enregistrez manuellement l'article manquant sur le check.

> [!TIP]
>
> Renvoyer n'est sûr que si la commande n'est pas déjà sur la caisse. Cherchez un check avec le numéro de commande storekit avant de renvoyer, sinon vous créerez un doublon.

## Problèmes de synchronisation des prix

> **Articles listés sous *Not found on the till***
>
> Le **POS ID** de l'article ne correspond à aucun numéro d'article dans le catalogue de la caisse. storekit laisse son prix inchangé. Corrigez le **POS ID** sur le produit ou modificateur et relancez **Preview price sync**.

> **Articles listés sous *Conflicting till prices***
>
> La caisse remonte plus d'un prix pour ce numéro d'article (généralement il apparaît dans plusieurs listes avec des prix différents). storekit applique le premier prix trouvé. Si ce n'est pas celui que vous voulez, définissez le prix dans storekit manuellement après l'application.

> **La prévisualisation affiche 0 to update mais les prix sont incorrects sur la caisse**
>
> Price sync ne récupère les prix que *depuis* la caisse *vers* storekit. Il ne pousse jamais les prix storekit vers Comtrex — changez le prix sur la caisse, puis relancez la synchronisation.

> **Load catalogue échoue — *Failed to load the Comtrex catalogue***
>
> Le serveur Comtrex n'a pas répondu à la requête item sync. C'est la même connexion que **Load from till**, alors vérifiez l'adresse, le port et le vendor ID, ainsi que le fait que la caisse soit en ligne. Cliquez sur **Refresh** pour réessayer.

## Problèmes de Pay at Table

> **Le client ne voit aucune addition ouverte pour la table**
>
> storekit a demandé à la caisse les checks ouverts sur le **POS ID** de la table et n'en a obtenu aucun. Soit le check n'a pas encore été ouvert sur la caisse, soit il est sur un autre numéro de table, soit le **POS ID** de la table dans storekit est incorrect. Vérifiez le numéro de table sur la caisse par rapport à **Stores** → votre établissement → **Settings** → **Tables**.

> **Le client a payé mais le check est toujours ouvert sur la caisse**
>
> Ouvrez **Tables** dans le menu de gauche, trouvez l'addition et cliquez sur **View payments**. Si le paiement est **Failed**, storekit n'a pas pu l'envoyer à la caisse après plusieurs tentatives et a annulé (remboursé) le paiement carte du client — reprenez le paiement sur la caisse ou dans storekit. Si le paiement apparaît comme réussi mais n'est pas sur le check, contactez le support avec la référence de l'addition pour qu'il soit renvoyé à la caisse.

> **L'addition n'est pas à jour**
>
> storekit relit le check à chaque fois que le client actualise. Demandez au client d'actualiser ; si les articles ajoutés par le personnel n'apparaissent toujours pas, confirmez qu'ils ont été ajoutés au même check (même numéro de table) et non à un nouveau.

> **Les pourboires n'apparaissent pas sur le check**
>
> Associez **Tip ID** dans les paramètres de connexion et cliquez sur **Save**. Sans cela, le pourboire est prélevé au client mais pas envoyé à la caisse.

## Toujours bloqué ?

Contactez le support storekit avec le nom de l'établissement, le numéro de commande ou la référence d'addition, et le texte d'erreur exact affiché sur la page de commande ou dans l'email *Comtrex Issue*. Zonal peut confirmer les numéros d'articles, les numéros de tables et les media IDs côté caisse.


## Related topics

- [Dépannage Stream](/docs/fr/guides/integrations/pos/stream/troubleshooting.md)
- [Dépannage Toast](/docs/fr/guides/integrations/pos/toast/troubleshooting.md)
- [Dépannage Syrve](/docs/fr/guides/integrations/pos/syrve/troubleshooting.md)
- [Dépannage Deliverect](/docs/fr/guides/integrations/pos/deliverect/troubleshooting.md)
- [Dépannage POS](/docs/fr/guides/integrations/pos/advanced/troubleshooting.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.