Sintassi
La sintassi del messaggioOTA_HotelAvailNotifRQ
è la seguente:
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="timestamp" Version="3.0"> <POS> <Source> <RequestorID ID="partner_account_name"/> </Source> </POS> <AvailStatusMessages HotelCode="HotelID"> <AvailStatusMessage BookingLimit="integer"> <StatusApplicationControl Start="YYYY-MM-DD" End="YYYY-MM-DD" Mon="boolean_value" Tue="boolean_value" Weds="boolean_value" Thur="boolean_value" Fri="boolean_value" Sat="boolean_value" Sun="boolean_value" InvTypeCode="RoomID"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="YYYY-MM-DD" End="YYYY-MM-DD" Mon="boolean_value" Tue="boolean_value" Weds="boolean_value" Thur="boolean_value" Fri="boolean_value" Sat="boolean_value" Sun="boolean_value" InvTypeCode="RoomID" RatePlanCode="PackageID"/> <LengthsOfStay> <LengthOfStay Time="integer" TimeUnit="[Day]" MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay| SetForwardMinStay]"/> </LengthsOfStay> <RestrictionStatus Status="[Close|Open]" Restriction="[Arrival|Departure|Master]" MaxAdvancedBookingOffset="integer" MinAdvancedBookingOffset="integer"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Elementi e attributi
Il messaggio OTA_HotelAvailNotifRQ contiene i seguenti elementi e attributi:Elemento / @attributo | Occorrenze | Tipo | Descrizione |
---|---|---|---|
OTA_HotelAvailNotifRQ | 1 | Complex element | L'elemento principale di un messaggio che definisce la disponibilità relativa alla tariffa della camere. |
OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | Un container per uno o più elementi
<AvailStatusMessage> . |
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode | 1 | String | L'identificatore univoco della proprietà. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> nel feed elenco hotel. L'ID hotel è indicato anche in Hotel Center. |
OTA_HotelAvailNotifRQ / POS | 0..1 | POS | Un container per specificare l'account partner di questo messaggio (in genere è utilizzato se il backend fornisce feed dei prezzi per più account partner). |
OTA_HotelAvailNotifRQ / POS/ Source | 1 | Source | Obbligatorio se è presente <POS> . Un container per
<RequestorID> . |
OTA_HotelAvailNotifRQ / POS / RequestorID | 1 | RequestorID | Obbligatorio se è presente <POS> . Definisce l'account
partner. |
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID | 1 | String | L'account partner di questo messaggio. Il valore della stringa è
il valore "Chiave del partner" presente
nella
pagina Impostazioni account in Hotel Center.
Nota: se hai un backend che fornisce feed per più
account, questo valore deve corrispondere al valore dell'attributo |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage | 1..n | AvailStatusMessage | Definisce limitazioni e disponibilità relative alla tariffa della camera per intervalli di tempo differenti per una singola proprietà. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | Int | Il numero di camere rimanenti che possono essere prenotate per l'intervallo di date in <StatusApplicationControl> . Se BooklingLimit è
specificato, <StatusApplicationControl> deve specificare InvTypeCode e <AvailStatusMessage> non può
contenere <LengthOfStay> o
<RestrictionStatus> . Deve essere uguale o maggiore di
0. Se non viene fornito, il valore predefinito è 0.
Nota: per stabilire la disponibilità di camere per una determinata impostazione di |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl | 1 | StatusApplicationControl | Definisce l'intervallo di date, oltre agli identificatori per tipo di camera
(InvTypeCode ) e piano tariffario (RatePlanCode ). |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start | 1 | Date | La data di inizio dell'intervallo di date. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Date | La data di fine dell'intervallo di date. Deve essere maggiore o uguale al
valore di start . Se start e end sono
uguali, l'aggiornamento verrà applicato a tale data. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon | 0..1 | Boolean | Imposta su true o 1 per includere esplicitamente i lunedì.
Se è impostato su |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | Boolean | Imposta su true o 1 per includere esplicitamente i martedì.
Se è impostato su |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | Boolean | Imposta su true o 1 per includere esplicitamente i mercoledì.
Se è impostato su |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | Boolean | Imposta su true o 1 per includere esplicitamente i giovedì.
Se è impostato su |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | Boolean | Imposta su true o 1 per includere esplicitamente i venerdì.
Se è impostato su |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | Boolean | Imposta su true o 1 per includere esplicitamente i sabati.
Se è impostato su |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | Boolean | Imposta su true o 1 per includere esplicitamente le domeniche.
Se è impostato su |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode | 1 | String | L'identificatore univoco dell'inventario (tipo di camera). Questo valore è mappato
a <RoomID> in un messaggio Transaction
(Property Data). |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | String | Un identificatore univoco per il piano tariffario. Questo identificatore è mappato
al valore di
<PackageID> in un messaggio
Transaction (Property Data). Il piano tariffario è ulteriormente definito e vi viene fatto riferimento
in <StatusApplicationControl> nei
messaggi <OTA_HotelRateAmountNotifRQ> e
<OTA_HotelAvailNotifRQ> .
L'attributo |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | Un container per la definizione delle limitazioni relative alla durata del soggiorno. Non deve essere presente se
<AvailStatusMessage> include l'attributo
BookingLimit . |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay | 1..n | LengthOfStay | Definisce le limitazioni relative alla durata del soggiorno. Quando utilizzi più di un
elemento <LengthOfStay> , ciascuno deve specificare un
valore di MinMaxMessageType diverso. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time | 1 | Int | Valore dell'unità di misura della durata del soggiorno. Tieni presente che un valore pari a
zero corrisponde a "senza limitazioni". Ad esempio, <LengthOfStay
Time="0" MinMaxMessageType="SetMaxLOS"/> significa nessuna
durata del soggiorno massima. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | Enum | L'unità di tempo. Se il valore non viene fornito, quello predefinito è "Day". I valori validi sono:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType | 1 | Enum | Diversi tipi di limitazioni relative alla durata del soggiorno. SetMaxLOS
e SetMinLOS si basano sull'arrivo.
SetForwardMinStay e SetForwardMaxStay si
basano sul soggiorno. I valori massimi devono essere maggiori o uguali ai
valori minimi. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus | 0..1 | RestrictionStatus | Definisce le limitazioni relative all'itinerario. Non deve essere presente se
<AvailStatusMessage> include l'attributo
BookingLimit . |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status | 0..1 | Enum | Indica se il tipo di limitazione specificato
dall'attributo
Nota: per stabilire la disponibilità della tariffa e della camera per
una determinata impostazione di |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | Enum | Questo attributo è obbligatorio se viene fornito I valori validi sono:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | Int | Numero minimo di giorni prima della data di arrivo in cui la camera può essere prenotata a questa tariffa. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | Int | Numero massimo di giorni prima della data di arrivo in cui la camera può essere prenotata a questa tariffa. |
Esempi
Esempio 1
Lunghezza del soggiorno min/max (in base alla data di arrivo) + acquisto anticipato min/max + stato Close con limitazione Arrival + totale inventario
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage BookingLimit="5"> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <LengthsOfStay> <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/> <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/> </LengthsOfStay> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Arrival" MaxAdvancedBookingOffset="30" MinAdvancedBookingOffset="7"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Esempio 2
Durata del soggiorno min/max (in base al soggiorno)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <LengthsOfStay> <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/> <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/> </LengthsOfStay> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Esempio 3
Stato Close con limitazione Departure (impedisce gli itinerari con check-out in date specifiche)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Departure"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Esempio 4
Stato Close con limitazione Arrival (impedisce gli itinerari con check-in in date specifiche)
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Arrival"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Esempio 5
Disponibilità Open, senza limitazioni
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage BookingLimit="5"> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Master"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Esempio 6
Limitazioni relative alla finestra per prenotazione anticipata min/max applicate solo nei weekend
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-01-01" End="2020-06-30" Mon=”false” Tue=”false” Weds=”false” Thur=”false” Fri=”false” Sat=”true” Sun=”true” InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus MaxAdvancedBookingOffset="30" MinAdvancedBookingOffset="2"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>
Esempio 7
Imposta più limitazioni nelle stesse date per un tipo di camera e un piano tariffario.
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2020-05-13T20:50:37-05:00" Version="3.0"> <AvailStatusMessages HotelCode="Property_1"> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Close" Restriction="Master"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Arrival"/> </AvailStatusMessage> <AvailStatusMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <RestrictionStatus Status="Open" Restriction="Departure"/> </AvailStatusMessage> </AvailStatusMessages> </OTA_HotelAvailNotifRQ>