CityPASS è un pass multi-attrazione che raggruppa l'ingresso a una selezione fissa di attrazioni di punta in diciassette destinazioni nordamericane, da New York, Chicago e Boston a Toronto, Orlando e la California meridionale, a un unico prezzo scontato, venduto tramite pubblicità ai consumatori, trade turistico, hotel e affiliati. Agli operatori porta titolari di pass prepagati che si impegnano per più ingressi prima dell'arrivo e li visitano durante un soggiorno di più giorni: viaggiatori che pianificano un itinerario completo in città.
Connettere CityPASS a Ventrata ti permette di scansionare, convalidare e riscattare i pass di CityPASS al tuo ingresso, su tornelli, chioschi, terminali POS basati su Ventrata, sull'app mobile o nella Ventrata Dashboard, senza un'app separata di CityPASS.
Per saperne di più su CityPASS, visita citypass.com.
📒 NOTA
Vuoi invece rivendere i biglietti di CityPASS? Vedi CityPASS: backend operatore.
🏆 CityPASS Preferred Integration Partner. Ventrata è stata designata CityPASS Preferred Integration Partner e supporta l'intero set di funzionalità dell'integrazione con CityPASS.
Sito web principale | |
Tag | Multi-Attraction Pass |
Tipo di connessione | Riscatto dei pass: scansioni i pass di CityPASS al tuo ingresso |
Funzionalità della connessione | Product Mapping · Availability Sync · Pricing Sync · Bookings Sync · Redemption Sync · Pass Walkup Scanning Sync |
Sviluppato da | Ventrata (tramite CityPASS API) |
Questa connessione ti permette di:
Scansiona i codici a barre di CityPASS e C-Ticket al tuo ingresso e convalidali con CityPASS in tempo reale.
Registra ogni visita con pass come prenotazione a data aperta in Ventrata, con il codice a barre come riferimento del rivenditore.
Segna automaticamente il biglietto come utilizzato in CityPASS, al momento della scansione oppure in seguito, quando viene riscattato o segnato come no-show.
Come funziona
Scansioni o inserisci un codice a barre al tuo ingresso.
Se il codice a barre inizia con 308458, Ventrata lo tratta come biglietto di CityPASS e lo convalida con l'API di CityPASS.
Ventrata trova la riga di mappatura per la famiglia di prodotti, l'attrazione e la classe di biglietto. Se non è ancora mappata, la scansione non va a buon fine finché non la mappi.
Ventrata crea una prenotazione a data aperta per il prodotto, l'opzione e l'unità mappati, quantità 1, con il codice a barre come riferimento del rivenditore.
Ventrata comunica a CityPASS che il biglietto è stato utilizzato. Se lo staff ha scelto una data o una fascia oraria, questa viene inviata come data di utilizzo; altrimenti viene usata l'ora attuale.
📒 NOTA
Solo i codici a barre che iniziano con 308458 vengono trattati come CityPASS.
Creare la connessione con CityPASS
🔐 Autorizzazioni di ruolo richieste: See Connections, Modify Connections
Prima di iniziare:
Hai configurato CityPASS come Reseller in Ventrata; il modulo della connessione ti chiede di sceglierne uno.
Hai un utente e una password di CityPASS per l'API di CityPASS.
Creare la connessione con CityPASS
Seleziona il Reseller CityPASS.
Inserisci l'utente e la password di CityPASS.
Scegli quali biglietti accettare con Is affiliate / Is not affiliate e Product families.
Salva. Ventrata verifica le credenziali recuperando l'elenco dei prodotti di riscatto di CityPASS; se l'operazione non riesce, i campi utente e password vengono segnati come non validi.
Il modulo della connessione ha queste opzioni:
Reseller | Il rivenditore di cui la connessione usa le impostazioni e per conto del quale vengono registrate le prenotazioni. |
Utente di CityPASS | Utente API fornito da CityPASS. Un prefisso 'uat:' indirizza la connessione all'ambiente di integrazione (test) di CityPASS. |
Password di CityPASS | Password API fornita da CityPASS. |
Is affiliate | Accetta i biglietti per cui CityPASS contrassegna l'attrazione come affiliate/inventory. Attivo per impostazione predefinita. |
Is not affiliate | Accetta i biglietti per cui CityPASS non contrassegna l'attrazione come affiliate/inventory. Attivo per impostazione predefinita. |
Product families | Quali famiglie di prodotti di CityPASS accetti: CityPASS e/o CTicket. Entrambe per impostazione predefinita. |
📗 SUGGERIMENTO
Aggiungi il prefisso 'uat:' all'utente per indirizzare la connessione all'ambiente di integrazione (test) di CityPASS.
Mappare i prodotti
Le righe provengono dall'elenco dei prodotti di riscatto di CityPASS (/ventrata/redemptionproducts). Le nuove classi di biglietto rilevate durante la scansione aggiungono righe al volo.
Apri la connessione e mappa ogni riga di CityPASS a un prodotto, un'opzione e un'unità Ventrata.
📒 NOTA
Ogni riga richiede un prodotto, un'opzione e un'unità.
📒 NOTA
Finché una riga non è mappata, le scansioni per quella classe di biglietto non vanno a buon fine con ' is not mapped in <connection>'.
Redemption
Immediatamente: impostazione predefinita: al momento della scansione Ventrata comunica a CityPASS che il biglietto è REDEEMED (chiamata Use).
Al riscatto o al no-show: Redeem on undefer / no-show è supportato. Ventrata invia la chiamata Use in seguito, con REDEEMED o con lo stato del biglietto Ventrata in maiuscolo, ad esempio NOSHOW o CANCELLED.
Cosa viene inviato a CityPASS: lo stato del biglietto (REDEEMED o, in modalità differita, lo stato del biglietto) e la data di utilizzo: la data/ora della prenotazione se lo staff ne ha scelta una, altrimenti il momento attuale. Non viene inviato alcun prezzo.
Funzionalità della connessione in dettaglio
Questa sezione è per chi vuole i dettagli. Fai clic su una riga per vedere come funziona ogni funzionalità.
Product Mapping | ✅ |
Mappi ogni pass di CityPASS a un prodotto Ventrata nella Ventrata Dashboard. Le righe provengono dall'elenco dei prodotti di riscatto di CityPASS (/ventrata/redemptionproducts). Le nuove classi di biglietto rilevate durante la scansione aggiungono righe al volo. Ogni riga richiede un prodotto, un'opzione e un'unità. Finché una riga non è mappata, le scansioni per quella classe di biglietto non vanno a buon fine con ' is not mapped in <connection>'. |
Content Sync | ❌ |
I contenuti dei prodotti non vengono sincronizzati. CityPASS vende il proprio pass. I tuoi prodotti e i relativi contenuti restano in Ventrata. |
Availability Sync | ✅ |
Nessuna disponibilità viene sincronizzata con CityPASS. Nessuna disponibilità viene sincronizzata con CityPASS. |
Pricing Sync | ✅ |
I prezzi vengono condivisi con CityPASS. La prenotazione usa il tuo prezzo unitario Ventrata con regolamento tramite voucher. Nessuna informazione sul prezzo viene inviata a CityPASS. |
Promotions Sync | ❌ |
Le promozioni non si applicano ai pass di CityPASS. Le tue promozioni Ventrata non si applicano alle prenotazioni create scansionando un pass. |
Bookings Sync | ✅ |
Le prenotazioni vengono create in Ventrata quando un pass viene scansionato. Le prenotazioni vengono create al momento della scansione, a data aperta, quantità 1 (un biglietto per codice a barre), con il codice a barre come riferimento del rivenditore. Non esiste una chiamata di cancellazione verso CityPASS. In modalità differita, lo stato di biglietto cancellato o no-show può essere inoltrato a CityPASS nella chiamata Use. |
Pickups/Dropoff Sync | ❌ |
Non fa parte di questa connessione. I riscatti dei pass non includono pick-up. |
Custom Questions Sync | ❌ |
Non fa parte di questa connessione. Le domande di prenotazione non vengono poste né inviate per i riscatti dei pass. |
Extras Sync | ❌ |
Non fa parte di questa connessione. Non è possibile aggiungere extra al riscatto di un pass. |
Redemption Sync | ✅ |
I riscatti vengono inviati a CityPASS. Impostazione predefinita: al momento della scansione Ventrata comunica a CityPASS che il biglietto è REDEEMED (chiamata Use). Redeem on undefer / no-show è supportato. Ventrata invia la chiamata Use in seguito, con REDEEMED o con lo stato del biglietto Ventrata in maiuscolo, ad esempio NOSHOW o CANCELLED. Lo stato del biglietto (REDEEMED o, in modalità differita, lo stato del biglietto) e la data di utilizzo: la data/ora della prenotazione se lo staff ne ha scelta una, altrimenti il momento attuale. Non viene inviato alcun prezzo. |
Pass Walkup Scanning Sync | ✅ |
Scansioni i pass di CityPASS al tuo ingresso. Scansioni o inserisci un codice a barre al tuo ingresso. Se il codice a barre inizia con 308458, Ventrata lo tratta come biglietto di CityPASS e lo convalida con l'API di CityPASS. Ventrata trova la riga di mappatura per la famiglia di prodotti, l'attrazione e la classe di biglietto. Se non è ancora mappata, la scansione non va a buon fine finché non la mappi. |
Gift Card Sync | ❌ |
Non fa parte di questa connessione. I pass di CityPASS non sono carte regalo Ventrata. |
✅ supportato · ❌ non supportato
Buono a sapersi: limiti di questa connessione
Buono a sapersi: limiti di questa connessione
Un biglietto per codice a barre.
Vengono riconosciuti solo i codici a barre che iniziano con 308458.
Nessun pick-up, extra o domanda di prenotazione.
Nessuna sincronizzazione di disponibilità o prezzi.
Risoluzione dei problemi
" is not mapped in <connection>"</b>
" is not mapped in <connection>"</b>
Questa famiglia di prodotti, attrazione e classe di biglietto di CityPASS non è ancora mappata a un prodotto Ventrata. Mappa la riga nella connessione con CityPASS a un prodotto, un'opzione e un'unità.
"Redemption not allowed"
"Redemption not allowed"
"Pass expired, cancelled, or already used"
"Pass expired, cancelled, or already used"
"Testo del messaggio di CityPASS"
"Testo del messaggio di CityPASS"
CityPASS ha rifiutato il biglietto per un altro motivo; Ventrata mostra il suo messaggio così com'è.
📚 Altro sulle connessioni Ventrata
Informazioni sul partner
City Pass, Inc.
Ventrata Partner ID: 41927759-10fb-4011-9315-aa4ece876c67