Riferimento XML per la disponibilità, le tariffe e l'inventario (ARI)

Questa guida di riferimento sul file XML fornisce esempi di codice e contenuti di riferimento dettagliati per i diversi messaggi, elementi e attributi disponibili per i feed Disponibilità, Tariffe e Inventario (ARI).

ARI è una modalità di invio dei prezzi che controlla tariffe per notte, disponibilità e inventario e fornisce vincoli su come possono essere combinati. ARI offre anche la flessibilità di includere tasse, commissioni e promozioni.

ARI segue i protocolli standard di OpenTravel Alliance (OTA) per alcuni dei principali tipi di messaggi per definire la disponibilità e l'inventario.

Prezzi basati sulla durata del soggiorno

I prezzi LOS-based ti consentono di specificare le tariffe in base alla data di check-in e alla durata del soggiorno, anziché in base alla data del soggiorno. Quando specifichi un elemento <StatusApplicationControl> per i prezzi basati sulla durata del soggiorno, gli attributi @Start e @End indicano un intervallo di date di check-in per le quali si applicano le tariffe per la durata del soggiorno.

Sebbene quando si utilizzano i prezzi basati sulla durata del soggiorno non siano più presenti tariffe per notte, tutte le altre funzionalità ARI (inventario, disponibilità, regole, promozioni e così via) possono comunque essere applicate a queste tariffe e sono specificate a livello di notte. Ciò significa che se i tuoi sistemi sono più in linea con un sistema di prezzi basato sulla durata del soggiorno, puoi comunque sfruttare il ricco set di funzionalità ARI, oltre all'efficienza della larghezza di banda garantita dall'utilizzo degli aggiornamenti notturni di disponibilità e limitazioni.

Punto chiave: ogni proprietà del tuo account deve utilizzare tariffe basate sulla durata del soggiorno o tariffe per data.

Per attivare i prezzi basati sulla durata del soggiorno nel tuo account, contatta il tuo TAM o contattaci.

Punto chiave: devi inviare i quattro tipi di messaggi (transazione, tariffa, inventario e disponibilità) prima che i prezzi siano disponibili. Ti consigliamo di limitare le dimensioni dei messaggi ARI in particolare <OTA_HotelRateAmountNotifRQ> a 5 MB con un limite di 400 file al secondo per la velocità di caricamento. Evita di inviare più informazioni sull'itinerario specifiche per la data che si sovrappongono tra loro entro un intervallo di 3 secondi dall'ultimo messaggio.

ARI utilizza i seguenti messaggi di richiesta:

• Transaction (Property Data). Definisce le informazioni sul tipo e sul pacchetto (piano tariffario).

• OTA_HotelRateAmountNotifRQ. Definisce gli importi delle tariffe di occupazione in base alla data o alla durata del soggiorno per prodotto (combinazione di tipo di camera e piano tariffario) per intervalli di date specifici.

• OTA_HotelAvailNotifRQ. Definisce la disponibilità e le limitazioni in base al tipo di camera e ai piani tariffari. Puoi aggiornare anche l'inventario utilizzando questo messaggio, ma è preferibile utilizzare OTA_HotelInvCountNotifRQ.

• OTA_HotelInvCountNotifRQ. Definisce l'inventario delle camere fisiche o il numero di camere disponibili per la vendita.

• TaxFeeInfo. (Facoltativo) Definisce tasse e commissioni per ogni proprietà. Questo messaggio non è necessario se AmountAfterTax è specificato nel messaggio OTA_HotelRateAmountNotifRQ.

• Promotions. (Facoltativo) Definisce le tariffe promozionali per determinate prenotazioni, soggiorni e utenti.

• RateModifications. (Facoltativo) Definisce le regole di modifica delle tariffe per determinate prenotazioni, soggiorni e utenti.

• ExtraGuestCharges. (Facoltativo) Definisce come devono essere configurate le tariffe per bambini e adulti aggiuntivi.

Ogni messaggio contiene un sottoinsieme di informazioni che Google utilizza per calcolare disponibilità e prezzi mostrati agli utenti quando cercano le tue proprietà con date di check-in e check-out specifiche e occupazione.

Punto chiave: le funzionalità di ARI sono limitate ai messaggi e agli elementi descritti in questa Pagina di riferimento sul file XML (ARI) relativo a prezzi e inventario, oltre che nella Guida di ARI. Tutti i messaggi, gli elementi o gli attributi OTA non documentati in maniera specifica non sono supportati nella nostra implementazione del feed ARI.

Inoltre, gli altri elementi del messaggio Transaction che non sono inclusi in questa Pagina di riferimento sul file XML (ARI) relativo a prezzi e inventario non sono supportati con il tipo di feed ARI.

Google continua ad aggiornare e migliorare l'API. Se nel tuo sistema utilizzi altre funzionalità relative ai prezzi, comunica al tuo Technology Account Manager(TAM) che possono essere assegnate priorità a queste funzionalità o ti farà sapere se sono previste per una release.

Cronologia delle revisioni del Riferimento XML per ARI

La tabella riportata di seguito elenca solo gli aggiornamenti della documentazione relativi alle modifiche delle funzionalità.

Data	Modifiche
14 agosto 2020	Release iniziale.
21 ottobre 2020	Aggiunto il tipo di messaggio Promozioni.
17 novembre 2020	Per i messaggi Transaction (Property Data), aggiornato l'endpoint e aggiunto l'attributo action per gli elementi PropertyDataSet.
24 novembre 2020	Per i messaggi Transaction (Property Data), aggiunti gli elementi <AllowablePackageIDs> e <AllowableRoomIDs>.
4 febbraio 2021	Aggiunti i messaggi di risposta.
25 febbraio 2021	OTA_HotelInvCountNotifRQ aggiunti.
21 ottobre 2020	Aggiunto il tipo di messaggio Modifiche alle tariffe.