Mensaje de transacción (datos de propiedad)

Descripción general

El mensaje de transacción de ARI (datos de propiedad) define la información sobre cada los tipos de habitaciones y paquetes (o planes de tarifas) de la propiedad. Los datos de cada tipo de habitación incluyen un identificador único (RoomID), un nombre localizado, una descripción y las URLs de la sala fotos. Cada dato del paquete incluye un identificador único (PackageID), localizado nombre, descripción, ocupación y valor agregado.

Puedes usar un mensaje de transacción para lo siguiente:

• Define datos para una o más propiedades.
• Define la información del tipo de habitación y el paquete para cada propiedad.
• Controla las ofertas de productos.

Además, puedes configurar acciones para hacer lo siguiente:

• Agrega un tipo de habitación y un paquete a una propiedad.

  Punto clave: El tipo de habitación tiene un límite de 3,000 por propiedad. Los paquetes también tienen un límite independiente de 3,000 por propiedad. Puedes usar el mensaje <Transaction> para quita tipos de habitaciones o paquetes.

• Quita un tipo de habitación y un paquete de una propiedad.

Para ver ejemplos de mensajes de transacción, consulta Transacción (datos de propiedad) Ejemplos.

Elementos obligatorios y opcionales

La referencia de XML proporciona descripciones de los elementos obligatorios y opcionales. Para obtener detalles y los elementos secundarios, consulta Elementos de transacción (datos de propiedad) y Atributos.

Sintaxis y esquemas

Utiliza la transacción (datos de la propiedad) Sintaxis ejemplo como referencia cuando crees el mensaje Transaction para garantizar que estés siguiendo 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 obtener el esquema de mensajes de transacción, consulta Esquemas de Anuncios de hoteles.

Lineamientos

Sigue estos lineamientos para los mensajes de transacción:

Acciones:

delta: Se usa para agregar o actualizar nuevos tipos de habitaciones y paquetes (planes de tarifas).

overlay: Úsalo para reemplazar todos los tipos de habitaciones y paquetes de una propiedad por un conjunto nuevo. Se debe incluir información de todos los tipos de habitaciones y planes de tarifas que que todavía quieres vender.

Idiomas admitidos:

Especifica uno o dos idiomas (inglés y un idioma local para la propiedad, si es necesario) para los campos Nombre, Descripción y Subtítulo. Puedes agregar más de dos idiomas si es necesario.

Tipos de habitaciones y paquetes:

Cuando actualices un tipo de habitación o un paquete, debes enviar todos los datos correspondiente a ese tipo de habitación o paquete. Por ejemplo, cuando agregues una foto, también debes incluir el nombre y la descripción.

<AllowablePackageIDs> y <AllowableRoomIDs> son opcionales y, si no los estableces, se puede crear cualquier combinación de tipo de habitación y plan de tarifas. Aún debes envía la disponibilidad y las tarifas con los IDs de tipo de habitación y plan de tarifas. Estos permite controlar los productos y desactivar combinaciones que el sistema ya no admite.

Envía una actualización del mensaje de transacción a Google cada vez que haya un cambio en la habitación o paquetes, o detalles importantes sobre los tipos de habitaciones o paquetes que que se deben agregar.

Nota: Debido a que Google almacena datos de propiedades conectados a una propiedad "coincidente", Google no puede aceptar estos datos hasta que la propiedad correspondiente se "coincida" en el sistema. Enviar todas tus propiedades en el feed de lista puede ayudar a evitar errores o retrasos más adelante.

Ejemplo

En esta sección, se proporciona un ejemplo básico de un mensaje de transacción de ARI con los elementos obligatorios y los opcionales. Para agregar o actualizar tipos de habitaciones y paquetes, usa una acción para delta para agregar o actualizar tipos de habitaciones y paquetes, o overlay para reemplazar todas las definiciones de tipos de habitaciones y paquetes (borra las entradas anteriores).

Debes especificar uno o dos idiomas (inglés y un idioma local para la propiedad, si es necesario) para los campos Nombre, Descripción y Subtítulo. Luego, agrega información de los datos de la propiedad, incluidos los vínculos a las fotos.

Para <PropertyID> y <RoomID>, usa los mismos IDs que usas en tu sistema. para los planes de tarifas y los tipos de habitaciones (respectivamente). La coherencia con tu sistema es son fundamentales para garantizar que Google muestre correctamente tus precios y datos.

Nota: Google usa "ID" para el identificador de tipo de habitación y paquete (plan de tarifas), mientras que el XML de OTA usa "code". Debes usar tus propios IDs, ya que Google no generarlos. Para los datos de la propiedad, los IDs del tipo de habitación y del plan de tarifas deben ser únicos por propiedad.

Una vez que prepares tu archivo, debes enviarlo a Google a través de un mensaje POST. al siguiente extremo: https://www.google.com/travel/hotels/uploads/property_data

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

En el siguiente ejemplo, se muestra cómo configurar el mensaje Transaction mediante un delta acción:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

Para obtener más ejemplos, como cómo usar la acción overlay, agregar un tipo de habitación y un paquete a los datos de propiedad existentes, y quitar los tipos de habitación y los paquetes existentes, consulta Ejemplos de Transaction (Property Data).

Instructivos

En esta sección, se proporcionan soluciones a situaciones que pueden surgir mientras enviar mensajes de transacción.

Situación 1: Cómo quitar datos de tipos de habitación

¿Cómo quito los datos de paquetes o tipos de habitación existentes?

Descripción

Enviaste varios tipos de habitaciones, incluidas las habitaciones King y Queen, para el propiedad. Todos los tipos de habitaciones Queen no están disponibles durante una remodelación y, por el momento, solo están disponibles los tipos de habitaciones King.

Solución

• No necesitas actualizar la disponibilidad, las tarifas ni el inventario por noche de el tipo de habitación y los IDs de paquete que se quitaron o desactivaron.
• Si se quitó o desactivó el tipo de habitación o el paquete, envía un nuevo Mensaje de transacción con action="overlay", que solo incluye la sala tipos y paquetes que siguen activos y excluye el tipo de habitación que se quitó o un paquete.

Muestra

En este fragmento XML, se muestra cómo usar la acción overlay para quitar un tipo de habitación.

Nota: Aunque en esta muestra se incluye el tipo de habitación, también puedes usar la misma acción para quitar los datos del paquete.

Esta es la acción original de delta, que incluye los tipos de habitaciones King y Queen:

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

Luego, puedes configurar overlay para quitar el tipo de habitación Queen y conservar el rey tipo de habitación:

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

Situación 2: Cómo controlar los productos con los IDs de paquetes permitidos

¿Cómo controlo los productos (combinaciones de tipos de habitaciones y paquetes) cuando los paquetes se agrupan por tipo de habitación?

Nota: Si tus tipos de habitaciones están agrupados por paquetes, consulta la Situación 3.

Descripción

Tienes ciertos paquetes que solo están disponibles para ciertos tipos de habitaciones. Por ejemplo, si tu propiedad tiene cuatro tipos de habitaciones (incluida la suite presidencial) y seis paquetes diferentes, pero solo algunos son aptos para la suite presidencial, puedes especificar la elegibilidad.

Solución

Envía un mensaje de transacción actualizado que especifique los productos que se incluyen en el paquete con <AllowablePackageIDs>.

Nota: Usa <AllowablePackageIDs> o <AllowableRoomIDs>, pero no ambos, y el elemento que uses dependerá de si tu sistema usa la jerarquía habitación > paquete o paquete > habitación. Si ninguno de estos elementos se define en el Mensaje de transacción. Los tipos de habitaciones se pueden combinar con cualquier paquete.

Muestra

Este fragmento XML muestra cómo usar <AllowablePackageIDs> para especificar paquetes que se usan en un tipo de habitación determinado. Aquí, el tipo de habitación Penthouse solo permite el paquete Penthouse todo incluido o el paquete de desayuno incluido, mientras que El tipo de habitación King suite solo se permite el paquete King con todo incluido o Paquete apto para mascotas.

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

Nota: Si usas <AllowablePackageIDs> o <AllowableRoomIDs> para desactivar una combinación que podrías haber usado anteriormente, pero que ahora no se permite en tu sistema, no es necesario que vuelvas a enviar el ARI para todas las fechas solo para quitar los datos anteriores.

Situación 3: Cómo controlar productos con los ID de AllowableRoomID

¿Cómo controlo los productos (combinaciones de tipos de habitaciones y paquetes) cuando los tipos de habitaciones se agrupan por paquete?

Nota: Si tus paquetes están agrupados por tipo de habitación, consulta la Situación 2.

Descripción

Ya no se vende una combinación de tipo de habitación y paquete como producto, o bien quieres controlar lo que se incluye en un paquete nuevo. Por ejemplo, puedes especificar solo ciertos tipos de habitaciones, como las habitaciones King y Queen con vista al mar, con un paquete.

Solución

Envía un mensaje de transacción actualizado que especifique los productos exactos que se incluyen con el paquete mediante el elemento <AllowableRoomIDs>.

Muestra

En este fragmento XML, se muestra cómo usar <AllowableRoomID> para especificar Oceanview King y Queen en el paquete.

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>