Descripción general
El mensaje Inventario (OTA_HotelInvCountNotifRQ) define los recuentos de inventario (cantidad de salas físicas) que están disponibles para reservar para tipos de habitaciones específicos. Cuando envías un mensaje de Inventario, indicas cuántas habitaciones de ese tipo estarán disponibles en una fecha determinada. Si no hay habitaciones de ese tipo disponibles, no se mostrarán los productos que incluyan ese tipo y fecha.
En las siguientes secciones, se abordan lineamientos generales, un ejemplo básico y situaciones prácticas para comenzar a agregar y actualizar inventario, y a enviar mensajes de Inventory.
Para ver ejemplos de varias situaciones relacionadas con el inventario, consulta Instructivos.
Elementos obligatorios y opcionales
La referencia de XML proporciona descripciones de los elementos obligatorios y opcionales. Para obtener detalles sobre los atributos y los elementos secundarios, consulta Elementos y atributos de inventario.
Sintaxis y esquemas
Usa el ejemplo de sintaxis de inventario como referencia cuando crees el mensaje de inventario para asegurarte de seguir 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 ver el esquema de mensajes de Inventory, consulta Esquemas de Anuncios de hoteles.
Lineamientos
Sigue estos lineamientos para los mensajes de Inventory:
El inventario se clasifica por hotel, fecha y tipo de habitación.
El recuento de inventario debe ser superior a
0para todas las noches de la estadía a fin de mostrar el precio del plan de tarifas y la ocupación asociados.Si el recuento de inventario es igual a
0, las salas de reuniones no estarán disponibles para reservar con el ID de habitación y el período especificados.CountTypesiempre debe tener el valor de2para ser válido, ya que indica un recuento de "disponibilidad definida".Enviar inventario actualizado cada vez que se produzca una reserva o una cancelación de una habitación en tu sistema
Inventario y disponibilidad
El inventario es la cantidad de habitaciones que se pueden reservar según el recuento físico. La disponibilidad indica si se permite reservar la combinación de tipo de habitación y plan de tarifas. Para ARI, la disponibilidad y el inventario pueden variar en función de un conjunto de fechas o un tipo de adaptación, y ambos tienen los tipos de mensajes correspondientes. El inventario y la disponibilidad se vinculan por hotel, fecha y tipo de habitación, con la adición del 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, se ve 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 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 "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 que se muestre el precio de un producto.
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, 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 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. 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 de forma correcta.
En este ejemplo, se muestra cómo configurar el inventario de 13 salas de reuniones que se pueden reservar 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 describe una situación que puedes encontrar mientras envías un mensaje de Inventory.
Situación: Cómo bloquear 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 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.
Ejemplo
En esta muestra, se muestra cómo usar InvCount a fin de configurar el inventario en 0 para la
habitación y las fechas especificadas (por ejemplo, las primeras semanas de enero).
<?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>