Descripción general
El mensaje Disponibilidad (OTA_HotelAvailNotifRQ) define si se puede vender un producto
(tipo de habitación combinado con el plan de tarifas) de un itinerario determinado para las
fechas aplicables. Cuando envías un mensaje de disponibilidad, indicas si cambiaron la disponibilidad o las restricciones de un producto.
En las siguientes secciones, se abordan lineamientos generales, un ejemplo básico y situaciones prácticas para comenzar a agregar y actualizar la disponibilidad mediante el mensaje de disponibilidad.
Restricción de disponibilidad por noche
Este mensaje te permite definir las restricciones que controlan la disponibilidad general de una reserva. Un tipo notable de restricción es la “disponibilidad por noche”, que indica si el producto se puede vender en una fecha en particular. Para que se pueda reservar una estadía (desde la entrada hasta la salida), debe haber disponibilidad por noche 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, hay un "detener la venta" todas las noches.
A fin de que un producto se pueda vender, debe tener <RestrictionStatus Restriction="Master"
Status="Open"> para todas las combinaciones de productos durante todas las noches de la estadía. Debes enviar a Google un Open explícito para cada producto o cambiar el valor predeterminado en Hotel Center. Para ello, navega a la página Precios > Configuración en Hotel Center y edita el campo “disponibilidad predeterminada”.
Otras restricciones
- Llegada/salida
- Impide la venta de un itinerario que llegue o salga en la fecha especificada.
Es
Opende forma predeterminada. - Compensación mínima y máxima de reservas
- Requiere que el itinerario se compre al menos o, como máximo, una cantidad determinada 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 de los itinerarios que tienen esta fecha de llegada.
- Estadía anticipada mínima y máxima (o “permanencia completa”)
- Restringe la duración de la estadía de los itinerarios que contienen esta fecha de estadía.
- Patrón de duración de la estadía
- Brinda un control exacto de la duración de la estadía permitida para esta fecha de llegada.
Lineamientos generales
Las restricciones de disponibilidad se establecen según el hotel, la fecha, el tipo de habitación y el plan de tarifas.
Solo se puede reservar un producto si no se aplican restricciones impuestas a la estadía (desde el registro de entrada hasta la salida) o cuando el usuario puede reservar la estadía.
Envía a Google una actualización del mensaje de disponibilidad cada vez que se modifique 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, tendrás que enviarlo a Google a través de un mensaje POST a este extremo:
https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif
Para obtener más información sobre cómo enviar o publicar el mensaje, consulta Enviar mensajes.
En HotelCode, usa el ID de hotel único que usaste en tu sistema para identificar la propiedad. Este valor debe coincidir con el ID de hotel especificado mediante <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 de forma correcta.
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 las situaciones que puedes encontrar cuando envías mensajes de disponibilidad. Específicamente, detalles sobre la restricción de disponibilidad por la noche (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.
Ejemplo
En este ejemplo, se muestra cómo abrir la disponibilidad nocturna de un producto durante algunas semanas en 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 Solución de problemas de precios faltantes o incompletos.
Situación 2: Cómo dejar de vender productos en fechas específicas
Descripción
Cuando quieres detener de forma explícita la venta de un producto (en lugar de estar fuera del inventario) en fechas específicas.
Solución
Establece la restricción Master en Close y especifica las fechas.
Ejemplo
En este ejemplo, se muestra cómo “detener la venta” 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>