OTA_HotelAvailNotifRQ

Richieste

Sintassi

La sintassi del messaggio OTA_HotelAvailNotifRQ è la seguente:

<?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>

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 sulle 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 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à relativa alla 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 di questo messaggio. In genere, devi usare questo attributo se il tuo backend fornisce feed del prezzo per più account partner.
OTA_HotelAvailNotifRQ / POS/ Source 1 Source Obbligatorio se è presente <POS>. Un contenitore 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 Partner key 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 partner del messaggio Transazione (dati della proprietà) 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 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 / 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 integer Nota: è preferibile utilizzare il messaggio OTA_HotelInvCountNotifRQ piuttosto che impostare questo attributo.

Il numero di camere 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 di <StatusApplicationControl>, l'attributo BookingLimit deve essere impostato almeno una volta.
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 (inclusa) dell'intervallo di date (in base al fuso orario della proprietà).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date La data di fine (inclusa) dell'intervallo di date (in base al fuso orario della proprietà). 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 true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su "true" (in effetti, non vengono inclusi nell'intervallo di date comprese tra 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, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean Imposta su true o 1 per includere esplicitamente i mercoledì.

Se è impostato su true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean Imposta su true o 1 per includere esplicitamente i giovedì.

Se è impostato su true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di 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, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra Start e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean Imposta su true o 1 per includere esplicitamente i sabati.

Se è impostato su true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra la data di inizio e End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean Imposta su true o 1 per includere esplicitamente le domeniche.

Se è impostato su true, vengono esclusi gli altri giorni della settimana che non sono esplicitamente impostati su true (in effetti, non vengono inclusi nell'intervallo di date comprese tra 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 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 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 contenitore 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 si utilizza MinMaxMessageType="FullPatternLOS" e non deve essere presente 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 di 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 corrisponde a "senza limitazioni". Ad esempio, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> significa nessuna durata del soggiorno massima.

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 un pernottamento.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum Diversi tipi di limitazioni relative alla durata del soggiorno. SetMaxLOS, SetMinLOS e FullPatternLOS sono basati 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" e 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 della posizione finale. Ad esempio, con FixedPatternLength="4" e FullPatternLOS="YNYN", sono consentite solo durate del soggiorno pari a 1 e 3.
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 Restriction è aperto o chiuso. I valori validi sono:
  • Open
  • Close

I valori Open e Close sono compatibili con tutti i valori dell'elemento <Restriction>. Quando i valori Open e Close vengono utilizzati con i valori Arrival e Departure, limitano le date specifiche nell'itinerario per il check-in e il check-out, rispettivamente.

  • Open e Close con Arrival: Questa combinazione specifica quali date dell'itinerario sono disponibili per il check-in
  • Open e Close con Departure: Questa combinazione specifica le date dell'itinerario disponibili per il check-out

    • La data Arrival non limita la disponibilità per le notti di soggiorno successive alla data del check-in.

    Ad esempio, un soggiorno dal 1° al 4 aprile in cui il periodo dal 2 al 4 aprile è chiuso agli arrivi è comunque prenotabile.

    Nota:

    • Per impostazione predefinita, Google presuppone che l'impostazione Master per tutti i prodotti sia Close. Puoi configurare questa impostazione tramite "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 "stop alla 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 da Start a End incluse.
    • Departure: Questo valore impedisce gli itinerari con una data di check-out compresa nell'intervallo di date da Start a End incluse.
    • Master: Questo valore indica se la tariffa della camera può essere prenotata per quella data.

    Sia Arrival che Departure devono avere disponibilità aperta per l'itinerario indicato. Il valore predefinito per Arrival e Departure è Open, a meno che non sia stato inviato un messaggio precedente che indica che è stato chiuso. Inoltre, la combinazione camera/pacchetto deve essere disponibile per tutte le date dell'itinerario, escluso l'ultimo giorno del soggiorno. Questa disponibilità può essere impostata tramite le impostazioni predefinite in Hotel Center o tramite l'elemento <Status> o <Restriction>. Se l'impostazione predefinita è Close, devi inviare un valore Status di Open e un valore restriction di Master per le date pertinenti per riaprire la disponibilità per le date dell'itinerario.

    Ad esempio, per un soggiorno di tre notti con data di arrivo il 1° aprile, l'itinerario completo è dal 1° al 4 aprile. Il valore Status deve essere impostato su Open e il valore Restriction deve essere impostato su Master per il pernottamento dal 1° al 3 aprile. L'ultimo giorno del soggiorno (4 aprile) è chiuso, poiché solo le date del pernottamento richiedono lo stato Open.

    Nota:se Restriction non è specificato, il valore predefinito è Master.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration Tempo minimo prima della data di arrivo (nell'ora locale della struttura) in cui la camera può essere prenotata a questa tariffa.

    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 (valore predefinito) indica che non sono previste limitazioni all'ultima data di prenotazione possibile.
    • 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 entro le 18:00).
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration Tempo massimo prima della data di arrivo (nell'ora locale della struttura) in cui la camera può essere prenotata a questa tariffa.

    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 più di 30 giorni prima della data di arrivo. Un valore 0 (valore predefinito) indica che non sono previste limitazioni alla prima data di prenotazione possibile.
    • 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 per la durata del soggiorno

    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 del soggiorno

    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>

    Rimuovere le limitazioni relative alla durata del soggiorno

    Se imposti Time="0" su <LengthOfStay>, significa che non ci sono limitazioni per la durata del soggiorno specificata. Ad esempio, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> significa che non esiste una limitazione relativa alla durata massima del soggiorno.

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

    Limitazione alla partenza

    Imposta una limitazione "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"
                       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 degli arrivi

    Imposta uno 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"
                       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

    Imposta la disponibilità su "Open" per un tipo di camera e un piano tariffario nelle date specificate.

    Nota: prima che i prezzi siano completamente disponibili, sono necessarie anche delle tariffe per notte, oltre a un conteggio dell'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>

    Chiudere le date di disponibilità

    Imposta la disponibilità su "Close" per un tipo di camera e un piano tariffario nelle date specificate. Questa operazione è anche nota come "stop alla 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 alla prenotazione anticipata

    Imposta un limite minimo e massimo per la finestra per prenotazione anticipata, applicato 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 con orario limite

    Applica un limite per la prenotazione alla data di arrivo alle ore 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ù limitazioni

    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"
                       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>


    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 della durata del soggiorno per l'intero pattern.

    Per un check-in il 26 luglio 2023, sono consentite solo durate del soggiorno di 2, 4 e 6 giorni. Le durate del soggiorno 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

    La sintassi del messaggio OTA_HotelAvailNotifRS è la seguente:

    <?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. Per informazioni dettagliate su questi errori, consulta la sezione Messaggi di errore relativi allo stato dei feed.
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer EWT (Error Warning Type) OpenTravel Alliance associato all'errore. Viene utilizzato solo il valore 12 (Processing exception).
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer 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. Per informazioni dettagliate su questi errori, consulta la 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>