Skip to main content
Beim Verbinden von Syrve wird Ihr storekit-Konto mit Ihrer Syrve-Organisation verknüpft. Sie geben Ihr Syrve API Login einmal ein und konfigurieren dann jeden Store: Wählen Sie die Organization, aktivieren Sie die Integration und legen Sie fest, wie Bestellungen am POS eingehen sollen.

Voraussetzungen

  • Ein Syrve Cloud-Konto mit API-Zugang
  • Ihr Syrve API Login — die API-Zugangsdaten für Ihre Organisation, ausgestellt von Syrve oder Ihrem Syrve-Reseller
  • Die für Ihr storekit-Konto aktivierte Syrve-Integration
Wenn Syrve nicht in Ihrer Liste Integrations erscheint, ist die Integration für Ihr Konto noch nicht aktiviert — wenden Sie sich an den storekit-Support.

Ihre Organisation verbinden

1

Syrve-Integration öffnen

Gehen Sie zu Stores → Ihr Store → Settings → Integrations und wählen Sie Syrve.
2

API Login eingeben

Geben Sie auf der Seite Syrve Settings unter Syrve API Settings Ihre Zugangsdaten in API Login ein und klicken Sie auf Save. storekit prüft sie vor dem Speichern gegen Syrve — wenn Syrve damit nicht erreicht werden kann, sehen Sie einen Fehler und es wird nichts gespeichert.
3

Integration aktivieren

Aktivieren Sie Enable Syrve.
4

Organisation auswählen

Wählen Sie die Syrve Organization, zu der dieser Store gehört. storekit lädt daraufhin die Terminalgruppen, Bestellarten, Zahlungsarten, Rabatte, Trinkgeldarten, Stornierungsgründe und External Menus dieser Organisation, damit Sie diese zuordnen können.
5

Speichern

Klicken Sie auf Save. Vor dem Speichern der Einstellungen muss eine Organisation ausgewählt sein.
Nach dem Verbinden klappt der Abschnitt Syrve API Settings in einen Connected-Zustand ein, wobei Ihre Zugangsdaten maskiert sind (nur die letzten Zeichen werden angezeigt). Klicken Sie auf Edit, um den Abschnitt wieder anzuzeigen, und verwenden Sie das Stiftsymbol, um das API Login zu ersetzen.
Das API Login wird einmalig für Ihr gesamtes storekit-Konto gespeichert — jeder Store im Konto verbindet sich damit mit Syrve. Die Organization und alles darunter sind pro Store konfiguriert.

Webhooks einrichten

Webhooks ermöglichen es Syrve, Bestellaktualisierungen an storekit zu senden, sodass Bestellungen automatisch voranschreiten, während die Küche sie bearbeitet (und Bestandsänderungen sofort eintreffen).
1

Zuerst Einstellungen speichern

Webhooks werden für die gespeicherte Organization registriert — speichern Sie Ihre Einstellungen, bevor Sie sie einrichten.
2

Setup webhooks

Klicken Sie unter Syrve Webhooks auf Setup webhooks. storekit registriert sich bei Syrve und liest anschließend die Einstellungen zur Bestätigung von Syrve zurück — das grüne Feld Webhooks enabled zeigt das Ziel und die aktivierten Ereignisse an.
Ohne Webhooks bestätigt storekit weiterhin, dass jede Bestellung auf der Kasse angekommen ist (es prüft dies etwa 5 Minuten nach dem Senden), aber spätere Küchenstatus und Live-Bestandsänderungen kommen nicht an — das gelbe Feld Webhooks not configured warnt, dass Bestellungen in storekit manuell weitergeführt werden müssen.
Um Syrve das Senden von Aktualisierungen zu untersagen, klicken Sie auf Disable webhooks (dieselbe Schaltfläche, sobald Webhooks konfiguriert sind).
Wenn Sie die Organization ändern, zeigt das Webhook-Feld Organization changed — speichern Sie Ihre Einstellungen, um den Webhook-Status für die neue Organisation zu sehen, und richten Sie die Webhooks bei Bedarf erneut ein.

Was sich durch das Verbinden ändert

  • Die Aktivierung von Syrve legt den POS-Anbieter dieses Stores auf Syrve fest. Bestellungen werden nur dann versendet, wenn die Organization und eine Terminal Group festgelegt sind.
  • Nach Auswahl einer Organisation wird der Rest der Seite Syrve Settings verfügbar: Syrve Menu, Syrve Order Complications und Syrve Webhooks.

Nächste Schritte

Menü synchronisieren

Importieren Sie Ihr Syrve External Menu in storekit

Bestellungen einrichten

Bestellarten, Zahlungen und Gebühren zuordnen

Verwandte Themen