Skip to main content
Problèmes courants de l’intégration Syrve et comment les résoudre. Si vous êtes toujours bloqué, contactez le support storekit.

Connexion

« Syrve » n’apparaît pas dans ma liste Integrations

L’intégration n’est pas activée pour votre compte. Contactez le support pour la faire activer.

« We could not reach Syrve’s API with the configured API key »

L’API Login enregistré ne fonctionne pas — il est mal saisi, révoqué, ou pas encore délivré pour un accès API. Ressaisissez-le sous Syrve API Settings (utilisez l’icône crayon pour le remplacer). storekit valide l’identifiant auprès de Syrve avant l’enregistrement, donc une valeur qui s’enregistre avec succès est une valeur qui fonctionne.

Je ne peux pas enregistrer les paramètres

Une Organization doit être sélectionnée avant que les paramètres puissent être enregistrés — la page vous invite à en sélectionner une.

Synchronisation du menu

Le bouton Sync menu est désactivé

  • Un External Menu doit être sélectionné.
  • La boutique doit avoir un menu storekit actif.

La liste déroulante External Menu est vide

Les menus externes sont créés dans Syrve Office. Configurez-en un là-bas (et vérifiez que votre Organization est la bonne), puis rouvrez la page.

Les articles affichent £0

Syrve n’a renvoyé aucun prix pour ces articles — une lacune connue de certains menus externes Syrve. Corrigez les prix dans Syrve Office et relancez Sync menu. Définir le prix dans storekit n’est pas une solution durable : la prochaine synchronisation le remplacera par ce que renvoie Syrve.

Des articles ou modificateurs manquent

Seul le contenu visible dans le menu externe Syrve s’importe — les articles, tailles et groupes de modificateurs masqués dans Syrve sont ignorés, tout comme les groupes de modificateurs sans option visible. Vérifiez le menu externe dans Syrve Office et resynchronisez.

Un article en stock apparaît comme épuisé (ou l’inverse)

La disponibilité suit la stop list de Syrve pour votre Terminal Group — voir Stock et disponibilité pour les règles exactes (y compris pourquoi un article dans la stop list avec du stock restant reste en vente). Les webhooks livrent les changements de stop list en direct ; sans eux, la liste n’est relue qu’à la synchronisation du menu — lancez Sync menu pour forcer une réconciliation, et configurez les webhooks pour qu’elle reste à jour.

Commandes

Les commandes n’arrivent pas jusqu’à la caisse

Une commande en échec est marquée failed dans storekit avec l’erreur Syrve sur la commande ; la commande du client aboutit tout de même. Causes courantes :
  • Le terminal group est endormi — l’erreur mentionne un timeout. C’est l’échec le plus courant et il fait l’objet de son propre guide : réveillez la caisse, et notez que Syrve rejette le renvoi d’une commande expirée comme un doublon — saisissez-la manuellement.
  • Aucun type de commande pour la méthode d’exécution — définissez Delivery Order Type, Pickup Order Type ou Table Order Type sous Syrve Order Complications, puis ouvrez la commande et utilisez Resend order to POS.
  • L’intégration n’est que partiellement configurée — l’Organization et le Terminal Group doivent tous deux être définis ; corrigez et renvoyez.
  • Un article ne peut pas être associé sur le POS — le menu sur la caisse a changé depuis le dernier import. Lancez Sync menu, puis renvoyez.

Le paiement n’apparaît pas sur la commande Syrve

Définissez Cash Payment Type et Card Payment Type sous Syrve Order Complications. Les commandes passées alors que l’un manque sont envoyées sans paiement — le personnel doit les clôturer sur la caisse.

Les frais de service sur le ticket ne correspondent pas à la commande

Les Service Charge sélectionnés sont des frais basés sur un pourcentage dans Syrve, qui recalculent leur propre pourcentage sur le POS et ignorent le montant envoyé par storekit. Utilisez plutôt des frais à flexible-sum de Syrve Office. N’oubliez pas que les frais de livraison sont intégrés aux mêmes frais, donc sur les commandes en livraison, le chiffre combiné est normal.

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

Les mises à jour de statut arrivent par webhook. Vérifiez Syrve Webhooks sur la page Syrve Settings — si le panneau indique Webhooks not configured, cliquez sur Setup webhooks. Si vous avez changé d’Organization, enregistrez et reconfigurez les webhooks.

Syrve indique que la commande a été annulée, mais elle est toujours active dans storekit

C’est volontaire : un ticket annulé sur la caisse n’annule pas une commande storekit payée à votre insu. storekit signale la commande ; annulez-la (et remboursez-la) dans storekit si c’est ce qui doit se produire.

Une commande storekit annulée est toujours sur la caisse

  • L’annulation ne parvient à Syrve que pour les commandes en retrait et en livraison — les additions à table doivent être annulées sur la caisse.
  • Un Cancel Cause doit être sélectionné sous Syrve Order Complications ; Syrve rejette les annulations sans motif.

Voir aussi