Vai al contenuto principale

Clorian: backend operatore

Collega Clorian a Ventrata per rivendere i prodotti degli operatori Clorian con disponibilità, prezzi e prenotazioni in tempo reale.

Clorian logo

 

Clorian è una piattaforma di biglietteria con sede a Barcellona per musei, monumenti e luoghi culturali, che gestisce vendite online e in loco, capienza con ingressi a orario e controllo accessi per siti come la Sagrada Família, La Pedrera e la Mezquita-Catedral di Córdoba. Dichiara oltre 28 milioni di biglietti venduti ogni anno tramite le sue strutture e una rete di oltre 14.000 rivenditori.

 

Collegare Clorian a Ventrata ti permette di rivendere i prodotti di operatori che usano Clorian come sistema di prenotazione. Ventrata legge da Clorian la loro disponibilità e i loro prezzi in tempo reale e ogni prenotazione che ricevi viene creata direttamente nell'account Clorian dell'operatore.

 

Per saperne di più su Clorian, visita clorian.com.

 

📒 NOTA

Se il tuo inventario di prodotti richiede entrambi i metodi di pagamento (Deferred Payment e Pre-payment), crea due operatori separati in Ventrata per gestire correttamente i pagamenti.

‼️ IMPORTANTE

La mappatura indica a Ventrata per quale prodotto Clorian richiedere la disponibilità. Se i prodotti con Backend Connected non sono mappati correttamente, le prenotazioni del prodotto non andranno a buon fine. Un'evidenziazione rossa sull'intera riga del prodotto indica che il prodotto non è mappato correttamente.

 

Sito web principale

Tag

Booking / Ticketing System

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

Ventrata (tramite Clorian B2B API)

 

Questa connessione operatore (detta anche backend) ti permette di rivendere i prodotti di operatori che usano Clorian come sistema di prenotazione principale, e ogni prenotazione viene creata direttamente in Clorian. Le funzionalità di questa connessione includono:

  • Availability Sync – la disponibilità in tempo reale proviene dall'account Clorian dell'operatore.

  • Pricing Sync – i prezzi arrivano da Clorian, oppure li imposti tu in Ventrata.

  • Bookings Sync – le prenotazioni vengono inviate da Ventrata a Clorian e Clorian emette i biglietti o i voucher.

 

L'API esterna di Clorian 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 Clorian

🔐 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 API Key, Username e Password dell'operatore. Segui i passaggi qui sotto.

  • Un accordo commerciale con l'operatore di cui vuoi rivendere i prodotti tramite Clorian.

  • I prodotti di Clorian ricreati in Ventrata, rispecchiando esattamente la configurazione di Clorian.

  • 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: ottieni le tue credenziali Clorian

Contatta Clorian e richiedi la tua API Key e le tue credenziali di Clorian (Username e Password).

 

  • API Key

  • Username

  • Password

 

Passaggio 2: configurare l'operatore in Ventrata

Contatta Clorian e richiedi la tua API Key, oltre alle tue credenziali di Clorian (Username e Password).

 

  1. Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.

  2. Nella sezione Backend Partner, seleziona Clorian e inserisci API Key, Username e Password.

  3. Nel campo Backend Partner, seleziona Clorian.

  4. Inserisci API Key, Username e Password ricevuti da Clorian (obbligatori).

  5. Facoltativo: scegli il metodo di pagamento per i tuoi prodotti: Deferred Payment (predefinito di Clorian, fatturato in seguito) o Pre-payment (deposito prepagato).

  6. Fai clic su Create Operator.

  7. Press Update Operator.

 

 

 

Passaggio 3: collega ogni prodotto

  1. Apri il prodotto dell'operatore in Products → Products e modificalo. Verifica che Operator sia impostato su questo operatore.

  2. Seleziona Backend Connected. Seleziona Backend Availability per usare la disponibilità di Clorian e Backend Pricing per usare i prezzi di Clorian.

  3. Press Update Product.

📒 NOTA

Clorian invia solo i prezzi al pubblico. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico e calcola il tuo prezzo netto (di costo) usando la percentuale di costo impostata sull'operatore nella Ventrata Dashboard.

 

Sul prodotto, seleziona Backend Connected e lascia selezionato Backend Availability.

 

Seleziona Backend Pricing se vuoi ereditare i prezzi da Clorian.

 

Click Update Product.

 

 

Mappare i prodotti su Clorian

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di Clorian 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.

 

  1. Nella Ventrata Dashboard, vai su Products → Products e apri il prodotto.

  2. Apri la scheda Mappings. Compare dopo che il prodotto è stato impostato come Backend Connected.

  3. Per ogni opzione e unità Ventrata, seleziona dai menu a tendina, che Ventrata carica da Clorian, il prodotto, l'opzione e le unità corrispondenti di Clorian. Non lasciare nessun campo vuoto.

  4. Press Save Changes.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

📗 SUGGERIMENTO

Dopo la mappatura effettua una prenotazione di test e chiedi all'operatore di confermare che sia arrivata nel suo account Clorian.

 

Gestire la connessione con Clorian

  • Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in Clorian.

  • Sostituisci la chiave sull'operatore se Clorian 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 Clorian.

 

Funzionalità della connessione in dettaglio

Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Clorian. Qui la direzione è opposta a quella di una connessione rivenditore: è Ventrata a chiamare Clorian, tramite la Clorian B2B API. Per ogni funzionalità spiega quali chiamate effettua Ventrata, quando e cosa significa per te.

 

In breve: Ventrata chiede a Clorian disponibilità e prezzi ogni volta che qualcuno visualizza un prodotto collegato al backend e crea ogni prenotazione nell'account Clorian dell'operatore. Clorian non rinvia modifiche a Ventrata.

 

Le tempistiche sono quelle tipiche di Clorian, arrotondate, e possono cambiare.

 

Product Mapping

✅

Mappi ogni prodotto, opzione e unità Ventrata al prodotto Clorian dell'operatore nella Ventrata Dashboard.

Il funzionamento è il seguente:

  • Prodotti – Ventrata legge prodotti, opzioni e unità dell'operatore in Clorian per popolare i menu a tendina della scheda Mappings.

  • Percorsi rilevati: GET /v2/clients, GET /v2/products/{n}.

 

Cosa significa per te: se qualcosa manca nel menu a tendina, l'operatore non te l'ha reso disponibile in Clorian. Chiedigli di farlo.

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da Clorian.

Ventrata non importa i contenuti dei prodotti da Clorian. 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 Clorian.

Il funzionamento è il seguente:

  • Disponibilità – quando qualcuno usa il calendario della disponibilità in Ventrata, ad esempio nella Dashboard, nel tuo web checkout o su un terminale, Ventrata interroga Clorian in tempo reale per le date visualizzate.

  • Disponibilità in tempo reale sincronizzata da Clorian.

  • Percorsi rilevati: GET /v2/products/{n}, GET /v2/products/{n}/events.

 

Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in Clorian, quindi non puoi vendere in eccesso una fascia oraria che l'operatore ha già venduto altrove.

Pricing Sync

✅

Con Backend Pricing attivo, Ventrata prende i prezzi da Clorian.

Il funzionamento è il seguente:

  • Prezzi statici sincronizzati da Clorian, esclusi i prezzi promozionali. Vengono ereditati quando Backend Pricing è selezionato sul prodotto.

  • Con Backend Pricing disattivato, il prodotto usa i prezzi che imposti in Ventrata e le prenotazioni vengono comunque inviate a Clorian.

Clorian invia solo i prezzi al pubblico. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico e calcola il tuo prezzo netto (di costo) usando la percentuale di costo impostata sull'operatore nella Ventrata Dashboard.

Promotions Sync

❌

Le promozioni non vengono inviate a Clorian.

Le promozioni non vengono inviate a Clorian. Le tue promozioni Ventrata si applicano comunque al prezzo che il cliente paga in Ventrata.

Non supportati: prodotti con promozioni, incluse le promozioni tramite API.

Bookings Sync

✅

Le prenotazioni effettuate in Ventrata per un prodotto collegato al backend vengono create nell'account Clorian dell'operatore.

Il funzionamento è il seguente:

  1. Blocco e conferma: quando il prodotto viene aggiunto al carrello, Ventrata verifica la prenotazione con Clorian e, dopo il pagamento, crea la prenotazione nell'account Clorian dell'operatore con i dati del cliente.

  2. Biglietti: il riferimento o i biglietti restituiti da Clorian vengono salvati nella prenotazione Ventrata.

  3. Chiamate rilevate: Confirm Booking, Create Booking.

Prenotazioni e cancellazioni vengono inviate da Ventrata a Clorian. Le modifiche delle prenotazioni da Ventrata a Clorian non sono supportate.

 

‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Clorian. Se l'operatore modifica o cancella una prenotazione in Clorian, 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 Clorian.

I dettagli di pickup e drop-off non vengono trasmessi a Clorian. 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 Clorian.

Le risposte alle tue domande di prenotazione non vengono trasmesse a Clorian. Se l'operatore ne ha bisogno, comunicagliele in un altro modo.

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in Clorian.

Extra e componenti aggiuntivi non vengono prenotati in Clorian. Vengono prenotati solo prodotto, opzione e unità principali.

Redemption Sync

❌

I riscatti e le altre modifiche di stato in Clorian non vengono rinviati a Ventrata dopo la conferma di una prenotazione.

I riscatti e le altre modifiche di stato in Clorian non vengono rinviati a Ventrata dopo la conferma di una prenotazione.

Pass Walkup Scanning Sync

❌

La scansione dei pass walk-up non è disponibile con Clorian.

La scansione dei pass walk-up non è disponibile con Clorian.

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a Clorian.

Le carte regalo Ventrata non vengono trasmesse a Clorian. I pagamenti con carta regalo restano in Ventrata.

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Clorian

  • Disponibilità in tempo reale: la disponibilità arriva da Clorian mentre gli utenti navigano.

  • Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in Clorian non arrivano a Ventrata.

  • API personalizzata: l'API di Clorian non è OCTO, quindi alcune funzionalità possono essere limitate rispetto ai backend OCTO.

  • Clorian è una piattaforma di biglietteria per importanti siti e luoghi culturali, che gestisce oltre 32 milioni di biglietti all'anno con una rete di oltre 14.000 distributori.

  • Metodo di pagamento per operatore: Deferred Payment (predefinito di Clorian) o Pre-payment (deposito prepagato).

 

FAQ

Ricevo un errore quando salvo la configurazione del backend dell'operatore.

Molto probabilmente API Key, Username e 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.

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.

I menu a tendina elencano ciò che l'operatore ti ha reso disponibile in Clorian. 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.

Controlla prima la mappatura del prodotto: ogni opzione e unità deve essere mappata. Poi verifica che la fascia oraria sia ancora disponibile in Clorian. Se il problema persiste, contatta il nostro supporto tecnico.

 

Risorse utili

 

 

Informazioni sul partner

Tiqueteo Spain, S.L.

Carrer de Veneçuela, 103, 1, Sant Martí

08019 Barcelona, Spain

 

Ventrata Partner ID: b4dc43c9-5155-4d6c-8861-a73a83fce30d

Hai ricevuto la risposta alla tua domanda?