Get Mappings (Ventrata → Viator, quando apri la connessione nella Dashboard) – Ventrata accede automaticamente al tuo account Viator e recupera l'elenco di tutti i prodotti e le opzioni dell'account, con il loro stato e le impostazioni di connettività. Ventrata può farlo perché l'hai invitata come tuo sistema di prenotazione nel passaggio 1.

Update Mappings (Ventrata → Viator, quando premi Update Connection Mapping) – Ventrata accede al prodotto corrispondente nel tuo account Viator, verifica le configurazioni di base come le categorie di biglietto, rimuove disponibilità, prezzi e promozioni (offerte speciali/deal) configurati in precedenza e aggiorna la mappatura nelle impostazioni di connettività secondo la tua selezione. Collega l'opzione di Viator scelta alla tua opzione Ventrata e applica l'impostazione di sincronizzazione dei prezzi del prodotto.

Mapping catalog (POST /v2/mappings/catalog) e Mapping connect (POST /v2/mappings/connect) (Ventrata → Viator, circa ogni ora): Ventrata legge i tuoi prodotti e le tue opzioni su Viator con il relativo stato di mappatura (Mapped, Unmapped o Paused) e invia le tue mappature a Viator. Queste sono le API di mappatura dei prodotti di Viator.

Tour List (POST /tourlist) (Viator → Ventrata): Viator recupera l'elenco dei prodotti e delle opzioni disponibili sulla connessione, con i relativi identificativi Ventrata. Viator li mostra nella scheda Product Connection di Viator Management Center, che è l'elenco da cui scegli quando mappi in Viator (metodo 2). Ventrata risponde con Get Products OCTO (GET /products).

Pricing Categories (tramite Calendar, Viator → Ventrata) – inoltre Viator recupera i dettagli sulle unità del tuo prodotto (tipi di biglietto) e sui relativi prezzi, e li aggiorna di conseguenza.

Viator rilegge l'elenco dei tuoi prodotti con Tour List alcune volte al giorno per connessione.

Il controllo delle mappature di Ventrata viene eseguito circa ogni ora. Legge il catalogo di mappatura di Viator circa ogni 30 minuti.

Ventrata legge e scrive i tuoi prodotti di Viator dalla Dashboard solo quando apri o aggiorni la connessione.

Calendar (POST /v2/availability/calendar) (Viator → Ventrata): Viator chiede una o più opzioni di prodotto su un intervallo di date. Ventrata risponde con ogni data o orario di inizio prenotabile, il relativo stato, la capienza residua per tipo di biglietto, il limite di prenotazione e i prezzi. Viator lo usa per popolare il calendario nella pagina del tuo prodotto. Ventrata risponde con Availability Check OCTO (POST /availability).

Availability Check (POST /v2/availability/check) (Viator → Ventrata): quando un cliente sceglie un prodotto, una data e una combinazione di viaggiatori, Viator verifica capienza e prezzo in tempo reale per quella scelta esatta, e di nuovo mentre il cliente procede nel checkout. Ventrata risponde con Availability Check OCTO.

Event Notification (POST https://api.viator.com/v2/notification/events) (Ventrata → Viator, ogni volta che la disponibilità cambia in Ventrata, ad esempio dopo una prenotazione, una cancellazione o una modifica di capienza o tariffa): Ventrata comunica a Viator quali opzioni di prodotto e date sono cambiate, e come: una fascia esaurita o riaperta (AVAILABILITY), una variazione della capienza residua (CAPACITY) o una variazione del prezzo (PRICING). Viator rilegge quindi quelle date. Viator gestisce per primi gli aggiornamenti AVAILABILITY e PRICING.

Verifica al momento della prenotazione – quando un cliente inizia a pagare, la chiamata Reserve di Viator fa sì che Ventrata verifichi di nuovo la capienza prima di bloccare i posti. Così Viator non può prenotare in eccesso una fascia appena esaurita.

Calendar: costante 24 ore su 24, il che indica una sincronizzazione pianificata in background piuttosto che ricerche dei clienti in tempo reale.

Availability Check: 24 ore su 24, più intenso nelle ore di punta degli acquisti, perché segue la navigazione dei clienti.

Event Notification: Ventrata le invia 24 ore su 24, man mano che si verificano modifiche in Ventrata.

Un piccolo numero di prodotti meno recenti usa ancora la chiamata legacy Real-time Availability (v1.0) di Viator.

Non siamo riusciti a misurare quanto in avanti legge Viator con Calendar, perché le date viaggiano nel corpo della richiesta.

Calendar e Availability Check (Viator → Ventrata) – ogni data o orario di inizio viene restituito con un prezzo per tipo di biglietto (ad esempio Adult o Child) nella tua valuta. L'API di Viator supporta prezzi a persona, prezzi a persona a scaglioni e prezzi per unità (ad esempio per auto, barca o gruppo).

Prezzi del rivenditore – i prezzi provengono dai prezzi del rivenditore Viator in Ventrata (al pubblico, all'ingrosso/a commissione), che la connessione eredita. L'API di Viator può anche trasmettere un prezzo netto per tipo di biglietto. Viator lo usa per gli operatori con un accordo a prezzo netto.

Event Notification (PRICING, Ventrata → Viator) – quando il prezzo al pubblico di un tipo di biglietto cambia, comprese nuove offerte speciali o sconti, Ventrata lo comunica a Viator e Viator rilegge il prezzo.

Reserve (Viator → Ventrata) – il blocco mantiene sia il prezzo sia i posti, così il cliente paga il prezzo che gli è stato mostrato.

Categorie di prezzo – Viator supporta infant, child, youth, adult e senior. Usa Traveler quando non ci sono limiti di età. Le categorie devono coprire le età da 0 a 99 anni senza lacune né sovrapposizioni.

I prezzi vengono restituiti con ogni Calendar e Availability Check, quindi Viator li riceve con la stessa frequenza con cui legge la disponibilità.

Calendar e Availability Check (Viator → Ventrata) – quando una promozione si applica a una data, Ventrata restituisce il prezzo al pubblico scontato insieme al prezzo al pubblico originale e all'ID dell'offerta speciale.

Special Offers (POST /v2/product/special-offers) (Viator → Ventrata): Viator chiede i dettagli di quelle offerte, come nome, tipo e date di validità. Ventrata risponde in base alle tue promozioni Ventrata. Viator lo usa per mostrare un'etichetta di offerta speciale nelle date scontate. L'etichetta non modifica il prezzo al pubblico consigliato.

Mappatura dalla Dashboard – quando aggiorni una mappatura, Ventrata rimuove le offerte speciali/deal configurate in precedenza su quel prodotto di Viator, così le tue offerte provengono da Ventrata.

Viator chiama Special Offers 24 ore su 24, solo per i fornitori i cui prodotti hanno promozioni.

Di solito Ventrata non invia chiamate Special Offers Notification. Viator recepisce le offerte tramite Calendar e Special Offers.

Ogni prenotazione inizia con Reserve, poi Booking. I blocchi sono più numerosi delle prenotazioni confermate. È normale: i blocchi dei clienti che non completano il pagamento semplicemente scadono.

Modifiche e cancellazioni arrivano durante tutta la giornata.

Viator ti invia un'email solo quando una prenotazione, una modifica o una cancellazione via API non va a buon fine (procedura di riserva di Viator). Le chiamate API riuscite non generano email.

Redemption (POST /redemption) (Viator → Ventrata): Viator chiede lo stato di riscatto di una prenotazione confermata e di ciascun viaggiatore incluso. Ventrata trova la prenotazione tramite il riferimento con List Bookings OCTO (GET /bookings) e risponde indicando se i biglietti sono stati riscattati. Viator usa la risposta per decidere se consentire una cancellazione o un rimborso.

Viator verifica lo stato di riscatto durante tutta la giornata, molto più spesso di quanto invii cancellazioni.

Ventrata non invia aggiornamenti sui riscatti a Viator di propria iniziativa.

Booking (Viator → Ventrata) – se la casella del pick-up in hotel è attiva per il tuo prodotto su Viator, il cliente sceglie il proprio hotel dal menu a tendina di Viator e Viator lo invia nel campo del punto di pick-up della prenotazione. Se invece raccogli i dettagli del pick-up nel campo dei requisiti speciali di Viator, arrivano lì.

Booking Amendment (Viator → Ventrata) – i dettagli dell'hotel modificati arrivano come modifica.

I dettagli del pick-up arrivano solo con prenotazioni e modifiche. L'API di Viator non ha alcuna chiamata per leggere i tuoi punti di pick-up Ventrata, né un campo separato per il drop-off.

Booking (Viator → Ventrata) – le informazioni che il cliente inserisce durante la procedura di prenotazione di Viator, come i dettagli del volo e della nave da crociera, vengono inviate nei campi domanda e risposta della prenotazione.

Contatto del cliente – Viator non condivide mai l'indirizzo email reale del cliente. Invia il numero di telefono se il cliente lo fornisce.

Le domande vengono configurate dal lato di Viator. L'API di Viator non ha alcuna chiamata per leggere le tue domande di prenotazione Ventrata.