Vai al contenuto principale

Tootbus: connessione rivenditore

Collega Tootbus a Ventrata per sincronizzare disponibilità e prezzi e ricevere subito le prenotazioni. Pacchetti di attrazioni per chi visita una città per la prima volta.

Tootbus logo powered by Ventrata icon Ventrata

 

Tootbus è il marchio di tour turistici di RATP Dev, con percorsi hop-on hop-off su autobus scoperti a basse emissioni a Parigi, Londra, Bruxelles, Barcellona, Madrid, Roma e in Toscana. Combina attrazioni partner, crociere fluviali e tour a piedi in pacchetti Discovery e combo di attrazioni, insieme ai propri pass da uno a tre giorni. Agli operatori porta visitatori alla prima visita in città all'inizio del soggiorno, che acquistano un pass per l'autobus e aggiungono prodotti di terzi dallo stesso carrello; i mercati principali sono i city break francesi, britannici e belgi.

 

Connettere Tootbus a Ventrata sincronizza disponibilità e prezzi e consegna prenotazioni, modifiche e cancellazioni con biglietti emessi automaticamente. Tootbus usa Ventrata come sistema di biglietteria principale.

 

Per saperne di più su come collaborare con Tootbus, visita tootbus.com.

 

Sito web principale

Tag

Operator Reselling Others · Sightseeing & Hop-On Hop-Off · Ventrata Client

Mercati di destinazione

🇧🇪 Belgio · 🇫🇷 Francia · 🇬🇧 Regno Unito

Mercati di origine

🌎 Globale

Specialità

Pacchetti di attrazioni per chi visita la città per la prima volta

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

GMV prenotato tramite Ventrata (ultimi 12 mesi)

US$100k+

Sviluppato da

Ventrata (tramite l'API OCTO di Ventrata)

 

Questa connessione rivenditore ti permette di vendere i tuoi prodotti tramite Tootbus senza gestire manualmente disponibilità, prezzi e prenotazioni. Le funzionalità di questa connessione includono:

  • Availability Sync – Tootbus verifica in Ventrata la tua disponibilità in tempo reale.

  • Pricing Sync – Tootbus riceve i tuoi prezzi dalla configurazione prezzi del rivenditore in Ventrata.

  • Bookings Sync – prenotazioni, modifiche e cancellazioni provenienti da Tootbus vengono create istantaneamente in Ventrata e i clienti ricevono biglietti Ventrata.

 

Creare la connessione con Tootbus

🔐 Autorizzazioni di ruolo richieste: See Connections, Modify Connections, See Connection Key

 

Prima di iniziare:

  • Hai un accordo commerciale con Tootbus per la vendita dei tuoi prodotti.

  • Per Tootbus è stato creato un Reseller in Ventrata, con prezzi al pubblico e prezzi all'ingrosso/a commissione configurati.

 

Tootbus funziona su Ventrata, quindi si tratta di una connessione da Ventrata a Ventrata. Crei una Ventrata Reseller Connection per Tootbus e condividi in modo sicuro la relativa chiave API. Tootbus si connette e mappa i tuoi prodotti nel proprio account Ventrata.

 

  1. Nella Ventrata Dashboard, vai su Connections > Connections, premi + New Connection e cerca Ventrata Reseller Connection.

  2. Seleziona Tootbus come rivenditore. Se necessario, consenti o escludi destinazioni e prodotti sulla connessione, quindi premi Create Connection.

  3. Premi l'icona a forma di occhio per mostrare la chiave API, copiala e condividila in modo sicuro con il tuo referente di Tootbus.

  4. Tootbus ti aggiunge come operatore con Ventrata (Operator Backend) come backend, poi connette e mappa ogni prodotto. Chiedigli di effettuare una prenotazione di test e verifica che compaia nella tua tabella delle prenotazioni.

 

📗 SUGGERIMENTO

Per tutti i passaggi con screenshot, vedi Ventrata: connessione rivenditore. Tootbus segue Ventrata: backend operatore.

 

Gestire la connessione con Tootbus

  • Consenti o non consentire prodotti: limita le destinazioni, i prodotti e le opzioni a cui Tootbus può accedere. Scopri come consentire o non consentire prodotti.

  • Rinomina la connessione per distinguere più connessioni con Tootbus.

 

Funzionalità della connessione in dettaglio

Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Tootbus: quali chiamate all'API OCTO di Ventrata effettua Tootbus (tramite l'integrazione certificata di Ventrata), quando le effettua e cosa significa per te. Ogni chiamata rimanda alla documentazione API di Ventrata.

 

In breve: Tootbus recupera da Ventrata tutto ciò che gli serve. Legge i tuoi prodotti, verifica la tua disponibilità e i tuoi prezzi e invia prenotazioni e cancellazioni. Ventrata non invia modifiche a Tootbus, quindi ciò che modifichi in Ventrata arriva a Tootbus alla sua verifica successiva.

 

Le tempistiche sono quelle tipiche di Tootbus e arrotondate, e possono cambiare se Tootbus modifica il proprio modo di sincronizzare.

 

Product Mapping

✅

Tootbus mappa i tuoi prodotti sui propri nel suo account Ventrata.

Su ogni prodotto connesso al backend, Tootbus sceglie dal tuo account il prodotto, l'opzione e le unità corrispondenti nella scheda Mappings del prodotto. I prodotti non mappati correttamente sono evidenziati in rosso e le relative prenotazioni non vanno a buon fine. Vedi Ventrata: backend operatore.

Content Sync

❌

Tootbus non legge i contenuti dei tuoi prodotti da Ventrata.

Tootbus usa le descrizioni, le immagini e gli altri contenuti configurati dal proprio lato, quindi aggiorna i tuoi contenuti direttamente con Tootbus.

Availability Sync

✅

Tootbus verifica in Ventrata la tua disponibilità in tempo reale. Ventrata non invia a Tootbus le modifiche di disponibilità.

Il funzionamento è il seguente:

  • Availability Check (POST /availability) – Tootbus invia un prodotto, un'opzione e una data o un intervallo di date. Ventrata risponde con ogni giorno o fascia oraria prenotabile, il relativo stato (AVAILABLE, LIMITED, SOLD_OUT, CLOSED o FREESALE), i posti rimanenti, il limite di prenotazione e un availabilityId, che Tootbus deve usare per prenotare quella fascia.

  • Availability Calendar (POST /availability/calendar) – restituisce un riepilogo per giorno anziché ogni singola fascia oraria, di solito per mostrare quali date sono aperte in un selettore di date.

  • Verifica al momento della prenotazione – quando un cliente prenota, Ventrata ricontrolla la capacità prima di creare la prenotazione, quindi Tootbus non può fare overbooking su una fascia appena esaurita, anche se la disponibilità che ha memorizzato è leggermente obsoleta.

 

Di solito con Tootbus:

  • Availability Check: Tootbus controlla i tuoi prodotti durante tutta la giornata, di solito a partire da 28 giorni da oggi e coprendo 7 giorni per richiesta, guarda fino a circa un anno avanti e ricontrolla lo stesso prodotto e le stesse date circa ogni 40 minuti.

  • Availability Calendar: Tootbus controlla i tuoi prodotti durante tutta la giornata, di solito a partire da oggi e coprendo un solo giorno per richiesta, guarda fino a circa 6 mesi avanti e ricontrolla lo stesso prodotto e le stesse date circa ogni 2 ore.

  • Le verifiche sono distribuite nell'arco della giornata senza picchi marcati, il che fa pensare a un mix di sincronizzazioni programmate e ricerche dei clienti in tempo reale.

 

Cosa significa per te: quando chiudi una data, modifichi la capienza o esaurisci i posti in Ventrata, Tootbus lo mostra dopo il controllo successivo. Per le date che controlla regolarmente, ciò avviene entro circa 40 minuti. Le date più lontane vengono di solito controllate meno spesso.

Pricing Sync

✅

I tuoi prezzi vengono restituiti con ogni verifica della disponibilità, una volta che Tootbus li richiede con la capability octo/pricing.

Il funzionamento è il seguente:

 

Di solito con Tootbus:

 

📗 SUGGERIMENTO – Se i prezzi su Tootbus sembrano errati, controlla prima i prezzi del rivenditore Tootbus in Ventrata: sono quelli che Tootbus legge.

Tootbus può usare i tuoi prezzi con Backend Pricing sul suo prodotto oppure impostare prezzi propri nel suo account.

Promotions Sync

❌

Le tue promozioni Ventrata non si applicano su Tootbus.

I prezzi su Tootbus non includono le promozioni che crei in Ventrata. Configura eventuali promozioni direttamente con Tootbus.

Bookings Sync

✅

Le prenotazioni e le cancellazioni effettuate su Tootbus vengono create istantaneamente in Ventrata e i clienti ricevono biglietti Ventrata.

Il funzionamento è il seguente:

  1. Blocco: Booking Reservation (POST /bookings) – quando un cliente avvia il checkout su Tootbus, Tootbus invia il prodotto, l'opzione, la fascia scelta (availabilityId) e un'unità per ogni persona. Ventrata ricontrolla la capacità e crea una prenotazione ON_HOLD, che blocca i posti mentre il cliente paga. Se non c'è più posto, Ventrata rifiuta il blocco.

  2. Conferma: Booking Confirmation (POST /bookings/{uuid}/confirm) – una volta completato il pagamento, Tootbus conferma il blocco, con il proprio riferimento di prenotazione e i dati di contatto del cliente. La prenotazione diventa CONFIRMED in Ventrata e Ventrata restituisce il tuo riferimento di prenotazione e i biglietti (uno per persona) o un voucher (uno per prenotazione), a seconda di come è configurato il prodotto, ciascuno con un codice QR e un link al PDF. Tootbus li consegna al cliente, che li mostra al tuo ingresso come qualsiasi biglietto Ventrata.

  3. Scadenza: se il cliente non completa il pagamento, Tootbus non conferma mai e il blocco scade da solo, liberando i posti.

  4. Cancellazione: Booking Cancellation (POST /bookings/{uuid}/cancel) – quando un cliente cancella su Tootbus, Tootbus cancella la prenotazione in Ventrata. Ventrata accetta solo se la prenotazione è ancora cancellabile e il limite di cancellazione dell'opzione non è stato superato. Altrimenti rifiuta la richiesta e Tootbus deve contattarti.

  5. Modifica: Tootbus non usa Booking Update (PATCH /bookings/{uuid}), quindi una modifica arriva molto probabilmente in Ventrata come una cancellazione più una nuova prenotazione.

 

Di solito con Tootbus:

  • Tootbus non imposta un tempo di blocco, quindi si applica il tempo di blocco predefinito.

  • Una prenotazione tipica su Tootbus è per circa 2 persone.

  • È normale vedere più blocchi che prenotazioni confermate: i blocchi dei clienti che non completano il pagamento semplicemente scadono.

  • Tootbus controlla anche le prenotazioni che ha effettuato, con Get Booking (GET /bookings/{uuid}), circa ogni 30 minuti, ad esempio per riconciliare i propri dati.

 

‼️ IMPORTANTE – Le prenotazioni si sincronizzano in un'unica direzione, da Tootbus a Ventrata. Se cancelli, modifichi o riprenoti in Ventrata una prenotazione proveniente da Tootbus, ad esempio nella Dashboard, Tootbus non riceve alcuna notifica. Contatta Tootbus affinché la prenotazione venga cancellata o modificata anche dal suo lato, oppure chiedi al cliente di cancellare tramite Tootbus.

Pickups/Dropoff Sync

❌

Tootbus non invia i dettagli di pickup o drop-off con le sue prenotazioni.

Se i tuoi prodotti includono pickup, verifica con Tootbus come raccoglie i dettagli del pickup, oppure accordati direttamente con il cliente.

Custom Questions Sync

❌

Tootbus non invia le risposte alle tue domande di prenotazione.

Se ti servono le domande di prenotazione, ad esempio nomi o esigenze alimentari, verifica con Tootbus come raccoglie queste informazioni.

Extras Sync

❌

Extra e add-on non possono essere prenotati tramite Tootbus.

Su Tootbus i clienti possono prenotare solo i tuoi prodotti e le tue opzioni principali. Vendi gli extra separatamente, ad esempio all'arrivo.

Redemption Sync

❌

I riscatti non vengono comunicati a Tootbus.

Ventrata non avvisa Tootbus quando un biglietto viene scansionato o riscattato. Tootbus vede un riscatto solo se rilegge la prenotazione da Ventrata.

Pass Walkup Scanning Sync

❌

I titolari di pass di Tootbus non possono essere scansionati al tuo ingresso senza una prenotazione.

I clienti provenienti da Tootbus devono avere una prenotazione effettuata tramite Tootbus prima della visita.

Gift Card Sync

❌

Le gift card Ventrata non possono essere vendute né riscattate tramite Tootbus.

Le gift card acquistate in Ventrata non possono essere usate su Tootbus e Tootbus non può vendere gift card Ventrata.

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Tootbus

  • Ritardi: disponibilità e prezzi arrivano a Tootbus solo quando effettua una verifica, quindi c'è sempre un breve ritardo dopo una modifica in Ventrata.

  • Limite di cancellazione: Tootbus può cancellare tramite API solo prima del limite di cancellazione della tua opzione. Le cancellazioni successive devono essere concordate con te.

  • Cosa può vedere Tootbus: solo le destinazioni, i prodotti e le opzioni consentiti sul rivenditore e sulla connessione e abilitati alla vendita sulla fonte Direct API. Scopri come consentire o non consentire prodotti.

  • Biglietti: Tootbus emette i biglietti o il voucher Ventrata che riceve alla conferma, quindi scansione e riscatto funzionano come di consueto.

  • Prenotazioni di test: Tootbus può inviare prenotazioni di test mentre configura la connessione. Le prenotazioni di test non consumano la tua disponibilità e non vengono fatturate.

 

FAQ

Nella pagina della connessione non viene mostrato alcun prodotto.

Verifica quali destinazioni, prodotti e opzioni sono consentiti sul tuo rivenditore e sulla connessione. Poi conferma che i tuoi prodotti e le tue opzioni siano abilitati alla vendita sulla fonte Direct API. Se il problema persiste, contatta il nostro supporto tecnico.

I miei prodotti Ventrata usano tariffe Booking Size e i prezzi non funzionano correttamente su Tootbus.

Dopo ogni modifica di tariffa, aggiorna la mappatura del prodotto per assicurarti che i conteggi per fascia del partner siano sincronizzati con Ventrata. Assicurati che la tariffa sia abilitata alla vendita tramite Direct API.

 

 

Informazioni sul partner

RATP Development SA

9 Rue Brahms

75012 Paris, France

 

Ventrata Partner ID: b3f1d7b2-1cca-481a-af23-5c56d6103277

 

Ventrata Ltd

55 Baker Street

London, W1U 7EU, United Kingdom

 

Ventrata Partner ID: a6a2a406-088a-4466-b87c-7fcc17770b71

Hai ricevuto la risposta alla tua domanda?