Vai al contenuto principale

ExperienceBank: backend operatore

Collega ExperienceBank a Ventrata per rivendere i prodotti degli operatori ExperienceBank con disponibilità, prezzi e prenotazioni in tempo reale.

ExperienceBank logo

 

ExperienceBank è un channel manager svizzero gestito da TrekkSoft AG che collega i fornitori di esperienze e le loro piattaforme di prenotazione a oltre 30 agenzie di viaggio online (OTA) in tutto il mondo tramite un'unica API, con aggiornamenti dell'inventario per evitare doppie prenotazioni. I suoi clienti sono fornitori di tour e attività e le piattaforme di prenotazione al loro servizio, per circa 20.000 attività, e offre alle OTA un'unica connessione a quell'offerta con integrazioni monitorate e supportate.

 

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

 

Per saperne di più su ExperienceBank, visita experiencebank.travel.

 

Sito web principale

Tag

Booking / Ticketing System · Third-Party Booking System Channel Manager

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

Ventrata (tramite ExperienceBank API)

 

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

  • Availability Sync – la disponibilità in tempo reale proviene dall'account ExperienceBank dell'operatore.

  • Pricing Sync – i prezzi arrivano da ExperienceBank, oppure li imposti tu in Ventrata.

  • Bookings Sync – le prenotazioni vengono inviate da Ventrata a ExperienceBank e ExperienceBank emette i biglietti o i voucher.

 

L'API esterna di ExperienceBank 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 ExperienceBank

🔐 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 Public Key di ExperienceBank e la Secret Key di ExperienceBank dell'operatore. Segui i passaggi qui sotto.

  • Sei presente come Marketplace su ExperienceBank.

  • L'operatore ha abilitato la connessione e ha condiviso con te le attività.

  • 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 come Marketplace su ExperienceBank

Per usare questa integrazione devi essere presente come Marketplace su ExperienceBank. Per chiedere di essere inserito, contatta il team di ExperienceBank tramite il modulo per i partner di distribuzione e indica che usi Ventrata come sistema di biglietteria principale.

 

Passaggio 2: ricevi le tue chiavi

Una volta inserito, ExperienceBank ti fornisce la Public Key di ExperienceBank (inizia con pub_) e la Secret Key di ExperienceBank (inizia con sec_).

 

Passaggio 3: chiedi al tuo operatore di abilitare la connessione

Contatta il tuo operatore e chiedigli di abilitare la connessione e condividere con te i prodotti (attività). Lo fa nel proprio account ExperienceBank in Marketplaces: seleziona il riquadro con la scheda del tuo marketplace, poi usa i pulsanti Enable e Share Activities.

 

Passaggio 4: configura l'operatore in Ventrata

Dopo che sei stato inserito come Marketplace su ExperienceBank, il team di ExperienceBank ti fornisce la Public Key (inizia con pub_) e la Secret Key (inizia con sec_).

 

  1. Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.

  2. Nella sezione Backend Partner, seleziona ExperienceBank e inserisci la Public Key di ExperienceBank e la Secret Key di ExperienceBank.

  3. Nel campo ExperienceBank Supplier, seleziona il tuo operatore dall'elenco degli operatori che hanno abilitato la connessione con te.

  4. Press Update Operator.

 

 

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

 

Passaggio 5: collega ogni prodotto

  1. Apri il prodotto dell'operatore in Products → Products e modificalo. Verifica che Operator sia impostato su questo operatore.

  2. Seleziona Backend Connected. Seleziona Backend Availability per usare la disponibilità di ExperienceBank e Backend Pricing per usare i prezzi di ExperienceBank.

  3. Press Update Product.

📒 NOTA

ExperienceBank invia sia i prezzi al pubblico sia i prezzi netti. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico come tuo prezzo di vendita e il prezzo netto come tuo prezzo di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

 

Seleziona Backend Connected per usare la connessione API. Per recuperare la disponibilità da ExperienceBank, lascia selezionato Backend Availability; per recuperare i prezzi, seleziona Backend Pricing.

 

Se Backend Availability o Backend Pricing non sono selezionati, il prodotto usa la disponibilità e i prezzi configurati in Ventrata, ma invia comunque le prenotazioni a ExperienceBank.

 

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 ExperienceBank. Assicurati che nessun campo resti vuoto (non mappato) e fai clic su Save Changes.

 

Mappare i prodotti su ExperienceBank

‼️ IMPORTANTE

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

 

  1. Nella Ventrata Dashboard, vai su Products → Products e apri il prodotto.

  2. Apri la scheda Mappings. Compare dopo che il prodotto è stato impostato come Backend Connected.

  3. Per ogni opzione e unità Ventrata, seleziona dai menu a tendina, che Ventrata carica da ExperienceBank, il prodotto, l'opzione e le unità corrispondenti di ExperienceBank. Non lasciare nessun campo vuoto.

  4. Press Save Changes.

 

📗 SUGGERIMENTO

Dopo la mappatura effettua una prenotazione di test e chiedi all'operatore di confermare che sia arrivata nel suo account ExperienceBank.

 

Gestire la connessione con ExperienceBank

  • Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in ExperienceBank.

  • Sostituisci la chiave sull'operatore se ExperienceBank 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 ExperienceBank.

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

✅

Mappi ogni prodotto, opzione e unità Ventrata al prodotto ExperienceBank dell'operatore nella Ventrata Dashboard.

Il funzionamento è il seguente:

  • Prodotti – Ventrata legge prodotti, opzioni e unità dell'operatore in ExperienceBank per popolare i menu a tendina della scheda Mappings.

  • Percorsi rilevati: POST /v1.

 

Cosa significa per te: se qualcosa manca nel menu a tendina, l'operatore non te l'ha reso disponibile in ExperienceBank. Chiedigli di farlo.

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da ExperienceBank.

Ventrata non importa i contenuti dei prodotti da ExperienceBank. 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 ExperienceBank.

Il funzionamento è il seguente:

  • Disponibilità – quando qualcuno usa il calendario della disponibilità in Ventrata, ad esempio nella Dashboard, nel tuo web checkout o su un terminale, Ventrata interroga ExperienceBank in tempo reale per le date visualizzate.

  • Richiesta in tempo reale a ExperienceBank quando un utente interagisce con il calendario della disponibilità (date e unità nella dashboard, nel web checkout, sul terminale e così via), di solito per intervalli di 7 giorni o per un giorno specifico. Prima che l'utente interagisca, il calendario può mostrare dati in cache (non in tempo reale) della richiesta precedente. Usa EB Activities List ed EB Availabilities List.

  • Percorsi rilevati: POST /v1.

 

Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in ExperienceBank, 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 ExperienceBank.

Il funzionamento è il seguente:

  • Da ExperienceBank vengono recuperati solo i prezzi al pubblico, insieme alla disponibilità, nella stessa richiesta in tempo reale. I prezzi vengono mostrati all'utente e memorizzati in cache o salvati in Ventrata come tariffe generate dall'API. I prezzi netti (all'ingrosso)/di costo vengono calcolati dalla tariffa al pubblico ricevuta e dalle impostazioni di costo/percentuale di costo che imposti in Ventrata.

  • Con Backend Pricing disattivato, il prodotto usa i prezzi che imposti in Ventrata e le prenotazioni vengono comunque inviate a ExperienceBank.

ExperienceBank invia sia i prezzi al pubblico sia i prezzi netti. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico come tuo prezzo di vendita e il prezzo netto come tuo prezzo di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

Promotions Sync

❌

Le promozioni non vengono inviate a ExperienceBank.

Le promozioni non vengono inviate a ExperienceBank. 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 ExperienceBank dell'operatore.

Il funzionamento è il seguente:

  1. Blocco e conferma: quando il prodotto viene aggiunto al carrello, Ventrata verifica la prenotazione con ExperienceBank e, dopo il pagamento, crea la prenotazione nell'account ExperienceBank dell'operatore con i dati del cliente.

  2. Biglietti: il riferimento o i biglietti restituiti da ExperienceBank vengono salvati nella prenotazione Ventrata.

  3. Chiamate rilevate: Cancel Booking, Confirm Booking, Create Booking, Get Booking.

Prenotazioni, modifiche e cancellazioni effettuate in Ventrata vengono inviate a ExperienceBank. Il blocco avviene quando un prodotto viene aggiunto al carrello (EB Create Booking). La conferma avviene dopo il pagamento (EB Commit Booking), con l'invio in quel momento dei dati di contatto del cliente; il voucher/biglietto di ExperienceBank viene acquisito come voucher/biglietto in Ventrata, tranne PDF_FILE, che Ventrata non supporta. La modifica di una prenotazione crea e conferma una nuova prenotazione e poi cancella quella precedente, perché ExperienceBank non supporta la modifica diretta di una prenotazione. La cancellazione invia EB Cancel Booking.

 

‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a ExperienceBank. Se l'operatore modifica o cancella una prenotazione in ExperienceBank, 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 ExperienceBank.

I dettagli di pickup e drop-off non vengono trasmessi a ExperienceBank. 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 ExperienceBank.

Le risposte alle tue domande di prenotazione non vengono trasmesse a ExperienceBank. Se l'operatore ne ha bisogno, comunicagliele in un altro modo.

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in ExperienceBank.

Extra e componenti aggiuntivi non vengono prenotati in ExperienceBank. Vengono prenotati solo prodotto, opzione e unità principali.

Redemption Sync

❌

I riscatti e le altre modifiche di stato in ExperienceBank non vengono rinviati a Ventrata dopo la conferma di una prenotazione.

I riscatti e le altre modifiche di stato in ExperienceBank non vengono rinviati a Ventrata dopo la conferma di una prenotazione.

Non supportato. Lo stato della prenotazione in ExperienceBank (ad esempio Redeemed) non viene inviato a Ventrata dopo la conferma della prenotazione.

Pass Walkup Scanning Sync

❌

La scansione dei pass walk-up non è disponibile con ExperienceBank.

La scansione dei pass walk-up non è disponibile con ExperienceBank.

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a ExperienceBank.

Le carte regalo Ventrata non vengono trasmesse a ExperienceBank. I pagamenti con carta regalo restano in Ventrata.

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con ExperienceBank

  • Disponibilità in tempo reale: la disponibilità arriva da ExperienceBank mentre gli utenti navigano.

  • Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in ExperienceBank non arrivano a Ventrata.

  • API personalizzata: l'API di ExperienceBank non è OCTO, quindi alcune funzionalità possono essere limitate rispetto ai backend OCTO.

  • Riceve voucher/biglietti dal sistema ExperienceBank dell'operatore e li emette ai tuoi clienti.

  • ExperienceBank fa parte del Gruppo TrekkSoft; è un software di channel management con connettività API per sistemi come TrekkSoft, Digitickets, Giant Monkey (go~mus) e Waldhart Software, oltre a diversi sistemi di terzi.

 

FAQ

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

Molto probabilmente la Public Key di ExperienceBank e la Secret Key di ExperienceBank 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.

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 elencano ciò che l'operatore ti ha reso disponibile in ExperienceBank. 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.

Controlla prima la mappatura del prodotto: ogni opzione e unità deve essere mappata. Poi verifica che la fascia oraria sia ancora disponibile in ExperienceBank. Se il problema persiste, contatta il nostro supporto tecnico.

Errore durante l'aggiornamento dell'operatore per salvare la configurazione del backend.

Probabilmente la Public Key di ExperienceBank, la Secret Key di ExperienceBank o il ExperienceBank Supplier non sono validi. Ricontrollali con il tuo operatore. Se il problema persiste, contatta l'assistenza.

Il fornitore/il prodotto/l'opzione/l'unità che voglio mappare non è nel menu a tendina.

Il menu a tendina viene caricato da ExperienceBank in base ai fornitori, ai prodotti, alle opzioni e alle unità che ti sono stati resi disponibili. Ricontrolla con il tuo operatore e con ExperienceBank. Se il problema persiste, contatta l'assistenza.

 

Risorse utili

 

 

Informazioni sul partner

TrekkSoft AG

Hauptstrasse 15

3800 Matten bei Interlaken, Switzerland

 

Ventrata Partner ID: e4004a52-68c4-438e-910d-7a90491216ae

Hai ricevuto la risposta alla tua domanda?