Prérequis
- Un compte Syrve Cloud avec accès API
- Votre API Login Syrve — l’identifiant API de votre organisation, délivré par Syrve ou par votre revendeur Syrve
- L’intégration Syrve activée sur votre compte storekit
Si Syrve n’apparaît pas dans votre liste Integrations, c’est que l’intégration n’est pas encore activée pour votre compte — contactez le support storekit.
Connecter votre organisation
1
Ouvrir l'intégration Syrve
Rendez-vous dans Stores → votre boutique → Settings → Integrations, puis sélectionnez Syrve.
2
Saisir votre API Login
Sur la page Syrve Settings, sous Syrve API Settings, saisissez votre identifiant dans API Login et cliquez sur Save. storekit le valide auprès de Syrve avant de l’enregistrer — si Syrve n’est pas joignable avec cet identifiant, une erreur s’affiche et rien n’est enregistré.
3
Activer l'intégration
Activez Enable Syrve.
4
Choisir votre organisation
Sélectionnez l’Organization Syrve à laquelle appartient cette boutique. storekit charge alors les terminal groups, types de commande, types de paiement, remises, types de pourboires, motifs d’annulation et menus externes de cette organisation pour que vous puissiez les mapper.
5
Enregistrer
Cliquez sur Save. Une organisation doit être sélectionnée avant que les paramètres puissent être enregistrés.
L’API Login est enregistré une seule fois pour l’ensemble de votre compte storekit — toutes les boutiques du compte se connectent à Syrve avec celui-ci. L’Organization et tout ce qui se trouve en dessous sont propres à chaque boutique.
Configurer les webhooks
Les webhooks permettent à Syrve de pousser les mises à jour de commande vers storekit, de sorte que les commandes progressent automatiquement au fur et à mesure que la cuisine les traite (et que les changements de stock arrivent en temps réel).1
Enregistrer d'abord vos paramètres
Les webhooks sont enregistrés pour l’Organization sauvegardée — enregistrez vos paramètres avant de les configurer.
2
Configurer les webhooks
Sous Syrve Webhooks, cliquez sur Setup webhooks. storekit s’enregistre auprès de Syrve puis relit les paramètres depuis Syrve pour confirmer — le panneau vert Webhooks enabled affiche la destination et les événements activés.
Si vous changez d’Organization, le panneau des webhooks affiche Organization changed — enregistrez vos paramètres pour voir l’état des webhooks pour la nouvelle organisation, et reconfigurez les webhooks si nécessaire.
Ce que la connexion modifie
- L’activation de Syrve définit le fournisseur POS de cette boutique sur Syrve. Les commandes ne sont envoyées qu’une fois l’Organization et un Terminal Group définis.
- Une fois qu’une organisation est sélectionnée, le reste de la page Syrve Settings devient disponible : Syrve Menu, Syrve Order Complications et Syrve Webhooks.
Étapes suivantes
Synchroniser votre menu
Importez votre menu externe Syrve dans storekit
Configurer les commandes
Mappez les types de commande, les paiements et les frais