Mensaje de inventario

Descripción general

El mensaje Inventory (OTA_HotelInvCountNotifRQ) define los recuentos de inventario (cantidad de habitaciones físicas) que se pueden reservar para tipos de habitación específicos. Cuando envías un mensaje de inventario, indicas cuántas habitaciones de ese tipo están disponibles en una fecha determinada. Si no hay habitaciones de ese tipo disponibles, no se mostrarán los productos que involucren ese tipo de habitación y fecha.

En las siguientes secciones, se incluyen lineamientos generales, un ejemplo básico y situaciones prácticas para que comiences a agregar y actualizar el inventario, y a enviar mensajes de inventario.

Para ver ejemplos de diversas situaciones relacionadas con el inventario, consulta la sección Instructivos.

Elementos obligatorios y opcionales

En la referencia de XML, se proporcionan descripciones de los elementos obligatorios y opcionales. Para obtener detalles sobre los atributos y los elementos secundarios, consulta Atributos y elementos del inventario.

Sintaxis y esquemas

Usa el ejemplo de sintaxis de Inventory como referencia cuando crees el mensaje de Inventory para asegurarte de que sigues el formato correcto.

Puedes usar una herramienta XML de terceros, como xmllint, para validar tus feeds con los esquemas publicados antes de enviarlos a Google. Para el esquema del mensaje de Inventory, consulta Esquemas de anuncios de hoteles.

Lineamientos

Usa los siguientes lineamientos para un mensaje de Inventory:

• El inventario se organiza por hotel, fecha y tipo de habitación.

• El recuento de inventario debe ser superior a 0 para todas las noches de la estadía para mostrar el precio del plan de tarifas y la ocupación asociados.

• Si el recuento de inventario es igual a 0, las habitaciones no estarán disponibles para reservar para el ID de habitación y el período especificados.

• CountType siempre debe tener el valor de 2 para ser válido, ya que indica un recuento de "disponibilidad definitiva".

• Envía el inventario actualizado cada vez que se produzca una reservación o cancelación de una habitación en tu sistema.

Nota: Envía los recuentos de inventario de habitaciones con OTA_HotelInvCountNotifRQ (método recomendado) o el método alternativo que usa el atributo <BookingLimit> del mensaje OTA_HotelAvailNotifRQ.

Inventario versus disponibilidad

El inventario es la cantidad de habitaciones disponibles para reservar según el recuento físico, y la disponibilidad indica si se permite reservar la combinación de tipo de habitación y plan de tarifas. En el caso de la ARI, la disponibilidad y el inventario pueden variar según un conjunto de fechas o el tipo de alojamiento, y ambos tienen tipos de mensajes correspondientes. El inventario y la disponibilidad se indexan por hotel, fecha y tipo de habitación, y se agrega el plan de tarifas para la disponibilidad.

Puede haber "sin disponibilidad" incluso cuando hay inventario, ya que el inventario y la disponibilidad son independientes entre sí.

Hay dos conceptos de disponibilidad. En primer lugar, está la disponibilidad general de un producto para una estadía determinada, que se ve afectada por factores como si cada noche tiene una tarifa definida, el inventario del tipo de habitación asociado y si la restricción de disponibilidad está abierta. En segundo lugar, está la restricción específica para un producto en una fecha determinada, representada por <RestrictionStatus Restriction="Master" Status="Open"/> en OTA_HotelAvailNotifRQ, y el cierre de esta disponibilidad se conoce como "suspensión de ventas".

El inventario debe ser un número entero mayor que 0 para la habitación, y la restricción de disponibilidad debe estar abierta para mostrar el precio de un producto.

Nota: Si una habitación está agotada, ya no se podrán vender los planes de tarifas asociados a ella.

Ejemplo

En esta sección, se proporciona un ejemplo básico de un mensaje de Inventory 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_inv_count_notif

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

Punto clave: Envía a Google un mensaje de Inventory actualizado cada vez que cambie tu inventario, por ejemplo, cuando se produzcan reservas y cancelaciones.

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 del hotel especificado con <id> en el elemento <listing> del feed de lista de hoteles. Para <RoomID>, usa el mismo ID que usaste en tu sistema para los tipos de habitación. La coherencia con tu sistema es fundamental para garantizar que Google muestre tus datos correctamente.

Nota: <CountType=2> es la única opción válida, ya que indica un recuento de "disponibilidad definitiva".

En este ejemplo, se muestra cómo establecer el inventario para 13 habitaciones reservables durante el mes de diciembre:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

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

Instructivos

En esta sección, se proporciona una situación que puedes encontrar cuando envías un mensaje de Inventory.

Situación: Cómo bloquear la reserva de salas

Descripción

Debes indicar que no quedan habitaciones disponibles para reservar de este tipo en un conjunto específico de fechas, por lo general, porque están agotadas.

Solución

Establece <InvCount Count> en un valor de 0 y agrega el período deseado.

Muestra

En este ejemplo, se muestra cómo usar InvCount para establecer el inventario en 0 para la habitación y las fechas especificadas (por ejemplo, las primeras semanas de enero).

Nota: Si el recuento de inventario de una habitación es 0 para cualquier noche de una estadía, no se podrá reservar la estadía para ningún producto asociado a esa habitación.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>