Vai al contenuto principale

Hellenic Heritage: backend operatore

Collega Hellenic Heritage a Ventrata per rivendere i prodotti degli operatori Hellenic Heritage con disponibilità e prenotazioni in tempo reale.

Hellenic Heritage logo

 

Hellenic Heritage Tickets è la piattaforma di biglietteria ufficiale del Ministero della Cultura ellenico e di ODAP, che copre una rete di oltre 350 siti archeologici, musei e monumenti in tutta la Grecia, tra cui venti siti Patrimonio dell'Umanità UNESCO. Il suo biglietto elettronico unificato riunisce 108 siti in un unico sistema, con ingresso a orario, accesso tramite QR da dispositivo mobile e pass regionali e tematici.

 

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

 

Per saperne di più su Hellenic Heritage, visita tickets.hh.gr.

 

📗 SUGGERIMENTO

Dopo la mappatura effettua una prenotazione di test e chiedi a Hellenic Heritage Tickets di confermare che sia arrivata nel suo sistema.

 

Sito web principale

Tag

Booking / Ticketing System

Funzionalità della connessione

Availability Sync · Bookings Sync

Sviluppato da

Ventrata (tramite Hellenic Heritage Tickets API)

 

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

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

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

 

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

🔐 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 le credenziali API di Hellenic Heritage Tickets (l'articolo non specifica i singoli campi) 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: richiedere le credenziali API

Contatta Hellenic Heritage Tickets e richiedi le credenziali API per rivenderne i prodotti tramite Ventrata.

 

Passaggio 2: configurare l'operatore in Ventrata

Contatta Hellenic Heritage Tickets e richiedi le credenziali API per poterne rivendere i prodotti tramite Ventrata.

 

  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 Hellenic Heritage e inserisci le credenziali API di Hellenic Heritage Tickets (l'articolo non specifica i singoli campi).

  3. Fai clic su 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 Hellenic Heritage.

  3. Fai clic su Update Product.

 

Assicurati che l'Operator del prodotto sia impostato su Hellenic Heritage Tickets.

 

Seleziona Backend Connected. Per recuperare la disponibilità da Hellenic Heritage Tickets, seleziona anche Backend Availability; per recuperare i prezzi, seleziona Backend Pricing.

 

Senza Backend Availability e Backend Pricing, il prodotto usa la disponibilità e i prezzi configurati in Ventrata, ma invia comunque le prenotazioni a Hellenic Heritage Tickets.

 

 

Mappare i prodotti su Hellenic Heritage

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di Hellenic Heritage 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 Hellenic Heritage, il prodotto, l'opzione e le unità corrispondenti di Hellenic Heritage. Non lasciare nessun campo vuoto.

  4. Fai clic su Save Changes.

 

📗 SUGGERIMENTO

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

 

Gestire la connessione con Hellenic Heritage

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

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

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

✅

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

Il funzionamento è il seguente:

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

 

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

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da Hellenic Heritage.

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

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 Hellenic Heritage in tempo reale per le date visualizzate.

  • Sincronizza la disponibilità da Hellenic Heritage Tickets quando Backend Availability è selezionato.

 

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

Pricing Sync

❌

Ventrata non legge i prezzi da Hellenic Heritage.

Ventrata non legge i prezzi da Hellenic Heritage. I prodotti usano i prezzi che imposti in Ventrata e le prenotazioni vengono comunque inviate a Hellenic Heritage.

Promotions Sync

❌

Le promozioni non vengono inviate a Hellenic Heritage.

Le promozioni non vengono inviate a Hellenic Heritage. 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 Hellenic Heritage dell'operatore.

Il funzionamento è il seguente:

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

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

Invia prenotazioni, modifiche e cancellazioni da Ventrata a Hellenic Heritage Tickets.

 

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

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

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

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in Hellenic Heritage.

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

Redemption Sync

❌

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

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

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a Hellenic Heritage.

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

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Hellenic Heritage

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

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

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

  • La connessione non crea automaticamente i prodotti: ricreali prima in Ventrata.

  • Informazioni sul partner (dall'introduzione dell'articolo): piattaforma di biglietteria ufficiale del Ministero della Cultura ellenico e di ODAP, che copre oltre 350 siti archeologici, musei e monumenti, tra cui venti siti Patrimonio dell'Umanità UNESCO. L'introduzione di un biglietto elettronico unificato nel 2026 ha riunito 108 siti in un unico sistema, con ingresso a orario, accesso tramite QR da dispositivo mobile e pass regionali e tematici.

 

FAQ

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

Molto probabilmente le credenziali API di Hellenic Heritage Tickets (l'articolo non specifica i singoli campi) 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 Hellenic Heritage. 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 Hellenic Heritage. Se il problema persiste, contatta il nostro supporto tecnico.

Ricevo un errore durante il salvataggio della configurazione del backend dell'operatore.

Molto probabilmente le credenziali non sono corrette. Verificale con Hellenic Heritage Tickets. Se il problema persiste, contatta il supporto tecnico.

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

 

 

Informazioni sul partner

Hellenic Heritage Tickets

Eleftheriou Venizelou 57

105 64 Athens, Greece

 

Ventrata Partner ID: 086db963-6786-4ca6-b86f-e01408d945c4

Hai ricevuto la risposta alla tua domanda?