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 considerato come un aggiornamento delta. Per ogni proprietà, data, camera e pacchetto specificati in <StatusApplicationControl>, un aggiornamento a 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 è stata definita una durata minima del soggiorno di 2 giorni e viene aggiornato un nuovo messaggio contenente solo una durata massima del soggiorno di 7 giorni, questa azione non cancellerà il precedente valore della durata minima del soggiorno.

Elementi e attributi

Il messaggio OTA_HotelAvailNotifRQ contiene i seguenti elementi e attributi:

Nota: ogni tipo di limitazione relativa alla durata del soggiorno viene impostato 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 specificare l'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 disponi di 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> nel feed elenco hotel. L'ID hotel è indicato anche in Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage	1..n	AvailStatusMessage	Definisce la disponibilità e le limitazioni delle tariffe della camera 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 uguale o maggiore di 0. Il valore predefinito è 0 se negativo o non fornito. Nota: per stabilire la disponibilità di camere per una determinata impostazione <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 include l'intervallo di date.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	La data di fine (in base al fuso orario della proprietà), incluso l'intervallo di date. Deve essere uguale o maggiore del valore start. Se start e end sono uguali, l'aggiornamento verrà applicato a questa data.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	Imposta su true o 1 per includere esplicitamente i lunedì. Se il criterio viene impostato su true, gli altri giorni della settimana che non sono impostati esplicitamente su "true" vengono esclusi (in effetti, vengono esclusi dalle date comprese nell'intervallo Start and End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	Imposta su true o 1 per includere esplicitamente i martedì. Se impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date comprese tra Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	Imposta su true o 1 per includere esplicitamente il mercoledì. Se impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date comprese tra Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	Imposta su true o 1 per includere esplicitamente il giovedì. Se impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date comprese tra Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	Imposta su true o 1 per includere esplicitamente i venerdì. Se impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date comprese tra Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat	0..1	boolean	Imposta su true o 1 per includere esplicitamente il sabato. Se impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date comprese tra Inizio e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	Imposta su true o 1 per includere esplicitamente la domenica. Se impostato su true, gli altri giorni della settimana che non sono esplicitamente impostati su true vengono esclusi (in effetti, vengono esclusi dalle date comprese tra Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode	1	string	L'identificatore univoco dell'inventario (tipo di camera). Questo valore viene 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 è 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 se <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 restrizioni 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 si utilizza MinMaxMessageType="FullPatternLOS" ed essere assente in caso contrario.
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 MinMaxMessageType diverso.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	Valore unitario della misurazione della durata del soggiorno. Tieni presente che un valore pari a zero viene considerato senza limitazioni. 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 venga utilizzato MinMaxMessageType="FullPatternLOS".
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	L'unità di tempo. Se non viene fornito, il valore predefinito è "Day". Il valore valido è: Day Nota: un'unità "Day" equivale a 1 notte.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	Diversi 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 di limitazione della durata del soggiorno. Nota: questo elemento deve essere presente quando si utilizza MinMaxMessageType="FullPatternLOS" ed essere assente in caso contrario.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	Una sequenza di caratteri Y e N che indica se ogni durata del soggiorno è consentita, da una notte al valore in FixedPatternLength. Qualsiasi durata del soggiorno superiore a FixedPatternLength eredita il valore nella posizione finale. Ad esempio, con FixedPatternLength="4" e FullPatternLOS="YNYN", sono consentite solo durate dei soggiorni 1 e 3.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus	0..1	RestrictionStatus	Definisce i limiti 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 configurare questa funzionalità tramite la "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 "interruzione 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 è disponibile per la prenotazione nella data indicata. Nota: se Restriction non è specificato, il valore predefinito è Master.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	Durata minima prima della data di arrivo (nell'ora locale della struttura) in cui è possibile prenotare questa tariffa della camera. I tipi di valore 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'ora della prenotazione più recente. 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 (ovvero 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 struttura) in cui è possibile prenotare questa tariffa della camera. I tipi di valore 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 di 30 giorni prima della data di arrivo. Un valore 0 (valore predefinito) indica che non esistono limitazioni per la prima data di 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 più di 30 giorni prima della data di arrivo. Un valore P30DT6H indica che la prenotazione non può avvenire 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>

Limitazione alla partenza

Imposta un limite di chiusura alla partenza. (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>

Limitazione di arrivo

Imposta una limitazione da "chiuso all'arrivo". (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>

Date di disponibilità aperte

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

Nota: prima che i prezzi siano completamente disponibili, sono necessarie anche le tariffe per notte, insieme a un numero di inventario maggiore di 0 per il tipo di camera.

<?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. Questa operazione è nota anche come "interruzione della vendita".

<?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 per la prenotazione anticipata

Imposta limitazioni minime e massime per la finestra per prenotazione anticipata, applicata 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>

Prenotazione limite

Applica un limite di prenotazione per la data di arrivo alle 18:00, 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>

Limitazioni multiple

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 piuttosto che 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 relativa alla durata del soggiorno con pattern completo.

Per il check-in il 26 luglio 2023, sono consentite solo durate di soggiorno di 2, 4 e 6 notti. Le durate dei soggiorni 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 sulla 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. Puoi trovare i dettagli su questi errori nella sezione Messaggi di errore relativi allo stato dei feed.
OTA_HotelAvailNotifRS / Errors / Error / @Type	1	integer	L'EWT (Error Warning Type) OpenTravel Alliance 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 Google del problema. Puoi trovare informazioni dettagliate su questi errori 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_HotelAvailNotiIMAGES 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>