CityPASS gestisce un programma di affiliazione e travel trade legato al suo pass multi-attrazione, che dal 1997 riunisce a un prezzo fisso scontato l'ingresso ad attrazioni famose in 17 grandi città degli Stati Uniti e del Canada. Il programma estende questo inventario a editori, agenti di viaggio, tour operator, hotel e organizzazioni di marketing territoriale tramite link di affiliazione tracciati e account trade, proponendo la vendita dei pass a visitatori che stanno già pianificando un viaggio in città, dai viaggiatori singoli alle famiglie e ai gruppi.
Collegare CityPASS a Ventrata ti permette di rivendere i prodotti di operatori che usano CityPASS come sistema di prenotazione. Ventrata legge da CityPASS la loro disponibilità in tempo reale e ogni prenotazione che ricevi viene creata direttamente nell'account CityPASS dell'operatore.
Per saperne di più su CityPASS, visita citypass.com.
📒 NOTA
Vuoi invece scansionare e riscattare i biglietti CityPASS al tuo ingresso? Consulta CityPASS: connessione rivenditore.
📗 SUGGERIMENTO
Dopo la mappatura effettua una prenotazione di test e chiedi a CityPASS Affiliates & Travel Trade di confermare che sia arrivata nel suo sistema.
Sito web principale | |
Tag | Custom / Proprietary Operator System |
Funzionalità della connessione | Availability Sync · Bookings Sync |
Sviluppato da | Ventrata (tramite CityPASS API) |
Questa connessione operatore (detta anche backend) ti permette di rivendere i prodotti di operatori che usano CityPASS come sistema di prenotazione principale, e ogni prenotazione viene creata direttamente in CityPASS. Le funzionalità di questa connessione includono:
Availability Sync – la disponibilità in tempo reale proviene dall'account CityPASS dell'operatore.
Bookings Sync – le prenotazioni vengono inviate da Ventrata a CityPASS e CityPASS emette i biglietti o i voucher.
L'API esterna di CityPASS 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 CityPASS
🔐 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 CityPASS User e CityPASS Password per l'operatore. Vedi i passaggi seguenti.
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
Contatta CityPASS Affiliates & Travel Trade e chiedi di poterne rivendere i prodotti tramite Ventrata.
Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.
Nella sezione Backend Partner, seleziona CityPASS e inserisci CityPASS User e CityPASS Password.
Inserisci nella sezione Backend Partner le credenziali fornite da CityPASS Affiliates & Travel Trade.
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 CityPASS.
Press Update Product.
Seleziona Backend Connected. Seleziona anche Backend Availability per recuperare la disponibilità e Backend Pricing per recuperare i prezzi. Senza di essi, il prodotto usa la disponibilità e i prezzi impostati in Ventrata, ma invia comunque le prenotazioni a CityPASS.
Mappare i prodotti su CityPASS
‼️ IMPORTANTE
La mappatura indica a Ventrata per quali prodotto, opzione e unità di CityPASS 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 CityPASS, il prodotto, l'opzione e le unità corrispondenti di CityPASS. 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 CityPASS.
Gestire la connessione con CityPASS
Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in CityPASS.
Sostituisci la chiave sull'operatore se CityPASS 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 CityPASS.
Funzionalità della connessione in dettaglio
Questa sezione è per chi vuole sapere esattamente come funziona la connessione con CityPASS. Qui la direzione è opposta a quella di una connessione rivenditore: è Ventrata a chiamare CityPASS, tramite CityPASS API. Per ogni funzionalità spiega quali chiamate effettua Ventrata, quando e cosa significa per te.
In breve: Ventrata chiede a CityPASS la disponibilità ogni volta che qualcuno visualizza un prodotto collegato al backend e crea ogni prenotazione nell'account CityPASS dell'operatore. CityPASS non rinvia modifiche a Ventrata.
Le tempistiche sono quelle tipiche di CityPASS, arrotondate, e possono cambiare.
Product Mapping | ✅ |
Mappi ogni prodotto, opzione e unità Ventrata al prodotto CityPASS 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 CityPASS. Chiedigli di farlo. |
Content Sync | ❌ |
Ventrata non importa i contenuti dei prodotti da CityPASS. Ventrata non importa i contenuti dei prodotti da CityPASS. 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 CityPASS. Il funzionamento è il seguente:
Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in CityPASS, quindi non puoi vendere in eccesso una fascia oraria che l'operatore ha già venduto altrove. |
Pricing Sync | ❌ |
Ventrata non legge i prezzi da CityPASS. Ventrata non legge i prezzi da CityPASS. I prodotti usano i prezzi che imposti in Ventrata e le prenotazioni vengono comunque inviate a CityPASS. |
Promotions Sync | ❌ |
Le promozioni non vengono inviate a CityPASS. Le promozioni non vengono inviate a CityPASS. 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 CityPASS dell'operatore. Il funzionamento è il seguente:
Invia prenotazioni, modifiche e cancellazioni da Ventrata a CityPASS.
‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a CityPASS. Se l'operatore modifica o cancella una prenotazione in CityPASS, 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 CityPASS. I dettagli di pickup e drop-off non vengono trasmessi a CityPASS. 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 CityPASS. Le risposte alle tue domande di prenotazione non vengono trasmesse a CityPASS. Se l'operatore ne ha bisogno, comunicagliele in un altro modo. |
Extras Sync | ❌ |
Extra e componenti aggiuntivi non vengono prenotati in CityPASS. Extra e componenti aggiuntivi non vengono prenotati in CityPASS. Vengono prenotati solo prodotto, opzione e unità principali. |
Redemption Sync | ❌ |
I riscatti e le altre modifiche di stato in CityPASS non vengono rinviati a Ventrata dopo la conferma di una prenotazione. I riscatti e le altre modifiche di stato in CityPASS non vengono rinviati a Ventrata dopo la conferma di una prenotazione. |
Pass Walkup Scanning Sync | ❌ |
La scansione dei pass walk-up non è disponibile con CityPASS. La scansione dei pass walk-up non è disponibile con CityPASS. |
Gift Card Sync | ❌ |
Le carte regalo Ventrata non vengono trasmesse a CityPASS. Le carte regalo Ventrata non vengono trasmesse a CityPASS. I pagamenti con carta regalo restano in Ventrata. |
✅ supportato · ❌ non supportato
Buono a sapersi: limiti e dettagli della connessione con CityPASS
Buono a sapersi: limiti e dettagli della connessione con CityPASS
Disponibilità in tempo reale: la disponibilità arriva da CityPASS mentre gli utenti navigano.
Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in CityPASS non arrivano a Ventrata.
API personalizzata: l'API di CityPASS non è OCTO, quindi alcune funzionalità possono essere limitate rispetto ai backend OCTO.
CityPASS è un fornitore di pass multi-attrazione che copre diciassette grandi città degli Stati Uniti e del Canada; il suo programma di affiliazione e travel trade estende il suo inventario a editori, agenti, tour operator, hotel e organizzazioni di marketing territoriale.
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 CityPASS User e CityPASS Password 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 CityPASS. 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 CityPASS. Se il problema persiste, contatta il nostro supporto tecnico.
Ricevo un errore durante il salvataggio della configurazione del backend dell'operatore.
Ricevo un errore durante il salvataggio della configurazione del backend dell'operatore.
Molto probabilmente le credenziali non sono corrette. Verificale con CityPASS Affiliates & Travel Trade. Se il problema persiste, contatta il 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 selezionato sul prodotto non ha un backend configurato. Controlla la configurazione del backend dell'operatore e riprova.
Risorse utili
📚 Altro sulle connessioni Ventrata
Informazioni sul partner
City Pass, Inc.
Ventrata Partner ID: 433aac31-5f98-4ad2-908e-6bc068366e02