Vai al contenuto principale

Reservotron: backend operatore

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

Reservotron logo

 

Reservotron è una piattaforma di prenotazione del Québec per aziende turistiche che combinano alloggio, attività e noleggio di attrezzature in un'unica attività, con vendita in francese e inglese. È pensata per operatori con un inventario dettagliato distribuito su più strutture e canali di vendita, con prenotazioni online e di persona, email automatiche agli ospiti e anagrafiche clienti, e collega l'inventario degli alloggi alle OTA alberghiere tramite un channel manager.

 

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

 

Per saperne di più su Reservotron, visita reservotron.com.

 

Sito web principale

Tag

Booking / Ticketing System

Funzionalità della connessione

Availability Sync · Bookings Sync

Sviluppato da

Ventrata (tramite Reservotron OCTO API)

 

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

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

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

 

Creare la connessione con Reservotron

🔐 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 OCTO API Key e l'OCTO Endpoint dell'operatore. Segui i passaggi qui sotto.

  • L'azienda di cui vuoi rivendere i prodotti è creata come operatore in Ventrata.

  • I prodotti dell'operatore sono creati in Ventrata. La connessione sincronizza disponibilità, prezzi e prenotazioni, ma non crea i prodotti.

  • 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: configurare l'operatore in Ventrata

Chiedi entrambi all'operatore che usa Reservotron. L'operatore può contattare il team di Reservotron per ricevere aiuto nell'ottenerli.

 

  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 Reservotron e inserisci la OCTO API Key and OCTO Endpoint. Reservotron fornisce un endpoint univoco per ogni operatore, nel formato https://reservotron.com/octo/api/v1/.

  3. Scegli Reservotron nella sezione Backend Partner dell'operatore.

  4. Inserisci la OCTO API Key e l'OCTO Endpoint, poi fai clic su Update Operator.

  5. Press Update Operator.

 

 

 

📒 NOTA – Ogni chiave API OCTO e ogni OCTO Endpoint ti collegano a un solo operatore. Configura ciascun operatore Reservotron separatamente.

 

Passaggio 2: 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 Reservotron.

  3. Press Update Product.

📒 NOTA

Quando usi Backend Pricing, i prezzi netti (all'ingrosso) restituiti da Reservotron vengono registrati come tuo prezzo di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

 

Imposta come Operator del prodotto l'operatore con il backend Reservotron, seleziona Backend Connected, poi Backend Availability e/o Backend Pricing. Senza di essi, il prodotto usa la disponibilità/i prezzi impostati in Ventrata, ma invia comunque le prenotazioni a Reservotron.

 

Seleziona Backend Connected per questo prodotto per usare la connessione API (backend). Per recuperare la disponibilità da Reservotron, assicurati che Backend Availability sia selezionato; per recuperare i prezzi, seleziona Backend Pricing. Se non selezioni Backend Availability e/o Backend Pricing, il prodotto userà la disponibilità e/o i prezzi configurati in Ventrata, ma invierà comunque le prenotazioni a Reservotron. Fai clic su Update Product per salvare.

 

Mappare i prodotti su Reservotron

‼️ IMPORTANTE

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

  4. Press Save Changes.

 

La pagina del prodotto mostrerà ora una scheda Mappings. Apri questa scheda e mappa il tuo prodotto, le opzioni e le unità Ventrata selezionando i prodotti, le opzioni e le unità corrispondenti dai menu a tendina ricevuti da Reservotron. Assicurati che nessun campo resti vuoto (non mappato) e 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 Reservotron.

 

Gestire la connessione con Reservotron

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

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

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

✅

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

Il funzionamento è il seguente:

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

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da Reservotron.

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

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

  • Con Backend Availability attivo, Ventrata invia una richiesta di disponibilità OCTO in tempo reale a Reservotron quando un utente interagisce con il calendario (dashboard, web checkout, terminale, ecc.), di solito per intervalli di 7 giorni o per un giorno specifico. Prima che l'utente interagisca, il calendario può mostrare dati in cache (non in tempo reale) della richiesta precedente.

 

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

Pricing Sync

❌

Ventrata non legge i prezzi da Reservotron.

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

Quando usi Backend Pricing, i prezzi netti (all'ingrosso) restituiti da Reservotron vengono registrati come tuo prezzo di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

Promotions Sync

❌

Le promozioni non vengono inviate a Reservotron.

Le promozioni non vengono inviate a Reservotron. 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 Reservotron 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 Reservotron.

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

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

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

Prenotazioni, modifiche e cancellazioni per i prodotti Backend Connected vengono inviate automaticamente a Reservotron: blocco quando il prodotto viene aggiunto al carrello, conferma dopo il pagamento (con i dati di contatto del cliente), aggiornamento quando una prenotazione cambia, cancellazione quando una prenotazione viene cancellata. Il voucher/biglietto di Reservotron viene acquisito in Ventrata, tranne PDF_FILE, che Ventrata non supporta.

 

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

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

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

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in Reservotron.

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

Redemption Sync

❌

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

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

Non supportato. Lo stato della prenotazione in Reservotron (ad esempio Redeemed) non viene comunicato a Ventrata dopo la conferma.

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a Reservotron.

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

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Reservotron

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

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

  • Reservotron è un software di prenotazione online per il turismo, sviluppato e gestito da Code Génome, diffuso tra gli operatori del Québec, in Canada.

 

FAQ

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

Molto probabilmente la OCTO API Key e l'OCTO Endpoint 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 Reservotron. 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 Reservotron. Se il problema persiste, contatta il nostro supporto tecnico.

Errore durante l'aggiornamento dell'operatore per salvare la configurazione del backend.

Probabilmente la OCTO API Key o l'OCTO Endpoint non sono corretti. Ricontrolla questi dati con il tuo operatore. Se il problema persiste, contatta l'assistenza Ventrata.

Il prodotto/l'opzione/l'unità che voglio mappare non è nel menu a tendina.

Il menu a tendina viene recuperato da Reservotron in base a prodotti, opzioni e unità che l'operatore ti ha reso disponibili. Verifica questi dettagli con il tuo operatore. Se il problema persiste, contatta il supporto Ventrata.

 

Risorse utili

 

 

Informazioni sul partner

Code Genome Inc. d/b/a Reservotron

400 Av. Atlantic #205

Outremont, QC H2V 1A5, Canada

 

Ventrata Partner ID: 946d0506-4ab3-4fa9-a701-06e85519f7a2

Hai ricevuto la risposta alla tua domanda?