OTA_HotelAvailNotifRQ

Solicitudes

Sintaxis

El mensaje OTA_HotelAvailNotifRQ usa la siguiente sintaxis:

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

Cada mensaje <OTA_HotelAvailNotifRQ> se considera una actualización delta. Para cada propiedad, fecha, habitación y paquete especificados en <StatusApplicationControl>, una actualización de cualquier restricción definida anteriormente solo reemplaza el valor de la misma restricción, mientras que agregar una restricción nueva no afecta a otras restricciones definidas anteriormente. Por ejemplo, si anteriormente se definió una duración mínima de la estadía de 2 días y, luego, se actualizó un mensaje nuevo que solo contiene una duración máxima de la estadía de 7 días, esta acción no borraría el valor anterior de la duración mínima de la estadía.

Elementos y atributos

El mensaje OTA_HotelAvailNotifRQ tiene los siguientes elementos y atributos:

Nota: Cada tipo de restricción de duración de la estadía se establece de forma independiente. Por ejemplo, un mensaje que establece SetMaxLOS no reemplaza un valor definido anteriormente para SetForwardMaxStay.

Elemento o @Attribute Casos Tipo Descripción
OTA_HotelAvailNotifRQ 1 Complex element Es el elemento raíz de un mensaje que define la disponibilidad de las tarifas de las habitaciones.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) El espacio de nombres XML.
OTA_HotelAvailNotifRQ / @EchoToken 1 string Es un identificador único para este mensaje de solicitud. Este valor se muestra en el mensaje de respuesta. Los caracteres permitidos son a-z, A-Z, 0-9, _ (guion bajo) y - (guion).
OTA_HotelAvailNotifRQ / @TimeStamp 1 DateTime La fecha y hora de creación de este mensaje.
OTA_HotelAvailNotifRQ / @Version 1 decimal Es la versión del mensaje de OpenTravel.
OTA_HotelAvailNotifRQ / POS 0..1 POS Es un contenedor para especificar la cuenta de socio de este mensaje. Por lo general, se usa si tu backend proporciona feeds de precios para varias cuentas de socios.
OTA_HotelAvailNotifRQ / POS/ Source 1 Source Obligatorio si <POS> está presente. Es un contenedor para el elemento <RequestorID>.
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID Obligatorio si <POS> está presente. Define la cuenta de socio.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string La cuenta de socio de este mensaje. Este valor de cadena es el valor de Partner key 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 valor del atributo partner de tu mensaje de transacción (datos de propiedad) y el valor del atributo ID en el elemento <RequestorID> de tu mensaje <OTA_HotelRateAmountNotifRQ> para la misma cuenta.
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages Es un contenedor para uno o más elementos <AvailStatusMessage>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string Es el identificador único de la propiedad. Este valor debe coincidir con el ID de hotel especificado con <id> en el elemento <listing> del feed de lista de hoteles. El ID del hotel también se muestra en Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage Define la disponibilidad y las restricciones de las tarifas de las habitaciones para diferentes períodos de una sola propiedad.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer Nota: Se prefiere el mensaje OTA_HotelInvCountNotifRQ en lugar de establecer este atributo.

Es la cantidad de habitaciones restantes que se pueden reservar para el período en <StatusApplicationControl>. Si se especifica BookingLimit, <StatusApplicationControl> debe especificar InvTypeCode, y <AvailStatusMessage> no puede contener <LengthOfStay> ni <RestrictionStatus>.

Debe ser igual o superior a 0. Si es negativo o no se proporciona, el valor predeterminado es 0.

Nota: Para establecer la disponibilidad de una habitación para una configuración de <StatusApplicationControl> determinada, se debe configurar el atributo BookingLimit al menos una vez.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl Define el período, así como los identificadores del tipo de habitación —InvTypeCode y el plan de tarifas —RatePlanCode.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date Es la fecha de inicio según la zona horaria de la propiedad que incluye el período.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date Es la fecha de finalización (según la zona horaria de la propiedad), incluido el período. Debe ser igual o mayor que el valor de start. Si start y end son iguales, la actualización se aplica a esa fecha.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean Establece en true o 1 para incluir los lunes de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran de forma explícita como "true" (en efecto, se filtran de las fechas dentro de Start and End)..
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean Establece true o 1 para incluir los martes de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean Establece true o 1 para incluir los miércoles de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean Establece true o 1 para incluir los jueves de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean Establece true o 1 para incluir los viernes de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean Establece en true o 1 para incluir explícitamente los sábados.

Si se establece en true, se excluyen los otros días de la semana que no se configuran de forma explícita en true (en efecto, se filtran de las fechas dentro de Inicio y End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean Establece en true o 1 para incluir los domingos de forma explícita.

Si se establece en true, se excluyen los otros días de la semana que no se configuran de forma explícita en true (en efecto, se filtran de las fechas dentro de Start y End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string Es el 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 Es un identificador único para el plan de tarifas. Este identificador se asigna al valor de <PackageID> en un mensaje de transacción (datos de propiedad). El plan de tarifas se define con mayor detalle y se hace referencia a él en <StatusApplicationControl> en los mensajes <OTA_HotelRateAmountNotifRQ> y <OTA_HotelAvailNotifRQ>.

El atributo RatePlanCode no se aplica y no se debe especificar cuando <AvailStatusMessage> contiene el atributo BookingLimit. Se debe especificar si se especifica <RestrictionStatus> o <LengthOfStay>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay Es un contenedor para definir restricciones de LOS. No debe estar presente si <AvailStatusMessage> incluye el atributo BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer Es la longitud del patrón definido en FullPatternLOS.

Nota: Este atributo se debe establecer cuando se usa MinMaxMessageType="FullPatternLOS" y no debe estar presente en otro caso.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay Define las restricciones sobre la duración de la estadía. Cuando uses más de un elemento <LengthOfStay>, cada uno debe especificar un valor MinMaxMessageType diferente.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer Es el valor de la unidad de la medición de la duración de la estadía. Ten en cuenta que un valor de cero se considera como ninguna restricción. Por ejemplo, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> significa que no hay una duración máxima de la estadía.

Nota: Este atributo se debe configurar, a menos que se use MinMaxMessageType="FullPatternLOS".

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum La unidad de tiempo. Si no se proporciona, el valor predeterminado es "Day". El valor válido es el siguiente:
  • Day
Nota: Una unidad de "Day" equivale a 1 noche de estadía.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum Varios tipos de restricciones de duración de la estadía SetMaxLOS, SetMinLOS y FullPatternLOS se basan en la llegada. SetForwardMinStay y SetForwardMaxStay se basan en la permanencia. Los valores máximos deben ser mayores o iguales que los valores mínimos.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern 0..1 LOS_Pattern Define el patrón de restricción de duración de la estadía.

Nota: Este elemento debe estar presente cuando se usa MinMaxMessageType="FullPatternLOS" y no debe estar presente en otro caso.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string Es una secuencia de caracteres Y y N que indican si se permite cada duración de la estadía, desde una noche hasta el valor en FixedPatternLength. Cualquier duración de la estadía superior a FixedPatternLength hereda el valor en la posición final. Por ejemplo, con FixedPatternLength="4" y FullPatternLOS="YNYN", solo se permiten las duraciones de estadía 1 y 3.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus Define las restricciones del itinerario. 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 especificado por el atributo Restriction está abierto o cerrado. Los valores válidos son los siguientes:
  • Open
  • Close

Los valores de Open y Close son compatibles con todos los valores del elemento <Restriction>. Cuando se usan los valores Open y Close con los valores Arrival y Departure, se restringen fechas específicas en el itinerario para el registro de entrada y salida, respectivamente.

  • Open y Close con Arrival: Esta combinación especifica qué fechas del itinerario están disponibles para el registro
  • Open y Close con Departure: Esta combinación especifica qué fechas del itinerario están disponibles para la salida.

    • La fecha de Arrival no restringe la disponibilidad de las noches de estadía después de la fecha de entrada.

    Por ejemplo, para una estadía del 1 al 4 de abril, en la que el 2 y el 4 de abril están cerrados para la llegada, aún se puede reservar.

    Nota:

    • De forma predeterminada, Google supone que la configuración de Master para todos los productos es Close. Puedes configurar esta opción en "Disponibilidad predeterminada" en la configuración de precios de Hotel Center. El valor "Cerrado" en Hotel Center corresponde al valor Close aquí.
    • Configurar Master como Close se conoce como "venta de parada".
    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 evita que se incluyan itinerarios con una fecha de entrada durante el período comprendido entre Start y End inclusive.
    • Departure: Este valor evita los itinerarios con una fecha de salida durante el período comprendido entre Start y End inclusive.
    • Master: Este valor indica si la tarifa de la habitación está disponible para reservar en la fecha.

    Arrival y Departure deben tener disponibilidad abierta para el itinerario determinado. El valor predeterminado de Arrival y Departure es Open, a menos que se haya enviado un mensaje anterior que indique que se cerró. Además, la combinación de habitación o paquete debe estar disponible para todas las fechas del itinerario, excepto el último día de la estadía. Esta disponibilidad se puede establecer mediante la configuración predeterminada de Hotel Center o a través del elemento <Status> o <Restriction>. Si la configuración predeterminada es Close, debes enviar un valor de Status de Open y un valor de restriction de Master para las fechas relevantes para volver a abrir la disponibilidad para las fechas del itinerario.

    Por ejemplo, para una estadía de tres noches con una fecha de llegada el 1 de abril, el itinerario completo es del 1 al 4 de abril. El valor de Status se debe establecer en Open y el valor de Restriction se debe establecer en Master para la estadía nocturna del 1 al 3 de abril. El último día de la estadía (4 de abril) está cerrado, ya que solo las fechas de estadía nocturnas requieren un estado Open.

    Nota: Si no se especifica Restriction, el valor predeterminado es Master.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration Es la duración mínima antes de la fecha de llegada (en la hora local de la propiedad) durante la cual se puede reservar esta tarifa de habitación.

    Los tipos de valor válidos son los siguientes:

    • Integer: Es la cantidad de días antes de la fecha de llegada. Por ejemplo, un valor de 1 indica que la tarifa de la habitación se debe reservar al menos un día antes de la fecha de llegada. Un valor de 0 (el valor predeterminado) indica que no hay restricciones en la hora de reserva más reciente.
    • ISO 8601 Duration (days, hours, and minutes): Es la cantidad de días (y, de manera opcional, horas o minutos) antes de la fecha de llegada. Por ejemplo, un valor de P1D indica que la tarifa de la habitación se debe reservar un día antes de la fecha de llegada. Un valor de P0DT6H indica que la reserva debe realizarse seis horas antes del final de la fecha de llegada (es decir, a las 6:00 p.m.) o antes.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration Es la duración máxima antes de la fecha de llegada (en la hora local de la propiedad) durante la cual se puede reservar esta tarifa de habitación.

    Los tipos de valor válidos son los siguientes:

    • Integer: Es la cantidad de días antes de la fecha de llegada. Por ejemplo, un valor de 30 indica que la tarifa de la habitación no se puede reservar antes de 30 días antes de la fecha de llegada. Un valor de 0 (el valor predeterminado) indica que no hay restricciones en la hora de reserva más temprana.
    • ISO 8601 Duration (days, hours, and minutes): Es la cantidad de días (y, de manera opcional, horas o minutos) antes de la fecha de llegada. Por ejemplo, un valor de P30D indica que la tarifa de la habitación no se puede reservar antes de 30 días antes de la fecha de llegada. Un valor de P30DT6H indica que la reserva no se puede realizar antes de las 6:00 p.m., 30 días antes de la fecha de llegada.

    Ejemplos

    Fecha de llegada de la duración de la estadía

    Establece duraciones de estadía mínimas y máximas (según la fecha de llegada).

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

    Duración de la LoS

    Establece duraciones mínimas y máximas de la estadía (según la permanencia).

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

    Quita las restricciones de LoS

    Establecer Time="0" en <LengthOfStay> indica que no hay restricciones para la duración de la estadía especificada. Por ejemplo, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> significa que no hay restricción de duración máxima de la estadía.

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

    Restricción de salida

    Establece una restricción de cierre para la salida. (Esto evita que se generen itinerarios con salida en fechas específicas).

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

    Restricción de llegada

    Establece una restricción de cierre a la llegada. (Esto evita que se generen itinerarios con registro de entrada en fechas específicas).

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


    Fechas de disponibilidad abierta

    Disponibilidad abierta para un tipo de habitación y un plan de tarifas en fechas específicas.

    Nota: También se necesitan las tarifas nocturnas, junto con un recuento de inventario superior a 0 para el tipo de habitación, antes de que los precios estén disponibles por completo.

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

    Cerrar fechas de disponibilidad

    Cerrar la disponibilidad de un tipo de habitación y un plan de tarifas en fechas específicas (Esto también se conoce como "venta de detención").

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

    Restricciones de reservas anticipadas

    Establece restricciones mínimas y máximas de períodos 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"
                       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>

    Reserva de corte

    Aplica un corte para las reservas en la fecha de llegada a las 6:00 p.m. en la hora local del 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>

    Varias restricciones

    Establecer varias restricciones en las mismas fechas para un tipo de habitación y un plan de tarifas

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


    Límite de reservas

    Establece recuentos de inventario para un tipo de habitación en fechas específicas.

    Nota: Se prefiere el mensaje OTA_HotelInvCountNotifRQ en lugar de configurar este atributo.

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

    Establece una restricción de duración de la estadía de patrón completo.

    Para una entrada el 26 de julio de 2023, solo se permiten estadías de 2, 4 y 6 días. Las duraciones de 1, 3, 5 y más de 7 días no están disponibles.

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

    Respuestas

    Sintaxis

    El mensaje OTA_HotelAvailNotifRS usa la siguiente sintaxis:

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

    Elementos y atributos

    El mensaje OTA_HotelAvailNotifRS tiene los siguientes elementos y atributos:

    Elemento o @Attribute Casos Tipo Descripción
    OTA_HotelAvailNotifRS 1 Complex element Es el elemento raíz de una respuesta a un mensaje de disponibilidad.
    OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime La fecha y hora de creación de este mensaje.
    OTA_HotelAvailNotifRS / @EchoToken 1 string Es el identificador único del mensaje OTA_HotelAvailNotifRQ asociado.
    OTA_HotelAvailNotifRS / Success 0..1 Success Indica que el mensaje OTA_HotelAvailNotifRQ se procesó correctamente.

    <Success> o <Errors> están presentes en cada mensaje.
    OTA_HotelAvailNotifRS / Errors 0..1 Errors Es un contenedor para uno o más problemas que se encontraron mientras se procesaba el mensaje OTA_HotelAvailNotifRQ.

    <Success> o <Errors> están presentes en cada mensaje.
    OTA_HotelAvailNotifRS / Errors / Error 1..n Error Es la descripción de un error que se encontró durante el procesamiento del mensaje OTA_HotelAvailNotifRQ. Puedes encontrar detalles sobre estos errores en Mensajes de error sobre el estado del feed.
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer El EWT (tipo de advertencia de error) de OpenTravel Alliance asociado con el error Solo se usa el valor 12 (Processing exception).
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer El código de error (ERR) de OpenTravel Alliance asociado con el error. Solo se usa el valor 450 (Unable to process).
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 enum Es el estado de la solicitud original. Solo se usa el valor NotProcessed.
    OTA_HotelAvailNotifRS / Errors / Error / @ShortText 1 string El identificador de Google del problema. Puedes encontrar detalles sobre estos errores en Mensajes de error sobre el estado del feed.

    Ejemplos

    Listo

    La siguiente es una respuesta a un mensaje OTA_HotelAvailNotifRQ procesado correctamente.

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

    Errores

    La siguiente es una respuesta a un mensaje OTA_HotelAvailNotifRQ que no se procesó debido a errores.

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