Bókun è la piattaforma di prenotazione e distribuzione di Tripadvisor per operatori di tour, attrazioni, attività, noleggi e trasporto terrestre, usata da migliaia di aziende in tutto il mondo. Il suo marketplace comprende oltre 2.600 OTA e rivenditori, e, grazie alla proprietà comune con Viator, è un backend frequente per gli operatori la cui domanda arriva in gran parte da Tripadvisor.
Collegare Bókun a Ventrata ti permette di rivendere i prodotti di operatori che usano Bókun come sistema di prenotazione. Ventrata legge da Bókun la loro disponibilità e i loro prezzi in tempo reale e ogni prenotazione che ricevi viene creata direttamente nell'account Bókun dell'operatore.
Per saperne di più su Bókun, visita bokun.io.
📒 NOTA
Vuoi invece che Bókun rivenda i tuoi prodotti? Consulta Bókun: connessione rivenditore.
📒 NOTA
Questa connessione sarà disponibile a breve. È in fase di sviluppo, con lancio previsto tra novembre e dicembre 2026. Se vuoi usarla, contatta il nostro supporto tecnico o il tuo Customer Success Manager Ventrata.
Sito web principale | |
Tag | Booking / Ticketing System |
Funzionalità della connessione | Availability Sync · Pricing Sync · Bookings Sync |
Sviluppato da | Ventrata (tramite Bókun OCTO API) |
Questa connessione operatore (detta anche backend) ti permette di rivendere i prodotti di operatori che usano Bókun come sistema di prenotazione principale, e ogni prenotazione viene creata direttamente in Bókun. Le funzionalità di questa connessione includono:
Availability Sync – la disponibilità in tempo reale proviene dall'account Bókun dell'operatore.
Pricing Sync – i prezzi arrivano da Bókun, oppure li imposti tu in Ventrata.
Bookings Sync – prenotazioni, modifiche e cancellazioni vengono inviate da Ventrata a Bókun e Bókun emette i biglietti o i voucher.
Creare la connessione con Bókun
🔐 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.
L'azienda di cui vuoi rivendere i prodotti è creata come operatore in Ventrata.
I prodotti dell'operatore sono creati in Ventrata. La connessione sincronizza disponibilità, prezzi e prenotazioni, ma non crea i prodotti.
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
Chiedila all'operatore che usa Bókun. La crea in Bókun: Settings → Connectivity → API keys → Create an API key → Save → abilita OCTO su questa chiave API.
Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.
Nella sezione Backend Partner, seleziona Bókun e inserisci la OCTO API Key. Lascia l'endpoint predefinito
https://api.bokun.io/octo/v1, a meno che l'operatore o Bókun non ti indichino diversamente.Scegli Bókun nella sezione Backend Partner dell'operatore.
Inserisci la OCTO API Key. Lascia l'OCTO Endpoint con il valore predefinito precompilato, a meno che l'operatore non ti indichi diversamente.
Click Update Operator.
Press Update Operator.
📒 NOTA – Ogni chiave API OCTO ti collega a un solo operatore. Configura ciascun operatore Bókun separatamente.
Passaggio 2: 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 Bókun e Backend Pricing per usare i prezzi di Bókun.
Press Update Product.
📒 NOTA
Bókun 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.
Imposta come Operator del prodotto l'operatore con il backend Bókun, seleziona Backend Connected, poi Backend Availability e/o Backend Pricing. Senza di essi, il prodotto usa la disponibilità/i prezzi impostati in Ventrata, ma invia comunque le prenotazioni a Bókun.
Mappare i prodotti su Bókun
‼️ IMPORTANTE
La mappatura indica a Ventrata per quali prodotto, opzione e unità di Bókun 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 dai menu a tendina, che Ventrata carica da Bókun, il prodotto, l'opzione e le unità corrispondenti di Bókun. Non lasciare nessun campo vuoto.
Press Save Changes.
📗 SUGGERIMENTO
Dopo la mappatura effettua una prenotazione di test e chiedi all'operatore di confermare che sia arrivata nel suo account Bókun.
Gestire la connessione con Bókun
Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in Bókun.
Sostituisci la chiave sull'operatore se Bókun 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 Bókun.
Funzionalità della connessione in dettaglio
Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Bókun. Qui la direzione è opposta a quella di una connessione rivenditore: è Ventrata a chiamare Bókun, tramite Bókun OCTO API. Per ogni funzionalità spiega quali chiamate effettua Ventrata, quando e cosa significa per te.
In breve: Ventrata chiede a Bókun disponibilità e prezzi ogni volta che qualcuno visualizza un prodotto collegato al backend e crea ogni prenotazione nell'account Bókun dell'operatore. Bókun non rinvia modifiche a Ventrata.
Le tempistiche sono quelle tipiche di Bókun, arrotondate, e possono cambiare.
Product Mapping | ✅ |
Mappi ogni prodotto, opzione e unità Ventrata al prodotto Bókun dell'operatore nella Ventrata Dashboard. Il funzionamento è il seguente:
Cosa significa per te: se qualcosa manca nel menu a tendina, l'operatore non te l'ha reso disponibile in Bókun. Chiedigli di farlo. |
Content Sync | ❌ |
Ventrata non importa i contenuti dei prodotti da Bókun. Ventrata non importa i contenuti dei prodotti da Bókun. 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 Bókun. Il funzionamento è il seguente:
Di solito con Bókun:
Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in Bókun, 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 Bókun. Il funzionamento è il seguente:
Bókun 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. |
Promotions Sync | ❌ |
Le promozioni non vengono inviate a Bókun. Le promozioni non vengono inviate a Bókun. 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 Bókun dell'operatore. Il funzionamento è il seguente:
Prenotazioni, modifiche e cancellazioni per i prodotti Backend Connected vengono inviate automaticamente a Bókun: blocco quando il prodotto viene aggiunto al carrello, conferma dopo il pagamento (con i dati di contatto del cliente), aggiornamento quando una prenotazione cambia, cancellazione quando una prenotazione viene cancellata. Il voucher/biglietto di Bókun viene acquisito in Ventrata, tranne PDF_FILE, che Ventrata non supporta.
‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Bókun. Se l'operatore modifica o cancella una prenotazione in Bókun, 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 Bókun. I dettagli di pickup e drop-off non vengono trasmessi a Bókun. 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 Bókun. Le risposte alle tue domande di prenotazione non vengono trasmesse a Bókun. Se l'operatore ne ha bisogno, comunicagliele in un altro modo. |
Extras Sync | ❌ |
Extra e componenti aggiuntivi non vengono prenotati in Bókun. Extra e componenti aggiuntivi non vengono prenotati in Bókun. Vengono prenotati solo prodotto, opzione e unità principali. |
Redemption Sync | ❌ |
I riscatti e le altre modifiche di stato in Bókun non vengono rinviati a Ventrata dopo la conferma di una prenotazione. I riscatti e le altre modifiche di stato in Bókun non vengono rinviati a Ventrata dopo la conferma di una prenotazione. Non supportato. Lo stato della prenotazione in Bókun (ad esempio Redeemed) non viene comunicato a Ventrata dopo la conferma. |
Pass Walkup Scanning Sync | ❌ |
La scansione dei pass walk-up non è disponibile con Bókun. La scansione dei pass walk-up non è disponibile con Bókun. |
Gift Card Sync | ❌ |
Le carte regalo Ventrata non vengono trasmesse a Bókun. Le carte regalo Ventrata non vengono trasmesse a Bókun. I pagamenti con carta regalo restano in Ventrata. |
✅ supportato · ❌ non supportato
Buono a sapersi: limiti e dettagli della connessione con Bókun
Buono a sapersi: limiti e dettagli della connessione con Bókun
Disponibilità in tempo reale: la disponibilità arriva da Bókun mentre gli utenti navigano.
Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in Bókun non arrivano a Ventrata.
Bókun, parte di Tripadvisor, è un sistema di prenotazione, gestione dell'inventario e channel management per tour, attività e attrazioni.
FAQ
Ricevo un errore quando salvo la configurazione del backend dell'operatore.
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.
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.
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 Bókun. 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.
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 Bókun. Se il problema persiste, contatta il nostro supporto tecnico.
Errore durante l'aggiornamento dell'operatore per salvare la configurazione del backend.
Errore durante l'aggiornamento dell'operatore per salvare la configurazione del backend.
Probabilmente la OCTO API Key o l'OCTO Endpoint non sono corretti. Ricontrolla questi dati con il tuo operatore. Se il problema persiste, contatta l'assistenza Ventrata.
Il prodotto/l'opzione/l'unità che voglio mappare non è nel menu a tendina.
Il prodotto/l'opzione/l'unità che voglio mappare non è nel menu a tendina.
Il menu a tendina viene recuperato da Bókun in base a prodotti, opzioni e unità che l'operatore ti ha reso disponibili. Verifica questi dettagli con il tuo operatore. Se il problema persiste, contatta il supporto Ventrata.
Risorse utili
📚 Altro sulle connessioni Ventrata
Informazioni sul partner
Tripadvisor LLC dba Bókun
400 1st Avenue
Needham, MA 02494, USA
Ventrata Partner ID: 18d71b21-57e4-4811-8818-a7be06311725