Vai al contenuto principale

Zaui: backend operatore

Collega Zaui a Ventrata per rivendere i prodotti degli operatori Zaui con disponibilità, prezzi e prenotazioni in tempo reale.

Zaui logo

 

Zaui è una piattaforma di prenotazione con sede a Vancouver per operatori di tour, attività, trasporti e noleggi, attiva dal 1999 e pensata per inventari basati su posti e fasce orarie. Le aziende orientate ai trasporti sono un suo punto di forza particolare: navette, pullman interurbani, trasferimenti da aeroporti e porti crocieristici e servizi in barca, insieme a visite turistiche e tour di più giorni, con channel management, prezzi dinamici e check-in da mobile da un'unica dashboard.

 

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

 

Per saperne di più su Zaui, visita zaui.com.

 

📒 NOTA

Vuoi invece che Zaui rivenda i tuoi prodotti? Consulta Zaui: connessione rivenditore.

 

Sito web principale

Tag

Booking / Ticketing System

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

Ventrata (tramite Zaui OCTO API)

 

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

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

  • Pricing Sync – i prezzi arrivano da Zaui, oppure li imposti tu in Ventrata.

  • Bookings Sync – prenotazioni, modifiche e cancellazioni vengono inviate da Ventrata a Zaui e Zaui emette i biglietti o i voucher.

 

Creare la connessione con Zaui

🔐 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 la OCTO API Key per l'operatore. Vedi i passaggi seguenti.

  • 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 la OCTO API Key al tuo operatore. Gli operatori possono configurare la connessione (canale) e ottenere la chiave in Zaui in Resellers > Channel Partners, selezionando poi Ventrata.

 

  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 Zaui e inserisci la OCTO API Key. Lascia l'endpoint predefinito https://api.zaui.io/octo, a meno che l'operatore o Zaui non ti indichino diversamente.

  3. Lascia nel campo OCTO Endpoint il valore Zaui già compilato, salvo diverse indicazioni dell'operatore o di Zaui.

  4. Fai clic su Update Operator.

 

 

Nella sezione Backend Partner, scegli Zaui dall'elenco delle connessioni disponibili e inserisci la chiave API OCTO che ti ha fornito il tuo operatore. Salvo diverse indicazioni dell'operatore o di Zaui, lascia nel campo OCTO Endpoint il valore predefinito già compilato per Zaui

 

📒 NOTA – Ogni chiave API OCTO ti collega a un solo operatore. Configura ciascun operatore Zaui separatamente.

 

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 Zaui e Backend Pricing per usare i prezzi di Zaui.

  3. Fai clic su Update Product.

📒 NOTA

Zaui 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 Zaui e Backend Pricing per recuperare i prezzi.

 

Senza queste opzioni, il prodotto usa la disponibilità e i prezzi impostati in Ventrata, ma invia comunque le prenotazioni a Zaui.

 

Seleziona Backend Connected per questo prodotto per usare la connessione API (backend). Per recuperare la disponibilità da Zaui, assicurati che Backend Availability sia selezionato; per recuperare i prezzi, seleziona Backend Pricing. Se non selezioni Backend Availability e/o Backend Pricing, il prodotto userà la disponibilità e/o i prezzi configurati in Ventrata, ma invierà comunque le prenotazioni a Zaui. Fai clic su Update Product per salvare.

 

Mappare i prodotti su Zaui

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di Zaui 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 Zaui, il prodotto, l'opzione e le unità corrispondenti di Zaui. Non lasciare nessun campo vuoto.

  4. Fai clic su Save Changes.

 

La pagina del prodotto mostrerà ora una scheda Mappings. Apri questa scheda e mappa il tuo prodotto, le opzioni e le unità Ventrata selezionando i prodotti, le opzioni e le unità corrispondenti dai menu a tendina ricevuti da Zaui. Assicurati che nessun campo resti vuoto (non mappato) e fai clic su Save Changes.

 

📗 SUGGERIMENTO

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

 

Gestire la connessione con Zaui

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

  • Sostituisci la chiave sull'operatore se Zaui 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 Zaui.

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

✅

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

Il funzionamento è il seguente:

  • Get Products (GET /products) – Ventrata legge prodotti, opzioni e unità dell'operatore in Zaui per popolare i menu a tendina della scheda Mappings.

 

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

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da Zaui.

Ventrata non importa i contenuti dei prodotti da Zaui. 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 Zaui.

Il funzionamento è il seguente:

  • Availability Check (POST /availability) – quando qualcuno usa il calendario della disponibilità in Ventrata, ad esempio nella Dashboard, nel tuo web checkout o su un terminale, Ventrata interroga Zaui in tempo reale per le date visualizzate.

  • Con Backend Availability attivo, Ventrata invia una richiesta in tempo reale a Zaui quando un utente interagisce con il calendario della disponibilità (dashboard, web checkout, terminale e così via). Le richieste riguardano di solito un intervallo di 7 giorni o un giorno specifico. Finché l'utente non interagisce con il calendario, questo può mostrare dati in cache, non in tempo reale, della richiesta precedente.

 

Di solito con Zaui:

  • 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 Zaui, quindi non puoi vendere in eccesso una fascia oraria che l'operatore ha già venduto altrove.

Pricing Sync

✅

Con Backend Pricing attivo, Ventrata prende i prezzi da Zaui.

Il funzionamento è il seguente:

  • Availability Check con la capability octo/pricing – Ventrata chiede a Zaui i prezzi a ogni richiesta di disponibilità.

  • Con Backend Pricing attivo, Ventrata recupera da Zaui sia i prezzi al pubblico sia i prezzi netti (all'ingrosso) nella stessa richiesta di disponibilità in tempo reale. I prezzi vengono mostrati all'utente e memorizzati in cache/salvati in Ventrata come tariffe generate dall'API. I prezzi netti vengono registrati come prezzi di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

  • Con Backend Pricing disattivato, il prodotto usa i prezzi che imposti in Ventrata e le prenotazioni vengono comunque inviate a Zaui.

Zaui 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 Zaui.

Le promozioni non vengono inviate a Zaui. 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 Zaui dell'operatore.

Il funzionamento è il seguente:

  1. Blocco: Booking Reservation (POST /bookings) – quando il prodotto viene aggiunto al carrello in Ventrata, Ventrata riserva i posti in Zaui.

  2. Conferma: Booking Confirmation (POST /bookings/{uuid}/confirm) – dopo il pagamento, Ventrata conferma la prenotazione in Zaui con i dati di contatto del cliente, e il biglietto o voucher restituito da Zaui diventa il biglietto o voucher Ventrata.

  3. Modifica: Booking Update (PATCH /bookings/{uuid}) – le modifiche effettuate in Ventrata vengono inviate a Zaui.

  4. Cancellazione: Booking Cancellation (POST /bookings/{uuid}/cancel) – le cancellazioni effettuate in Ventrata vengono inviate a Zaui.

Blocco quando un prodotto viene aggiunto al carrello. Conferma dopo il pagamento, con invio dei dati di contatto del cliente; il voucher/biglietto di Zaui viene acquisito in Ventrata (tranne PDF_FILE, che Ventrata non supporta). Le modifiche e le cancellazioni effettuate in Ventrata vengono inviate a Zaui.

 

‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Zaui. Se l'operatore modifica o cancella una prenotazione in Zaui, 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 Zaui.

I dettagli di pickup e drop-off non vengono trasmessi a Zaui. 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 Zaui.

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

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in Zaui.

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

Redemption Sync

❌

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

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

Non supportato. Lo stato della prenotazione in Zaui, ad esempio Redeemed, non viene rinviato a Ventrata dopo la conferma.

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a Zaui.

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

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Zaui

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

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

 

FAQ

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

Molto probabilmente la OCTO API Key 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 Zaui. 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 Zaui. Se il problema persiste, contatta il nostro supporto tecnico.

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

Molto probabilmente la OCTO API Key o l'OCTO Endpoint non sono corretti. 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.

 

Risorse utili

 

 

Informazioni sul partner

Zaui Software Ltd.

Suite 423 - 119 Pender Street West

Vancouver, BC V6B 1S5, Canada

 

Ventrata Partner ID: 09fc078e-fea1-4519-92d4-5eef643ca954

Hai ricevuto la risposta alla tua domanda?