Vai al contenuto principale

Local Experiences: connessione rivenditore

Collega Local Experiences a Ventrata per sincronizzare disponibilità e prezzi e ricevere subito le prenotazioni.

Local Experiences logo

 

Local Experiences è un marketplace online con sede a Londra per tour e attività, che rivende l'inventario degli operatori senza gestire tour propri, offrendo passeggiate guidate, biglietti salta-fila ed esperienze brevi in città europee come Roma, Firenze, Venezia, Napoli, Parigi, Barcellona, Lisbona e Atene, oltre a Dubai. Agli operatori porta viaggiatori individuali e grandi gruppi che prenotano a prezzi accessibili in oltre 20 lingue dei tour, con acquisti regalo e prenotazioni di gruppo gestiti insieme ai biglietti standard.

 

Collegando Local Experiences a Ventrata, disponibilità e prezzi vengono sincronizzati e prenotazioni, modifiche e cancellazioni arrivano con i biglietti emessi automaticamente.

 

Per saperne di più su come collaborare con Local Experiences, visita localexperiences.tours.

 

Sito web principale

Tag

Travel Agent

Mercati di destinazione

🌎 Globale

Mercati di origine

🌎 Globale

Specialità

Grandi gruppi e acquisti regalo a prezzi accessibili

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

Local Experiences (tramite l'API OCTO di Ventrata)

 

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

  • Availability Sync – Local Experiences controlla la tua disponibilità in tempo reale in Ventrata.

  • Pricing Sync – Local Experiences ottiene i tuoi prezzi dai prezzi rivenditore in Ventrata.

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

 

Creare la connessione Local Experiences

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

Prima di iniziare:

  • Devi avere un accordo commerciale con Local Experiences perché il partner possa vendere i tuoi prodotti. Per informazioni su una partnership, contatta il partner tramite localexperiences.tours.

  • Devi aver creato Local Experiences come Reseller in Ventrata con i relativi prezzi (al pubblico, all'ingrosso/a commissione) definiti correttamente. Tieni presente che questa connessione API richiede che il rivenditore sia impostato sul metodo di regolamento "Bill to my account".

 

  1. Nella Ventrata Dashboard, vai su Connections → Connections, fai clic su + New Connection e seleziona Local Experiences dall'elenco dei partner.

  2. Seleziona Local Experiences Reseller dall'elenco dei tuoi rivenditori (deve essere creato prima della connessione). La connessione eredita la configurazione del rivenditore, ad esempio prezzi, destinazioni e prodotti consentiti.

  3. (Facoltativo) Puoi anche impostare un Name a tua scelta per la connessione, utile se prevedi di avere più connessioni Local Experiences e vuoi distinguerle più facilmente in futuro.

  4. Fai clic sul pulsante Create Octo Connection.

 

📗 SUGGERIMENTO

Se necessario, puoi anche consentire o non consentire prodotti o destinazioni a livello di connessione, oltre a quanto configurato sul rivenditore.

 

Mappare i prodotti su Local Experiences

Condividi in modo sicuro la chiave API OCTO mostrata sulla connessione che hai creato con il tuo referente Local Experiences e chiedigli di mappare i tuoi prodotti tramite l'API OCTO di Ventrata, con i prezzi (octo/pricing) abilitati. Di solito il team di Local Experiences impiega al massimo qualche giorno lavorativo per completare questa operazione.

 

La configurazione in Ventrata è completa. Non devi fare altro.

 

📗 SUGGERIMENTO

Local Experiences può accedere a tutti i prodotti abilitati sulla connessione, ma quando lo contatti puoi anche indicare gli ID di prodotto e opzione mostrati nella pagina della connessione per specificare cosa mappare.

 

 

Gestire la connessione Local Experiences

  • Consenti o escludi prodotti: limita le destinazioni, i prodotti e le opzioni a cui Local Experiences può accedere. Vedi come consentire o escludere prodotti.

  • Rinomina la connessione per distinguere più connessioni Local Experiences.

 

Funzionalità della connessione in dettaglio

Questa sezione è per chi vuole sapere esattamente come funziona la connessione Local Experiences: quali chiamate dell'API OCTO di Ventrata effettua Local Experiences, quando le effettua e cosa significa per te. Ogni chiamata rimanda alla documentazione API di Ventrata.

 

In breve: Local Experiences recupera da Ventrata tutto ciò che gli serve. Legge i tuoi prodotti, controlla disponibilità e prezzi e invia prenotazioni e cancellazioni. Ventrata non invia modifiche a Local Experiences, quindi qualsiasi cosa tu modifichi in Ventrata arriva a Local Experiences al controllo successivo.

 

Le tempistiche sono quelle tipiche di Local Experiences e sono arrotondate; possono cambiare se Local Experiences modifica il modo in cui si sincronizza.

 

Product Mapping

❌

Non puoi mappare i prodotti da Ventrata. Local Experiences li mappa dal suo lato, tramite il tuo account manager o il portale di Local Experiences.

Il funzionamento è il seguente:

  • Get Products (GET /products) – quando Local Experiences configura la connessione, e ogni volta che aggiorna le sue offerte, legge tutti i prodotti abilitati sulla connessione, con le relative opzioni e unità (tipi di biglietto come Adult o Child).

  • Get Product (GET /products/{productId}) – Local Experiences rilegge un singolo prodotto per recepire le modifiche a opzioni, unità, termini di prenotazione e impostazioni.

  • Mappatura dal lato di Local Experiences – Local Experiences collega ogni opzione e unità Ventrata alla propria offerta e ai propri tipi di biglietto. Se ne occupa il tuo account manager Local Experiences, oppure lo fai tu nel portale di Local Experiences, se disponibile. Tu condividi solo la chiave API della connessione.

 

Di solito con Local Experiences:

  • Local Experiences legge l'elenco completo dei tuoi prodotti circa una volta al giorno.

  • Rilegge ogni prodotto circa una volta al giorno.

 

Cosa significa per te: Local Experiences può vendere solo ciò che ha mappato. Quando aggiungi un prodotto, un'opzione o un'unità in Ventrata, Local Experiences potrebbe vederlo al successivo aggiornamento, ma non lo venderà finché non è mappato. Per questo avvisa il tuo account manager Local Experiences ogni volta che ne aggiungi uno.

Content Sync

✅ / ❌

Local Experiences può leggere da Ventrata i contenuti dei tuoi prodotti, come descrizioni e immagini.

Il funzionamento è il seguente:

  • Capability octo/content – quando Local Experiences la aggiunge all'header Octo-Capabilities, Get Products (GET /products) e Get Product (GET /products/{productId}) restituiscono anche i contenuti dei tuoi prodotti, come descrizioni, punti salienti, servizi inclusi e immagini.

  • Le modifiche ai contenuti in Ventrata arrivano a Local Experiences al successivo aggiornamento dei prodotti.

 

Di solito con Local Experiences:

  • Local Experiences richiede octo/content.

Availability Sync

✅

Local Experiences controlla la tua disponibilità in tempo reale in Ventrata. Ventrata non invia a Local Experiences le modifiche alla disponibilità.

Il funzionamento è il seguente:

  • Availability Check (POST /availability) – Local Experiences invia un prodotto, un'opzione e una data o un intervallo di date. Ventrata risponde con ogni giorno o fascia oraria prenotabile, il suo stato (AVAILABLE, LIMITED, SOLD_OUT, CLOSED o FREESALE), i posti rimanenti, il termine di prenotazione e un availabilityId, necessario a Local Experiences per prenotare quella fascia.

  • Availability Batch (POST /availability/batch) – disponibilità di molti prodotti in un'unica richiesta, pensata per le sincronizzazioni in background.

  • Controllo alla prenotazione – quando un cliente prenota, Ventrata ricontrolla la capienza prima di creare la prenotazione, quindi Local Experiences non può fare overbooking su una fascia appena esaurita, anche se la disponibilità che ha memorizzato è leggermente obsoleta.

 

Di solito con Local Experiences:

  • Availability Check: Local Experiences controlla i tuoi prodotti 24 ore su 24, di solito a partire da oggi e coprendo circa un anno per richiesta, guarda fino a circa un anno avanti e ricontrolla lo stesso prodotto e le stesse date circa ogni 2 ore.

  • Availability Batch: Local Experiences controlla i tuoi prodotti 24 ore su 24, di solito a partire da oggi e coprendo circa un anno per richiesta, guarda fino a circa un anno avanti e ricontrolla lo stesso prodotto e le stesse date circa ogni 20 minuti.

  • I controlli sono distribuiti uniformemente nell'arco delle 24 ore, il che indica una sincronizzazione pianificata in background anziché ricerche dei clienti in tempo reale.

 

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

Pricing Sync

✅

I tuoi prezzi vengono restituiti con ogni controllo della disponibilità, se Local Experiences li richiede con la capability octo/pricing.

Il funzionamento è il seguente:

  • Capability octo/pricing: Local Experiences richiede i prezzi aggiungendo octo/pricing all'header Octo-Capabilities delle sue richieste. Senza di essa, Ventrata invia la disponibilità senza alcun prezzo.

  • Availability Check (POST /availability) – con i prezzi attivi, ogni giorno o fascia oraria viene restituito con il tuo prezzo per unità (tipo di biglietto): il prezzo retail pagato dal cliente e il prezzo net che fatturi a Local Experiences, entrambi derivati dai prezzi del rivenditore in Ventrata (al pubblico e all'ingrosso/a commissione).

  • Prezzi di gruppo – quando Local Experiences invia anche quante persone di ciascun tipo di unità stanno prenotando, Ventrata calcola il prezzo esatto per quel gruppo. Questo è importante per le tariffe Booking Size e altri prezzi di gruppo.

  • Booking Reservation (POST /bookings) e Booking Confirmation (POST /bookings/{uuid}/confirm) – la prenotazione viene restituita con il prezzo al pubblico e il prezzo netto finali, quindi in Ventrata la prenotazione registra sempre il prezzo a cui è stata venduta.

 

Di solito con Local Experiences:

  • Local Experiences richiede octo/pricing in tutti i suoi controlli della disponibilità, quindi vende ai tuoi prezzi Ventrata.

  • Local Experiences non invia il numero di persone per tipo di unità, quindi i prezzi vengono restituiti per persona e i prezzi di gruppo, come le tariffe Booking Size, potrebbero non essere mostrati correttamente su Local Experiences.

 

‼️ IMPORTANTE – Chiedi di abilitare i prezzi. Quando chiedi a Local Experiences di mappare i tuoi prodotti, chiedi anche di abilitare i prezzi (octo/pricing), oppure attivali tu se esegui la mappatura nel portale di Local Experiences. Altrimenti potrebbero essere disattivati e Local Experiences non riceverà i tuoi prezzi Ventrata.

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

Promotions Sync

❌

Le tue promozioni Ventrata non si applicano su Local Experiences.

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

Bookings Sync

✅

Le prenotazioni e le cancellazioni effettuate su Local Experiences 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 Local Experiences, Local Experiences invia il prodotto, l'opzione, la fascia scelta (availabilityId) e un elemento unità per persona. Ventrata ricontrolla la capienza e crea una prenotazione ON_HOLD, che trattiene i posti mentre il cliente paga. Se non c'è più posto, Ventrata rifiuta il blocco.

  2. Conferma: Booking Confirmation (POST /bookings/{uuid}/confirm) – quando il pagamento va a buon fine, Local Experiences conferma il blocco. 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. Local Experiences li consegna al cliente, che li mostra al tuo ingresso come qualsiasi biglietto Ventrata.

  3. Scadenza: se il cliente non completa il pagamento, Local Experiences non conferma mai e il blocco scade automaticamente, liberando i posti.

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

  5. Modifica: Booking Update (PATCH /bookings/{uuid}) – permette a Local Experiences di modificare una prenotazione direttamente, ad esempio con una nuova data, un nuovo orario o un diverso numero di persone. Alcuni rivenditori invece cancellano e prenotano di nuovo.

 

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

Pickups/Dropoff Sync

❌

Local Experiences non invia i dettagli di pick-up o drop-off con le sue prenotazioni.

Se i tuoi prodotti includono pick-up, verifica con Local Experiences come raccoglie i dettagli di pick-up, oppure concordali con il cliente.

Custom Questions Sync

❌

Local Experiences non invia le risposte alle tue domande sulla prenotazione.

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

Extras Sync

❌

Extra e servizi aggiuntivi non si possono prenotare tramite Local Experiences.

Su Local Experiences 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 Local Experiences.

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

Pass Walkup Scanning Sync

❌

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

I clienti di Local Experiences hanno bisogno di una prenotazione effettuata tramite Local Experiences prima della visita.

Gift Card Sync

❌

Le carte regalo Ventrata non si possono vendere né riscattare tramite Local Experiences.

Le carte regalo acquistate in Ventrata non si possono usare su Local Experiences e Local Experiences non può vendere carte regalo Ventrata.

✅ supportato · ✅ / ❌ limitato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione Local Experiences

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

  • Termine di cancellazione: Local Experiences può cancellare tramite API solo prima del termine di cancellazione della tua opzione. Le cancellazioni successive devono essere concordate con te.

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

  • Biglietti: Local Experiences emette i biglietti o il voucher Ventrata ricevuti alla conferma, quindi scansione e riscatto funzionano come sempre.

  • Prenotazioni di test: Local Experiences può inviare prenotazioni di test durante la configurazione della 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 Local Experiences.

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

LOCAL EXPERIENCES LTD

20 Wenlock Road, London, England, N1 7GU

United Kingdom

 

Ventrata Partner ID: e79dc9d6-619e-4dc9-a995-09295960c72b

Hai ricevuto la risposta alla tua domanda?