Salzburg Card è la city card all-inclusive di Salisburgo, in Austria, emessa da Tourismus Salzburg, che offre un ingresso gratuito ad attrazioni e musei della città più i trasporti pubblici per 24, 48 o 72 ore. Alle attrazioni porta circa 240.000 titolari di card all'anno e circa 1,2 milioni di ingressi, con Germania, Stati Uniti, Regno Unito e Italia come principali mercati di pernottamento, ed è venduta tramite hotel, biglietterie, l'aeroporto e online. Salzburg Card utilizza Feratel come sistema di biglietteria principale.
Connettere Salzburg Card a Ventrata ti permette di scansionare, convalidare e riscattare i pass di Salzburg Card al tuo ingresso, su tornelli, chioschi, terminali POS basati su Ventrata, sull'app mobile o nella Ventrata Dashboard, senza un'app separata di Salzburg Card.
Per saperne di più su Salzburg Card, visita salzburg.info/en/hotels-offers/salzburg-card.
Sito web principale | |
Tag | Destination Organization (DMO) · Multi-Attraction Pass |
Tipo di connessione | Riscatto dei pass: scansioni i pass di Salzburg Card al tuo ingresso |
Funzionalità della connessione | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Sviluppato da | Ventrata (tramite feratel CheckAPI) |
Questa connessione ti permette di:
Scansiona e convalida le Salzburg Card dei visitatori senza prenotazione su hardware basato su Ventrata (tornello, chiosco per biglietti, punto vendita / terminale), sull'app mobile o dalla dashboard, senza uno scanner o un'app feratel separati.
Crea automaticamente una prenotazione in Ventrata per ogni carta valida, così i visitatori con Salzburg Card compaiono nei tuoi report, nella capienza e nel regolamento dei conti.
Registra l'utilizzo della carta presso feratel immediatamente, oppure all'ingresso o al no-show, segnando la carta come utilizzata per il tuo servizio.
Come funziona
Il codice QR del visitatore viene scansionato su hardware basato su Ventrata o sull'app mobile, oppure inserito in Redeem Voucher Code nella dashboard. In alternativa si può inserire il numero stampato sulla carta.
Se il codice non appartiene a una delle tue prenotazioni o dei tuoi biglietti esistenti, Ventrata verifica in tempo reale con feratel se si tratta di una carta Salzburg Card valida per la tua attrazione in quel momento. Questa verifica non registra alcun utilizzo.
Se la carta è valida, Ventrata crea una prenotazione sotto il tuo rivenditore Salzburg Card, per il prodotto, l'opzione e l'unità che hai mappato su quel servizio e tipo di carta (ad es. Adult o Child).
La prenotazione viene effettuata sulla prima disponibilità attualmente in corso, a meno che il personale non ne scelga una (ad es. su un chiosco per biglietti o un punto vendita).
Ventrata invia l'utilizzo della carta a feratel come “check with transaction”: per impostazione predefinita subito, oppure quando la prenotazione viene riscattata/aggiornata o segnata come no-show, a seconda delle tue impostazioni.
📒 NOTA
Il codice QR sulla carta fisica o sulla carta digitale del visitatore, oppure il numero stampato sulla carta. Un codice QR su una ricevuta d'acquisto non è valido come Salzburg Card.
Creare la connessione con Salzburg Card
🔐 Autorizzazioni di ruolo richieste: See Connections, Modify Connections
Prima di iniziare:
Devi essere un'attrazione partner di Salzburg Card con un accordo commerciale con Tourismus Salzburg GmbH.
La tua attrazione deve essere abilitata per Ventrata da Tourismus Salzburg. Tourismus Salzburg informa feratel, e feratel attiva il checkpoint della tua attrazione per Ventrata.
All'ingresso devi usare hardware basato su Ventrata (tornello, chiosco per biglietti, punto vendita / terminale), l'app mobile o la dashboard.
Crea Salzburg Card come rivenditore in Ventrata con i prezzi corretti (al pubblico, all'ingrosso/a commissione) e il metodo di regolamento “Bill to my account”.
Procurati le cinque credenziali feratel e almeno una carta Salzburg Card reale per ogni tipo che accetti (ad es. una Adult e una Child) che includa i tuoi servizi.
Il tuo ruolo richiede le autorizzazioni See Connections e Modify Connections.
Per aderire a Salzburg Card come attrazione partner, contatta Tourismus Salzburg. [email protected] Https://www.salzburg.info/en/hotels-offers/salzburg-card
Per assistenza con le credenziali o la configurazione, metti in copia Ventrata Connectivity nella tua richiesta a Salzburg Card. [email protected]
Creare la connessione
Nella Ventrata Dashboard, vai su Connections → Connections, fai clic su + New Connection e seleziona Salzburg Card.
Seleziona il tuo rivenditore Salzburg Card.
Inserisci Feratel Username, Password, Tenant ID, Client ID e Client Secret.
Scegli quando inviare il riscatto a feratel, come concordato con Tourismus Salzburg, oppure lascia entrambe le opzioni deselezionate per registrare l'utilizzo quando la carta viene convalidata e la prenotazione creata.
Facoltativamente, imposta un Name, limita destinazioni, prodotti o articoli e seleziona Test.
Fai clic su Create Connection e prosegui con la mappatura.
Il modulo della connessione ha queste opzioni:
Reseller | Il tuo rivenditore Salzburg Card (ad es. Tourismus Salzburg GmbH). La connessione eredita i suoi prezzi, destinazioni, prodotti e articoli consentiti, e tutte le prenotazioni con carta vengono registrate sotto di esso. |
Feratel Username / Password / Tenant ID / Client ID / Client Secret | Le tue credenziali feratel fornite da Salzburg Card. |
Redeem on Redemption/Upgrade | Invia il riscatto a feratel quando la prenotazione viene riscattata in Ventrata. Consigliato quando prenotazione e ingresso avvengono in momenti diversi. |
Redeem on No-show | Invia il riscatto a feratel quando la prenotazione viene segnata come no-show in Ventrata, inclusi i no-show automatici. |
Name | Nome facoltativo della connessione, a tua scelta. |
Destinazioni, prodotti o articoli consentiti | Restrizioni aggiuntive facoltative oltre a quelle impostate sul rivenditore. |
Test | Forza tutte le prenotazioni Salzburg Card in modalità test e accetta scansioni solo da dispositivi in modalità test. |
📗 SUGGERIMENTO
Seleziona Test sulla connessione per forzare tutte le prenotazioni Salzburg Card in modalità test e accettare scansioni solo da dispositivi in modalità test; deselezionalo prima di andare in produzione. Le carte di servizio di test hanno un tipo di carta di test, non Adult o Child, quindi non possono essere usate per configurare la mappatura.
Mappare i prodotti
Feratel non invia tramite API i servizi insieme ai relativi tipi di carta. I servizi assegnati alla tua attrazione si caricano automaticamente; ogni tipo di carta (ad es. Adult, Child) compare come riga sotto il proprio servizio la prima volta che viene scansionata una carta di quel tipo.
Apri la tua connessione Salzburg Card e controlla i servizi caricati da feratel. Le righe dei servizi indicano a Ventrata cosa verificare, ma da sole non possono essere usate per l'ingresso.
Tieni pronta una carta reale per ogni tipo (non una carta di servizio di test).
Scansiona ogni carta, oppure inseriscine il codice o il numero stampato in Redeem Voucher Code. La prima scansione non riesce con un errore di mappatura: è previsto e la carta non viene consumata.
Ricarica la pagina della connessione o fai clic su Refresh Mapping. Sotto il servizio compare una nuova riga rossa per ogni tipo di carta scansionato.
Fai clic su ogni riga, seleziona il prodotto, l'opzione e l'unità Ventrata (tutti e tre obbligatori) e fai clic su Update Mapping.
Scansiona di nuovo le stesse carte. Viene creata una prenotazione e il riscatto viene inviato in base alle tue impostazioni.
Quando viene assegnato un nuovo servizio, fai prima clic su Refresh Mapping, poi scansiona e mappa ogni tipo di carta. Per un nuovo tipo di carta su un servizio esistente, basta scansionarlo e mapparlo.
📒 NOTA
Se scansioni una carta di servizio di test, compare una riga con un tipo di carta di test; puoi lasciarla non mappata.
📒 NOTA
Quando un servizio viene rimosso in feratel, Refresh Mapping lo elimina insieme alle mappature dei tipi di carta. Se viene ripristinato, aggiorna, poi scansionalo e mappalo di nuovo.
Redemption
Immediatamente: impostazione predefinita (entrambe le opzioni deselezionate): l'utilizzo della carta viene registrato presso feratel quando la carta viene convalidata e la prenotazione creata.
Al riscatto o al no-show: con Redeem on Redemption/Upgrade, l'utilizzo viene inviato quando la prenotazione viene riscattata o aggiornata in Ventrata. Con Redeem on No-show, viene inviato quando la prenotazione viene segnata come no-show, inclusi i no-show automatici.
Cosa viene inviato a Salzburg Card: una richiesta “check with transaction” a feratel, che segna la carta come utilizzata per il tuo servizio. Il riscatto in Ventrata non riesce se feratel non lo accetta.
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 Salzburg Card a un prodotto Ventrata nella Ventrata Dashboard. Feratel non invia tramite API i servizi insieme ai relativi tipi di carta. I servizi assegnati alla tua attrazione si caricano automaticamente; ogni tipo di carta (ad es. Adult, Child) compare come riga sotto il proprio servizio la prima volta che viene scansionata una carta di quel tipo. Se scansioni una carta di servizio di test, compare una riga con un tipo di carta di test; puoi lasciarla non mappata. Quando un servizio viene rimosso in feratel, Refresh Mapping lo elimina insieme alle mappature dei tipi di carta. Se viene ripristinato, aggiorna, poi scansionalo e mappalo di nuovo. |
Content Sync | ❌ |
I contenuti dei prodotti non vengono sincronizzati. Salzburg Card vende il proprio pass. I tuoi prodotti e i relativi contenuti restano in Ventrata. |
Availability Sync | ✅ / ❌ |
Limitato: le visite con carta incidono sulla tua capienza. Le prenotazioni vengono inserite nella prima disponibilità attualmente in corso, quindi le visite con carta incidono sulla tua capienza. Una verifica di validità riuscita non riserva il servizio presso feratel: se la carta viene usata altrove prima dell'invio del riscatto, feratel la rifiuta. |
Pricing Sync | ❌ |
I prezzi non vengono sincronizzati con Salzburg Card. Le prenotazioni usano i prezzi (al pubblico, all'ingrosso/a commissione) definiti sul tuo rivenditore Salzburg Card, che deve usare il metodo di regolamento “Bill to my account”. |
Promotions Sync | ❌ |
Le promozioni non si applicano ai pass di Salzburg Card. Le tue promozioni Ventrata non si applicano alle prenotazioni create scansionando un pass. |
Bookings Sync | ✅ / ❌ |
Limitato: le prenotazioni vengono create solo quando un pass viene scansionato. Una prenotazione per ogni carta valida, creata automaticamente sotto il rivenditore Salzburg Card, sulla prima disponibilità attualmente in corso, a meno che il personale non ne scelga una. Il numero stampato sulla carta viene registrato come riferimento del rivenditore e in fattura. Prodotto, opzione e unità derivano dalla mappatura per servizio e tipo di carta. I riscatti registrati in feratel non possono essere annullati da Ventrata. |
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 Salzburg Card. Impostazione predefinita (entrambe le opzioni deselezionate): l'utilizzo della carta viene registrato presso feratel quando la carta viene convalidata e la prenotazione creata. Con Redeem on Redemption/Upgrade, l'utilizzo viene inviato quando la prenotazione viene riscattata o aggiornata in Ventrata. Con Redeem on No-show, viene inviato quando la prenotazione viene segnata come no-show, inclusi i no-show automatici. Una richiesta “check with transaction” a feratel, che segna la carta come utilizzata per il tuo servizio. Il riscatto in Ventrata non riesce se feratel non lo accetta. |
Pass Walkup Scanning Sync | ✅ |
Scansioni i pass di Salzburg Card al tuo ingresso. Il codice QR del visitatore viene scansionato su hardware basato su Ventrata o sull'app mobile, oppure inserito in Redeem Voucher Code nella dashboard. In alternativa si può inserire il numero stampato sulla carta. Se il codice non appartiene a una delle tue prenotazioni o dei tuoi biglietti esistenti, Ventrata verifica in tempo reale con feratel se si tratta di una carta Salzburg Card valida per la tua attrazione in quel momento. Questa verifica non registra alcun utilizzo. Se la carta è valida, Ventrata crea una prenotazione sotto il tuo rivenditore Salzburg Card, per il prodotto, l'opzione e l'unità che hai mappato su quel servizio e tipo di carta (ad es. Adult o Child). |
Gift Card Sync | ❌ |
Non fa parte di questa connessione. I pass di Salzburg Card non sono carte regalo Ventrata. |
✅ supportato · ✅ / ❌ limitato · ❌ non supportato
Buono a sapersi: limiti di questa connessione
Buono a sapersi: limiti di questa connessione
I tipi di carta possono essere mappati solo dopo che una carta reale di quel tipo è stata scansionata una volta.
Le carte di servizio di test non possono essere usate per configurare la mappatura Adult o Child.
Le regole di validità (periodo della carta, numero di utilizzi, finestre di doppio utilizzo) sono gestite dall'emittente della carta in feratel.
I riscatti registrati in feratel non possono essere annullati da Ventrata.
Se prenotazione e ingresso avvengono in momenti diversi, la carta potrebbe essere usata altrove nel frattempo, a meno che tu non abiliti Redeem on Redemption/Upgrade.
Risoluzione dei problemi
“Errore di mappatura alla prima scansione di una carta”
“Errore di mappatura alla prima scansione di una carta”
È previsto la prima volta che viene scansionato un tipo di carta. La carta non viene consumata. Ricarica la pagina della connessione, mappa la nuova riga e scansiona di nuovo.
“Nessuna prenotazione trovata”
“Nessuna prenotazione trovata”
Il codice scansionato non appartiene a una carta Salzburg Card, ad esempio è il codice QR su una ricevuta d'acquisto. Scansiona il codice QR sulla carta o sulla carta digitale, oppure inserisci il numero stampato sulla carta.
“Carta rifiutata perché non valida (messaggio da feratel)”
“Carta rifiutata perché non valida (messaggio da feratel)”
Riflette lo stato della carta e le regole di utilizzo stabilite da Tourismus Salzburg: scaduta, già utilizzata oggi per il tuo servizio o non valida per questo servizio. I clienti devono contattare Tourismus Salzburg per la loro carta.
“La carta viene scansionata ma non viene creata alcuna prenotazione”
“La carta viene scansionata ma non viene creata alcuna prenotazione”
Il tipo di carta potrebbe non essere ancora mappato. Ricarica la pagina della connessione, mappa la nuova riga e scansiona di nuovo. Per un servizio appena assegnato, fai prima clic su Refresh Mapping. Se il problema persiste, contatta l'assistenza Ventrata.
“La connessione non può essere creata o non vengono caricati servizi”
“La connessione non può essere creata o non vengono caricati servizi”
Le credenziali potrebbero essere errate oppure il tuo checkpoint non è abilitato per Ventrata. Controlla che tutte e cinque le credenziali feratel siano esattamente come le hai ricevute e che il checkpoint sia abilitato. Poi contatta il tuo referente di Salzburg Card mettendo in copia [email protected].
FAQ
Che rapporto c'è tra feratel e Salzburg Card?
Che rapporto c'è tra feratel e Salzburg Card?
Salzburg Card è emessa da Tourismus Salzburg GmbH e funziona sul software Card System di feratel. feratel non è un rivenditore: il tuo rapporto commerciale è con Tourismus Salzburg, e Ventrata usa la CheckAPI di feratel per convalidare e riscattare la carta. Ogni carta basata su feratel richiede una propria connessione e un proprio rivenditore in Ventrata.
Una scansione riuscita riserva la carta per la mia attrazione?
Una scansione riuscita riserva la carta per la mia attrazione?
No. Ventrata verifica prima la carta senza registrarne l'utilizzo. Se la carta viene usata altrove prima dell'invio del riscatto, feratel la rifiuta.
Quando conviene abilitare Redeem on Redemption/Upgrade?
Quando conviene abilitare Redeem on Redemption/Upgrade?
Quando prenotazione e ingresso avvengono in momenti diversi, ad esempio su un chiosco per biglietti o con una prevendita a un punto vendita, così l'utilizzo della carta viene registrato all'ingresso.
Risorse utili
📚 Altro sulle connessioni Ventrata
Informazioni sul partner
Tourismus Salzburg GmbH
Auerspergstraße 6, 5020 Salzburg
Austria
Ventrata Partner ID: 01a144a3-e3fa-7458-938a-1324332c0830