Vai al contenuto principale

City Sightseeing Worldwide: connessione rivenditore

Collega City Sightseeing Worldwide a Ventrata per sincronizzare disponibilità e prezzi e ricevere subito le prenotazioni. Vende tour in bus hop-on hop-off.

City Sightseeing Worldwide logo powered by Prioticket icon Prioticket

 

City Sightseeing Worldwide è il marchio globale di autobus scoperti hop-on hop-off, con franchisee locali che gestiscono percorsi e attrazioni in oltre 100 città in Europa, nelle Americhe, in Medio Oriente e altrove. Prenotazione online centralizzata, voucher validi dodici mesi, cancellazione gratuita e commento nella lingua del visitatore fanno capo a un unico marchio consumer. Agli operatori porta domanda turistica da visitatori internazionali in città che prenotano un tour in autobus e aggiungono attrazioni e tour nella stessa destinazione, con i bambini che viaggiano gratis in molte città.

 

Collegare City Sightseeing Worldwide a Ventrata sincronizza disponibilità e prezzi e trasmette prenotazioni, modifiche e cancellazioni, con biglietti emessi automaticamente. City Sightseeing Worldwide utilizza Prioticket e riceve i tuoi prodotti tramite la sua integrazione certificata con l'API OCTO di Ventrata.

 

Per saperne di più su come collaborare con City Sightseeing Worldwide, visita city-sightseeing.com.

 

Sito web principale

Tag

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

Mercati di destinazione

🌎 Globale

Mercati di origine

🌎 Globale

Specialità

Tour in bus scoperto hop-on hop-off e combo con attrazioni

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

GMV prenotato tramite Ventrata (ultimi 12 mesi)

US$1M+

Fornitori con prenotazioni tramite Ventrata (ultimi 12 mesi)

10+

Sviluppato da

Prioticket (tramite l'API OCTO di Ventrata)

 

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

  • Availability Sync – City Sightseeing Worldwide verifica in Ventrata la tua disponibilità in tempo reale.

  • Pricing Sync – City Sightseeing Worldwide riceve i tuoi prezzi dalla configurazione prezzi del rivenditore in Ventrata.

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

 

Creare la connessione con City Sightseeing Worldwide

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

Prima di iniziare:

  • Devi avere un accordo commerciale con City Sightseeing Worldwide perché il partner possa vendere i tuoi prodotti. Per informazioni su una partnership, contatta il partner tramite city-sightseeing.com.

  • Devi avere City Sightseeing Worldwide creato come Reseller in Ventrata, con i relativi prezzi (al pubblico, all'ingrosso/commissioni) 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 City Sightseeing Worldwide (powered by Prioticket) dall'elenco dei partner.

  2. Seleziona il rivenditore City Sightseeing Worldwide dall'elenco dei tuoi rivenditori (deve essere creato prima di creare una connessione). La connessione erediterà la configurazione del rivenditore, come prezzi, destinazioni consentite, prodotti e così via.

  3. (Facoltativo) Puoi anche impostare un Name a tua scelta per la connessione: può essere utile se prevedi di avere più connessioni con City Sightseeing Worldwide 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 City Sightseeing Worldwide

Condividi in modo sicuro la chiave API OCTO mostrata sulla connessione che hai creato con il tuo referente di City Sightseeing Worldwide e chiedigli di mappare i tuoi prodotti tramite l'API OCTO di Ventrata, con i prezzi (octo/pricing) abilitati. Di solito il team di City Sightseeing Worldwide completa l'operazione in pochi giorni lavorativi.

 

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

 

📗 SUGGERIMENTO

City Sightseeing Worldwide 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 con City Sightseeing Worldwide

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

  • Rinomina la connessione per distinguere più connessioni con City Sightseeing Worldwide.

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

❌

Non puoi mappare i prodotti da Ventrata. City Sightseeing Worldwide li mappa dal proprio lato, tramite il tuo account manager o il portale di City Sightseeing Worldwide.

Il funzionamento è il seguente:

  • Get Products (GET /products) – quando City Sightseeing Worldwide configura la tua connessione, e ogni volta che aggiorna le sue inserzioni, legge tutti i prodotti abilitati sulla connessione, con le relative opzioni e unità (tipi di biglietto come Adulto o Bambino).

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

  • Mappatura dal lato di City Sightseeing Worldwide – City Sightseeing Worldwide collega ogni opzione e unità Ventrata alle proprie inserzioni e ai propri tipi di biglietto. Se ne occupa il tuo account manager di City Sightseeing Worldwide, oppure lo fai tu nel portale di City Sightseeing Worldwide, se disponibile. Devi solo condividere la chiave API della connessione.

 

Di solito con City Sightseeing Worldwide:

  • City Sightseeing Worldwide legge l'elenco completo dei tuoi prodotti circa ogni 11 ore.

  • Rilegge ogni prodotto circa ogni 9 ore.

 

Cosa significa per te: City Sightseeing Worldwide può vendere solo ciò che ha mappato. Quando aggiungi un prodotto, un'opzione o un'unità in Ventrata, City Sightseeing Worldwide potrebbe vederlo al successivo aggiornamento, ma non lo venderà finché non sarà mappato. Avvisa quindi il tuo account manager di City Sightseeing Worldwide ogni volta che ne aggiungi uno.

Content Sync

✅ / ❌

City Sightseeing Worldwide può leggere da Ventrata i contenuti dei tuoi prodotti, come descrizioni e immagini.

Il funzionamento è il seguente:

  • Capability octo/content – quando City Sightseeing Worldwide 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, inclusioni e immagini.

  • Le modifiche ai contenuti in Ventrata arrivano a City Sightseeing Worldwide al successivo aggiornamento dei prodotti.

 

Di solito con City Sightseeing Worldwide:

  • City Sightseeing Worldwide richiede octo/content.

Availability Sync

✅

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

Il funzionamento è il seguente:

  • Availability Check (POST /availability) – City Sightseeing Worldwide 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 City Sightseeing Worldwide 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 City Sightseeing Worldwide non può fare overbooking su una fascia appena esaurita, anche se la disponibilità che ha memorizzato è leggermente obsoleta.

 

Di solito con City Sightseeing Worldwide:

  • Availability Check: City Sightseeing Worldwide controlla i tuoi prodotti durante tutta la giornata, di solito a partire da 10 giorni da oggi e coprendo un solo giorno per richiesta, guarda fino a circa un anno avanti e ricontrolla lo stesso prodotto e le stesse date circa ogni 4 ore.

  • Availability Calendar: City Sightseeing Worldwide controlla ogni prodotto circa una volta al giorno.

  • 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, City Sightseeing Worldwide lo mostra dopo il controllo successivo. Per le date che controlla regolarmente, ciò avviene entro circa 4 ore. Le date più lontane vengono di solito controllate meno spesso.

Pricing Sync

✅ / ❌

I tuoi prezzi vengono restituiti con la disponibilità solo quando City Sightseeing Worldwide li richiede, e City Sightseeing Worldwide non sempre lo fa.

Il funzionamento è il seguente:

  • Capability octo/pricing – City Sightseeing Worldwide 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 City Sightseeing Worldwide, entrambi presi dai prezzi del rivenditore in Ventrata (al pubblico e all'ingrosso/commissioni).

  • Prezzi di gruppo – quando City Sightseeing Worldwide invia anche quante persone di ciascun tipo di unità stanno prenotando, Ventrata calcola il prezzo esatto per quel gruppo. È 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 City Sightseeing Worldwide:

  • Di solito City Sightseeing Worldwide non richiede octo/pricing, quindi molto probabilmente usa i prezzi memorizzati dal proprio lato, che dovresti mantenere aggiornati manualmente con City Sightseeing Worldwide.

 

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

Promotions Sync

❌

Le tue promozioni Ventrata non si applicano su City Sightseeing Worldwide.

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

Bookings Sync

✅

Le prenotazioni e le cancellazioni effettuate su City Sightseeing Worldwide 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 City Sightseeing Worldwide, City Sightseeing Worldwide 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, City Sightseeing Worldwide 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. City Sightseeing Worldwide li consegna al cliente, che li mostra al tuo ingresso come qualsiasi biglietto Ventrata.

  3. Scadenza: se il cliente non completa il pagamento, City Sightseeing Worldwide 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 City Sightseeing Worldwide, City Sightseeing Worldwide 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 City Sightseeing Worldwide deve contattarti.

  5. Modifica: City Sightseeing Worldwide 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 City Sightseeing Worldwide:

  • City Sightseeing Worldwide blocca i posti per circa 60 minuti mentre il cliente paga (expirationMinutes).

  • Una prenotazione tipica su City Sightseeing Worldwide è per circa 2 persone.

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

 

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

Pickups/Dropoff Sync

❌

City Sightseeing Worldwide non invia i dettagli di pickup o drop-off con le sue prenotazioni.

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

Custom Questions Sync

❌

City Sightseeing Worldwide non invia le risposte alle tue domande di prenotazione.

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

Extras Sync

❌

Extra e add-on non possono essere prenotati tramite City Sightseeing Worldwide.

Su City Sightseeing Worldwide 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 City Sightseeing Worldwide.

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

Pass Walkup Scanning Sync

❌

I titolari di pass di City Sightseeing Worldwide non possono essere scansionati al tuo ingresso senza una prenotazione.

I clienti provenienti da City Sightseeing Worldwide devono avere una prenotazione effettuata tramite City Sightseeing Worldwide prima della visita.

Gift Card Sync

❌

Le gift card Ventrata non possono essere vendute né riscattate tramite City Sightseeing Worldwide.

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

✅ supportato · ✅ / ❌ limitato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con City Sightseeing Worldwide

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

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

  • Cosa può vedere City Sightseeing Worldwide: 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: City Sightseeing Worldwide emette i biglietti o il voucher Ventrata che riceve alla conferma, quindi scansione e riscatto funzionano come di consueto.

  • Prenotazioni di test: City Sightseeing Worldwide 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 City Sightseeing Worldwide.

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

City Sightseeing Limited

Suite 8, Floor 3, Grosvenor House, Prospect Hill

Redditch, Worcestershire, B97 4DL, United Kingdom

 

Ventrata Partner ID: 96e653b9-6e2f-4828-830b-8637bc33faa4

 

Prioticket B.V.

Prins Hendrikkade 21

1012 TL Amsterdam, Paesi Bassi

 

Ventrata Partner ID: 8347e498-1afe-48e1-9d99-8b2d1e0069fb

Hai ricevuto la risposta alla tua domanda?