OTA_HotelAvailNotifRQ

Richieste

Sintassi

Il messaggio OTA_HotelAvailNotifRQ utilizza la seguente sintassi:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Punto chiave: ogni messaggio <OTA_HotelAvailNotifRQ> viene trattato come un aggiornamento delta. Per ogni proprietà, data, camera e pacchetto specificati in <StatusApplicationControl>, un aggiornamento di qualsiasi limitazione definita in precedenza sostituisce solo il valore della stessa limitazione, mentre l'aggiunta di una nuova limitazione non influisce su altre limitazioni definite in precedenza. Ad esempio, se in precedenza era stata definita una durata minima del soggiorno di 2 giorni e poi è stato aggiornato un nuovo messaggio contenente solo una durata massima del soggiorno di 7 giorni, questa azione non cancellerà il valore della durata minima del soggiorno precedente.

Elementi e attributi

Il messaggio OTA_HotelAvailNotifRQ contiene i seguenti elementi e attributi:

Nota: ogni tipo di limitazione relativa alla durata del soggiorno viene impostata in modo indipendente. Ad esempio, un messaggio che imposta SetMaxLOS non sovrascrive un valore definito in precedenza per SetForwardMaxStay.

Elemento / @Attributo	Occorrenze	Tipo	Descrizione
OTA_HotelAvailNotifRQ	1	Complex element	L'elemento principale di un messaggio che definisce la disponibilità della tariffa della camera.
OTA_HotelAvailNotifRQ / @xmlns	0..1	string (URI)	Lo spazio dei nomi XML.
OTA_HotelAvailNotifRQ / @EchoToken	1	string	Un identificatore univoco per questo messaggio di richiesta. Questo valore viene restituito nel messaggio di risposta. I caratteri consentiti sono a-z, A-Z, 0-9, _ (trattino basso) e - (trattino).
OTA_HotelAvailNotifRQ / @TimeStamp	1	DateTime	La data e l'ora di creazione di questo messaggio.
OTA_HotelAvailNotifRQ / @Version	1	decimal	La versione del messaggio OpenTravel.
OTA_HotelAvailNotifRQ / POS	0..1	POS	Un contenitore per la specifica dell'account partner per questo messaggio. In genere viene utilizzato se il backend fornisce feed del prezzo 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 per questo messaggio. Questo valore di stringa è il valore Partner key elencato 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 partner del messaggio Transaction (Property Data) e al valore dell'attributo ID nell'elemento <RequestorID> del messaggio <OTA_HotelRateAmountNotifRQ> per lo stesso account.
OTA_HotelAvailNotifRQ / AvailStatusMessages	1	AvailStatusMessages	Un contenitore per uno o più elementi <AvailStatusMessage>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode	1	string	L'identificatore univoco della struttura. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> del feed elenco hotel. L'ID hotel è indicato anche in Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage	1..n	AvailStatusMessage	Definisce la disponibilità e le limitazioni della tariffa delle camere per diversi intervalli di tempo per una singola proprietà.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit	1	integer	Nota: è preferibile utilizzare il messaggio OTA_HotelInvCountNotifRQ piuttosto che impostare questo attributo. Il numero di stanze rimanenti che possono essere prenotate per l'intervallo di date in <StatusApplicationControl>. Se BookingLimit è specificato, <StatusApplicationControl> deve specificare InvTypeCode e <AvailStatusMessage> non può contenere <LengthOfStay> o <RestrictionStatus>. Deve essere maggiore o uguale a 0. Il valore predefinito è 0 se negativo o non fornito. Nota: per stabilire la disponibilità delle camere per una determinata impostazione di <StatusApplicationControl>, l'attributo BookingLimit deve essere impostato almeno una volta.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl	1	StatusApplicationControl	Definisce l'intervallo di date, nonché gli identificatori per il tipo di camera —InvTypeCode e il piano tariffario —RatePlanCode.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start	1	Date	La data di inizio è basata sul fuso orario della proprietà che comprende l'intervallo di date.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	La data di fine (in base al fuso orario della proprietà), inclusa l'intervallo di date. Deve essere uguale o superiore al valore di start. Se start e end sono uguali, l'aggiornamento verrà applicato alla data in questione.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	Imposta su true o 1 per includere esplicitamente i lunedì. Se impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su "true" vengono esclusi (in effetti, vengono esclusi dalle date all'interno di Start and End).)
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	Imposta su true o 1 per includere esplicitamente i martedì. Se il criterio viene impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date all'interno di Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	Imposta su true o 1 per includere esplicitamente i mercoledì. Se il criterio viene impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date all'interno di Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	Imposta su true o 1 per includere esplicitamente i giovedì. Se il criterio viene impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date all'interno di Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	Imposta su true o 1 per includere esplicitamente i venerdì. Se il criterio viene impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date all'interno di Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat	0..1	boolean	Imposta su true o 1 per includere esplicitamente i sabati. Se il criterio viene impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date all'interno di inizio e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	Imposta su true o 1 per includere esplicitamente le domenica. Se il criterio viene impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date all'interno di Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode	1	string	L'identificatore univoco dell'inventario (tipo di camera). Questo valore è mappato a <RoomID> in un messaggio Transactions (Property Data).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode	0..1	string	Un identificatore univoco del piano tariffario. Questo identificatore è mappato al valore di <PackageID> in un messaggio Transaction (Property Data). Il piano tariffario viene ulteriormente definito e vi viene fatto riferimento in <StatusApplicationControl> nei messaggi <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ>. L'attributo RatePlanCode non è applicabile e non deve essere specificato quando <AvailStatusMessage> contiene l'attributo BookingLimit. Deve essere specificato se <RestrictionStatus> o <LengthOfStay> è specificato.
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 / @FixedPatternLength	0..1	integer	La lunghezza del pattern definito in FullPatternLOS. Nota: questo attributo deve essere impostato quando utilizzi MinMaxMessageType="FullPatternLOS" e assente negli altri casi.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay	1..n	LengthOfStay	Definisce le limitazioni relative alla durata del soggiorno. Quando utilizzi più un elemento <LengthOfStay>, ciascuno deve specificare un valore MinMaxMessageType diverso.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	Valore dell'unità di misura della durata del soggiorno. Tieni presente che un valore pari a zero viene considerato come nessuna restrizione. Ad esempio, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> indica che non esiste una durata massima del soggiorno. Nota: questo attributo deve essere impostato a meno che non utilizzi MinMaxMessageType="FullPatternLOS".
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	L'unità di tempo. Se non viene specificato, il valore predefinito è "Day". Il valore valido è: Day Nota: un'unità "Day" equivale a un soggiorno di una notte.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Vari tipi di limitazioni relative alla durata del soggiorno. SetMaxLOS, SetMinLOS e FullPatternLOS 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 / LengthsOfStay / LengthOfStay / LOS_Pattern	0..1	LOS_Pattern	Definisce il pattern della limitazione per la durata del soggiorno. Nota: questo elemento deve essere presente quando utilizzi MinMaxMessageType="FullPatternLOS" e assente negli altri casi.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Una sequenza di Y e N caratteri che indica se ogni durata del soggiorno è consentita, da una notte al valore in FixedPatternLength. Con una durata superiore a FixedPatternLength, il valore nella posizione finale viene ereditato. Ad esempio, con FixedPatternLength="4" e FullPatternLOS="YNYN", sono consentite solo durate del soggiorno di 1 e 3 notti.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus	0..1	RestrictionStatus	Definisce le limitazioni dell'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 Restriction è aperto o chiuso. I valori validi sono: Open Close Nota: Per impostazione predefinita, Google presuppone che l'impostazione Master per tutti i prodotti sia Close. Puoi configurarla utilizzando "Disponibilità predefinita" nelle impostazioni dei prezzi di Hotel Center. Il valore "Chiuso" in Hotel Center corrisponde al valore Close qui. L'impostazione di Master su Close è nota come "interrompi vendita".
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	enum	Questo attributo è obbligatorio se viene fornito Status. I valori validi sono: Arrival: Questo valore impedisce gli itinerari con una data di check-in compresa nell'intervallo di date Start e End incluse. Departure: Questo valore impedisce gli itinerari con una data di check-out compresa nell'intervallo di date Start e End incluse. Master: Questo valore indica se la tariffa della camera può essere prenotata per quella data. Nota: se Restriction non è specificato, il valore predefinito è Master.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	Durata minima precedente alla data di arrivo (nell'ora locale della proprietà) durante la quale è possibile prenotare questa tariffa della camera. I tipi di valori validi sono: Integer: Il numero di giorni prima della data di arrivo. Ad esempio, un valore 1 indica che la tariffa della camera deve essere prenotata almeno un giorno prima della data di arrivo. Un valore 0 (il valore predefinito) indica che non esistono limitazioni all'orario dell'ultima prenotazione. ISO 8601 Duration (days, hours, and minutes): Il numero di giorni (e, facoltativamente, ore/minuti) prima della data di arrivo. Ad esempio, un valore P1D indica che la tariffa della camera deve essere prenotata un giorno prima della data di arrivo. Un valore P0DT6H indica che la prenotazione deve avvenire sei ore prima della fine della data di arrivo (ad esempio, alle 18:00) o prima.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	integer or duration	Durata massima prima della data di arrivo (nell'ora locale della proprietà) per la quale è possibile prenotare la tariffa della camera. I tipi di valori validi sono: Integer: Il numero di giorni prima della data di arrivo. Ad esempio, un valore 30 indica che la tariffa della camera non può essere prenotata prima della data di arrivo. Un valore 0 (il valore predefinito) indica che non sono previste limitazioni alla prima data/ora della prenotazione. ISO 8601 Duration (days, hours, and minutes): Il numero di giorni (e, facoltativamente, ore/minuti) prima della data di arrivo. Ad esempio, un valore P30D indica che la tariffa della camera non può essere prenotata prima della data di arrivo. Un valore P30DT6H indica che la prenotazione non può essere effettuata prima delle 18:00, 30 giorni prima della data di arrivo.

Esempi

Data di arrivo LoS

Imposta la durata minima e massima del soggiorno (in base alla data di arrivo).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Durata LoS

Imposta la durata minima e massima del soggiorno (in base al soggiorno).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Restrizioni alla partenza

Imposta una limitazione di tipo chiuso alla partenza. (Ciò impedisce gli itinerari con check-out in date specificate.)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Restrizioni sugli arrivi

Imposta una limitazione di tipo chiuso all'arrivo. (Ciò impedisce gli itinerari con check-in in date specificate.)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Apri le date di disponibilità

Apri la disponibilità per un tipo di camera e un piano tariffario in date specificate.

Nota: sono necessarie anche tariffe per notte, insieme a un conteggio dell'inventario maggiore di 0 per il tipo di camera, prima che i prezzi diventino completamente disponibili.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Chiudi le date di disponibilità

Chiudi la disponibilità per un tipo di camera e un piano tariffario nelle date specificate. (Questo processo è anche noto come "interruzione delle vendite").

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Limitazioni relative alla prenotazione anticipata

Imposta un limite minimo e massimo per le finestre per prenotazione anticipata, applicate solo nei fine settimana.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-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>

Chiusura prenotazione

Applicare un limite per la prenotazione per il giorno di arrivo alle 18:00 nell'ora locale dell'hotel.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Più restrizioni

Impostare 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"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Nota: se Restriction non è specificato, il valore predefinito è Master.

Limite di prenotazione

Imposta i conteggi dell'inventario per un tipo di camera nelle date specificate.

Nota: è preferibile utilizzare il messaggio OTA_HotelInvCountNotifRQ anziché impostare questo attributo.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

FullPatternLoS

Imposta una limitazione per la durata del soggiorno completa per lo schema.

Per il check-in del 26 luglio 2023 sono ammesse solo durate del soggiorno di 2, 4 e 6 persone. Le durate dei soggiorni di 1, 3, 5 e 7+ non sono disponibili.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Risposte

Sintassi

Il messaggio OTA_HotelAvailNotifRS utilizza la seguente sintassi:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       EchoToken="echo_token"
                       Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

Elementi e attributi

Il messaggio OTA_HotelAvailNotifRS contiene i seguenti elementi e attributi:

Elemento / @Attributo	Occorrenze	Tipo	Descrizione
OTA_HotelAvailNotifRS	1	Complex element	L'elemento principale per una risposta a un messaggio di disponibilità.
OTA_HotelAvailNotifRS / @TimeStamp	1	DateTime	La data e l'ora di creazione di questo messaggio.
OTA_HotelAvailNotifRS / @EchoToken	1	string	L'identificatore univoco del messaggio OTA_HotelAvailNotifRQ associato.
OTA_HotelAvailNotifRS / Success	0..1	Success	Indica che il messaggio OTA_HotelAvailNotifRQ è stato elaborato correttamente. In ogni messaggio è presente <Success> o <Errors>.
OTA_HotelAvailNotifRS / Errors	0..1	Errors	Un contenitore per uno o più problemi riscontrati durante l'elaborazione del messaggio OTA_HotelAvailNotifRQ. In ogni messaggio è presente <Success> o <Errors>.
OTA_HotelAvailNotifRS / Errors / Error	1..n	Error	La descrizione di un errore riscontrato durante l'elaborazione del messaggio OTA_HotelAvailNotifRQ. I dettagli di questi errori sono disponibili nella sezione Messaggi di errore relativi allo stato dei feed.
OTA_HotelAvailNotifRS / Errors / Error / @Type	1	integer	Il tipo di avviso di errore OpenTravel Alliance (EWT) associato all'errore. Viene utilizzato solo il valore 12 (Processing exception).
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	L'ERR (Error Code) OpenTravel Alliance associato all'errore. Viene utilizzato solo il valore 450 (Unable to process).
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	enum	Lo stato della richiesta originale. Viene utilizzato solo il valore NotProcessed.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText	1	string	L'identificatore di Google del problema. I dettagli di questi errori sono disponibili nella sezione Messaggi di errore relativi allo stato dei feed.

Esempi

Operazione riuscita

Di seguito è riportata una risposta a un messaggio OTA_HotelAvailNotifRQ elaborato correttamente.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

Errori

Di seguito è riportata una risposta a un messaggio OTA_HotelAvailNotifRQ non elaborato a causa di errori.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>