Dépannage POS

​

Outil de diagnostic

Répondez à quelques questions pour diagnostiquer votre problème :

---

Ce guide couvre les problèmes courants avec les intégrations POS et comment les résoudre.

​

Problèmes de connexion

​

L’intégration ne se connecte pas

Symptômes :

• Erreur « Connection failed » lors de la configuration
• Impossible d’enregistrer les paramètres d’intégration
• Le test de connexion échoue

Solutions :

1. Vérifiez les identifiants
   • Vérifiez soigneusement les clés API, secrets et IDs de site
   • Assurez-vous qu’il n’y a pas d’espaces superflus dans les identifiants copiés
   • Confirmez que les identifiants n’ont pas expiré
2. Vérifiez le statut du POS
   • Vérifiez que votre système POS est en ligne
   • Assurez-vous que la connectivité cloud est activée
   • Vérifiez les pannes du système POS
3. Problèmes réseau
   • Confirmez que votre établissement a une connexion Internet
   • Vérifiez que les paramètres du pare-feu ne bloquent pas les appels API
   • Essayez depuis un autre réseau si possible
4. Contactez votre fournisseur POS
   • Vérifiez que l’accès API est activé sur votre compte
   • Demandez de nouveaux identifiants si ceux existants ne fonctionnent pas

​

La connexion se coupe par intermittence

Symptômes :

• L’intégration fonctionne parfois mais pas toujours
• Les commandes échouent occasionnellement à s’injecter
• La synchronisation se termine parfois mais échoue à d’autres moments

Solutions :

1. Vérifiez la stabilité de la connexion Internet
   • Les connexions instables causent des échecs intermittents
   • Envisagez une connexion Internet de secours
2. Vérifiez la disponibilité du POS
   • Certains systèmes POS redémarrent la nuit
   • Vérifiez si les échecs correspondent aux fenêtres de maintenance
3. Surveillez les limites d’API
   • Certains systèmes POS ont des limites de débit
   • Réduisez la fréquence de synchronisation si vous atteignez les limites

​

Problèmes de synchronisation du menu

​

Le menu ne se synchronise pas

Symptômes :

• Le bouton de synchronisation ne fait rien
• Les produits n’apparaissent pas après la synchronisation
• La synchronisation s’exécute mais le menu est vide

Solutions :

1. Vérifiez que l’intégration est connectée
   • Allez dans Paramètres de la boutique > Intégrations
   • Vérifiez que le POS s’affiche comme connecté
2. Vérifiez le menu dans le POS
   • Assurez-vous que les produits sont actifs/publiés
   • Vérifiez que les produits sont assignés à des catégories
   • Confirmez que le type de menu est correct
3. Essayez la synchronisation manuelle
   • Utilisez le bouton de synchronisation dans la section Menu
   • Attendez que la synchronisation soit complètement terminée
   • Recherchez les messages d’erreur

​

Produits manquants après synchronisation

Symptômes :

• Certains produits se synchronisent mais d’autres non
• Des modificateurs manquent
• Les catégories sont incomplètes

Solutions :

1. Vérifiez le statut du produit dans le POS
   • Les produits doivent être actifs/activés
   • Les produits doivent être assignés à un menu
   • Vérifiez les paramètres de visibilité du produit
2. Vérifiez la structure du menu
   • Les produits hors catégorie peuvent ne pas se synchroniser
   • Certaines intégrations ne synchronisent que des types de menu spécifiques
   • Vérifiez que le bon menu est sélectionné
3. Vérifiez les erreurs de synchronisation
   • Consultez les messages d’erreur après synchronisation
   • Des produits individuels peuvent échouer alors que d’autres réussissent

​

Les prix sont incorrects

Symptômes :

• Les prix synchronisés ne correspondent pas au POS
• Les prix sont doublés ou divisés par deux
• La taxe apparaît de manière incorrecte

Solutions :

1. Incohérence des paramètres de taxe
   • Vérifiez si les prix POS incluent la taxe
   • Vérifiez que les paramètres de taxe storekit correspondent
   • Assurez-vous que les taux de taxe sont correctement configurés
2. Problèmes de devise
   • Confirmez que les paramètres de devise correspondent
   • Vérifiez les différences de décimales
3. Resynchronisez après changements
   • Les prix ne se mettent pas à jour tant que vous n’avez pas synchronisé
   • Déclenchez une synchronisation manuelle après des changements de prix dans le POS

​

Problèmes d’injection de commande

​

Les commandes n’apparaissent pas dans le POS

Symptômes :

• Le client reçoit une confirmation
• La commande apparaît dans le tableau de bord storekit
• La commande n’apparaît jamais dans le POS

Solutions :

1. Vérifiez le statut de l’intégration
   • Vérifiez que l’intégration est activée
   • Recherchez les avertissements de déconnexion
2. Consultez la commande dans le tableau de bord
   • Consultez les détails de la commande pour les erreurs
   • Vérifiez le champ de statut d’injection POS
3. Vérifiez que le POS est en ligne
   • Vérifiez que le terminal est sous tension
   • Confirmez la connectivité réseau
   • Essayez de passer une commande directement dans le POS
4. Vérifiez les codes PLU (liaison manuelle)
   • Assurez-vous que tous les articles ont des PLU valides
   • Vérifiez que les PLU existent dans le système POS
5. Vérifiez les notifications par email
   • Si l’injection de commande échoue, vous recevrez une notification par email
   • L’email inclut la raison spécifique de l’erreur et les détails de la commande
   • Vérifiez que l’adresse email de votre établissement est correctement configurée

​

Commandes arrivant en retard

Symptômes :

• Les commandes arrivent au POS avec plusieurs minutes/heures de retard
• Les précommandes arrivent aux mauvaises heures
• Les commandes ASAP sont retardées

Solutions :

1. Vérifiez les paramètres d’injection
   • Consultez le timing d’injection des précommandes
   • Vérifiez que les commandes ASAP sont configurées sur immédiat
2. Latence réseau
   • Les connexions lentes retardent l’injection
   • Vérifiez la performance globale du réseau
3. Problèmes de file d’attente POS
   • Certains systèmes POS mettent en file d’attente les commandes entrantes
   • Vérifiez les paramètres du POS pour le traitement des commandes

​

Articles manquants dans les commandes

Symptômes :

• La commande apparaît mais des articles manquent
• Les modificateurs ne s’affichent pas
• Commande partielle dans le POS

Solutions :

1. Problèmes de mappage PLU
   • Les PLU manquants font échouer les articles
   • Vérifiez que tous les produits et modificateurs ont des PLU
2. Incohérence de produit
   • L’article peut avoir été supprimé du POS
   • Resynchronisez le menu pour mettre à jour les mappages
3. Configuration des modificateurs
   • Vérifiez que les modificateurs sont correctement liés
   • Vérifiez les paramètres des groupes de modificateurs

​

Articles erronés dans les commandes

Symptômes :

• Le POS affiche des articles différents de ceux commandés
• Les quantités sont incorrectes
• Modificateurs appliqués aux mauvais articles

Solutions :

1. Codes PLU incorrects
   • Un PLU erroné mappe au mauvais produit
   • Auditez les mappages PLU par rapport au POS
2. PLU en double
   • Le même PLU utilisé pour plusieurs produits
   • Assurez-vous que les PLU sont uniques
3. Modifications récentes du menu
   • Les produits peuvent avoir été remappés
   • Resynchronisez et vérifiez les mappages

​

Problèmes de remises et fidélité

​

Les remises ne s’appliquent pas

Symptômes :

• Les remises de fidélité n’apparaissent pas
• La tarification promotionnelle ne fonctionne pas
• Le solde client n’est pas reflété

Solutions :

1. Vérifiez que la remise est active
   • Vérifiez que la promotion est activée dans le POS
   • Confirmez que la plage de dates est actuelle
   • Vérifiez que les conditions sont remplies
2. Qualification du client
   • Vérifiez que le client est inscrit à la fidélité
   • Vérifiez que le client remplit les critères de la remise
   • Confirmez que les commandes en ligne sont éligibles
3. Paramètres d’intégration
   • Certaines remises nécessitent une activation explicite
   • Vérifiez les paramètres de synchronisation des remises

​

Montants de remise incorrects

Symptômes :

• La remise s’applique mais le montant est incorrect
• Pourcentage mal calculé
• La remise apparaît deux fois

Solutions :

1. Vérifiez les règles de remise
   • Vérifiez la méthode de calcul de la remise
   • Vérifiez les règles de cumul
2. Interaction avec la taxe
   • Confirmez si la remise s’applique avant/après taxe
   • Vérifiez que les deux systèmes utilisent la même méthode

​

Notifications par email pour les synchronisations échouées

storekit envoie automatiquement des notifications par email lorsque les commandes ou paiements échouent à se synchroniser avec votre POS, garantissant que vous ne manquiez jamais d’informations critiques.

​

Notifications de commandes échouées

Lorsqu’une commande échoue à se synchroniser avec votre POS, vous recevrez un email qui inclut :

• Détails de la commande — Nom du client, ID de commande et mode de paiement
• Raison de l’erreur — Détails techniques spécifiques sur la raison de l’échec de synchronisation
• Articles de la commande — Un résumé de ce qui a été commandé (avec images lorsque disponibles)
• Actions rapides — Lien direct pour consulter la commande dans votre tableau de bord

​

Que faire lorsque vous recevez un email de commande échouée

1. Vérifiez la raison de l’erreur — L’email inclut des détails spécifiques sur la raison de l’échec de synchronisation
2. Consultez la commande dans le tableau de bord — Cliquez sur le lien dans l’email pour voir tous les détails de la commande
3. Corrigez la cause sous-jacente — Par exemple, remettez le terminal POS ou l’iPad en marche, ou réactivez un modificateur requis manquant dans la commande
4. Renvoyez vous-même la commande à votre POS — Ouvrez la commande, cliquez sur Plus d’actions, puis Renvoyer la commande au POS. Le tableau de bord confirme avec Nouvelle tentative d’injection POS mise en file d’attente et la commande est renvoyée à votre POS
5. Saisissez manuellement la commande — Si la nouvelle tentative échoue toujours, saisissez la commande directement dans votre POS en solution de repli
6. Contactez le support — Si le problème persiste, notre équipe de support a déjà été notifiée et peut aider à le résoudre

​

Notifications d’échec de paiement d’addition

Lorsqu’un paiement Pay at Table réussit mais échoue à se synchroniser avec votre POS, vous recevrez une notification par email. C’est critique car le client a déjà payé, mais votre POS peut ne pas le refléter. La notification inclut :

• Détails de l’addition — ID de l’addition et nom de l’établissement
• Informations de paiement — ID de paiement et détails de la transaction
• Raison de l’erreur — Détails techniques spécifiques sur la raison de l’échec de synchronisation
• IDs de référence — IDs d’addition storekit et POS pour la réconciliation
• Actions rapides — Lien direct pour consulter l’addition dans votre tableau de bord

​

Que faire lorsque vous recevez un email d’échec de paiement d’addition

1. Vérifiez les détails de l’erreur — L’email inclut des informations spécifiques sur la raison de l’échec de synchronisation
2. Consultez l’addition dans le tableau de bord — Cliquez sur le lien pour voir tous les détails du paiement
3. Réconciliez manuellement dans le POS — Marquez l’addition comme payée dans votre POS si nécessaire
4. Contactez le support — Notre équipe est notifiée automatiquement et peut aider avec les problèmes récurrents

​

Vous assurer de recevoir les notifications

Assurez-vous que l’adresse email de votre établissement est correctement configurée :

1. Allez dans Paramètres de la boutique dans votre tableau de bord
2. Naviguez vers Détails de la boutique
3. Vérifiez que votre adresse email est correcte
4. Ajoutez plusieurs adresses email si nécessaire (la première adresse recevra les notifications)

​

Obtenir de l’aide

Si vous avez essayé ces solutions et que vous rencontrez toujours des problèmes :

1. Rassemblez les informations
   • Notez les messages d’erreur spécifiques
   • Enregistrez les IDs de commande concernés
   • Prenez des captures d’écran si possible
   • Vérifiez les notifications par email de commandes échouées
2. Vérifiez le statut du fournisseur POS
   • Recherchez les problèmes à l’échelle du système
   • Contactez le support POS pour leur côté
3. Contactez le support storekit
   • Fournissez les IDs de commande et les détails d’erreur
   • Partagez les paramètres d’intégration (pas les identifiants)
   • Transférez toutes les notifications par email de commandes échouées

Contactez le support pour toute assistance supplémentaire.