Exchange Code For Tokens (POST /v2/oauth2/authorizations) – Ventrata → Airbnb, una sola volta, quando fai clic su Connect with Airbnb e Allow. Airbnb concede a Ventrata l'accesso per gestire il calendario e le prenotazioni delle tue offerte Airbnb. I token di accesso di Airbnb hanno una durata breve, quindi Ventrata rinnova automaticamente questo accesso in background (Refresh Access Token, stesso percorso).

Get Activities (GET /v2/activities) e List all offerings (GET /v2/activities/{id}/offerings) – Ventrata → Airbnb, quando apri la pagina della connessione. Ventrata legge le tue offerte Airbnb e le mostra a sinistra nella tabella di mappatura.

Set Attributes (PUT /v2/activities/{id}/attributes) – Ventrata → Airbnb, quando fai clic su Update Mapping. Dopo aver letto l'offerta, Ventrata invia i tipi di ospite venduti dalla tua opzione (Adult, Child, Infant), i relativi limiti di età ricavati dalle tue unità Ventrata e l'età minima.

Set Activity Availability (PUT /v2/activities/{id}/availability) – Ventrata → Airbnb, con Update Mapping. Ventrata attiva la sincronizzazione della disponibilità, che rende Ventrata la fonte di riferimento per l'offerta e attiva i controlli in tempo reale di Airbnb prima di ogni prenotazione.

Set Offering (PUT /v2/activities/{id}/offerings/{id}) – Ventrata → Airbnb, con Update Mapping. Ventrata memorizza sull'offering Airbnb gli ID della tua connessione, del prodotto e dell'opzione Ventrata. Airbnb rimanda questi ID con ogni controllo e prenotazione, ed è così che Ventrata sa quale prodotto sta prenotando un ospite.

Set Offering Availability (PUT …/offerings/{id}/availability) e Set Offering Pricing (PUT …/offerings/{id}/pricing) – Ventrata → Airbnb, con Update Mapping. Ventrata imposta i limiti di gruppo validi per tutta l'offerta, l'anticipo di prenotazione e il tipo di prenotazione (ad esempio una prenotazione pubblica condivisa), così sono la capienza che Ventrata invia per ogni fascia oraria e il controllo in tempo reale di Ventrata a decidere cosa si può prenotare.

Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, alla fine di Update Mapping. Ventrata crea le tue fasce orarie nel calendario di Airbnb (vedi Availability Sync).

Aggiornamenti di mappatura in coda – alcuni aggiornamenti di mappatura vengono eseguiti come job in background con gli stessi passaggi. Il job legge il tuo prodotto tramite l'API OCTO di Ventrata con Get Product (GET /products/{productId}).

Le chiamate di mappatura avvengono solo quando qualcuno si collega, apre una pagina di connessione o fa clic su Update Mapping.

I rinnovi dell'accesso e gli aggiornamenti di mappatura in coda vengono eseguiti in background 24 ore su 24.

Get Instances (GET /v2/activities/{id}/instances) e Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, non appena la disponibilità cambia in Ventrata, ad esempio dopo una prenotazione su qualsiasi canale, una cancellazione o una modifica alla capienza o al calendario. Ventrata legge le fasce orarie che Airbnb ha per le date interessate, le confronta con Ventrata e invia in un unico batch solo le differenze: nuove fasce da creare, fasce il cui limite di ospiti (posti rimanenti) o prezzo è cambiato e fasce da rimuovere perché non più disponibili.

API OCTO di Ventrata – per calcolare ogni aggiornamento, l'adattatore di Ventrata legge il tuo prodotto e la disponibilità in tempo reale tramite l'API OCTO di Ventrata: Get Product (GET /products/{productId}) e Availability Check (POST /availability).

Risincronizzazione in background – Ventrata → Airbnb, 24 ore su 24. Un job pianificato scorre le offerte mappate, confronta di nuovo le fasce orarie di Airbnb con Ventrata e corregge quelle disallineate, inviando anche in questo caso solo le differenze. Alcuni aggiornamenti della disponibilità vengono inoltre messi in coda e inviati come job in background.

Check Availability (GET /airbnb/endpoint/reservation) – Airbnb → Ventrata, in tempo reale, prima che un ospite passi al checkout. Airbnb invia l'offerta, gli ID di prodotto e opzione Ventrata memorizzati alla mappatura, l'orario di inizio e il numero di adulti, bambini e neonati. Ventrata cerca il prodotto con Get Product (GET /products/{productId}), controlla in tempo reale quella fascia oraria e quei tipi di ospite e risponde sì o no. Airbnb si aspetta una risposta entro 2 secondi. Se la risposta è no, o il controllo non riesce o richiede troppo tempo, l'ospite non può prenotare e Airbnb rimuove quella fascia oraria dal proprio calendario.

Gli invii della disponibilità avvengono 24 ore su 24, seguendo le prenotazioni e le modifiche che avvengono in Ventrata. Coprono le date da oggi fino a circa un anno avanti, per lo più le prossime settimane.

La risincronizzazione in background viene eseguita 24 ore su 24.

Check Availability arriva in modo uniforme 24 ore su 24, per lo più per date nelle prossime quattro settimane. Airbnb controlla molto più spesso di quanto gli ospiti prenotino, quindi la maggior parte dei controlli non porta a una prenotazione.

Set Offering Pricing (PUT /v2/activities/{id}/offerings/{id}/pricing) – Ventrata → Airbnb, con Update Mapping. Ventrata imposta le impostazioni di prezzo dell'offerta, ad esempio che viene venduta come prenotazione pubblica condivisa.

Set Attributes (PUT /v2/activities/{id}/attributes) – Ventrata → Airbnb, con Update Mapping. Ventrata invia i tuoi tipi di ospite e le fasce d'età, così Adult, Child e Infant di Airbnb corrispondono alle tue unità Ventrata.

Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, con gli aggiornamenti della disponibilità. Quando il prezzo di una fascia oraria deve essere aggiornato, Ventrata invia il prezzo adulto, bambino e neonato per quella fascia, così i prezzi specifici per data e orario in Ventrata arrivano ad Airbnb. I prezzi derivano dai prezzi del rivenditore Airbnb in Ventrata.

Tariffe Booking Size – i conteggi dei livelli partner vengono sincronizzati quando fai clic su Update Mapping. Dopo ogni modifica alle tariffe, aggiorna di nuovo la mappatura del prodotto e assicurati che la tariffa sia abilitata alla vendita tramite Direct API.

I prezzi viaggiano con gli invii della disponibilità, 24 ore su 24. La maggior parte degli invii modifica solo i posti rimanenti; i prezzi vengono inclusi quando il prezzo di una fascia deve essere aggiornato.

Le impostazioni di prezzo valide per tutta l'offerta e i tipi di ospite vengono inviati solo con Update Mapping.

Prenotazioni, modifiche e cancellazioni arrivano 24 ore su 24 e ciascuna viene gestita nel momento in cui avviene.

Ogni nuova prenotazione arriva in Ventrata sia come chiamata Make Reservation sia come webhook. Ventrata le abbina tramite il codice di conferma di Airbnb.

Ogni nuova prenotazione è seguita da un messaggio con i biglietti.

I controlli delle modifiche (Update Reservation) sono rari.

Biglietti – Ventrata → Airbnb, subito dopo ogni prenotazione: il link al biglietto PDF, il link al biglietto wallet e, per alcuni prodotti, le immagini dei codici QR, tutto nei messaggi Airbnb dell'ospite (vedi Bookings Sync). Gli ospiti li mostrano al tuo ingresso e tu li scansioni e riscatti in Ventrata come qualsiasi biglietto Ventrata.

Nessun aggiornamento sui riscatti – Ventrata non invia aggiornamenti ad Airbnb quando un biglietto viene scansionato o riscattato, né quando un ospite non si presenta.

Non rileviamo chiamate che comunichino riscatti o no-show ad Airbnb.