Berlin WelcomeCard è il biglietto turistico ufficiale di Berlino, emesso dall'ente del turismo visitBerlin e venduto oltre 15 milioni di volte. Abbina il trasporto pubblico illimitato nelle zone AB o ABC a sconti in oltre 170 attrazioni, e le versioni superiori aggiungono l'ingresso all'Isola dei Musei o l'ingresso gratuito a più di 25 attrazioni. Alle attrazioni porta visitatori della città, alla prima visita o abituali, dalla Germania e dall'estero, che acquistano la card online o nei punti vendita e organizzano le visite in base a essa. Questa connessione è sviluppata e gestita da Public Ticket Solution.

Connettere Berlin WelcomeCard a Ventrata ti permette di scansionare, convalidare e riscattare i pass di Berlin WelcomeCard al tuo ingresso, su tornelli, chioschi, terminali POS basati su Ventrata, sull'app mobile o nella Ventrata Dashboard, senza un'app separata di Berlin WelcomeCard.

Per saperne di più su Berlin WelcomeCard, visita berlin-welcomecard.de.

Sito web principale	berlin-welcomecard.de
Tag	Destination Organization (DMO) · Multi-Attraction Pass
Tipo di connessione	Riscatto dei pass: scansioni i pass di Berlin WelcomeCard al tuo ingresso
Funzionalità della connessione	Product Mapping · Redemption Sync · Pass Walkup Scanning Sync
Sviluppato da	Ventrata (tramite visitBerlin Ticket Gateway API)

Questa connessione ti permette di:

Scansiona o digita in Ventrata un codice biglietto Berlin WelcomeCard e verificalo con Berlin WelcomeCard in tempo reale.
Crea automaticamente una prenotazione in Ventrata per ogni biglietto valido.
Registra l'ingresso presso Berlin WelcomeCard al momento della scansione, così il biglietto risulta utilizzato.

Come funziona

Il personale scansiona o digita un codice biglietto WelcomeCard in Ventrata: nella ricerca ordini del Backoffice, su uno scanner o terminale Ventrata, oppure tramite l'API OCTO di riscatto/check-in di Ventrata.
Ventrata considera biglietti WelcomeCard solo i codici che iniziano con "TE" seguito da almeno 12 caratteri. Gli altri codici vengono lasciati alle tue altre connessioni.
Se il biglietto era già stato prenotato per questo rivenditore, Ventrata restituisce la prenotazione esistente.
Altrimenti Ventrata invia a Berlin WelcomeCard una scansione di sola verifica per controllare il biglietto e trovarne la variante di prodotto.
Ventrata registra quindi una scansione di ingresso presso Berlin WelcomeCard, usando il tuo Entry Zone ID, l'Organization ID e l'ora corrente.
Se Berlin WelcomeCard conferma l'esito positivo, Ventrata salva una prenotazione a data aperta per 1 unità del prodotto, dell'opzione e dell'unità che hai mappato su quella variante.

📒 NOTA

Codici biglietto che corrispondono a "TE" seguito da almeno 12 lettere o cifre (regex ^TE\w{12,}$). Qualsiasi altro codice viene ignorato da questa connessione.

Creare la connessione con Berlin WelcomeCard

🔐 Autorizzazioni di ruolo richieste: See Connections, Modify Connections

Prima di iniziare:

Tieni pronte le tue credenziali API Berlin WelcomeCard: Username, Password, Product ID, Organization ID ed Entry Zone ID.
Crea Berlin WelcomeCard come rivenditore in Ventrata e selezionalo sulla connessione. Il modulo indica Reseller come facoltativo, ma le ricerche ne hanno bisogno.

Creare la connessione

Seleziona il tuo rivenditore Berlin WelcomeCard.
Inserisci Username, Password, Product ID, Organization ID ed Entry Zone ID.
Salva. Ventrata effettua l'accesso, recupera il prodotto e le sue varianti e crea una riga di mappatura per ogni variante.

Il modulo della connessione ha queste opzioni:

Reseller	Il rivenditore sotto cui vengono registrate le prenotazioni WelcomeCard. Facoltativo nel modulo, ma in pratica necessario per le ricerche.
Berlin Welcomecard Username / Password	Ventrata li usa per accedere quando salvi. Se l'accesso non riesce, entrambi i campi vengono segnalati come non validi.
Berlin Welcomecard Product ID	Il prodotto WelcomeCard di cui Ventrata carica le varianti per la mappatura. Se il prodotto non viene trovato, il campo viene segnalato come non valido.
Berlin Welcomecard Organization ID	Inviato con ogni scansione di ingresso. Non viene verificato al salvataggio.
Berlin Welcomecard Entry Zone ID	La zona di ingresso su cui viene registrata ogni scansione. Non viene verificata al salvataggio; un valore errato emerge solo al momento della scansione.

Mappare i prodotti

Quando salvi la connessione, Ventrata crea una riga per ogni variante del prodotto WelcomeCard configurato. Le varianti che non esistono più vengono rimosse. Se un biglietto scansionato appartiene a una variante che non ha ancora una riga, Ventrata aggiunge la riga al momento della scansione.

Apri la connessione e seleziona ogni riga di variante.
Scegli il prodotto, l'opzione e l'unità Ventrata da prenotare per quella variante. Opzione e unità sono obbligatorie.
Salva di nuovo la connessione ogni volta che le varianti WelcomeCard cambiano. Le righe si aggiornano solo al salvataggio.

📒 NOTA

Un biglietto per una variante non mappata non riesce con " is not mapped in <connection>" finché non la mappi.

Redemption

Immediatamente: sempre. La scansione di ingresso viene registrata presso Berlin WelcomeCard al momento della scansione e la prenotazione viene salvata solo se il fornitore segnala l'esito positivo.
Al riscatto o in caso di no-show: non supportato. Le opzioni Redeem on Redemption/Upgrade e Redeem on No-show non compaiono per questa connessione.
Cosa viene inviato a Berlin WelcomeCard: un evento di scansione di ingresso (scanEventCreate, kind entry) con la tua zona di ingresso, l'organizzazione, l'ora corrente e il nome dispositivo "Ventrata".

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 Berlin WelcomeCard a un prodotto Ventrata nella Ventrata Dashboard. Quando salvi la connessione, Ventrata crea una riga per ogni variante del prodotto WelcomeCard configurato. Le varianti che non esistono più vengono rimosse. Se un biglietto scansionato appartiene a una variante che non ha ancora una riga, Ventrata aggiunge la riga al momento della scansione. Un biglietto per una variante non mappata non riesce con " is not mapped in <connection>" finché non la mappi.
Content Sync	❌	I contenuti dei prodotti non vengono sincronizzati. Berlin WelcomeCard vende il proprio pass. I tuoi prodotti e i relativi contenuti restano in Ventrata.
Availability Sync	❌	La tua disponibilità non viene condivisa con Berlin WelcomeCard. Non c'è alcuno scambio di disponibilità o capienza con Berlin WelcomeCard.
Pricing Sync	❌	I prezzi non vengono sincronizzati con Berlin WelcomeCard. La prenotazione usa il prezzo unitario Ventrata ed è saldata tramite voucher, quindi l'ordine va in pareggio a zero. Nessun prezzo viene inviato a Berlin WelcomeCard.
Promotions Sync	❌	Le promozioni non si applicano ai pass di Berlin WelcomeCard. 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 a data aperta per ogni biglietto, con quantità 1 dell'unità mappata, creata quando il biglietto viene scansionato. Il riferimento del rivenditore è il codice biglietto senza il prefisso "TE". I controlli su cliente, domande, trasporto e accompagnatori vengono saltati. Scansionare di nuovo lo stesso biglietto restituisce la prenotazione esistente. Non esiste una chiamata di cancellazione verso Berlin WelcomeCard. Una scansione registrata non può essere annullata 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 Berlin WelcomeCard. Sempre. La scansione di ingresso viene registrata presso Berlin WelcomeCard al momento della scansione e la prenotazione viene salvata solo se il fornitore segnala l'esito positivo. Non supportato. Le opzioni Redeem on Redemption/Upgrade e Redeem on No-show non compaiono per questa connessione. Un evento di scansione di ingresso (scanEventCreate, kind entry) con la tua zona di ingresso, l'organizzazione, l'ora corrente e il nome dispositivo "Ventrata".
Pass Walkup Scanning Sync	✅	Scansioni i pass di Berlin WelcomeCard al tuo ingresso. Il personale scansiona o digita un codice biglietto WelcomeCard in Ventrata: nella ricerca ordini del Backoffice, su uno scanner o terminale Ventrata, oppure tramite l'API OCTO di riscatto/check-in di Ventrata. Ventrata considera biglietti WelcomeCard solo i codici che iniziano con "TE" seguito da almeno 12 caratteri. Gli altri codici vengono lasciati alle tue altre connessioni. Se il biglietto era già stato prenotato per questo rivenditore, Ventrata restituisce la prenotazione esistente.
Gift Card Sync	❌	Non fa parte di questa connessione. I pass di Berlin WelcomeCard non sono carte regalo Ventrata.

✅ supportato · ✅ / ❌ limitato · ❌ non supportato

Buono a sapersi: limiti di questa connessione

Un solo Product ID WelcomeCard per connessione. Per accettare più prodotti WelcomeCard, probabilmente ti serve una connessione per prodotto.
Le mappature si aggiornano solo quando salvi di nuovo la connessione.
Il riscatto non può essere differito all'ingresso o al no-show.
Nessun pick-up, extra, domanda personalizzata o risorsa.
I risultati della ricerca restano in cache per 5 minuti. Se Berlin WelcomeCard non risponde entro circa 12 secondi, il codice viene considerato non trovato.

Risoluzione dei problemi

"%{title} is not mapped in %{connection}"

La variante del biglietto non ha un prodotto, un'opzione e un'unità Ventrata mappati. Mappa la riga della variante sulla connessione, poi esegui di nuovo la scansione.

"Redemption not allowed"