Vai al contenuto principale

Smartvisit: backend operatore

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

Smartvisit logo

 

Smartvisit è una piattaforma di esperienze di destinazione che gestisce configurazione, prezzi, vendita e riscatto dei pass per operatori turistici, strutture ricettive, organizzazioni di marketing territoriale e programmi fedeltà, con team negli Stati Uniti, in Australia, in Europa e nel Golfo. La sua app raggruppa attrazioni, tour, ristorazione e shopping in pass digitali personalizzati con ingresso senza biglietto e percorsi audio autoguidati, riscattati in tempo reale dai visitatori in destinazione.

 

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

 

Per saperne di più su Smartvisit, visita smartvisit.com.

 

📒 NOTA

Vuoi invece che Smartvisit rivenda i tuoi prodotti? Consulta Smartvisit: connessione rivenditore.

 

📗 SUGGERIMENTO

Puoi consentire/escludere prodotti o destinazioni a livello di connessione, in aggiunta alle impostazioni del rivenditore. È utile se hai più connessioni Smartvisit collegate a un unico rivenditore.

📗 SUGGERIMENTO

Smartvisit può accedere a tutti i prodotti abilitati sulla connessione. Puoi anche indicare a Smartvisit gli ID di prodotto e opzione mostrati nella pagina della connessione per specificare cosa mappare.

 

Sito web principale

Tag

Custom / Proprietary Operator System

Funzionalità della connessione

Availability Sync · Bookings Sync

Sviluppato da

Ventrata (tramite Smartvisit OCTO API)

 

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

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

  • Bookings Sync – prenotazioni, modifiche e cancellazioni vengono inviate da Ventrata a Smartvisit e Smartvisit emette i biglietti o i voucher.

 

Creare la connessione con Smartvisit

🔐 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 la chiave API OCTO (mostrata sulla connessione in Ventrata) per l'operatore. Consulta i passaggi qui sotto.

  • Un accordo commerciale con Smartvisit per la vendita dei tuoi prodotti.

  • Un rivenditore (Reseller) Smartvisit creato in Ventrata, con prezzi al pubblico e all'ingrosso/a commissione configurati.

  • 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: crea Smartvisit come rivenditore

Crea Smartvisit come rivenditore (Reseller) in Ventrata con i prezzi al pubblico e all'ingrosso/a commissione configurati correttamente. La connessione eredita la configurazione del rivenditore, come prezzi, destinazioni consentite e prodotti.

 

Passaggio 2: configurare l'operatore in Ventrata

Ventrata la genera quando crei la connessione; la invii via email al tuo referente di Smartvisit perché possa mappare i tuoi prodotti.

 

  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 Smartvisit e inserisci la chiave API OCTO (mostrata sulla connessione in Ventrata).

  3. Fai clic su Update Operator.

 

 

📒 NOTA – Ogni chiave API OCTO (mostrata sulla connessione in Ventrata) ti collega a un solo operatore. Configura separatamente ogni operatore Smartvisit.

 

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 Smartvisit.

  3. Fai clic su Update Product.

 

Mappare i prodotti su Smartvisit

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di Smartvisit 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 Smartvisit, il prodotto, l'opzione e le unità corrispondenti di Smartvisit. 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 Smartvisit.

 

Gestire la connessione con Smartvisit

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

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

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

✅

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

Il funzionamento è il seguente:

  • Get Products (GET /products) – Ventrata legge prodotti, opzioni e unità dell'operatore in Smartvisit 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 Smartvisit. Chiedigli di farlo.

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da Smartvisit.

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

Il funzionamento è il seguente:

  • Availability Check (POST /availability) – quando qualcuno usa il calendario della disponibilità in Ventrata, ad esempio nella Dashboard, nel tuo web checkout o su un terminale, Ventrata interroga Smartvisit in tempo reale per le date visualizzate.

  • Sincronizza in tempo reale con Ventrata disponibilità e prezzi dei tuoi prodotti Smartvisit.

 

Di solito con Smartvisit:

  • Le richieste coprono 7 giorni alla volta, da oggi fino a circa un anno in avanti, mentre gli utenti navigano e mentre Ventrata carica il calendario.

 

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

Pricing Sync

❌

Ventrata non legge i prezzi da Smartvisit.

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

Promotions Sync

❌

Le promozioni non vengono inviate a Smartvisit.

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

Il funzionamento è il seguente:

  1. Blocco: Booking Reservation (POST /bookings) – quando il prodotto viene aggiunto al carrello in Ventrata, Ventrata riserva i posti in Smartvisit.

  2. Conferma: Booking Confirmation (POST /bookings/{uuid}/confirm) – dopo il pagamento, Ventrata conferma la prenotazione in Smartvisit con i dati di contatto del cliente, e il biglietto o voucher restituito da Smartvisit diventa il biglietto o voucher Ventrata.

  3. Modifica: Booking Update (PATCH /bookings/{uuid}) – le modifiche effettuate in Ventrata vengono inviate a Smartvisit.

  4. Cancellazione: Booking Cancellation (POST /bookings/{uuid}/cancel) – le cancellazioni effettuate in Ventrata vengono inviate a Smartvisit.

Riceve in Ventrata prenotazioni, modifiche e cancellazioni da Smartvisit.

 

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

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

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

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in Smartvisit.

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

Redemption Sync

❌

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

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

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a Smartvisit.

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

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Smartvisit

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

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

  • Smartvisit crea pass digitali per città e destinazioni (attrazioni, tour, ristorazione, shopping) in prodotti basati su app, con riscatto senza biglietto e itinerari audio geolocalizzati.

  • Collabora con organizzazioni di marketing territoriale, hotel e programmi fedeltà.

 

FAQ

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

La chiave API OCTO (mostrata sulla connessione in Ventrata) o l'endpoint sono molto probabilmente errati. 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 Smartvisit. 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 Smartvisit. Se il problema persiste, contatta il nostro supporto tecnico.

 

Risorse utili

 

 

Informazioni sul partner

Smartvisit

Suite 202, 99 Alexander Street

Crows Nest, New South Wales 2065, Australia

 

Ventrata Partner ID: bb75947b-a65b-4f1b-af5b-d0a2f55b51b4

Hai ricevuto la risposta alla tua domanda?