Vai al contenuto principale

Prague Boats: backend operatore

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

Prague Boats logo

 

Prague Boats è un operatore di crociere fluviali sulla Moldava a Praga, che dal 1993 organizza crociere turistiche, con pranzo e con cena, con una flotta che comprende battelli con tetto in vetro e catamarani completamente elettrici. Si rivolge ai visitatori di Praga per svago e offre a bordo anche noleggi aziendali, conferenze, matrimoni e feste private, oltre a crociere stagionali per l'Avvento, il Natale e il Capodanno.

 

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

 

Per saperne di più su Prague Boats, visita prague-boats.cz.

 

📗 SUGGERIMENTO

Dopo la mappatura effettua una prenotazione di test e chiedi a Prague Boats di confermare che sia arrivata nel suo sistema.

 

Sito web principale

Tag

Custom / Proprietary Operator System

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

Ventrata (tramite Prague Boats OCTO API)

 

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

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

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

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

 

Creare la connessione con Prague Boats

🔐 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 per l'operatore. Vedi i passaggi seguenti.

  • Un accordo commerciale con Prague Boats per rivenderne 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

Contatta Prague Boats e richiedi la OCTO API Key.

 

  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 Prague Boats e inserisci la chiave API OCTO.

  3. Fai clic su Update Operator.

 

 

 

📒 NOTA – Ogni chiave API OCTO ti collega a un solo operatore. Configura ciascun operatore Prague Boats 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 Prague Boats e Backend Pricing per usare i prezzi di Prague Boats.

  3. Fai clic su Update Product.

📒 NOTA

Prague Boats invia sia i prezzi al pubblico sia i prezzi netti. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico come tuo prezzo di vendita e il prezzo netto come tuo prezzo di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

 

Seleziona Backend Availability per recuperare la disponibilità e Backend Pricing per recuperare i prezzi.

 

Senza queste opzioni, il prodotto usa la disponibilità e i prezzi impostati in Ventrata, ma invia comunque le prenotazioni a Prague Boats.

 

 

Mappare i prodotti su Prague Boats

‼️ IMPORTANTE

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

 

Gestire la connessione con Prague Boats

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

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

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

✅

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

Il funzionamento è il seguente:

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

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da Prague Boats.

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

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

  • Sincronizza la disponibilità dal sistema di Prague Boats.

 

Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in Prague Boats, 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 Prague Boats.

Il funzionamento è il seguente:

  • Availability Check con la capability octo/pricing – Ventrata chiede a Prague Boats i prezzi a ogni richiesta di disponibilità.

  • Sincronizza i prezzi dal sistema di Prague Boats.

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

Prague Boats invia sia i prezzi al pubblico sia i prezzi netti. Con Backend Pricing selezionato, Ventrata registra il prezzo al pubblico come tuo prezzo di vendita e il prezzo netto come tuo prezzo di costo, indipendentemente dalla percentuale di costo impostata sull'operatore.

Promotions Sync

❌

Le promozioni non vengono inviate a Prague Boats.

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

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

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

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

Invia prenotazioni, modifiche e cancellazioni da Ventrata a Prague Boats.

 

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

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

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

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in Prague Boats.

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

Redemption Sync

❌

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

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

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a Prague Boats.

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

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con Prague Boats

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

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

 

FAQ

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

Molto probabilmente la OCTO API Key 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 Prague Boats. 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 Prague Boats. 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 Prague Boats. 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

Prague Boats

Nad Vavruskou 696/19

181 00 Prague 8, Czech Republic

 

Ventrata Partner ID: 64caef6d-3295-4558-905a-868e53e1607c

Hai ricevuto la risposta alla tua domanda?