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 trata como 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 otras restricciones definidas anteriormente. Por ejemplo, si antes se definía una estadía mínima de 2 días y, luego, se actualizaba un mensaje nuevo que solo contenía una estadía máxima de 7 días, esta acción no borraría el valor anterior de la estadía mínima.

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 previamente para SetForwardMaxStay.

Elemento / @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 habitaciones.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) Es 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 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 objeto <RequestorID>.
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID Obligatorio si <POS> está presente. Define la cuenta del socio.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string Es la cuenta de socio de este mensaje. Este valor de cadena es el valor de Partner key que se indica 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 Transaction (Property Data) 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 indica en Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage Define la disponibilidad y las restricciones de las tarifas de 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 mayor que 0. El valor predeterminado es 0 si es negativo o no se proporciona.

Nota: Para establecer la disponibilidad de habitaciones para un parámetro de configuración de <StatusApplicationControl> determinado, se debe establecer 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 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), que se incluye en 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 Se establece en true o 1 para incluir los lunes de forma explícita.

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

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

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

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

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

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

Si se configura como true, se excluyen otros días de la semana que no se hayan configurado explícitamente como 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 de Transacciones (datos de propiedad).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string Es un identificador único del 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 y se hace referencia a él en <StatusApplicationControl> en los mensajes <OTA_HotelRateAmountNotifRQ> y <OTA_HotelAvailNotifRQ>.

El atributo RatePlanCode no es aplicable 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 otros casos.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay Define restricciones sobre la duración de la estadía. Cuando se usa más de un elemento <LengthOfStay>, cada uno debe especificar un valor de 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 sin 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 establecer, a menos que se use MinMaxMessageType="FullPatternLOS".

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum Es la unidad de tiempo. El valor predeterminado es "Day" si no se proporciona. El valor válido es el siguiente:
  • Day
Nota: Una unidad de "Day" equivale a una 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 la duración de la estadía.

Nota: Este elemento debe estar presente cuando se usa MinMaxMessageType="FullPatternLOS" y ausente en los demás casos.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string Es una secuencia de caracteres Y y N que indica 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 mayor que 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 de 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:
  • 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 de entrada.
  • Open y Close con Departure: Esta combinación especifica qué fechas del itinerario están disponibles para la salida.

    • La fecha Arrival no restringe la disponibilidad para las noches de estadía posteriores a la fecha de entrada.

    Por ejemplo, se puede reservar una estadía del 1 al 4 de abril, aunque del 2 al 4 de abril no se permitan llegadas.

    Nota:

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

    Tanto Arrival como Departure deben tener disponibilidad abierta para el itinerario determinado. El valor predeterminado para 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 y paquete debe estar disponible para todas las fechas del itinerario, excepto el último día de la estadía. Esta disponibilidad se puede establecer con la configuración predeterminada de Hotel Center o a través del elemento <Status> o <Restriction>. Si el parámetro de configuración predeterminado es Close, debes enviar un valor de Status de Open y un valor de restriction de Master para las fechas pertinentes con el objetivo de volver a abrir la disponibilidad para las fechas del itinerario.

    Por ejemplo, para una estadía de tres noches con 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 nocturna 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) para la que se puede reservar esta tarifa de habitación.

    Los tipos de valor válidos son los siguientes:

    • Integer: 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): 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 18:00) 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) para la que se puede reservar esta tarifa de habitación.

    Los tipos de valor válidos son los siguientes:

    • Integer: 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 los 30 días previos a 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): La cantidad de días (y, de forma 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 los 30 días previos a la fecha de llegada. Un valor de P30DT6H indica que la reserva no puede realizarse antes de las 18:00, 30 días antes de la fecha de llegada.

    Ejemplos

    Fecha de llegada de la estadía

    Establece la duración mínima y máxima de la estadía (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 del LoS

    Establece la duración mínima y máxima de la estadía (según la estadía continua).

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

    Cómo quitar 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 una 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 los itinerarios con salida en las fechas especificadas).

    <?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 para la llegada. (Esto evita itinerarios con check-in 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 especificadas.

    Nota: También se necesitan tarifas por noche, junto con un recuento de inventario superior a 0 para el tipo de habitación, antes de que los precios estén completamente 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-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

    Cerrar fechas de disponibilidad

    Cierra la disponibilidad de un tipo de habitación y un plan de tarifas en fechas especificadas. (Esto también se conoce como "suspensión de ventas").

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

    Establece restricciones de período mínimo y máximo 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 límite para las reservas en la fecha de llegada a las 18:00, 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

    Establece varias restricciones para las mismas fechas en 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 reserva

    Establece los recuentos de inventario para un tipo de habitación en fechas especificadas.

    Nota: Se prefiere el mensaje OTA_HotelInvCountNotifRQ antes de establecer 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 para un patrón completo.

    Para una entrada el 26 de julio de 2023, solo se permiten duraciones de estadía de 2, 4 y 6. Las duraciones de estadía de 1, 3, 5 y más de 7 noches 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 / @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 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 durante el procesamiento del 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 produjo durante el procesamiento del mensaje de OTA_HotelAvailNotifRQ. Puedes encontrar detalles sobre estos errores en Mensajes de error sobre el estado del feed.
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer Es el EWT (Error Warning Type) de OpenTravel Alliance asociado al error. Solo se usa el valor 12 (Processing exception).
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer Es el código de error de la OpenTravel Alliance (ERR) asociado al 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 Es el identificador de Google para el problema. Puedes encontrar detalles sobre estos errores en Mensajes de error sobre el estado del feed.

    Ejemplos

    Listo

    A continuación, se muestra 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

    A continuación, se muestra 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>