Zum Hauptinhalt springen

Zenchef: Betreiber-Backend

Verbinden Sie Zenchef mit Ventrata, um Produkte von Betreibern, die Zenchef nutzen, mit Live-Verfügbarkeit und Buchungen weiterzuverkaufen. Restaurantreservierungen und Tischmanagement.

Zenchef logo

 

Zenchef ist eine europäische Plattform für Restaurantreservierungen und Tischmanagement, die Buchung, Zahlungen, Gästeprofile, Marketing und Analysen in der Suite ZenchefOS bündelt. Die Plattform ist in sieben Sprachen in Frankreich, den Niederlanden, Deutschland, Belgien, Spanien, Italien und Portugal tätig, mit einer Buchungs-App für Gäste und Integrationen mit Restaurant-Kassensystemen, und bedient unabhängige Restaurants und Restaurantgruppen.

 

Wenn Sie Zenchef mit Ventrata verbinden, können Sie Produkte von Betreibern weiterverkaufen, die Zenchef als Buchungssystem nutzen. Ventrata liest deren Live-Verfügbarkeit aus Zenchef, und jede Buchung, die Sie entgegennehmen, wird direkt im Konto des Betreibers bei Zenchef angelegt.

 

Weitere Informationen zu Zenchef finden Sie unter zenchef.com.

 

📒 HINWEIS

Diese Verbindung befindet sich in der Testphase und ist möglicherweise nicht für alle Nutzer verfügbar.

‼️ WICHTIG

In der Verbindung mit Zenchef in Ventrata werden die Restauranträume von Zenchef (sowie ein zusätzlicher Eintrag „All Rooms“) als Produkte für die Zuordnung zurückgegeben.

 

Hauptwebsite

Tags

Booking / Ticketing System

Verbindungsfunktionen

Availability Sync · Bookings Sync

Entwickelt von

Ventrata (über die Zenchef API)

 

Mit dieser Betreiber-Verbindung (auch Backend genannt) können Sie Produkte von Betreibern weiterverkaufen, die Zenchef als primäres Buchungssystem nutzen. Jede Buchung wird direkt in Zenchef angelegt. Zu den Funktionen dieser Verbindung gehören:

  • Availability Sync – die Live-Verfügbarkeit stammt aus dem Konto des Betreibers bei Zenchef.

  • Bookings Sync – Buchungen werden von Ventrata an Zenchef übermittelt, und Zenchef stellt die Tickets oder Voucher aus.

 

Die externe API von Zenchef, die für diese Verbindung verwendet wird, ist eine individuelle API, die nicht dem OCTO API-Standard entspricht. Dadurch können bestimmte Funktionen und Möglichkeiten eingeschränkt sein.

 

Verbindung mit Zenchef erstellen

🔐 Erforderliche Rollenberechtigungen: See Operators, Modify Operators, See Products, Modify Products

Bevor Sie beginnen:

  • Sie benötigen eine Handelsvereinbarung mit dem Betreiber über dessen Tarife und Konditionen.

  • Sie benötigen die Restaurant ID und das API Token von Zenchef für den Betreiber. Siehe die folgenden Schritte.

  • Sie müssen die Produkte des Betreibers in Ventrata neu anlegen. Siehe Produkte erstellen. Die Verbindung synchronisiert Verfügbarkeit, Preise und Buchungen, legt aber keine Produkte in Ventrata an.

 

Schritt 1: Betreiber in Ventrata konfigurieren

Fragen Sie Ihren Betreiber nach den Zugangsdaten. Das Restaurant findet sie in seinem Dashboard von Zenchef unter Partners > Integrations oder erhält sie vom Team von Zenchef.

 

  1. Gehen Sie im Ventrata Dashboard zu Produkte → Betreiber (Products → Operators) und öffnen Sie den Betreiber. Falls er noch nicht existiert, legen Sie ihn zuerst als Betreiber an.

  2. Wählen Sie im Abschnitt Backend-Partner (Backend Partner) Zenchef aus und geben Sie die Restaurant ID und das API Token von Zenchef ein.

  3. Press Update Operator.

 

 

Schritt 2: Jedes Produkt verbinden

  1. Öffnen Sie das Produkt des Betreibers unter Produkte → Produkte (Products → Products) und bearbeiten Sie es. Prüfen Sie, ob Betreiber (Operator) auf diesen Betreiber gesetzt ist.

  2. Aktivieren Sie Backend verbunden (Backend Connected). Aktivieren Sie Backend-Verfügbarkeit (Backend Availability), um die Verfügbarkeit aus Zenchef zu verwenden.

  3. Press Update Product.

📒 HINWEIS

Zenchef sendet sowohl Verkaufs- als auch Nettopreise. Ist Backend-Preisgestaltung (Backend Pricing) aktiviert, erfasst Ventrata den Verkaufspreis als Ihren Verkaufspreis und den Nettopreis als Ihren Einkaufspreis, unabhängig vom beim Betreiber hinterlegten Kostenanteil.

 

Aktivieren Sie Backend-Verfügbarkeit, um die Verfügbarkeit aus Zenchef abzurufen.

 

Andernfalls verwendet das Produkt die in Ventrata festgelegte Verfügbarkeit, übermittelt Buchungen aber weiterhin an Zenchef.

 

Produkte zu Zenchef zuordnen

‼️ WICHTIG

Über die Zuordnung erfährt Ventrata, für welches Produkt, welche Option und welche Einheiten in Zenchef die Verfügbarkeit geprüft und gebucht werden soll. Ist ein mit dem Backend verbundenes Produkt nicht korrekt zugeordnet, schlagen seine Buchungen fehl. Eine rote Markierung über die gesamte Produktzeile zeigt ein falsch zugeordnetes Produkt an.

 

  1. Gehen Sie im Ventrata Dashboard zu Produkte → Produkte (Products → Products) und öffnen Sie das Produkt.

  2. Öffnen Sie den Tab Zuordnungen (Mappings). Er wird angezeigt, sobald das Produkt auf Backend verbunden (Backend Connected) gesetzt ist.

  3. Wählen Sie für jede Ventrata-Option und -Einheit in den Dropdown-Menüs, die Ventrata aus Zenchef lädt, das passende Produkt, die passende Option und die passenden Einheiten in Zenchef aus. Lassen Sie kein Feld leer.

  4. Press Save Changes.

📒 HINWEIS

In den Dropdown-Listen der Zuordnungen entsprechen die Produkte von Zenchef den Räumen von Zenchef.

 

📗 TIPP

Nehmen Sie nach der Zuordnung eine Testbuchung vor und bitten Sie den Betreiber zu bestätigen, dass sie in seinem Konto bei Zenchef angekommen ist.

 

Verbindung mit Zenchef verwalten

  • Aktualisieren Sie die Zuordnung, wenn der Betreiber Produkte, Optionen oder Einheiten in Zenchef ändert.

  • Ersetzen Sie den Schlüssel beim Betreiber, wenn Zenchef oder der Betreiber einen neuen ausstellt.

  • Deaktivieren Sie Backend-Verfügbarkeit oder Backend-Preisgestaltung bei einem Produkt, um stattdessen die eigene Verfügbarkeit oder die eigenen Preise von Ventrata zu verwenden. Buchungen werden weiterhin an Zenchef übermittelt.

 

Verbindungsfunktionen im Detail

Dieser Abschnitt richtet sich an alle, die genau wissen möchten, wie die Verbindung mit Zenchef funktioniert. Die Richtung ist hier umgekehrt wie bei einer Wiederverkäufer-Verbindung: Ventrata ruft Zenchef auf, und zwar über die Zenchef API. Für jede Funktion wird erklärt, welche Aufrufe Ventrata wann ausführt und was das für Sie bedeutet.

 

Kurz gesagt: Ventrata fragt bei Zenchef die Verfügbarkeit ab, sobald jemand ein mit dem Backend verbundenes Produkt aufruft, und legt jede Buchung im Konto des Betreibers bei Zenchef an. Zenchef meldet keine Änderungen an Ventrata zurück.

 

Die Zeitangaben sind für Zenchef typisch, gerundet und können sich ändern.

 

Product Mapping

✅

Sie ordnen jedes Ventrata-Produkt, jede Option und jede Einheit im Ventrata Dashboard dem Produkt des Betreibers in Zenchef zu.

Das funktioniert wie folgt:

  • Produkte – Ventrata liest die Produkte, Optionen und Einheiten des Betreibers in Zenchef, um die Dropdown-Menüs auf dem Tab Zuordnungen (Mappings) zu füllen.

  • Beobachtete Pfade: GET /api/v1/restaurants/{n}, GET /api/v1/restaurants/{n}/bookingrooms.

 

Was das für Sie bedeutet: Wenn etwas im Dropdown-Menü fehlt, hat der Betreiber es Ihnen in Zenchef nicht freigegeben. Bitten Sie ihn darum.

Content Sync

❌

Ventrata importiert keine Produktinhalte aus Zenchef.

Ventrata importiert keine Produktinhalte aus Zenchef. Sie legen die Produkte selbst in Ventrata an und beschreiben sie.

Availability Sync

✅

Bei aktivierter Backend-Verfügbarkeit prüft Ventrata die Live-Verfügbarkeit des Betreibers in Zenchef.

Das funktioniert wie folgt:

  • Verfügbarkeit – Wenn jemand den Verfügbarkeitskalender in Ventrata nutzt, zum Beispiel im Dashboard, in Ihrem Web Checkout oder an einem Terminal, fragt Ventrata bei Zenchef live die angezeigten Daten ab.

  • Synchronisiert die Verfügbarkeit aus dem System des Betreibers bei Zenchef.

  • Beobachtete Pfade: GET /api/v1/restaurants/{n}, GET /api/v1/restaurants/{n}/bookingrooms.

 

Typischerweise bei Zenchef:

  • Die Anfragen umfassen jeweils 7 Tage, von heute bis etwa ein Jahr im Voraus, während Nutzer den Kalender durchsuchen und Ventrata ihn lädt.

 

Was das für Sie bedeutet: Kunden buchen auf Basis der Live-Verfügbarkeit des Betreibers in Zenchef. So können Sie keinen Zeitslot überverkaufen, den der Betreiber bereits anderweitig verkauft hat.

Pricing Sync

❌

Ventrata liest keine Preise aus Zenchef.

Ventrata liest keine Preise aus Zenchef. Die Produkte verwenden die Preise, die Sie in Ventrata festgelegt haben, und Buchungen werden weiterhin an Zenchef übermittelt.

Zenchef sendet sowohl Verkaufs- als auch Nettopreise. Ist Backend-Preisgestaltung (Backend Pricing) aktiviert, erfasst Ventrata den Verkaufspreis als Ihren Verkaufspreis und den Nettopreis als Ihren Einkaufspreis, unabhängig vom beim Betreiber hinterlegten Kostenanteil.

Promotions Sync

❌

Werbeaktionen werden nicht an Zenchef übermittelt.

Werbeaktionen werden nicht an Zenchef übermittelt. Ihre Ventrata-Werbeaktionen gelten weiterhin für den Preis, den Ihr Kunde in Ventrata bezahlt.

Bookings Sync

✅

Buchungen, die in Ventrata für ein mit dem Backend verbundenes Produkt vorgenommen werden, werden im Konto des Betreibers bei Zenchef angelegt.

Das funktioniert wie folgt:

  1. Reservieren und bestätigen: Wenn das Produkt in den Warenkorb gelegt wird, prüft Ventrata die Buchung bei Zenchef. Nach der Zahlung legt Ventrata die Buchung mit den Kundendaten im Konto des Betreibers bei Zenchef an.

  2. Tickets: Die Referenz oder die Tickets, die Zenchef zurückgibt, werden in der Ventrata-Buchung gespeichert.

  3. Beobachtete Aufrufe: Cancel Booking, Confirm Booking, Create Booking, Get Booking, Update Booking.

Übermittelt Buchungen, Änderungen und Stornierungen von Ventrata an Zenchef. Empfängt Voucher/Tickets von Zenchef und stellt sie Ihren Kunden aus.

 

‼️ WICHTIG – Buchungen werden nur in eine Richtung synchronisiert, von Ventrata zu Zenchef. Wenn der Betreiber eine Buchung in Zenchef ändert oder storniert, wird Ventrata nicht benachrichtigt. Bitten Sie den Betreiber, Sie über alle Änderungen zu informieren.

Pickups/Dropoff Sync

❌

Angaben zu Abholung und Absetzen werden nicht an Zenchef übermittelt.

Angaben zu Abholung und Absetzen werden nicht an Zenchef übermittelt. Teilen Sie sie dem Betreiber auf anderem Weg mit, wenn ein Produkt sie benötigt.

Custom Questions Sync

❌

Antworten auf Ihre Buchungsfragen werden nicht an Zenchef übermittelt.

Antworten auf Ihre Buchungsfragen werden nicht an Zenchef übermittelt. Teilen Sie sie dem Betreiber auf anderem Weg mit, wenn er sie benötigt.

Extras Sync

❌

Extras und Zusatzleistungen werden nicht in Zenchef gebucht.

Extras und Zusatzleistungen werden nicht in Zenchef gebucht. Gebucht werden nur das Hauptprodukt, die Option und die Einheiten.

Redemption Sync

❌

Einlösungen und andere Statusänderungen in Zenchef werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet.

Einlösungen und andere Statusänderungen in Zenchef werden nach der Bestätigung einer Buchung nicht an Ventrata zurückgemeldet.

Pass Walkup Scanning Sync

❌

Das Scannen von Pässen bei Laufkunden ist mit Zenchef nicht verfügbar.

Das Scannen von Pässen bei Laufkunden ist mit Zenchef nicht verfügbar.

Gift Card Sync

❌

Ventrata-Geschenkkarten werden nicht an Zenchef übermittelt.

Ventrata-Geschenkkarten werden nicht an Zenchef übermittelt. Zahlungen mit Geschenkkarten verbleiben in Ventrata.

✅ unterstützt · ❌ nicht unterstützt

 

Gut zu wissen: Grenzen und Details der Verbindung mit Zenchef

  • Live-Verfügbarkeit: Die Verfügbarkeit wird aus Zenchef abgerufen, während Kunden das Angebot durchsuchen.

  • Buchungen in eine Richtung: Änderungen, die der Betreiber in Zenchef vornimmt, erreichen Ventrata nicht.

  • Individuelle API: Die API von Zenchef ist keine OCTO API, daher können einige Funktionen im Vergleich zu OCTO-Backends eingeschränkt sein.

  • Gedacht für Attraktionen, die zusätzlich ein Restaurant mit Reservierungsbedarf betreiben; Restaurantprodukte können über Ventrata weiterverkauft und gebündelt werden.

 

FAQ

Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.

Die Restaurant ID und das API Token von Zenchef oder der Endpunkt sind höchstwahrscheinlich falsch. Klären Sie die Angaben mit Ihrem Betreiber ab. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

In den Produkteinstellungen gibt es kein Kontrollkästchen „Backend verbunden“ (Backend Connected).

Für den beim Produkt festgelegten Betreiber ist höchstwahrscheinlich kein Backend konfiguriert. Prüfen Sie die Einstellungen unter „Backend-Partner“ (Backend Partner) beim Betreiber und versuchen Sie es erneut. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Das Produkt, die Option oder die Einheit, die ich zuordnen möchte, ist nicht im Dropdown-Menü enthalten.

Die Dropdown-Menüs zeigen, was der Betreiber Ihnen in Zenchef freigegeben hat. Fragen Sie beim Betreiber nach. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Buchungen für ein mit dem Backend verbundenes Produkt schlagen fehl.

Prüfen Sie zuerst die Zuordnung des Produkts: Jede Option und jede Einheit muss zugeordnet sein. Prüfen Sie dann, ob der Zeitslot in Zenchef noch verfügbar ist. Besteht das Problem weiterhin, wenden Sie sich an unseren technischen Support.

Beim Speichern der Backend-Konfiguration des Betreibers erhalte ich eine Fehlermeldung.

Die Restaurant ID und das API Token von Zenchef sind höchstwahrscheinlich ungültig. Klären Sie dies mit Ihrem Betreiber ab. Besteht das Problem weiterhin, wenden Sie sich an den Support.

In den Produkteinstellungen gibt es kein Kontrollkästchen „Backend verbunden“ (Backend Connected).

Für den beim Produkt ausgewählten Betreiber ist höchstwahrscheinlich kein Backend konfiguriert. Prüfen Sie die Backend-Konfiguration und versuchen Sie es erneut. Besteht das Problem weiterhin, wenden Sie sich an den Support.

Der Anbieter, das Produkt, die Option oder die Einheit, die ich zuordnen möchte, ist nicht im Dropdown-Menü enthalten.

Die Dropdown-Liste wird anhand der Restauranträume in Zenchef geladen, die für Sie freigegeben sind. Klären Sie dies mit Ihrem Betreiber und Zenchef ab. Besteht das Problem weiterhin, wenden Sie sich an den Support.

 

Nützliche Ressourcen

 

 

Partnerinformationen

ZENCHEF SAS (Handels- und Gesellschaftsregister Paris 528389794)

63 Av. de Villiers

75017 Paris, Frankreich

 

Ventrata-Partner-ID: a7fb0c12-9a0a-49ed-87f6-97813ec681f9

Hat dies deine Frage beantwortet?