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

> Résolvez les problèmes d'intégration Toast POS dans storekit : connexion, synchro du menu, prix à £0, modificateurs manquants et échec d'injection.

Problèmes courants de l'intégration Toast et comment les résoudre. Si vous êtes toujours bloqué, [contactez le support storekit](/docs/fr/getting-started/contact-support).

## Connexion

### « Toast POS » n'apparaît pas dans ma liste Integrations

L'intégration n'est pas activée pour votre compte. [Contactez le support](/docs/fr/getting-started/contact-support) pour la faire activer.

### La connexion échoue

* Vérifiez que le **Restaurant GUID** est correct pour ce restaurant — un GUID incorrect ou mal saisi est la cause habituelle.
* Confirmez que votre restaurant Toast a la commande en ligne activée.

### Je ne peux pas enregistrer les paramètres

Lorsque **Enable Toast POS** est activé, **Alternate Payment Type** et **Check Discount** sont obligatoires. L'enregistrement échoue avec "Please fill in all required fields" tant que les deux (sous **Additional Settings**) ne sont pas définis.

## Synchronisation du menu

### Rien n'est importé, ou la synchronisation s'interrompt

* **Enable Toast POS** doit être activé et l'établissement doit avoir un menu storekit actif avant de pouvoir lancer **Sync Menu**. Voir ["This venue has no active menu to sync into"](#this-venue-has-no-active-menu-to-sync-into).
* Le contenu du menu doit être **visible pour les ordering partners** dans Toast. Si tout ce qui est sélectionné est masqué aux ordering partners, storekit interrompt la synchronisation (délibérément, pour ne pas effacer votre menu). Rendez le menu visible pour les ordering partners dans Toast et relancez la synchronisation.
* Si vous avez défini un **Toast Menu** spécifique qui n'existe plus dans Toast, la synchronisation s'interrompt — effacez ou mettez à jour **Toast Menu**.

### "This venue has no active menu to sync into"

L'établissement n'a pas encore de menu storekit. C'est une condition storekit, pas Toast. Votre menu Toast est correct, et il n'y a rien à vérifier dans Toast. **Sync Menu** importe *dans* un menu storekit existant, donc un tout nouvel établissement (par exemple le deuxième, troisième ou quatrième site d'un groupe partageant un même menu Toast) a besoin d'un menu avant la première synchronisation. Pour résoudre le problème :

1. Allez dans **Stores** → le nouvel établissement et cliquez sur **Create a menu**.
2. Choisissez **Enter Manually** et cliquez sur **Create a menu**. Cela crée un menu vide sur l'établissement ; vous n'avez rien besoin d'y ajouter.
3. Connectez l'établissement à Toast s'il ne l'est pas encore. Suivez [Connecter Toast](/docs/fr/guides/integrations/pos/toast/connect) (**Restaurant GUID** → **Connect** → **Enable Toast POS** → **Alternate Payment Type** et **Check Discount** → **Save**).
4. Cliquez sur **Sync Menu** sous **Sync Actions**.

Répétez pour chaque établissement qui doit servir le menu Toast. Voir [Utiliser un même menu Toast sur plusieurs établissements](/docs/fr/guides/integrations/pos/toast/menu-sync#utiliser-un-meme-menu-toast-sur-plusieurs-etablissements).

### Des articles s'affichent à £0

Les tarifs Toast basés sur la taille et la séquence ne peuvent pas être représentés comme un prix unique, ces articles sont donc importés à £0. Définissez le prix dans storekit ou restructurez l'article dans Toast.

### Des modificateurs manquent

Les groupes de **pré-modificateurs** Toast ne sont pas pris en charge et sont ignorés. Les groupes de modificateurs standards et imbriqués s'importent normalement.

### Un article en stock apparaît comme épuisé (ou inversement)

Les stocks suivent Toast. storekit met en pause les articles que Toast signale en rupture et les restaure lorsque Toast les signale à nouveau en stock. Relancez **Sync Menu** pour forcer une réconciliation.

## Commandes

### Les commandes n'arrivent pas à Toast

Une commande échouée est marquée **failed** dans storekit avec le message d'erreur Toast ; la commande du client se termine tout de même. Ré-envoyez-la depuis le tableau de bord une fois la cause corrigée. Causes courantes :

* **Aucune dining option pour la méthode de traitement** — définissez la dining option correspondante (ou le **Default Dining Option**) sous **Dining Options**.
* **Un article ne peut pas être associé à un groupe de menu Toast** — relancez **Sync Menu** pour que les articles portent leurs identifiants Toast.
* **Alternate Payment Type manquant** — définissez-le sous **Additional Settings**.

### Les remises ou service charges ne sont pas sur le ticket Toast

* Les remises nécessitent que **Check Discount** soit défini sous **Additional Settings**.
* La service charge de commande nécessite **Service Charge**, et les frais de livraison nécessitent **Delivery Fee Service Charge**.

### Les pourboires de commande apparaissent comme service charge (ou l'inverse)

Vérifiez **Send Order Tips as Service Charge** sous **Additional Settings**. Lorsque activé, les pourboires de commande sont ajoutés à la **Service Charge** sur le ticket au lieu d'être enregistrés comme pourboire Toast ; lorsque désactivé, ils sont enregistrés comme pourboire sur le paiement. N'affecte que les commandes en ligne — les pourboires en pay-at-table sont toujours des pourboires Toast.

### Les statuts de commande ne se mettent pas à jour dans storekit

Les mises à jour de statut dépendent de l'envoi par Toast des événements de statut de commande à storekit, configurés lors de la mise en place. Si Preparing/Ready/Complete ne remontent pas, contactez le support pour vérifier votre abonnement webhook.

## Service sur place et plan de salle

### Aucune table importée après Sync Floorplan

Les tables ne s'importent que si elles appartiennent à une **zone de service** Toast. Si Toast n'a aucune zone de service, rien ne s'importe — ajoutez des zones de service dans Toast, puis relancez **Sync Floorplan**.

### Les commandes sur place ne s'attachent pas à la bonne table

Une commande sur place ne se lie à une table Toast que si storekit a une table synchronisée correspondante. Relancez **Sync Floorplan** après avoir ajouté ou renommé des tables dans Toast.

## Pay at Table

### Un paiement pay-at-table a échoué

* **Alternate Payment Type** doit être défini sous **Additional Settings**.
* Le pay-at-table ne prend en charge que les commandes à **ticket unique**. Si le personnel divise le ticket en plusieurs tickets sur le terminal Toast, storekit ne peut pas appliquer le paiement.

### L'add-to-bill est rejeté

Les commandes ajoutées doivent être **impayées / espèces**, à ticket unique, et ne comporter aucune remise, service charge ni frais de livraison. Les commandes par carte ou carte-cadeau déjà encaissées ne peuvent pas être ajoutées à un ticket.

## Voir aussi

* [Connecter Toast](/docs/fr/guides/integrations/pos/toast/connect)
* [Synchronisation du menu](/docs/fr/guides/integrations/pos/toast/menu-sync)
* [Commandes et routage](/docs/fr/guides/integrations/pos/toast/orders)
* [Pay at Table](/docs/fr/guides/integrations/pos/toast/pay-at-table)


## Related topics

- [Connecter Toast](/docs/fr/guides/integrations/pos/toast/connect.md)
- [Dépannage](/docs/fr/guides/integrations/pos/comtrex/troubleshooting.md)
- [Toast Pay at Table](/docs/fr/guides/integrations/pos/toast/pay-at-table.md)
- [Synchronisation du menu Toast](/docs/fr/guides/integrations/pos/toast/menu-sync.md)
- [Toast POS](/docs/fr/guides/integrations/pos/toast/overview.md)


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