Xola è una piattaforma di prenotazione ed e-commerce per operatori di tour, attività e attrazioni, che comprende checkout online, punto vendita, chioschi, liberatorie digitali, pianificazione di personale e attrezzature, liste d'attesa e recensioni, con Xolabot che gestisce il recupero dei carrelli e il follow-up di marketing. La sua base di operatori si concentra nelle categorie avventura ed esperienze, come tour in elicottero, zipline, escape room, sport acquatici, tour in barca e charter di pesca.

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

Per saperne di più su Xola, visita xola.com.

Sito web principale	xola.com
Tag	Booking / Ticketing System
Funzionalità della connessione	Availability Sync · Pricing Sync · Bookings Sync
Sviluppato da	Ventrata (tramite Xola OCTO API)

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

Availability Sync – la disponibilità in tempo reale proviene dall'account Xola dell'operatore.
Pricing Sync – i prezzi al pubblico e netti arrivano da Xola, oppure imposti tu i prezzi in Ventrata.
Bookings Sync – prenotazioni, modifiche e cancellazioni vengono inviate da Ventrata a Xola e Xola emette i biglietti o i voucher.

Creare la connessione con Xola

🔐 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 essere presente come Distribution Channel nell'App Store di Xola. Consulta il passaggio 1.
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: fatti inserire nell'App Store di Xola

Invia un'email a [email protected] e [email protected] indicando i nomi degli operatori Xola con cui vuoi collegarti, oltre al tuo logo, alla ragione sociale e a un referente per la scheda della tua app. Considera diversi giorni perché Xola esamini e approvi la tua richiesta.

Passaggio 2: ottieni la OCTO API Key dell'operatore

Una volta inserito, chiedi all'operatore di installare la tua app in Xola, selezionare le esperienze che vuole condividere con te e condividere con te in modo sicuro la OCTO API Key.

Passaggio 3: configura l'operatore in Ventrata

Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.
Nella sezione Backend Partner, seleziona Xola e inserisci la OCTO API Key. Lascia l'OCTO Endpoint predefinito https://octo.xola.com/latest, a meno che l'operatore o Xola non ti indichino diversamente.
Press Update Operator.

Nella sezione Backend Partner, scegli Xola 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 Xola, lascia nel campo OCTO Endpoint il valore predefinito già compilato per Xola

📒 NOTA – Ogni chiave API ti collega a un solo operatore. Configura separatamente ogni operatore Xola.

Passaggio 4: collega ogni prodotto

Apri il prodotto dell'operatore in Products → Products e modificalo. Verifica che Operator sia impostato su questo operatore.
Seleziona Backend Connected. Seleziona Backend Availability per usare la disponibilità di Xola e Backend Pricing per usare i prezzi di Xola.
Press Update Product.

📒 NOTA

Xola invia solo i prezzi al pubblico. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico e calcola il tuo prezzo netto (di costo) usando la percentuale di costo impostata sull'operatore nella Ventrata Dashboard.

Seleziona Backend Connected per questo prodotto per usare la connessione API (backend). Per recuperare la disponibilità da Xola, 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 Xola. Fai clic su Update Product per salvare.

Mappare i prodotti su Xola

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di Xola 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.

Nella Ventrata Dashboard, vai su Products → Products e apri il prodotto.
Apri la scheda Mappings. Compare dopo che il prodotto è stato impostato come Backend Connected.
Per ogni opzione e unità Ventrata, seleziona l'esperienza, l'opzione e le unità corrispondenti di Xola dai menu a tendina, che Ventrata carica da Xola. Non lasciare nessun campo vuoto.
Press 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 Xola. 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 Xola.

Gestire la connessione con Xola

Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in Xola.
Sostituisci la chiave sull'operatore se Xola 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 Xola.

Funzionalità della connessione in dettaglio

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

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

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

Product Mapping	✅	Mappi ogni prodotto, opzione e unità Ventrata sull'esperienza Xola dell'operatore nella Ventrata Dashboard. Il funzionamento è il seguente: Get Products (`GET /products`) – Ventrata legge le esperienze che l'operatore ha condiviso con te in Xola, con le relative opzioni e unità, per compilare i menu a tendina nella scheda Mappings. Capabilities (`GET /capabilities`) – Ventrata verifica quali capability OCTO supporta l'account Xola dell'operatore. Di solito con Xola: Ventrata rilegge prodotti e capability dell'operatore da Xola a intervalli di qualche ora, quindi le nuove esperienze che l'operatore condivide con te compaiono nei menu a tendina senza alcun intervento. Cosa significa per te: se nel menu a tendina manca un'esperienza, un'opzione o un'unità, l'operatore non l'ha ancora condivisa con te in Xola. Chiedigli di aggiungerla alla tua app.
Availability Sync	✅	Con Backend Availability attivo, Ventrata verifica la disponibilità in tempo reale dell'operatore in Xola. 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 Xola in tempo reale per le date visualizzate. Xola risponde con ogni fascia oraria, il suo stato e la capacità residua. Prima che qualcuno interagisca con il calendario, questo può mostrare il risultato dell'ultima verifica di quelle date (in cache). Di solito con Xola: Le richieste di solito coprono un solo giorno o pochi giorni alla volta, a partire da oggi e fino a circa 6 mesi in avanti, mentre gli utenti navigano. Cosa significa per te: i clienti prenotano sempre in base alla disponibilità in tempo reale dell'operatore in Xola, quindi non puoi vendere in eccesso una fascia oraria che l'operatore ha già venduto altrove. Ventrata chiede la disponibilità a Xola per intervalli di 7 giorni o per un solo giorno.
Pricing Sync	✅	Con Backend Pricing attivo, Ventrata prende da Xola sia i prezzi al pubblico sia i prezzi netti. Il funzionamento è il seguente: Availability Check con la capability `octo/pricing` – Ventrata chiede i prezzi a Xola a ogni richiesta di disponibilità. I prezzi vengono mostrati all'utente e salvati in Ventrata come tariffe generate dall'API. I prezzi netti (all'ingrosso) di Xola vengono registrati come prezzo 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 Xola. Xola invia solo i prezzi al pubblico. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico e calcola il tuo prezzo netto (di costo) usando la percentuale di costo impostata sull'operatore nella Ventrata Dashboard.
Bookings Sync	✅	Prenotazioni, modifiche e cancellazioni effettuate in Ventrata per un prodotto collegato al backend vengono inviate automaticamente a Xola. Il funzionamento è il seguente: Blocco: Booking Reservation (`POST /bookings`) – quando il prodotto viene aggiunto al carrello in Ventrata, Ventrata riserva i posti in Xola. Conferma: Booking Confirmation (`POST /bookings/{uuid}/confirm`) – dopo il pagamento, Ventrata conferma la prenotazione in Xola con i dati di contatto del cliente. Il biglietto o voucher restituito da Xola diventa il biglietto o voucher Ventrata, tranne PDF_FILE, che Ventrata non supporta. Modifica: Booking Update (`PATCH /bookings/{uuid}`) – quando una prenotazione viene modificata in Ventrata, la modifica viene inviata a Xola. Cancellazione: Booking Cancellation (`POST /bookings/{uuid}/cancel`) – quando una prenotazione viene cancellata in Ventrata, viene cancellata anche in Xola. ‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Xola. Se l'operatore modifica o cancella una prenotazione in Xola, Ventrata non riceve alcuna notifica. Chiedi all'operatore di informarti di eventuali modifiche.
Content Sync	❌	Ventrata non importa i contenuti dei prodotti da Xola. Ventrata non importa i contenuti dei prodotti da Xola. Crei e descrivi tu stesso i prodotti in Ventrata.
Promotions Sync	❌	Le promozioni non vengono inviate a Xola. Le promozioni non vengono inviate a Xola. Le tue promozioni Ventrata si applicano comunque al prezzo che il cliente paga in Ventrata.
Pickups/Dropoff Sync	❌	I dettagli di pickup e drop-off non vengono trasmessi a Xola. I dettagli di pickup e drop-off non vengono trasmessi a Xola. 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 Xola. Le risposte alle tue domande di prenotazione non vengono trasmesse a Xola. Se l'operatore ne ha bisogno, comunicagliele in un altro modo.
Extras Sync	❌	Extra e componenti aggiuntivi non vengono prenotati in Xola. Extra e componenti aggiuntivi non vengono prenotati in Xola. Vengono prenotati solo prodotto, opzione e unità principali.
Redemption Sync	❌	I riscatti e le altre modifiche di stato in Xola non vengono rinviati a Ventrata dopo la conferma di una prenotazione. I riscatti e le altre modifiche di stato in Xola non vengono rinviati a Ventrata dopo la conferma di una prenotazione.
Pass Walkup Scanning Sync	❌	La scansione dei pass walk-up non è disponibile con Xola. La scansione dei pass walk-up non è disponibile con Xola.
Gift Card Sync	❌	Le carte regalo Ventrata non vengono trasmesse a Xola. Le carte regalo Ventrata non vengono trasmesse a Xola. I pagamenti con carta regalo restano in Ventrata.

✅ supportato · ❌ non supportato

Buono a sapersi: limiti e dettagli della connessione con Xola

Un operatore per chiave: ogni operatore Xola ti fornisce la propria OCTO API Key.
Solo esperienze condivise: puoi mappare e vendere solo le esperienze che l'operatore ha condiviso con la tua app in Xola.
Disponibilità in tempo reale: la disponibilità proviene da Xola mentre gli utenti navigano, quindi non c'è alcuna disponibilità da sincronizzare a mano.
Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in Xola non arrivano a Ventrata.

FAQ

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

Molto probabilmente la OCTO API Key o l'OCTO 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 mostrano ciò che l'operatore ha condiviso con te in Xola. Chiedi all'operatore di condividerlo. 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 Xola. Se il problema persiste, contatta il nostro supporto tecnico.

Risorse utili

📚 Altro sulle connessioni Ventrata

Informazioni sul partner

Xola, Inc.

Hewes Building, 995 Market St

San Francisco, CA 94103, USA

xola.com

Ventrata Partner ID: 360a0ae4-5437-4c21-9dfa-68c0e8e22c8a

Xola: backend operatore