Outbox è una piattaforma di biglietteria cloud con sede a Montréal per eventi dal vivo e location, venduta in white label con biglietti digitali e wallet, posti liberi e numerati, mappe dei posti in 3D, controllo di inventario e distribuzione e un'API completa, in più lingue e valute. L'azienda dichiara oltre 500 milioni di biglietti venduti per clienti tra cui Bell Centre, Cirque du Soleil, Osheaga, The O2 e location in Canada, Stati Uniti, Regno Unito e Messico.
Collegare Outbox a Ventrata ti permette di rivendere i prodotti di operatori che usano Outbox come sistema di prenotazione. Ventrata legge da Outbox la loro disponibilità e i loro prezzi in tempo reale e ogni prenotazione che ricevi viene creata direttamente nell'account Outbox dell'operatore.
Per saperne di più su Outbox, visita outbox.com.
‼️ IMPORTANTE
L'API esterna di Outbox usata per questa connessione è un'API XML-RPC personalizzata che non segue lo standard API OCTO, il che può limitare alcune funzionalità e capacità.
‼️ IMPORTANTE
Poiché Outbox vende posti con ingresso a orario, usa sempre Backend Availability. Senza di esso, si possono effettuare prenotazioni per fasce orarie che non esistono o sono esaurite in Outbox, e queste non andranno a buon fine.
📗 SUGGERIMENTO
Dopo la mappatura effettua una prenotazione di test e chiedi all'operatore di confermare che sia arrivata in Outbox con la fascia oraria e i tipi di biglietto corretti.
Sito web principale | |
Tag | Booking / Ticketing System |
Funzionalità della connessione | Availability Sync · Pricing Sync · Bookings Sync |
Sviluppato da | Ventrata (tramite Outbox Partner Sell API) |
Questa connessione operatore (detta anche backend) ti permette di rivendere i prodotti di operatori che usano Outbox come sistema di prenotazione principale, e ogni prenotazione viene creata direttamente in Outbox. Le funzionalità di questa connessione includono:
Availability Sync – la disponibilità in tempo reale proviene dall'account Outbox dell'operatore.
Pricing Sync – i prezzi arrivano da Outbox, oppure li imposti tu in Ventrata.
Bookings Sync – le prenotazioni vengono inviate da Ventrata a Outbox e Outbox emette i biglietti o i voucher.
L'API esterna di Outbox 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 Outbox
🔐 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 l'API Key e l'API URL per l'operatore. Vedi i passaggi seguenti.
Assicurati di ricevere le credenziali di produzione: staging e produzione usano URL e chiavi diversi, e l'inventario di produzione è configurato separatamente da quello di staging.
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
Il tuo operatore richiede per te un nuovo canale API al proprio account manager di Outbox, che configura anche gli onsale e l'inventario che puoi vendere. Outbox rilascia le credenziali.
Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.
Nella sezione Backend Partner, seleziona Outbox e inserisci l'API Key e l'API URL.
Inserisci l'API Key: ti identifica come canale di vendita (rivenditore) nel sistema Outbox dell'operatore e determina quali onsale (prodotti) e quale valuta ti sono disponibili. Ogni rivenditore ha bisogno di una propria chiave; le chiavi non possono essere condivise tra aziende.
Inserisci l'API URL: l'indirizzo dell'API Outbox dell'operatore, di solito sul dominio di biglietteria dell'operatore e terminante con /extapi/ (ad esempio https://tickets.onetimessquare.com/extapi/). Deve iniziare con https://.
Press Update Operator.
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 Outbox e Backend Pricing per usare i prezzi di Outbox.
Press Update Product.
📒 NOTA
Outbox 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, poi Backend Availability per recuperare fasce orarie e disponibilità e Backend Pricing per recuperare i prezzi.
Mappare i prodotti su Outbox
‼️ IMPORTANTE
La mappatura indica a Ventrata per quali prodotto, opzione e unità di Outbox 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 Outbox, il prodotto, l'opzione e le unità corrispondenti di Outbox. 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 Outbox.
Gestire la connessione con Outbox
Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in Outbox.
Sostituisci la chiave sull'operatore se Outbox 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 Outbox.
Funzionalità della connessione in dettaglio
Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Outbox. Qui la direzione è opposta a quella di una connessione rivenditore: è Ventrata a chiamare Outbox, tramite Outbox Partner Sell API. Per ogni funzionalità spiega quali chiamate effettua Ventrata, quando e cosa significa per te.
In breve: Ventrata chiede a Outbox disponibilità e prezzi ogni volta che qualcuno visualizza un prodotto collegato al backend e crea ogni prenotazione nell'account Outbox dell'operatore. Outbox non rinvia modifiche a Ventrata.
Le tempistiche sono quelle tipiche di Outbox, arrotondate, e possono cambiare.
Product Mapping | ✅ |
Mappi ogni prodotto, opzione e unità Ventrata al prodotto Outbox 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 Outbox. Chiedigli di farlo. |
Content Sync | ❌ |
Ventrata non importa i contenuti dei prodotti da Outbox. Ventrata non importa i contenuti dei prodotti da Outbox. 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 Outbox. Il funzionamento è il seguente:
Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in Outbox, 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 Outbox. Il funzionamento è il seguente:
Outbox 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 Outbox. Le promozioni non vengono inviate a Outbox. 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 Outbox dell'operatore. Il funzionamento è il seguente:
Prenotazione: i posti vengono bloccati in Outbox per il periodo di blocco restituito da Outbox quando un prodotto viene aggiunto al carrello; ogni ordine Outbox copre una sola fascia oraria. Conferma: dopo il pagamento, con i dati di contatto del cliente; nome, cognome, email e paese sono obbligatori, telefono e codice postale vengono trasmessi se disponibili e la lingua del cliente viene impostata su francese o inglese in base alla sua impostazione locale. Il numero d'ordine Outbox viene registrato come Supplier Reference. Biglietti: per ogni posto viene emesso un codice a barre come codice QR su ciascun biglietto Ventrata, oltre a un PDF con tutti i biglietti dell'ordine; i valori dei QR corrispondono al PDF di Outbox. Modifica: Outbox non può modificare un ordine esistente tramite API, quindi aggiornare una prenotazione confermata riemette solo i biglietti; per cambiare data, fascia oraria o numero di biglietti, cancella e prenota di nuovo. Cancellazione: cancellare una prenotazione confermata cancella l'ordine Outbox; cancellare una prenotazione non confermata (in attesa) libera i posti bloccati.
‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Outbox. Se l'operatore modifica o cancella una prenotazione in Outbox, 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 Outbox. I dettagli di pickup e drop-off non vengono trasmessi a Outbox. 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 Outbox. Le risposte alle tue domande di prenotazione non vengono trasmesse a Outbox. Se l'operatore ne ha bisogno, comunicagliele in un altro modo. |
Extras Sync | ❌ |
Extra e componenti aggiuntivi non vengono prenotati in Outbox. Extra e componenti aggiuntivi non vengono prenotati in Outbox. Vengono prenotati solo prodotto, opzione e unità principali. |
Redemption Sync | ❌ |
I riscatti e le altre modifiche di stato in Outbox non vengono rinviati a Ventrata dopo la conferma di una prenotazione. I riscatti e le altre modifiche di stato in Outbox non vengono rinviati a Ventrata dopo la conferma di una prenotazione. Non supportato. Lo stato della prenotazione in Outbox (ad esempio un biglietto scansionato) non viene comunicato a Ventrata. |
Pass Walkup Scanning Sync | ❌ |
La scansione dei pass walk-up non è disponibile con Outbox. La scansione dei pass walk-up non è disponibile con Outbox. |
Gift Card Sync | ❌ |
Le carte regalo Ventrata non vengono trasmesse a Outbox. Le carte regalo Ventrata non vengono trasmesse a Outbox. I pagamenti con carta regalo restano in Ventrata. |
✅ supportato · ❌ non supportato
Buono a sapersi: limiti e dettagli della connessione con Outbox
Buono a sapersi: limiti e dettagli della connessione con Outbox
Disponibilità in tempo reale: la disponibilità arriva da Outbox mentre gli utenti navigano.
Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in Outbox non arrivano a Ventrata.
API personalizzata: l'API di Outbox non è OCTO, quindi alcune funzionalità possono essere limitate rispetto ai backend OCTO.
Biglietti: ai tuoi clienti vengono emessi i codici QR e i biglietti PDF di Outbox.
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 l'API Key e l'API URL 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 Outbox. 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 Outbox. 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 l'API Key o l'API URL non sono corretti, oppure sono state usate credenziali di test con un URL di produzione (o viceversa). Verifica con il tuo operatore. Se il problema persiste, contatta l'assistenza.
Il prodotto/l'opzione/l'unità che voglio mappare non compare nel menu a tendina, oppure il menu a tendina è vuoto.
Il prodotto/l'opzione/l'unità che voglio mappare non compare nel menu a tendina, oppure il menu a tendina è vuoto.
Il menu a tendina viene recuperato da Outbox in base agli onsale assegnati alla tua API Key. Chiedi al tuo operatore di verificare con Outbox che l'inventario sia configurato per il tuo canale API nell'ambiente che stai usando (staging e produzione sono configurati separatamente). Se il problema persiste, contatta l'assistenza.
Prodotti, opzioni o unità compaiono come "Undefined" nei menu a tendina della mappatura.
Prodotti, opzioni o unità compaiono come "Undefined" nei menu a tendina della mappatura.
I nomi provengono dalla configurazione degli onsale dell'operatore in Outbox. Chiedi al tuo operatore di aggiungere in Outbox i titoli e le descrizioni dei tipi di prezzo.
La conferma della prenotazione non va a buon fine con il messaggio "Country code is required".
La conferma della prenotazione non va a buon fine con il messaggio "Country code is required".
Outbox richiede un paese per ogni ordine. Assicurati che il checkout, il modulo di prenotazione o la connessione rivenditore che vende questo prodotto raccolga il paese del cliente, quindi riprova.
I prezzi sono diversi da quelli previsti dall'operatore.
I prezzi sono diversi da quelli previsti dall'operatore.
Outbox restituisce prezzi comprensivi di imposte che includono i costi di servizio per il tuo canale. Verifica con il tuo operatore le tabelle dei prezzi e i costi di servizio del tuo canale API.
Per una data non viene mostrata nessuna fascia oraria.
Per una data non viene mostrata nessuna fascia oraria.
L'operatore non ha eventi o posti rilasciati per quella data in Outbox. Verifica con il tuo operatore.
Risorse utili
📚 Altro sulle connessioni Ventrata
Informazioni sul partner
Outbox Technology Inc.
3575 Boulevard Saint-Laurent, Suite 705
Montreal, QC H2X 2T7, Canada
Ventrata Partner ID: 01a06240-f33b-7362-b04f-35ed782cee0e