OTA_HotelAvailNotifRQ

Sintaxis

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

Elementos y atributos

El mensaje OTA_HotelAvailNotifPull cuenta con los siguientes elementos y atributos:
Elemento/@Atributo Repeticiones Tipo Descripción
OTA_HotelAvailNotifRQ 1 Complex element Elemento raíz de un mensaje que define la disponibilidad del precio de la habitación.
OTA_HotelAvailNotifRQ/AvailStatusMessages 1 AvailStatusMessages Contenedor para uno o más elementos <AvailStatusMessage>.
OTA_HotelAvailNotifRQ/AvailStatusMessages/@HotelCode 1 String Identificador único de la propiedad. Este valor debe coincidir con el ID de hotel especificado en la cadena <id> del elemento <listing> del feed de lista de hoteles. El ID de hotel también aparece en Hotel Center.
OTA_HotelAvailNotifRQ/POS 0..1 POS Contenedor para especificar la cuenta de partner de este mensaje (normalmente se utiliza si tu backend proporciona feeds de precios para varias cuentas de partner).
OTA_HotelAvailNotifRQ/POS/Source 1 Source Es obligatorio si aparece <POS>. Contenedor para <RequestorID>.
OTA_HotelAvailNotifRQ/POS/RequestorID 1 RequestorID Es obligatorio si aparece <POS>. Define la cuenta de partner.
OTA_HotelAvailNotifRQ/POS/RequestorID/@ID 1 String Cuenta de partner de este mensaje. El valor de esta cadena es "Clave del partner", que aparece en la página Configuración de la cuenta de Hotel Center.

Nota: Si tienes un backend que proporciona feeds para varias cuentas, este valor debe coincidir con el del atributo partner del mensaje Transaction (Property Data) y con el del atributo ID del elemento <RequestorID> del mensaje <OTA_HotelRateAmountNotifRQ> de la misma cuenta.

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage 1..n AvailStatusMessage Define la disponibilidad y las restricciones del precio de las habitaciones para periodos diferentes en una sola propiedad.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/@BookingLimit 1 Int Número de habitaciones que se pueden reservar en el periodo que se ha indicado en <StatusApplicationControl>. Si se especifica BooklingLimit, <StatusApplicationControl> debe especificar InvTypeCode, y <AvailStatusMessage> no puede contener <LengthOfStay> ni <RestrictionStatus>. Debe ser igual o superior a 0. El valor predeterminado es 0 si no se proporciona ninguno.

Nota: Para establecer la disponibilidad de las habitaciones en un ajuste de <StatusApplicationControl> concreto, se debe configurar el atributo BookingLimit al menos una vez.

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl 1 StatusApplicationControl Define el periodo, así como los identificadores del tipo de habitación (InvTypeCode) y del plan de precios (RatePlanCode).
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@Start 1 Date Fecha de inicio del periodo.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@End 1 Date Fecha de finalización del periodo. Debe ser igual o superior al valor de start. Si los valores de start y end son iguales, los datos actualizados se aplicarán a esa fecha.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@Mon 0..1 Boolean Asigna el valor true o 1 para incluir los lunes de forma explícita.

Si se asigna el valor true, se excluyen otros días de la semana que no se hayan definido explícitamente como true (de hecho, se excluyen de las fechas comprendidas entre Start y End).

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@Tue 0..1 Boolean Asigna el valor true o 1 para incluir los martes de forma explícita.

Si se asigna el valor true, se excluyen otros días de la semana que no se hayan definido explícitamente como true (de hecho, se excluyen de las fechas comprendidas entre Start y End).

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@Weds 0..1 Boolean Asigna el valor true o 1 para incluir los miércoles de forma explícita.

Si se asigna el valor true, se excluyen otros días de la semana que no se hayan definido explícitamente como true (de hecho, se excluyen de las fechas comprendidas entre Start y End).

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@Thur 0..1 Boolean Asigna el valor true o 1 para incluir los jueves de forma explícita.

Si se asigna el valor true, se excluyen otros días de la semana que no se hayan definido explícitamente como true (de hecho, se excluyen de las fechas comprendidas entre Start y End).

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@Fri 0..1 Boolean Asigna el valor true o 1 para incluir los viernes de forma explícita.

Si se asigna el valor true, se excluyen otros días de la semana que no se hayan definido explícitamente como true (de hecho, se excluyen de las fechas comprendidas entre Start y End).

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/ StatusApplicationControl/@Sat 0..1 Boolean Asigna el valor true o 1 para incluir los sábados de forma explícita.

Si se asigna el valor true, se excluyen otros días de la semana que no se hayan definido explícitamente como true (de hecho, se excluyen de las fechas comprendidas entre Start y End).

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@Sun 0..1 Boolean Asigna el valor true o 1 para incluir los domingos de forma explícita.

Si se asigna el valor true, se excluyen otros días de la semana que no se hayan definido explícitamente como true (de hecho, se excluyen de las fechas comprendidas entre Start y End).

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@InvTypeCode 1 String Identificador único del inventario (tipo de habitación). Este valor se asigna a <RoomID> en un mensaje Transactions (Property Data).
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/StatusApplicationControl/@RatePlanCode 0..1 String Identificador único del plan de precios. Este identificador se asigna al valor del objeto <PackageID> en un mensaje Transaction (Property Data). El plan de precios se define mejor y se hace referencia a él en el elemento <StatusApplicationControl> de los mensajes <OTA_HotelRateAmountNotifRQ> y <OTA_HotelAvailNotifRQ>.

El atributo RatePlanCode no es aplicable y no se debe especificar si <AvailStatusMessage> contiene el atributo BookingLimit; únicamente debe indicarse si se especifica <RestrictionStatus> o <LengthOfStay>.

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/LengthsOfStay 0..1 LengthsOfStay Contenedor para definir restricciones de la duración de la estancia (DDE). No debe estar presente si <AvailStatusMessage> incluye el atributo BookingLimit.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/LengthsOfStay/LengthOfStay 1..n LengthOfStay Define las restricciones de la DDE. Si se usa más de un elemento <LengthOfStay>, cada uno debe especificar un valor MinMaxMessageType diferente.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/LengthsOfStay/LengthOfStay/@Time 1 Int Valor de la unidad de la medición de la DDE. Ten en cuenta que un valor de cero se interpreta como que no hay restricciones. Por ejemplo, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> quiere decir que no hay una DDE máxima.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/LengthsOfStay/LengthOfStay/@TimeUnit 0..1 Enum

Unidad de tiempo. Si no se proporciona, el valor predeterminado será "Day". Estos son los valores válidos:

  • Day
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/LengthsOfStay/LengthOfStay/@MinMaxMessageType 1 Enum Varios tipos de restricciones de la DDE. SetMaxLOS y SetMinLOS se basan en la fecha de llegada. SetForwardMinStay y SetForwardMaxStay se basan en la estancia. Los valores máximos deben ser superiores o iguales a los mínimos.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/RestrictionStatus 0..1 RestrictionStatus Define las restricciones de los itinerarios. No debe estar presente si <AvailStatusMessage> incluye el atributo BookingLimit.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/RestrictionStatus/@Status 0..1 Enum

Indica si el tipo de restricción especificada por el atributo Restriction es abierta o cerrada. Estos son los valores válidos:

  • Open
  • Close

Nota: Para establecer la disponibilidad de habitaciones y precios en un ajuste de <StatusApplicationControl> concreto, el atributo Status debe configurarse como Open y el atributo Restriction como Master al menos una vez. Además, los partners pueden solicitar que Google configure su cuenta para que la configuración predeterminada del atributo Status sea Open cuando hayan proporcionado un precio y el valor de BookingLimit sea superior a 0.

OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/RestrictionStatus/@Restriction 0..1 Enum

Este atributo es obligatorio si se proporciona Status.

Estos son los valores válidos:

  • Arrival: este valor impide que se incluyan itinerarios con una fecha de entrada durante el periodo comprendido entre los valores de Start y End, ambos incluidos.
  • Departure: este valor impide que se incluyan itinerarios con una fecha de salida durante el periodo comprendido entre los valores de Start y End, ambos incluidos.
  • Master: este valor indica si el precio de la habitación se puede reservar en la fecha especificada.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/RestrictionStatus/@MinAdvancedBookingOffset 0..1 Int Número mínimo de días antes de la fecha de llegada en los que se puede reservar este precio de la habitación.
OTA_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/RestrictionStatus/@MaxAdvancedBookingOffset 0..1 Int Número máximo de días antes de la fecha de llegada en los que se puede reservar este precio de la habitación.

Ejemplos

Ejemplo 1

Valores máximos y mínimos de la DDE (en función de la fecha de llegada) + entrada anticipada mínima y máxima + cierre de llegada + recuento del inventario

<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5"
                      MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2"
                      MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Arrival"
                         MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="7"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Ejemplo 2

Valores máximos y mínimos de la DDE (en función de la estancia)

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

Ejemplo 3

Cierre de salida (no se permiten itinerarios con salidas en las fechas especificadas)

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

Ejemplo 4

Cierre de llegada (no se permiten itinerarios con entradas en las fechas especificadas)

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

Ejemplo 5

Disponibilidad abierta, sin restricciones

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Ejemplo 6

Restricciones mínimas y máximas de la ventana de reserva anticipada que se aplican solo los fines de semana

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-01-01"
                                End="2020-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Ejemplo 7

Definir varias restricciones en las mismas fechas para el tipo de habitación y el plan de precios

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Master"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Arrival"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>