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 specificato 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 è 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 precedente della durata minima del soggiorno.

Elementi e attributi

Il messaggio OTA_HotelAvailNotifRQ contiene i seguenti elementi e attributi:

Nota:ogni tipo di limitazione della 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, viene utilizzato 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 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> 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 in base al fuso orario della proprietà, che include l'intervallo di date.
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 start. Se start e end sono uguali, l'aggiornamento verrà applicato a quella 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 Data 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 Transactions (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> sono specificati.
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" corrisponde a un soggiorno di 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" 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 nella posizione finale. Ad esempio, con FixedPatternLength="4" e FullPatternLOS="YNYN" sono consentite solo le durate del soggiorno 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 date specifiche nell' itinerario rispettivamente per il check-in e il check-out.

  • 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 di check-in.

    Ad esempio, per un soggiorno dal 1° al 4 aprile, se il 2 e il 3 aprile sono chiusi per l'arrivo, la prenotazione è ancora possibile.

    Nota:

    • Per impostazione predefinita, Google presuppone che l'impostazione Master per tutti i prodotti sia Close. Puoi configurare questa opzione in "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 una disponibilità aperta per il determinato itinerario. Il valore predefinito sia per Arrival sia per Departure è Open, a meno che non sia stato inviato un messaggio precedente che indica che la richiesta è stata chiusa. Inoltre, la combinazione di camera/pacchetto deve essere disponibile per tutte le date dell'itinerario, escluso l'ultimo giorno di 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 una data di arrivo il 1° aprile, l'itinerario completo è dal 1° al 4 aprile. Il valore Status debe essere impostato su Open e il valore Restriction su Master per il pernottamento dal 1° al 3 aprile. L'ultimo giorno del soggiorno (4 aprile) è chiuso, poiché solo le date del soggiorno notturno richiedono uno 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 (nel tempo 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 entro 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 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 di visibilità

    L'impostazione Tempo="0" su <LengthOfStay> indica che non ci sono limitazioni per la durata del soggiorno specificata. Ad esempio, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> significa che non è prevista alcuna limitazione 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 di partenza

    Imposta uno stato "Chiuso" con limitazione "Partenza" (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 di arrivo

    Imposta uno stato "Chiuso" con limitazione "Arrivo" (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à aperta

    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 superiore a 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 limite di tempo

    Applica una scadenza per la prenotazione alle ore 18:00 della data di arrivo 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 1, 3, 5 e più di 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 (codice di errore) 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 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>