Vai al contenuto principale

FareHarbor: backend operatore

Collega FareHarbor a Ventrata per rivendere i prodotti degli operatori FareHarbor con disponibilità, prezzi e prenotazioni in tempo reale. Usato da oltre 20.000 aziende.

FareHarbor logo

 

FareHarbor, parte di Booking Holdings, è una piattaforma di prenotazione e gestione aziendale usata da oltre 20.000 aziende di tour, attività, noleggi e attrazioni, con la maggiore diffusione tra gli operatori di piccole e medie dimensioni in Nord America ed Europa. Il suo prodotto comprende vendite online e di persona, gestione dell'inventario, pagamenti, eventi privati, reportistica, pianificazione del personale, un'app mobile e programmi partner per affiliati e API.

 

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

 

Per saperne di più su FareHarbor, visita fareharbor.com.

 

📒 NOTA

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

 

‼️ IMPORTANTE

FareHarbor addebita a te, distributore o rivenditore, delle commissioni per l'uso di questa connessione. Per i dettagli, contatta direttamente FareHarbor. Ventrata non addebita alcuna commissione aggiuntiva per questa connessione.

 

Sito web principale

Tag

Booking / Ticketing System

Funzionalità della connessione

Availability Sync · Pricing Sync · Bookings Sync

Sviluppato da

Ventrata (tramite FareHarbor External API)

 

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

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

  • Pricing Sync – i prezzi al pubblico e netti arrivano da FareHarbor, oppure imposti tu i prezzi in Ventrata.

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

 

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

🔐 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 un accordo di distribuzione con FareHarbor e la tua User Key di FareHarbor. Consulta il passaggio 1.

  • 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: registrati come distributore FareHarbor

Se non ti sei mai collegato a un operatore FareHarbor, invia un'email a [email protected] mettendo in copia [email protected] e [email protected] per richiedere un accordo di distribuzione. Includi:. Indica che sei un utente Ventrata.

  • Nome commerciale, partita IVA e indirizzo della tua azienda

  • Nome completo, indirizzo email e qualifica della persona che firma

  • Gli operatori FareHarbor con cui vuoi collegarti

  • Le pagine del tuo sito web in cui prevedi di vendere i loro prodotti (se applicabile)

  • Che sei un utente Ventrata

 

Una volta stipulato l'accordo, [email protected] o [email protected] ti invia la tua User Key di FareHarbor. Se ti sei già collegato in passato a operatori FareHarbor, ne hai già una.

 

Passaggio 2: configurare l'operatore in 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 FareHarbor e inserisci la chiave. Lascia il campo dell'endpoint con il valore predefinito, a meno che l'operatore non ti indichi diversamente.

  3. Press 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 FareHarbor e Backend Pricing per usare i prezzi di FareHarbor.

  3. Press Update Product.

📒 NOTA

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

 

Mappare i prodotti su FareHarbor

‼️ IMPORTANTE

La mappatura indica a Ventrata per quali prodotto, opzione e unità di FareHarbor 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 l'item e i tipi di cliente corrispondenti di FareHarbor dai menu a tendina, che Ventrata carica da FareHarbor. Non lasciare nessun campo vuoto.

  4. Press Save Changes.

 

📗 SUGGERIMENTO

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

 

Gestire la connessione con FareHarbor

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

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

 

Funzionalità della connessione in dettaglio

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

 

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

 

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

 

Product Mapping

✅

Mappi ogni prodotto, opzione e unità Ventrata sull'item FareHarbor dell'operatore nella Ventrata Dashboard.

Il funzionamento è il seguente:

  • Company (GET /companies/{shortname}/) – Ventrata legge l'azienda FareHarbor dell'operatore, che verifica regolarmente.

  • Items (GET /companies/{shortname}/items/) – Ventrata legge gli item (prodotti) FareHarbor dell'operatore e i relativi tipi di cliente per compilare i menu a tendina nella scheda Mappings.

 

Cosa significa per te: se nel menu a tendina manca un item o un tipo di cliente, l'operatore non te l'ha reso disponibile in FareHarbor. Chiediglielo.

Availability Sync

✅

Con Backend Availability attivo, Ventrata verifica la disponibilità in tempo reale dell'operatore in FareHarbor.

Il funzionamento è il seguente:

  • Disponibilità per intervallo di date (GET /companies/{shortname}/items/{pk}/minimal/availabilities/date-range/{start}/{end}/) – quando qualcuno usa il calendario della disponibilità in Ventrata, Ventrata interroga FareHarbor in tempo reale per le date visualizzate.

  • Disponibilità per data (GET /companies/{shortname}/items/{pk}/minimal/availabilities/date/{date}/) – Ventrata verifica di nuovo la data scelta subito prima di creare una prenotazione.

 

Di solito con FareHarbor:

  • Le richieste di solito coprono un solo giorno o un intervallo di 7 giorni, da oggi fino a circa un anno in avanti, mentre gli utenti navigano.

 

Cosa significa per te: i clienti prenotano sempre in base alla disponibilità in tempo reale dell'operatore in FareHarbor.

Pricing Sync

✅

Con Backend Pricing attivo, Ventrata prende dalla disponibilità le tariffe FareHarbor dell'operatore, al pubblico e nette.

Il funzionamento è il seguente:

  • Disponibilità – ogni disponibilità di FareHarbor include le tariffe per ciascun tipo di cliente, che Ventrata usa come prezzi del prodotto.

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

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

Bookings Sync

✅ / ❌

Le prenotazioni effettuate in Ventrata vengono create in FareHarbor. FareHarbor non prevede una fase di blocco e le cancellazioni vanno verificate con l'operatore.

Il funzionamento è il seguente:

  1. Blocco: Validate booking (POST /companies/{shortname}/availabilities/{pk}/bookings/validate/) – quando il prodotto viene aggiunto al carrello, Ventrata verifica la prenotazione con FareHarbor. FareHarbor non blocca i posti, quindi Ventrata li blocca dal proprio lato solo mentre il cliente paga.

  2. Conferma: Create booking (POST /companies/{shortname}/availabilities/{pk}/bookings/) – dopo il pagamento, Ventrata convalida di nuovo la prenotazione e la crea nell'account FareHarbor dell'operatore con i dati del cliente. Il riferimento della prenotazione di FareHarbor viene salvato sulla prenotazione Ventrata.

  3. Cancellazione: quando cancelli una prenotazione in Ventrata, verifica anche con l'operatore che sia cancellata in FareHarbor.

 

‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a FareHarbor. Se l'operatore modifica o cancella una prenotazione in FareHarbor, Ventrata non riceve alcuna notifica. Chiedi all'operatore di informarti di eventuali modifiche.

📒 NOTA – Poiché FareHarbor non blocca i posti durante il checkout, una fascia oraria può esaurirsi in FareHarbor mentre il tuo cliente sta pagando. Ventrata verifica di nuovo prima di creare la prenotazione e la interrompe se non c'è più posto.

Content Sync

❌

Ventrata non importa i contenuti dei prodotti da FareHarbor.

Ventrata non importa i contenuti dei prodotti da FareHarbor. Crei e descrivi tu stesso i prodotti in Ventrata.

Promotions Sync

❌

Le promozioni non vengono inviate a FareHarbor.

Le promozioni non vengono inviate a FareHarbor. Le tue promozioni Ventrata si applicano comunque al prezzo che il cliente paga in Ventrata.

Pickups/Dropoff Sync

❌

I dettagli di pickup e drop-off non vengono trasmessi a FareHarbor.

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

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

Extras Sync

❌

Extra e componenti aggiuntivi non vengono prenotati in FareHarbor.

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

Redemption Sync

❌

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

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

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

Le carte regalo Ventrata non vengono trasmesse a FareHarbor.

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

✅ supportato · ✅ / ❌ limitato · ❌ non supportato

 

Buono a sapersi: limiti e dettagli della connessione con FareHarbor

  • Commissioni: FareHarbor addebita ai distributori delle commissioni per questa connessione. Ventrata no.

  • Nessun blocco in FareHarbor: i posti vengono bloccati solo in Ventrata durante il checkout, e Ventrata verifica di nuovo la disponibilità prima della prenotazione.

  • API personalizzata: l'External API di FareHarbor non è OCTO, quindi alcune funzionalità potrebbero essere limitate rispetto ai backend OCTO.

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

 

FAQ

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

Molto probabilmente la tua User Key di FareHarbor non è corretta. Controllala e, 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 mostrano gli item e i tipi di cliente che l'operatore ti ha reso disponibili in FareHarbor. Verifica con l'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 FareHarbor. Se il problema persiste, contatta il nostro supporto tecnico.

 

Risorse utili

 

 

Informazioni sul partner

FareHarbor B.V.

Vijzelstraat 66-80

1017 HL Amsterdam, Netherlands

 

Ventrata Partner ID: 11496205-33a3-470e-9449-13f00f85c8d5

Hai ricevuto la risposta alla tua domanda?