Vai al contenuto principale

TripWorks: backend operatore

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

TripWorks logo

 

TripWorks è una piattaforma di prenotazione per operatori di tour, attività e attrazioni, usata soprattutto negli Stati Uniti per tour aerei e in barca, visite turistiche e tour cittadini, attività d'avventura e all'aperto, attrazioni e luoghi di intrattenimento. Copre scoperta, prenotazione, pagamenti, pianificazione, check-in e analisi, con agenti AI in chat e al telefono che accettano prenotazioni 24 ore su 24 e oltre 50 integrazioni di distribuzione.

 

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

 

Per saperne di più su TripWorks, visita tripworks.com.

 

📒 NOTA

Ogni chiave API ti collega a un solo operatore. Se rivendi più operatori che usano TripWorks, crea in Ventrata un operatore separato per ciascuno, con la propria chiave API.

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di TripWorks richiedere la disponibilità e prenotare. Se i prodotti collegati al backend non sono mappati correttamente, le prenotazioni non andranno a buon fine. Un'evidenziazione rossa sulla riga del prodotto indica un prodotto mappato in modo errato.

📗 SUGGERIMENTO

Dopo la mappatura effettua una prenotazione di test e chiedi al tuo operatore di confermare che compaia in TripWorks.

 

Sito web principale

Tag

Booking / Ticketing System

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

Ventrata (tramite TripWorks OCTO API)

 

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

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

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

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

 

Creare la connessione con TripWorks

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

  • Ogni chiave API ti collega a un solo operatore.

  • 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

Il tuo operatore la richiede a TripWorks per te. TripWorks emette una chiave separata per ogni rapporto tra rivenditore e operatore. Chiedigli di mettere in copia [email protected], così Ventrata può aiutare se necessario.

 

  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 TripWorks e inserisci la OCTO API Key. Lascia l'endpoint predefinito, a meno che TripWorks o il tuo operatore non indichino diversamente.

  3. Quando crei l'operatore, inserisci il nome dell'operatore (ad esempio HeliNY).

  4. Fai clic su Update Operator.

 

 

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

  3. Fai clic su Update Product.

📒 NOTA

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

 

Nella sezione Operator & Backend del prodotto, assegna l'operatore TripWorks, seleziona Backend Connected e lascia selezionato Backend Availability per importare la disponibilità in tempo reale.

 

Facoltativamente, seleziona Backend Pricing per importare i prezzi da TripWorks. Se non lo selezioni, il prodotto usa i prezzi impostati in Ventrata ma invia comunque le prenotazioni a TripWorks.

 

Ripeti per ogni prodotto che rivendi.

 

Mappare i prodotti su TripWorks

‼️ IMPORTANTE

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

  4. Fai clic su Save Changes.

📒 NOTA

I prodotti compaiono con il nome dell'esperienza in TripWorks. Mappa ogni unità Ventrata (ad esempio Adult, Child) sull'unità corrispondente di TripWorks.

 

📗 SUGGERIMENTO

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

 

Gestire la connessione con TripWorks

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

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

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

✅

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

Il funzionamento è il seguente:

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

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da TripWorks.

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

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

  • Con Backend Availability, Ventrata richiede a TripWorks la disponibilità in tempo reale quando un utente consulta le date nella dashboard, nel checkout o in altri canali di vendita.

 

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

Il funzionamento è il seguente:

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

  • Con Backend Pricing, Ventrata importa i prezzi da TripWorks insieme alla disponibilità. I prezzi includono tasse e commissioni dell'operatore, quindi il prezzo mostrato nella disponibilità corrisponde a quello alla conferma. Non è indicato se si tratta di prezzi retail o netti.

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

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

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

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

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

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

La disponibilità viene bloccata in TripWorks quando un prodotto viene aggiunto al carrello e confermata dopo il pagamento, insieme ai dati di contatto del cliente. Le modifiche delle prenotazioni (data, orario, quantità) e le cancellazioni effettuate in Ventrata vengono inviate automaticamente a TripWorks.

 

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

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

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

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in TripWorks.

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

Redemption Sync

❌

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

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

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a TripWorks.

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

✅ supportato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con TripWorks

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

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

  • Voucher/biglietti: TripWorks restituisce un codice QR per la prenotazione e per ogni biglietto, e Ventrata li emette per il tuo cliente. Il codice QR rimanda al portale clienti TripWorks dell'operatore ed è ciò che l'operatore scansiona all'arrivo.

 

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 TripWorks. 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 TripWorks. Se il problema persiste, contatta il nostro supporto tecnico.

Errore durante il salvataggio della configurazione backend dell'operatore.

Probabilmente la OCTO API Key non è corretta o non è ancora attiva. Ricontrollala con il tuo operatore. Se il problema persiste, contatta [email protected].

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

Il menu a tendina mostra solo i prodotti, le opzioni e le unità che l'operatore ti ha reso disponibili in TripWorks. Chiedi al tuo operatore di verificare l'allocazione dal suo lato.

 

Risorse utili

 

 

Informazioni sul partner

TripWorks, Inc.

1 High Street Ct.

Morristown, NJ 07960, United States

 

Ventrata Partner ID: 01a159ec-f15a-73fd-96c5-917ef887269b

Hai ricevuto la risposta alla tua domanda?