Mensaje de disponibilidad

Descripción general

El mensaje de disponibilidad (OTA_HotelAvailNotifRQ) define si un producto (tipo de habitación combinado con plan de tarifas) para un itinerario determinado se puede vender para las fechas aplicables. Cuando envías un mensaje de disponibilidad, indicas si cambió la disponibilidad o las restricciones de un producto.

En las siguientes secciones, se abarcan los lineamientos generales, un ejemplo básico y situaciones prácticas para que comiences a agregar y actualizar la disponibilidad con el mensaje Availability.

Restricción de disponibilidad nocturna

El mensaje de disponibilidad te permite definir restricciones que controlan la disponibilidad general de una reserva. Un tipo de restricción notable es la "disponibilidad nocturna", que indica si el producto se puede vender en una fecha determinada. Para que una estadía (desde la entrada hasta la salida) se pueda reservar, debe haber disponibilidad nocturna en todas las fechas y se deben cumplir todas las demás restricciones de reserva y estadía.

Configuración de restricciones

De forma predeterminada, RestrictionStatus para Restriction="Master" está cerrado. En otras palabras, de forma predeterminada, se aplica un "detener la venta" todas las noches.

Para que un producto se pueda vender, debe tener <RestrictionStatus Restriction="Master" Status="Open"> para todas las combinaciones de productos en todas las noches de una estadía. Debes enviar a Google un Open explícito para cada producto o cambiar el valor predeterminado en Hotel Center. Para ello, ve a la página Precios > Configuración en Hotel Center y edita el campo "Disponibilidad predeterminada".

Otras restricciones

Llegada y salida
Evita la venta de un itinerario que llega o sale en la fecha especificada. Es Open de forma predeterminada.
Desplazamiento mínimo y máximo de la reserva
Requiere que el itinerario se compre al menos o como máximo una cierta cantidad de días antes de la llegada.
Duración mínima y máxima de la estadía
Restringe la duración de la estadía para los itinerarios que tienen esta fecha de llegada.
Estadía mínima y máxima hacia adelante (o "hasta")
Restringe la duración de la estadía para los itinerarios que contienen esta fecha de estadía.
Patrón de duración de la estadía
Brinda un control exacto de las duraciones de estadía permitidas para esta fecha de llegada.

Lineamientos generales

  • Las restricciones de disponibilidad se basan en el hotel, la fecha, el tipo de habitación y el plan de tarifas.

  • Un producto solo se puede reservar si no hay restricciones impuestas que se apliquen a la estadía (desde el registro de entrada hasta el de salida) o cuando el usuario puede reservar la estadía.

  • Envía a Google una actualización del mensaje de disponibilidad cada vez que haya un cambio en las restricciones de disponibilidad del producto en fechas específicas.

Ejemplo

En esta sección, se proporciona un ejemplo básico de un mensaje de disponibilidad con elementos obligatorios y opcionales. Una vez que prepares tu archivo, deberás enviarlo a Google a través de un mensaje POST a este endpoint:

https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif

Para obtener más información sobre cómo enviar el mensaje con POST, consulta Envío de mensajes.

En el caso de HotelCode, usa el ID único del hotel que usaste en tu sistema para identificar la propiedad. Este valor debe coincidir con el ID de hotel especificado con <id> en el elemento <listing> del feed de lista de hoteles. La coherencia con tu sistema es fundamental para garantizar que Google muestre tus datos correctamente.

En este ejemplo, se muestra cómo establecer restricciones de disponibilidad:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

Para obtener más ejemplos, consulta Ejemplos de disponibilidad.

Instructivos

En esta sección, se proporcionan soluciones para situaciones que puedes encontrar cuando envías mensajes de disponibilidad, específicamente detalles sobre la restricción de disponibilidad nocturna (también conocida como "detener la venta").

Situación 1: Cómo vender productos en fechas específicas

Descripción

Quieres que la combinación de tipo de habitación y plan de tarifas (producto) esté disponible en fechas específicas.

Solución

Establece la restricción Master en Open y especifica las fechas.

Muestra

En este ejemplo, se muestra cómo abrir la disponibilidad nocturna de un producto durante algunas semanas de marzo.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Para obtener más información sobre cómo establecer los precios, consulta Soluciona problemas relacionados con precios faltantes o incompletos.

Situación 2: Cómo dejar de vender productos en fechas específicas

Descripción

Quieres detener explícitamente la venta de un producto (en lugar de que esté agotado) en fechas específicas.

Solución

Establece la restricción Master en Close y especifica las fechas.

Muestra

En este ejemplo, se muestra cómo "dejar de vender" o cerrar la disponibilidad nocturna de un producto en fechas específicas.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>