Onebox è un sistema di distribuzione di biglietti con sede a Barcellona per eventi dal vivo e tempo libero, usato da promoter, strutture, festival, teatri, musei, stadi e parchi tematici per gestire vendite, prezzi dinamici, mappe dei posti, capienza e controllo accessi. Tra i clienti figurano l'Atlético de Madrid e il Teatro Apolo; l'azienda dichiara oltre 65 milioni di biglietti venduti e la sua rete di distribuzione raggiunge operatori di biglietteria, agenzie di viaggio, hotel e centri commerciali in tutta la Spagna.
Collegare Onebox a Ventrata ti permette di rivendere i prodotti di operatori che usano Onebox come sistema di prenotazione. Ventrata legge da Onebox la loro disponibilità e i loro prezzi in tempo reale e ogni prenotazione che ricevi viene creata direttamente nell'account Onebox dell'operatore.
Per saperne di più su Onebox, visita oneboxtds.com.
📒 NOTA
Questa connessione sarà disponibile a breve. È in fase di sviluppo. Se vuoi utilizzarla, contatta il nostro supporto tecnico o il tuo Customer Success Manager Ventrata.
‼️ IMPORTANTE
La mappatura indica a Ventrata per quale prodotto richiedere la disponibilità a Onebox. Se un prodotto collegato al backend non è mappato correttamente, le sue prenotazioni non andranno a buon fine. Un'evidenziazione rossa sull'intera riga del prodotto indica che il prodotto non è mappato correttamente.
📒 NOTA
Ricrea in Ventrata i prodotti di Onebox, rispecchiando esattamente la configurazione di Onebox.
📗 SUGGERIMENTO
Durante la creazione dell'operatore sono obbligatori solo i campi contrassegnati da un asterisco (*).
Sito web principale | |
Tag | Booking / Ticketing System |
Funzionalità della connessione | Availability Sync · Pricing Sync · Bookings Sync |
Sviluppato da | Ventrata (tramite Onebox Distribution API) |
Questa connessione operatore (detta anche backend) ti permette di rivendere i prodotti di operatori che usano Onebox come sistema di prenotazione principale, e ogni prenotazione viene creata direttamente in Onebox. Le funzionalità di questa connessione includono:
Availability Sync – la disponibilità in tempo reale proviene dall'account Onebox dell'operatore.
Pricing Sync – i prezzi arrivano da Onebox, oppure li imposti tu in Ventrata.
Bookings Sync – le prenotazioni vengono inviate da Ventrata a Onebox e Onebox emette i biglietti o i voucher.
L'API esterna di Onebox 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 Onebox
🔐 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 Channel ID e Client Secret dell'operatore. Segui i passaggi qui sotto.
Ricrea in Ventrata i prodotti di Onebox, rispecchiando esattamente la configurazione di Onebox.
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: firma un accordo commerciale e richiedi le credenziali
Firma un accordo commerciale con l'operatore di cui intendi rivendere i prodotti tramite Onebox.
Contatta Onebox e richiedi le credenziali indicate di seguito.
Channel ID
Client Secret
Passaggio 2: configurare l'operatore in Ventrata
Contatta Onebox e richiedi il Channel ID e il Client Secret.
Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.
Nella sezione Backend Partner, seleziona Onebox e inserisci Channel ID e Client Secret.
Press Update Operator.
Passaggio 3: 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 Onebox e Backend Pricing per usare i prezzi di Onebox.
Press Update Product.
📒 NOTA
Onebox invia solo prezzi netti. Con Backend Pricing selezionato, Ventrata registra il prezzo netto come tuo prezzo di costo e calcola il prezzo al pubblico usando la percentuale di costo impostata sull'operatore nella Ventrata Dashboard.
Seleziona Backend Connected e lascia selezionato Backend Availability.
Seleziona Backend Pricing se vuoi ereditare i prezzi dal partner backend.
Mappare i prodotti su Onebox
‼️ IMPORTANTE
La mappatura indica a Ventrata per quali prodotto, opzione e unità di Onebox 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 Onebox, il prodotto, l'opzione e le unità corrispondenti di Onebox. 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 Onebox.
Gestire la connessione con Onebox
Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in Onebox.
Sostituisci la chiave sull'operatore se Onebox 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 Onebox.
Funzionalità della connessione in dettaglio
Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Onebox. Qui la direzione è opposta a quella di una connessione rivenditore: è Ventrata a chiamare Onebox, tramite l'Onebox Distribution API. Per ogni funzionalità spiega quali chiamate effettua Ventrata, quando e cosa significa per te.
In breve: Ventrata chiede a Onebox disponibilità e prezzi ogni volta che qualcuno visualizza un prodotto collegato al backend e crea ogni prenotazione nell'account Onebox dell'operatore. Onebox non rinvia modifiche a Ventrata.
Le tempistiche sono quelle tipiche di Onebox, arrotondate, e possono cambiare.
Product Mapping | ✅ |
Mappi ogni prodotto, opzione e unità Ventrata al prodotto Onebox 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 Onebox. Chiedigli di farlo. |
Content Sync | ❌ |
Ventrata non importa i contenuti dei prodotti da Onebox. Ventrata non importa i contenuti dei prodotti da Onebox. 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 Onebox. Il funzionamento è il seguente:
Di solito con Onebox:
Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in Onebox, 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 Onebox. Il funzionamento è il seguente:
Onebox invia solo prezzi netti. Con Backend Pricing selezionato, Ventrata registra il prezzo netto come tuo prezzo di costo e calcola il prezzo al pubblico usando la percentuale di costo impostata sull'operatore nella Ventrata Dashboard. |
Promotions Sync | ❌ |
Le promozioni non vengono inviate a Onebox. Le promozioni non vengono inviate a Onebox. 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 Onebox dell'operatore. Il funzionamento è il seguente:
Invia le prenotazioni da Ventrata a Onebox. Le modifiche e le cancellazioni delle prenotazioni da Ventrata a Onebox non sono supportate.
‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Onebox. Se l'operatore modifica o cancella una prenotazione in Onebox, 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 Onebox. I dettagli di pickup e drop-off non vengono trasmessi a Onebox. 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 Onebox. Le risposte alle tue domande di prenotazione non vengono trasmesse a Onebox. Se l'operatore ne ha bisogno, comunicagliele in un altro modo. |
Extras Sync | ❌ |
Extra e componenti aggiuntivi non vengono prenotati in Onebox. Extra e componenti aggiuntivi non vengono prenotati in Onebox. Vengono prenotati solo prodotto, opzione e unità principali. |
Redemption Sync | ❌ |
I riscatti e le altre modifiche di stato in Onebox non vengono rinviati a Ventrata dopo la conferma di una prenotazione. I riscatti e le altre modifiche di stato in Onebox non vengono rinviati a Ventrata dopo la conferma di una prenotazione. |
Pass Walkup Scanning Sync | ❌ |
La scansione dei pass walk-up non è disponibile con Onebox. La scansione dei pass walk-up non è disponibile con Onebox. |
Gift Card Sync | ❌ |
Le carte regalo Ventrata non vengono trasmesse a Onebox. Le carte regalo Ventrata non vengono trasmesse a Onebox. I pagamenti con carta regalo restano in Ventrata. |
✅ supportato · ❌ non supportato
Buono a sapersi: limiti e dettagli della connessione con Onebox
Buono a sapersi: limiti e dettagli della connessione con Onebox
Disponibilità in tempo reale: la disponibilità arriva da Onebox mentre gli utenti navigano.
Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in Onebox non arrivano a Ventrata.
API personalizzata: l'API di Onebox non è OCTO, quindi alcune funzionalità possono essere limitate rispetto ai backend OCTO.
Onebox è un sistema centralizzato di distribuzione di biglietti (TDS) che dà accesso a inventario, prezzi e mappe dei posti assegnati per eventi dal vivo di più strutture tramite un unico gateway API.
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 Channel ID e Client Secret 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 Onebox. 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 Onebox. Se il problema persiste, contatta il nostro supporto tecnico.
Risorse utili
📚 Altro sulle connessioni Ventrata
Informazioni sul partner
ONEBOX IBERICA, S.L.
Via Augusta 21 - 23
08006 Barcelona, Spain
Ventrata Partner ID: 4b72f238-0436-4b6a-ae39-5849d1f7740c