Get Mappings (tramite l'API GraphQL del Supplier Portal di GetYourGuide) – quando apri la connessione o fai clic su Refresh Mapping, Ventrata accede al tuo account GetYourGuide come utente Operations che hai aggiunto nel passaggio 2 e legge tutti i tuoi prodotti e le tue opzioni su GetYourGuide, con il relativo stato attuale e le impostazioni di connettività. GetYourGuide non pubblica documentazione per questa API; il link mostra il concetto equivalente di mappatura self-service nell'API OCTO di Ventrata.

Update Mappings (tramite l'API GraphQL del Supplier Portal di GetYourGuide) – quando premi Update Connection Mapping, Ventrata apre il prodotto corrispondente nel tuo account GetYourGuide. Verifica le impostazioni di base (come le categorie di biglietto), cancella disponibilità, prezzi e promozioni esistenti e scrive la mappatura nelle impostazioni di connettività dell'opzione. Disattiva inoltre gli add-on per l'opzione e sincronizza subito i tuoi deal per quel prodotto (vedi Promotions Sync).

Product Details (GET /1/products/{productId}) – quando viene inserito un External Product ID per il primo prodotto che mappi, GetYourGuide chiede a Ventrata i suoi dettagli di base, incluso il tuo Ventrata API Supplier ID (= Connection ID/Key).

Products List (GET /1/suppliers/{supplierId}/products/) – usando questo ID, GetYourGuide recupera l'elenco dei prodotti disponibili sulla connessione, con i relativi External Product ID, e li mostra in un menu a tendina per facilitare la mappatura degli altri prodotti. Ventrata crea l'elenco con Get Products OCTO (GET /products), quindi contiene solo i prodotti abilitati sulla connessione.

Pricing Categories (GET /1/products/{productId}/pricing-categories/) – GetYourGuide importa le unità del tuo prodotto come sue categorie di prezzo. Ventrata le legge con Get Product OCTO (GET /products/{productId}).

Availability Query (GET /1/get-availabilities/) – GetYourGuide verifica che ci siano almeno 2 fasce orarie o giorni disponibili nei prossimi 365 giorni, che le categorie di prezzo (unità) restituite corrispondano a quelle configurate o importate su GetYourGuide e che i prezzi siano validi (ad esempio, nessuna incongruenza di valuta).

Reservation (POST /1/reserve/) – GetYourGuide effettua alcune prenotazioni di test (prenotazioni in sospeso), di solito per il numero minimo e massimo di partecipanti consentiti per ogni categoria di prezzo (tipo di unità).

Reservation Cancellation (POST /1/cancel-reservation/) – GetYourGuide poi cancella (rilascia) queste prenotazioni di test.

Le chiamate di mappatura avvengono solo quando qualcuno apre o modifica una connessione, quindi arrivano a brevi raffiche e non secondo una pianificazione.

Ventrata accede al tuo account GetYourGuide (inclusa la verifica in due passaggi di GetYourGuide) ogni volta che legge o salva le tue mappature.

GetYourGuide chiama Product Details, Products List e Pricing Categories solo mentre qualcuno sta mappando nel suo Supplier Portal.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata) – GetYourGuide chiede un prodotto e un intervallo di date. Ventrata risponde con ogni giorno o fascia oraria disponibile, i posti residui, il limite di prenotazione e i prezzi, e GetYourGuide li memorizza (cache) nel proprio sistema. Dietro le quinte, l'adattatore cerca la tua mappatura e chiama Availability Check OCTO (POST /availability). GetYourGuide risincronizza con una frequenza predefinita, che può variare in base a molti fattori:

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide) – quando la tua disponibilità cambia per nuove prenotazioni in Ventrata o per modifiche specifiche di data/ora (non modifiche in blocco), Ventrata invia a GetYourGuide i posti (e i prezzi) aggiornati per quella fascia oraria. Ventrata invia subito l'aggiornamento per le fasce che iniziano nei prossimi 90 giorni con 10 posti o meno rimasti, incluse quelle esaurite. Le altre modifiche arrivano a GetYourGuide alla successiva sincronizzazione pianificata.

Reservation (POST /1/reserve/, GetYourGuide → Ventrata) – quando un cliente aggiunge il tuo prodotto al carrello su GetYourGuide, Ventrata verifica di nuovo che resti capienza sufficiente e, in caso contrario, rifiuta la prenotazione. Così GetYourGuide non può prenotare in eccesso una fascia, anche se la sua disponibilità in cache non è perfettamente aggiornata.

Availability Query: 24 ore su 24 e abbastanza costante, con lievi picchi diurni. In media ogni prodotto mappato viene controllato ogni pochi minuti.

Circa metà delle richieste riguarda date entro il mese successivo. Le altre si spingono più avanti, fino a quasi un anno.

La maggior parte delle richieste riguarda un solo giorno; le richieste più lunghe coprono di solito circa una settimana.

Le date richieste includono uno scostamento di fuso orario, quindi il fuso orario del tuo prodotto è importante.

Notify Availability Update: inviato 24 ore su 24, pochi istanti dopo la modifica che lo ha attivato. Gli invii arrivano a raffiche che seguono l'attività di prenotazione e le tue modifiche.

Pricing Categories (GET /1/products/{productId}/pricing-categories/, GetYourGuide → Ventrata) – durante la mappatura, GetYourGuide recupera i dettagli delle unità del tuo prodotto e li aggiorna (importa) come sue categorie di prezzo.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata) – GetYourGuide chiama regolarmente Ventrata per risincronizzare il prezzo al pubblico di ogni categoria di biglietto e lo memorizza in cache, con la stessa pianificazione della disponibilità. I prezzi provengono dai prezzi del rivenditore GetYourGuide in Ventrata, tramite l'Availability Check OCTO.

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide) – quando la tua disponibilità cambia per nuove prenotazioni in Ventrata, tariffe o modifiche specifiche di data/ora (non modifiche in blocco), Ventrata invia a GetYourGuide i prezzi al pubblico aggiornati.

Booking (POST /1/book/, GetYourGuide → Ventrata) – ogni prenotazione riporta il prezzo al pubblico usato da GetYourGuide.

Tariffe Booking Size – Ventrata e GetYourGuide calcolano in modo diverso le strutture a scaglioni con più unità, quindi solo un'unità mappata per prodotto può usare prezzi dinamici a scaglioni. Eventuali tariffe aggiuntive restano consentite e funzionano, ma con prezzi statici. Ecco un esempio in cui l'unità Adult ha i prezzi a scaglioni attivi, mentre le unità Child e Infant restano statiche:

Non esiste una chiamata separata per i prezzi: i prezzi viaggiano con ogni risposta di disponibilità e ogni invio.

GetYourGuide chiama Pricing Categories solo mentre un prodotto viene mappato.

List Deals (GET /1/deals), Delete a deal (DELETE /1/deals/{dealId}) e Create a Deal (POST /1/deals), Ventrata → GetYourGuide: per i prodotti che mappi dalla Ventrata Dashboard (non dal portale di GetYourGuide), Ventrata legge le tue offerte speciali su GetYourGuide e verifica che corrispondano alle promozioni pubbliche consentite per il tuo rivenditore GetYourGuide. Lo fa ogni 60 minuti. Se qualcosa non corrisponde, Ventrata elimina tutte le offerte speciali e le ricrea in base alla Ventrata Dashboard. GetYourGuide non ha una chiamata per modificare un deal, quindi ogni modifica è un'eliminazione più un nuovo deal.

Quando salvi una mappatura nella Ventrata Dashboard, Ventrata sincronizza subito anche i deal di quel prodotto.

Al momento GetYourGuide supporta solo promozioni pubbliche di base applicabili a tutte le unità con configurazione pro rata. Le altre promozioni non vengono sincronizzate.

Il controllo dei deal viene eseguito 24 ore su 24, a cicli orari, e subito dopo le modifiche alle mappature.

Eliminazioni e ricreazioni sono frequenti, perché qualsiasi differenza ricostruisce i deal del prodotto.

Starts at

Ends at

Days Before

Notice Days

Redeemable Day

Tutte e quattro le chiamate arrivano 24 ore su 24, mentre i clienti acquistano, con picchi diurni.

I blocchi sono più numerosi delle prenotazioni. È normale: GetYourGuide rilascia subito quasi tutti i blocchi che non diventano prenotazioni, invece di lasciarli scadere.

Ogni modifica di prenotazione compare in Ventrata come una nuova prenotazione più una cancellata con lo stesso riferimento.

Se una chiamata di prenotazione non va a buon fine o va in timeout, GetYourGuide la ritenta fino a 10 volte, ogni 10 minuti (vedi i nuovi tentativi di prenotazione di GetYourGuide), quindi occasionalmente una prenotazione può arrivare poco dopo il pagamento del cliente.

Ticket Redemption by Booking Reference (POST /1/redeem-booking, Ventrata → GetYourGuide) – non appena uno qualsiasi dei biglietti di una prenotazione viene riscattato (anche se la prenotazione è riscattata solo in parte), Ventrata invia a GetYourGuide una notifica di riscatto della prenotazione. Questo può aiutare a evitare cancellazioni e rimborsi di prenotazioni riscattate. Tuttavia, attualmente è noto che GetYourGuide cancella le prenotazioni indipendentemente dalla notifica ricevuta.

Ventrata comunica i riscatti per prenotazione. La chiamata di riscatto per singolo biglietto di GetYourGuide non viene usata.

Ventrata controlla ogni aggiornamento di una prenotazione di GetYourGuide e invia una notifica solo quando l'aggiornamento include un riscatto.

Le notifiche seguono le tue scansioni: partono 24 ore su 24, ma soprattutto durante il giorno, quando arrivano gli ospiti.

Crea un elenco di luoghi di pick-up per ciascuno dei tuoi prodotti/opzioni nel Supplier Portal di GetYourGuide. Al momento GetYourGuide non può recuperarli da Ventrata, quindi li gestisci manualmente nel suo portale.

Booking (POST /1/book/, GetYourGuide → Ventrata) – se applicabile al tuo prodotto, GetYourGuide invia a Ventrata il luogo di pick-up (l'hotel del viaggiatore) con la richiesta di conferma della prenotazione. Usando la Google Maps Places API, Ventrata lo abbina al punto di pick-up più vicino che offri e salva anche la posizione esatta nel campo Hotel della prenotazione.

I dettagli del pick-up arrivano solo con la chiamata Booking. GetYourGuide non chiede mai a Ventrata i tuoi punti di pick-up.

Mappatura nel portale di GetYourGuide: quando configuri o mappi un prodotto nel portale di GetYourGuide, imposta l'opzione Allow Add-ons su No. Impostandola su Yes, GetYourGuide richiede all'API i dati degli add-on (Fetch Addons, GET /1/products/{productId}/addons/), che Ventrata rifiuta, causando errori di connessione.

Mappatura nella Ventrata Dashboard: i prodotti mappati direttamente dalla Ventrata Dashboard hanno automaticamente gli add-on disattivati durante la configurazione.