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

Questa guida di riferimento XML fornisce esempi di codice e contenuti di riferimento dettagliati per i diversi messaggi, elementi e attributi disponibili per i feed ARI (disponibilità, tariffe e inventario).

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

Il feed 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 lunghezza del soggiorno

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

Sebbene quando utilizzi i prezzi basati sulla lunghezza del soggiorno non siano più presenti tariffe per notte, tutte le altre funzionalità del feed 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ù allineati con un sistema di prezzi basato sulla lunghezza del soggiorno, puoi comunque sfruttare il set avanzato di funzionalità ARI, oltre all'efficienza della larghezza di banda garantita utilizzando la disponibilità notturna e gli aggiornamenti delle limitazioni.

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

Per attivare i prezzi basati sulla lunghezza del soggiorno sul tuo account, rivolgiti al tuo TAM o contattaci.

Punto chiave: devi inviare i quattro tipi di messaggi (transazione, tariffa, inventario e disponibilità) prima che i prezzi diventino disponibili. Ti consigliamo di scegliere le dimensioni specifiche dei messaggi ARI da <OTA_HotelRateAmountNotifRQ> a 5 MB con un limite di 400 file al secondo per la frequenza di caricamento.

Il feed ARI utilizza i seguenti messaggi di richiesta:

• Transaction (Dati proprietà). Definisce il tipo e le informazioni del pacchetto (piano tariffario).

• OTA_HotelRateAmountNotifRQ. Definisce gli importi della tariffa di presenza in base alla data o alla lunghezza del soggiorno per prodotto (combinazione di tipo di camera e piano tariffario) per intervalli di date specifici.

• OTA_HotelAvailNotifRQ. Definisce disponibilità e limitazioni in base al tipo di camera e ai piani tariffari. L'inventario può essere aggiornato anche tramite questo messaggio, ma è preferibile utilizzare OTA_HotelInvCountNotifRQ.

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

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

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

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

• ExtraGuestCharges. (Facoltativo) Definisce come configurare le tariffe per i bambini e gli adulti aggiuntivi.

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

Punto chiave: le funzionalità ARI sono limitate ai messaggi e agli elementi descritti nel riferimento XML per inventario e prezzi (ARI) e nella guida ARI. Qualsiasi messaggio, elemento o attributo OTA non specificamente documentato qui non è supportato nella nostra implementazione ARI.

Inoltre, quando si utilizza il tipo di feed ARI non sono supportati altri elementi del messaggio Transaction non contemplati in questo riferimento XML per l'inventario e i prezzi (ARI).

Google continua ad aggiornare e migliorare l'API. Se utilizzi funzionalità di determinazione dei prezzi aggiuntive nel sistema, invia una notifica a Technology Account Manager(TAM) in modo che possa avere la priorità con queste funzionalità o ti comunicherà se queste funzionalità sono previste per una release.

Cronologia delle revisioni dei riferimenti XML ARI

La tabella seguente elenca solo gli aggiornamenti della documentazione relativi alle modifiche alle funzionalità.

Data	Modifiche
14 agosto 2020	Versione iniziale.
21 ottobre 2020	Aggiunto il tipo di messaggio Promozioni.
17 novembre 2020	Per i messaggi Transaction (Property Data), è stato aggiornato l'endpoint e aggiunto l'attributo action agli elementi PropertyDataSet.
24 novembre 2020	Per i messaggi Transaction (Property Data), sono stati aggiunti gli elementi <AllowablePackageIDs> e <AllowableRoomIDs>.
4 febbraio 2021	Messaggi di risposta aggiunti.
25 febbraio 2021	OTA_HotelInvCountNotifRQ aggiunti.
21 ottobre 2020	Aggiunto il tipo di messaggio Modifiche tariffarie.