Vai al contenuto principale

Zenchef: backend operatore

Collega Zenchef a Ventrata per rivendere i prodotti degli operatori Zenchef con disponibilità e prenotazioni in tempo reale. Prenotazioni e gestione dei tavoli per ristoranti.

Zenchef logo

 

Zenchef è una piattaforma europea di prenotazione e gestione dei tavoli per ristoranti, che riunisce prenotazioni, pagamenti, profili degli ospiti, marketing e analisi nella suite ZenchefOS. Opera in sette lingue in Francia, Paesi Bassi, Germania, Belgio, Spagna, Italia e Portogallo, con un'app di prenotazione per gli ospiti e integrazioni con i sistemi di cassa dei ristoranti, al servizio di ristoranti indipendenti e gruppi di ristorazione.

 

Collegare Zenchef a Ventrata ti permette di rivendere i prodotti di operatori che usano Zenchef come sistema di prenotazione. Ventrata legge da Zenchef la loro disponibilità in tempo reale e ogni prenotazione che ricevi viene creata direttamente nell'account Zenchef dell'operatore.

 

Per saperne di più su Zenchef, visita zenchef.com.

 

📒 NOTA

Questa connessione è in fase di test e potrebbe non essere disponibile per tutti gli utenti.

‼️ IMPORTANTE

Nella connessione di Ventrata con Zenchef, le sale dei ristoranti di Zenchef (più una voce aggiuntiva 'All Rooms') vengono restituite come prodotti da mappare.

 

Sito web principale

Tag

Booking / Ticketing System

Funzionalità della connessione

Availability Sync · Bookings Sync

Sviluppato da

Ventrata (tramite Zenchef API)

 

Questa connessione operatore (detta anche backend) ti permette di rivendere i prodotti di operatori che usano Zenchef come sistema di prenotazione principale, e ogni prenotazione viene creata direttamente in Zenchef. Le funzionalità di questa connessione includono:

  • Availability Sync – la disponibilità in tempo reale proviene dall'account Zenchef dell'operatore.

  • Bookings Sync – le prenotazioni vengono inviate da Ventrata a Zenchef e Zenchef emette i biglietti o i voucher.

 

L'API esterna di Zenchef usata per questa connessione è un'API personalizzata che non segue lo standard API OCTO, il che può limitare alcune funzionalità e capacità.

 

Creare la connessione con Zenchef

🔐 Autorizzazioni di ruolo richieste: See Operators, Modify Operators, See Products, Modify Products

Prima di iniziare:

  • Devi avere un accordo commerciale con l'operatore per le sue tariffe e condizioni.

  • Devi avere il Restaurant ID di Zenchef e l'API Token di Zenchef dell'operatore. Segui i passaggi qui sotto.

  • Devi ricreare i prodotti dell'operatore in Ventrata. Scopri come creare i prodotti. La connessione sincronizza disponibilità, prezzi e prenotazioni, ma non crea i prodotti in Ventrata.

 

Passaggio 1: configurare l'operatore in Ventrata

Chiedi le credenziali al tuo operatore. Il ristorante le trova nella propria dashboard di Zenchef in Partners > Integrations, oppure le ottiene dal team di Zenchef.

 

  1. Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.

  2. Nella sezione Backend Partner, seleziona Zenchef e inserisci il Restaurant ID di Zenchef e l'API Token di Zenchef.

  3. Press Update Operator.

 

 

Passaggio 2: collega ogni prodotto

  1. Apri il prodotto dell'operatore in Products → Products e modificalo. Verifica che Operator sia impostato su questo operatore.

  2. Seleziona Backend Connected. Seleziona Backend Availability per usare la disponibilità di Zenchef.

  3. Press Update Product.

📒 NOTA

Zenchef invia sia i prezzi al pubblico sia i prezzi netti. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico come tuo prezzo di vendita e il prezzo netto come tuo prezzo di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

 

Seleziona Backend Availability per recuperare la disponibilità da Zenchef.

 

Senza questa opzione, il prodotto usa la disponibilità impostata in Ventrata, ma invia comunque le prenotazioni a Zenchef.

 

Mappare i prodotti su Zenchef

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di Zenchef verificare la disponibilità e prenotare. Se un prodotto collegato al backend non è mappato correttamente, le sue prenotazioni non vanno a buon fine. Un'evidenziazione rossa sull'intera riga del prodotto indica un prodotto mappato in modo errato.

 

  1. Nella Ventrata Dashboard, vai su Products → Products e apri il prodotto.

  2. Apri la scheda Mappings. Compare dopo che il prodotto è stato impostato come Backend Connected.

  3. Per ogni opzione e unità Ventrata, seleziona dai menu a tendina, che Ventrata carica da Zenchef, il prodotto, l'opzione e le unità corrispondenti di Zenchef. Non lasciare nessun campo vuoto.

  4. Press Save Changes.

📒 NOTA

Nei menu a tendina di Mappings, i prodotti di Zenchef corrispondono alle sale di Zenchef.

 

📗 SUGGERIMENTO

Dopo la mappatura effettua una prenotazione di test e chiedi all'operatore di confermare che sia arrivata nel suo account Zenchef.

 

Gestire la connessione con Zenchef

  • Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in Zenchef.

  • Sostituisci la chiave sull'operatore se Zenchef o l'operatore ne emettono una nuova.

  • Disattiva Backend Availability o Backend Pricing su un prodotto per usare invece la disponibilità o i prezzi di Ventrata. Le prenotazioni vengono comunque inviate a Zenchef.

 

Funzionalità della connessione in dettaglio

Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Zenchef. Qui la direzione è opposta a quella di una connessione rivenditore: è Ventrata a chiamare Zenchef, tramite Zenchef API. Per ogni funzionalità spiega quali chiamate effettua Ventrata, quando e cosa significa per te.

 

In breve: Ventrata chiede a Zenchef la disponibilità ogni volta che qualcuno visualizza un prodotto collegato al backend e crea ogni prenotazione nell'account Zenchef dell'operatore. Zenchef non rinvia modifiche a Ventrata.

 

Le tempistiche sono quelle tipiche di Zenchef, arrotondate, e possono cambiare.

 

Product Mapping

✅

Mappi ogni prodotto, opzione e unità Ventrata al prodotto Zenchef dell'operatore nella Ventrata Dashboard.

Il funzionamento è il seguente:

  • Prodotti – Ventrata legge prodotti, opzioni e unità dell'operatore in Zenchef per popolare i menu a tendina della scheda Mappings.

  • Percorsi rilevati: GET /api/v1/restaurants/{n}, GET /api/v1/restaurants/{n}/bookingrooms.

 

Cosa significa per te: se qualcosa manca nel menu a tendina, l'operatore non te l'ha reso disponibile in Zenchef. Chiedigli di farlo.

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da Zenchef.

Ventrata non importa i contenuti dei prodotti da Zenchef. Crei e descrivi tu stesso i prodotti in Ventrata.

Availability Sync

✅

Con Backend Availability attivo, Ventrata verifica la disponibilità in tempo reale dell'operatore in Zenchef.

Il funzionamento è il seguente:

  • Disponibilità – quando qualcuno usa il calendario della disponibilità in Ventrata, ad esempio nella Dashboard, nel tuo web checkout o su un terminale, Ventrata interroga Zenchef in tempo reale per le date visualizzate.

  • Sincronizza la disponibilità dal sistema Zenchef dell'operatore.

  • Percorsi rilevati: GET /api/v1/restaurants/{n}, GET /api/v1/restaurants/{n}/bookingrooms.

 

Di solito con Zenchef:

  • Le richieste coprono 7 giorni alla volta, da oggi fino a circa un anno in avanti, mentre gli utenti navigano e mentre Ventrata carica il calendario.

 

Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in Zenchef, quindi non puoi vendere in eccesso una fascia oraria che l'operatore ha già venduto altrove.

Pricing Sync

❌

Ventrata non legge i prezzi da Zenchef.

Ventrata non legge i prezzi da Zenchef. I prodotti usano i prezzi che imposti in Ventrata e le prenotazioni vengono comunque inviate a Zenchef.

Zenchef invia sia i prezzi al pubblico sia i prezzi netti. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico come tuo prezzo di vendita e il prezzo netto come tuo prezzo di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

Promotions Sync

❌

Le promozioni non vengono inviate a Zenchef.

Le promozioni non vengono inviate a Zenchef. Le tue promozioni Ventrata si applicano comunque al prezzo che il cliente paga in Ventrata.

Bookings Sync

✅

Le prenotazioni effettuate in Ventrata per un prodotto collegato al backend vengono create nell'account Zenchef dell'operatore.

Il funzionamento è il seguente:

  1. Blocco e conferma: quando il prodotto viene aggiunto al carrello, Ventrata verifica la prenotazione con Zenchef e, dopo il pagamento, crea la prenotazione nell'account Zenchef dell'operatore con i dati del cliente.

  2. Biglietti: il riferimento o i biglietti restituiti da Zenchef vengono salvati nella prenotazione Ventrata.

  3. Chiamate rilevate: Cancel Booking, Confirm Booking, Create Booking, Get Booking, Update Booking.

Invia prenotazioni, modifiche e cancellazioni da Ventrata a Zenchef. Riceve voucher/biglietti da Zenchef e li emette ai tuoi clienti.

 

‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Zenchef. Se l'operatore modifica o cancella una prenotazione in Zenchef, Ventrata non riceve alcuna notifica. Chiedi all'operatore di informarti di eventuali modifiche.

Pickups/Dropoff Sync

❌

I dettagli di pickup e drop-off non vengono trasmessi a Zenchef.

I dettagli di pickup e drop-off non vengono trasmessi a Zenchef. Se un prodotto li richiede, comunicali all'operatore in un altro modo.

Custom Questions Sync

❌

Le risposte alle tue domande di prenotazione non vengono trasmesse a Zenchef.

Le risposte alle tue domande di prenotazione non vengono trasmesse a Zenchef. Se l'operatore ne ha bisogno, comunicagliele in un altro modo.

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in Zenchef.

Extra e componenti aggiuntivi non vengono prenotati in Zenchef. Vengono prenotati solo prodotto, opzione e unità principali.

Redemption Sync

❌

I riscatti e le altre modifiche di stato in Zenchef non vengono rinviati a Ventrata dopo la conferma di una prenotazione.

I riscatti e le altre modifiche di stato in Zenchef non vengono rinviati a Ventrata dopo la conferma di una prenotazione.

Pass Walkup Scanning Sync

❌

La scansione dei pass walk-up non è disponibile con Zenchef.

La scansione dei pass walk-up non è disponibile con Zenchef.

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a Zenchef.

Le carte regalo Ventrata non vengono trasmesse a Zenchef. I pagamenti con carta regalo restano in Ventrata.

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Zenchef

  • Disponibilità in tempo reale: la disponibilità arriva da Zenchef mentre gli utenti navigano.

  • Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in Zenchef non arrivano a Ventrata.

  • API personalizzata: l'API di Zenchef non è OCTO, quindi alcune funzionalità possono essere limitate rispetto ai backend OCTO.

  • Pensata per le attrazioni che gestiscono anche un ristorante che richiede prenotazioni; i prodotti del ristorante possono essere rivenduti e inseriti in pacchetti tramite Ventrata.

 

FAQ

Ricevo un errore quando salvo la configurazione del backend dell'operatore.

Molto probabilmente il Restaurant ID di Zenchef e l'API Token di Zenchef o l'endpoint non sono corretti. Verificali con il tuo operatore. Se il problema persiste, contatta il nostro supporto tecnico.

Nelle impostazioni del prodotto non c'è la casella Backend Connected.

Molto probabilmente l'operatore impostato sul prodotto non ha un backend configurato. Controlla le impostazioni Backend Partner dell'operatore e riprova. Se il problema persiste, contatta il nostro supporto tecnico.

Il prodotto, l'opzione o l'unità che voglio mappare non compare nel menu a tendina.

I menu a tendina elencano ciò che l'operatore ti ha reso disponibile in Zenchef. Chiedi all'operatore. Se il problema persiste, contatta il nostro supporto tecnico.

Le prenotazioni non vanno a buon fine per un prodotto collegato al backend.

Controlla prima la mappatura del prodotto: ogni opzione e unità deve essere mappata. Poi verifica che la fascia oraria sia ancora disponibile in Zenchef. Se il problema persiste, contatta il nostro supporto tecnico.

Ricevo un errore durante il salvataggio della configurazione del backend dell'operatore.

Molto probabilmente il Restaurant ID di Zenchef e l'API Token di Zenchef non sono validi. Ricontrollali con il tuo operatore. Se il problema persiste, contatta l'assistenza.

Nelle impostazioni del prodotto non c'è la casella Backend Connected.

Molto probabilmente l'operatore selezionato sul prodotto non ha un backend configurato. Controlla la configurazione del backend e riprova. Se il problema persiste, contatta l'assistenza.

Il fornitore, il prodotto, l'opzione o l'unità che voglio mappare non è nel menu a tendina.

Il menu a tendina viene caricato in base alle sale del ristorante in Zenchef che ti sono state rese disponibili. Ricontrolla con il tuo operatore e con Zenchef. Se il problema persiste, contatta l'assistenza.

 

Risorse utili

 

 

Informazioni sul partner

ZENCHEF SAS (Paris Trade and Companies Register 528389794)

63 Av. de Villiers

75017 Paris, France

 

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

Hai ricevuto la risposta alla tua domanda?