Mensaje del inventario

Descripción general

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

En las siguientes secciones, se abordan lineamientos generales, un ejemplo básico e instructivos para comenzar a agregar y actualizar inventario, Mensajes de inventario

Para ver ejemplos de varias situaciones relacionadas con el inventario, consulta los instructivos.

Elementos obligatorios y opcionales

La referencia de XML proporciona descripciones de los elementos obligatorios y opcionales. Más información sobre atributos y elementos secundarios, consulta Elementos de inventario y atributos.

Sintaxis y esquemas

Usar la herramienta Inventory de sintaxis como una referencia cuando cree el mensaje Inventario para asegurarse de que está siguiendo el el formato correcto.

Puede usar una herramienta XML de terceros, como xmllint, para validar sus feeds los esquemas publicados antes de enviarlos a Google. Para el inventario esquema de mensajes, consulta Esquemas de anuncios de hoteles.

Lineamientos

Usa los siguientes lineamientos para un mensaje de inventario:

• El inventario está vinculado 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 salas no estarán disponibles para libro correspondiente al ID de habitación y al período especificados.

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

• Envía un inventario actualizado cada vez que se realice una reserva o cancelación de una habitación en tu sistema.

Nota: Envía los recuentos de inventario de la sala mediante OTA_HotelInvCountNotifRQ (método recomendado) o el método alternativo con el Atributo <BookingLimit> del mensaje OTA_HotelAvailNotifRQ.

Inventario frente a disponibilidad

El inventario es la cantidad de salas que se pueden reservar según la cantidad de elementos físicos y disponibilidad indica si la combinación de tipo de habitación y plan de tarifas es que se puede reservar. Para ARI, la disponibilidad y el inventario pueden variar en un conjunto de fechas o un tipo de hospedaje, y ambos tienen correspondencia tipos de mensajes. El inventario y la disponibilidad están vinculados por hotel, fecha y habitación con la incorporación del plan de tarifas para la disponibilidad.

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

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

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 se agota, todos los planes de tarifas asociados a ella pueden ya no se venderán.

Ejemplo

En esta sección, se muestra un ejemplo básico de un mensaje de Inventory que usa y elementos opcionales. Una vez que hayas preparado el 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_inv_count_notif

Para obtener más información sobre cómo enviar o PUBLICAR el mensaje, consulta Cómo enviar mensajes.

Punto clave: Envíale a Google un mensaje de Inventario actualizado cada vez que cambios, como cuándo se producen reservas y cancelaciones.

Para 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 usando <id> en <listing> elemento en la Feed de lista de hoteles. Para <RoomID>, usa el mismo ID que usaste en tu sistema para tipos de habitaciones. La coherencia con tu sistema es fundamental para garantizar que Google muestra tus datos de forma correcta.

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

En este ejemplo, se muestra cómo configurar un inventario para 13 salas que se pueden reservar del 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 ver más ejemplos, consulta Inventario ejemplos comunes.

Instructivos

En esta sección, se brinda una situación que podría surgir durante el envío de un Mensaje de Inventory.

Situación: Cómo bloquear las salas de reuniones para que no se reserven

Descripción

Debes indicar que no hay salas de reuniones restantes que se puedan reservar para este tipo de habitación en un conjunto de fechas específico, por lo general, agotado.

Solución

Estableces <InvCount Count> en un valor 0 y agregas el período que deseas.

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 estadía, entonces no se puede reservar la estadía para ningún producto asociado con 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>