En esta página, se proporciona una referencia para los mensajes de transacción basados en XML.
<Transaction>
El elemento raíz de un mensaje de transacción es <Transaction>
. Es un contenedor de información descriptiva sobre habitaciones y paquetes, y los precios y la disponibilidad de habitaciones y paquetes.
El elemento <Transaction>
aparece en el siguiente lugar en la jerarquía XML del mensaje de transacción:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Los mensajes que usan <Transaction>
como elemento raíz requieren al menos un elemento secundario. Los mensajes de transacción pueden tener cualquier cantidad de elementos secundarios, siempre que el tamaño total del mensaje no supere los 100 MB.
Sintaxis
El elemento <Transaction>
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp" id="transaction_ID">
<!-- Defines data about a room or package (Room Bundle) -->
<PropertyDataSet>
...
</PropertyDataSet>
<!-- Updates/sets prices and availability for rooms and Room Bundles -->
<!-- (Also removes itineraries from inventory) -->
<Result>
...
</Result>
</Transaction>
Atributos
El elemento <Transaction>
tiene los siguientes atributos:
Atributo | ¿Es obligatorio? | Tipo | Descripción |
---|---|---|---|
id | Required | string | Un identificador único para cada mensaje de transacción. |
partner | Optional | string | La cuenta de socio a la que corresponde el mensaje de transacción. Por lo general, debes usarlo si el backend proporciona feeds de precios para varias cuentas de socios. Este valor de cadena es el valor de "Clave de socio" que aparece en la página Configuración de la cuenta de Hotel Center. |
timestamp | Required | DateTime | El momento en el que se envió el mensaje de transacción. Se procesarán todos los mensajes enviados con una marca de tiempo dentro de las 24 horas anteriores, mientras que se descartarán los que no lo hayan hecho. Los mensajes se procesan en el orden de |
Elementos secundarios
El elemento <Transaction>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<PropertyDataSet> | Optional* | <PropertyDataSet> |
Describe una habitación y paquetes de habitaciones específicos. Por lo general, se usa en un mensaje de transacción independiente para definir valores compartidos de paquetes de habitaciones y reducir el tamaño de tus mensajes de transacción. |
<Result> | Optional* | <Result> |
Datos de precios del itinerario de una habitación o un elemento |
* Se requiere al menos uno de los valores <PropertyDataSet> o <Result> . |
Ejemplos
Datos de la habitación
En el siguiente ejemplo, se definen los datos de las habitaciones en un mensaje Transaction:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>5440OF</RoomID>
<Name>
<Text text="Single King Bed Room" language="en"/>
<Text text="Simple Lit de Roi" language="fr"/>
</Name>
<Description>
<Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
and down comforters (bedspreads). City view. 300 square feet. Desk with
rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
complimentary HBO and pay movies." language="en"/>
<Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Bathroom View" language="en"/>
<Text text="La salle de baines" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Capacity>4</Capacity>
</RoomData>
</PropertyDataSet>
</Transaction>
Datos de precios
En el siguiente ejemplo, se definen los datos de precios en un mensaje Transaction:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>052213</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">299.98</Baserate>
<Tax currency="USD">26.42</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="otto"/>
<PointOfSale id="simon"/>
</AllowablePointsOfSale>
</Result>
</Transaction>
Tarifas por noche
En el siguiente ejemplo, se definen los datos de precios para 1 a 7 noches a partir del 7 de junio de 2023:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">209.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">419.98</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>3</Nights>
<Baserate currency="USD">614.97</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>4</Nights>
<Baserate currency="USD">819.96</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>5</Nights>
<Baserate currency="USD">999.95</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>6</Nights>
<Baserate currency="USD">1193.94</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
<Result>
<Property>1234</Property>
<Checkin>2018-06-07</Checkin>
<Nights>7</Nights>
<Baserate currency="USD">1259.93</Baserate>
<Tax currency="USD">21.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
</Result>
</Transaction>
Tarifas base y condicionales
En el siguiente ejemplo, se muestra un mensaje de transacción que contiene una tarifa base y una tarifa condicional:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">200.00</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Rates>
<!-- The rate_rule_id is required when using conditional rates -->
<Rate rate_rule_id="mobile">
<!-- Override base rate and taxes for conditional rates -->
<Baserate currency="USD">180.00</Baserate>
<Tax currency="USD">18.00</Tax>
<!-- NOTE: OtherFees is inherited from the above setting -->
<Custom1>ratecode123</Custom1>
</Rate>
</Rates>
</Result>
</Transaction>
Quitar inventario
En el siguiente ejemplo, se quitan varios inventarios (estadías de 1 noche en varias fechas diferentes) de un hotel:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-05-23T16:20:00-04:00" id="42">
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-23</Checkin>
<Nights>1</Nights>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-24</Checkin>
<Nights>1</Nights>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
<!---Sending <Baserate> is optional with <Unavailable> -->
<Result>
<Property>1123581321</Property>
<Checkin>2023-05-25</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">-1</Baserate>
<Unavailable>
<NoVacancy/>
</Unavailable>
<Tax currency="USD">0</Tax>
<OtherFees currency="USD">0</OtherFees>
</Result>
</Transaction>
<PropertyDataSet>
Es un contenedor de información de una habitación y un paquete (o paquete de habitación) en un mensaje <Transaction>
. Los valores establecidos en un hotel anulan los valores establecidos en un socio.
Google almacena esta información para que no tengas que definirla cada vez que envíes actualizaciones de precios.
El elemento <PropertyDataSet>
aparece en el siguiente lugar en la jerarquía XML del mensaje de transacción:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Para obtener más información, consulta los metadatos del paquete de habitación.
Sintaxis
El elemento <PropertyDataSet>
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet> <!-- (Required) ID that matches the Hotel List Feed --> <Property>hotel_ID</Property> <!-- (Optional) Defines metadata about a room --> <RoomData> ... </RoomData> <!-- (Optional) Defines package metadata to be paired with rooms (Room Bundles) --> <PackageData> ... </PackageData> </PropertyDataSet> ... </Transaction>
Atributos
El elemento <PropertyDataSet>
no tiene atributos.
Elementos secundarios
El elemento <PropertyDataSet>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<PackageData> | Optional* | <PackageData> |
Describe un paquete de habitación. Estos datos están asociados a un socio y
un hotel, pero no a un itinerario. Este elemento es similar a <RoomData> , pero describe comodidades y términos que no forman parte de la descripción de la habitación física.
Puedes hacer referencia al ID de paquete en tus actualizaciones de precios. Para obtener más información, consulta los metadatos del paquete de habitaciones. |
<Property> | Required | string | Es el ID de un hotel al que se aplican los datos asociados. El valor de este elemento debe ser una cadena que coincida con la ficha <id> de tu feed de lista de hoteles.
|
<RoomData> | Optional* | <RoomData> |
Describe una habitación. Estos datos se asocian a un socio y a un hotel, pero no a un itinerario.
Debes hacer referencia al ID de la habitación en las actualizaciones de precios. |
* Se requiere al menos uno de los valores <PackageData> o <RoomData> . |
Ejemplos
Datos de habitaciones y paquetes
En el siguiente ejemplo, se muestran datos de habitaciones y paquetes en un <PropertyDataSet>
:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Cuando envíes los precios y la disponibilidad de este paquete de habitación y de habitación, debes hacer referencia a los IDs de habitación y de paquete en los mensajes de precios. El resultado es que reducirás en gran medida el tamaño de los mensajes y la cantidad de errores que podrías encontrar debido a los datos duplicados. Para obtener más información, consulta los metadatos del paquete de habitaciones.
<RoomData>
Definen metadatos sobre las habitaciones independientes del itinerario y, por extensión, los paquetes de habitaciones (ya que los paquetes de habitaciones son habitaciones y comodidades adicionales). Usa <RoomData>
para reducir la repetición de datos descriptivos en tu feed de precios.
El elemento <RoomData>
aparece en el siguiente lugar en la jerarquía XML del mensaje de transacción:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Los elementos <RoomData>
contienen información asociada con un socio y un hotel, pero no con un itinerario. El propósito previsto es para todos los datos no itinerarios.
El elemento <RoomData>
es similar a <PackageData>
, pero describe la habitación física en lugar de las comodidades y las condiciones de un paquete. Usarás <RoomData>
y <PackageData>
en conjunto para brindar detalles sobre los paquetes de habitaciones. Para habitaciones individuales que no formen parte de un paquete, usa solo <RoomData>
.
Puedes definir los elementos <RoomData>
y <PackageData>
para la misma habitación o paquete de habitación. Cuando Google muestre esa habitación o ese paquete en los resultados de la búsqueda, incluirá las descripciones de ambos, separadas por un guion.
Para obtener más información, consulta los metadatos del paquete de habitación.
Sintaxis
El elemento <RoomData>
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet> ... <RoomData> <RoomID>room_ID</RoomID> <Name> <Text text="room_name" language="language_code"/> ... </Name> <Description> <Text text="room_description" language="language_code"/> ... </Description> <Capacity>max_number_of_occupants</Capacity> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults, children, or seniors --></OccupancyDetails> <OccupancySettings> <MinOccupancy>min_number_of_occupants</MinOccupancy> <MinAge>min_age_of_occupants</MinAge> </OccupancySettings> <PhotoURL> <Caption> <Text text="photo_description" language="language_code"/> ... </Caption> <URL>photo_location</URL> </PhotoURL> <RoomFeatures> ... </RoomFeatures> </RoomData> ... </PropertyDataSet> </Transaction>
Atributos
El elemento <RoomData>
no tiene atributos.
Elementos secundarios
El elemento <RoomData>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<Capacity> | Optional | integer | Indica la cantidad máxima de huéspedes que una habitación puede acomodar físicamente. En el caso de una habitación, la capacidad es mayor o igual que la
ocupación.
Cuando se especifica, este valor debe ser igual o mayor que el valor del elemento El valor de |
<Description> | Optional | Object | Corresponde a una descripción detallada de la sala. Este elemento debe contener información que no haya sido descrita por otros elementos ni por el elemento <Name> . No uses todas las letras en mayúsculas para especificar la descripción de la habitación.
El elemento
Usa un elemento En el siguiente ejemplo, se muestran las versiones en inglés y francés de la descripción de la habitación: <Description> <Text text="Two queen-sized beds" language="en"/> <Text text="Deux lits de la reine" language="fr"/> </Description> |
<Name> | Required | string | Es el nombre de la categoría de la habitación. Este valor debe coincidir con el que aparece en la página de destino del hotel (anteriormente, el punto de venta). No establezcas el valor de este elemento en mayúsculas.
Este toma un único elemento secundario,
Usa un elemento En el siguiente ejemplo, se muestran las versiones en inglés y francés del nombre de la habitación: <Name> <Text text="Standard Double Room" language="en"/> <Text text="Le chambre double" language="fr"/> </Name> |
<Occupancy> | Optional | integer | Indica la cantidad máxima de huéspedes a los que está destinada una habitación.
Por ejemplo, un paquete grande podría alojar físicamente 6 huéspedes (capacidad = 6), pero está destinado solo a 4 huéspedes.
Este valor debe ser menor o igual que el elemento El valor de
|
<OccupancySettings> | Optional | Object | Son parámetros de configuración que pueden restringir o modificar los requisitos de ocupación de una
habitación.
El elemento
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> No es necesario incluir todos los elementos secundarios. |
<PhotoURL> | Optional | Object | Es una URL y una leyenda opcional para una foto de la habitación o el paquete de habitación determinados. Puedes especificar más de un <PhotoURL> para una habitación o un paquete de habitación. La URL de cada foto debe estar en su propio <PhotoURL> .
Este elemento toma los siguientes elementos secundarios:
Ejemplo: <PhotoURL> <URL>https://www.example.com/static/bar/image1234.jpg</URL> <Caption> <Text text="A bright and breezy way to enjoy your mornin' cuppa tea." language="en"/> <Text text="Une façon lumineuse et aérée pour profiter de votre journée tasse de thé." language="fr"/> </Caption> </PhotoURL> <PhotoURL> <URL>https://www.foo.com/static/bar/image5678.jpg</URL> <Caption> <Text text="Or, perhaps you prefer coffee." language="en"/> <Text text="Ou peut-être préférez-vous le café." language="fr"/> </Caption> </PhotoURL> |
<RoomFeatures> | Optional | <RoomFeatures> |
Contiene información sobre las características de la habitación. |
<RoomID> | Required | string | Es el ID único de la sala. Usa este ID para hacer coincidir los datos de las habitaciones con los bloques <Result> en tus actualizaciones de precios. Para obtener más información, consulta los metadatos del paquete de habitaciones. También puedes usar este ID para hacer referencia a la definición de una sala común en un solo mensaje de transacción cuando definas los datos de la sala de forma intercalada. |
Ejemplos
Datos de la habitación
En el siguiente ejemplo, se definen los datos de las habitaciones:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>5440OF</RoomID>
<Name>
<Text text="Single King Bed Room" language="en"/>
<Text text="Simple Lit de Roi" language="fr"/>
</Name>
<Description>
<Text text="One king bed with pillowtop mattresses, 300-thread-count linens,
and down comforters (bedspreads). City view. 300 square feet. Desk with
rolling chair. Multi-line phone with voice mail. Cable/satellite TV with
complimentary HBO and pay movies." language="en"/>
<Text text="Un très grand lit avec matelas à plateau-coussin, ..." language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Bathroom View" language="en"/>
<Text text="La salle de baines" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Capacity>4</Capacity>
</RoomData>
</PropertyDataSet>
</Transaction>
Metadatos de paquetes y habitaciones
En el siguiente ejemplo, se definen los metadatos de habitaciones y paquetes:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Varios paquetes de habitaciones
En el siguiente ejemplo, se definen los metadatos de habitaciones y paquetes para varios paquetes de Room:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<!-- A transaction message with room types result. -->
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
<RoomID>single</RoomID>
<Name>
<Text text="Single room" language="en"/>
<Text text="Chambre simple" language="fr"/>
</Name>
<Description>
<Text text="A single room" language="en"/>
<Text text="Le chambre simple" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image1235.jpg</URL>
</PhotoURL>
<Capacity>2</Capacity>
</RoomData>
<RoomData>
<RoomID>double</RoomID>
<Name>
<Text text="Double room" language="en"/>
<Text text="Chambre double" language="fr"/>
</Name>
<Occupancy>1</Occupancy>
</RoomData>
<PackageData>
<PackageID>refundbreakfast</PackageID>
<Name>
<Text text="Refundable Room with Breakfast" language="en"/>
<Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Continental Breakfast" language="en"/>
<Text text="Petit déjeuner continental" language="fr"/>
</Description>
<ChargeCurrency>hotel</ChargeCurrency>
<Refundable available="1" refundable_until_days="3"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>prepaid</PackageID>
<Name>
<Text text="Nonrefundable" language="en"/>
<Text text="Non remboursable" language="fr"/>
</Name>
<Description>
<Text text="Blah blah blad" language="en"/>
<Text text="Le blah blah blad" language="fr"/>
</Description>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="0"/>
</PackageData>
</PropertyDataSet>
</Transaction>
<RoomFeatures>
Define las características que se encuentran en la sala.
El elemento <RoomFeatures>
aparece en el siguiente lugar en la jerarquía XML del mensaje de transacción:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<RoomFeatures>
Sintaxis
El elemento <RoomFeatures>
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <PropertyDataSet ... > ... <RoomData> <RoomFeatures> <JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle> <Beds> <Bed size="[single|semi_double|double|queen|king]"> <Width unit="cm" number="width"/> <Length unit="cm" number="length"/> </Bed> <!-- Include with any additional beds. --> </Beds> <Suite/> <Capsule/> <Roomsharing>[shared|private]</Roomsharing> <Outdoor/> <MobilityAccessible/> <Smoking>[smoking|non_smoking]</Smoking> <BathAndToilet relation="[together|separate]"> <Bath bathtub="[false|true]" shower="[false|true]"/> <Toilet electronic_bidet="[false|true]" mobility_accessible="[false|true]"/> </BathAndToilet> <OpenAirBath/> <AirConditioning/> <Balcony/> <Views> <!-- (Optional) Defines the type of views from the room. --> <!-- Example: <OceanView/> --> </Views> </RoomFeatures> ... </RoomData> ... </PropertyDataSet> </Transactions>
Atributos
El elemento <RoomFeatures>
no tiene atributos.
Elementos secundarios
El elemento <RoomFeatures>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<JapaneseHotelRoomStyle> | Optional | enum | Indica el estilo de una habitación de hotel japonesa. Estos son los valores válidos:
|
<Beds> | Optional | Object | Contiene la cantidad de <Bed> que tenga la habitación. Ten en cuenta que los futones japoneses no deberían contabilizarse aquí.
Cada
<Bed> tiene los siguientes elementos secundarios:
<Beds> <Bed size="double"> <Width unit="cm" number="140"/> <Length unit="cm" number="195"/> </Bed> <Bed/> <!-- Size unknown --> </Beds> |
<Suite> | Optional | empty | Proporciona este elemento cuando esta habitación sea una suite. |
<Capsule> | Optional | empty | Proporciona este elemento cuando esta sala sea una cápsula. |
<Roomsharing> | Optional | enum | Indica si esta habitación se comparte con otros ocupantes, como los propietarios o con otros
huéspedes. Los valores válidos son shared y private . |
<Outdoor> | Optional | empty | Proporciona este elemento cuando esta habitación sea de alojamiento al aire libre que no tenga paredes fijas, plomería ni control de clima. Por ejemplo, las habitaciones de hotel no son alojamientos al aire libre, mientras que los campamentos donde los huéspedes se hospedan en carpas y los parques de autocaravanas donde los huéspedes traen su propia casa rodante son alojamiento al aire libre. |
<MobilityAccessible> | Optional | empty | Proporciona este elemento cuando la sala sea accesible para personas con movilidad reducida. |
<Smoking> | Optional | enum | Indica si esta habitación es para no fumadores o para fumadores. Los valores válidos son non_smoking y smoking . |
<BathAndToilet> | Optional | Object | Contiene información sobre un baño y un inodoro en la habitación.
El atributo es:
De manera opcional, el elemento toma los siguientes elementos secundarios:
Ejemplo: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
<OpenAirBath> | Optional | empty | Proporciona este elemento cuando esta habitación tenga baño privado al aire libre. |
<AirConditioning> | Optional | empty | Proporciona este elemento cuando esta habitación tenga aire acondicionado. |
<Balcony> | Optional | empty | Proporciona este elemento cuando esta habitación tenga balcón o terraza. |
<Views> | Optional | Object | Entre las opciones válidas, se incluyen las siguientes:
|
Ejemplos
JapaneseHotelRoomStyle
no tiene un valor predeterminado. Omitir un valor no genera un error de XML, pero tu ficha no se muestra en los resultados de la búsqueda cuando el usuario filtra por estilo de habitación o camas.
Dos camas individuales
En el siguiente ejemplo, se muestra cómo usar <RoomFeatures>
:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
<Beds> <!-- Two single beds -->
<Bed size="single">
<Width unit="cm" number="97"/>
<Length unit="cm" number="195"/>
</Bed>
<Bed size="single">
<Width unit="cm" number="97"/>
<Length unit="cm" number="195"/>
</Bed>
</Beds>
<Suite/>
<Capsule/>
<Roomsharing>private</Roomsharing>
<Outdoor/>
<MobilityAccessible/>
<Smoking>non_smoking</Smoking>
<BathAndToilet relation="separate">
<Bath bathtub="1" shower="1"/>
<Toilet electronic_bidet="1" mobility_accessible="1"/>
</BathAndToilet>
<OpenAirBath/>
<AirConditioning/>
<Balcony/>
<Views>
<LakeView/>
<MarinaView/>
<BeachView/>
<ForestView/>
<MountainView/>
<NatureView/>
</Views>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
Dos camas dobles
El siguiente es un ejemplo de una habitación japonesa de estilo western
con dos camas double
.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
<Beds> <!-- Two double beds-->
<Bed size="double"></Bed>
<Bed size="double"></Bed>
</Beds>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
Estilo japonés sin cama
El siguiente es un ejemplo de una habitación de estilo japonés sin cama. No se requiere información sobre la cama para la habitación de estilo japanese
.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
Wéstern japonés con cama
El siguiente es un ejemplo de una habitación de estilo japanese_western
con una cama de tamaño king
.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
<Beds>
<Bed size="king"></Bed>
</Beds>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
Si el socio no tiene la información sobre la cantidad de camas en las habitaciones japanese_western
, sigue el ejemplo:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<RoomFeatures>
<JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
</RoomFeatures>
</RoomData>
</PropertyDataSet>
</Transaction>
<PackageData>
Define los metadatos independientes del itinerario sobre los paquetes de habitaciones de una propiedad. Este elemento contiene información asociada a un socio y un hotel, pero no a un itinerario. El propósito previsto es definir todos los datos no itinerarios una vez y hacer referencia a ellos a partir de datos de itinerarios.
El elemento <PackageData>
aparece en el siguiente lugar en la jerarquía XML del mensaje de transacción:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
El elemento <PackageData>
es similar a <RoomData>
, pero describe las características de las tarifas y los términos que no forman parte de la descripción del espacio físico. Usarás <RoomData>
y <PackageData>
en conjunto para proporcionar detalles sobre los paquetes de habitaciones y las funciones de tarifas. En el caso de las habitaciones individuales que no formen parte de un paquete, usa solo <RoomData>
.
Puedes definir los elementos <RoomData>
y <PackageData>
para la misma habitación o paquete de habitación. Cuando Google muestre esa habitación o ese paquete en los resultados de la búsqueda, incluirá las descripciones de ambos, separadas por un guion.
Si actualizas un solo elemento <PackageData>
para una propiedad, debes actualizar todos los elementos <PackageData>
y <RoomData>
de la propiedad.
Cada <PropertyDataSet>
se considera todos los datos sobre la propiedad y reemplaza los datos existentes.
Para obtener más información, consulta los metadatos del paquete de habitación.
Sintaxis
El elemento <PackageData>
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
<PropertyDataSet ... >
<PackageData>
<PackageID>package_ID</PackageID>
<Name>
<Text text="package_name" language="language_code"/>
...
</Name>
<Description>
<Text text="package_description" language="language_code"/>
...
</Description>
<Refundable available="[false|true]" refundable_until_days="number_of_days"
refundable_until_time="time"/>
<ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency>
<Occupancy>max_number_of_intended_occupants</Occupancy>
<OccupancyDetails><!-- optional info about the types of guests,
whether adults or children --></OccupancyDetails>
<!-- For these next 3 elements, boolean_value can be 0/1 or true/false -->
<BreakfastIncluded>boolean_value</BreakfastIncluded>
<InternetIncluded>boolean_value</InternetIncluded>
<ParkingIncluded>boolean_value</ParkingIncluded>
<PhotoURL>
<Caption>
<Text text="photo_description" language="language_code"/>
...
</Caption>
<URL>photo_location</URL>
</PhotoURL>
...
<Meals>
<Breakfast
included="[true|false]" buffet="[true|false]"
in_room="[true|false]" in_private_space="[true|false]"/>
<Dinner
included="[true|false]" buffet="[true|false]"
in_room="[true|false]" in_private_space="[true|false]"/>
</Meals>
<CheckinTime>checkin_time</CheckinTime>
<CheckoutTime>checkout_time</CheckoutTime>
<MembershipBenefitsIncluded>
<ProgramName>
<Text language="en" text="Special Rewards">
</ProgramName>
<ProgramLevel>
<Text language="en" text="Platinum">
</ProgramLevel>
</MembershipBenefitsIncluded>
<OnPropertyCredit>
<Amount currency="USD">123.45</Amount>
</OnPropertyCredit>
</PackageData>
<!-- a PackageID with a MilesIncluded
rate feature -->
<PackageData>
<PackageID>room_with_miles</PackageID>
<Name>
<Text text="Room with Bundled Miles" language="en">
</Name>
<ChargeCurrency>hotel </ChargeCurrency>
<MilesIncluded>
<NumberOfMiles>1000 </NumberOfMiles>
<Provider>
<Text language="en" text="United Airlines">
</Provider>
</MilesIncluded>
</PackageData>
...
...
</PropertyDataSet>
...
</Transaction>
Atributos
El elemento <PackageData>
no tiene atributos.
Elementos secundarios
El elemento <PackageData>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<BreakfastIncluded> | Optional | boolean | Especifica si este paquete incluye desayuno con la tarifa.
Los valores válidos son 0 (o false ) y 1 (o true ).
Es preferible que uses |
<ChargeCurrency> | Optional | enum | Indica cuándo y dónde el usuario paga una reserva. Este elemento usa la misma sintaxis que <ChargeCurrency> en un <Result> .
El valor predeterminado es |
<CheckinTime> | Optional | Time | Hora de entrada más temprana posible. La hora debe ser inferior a las 24:00 en la hora local del hotel. |
<CheckoutTime> | Optional | Time | Es la hora de salida más reciente posible en la hora local del hotel. |
<Description> | Optional | Object | Es una descripción detallada del paquete. Este elemento debe contener información que no haya sido descrita por otros elementos ni por el elemento <Name> . No uses todas las letras en mayúsculas para especificar la descripción de la habitación.
El elemento <Description> <Text text="Two breakfast buffet certificates for each night of stay." language="en"/> <Text text="Deux certificats petit-déjeuner buffet pour chaque nuit de séjour." language="fr"/> </Description> |
<InternetIncluded> | Optional | boolean | Si un paquete incluye acceso a Internet sin cargo,
mientras que otros no incluyen ese servicio. No configures este elemento para los paquetes de habitaciones en un hotel que ofrece Internet gratis a todas las habitaciones. Este elemento no se aplica a la conexión a Internet por cable o inalámbrica en la habitación que no está disponible en las habitaciones de huéspedes. Los valores válidos son 0 (o false ) y 1 (o true ).
|
<Meals> | Optional | Object | Contiene información sobre las comidas en este paquete.
El elemento
Los atributos opcionales se usan solo cuando Para que los filtros de comida ( |
<Name> | Required | string | El nombre del paquete. Este valor debe coincidir con lo que aparece en la página de destino del hotel. No establezcas el valor de este elemento en mayúsculas.
Este toma un solo elemento secundario, <Name> <Text text="Bed and Breakfast" language="en"/> <Text text="Lit et petit déjeuné" language="fr"/> </Name> |
<Occupancy> | Optional | integer | Indica la cantidad máxima de huéspedes para los que está diseñado un paquete de habitación.
Por ejemplo, un paquete grande puede alojar hasta 6 huéspedes, pero está diseñado para un máximo de 4 huéspedes.
Este valor debe ser menor o igual que el elemento El valor de Si especificas este elemento en Nota: <Occupancy> puede estar acompañado de <OccupancyDetails> ,que especifica el tipo de invitados (adultos o niños). Consulta <OccupancyDetails> para conocer la sintaxis y la descripción de los elementos secundarios.
|
<PackageID> | Required | string | Es el ID único del paquete. Usa este ID para hacer coincidir los datos del paquete de habitación con los bloques (También puedes usar este ID para hacer referencia a una definición del paquete de habitación común que se utiliza en un solo mensaje Transaction cuando defines los datos del paquete de la habitación de forma intercalada). |
<ParkingIncluded> | Optional | boolean | Indica si el paquete de habitación incluye estacionamiento sin cargo, y el estacionamiento sería un servicio pagado en este hotel. No especifiques un valor para este elemento para un hotel que ofrece estacionamiento gratuito.
Los valores válidos son |
<PhotoURL> | Optional | Object | (Igual que <PhotoURL> en <RoomData> , pero para el paquete (p.ej., fotos de la comida).)
|
<Refundable> | Optional | Object | Permite publicar una tarifa como completamente reembolsable o proporcionar una cancelación
gratuita. De lo contrario, no se mostrará información sobre el reembolso.
Una política de reembolso a nivel de <PackageData> anula la política de reembolso a nivel de <Result> . Una política de reembolso a nivel de <Rates> anula la política de reembolso a nivel de <PackageData> . Los precios reembolsables también
se pueden destacar a los usuarios a través de opciones alternativas sin modificar
directamente el esquema de mensajes de transacción. Obtén más información sobre estas opciones
Política de tarifas reembolsables.
En el siguiente ejemplo, se muestra el elemento <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Nota: Te recomendamos configurar todos los atributos. Se genera un mensaje de advertencia sobre el estado del feed cuando no se configuran uno o más atributos. Si no configuras ningún atributo, la tarifa no se mostrará como reembolsable. Los atributos son los siguientes:
Cuando configures los atributos, ten en cuenta lo siguiente:
|
<MembershipBenefits |
Optional | boolean | La tarifa incluye los beneficios de nivel élite por la duración de la estadía. Incluye los siguientes parámetros:
|
<CarRentalIncluded> | Optional | boolean | La tarifa incluye el alquiler de autos gratuito por la duración de la estadía. |
<MilesIncluded>> | Optional | boolean | La tarifa incluye las millas de viajero frecuente. Entre los parámetros, se incluyen los siguientes:
|
<OnPropertyCredit> | Optional | boolean | La tarifa incluye crédito en la propiedad (F&B, complejo turístico, spa, etcétera). Parámetro:
|
<AirportTransportationIncluded> | Optional | Object | La tarifa incluye transporte gratuito desde y hacia un aeropuerto cercano. El atributo opcional direction especifica la direccionalidad del transporte. Entre los valores válidos, se incluyen los siguientes:
from : Se proporciona transporte del aeropuerto a la
propiedad. Este es el valor predeterminado si no se especifica ninguna dirección.
to : Se ofrece transporte al aeropuerto desde la propiedad.
round_trip : Se brinda transporte desde y hacia el aeropuerto.
|
Ejemplos
Paquete de habitación individual
En el siguiente ejemplo, se define un paquete de habitación individual con una ocupación para 2 personas (un adulto y un niño) y, además, incluye desayuno:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>1</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Two certificates for continental
breakfast will be provided." language="en"/>
<Text text="Deux certificats pour le petit déjeuner
continental seront fournis." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Metadatos de paquetes y habitaciones
En el siguiente ejemplo, se definen los metadatos de habitaciones y paquetes:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>180054</Property>
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Bed Room" language="en"/>
<Text text="Chambre single" language="fr"/>
</Name>
<Description>
<Text text="Non-smoking" language="en"/>
<Text text="Pas de fumiers" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>P54321</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
<Text text="Avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Includes a delightful array of jams and jellies." language="en"/>
<Text text="Comprend une délicieuse gamme de confitures et gelées." language="fr"/>
</Description>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Varios paquetes de habitaciones
En el siguiente ejemplo, se definen los metadatos de habitaciones y paquetes para varios paquetes de Room:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<!-- A transaction message with room types result. -->
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
<RoomID>single</RoomID>
<Name>
<Text text="Single room" language="en"/>
<Text text="Chambre simple" language="fr"/>
</Name>
<Description>
<Text text="A single room" language="en"/>
<Text text="Le chambre simple" language="fr"/>
</Description>
<PhotoURL>
<Caption>
<Text text="Living area" language="en"/>
<Text text="Le chambre" language="fr"/>
</Caption>
<URL>http://www.foo.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image1235.jpg</URL>
</PhotoURL>
<Capacity>2</Capacity>
</RoomData>
<RoomData>
<RoomID>double</RoomID>
<Name>
<Text text="Double room" language="en"/>
<Text text="Chambre double" language="fr"/>
</Name>
<Occupancy>1</Occupancy>
</RoomData>
<PackageData>
<PackageID>refundbreakfast</PackageID>
<Name>
<Text text="Refundable Room with Breakfast" language="en"/>
<Text text="Chambre remboursable avec le petit déjeuner" language="fr"/>
</Name>
<Description>
<Text text="Continental Breakfast" language="en"/>
<Text text="Petit déjeuner continental" language="fr"/>
</Description>
<ChargeCurrency>hotel</ChargeCurrency>
<Refundable available="1" refundable_until_days="3"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>prepaid</PackageID>
<Name>
<Text text="Nonrefundable" language="en"/>
<Text text="Non remboursable" language="fr"/>
</Name>
<Description>
<Text text="Blah blah blad" language="en"/>
<Text text="Le blah blah blad" language="fr"/>
</Description>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="0"/>
</PackageData>
</PropertyDataSet>
</Transaction>
Paquete de habitación con tarifas
En el siguiente ejemplo, se definen los metadatos de habitación y paquete para un paquete de Room con características de tarifa:
<Transaction timestamp="2010-04-24T20:44:56-04:00" id="TXNID">
<PropertyDataSet>
<Property>12345</Property>
<RoomData>
...
</RoomData>
<!-- definitions of PackageData types including rate features -->
<PackageData>
<PackageID>room_with_addl_benefits</PackageID>
<Name>
<Text text="Acme Hotels 2017 Promotion Package" language="en"/>
</Name>
<ChargeCurrency>hotel</ChargeCurrency>
<BreakfastIncluded>1</BreakfastIncluded>
<MembershipBenefitsIncluded>
<ProgramName>
<Text language="en" text="Marriott Rewards"/>
</ProgramName>
<ProgramLevel>
<Text language="en" text="Platinum"/>
</ProgramLevel>
</MembershipBenefitsIncluded>
<OnPropertyCredit>
<Amount currency="USD">123.45</Amount>
</OnPropertyCredit>
</PackageData>
<PackageData>
<PackageID>room_with_miles</PackageID>
<Name>
<Text text="Room with Bundled Miles" language="en"/>
</Name>
<ChargeCurrency>hotel</ChargeCurrency>
<MilesIncluded>
<NumberOfMiles>1000</NumberOfMiles>
<Provider>
<Text language="en" text="United Airlines"/>
</Provider>
</MilesIncluded>
<AirportTransportationIncluded direction="from"/>
</PackageData>
</PropertyDataSet>
<!-- The actual list of prices -->
<Result>
…
</Result>
</Transaction>
Comidas y fotos
En el siguiente ejemplo, se definen los metadatos de habitaciones y paquetes de comidas, fotos y horas de entrada y salida:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Meals Included" language="en"/>
</Name>
<PhotoURL>
<Caption>
<Text text="Breakfast" language="en"/>
<Text text="朝食" language="ja"/>
</Caption>
<URL>http://example.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Meals>
<!-- Guests can choose to have breakfast in their room or in another
space to avoid contact with other guests. -->
<Breakfast included="1" in_room="1" in_private_space="1"/>
<Dinner included="1" buffet="1"/>
</Meals>
<CheckinTime>15:00</CheckinTime>
<CheckoutTime>11:00</CheckoutTime>
</PackageData>
</PropertyDataSet>
</Transaction>
Desayuno
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<PropertyDataSet>
<Property>1234</Property>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Breakfast Included" language="en"/>
</Name>
<PhotoURL>
<Caption>
<Text text="Breakfast" language="en"/>
<Text text="朝食" language="ja"/>
</Caption>
<URL>http://example.com/static/bar/image1234.jpg</URL>
</PhotoURL>
<Meals>
<Breakfast included="true"/>
<!-- Dinner not included needs to be explicitly specified -->
<Dinner included="false"/>
</Meals>
<CheckinTime>15:00</CheckinTime>
<CheckoutTime>11:00</CheckoutTime>
</PackageData>
</PropertyDataSet>
</Transaction>
<Result>
Un contenedor para actualizaciones de precios y disponibilidad en un mensaje <Transaction>
El elemento <Result>
aparece en el siguiente lugar en la jerarquía XML del mensaje de transacción:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Usa <Result>
para establecer o actualizar los precios de las habitaciones y definir el inventario disponible. Por lo general, los elementos definidos en este elemento hacen referencia a metadatos independientes de itinerarios sobre una habitación o un paquete (como una descripción o un conjunto de comodidades) definidos en <PackageData>
y <RoomData>
.
Por lo general, envías mensajes de Transaction con actualizaciones de precios con mucha frecuencia. La manera y la frecuencia exactas en las que lo hagas dependerá de tu modo de entrega.
Puedes usar <Result>
en un mensaje de transacción para quitar itinerarios, como se describe en Quita inventario.
Si quieres obtener más información sobre el uso de mensajes de transacción para actualizar precios y disponibilidad, consulta Cómo agregar y actualizar inventario.
Un solo mensaje de transacción puede incluir cualquier cantidad de elementos <Result>
, siempre que el tamaño del mensaje no supere los 100 MB.
Sintaxis
El elemento <Result>
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> <!-- Required --> <Property>hotel_ID</Property> <!-- Required --> <Checkin>YYYY-MM-DD</Checkin> <!-- Required --> <Nights>number_of_nights</Nights> <Baserate currency="currency_code">price</Baserate> <!-- Only required when <Baserate> contains a real price --> <Tax currency="currency_code">tax_amount</Tax> <!-- Only required when <Baserate> contains a real price --> <OtherFees currency="currency_code">fee_amount</OtherFees> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <RoomID>room_ID</RoomID> <PackageID>package_ID</PackageID> <ExpirationTime>expiration_time</ExpirationTime> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <Occupancy>max_number_of_intended_occupants</Occupancy> <!-- For Baserate, occupancy value must be greater than or equal to 2. If a value is not provided for occupancy, it defaults to 2. --> <OccupancyDetails>occupancy_info</OccupancyDetails> <Rates>...</Rates> <RoomBundle>...</RoomBundle> <AllowablePointsOfSale> <PointOfSale id="landing_page_identifier"/> ... </AllowablePointsOfSale> <Custom[1-5]>custom_value</Custom[1-5]> </Result> ... </Transaction>
Atributos
El elemento <Result>
tiene los siguientes atributos:
Atributo | ¿Es obligatorio? | Tipo | Descripción |
---|---|---|---|
mergeable | Optional | boolean | De forma predeterminada, los precios nuevos para un par específico de itinerario y hotel
reemplazarán los precios anteriores (no vencidos) que se encuentren en la caché de Google. El
atributo combinable te permite almacenar precios adicionales en la caché de Google
sin borrar la información de precios anterior. La consulta de precios en tiempo real con respuestas de contexto siempre tendrá este atributo establecido en true (independientemente de tu respuesta al mensaje de transacción). |
Elementos secundarios
El elemento <Result>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<AllowablePointsOfSale> | Optional | Object | Una o más páginas de destino que son aptas para el hotel. Una página de destino es un sitio web que puede manejar el proceso de reserva del
usuario final. Para incluir explícitamente una página de destino determinada (y excluir otras), agrega uno o más elementos <AllowablePointsOfSale> que coincidan con el atributo id del elemento <PointOfSale> en el archivo de páginas de destino.
Si no incluyes este elemento, se considerarán aptas todas las páginas de destino definidas en el archivo para reservar la habitación. Para obtener más información, consulta la sintaxis del archivo de páginas de destino. |
<Baserate> | Optional | float | Es el precio de la habitación de la estadía. El valor de este elemento debe reflejar lo siguiente:
Si la habitación no está disponible para el itinerario, se debe omitir Para quitar un paquete de habitación, sigue las instrucciones que se indican en Cómo quitar un paquete de habitación. La <Baserate currency="USD">1200.40</Baserate> El elemento
|
<ChargeCurrency> | Optional | enum | Indica cuándo y dónde el usuario paga una reserva. Este elemento se puede usar en un mensaje Transaction en el elemento <Result> para el precio del hotel o en el bloque <PackageData> para un paquete de habitación.
Estos son los valores válidos:
El valor predeterminado es |
<Checkin> | Required | Date | Indica la fecha de entrada de un itinerario con el formato Date. La combinación de los elementos <Nights> y <Checkin> constituye un itinerario. |
<Custom[1‑5]> | Optional | string | Define un campo personalizado que puedes usar para pasar datos adicionales asociados con un hotel. Puedes pasar hasta cinco valores personalizados con los siguientes nombres de elementos:
Los elementos Los elementos <Custom> que se proporcionan en el elemento |
<ExpirationTime> | Optional | DateTime | Es la fecha y hora en la que el precio se considera vencido (mínimo de 3 horas).
Te recomendamos que no proporciones marcas de tiempo de vencimiento si no son fundamentales para tu estructura de precios. Google no publica precios vencidos, y cualquier itinerario que tenga un precio vencido será apto para la consulta de precios en tiempo real. |
<Nights> | Required | integer | Indica la cantidad de noches de un itinerario. El valor del elemento <Nights> debe ser un número entero positivo.
La combinación de <Nights> y <Checkin> constituye un itinerario. |
<OtherFees> | Optional | float | Son tarifas distintas de la tarifa base y los impuestos que influyen en el precio final de una habitación. El elemento <OtherFees> toma un único atributo obligatorio, currency , que define el código de moneda de tres letras para las tarifas. Por ejemplo, USD .
El elemento |
<Occupancy> | Optional | integer | Especifica la cantidad máxima de ocupantes permitidos para esta tarifa.
Cuando <Occupancy> aparece directamente en <Result> , debe especificar 2 o más. <Occupancy> puede estar acompañado de <OccupancyDetails> , que especifica el tipo de invitados (adultos o niños). Si no se especifican los tipos de invitados, se supone que son adultos. Consulta <OccupancyDetails> para conocer la sintaxis y la descripción de los elementos secundarios. Si no se proporciona el elemento <Occupancy> , la ocupación se establece de forma predeterminada como 2 .
Nota: Comunícate con el equipo de asistencia al cliente para habilitar la función y enviar precios que no sean de ocupación doble. |
<PackageID> | Optional | string | Es el ID único del paquete que se asignará a los datos de paquetes predefinidos. También se usa para propagar la variable de la página de destino PACKAGE-ID. Para obtener más información, consulta los metadatos del paquete de habitaciones. |
<Property> | Required | string | Es el ID de un hotel afectado por los datos asociados (precio, itinerario, paquete de habitación o metadatos). El valor de este elemento debe ser una cadena. El valor de este elemento debe coincidir con la ficha <id> que definiste en tu feed de lista de hoteles.
|
<Rates> | Optional | <Rates> |
Es un contenedor para uno o más bloques <Rate> . Cada <Rate> de <Rates> define un precio diferente para la combinación de itinerario y habitación.
Usa el elemento Nota: Dentro de |
<Refundable> | Optional | Object | Permite publicar una tarifa como completamente reembolsable o proporcionar una cancelación
gratuita. De lo contrario, no se mostrará información sobre el reembolso.
Una política de reembolso a nivel de <PackageData> anula la política de reembolso a nivel de <Result> . Una política de reembolso a nivel de <Rates> anula la política de reembolso a nivel de <PackageData> . Los precios reembolsables también
se pueden destacar a los usuarios a través de opciones alternativas sin modificar
directamente el esquema de mensajes de transacción. Obtén más información sobre la
Política de tarifas reembolsables.
En el siguiente ejemplo, se muestra el elemento <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Nota: Te recomendamos configurar todos los atributos. Se genera un mensaje de advertencia sobre el estado del feed cuando no se configuran uno o más atributos. Si no configuras ningún atributo, la tarifa no se mostrará como reembolsable. Los atributos son los siguientes:
Cuando configures los atributos, ten en cuenta lo siguiente:
|
<RoomBundle> | Optional | <RoomBundle> |
Es un contenedor de información sobre las descripciones físicas de una habitación con precio,
cualquier empaquetado de comodidades y algunos detalles de la política de compras del
itinerario y hotel determinados.
En general, usa este elemento para definir el precio de la habitación base y los diferentes tipos de habitaciones dentro de la misma propiedad. Si bien es posible definir las descripciones del paquete de habitación intercaladas, debes usar un mensaje Transaction independiente para definir esa información. Google almacenará metadatos para que puedas hacer referencia a ellos, en lugar de repetirlos, en todas las actualizaciones de precios futuras. |
<RoomID> | Optional | string | Es el ID único de la sala para asignarla a datos predefinidos. También se usa para propagar la variable de la página de destino PARTNER-ROOM-ID. Para obtener más información, consulta los metadatos del paquete de Room. |
<Tax> | Optional | float | Son los impuestos que se calculan sobre el precio final de una habitación.
El elemento <Tax> toma un único atributo obligatorio, currency , que define el código de moneda de tres letras para los impuestos. Por ejemplo, USD . El elemento <Tax> es obligatorio si <Baserate> es mayor que cero. |
<Unavailable> | Optional | Object | Indica que el itinerario no está disponible para reservas. Funciona como contenedor para los motivos más detallados por los que el itinerario no estaba disponible. Uno o más de los siguientes motivos de falta de disponibilidad pueden anidarse debajo de la etiqueta <Unavailable> :
|
Ejemplos
Ejemplo de varias propiedades
En el siguiente ejemplo, se define un itinerario y sus precios para dos propiedades:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
</Result>
<Result>
<Property>052213</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">299.98</Baserate>
<Tax currency="USD">26.42</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="otto"/>
<PointOfSale id="simon"/>
</AllowablePointsOfSale>
</Result>
</Transaction>
En este ejemplo, no se muestran detalles de la habitación, como una descripción, una foto y leyenda, el nombre de la habitación y su capacidad.
Puedes definir esa información una vez en un mensaje Transaction independiente que Google almacena. Luego, podrás hacer referencia a él en todas las actualizaciones de precios y de inventario posteriores. Para obtener más información, consulta los metadatos del paquete de habitaciones.
Ejemplo de tarifas múltiples
En el siguiente ejemplo, se define un solo itinerario y una propiedad con varias tarifas para diferentes ocupaciones. Se puede usar el elemento <Rates>
para proporcionar precios de varias tarifas para una propiedad específica. El siguiente ejemplo también es útil para las propiedades de Alquileres de vacaciones (RV):
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-23T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2021-01-13</Checkin>
<Nights>9</Nights>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>2</Occupancy>
<Rates>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>1</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>3</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>4</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>5</Occupancy>
</Rate>
<Rate>
<Baserate currency="USD">3196.1</Baserate>
<Tax currency="USD">559.49</Tax>
<OtherFees currency="USD">543.34</OtherFees>
<Occupancy>6</Occupancy>
</Rate>
</Rates>
</Result>
</Transaction>
Ejemplo no disponible
En el siguiente ejemplo, se define un itinerario cuya disponibilidad no se pudo recuperar de canales descendentes, un segundo que está por debajo de la estadía mínima de una noche y ya se reservó para las fechas especificadas, y un tercero cuya propiedad está cerrada en la fecha de llegada, pero que se abre durante el transcurso de la estadía:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Unavailable>
<NotFetched/>
</Unavailable>
</Result>
<Result>
<Property>073313</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Unavailable>
<NoVacancy/>
<MinNightStay value=3/>
</Unavailable>
</Result>
<Result>
<Property>052213</Property>
<Checkin>2018-06-10</Checkin>
<Nights>10</Nights>
<Unavailable>
<PropertyClosed first_open="2018-06-15" first_closed="2018-06-10"/>
</Unavailable>
</Result>
</Transaction>
<Rates>
Es un contenedor para uno o más bloques <Rate>
. Cada <Rate>
de <Rates>
define un precio diferente para la combinación de habitación o itinerario.
Usa el elemento <Rates>
solo cuando haya varias tarifas para la misma combinación de habitación o itinerario. Por ejemplo, puedes definir varias tarifas para las tarifas condicionales, las tarifas privadas o las tarifas condicionales de paquetes de habitación.
El elemento <Rates>
aparece en el siguiente lugar en la jerarquía XML del mensaje de transacción:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
(Can also contain<Rates>
) + ...
Los valores establecidos en un <Rate>
anulan los valores relacionados con los precios en el elemento <Result>
o <RoomBundle>
superior. Si no están configurados en <Rate>
, heredan su valor del elemento superior. Solo se hereda <AllowablePointsofSale> al elemento <RoomBundle>
.
Sintaxis
El elemento <Rates>
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> <Rates> <Rate rate_rule_id="rate_rule_id"> <Baserate currency="currency_code">price</Baserate> <Tax currency="currency_code">tax_amount</Tax> <OtherFees currency="currency_code">fee_amount</OtherFees> <ExpirationTime>expiration_time</ExpirationTime> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <AllowablePointsOfSale> <PointOfSale id="landing_page_identifier"/> </AllowablePointsOfSale> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults or children --></OccupancyDetails> ... <Custom[1-5]>custom_value</Custom[1-5]> </Rate> ... </Rates> </Result> ... </Transaction>
Atributos
El elemento <Rates>
tiene los siguientes atributos:
Atributo | ¿Es obligatorio? | Descripción |
---|---|---|
rate_rule_id | Optional | Para las tarifas condicionales, este ID hace coincidir una tarifa con una definición de tu archivo de definición de reglas de tarifas. El límite de caracteres de este campo es de 40. |
Elementos secundarios
El elemento <Rates>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<AllowablePointsOfSale> | Optional | Object | Una o más páginas de destino que son aptas para el hotel. Este elemento usa la misma sintaxis que <AllowablePointsOfSale> en <Result> . |
<Baserate> | Required | float | Es el precio de la habitación de la estadía. Este elemento usa la misma sintaxis que <Baserate> en <Result> .
Nota: No se puede definir el elemento secundario |
<ChargeCurrency> | Optional | enum | Indica cuándo y dónde el usuario paga una reserva. Este elemento usa la misma sintaxis que un <ChargeCurrency> en un <Result> . |
<Custom[1‑5]> | Optional | string | Son campos personalizados que puedes usar para pasar datos adicionales asociados con un hotel a una página de destino. Este elemento usa la misma sintaxis que un <Custom[1‑5]> en un <Result> . Hay un límite
de 200 caracteres por campo personalizado. Para obtener más información, consulta los
archivos de páginas de destino.
Si se proporcionan elementos <Custom> en el elemento |
<ExpirationTime> | Optional | DateTime | La fecha y hora en que la tarifa se considera vencida. Este elemento usa la misma sintaxis que un <ExpirationTime> en un <Result> . |
<Occupancy> | Optional | integer | Especifica la cantidad máxima de ocupantes permitidos para esta tarifa. Si no
se especifica, se supone que es la misma que la tarifa superior.
|
<OtherFees> | Required | float | Son tarifas distintas de la tarifa base y los impuestos que influyen en el precio final de una habitación. Este elemento usa la misma sintaxis que <OtherFees> en un <Result> . |
<Refundable> | Optional | Object | Permite publicar una tarifa como completamente reembolsable o proporcionar una cancelación
gratuita. De lo contrario, no se mostrará información sobre el reembolso.
Una política de reembolso a nivel de <PackageData> anula la política de reembolso a nivel de <Result> . Una política de reembolso a nivel de <Rates> anula la política de reembolso a nivel de <PackageData> . Los precios reembolsables también
se pueden destacar a los usuarios a través de opciones alternativas sin modificar
directamente el esquema de mensajes de transacción. Obtén más información sobre estas opciones
Política de tarifas reembolsables.
En el siguiente ejemplo, se muestra el elemento <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Nota: Te recomendamos configurar todos los atributos. Se genera un mensaje de advertencia sobre el estado del feed cuando no se configuran uno o más atributos. Si no configuras ningún atributo, la tarifa no se mostrará como reembolsable. Los atributos son los siguientes:
Cuando configures los atributos, ten en cuenta lo siguiente:
|
<Tax> | Required | float | Son los impuestos que se calculan sobre el precio final de una habitación. Este elemento usa la misma sintaxis que un <Tax> en un <Result> . |
Ejemplos
Tarifa base y tarifa condicional
En el siguiente ejemplo, se muestra un mensaje de transacción que contiene una tarifa base y una tarifa condicional:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">200.00</Baserate>
<Tax currency="USD">20.00</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Rates>
<!-- The rate_rule_id is required when using conditional rates -->
<Rate rate_rule_id="mobile">
<!-- Override base rate and taxes for conditional rates -->
<Baserate currency="USD">180.00</Baserate>
<Tax currency="USD">18.00</Tax>
<!-- NOTE: OtherFees is inherited from the above setting -->
<Custom1>ratecode123</Custom1>
</Rate>
</Rates>
</Result>
</Transaction>
Varias tarifas condicionales
En el siguiente ejemplo, se define una tarifa base y varias tarifas condicionales dentro de una <RoomBundle>
:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>2</Nights>
<!-- When Google receives new room bundle information for an itinerary, all
previous room bundle pricing is dropped from Google's cache. Thus, if you
want to delete a specific room bundle from Google's cache, you may do so
by simply not providing that specific room bundle in subsequent transaction
messages. -->
<RoomBundle>
...
<!-- RoomID is required, PackageID is recommended. -->
<RoomID>5</RoomID>
<PackageID>ABC</PackageID>
<!-- Baserate is required. -->
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<!-- RatePlanID is optional and represents the unique identifier for a
room and package data combination. We strongly recommend using RatePlanID
as a variable to build your dynamic landing page (formerly Point of Sale)
URL. For details, see Using Variables and Conditions. -->
<RatePlanID>5-ABC</RatePlanID>
<!-- Occupancy is mandatory for RoomBundle elements. -->
<!-- Elements below will get inherited to nested rate elements. -->
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
</OccupancyDetails>
<InternetIncluded>1</InternetIncluded>
<!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<!-- Neither rate overrides Custom2. -->
<Custom2>ratebasic</Custom2>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides ChargeCurrency from roombundle. -->
<ChargeCurrency>hotel</ChargeCurrency>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode321</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode432</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>
<RoomBundle>
Define el precio y la disponibilidad de los paquetes de habitaciones como elementos secundarios de <Result>
en un mensaje <Transaction>
. Define un elemento independiente para cada combinación de paquete o itinerario. Para definir el paquete y las condiciones de los paquetes de habitación, usa <RoomData>
.
El elemento <RoomBundle>
aparece en el siguiente lugar en la jerarquía XML del mensaje de transacción:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Para obtener más información, consulta Cómo usar los paquetes de habitación.
Sintaxis
El elemento <RoomBundle>
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> ... <RoomBundle> <!-- Required unless specified inline under<RoomData>
--> <RoomID>room_ID</RoomID> <!-- Required<PackageData>
--> <PackageID>package_ID</PackageID> <!-- Required --> <Baserate currency="currency_code">price</Baserate> <!-- Required --> <Tax currency="currency_code">taxes</Tax> <!-- Required --> <OtherFees currency="currency_code">other_fees</OtherFees> <Refundable available="[false|true]" refundable_until_days="number_of_days" refundable_until_time="time"/> <!-- Required --> <ChargeCurrency>[deposit|hotel|installments|web]</ChargeCurrency> <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <!-- optional info about the types of guests, whether adults or children --></OccupancyDetails> <BreakfastIncluded>boolean_value</BreakfastIncluded> <InternetIncluded>boolean_value</InternetIncluded> <ParkingIncluded>boolean_value</ParkingIncluded> <RatePlanID>rate_plan_ID</RatePlanID> <Rates>...</Rates> <Custom1>custom_value_1</Custom1> <Custom2>custom_value_2</Custom2> <Custom3>custom_value_3</Custom3> <Custom4>custom_value_4</Custom4> <Custom5>custom_value_5</Custom5> </RoomBundle> ... </Result> </Transaction>
Atributos
El elemento <RoomBundle>
no tiene atributos.
Elementos secundarios
El elemento <RoomBundle>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<Baserate> | Required | float | Define el precio del paquete de habitación de la estadía. Este elemento usa la misma sintaxis que <Baserate> en <Result> , con la siguiente excepción:
|
<BreakfastIncluded> | Optional | boolean | Especifica si este paquete de habitación incluye desayuno con la tarifa. |
<ChargeCurrency> | Optional | enum | Indica cuándo y dónde el usuario paga una reserva. Este elemento usa la misma sintaxis que <ChargeCurrency> en un <Result> .
El valor predeterminado es |
<Custom[1‑5]> | Optional | string | Campos personalizados para pasar datos adicionales a las páginas de destino del paquete de habitación. Estos elementos usan la misma sintaxis que <Custom[1-5]> en <Result> . Hay un límite de 200
caracteres por campo personalizado. Para obtener más información, consulta los archivos de páginas de destino.
Si se proporcionan elementos <Custom> en el elemento |
<InternetIncluded> | Optional | boolean | Si un paquete de habitación incluye acceso a Internet sin cargo, mientras que otros paquetes no incluyen ese servicio No configures este elemento para los paquetes de habitaciones en un hotel que ofrece Internet gratis a todas las habitaciones. Este elemento no se aplica a la conexión a Internet por cable o inalámbrica en la habitación que no está disponible en las habitaciones de huéspedes. |
<Occupancy> | Required | integer | Especifica la cantidad máxima de ocupantes permitidos para esta tarifa. Por ejemplo, una suite grande puede alojar 6 huéspedes físicamente, pero el "Paquete de luna de miel" permite solo 2 huéspedes.
Este valor debe ser menor o igual que Cuando definas la ocupación en la URL de tu página de destino, usa las variables El valor de Notas:
|
<OtherFees> | Required | float | Son tarifas distintas de la tarifa base y los impuestos que influyen en el precio final de una habitación. El elemento <OtherFees> toma un único atributo obligatorio, currency , que define el código de moneda de tres letras para las tarifas. Por ejemplo, usa USD para dólares estadounidenses. |
<PackageID> | Optional (recommended) | string | Es el ID único de los datos del paquete. Usa este ID para hacer coincidir los datos del paquete de habitación con los que se enviaron en <PackageData> . Para obtener más información, consulta los metadatos del paquete de Room. También puedes usar este ID para hacer referencia a una definición del paquete de habitación común que se utiliza en un solo mensaje de transacción cuando defines los datos del paquete de la habitación de forma intercalada. |
<ParkingIncluded> | Optional | boolean | Indica si el paquete de habitación incluye estacionamiento sin cargo, y el estacionamiento sería un servicio pagado en este hotel. No especifiques un valor para este elemento para un hotel que ofrece estacionamiento gratuito.
Los valores válidos son |
<RatePlanID> | Optional | string | El ID del plan de tarifas representa el identificador único de una combinación de habitación y paquete. Por ejemplo, con un valor <RoomID> de 5 y un valor <PackageID> de ABC, podrías usar un valor de 5-ABC para <RatePlanID> . Te recomendamos que uses
RatePlanID como una variable para crear la URL de tu página de destino
dinámica (antes conocida como punto de venta).
Para obtener más información, consulta Usa variables y condiciones. |
<Rates> | Optional | <Rates> |
Tarifas que anulan los valores predeterminados de este paquete de habitación. Este elemento usa la misma sintaxis que <Rates> en <Result> . |
<Refundable> | Optional | Object | Permite publicar una tarifa como completamente reembolsable o proporcionar una cancelación
gratuita. De lo contrario, no se mostrará información sobre el reembolso.
Una política de reembolso a nivel de <PackageData> anula la política de reembolso a nivel de <Result> . Una política de reembolso a nivel de <Rates> anula la política de reembolso a nivel de <PackageData> . Los precios reembolsables también
se pueden destacar a los usuarios a través de opciones alternativas sin modificar
directamente el esquema de mensajes de transacción. Obtén más información sobre estas opciones
Política de tarifas reembolsables.
En el siguiente ejemplo, se muestra el elemento <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Nota: Te recomendamos configurar todos los atributos. Se genera un mensaje de advertencia sobre el estado del feed cuando no se configuran uno o más atributos. Si no configuras ningún atributo, la tarifa no se mostrará como reembolsable. Los atributos son los siguientes:
Cuando configures los atributos, ten en cuenta lo siguiente:
|
<RoomID> | Required | string | Es el ID único de los datos de la habitación. Usa este ID para hacer coincidir los datos del paquete de habitación con los que enviaste en <RoomData> .
Para obtener más información, consulta los
metadatos del paquete de habitación. También puedes usar este ID para hacer referencia a la definición de una sala común en un solo mensaje de transacción cuando definas los datos de la sala de forma intercalada. |
<Tax> | Required | float | Son los impuestos que se calculan sobre el precio final de una habitación.
El elemento <Tax> toma un único atributo obligatorio, currency , que define el código de moneda de tres letras para los impuestos. Por ejemplo, usa USD para dólares estadounidenses. |
Ejemplos
Paquete de ocupación individual
En el siguiente ejemplo, se define una respuesta con un solo paquete de ocupación.
Cuando un usuario selecciona 1
en el selector de ocupación, Google muestra el precio apto más bajo, sin importar la ocupación.
Si no hay un precio de habitación única disponible, Google mostrará el precio más bajo de habitación doble. Ten en cuenta que los precios de las habitaciones individuales no se consultan en vivo si se almacenan en caché los precios de las habitaciones dobles o más para un itinerario.
En este ejemplo, se hace referencia a los metadatos predefinidos de habitaciones y paquetes con los elementos <RoomID>
y <PackageID>
. Usa los elementos <RoomData>
y <PackageData>
para definir esa información.
<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 1 example ----->
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
<!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
<!-- Note: Once defined it does not have to be repeated for future
Transaction Messages.
PropertyDataSets can also be defined and sent in their own
Transaction Message separately from pricing. Google can be
configured to pull just PropertyDataSets once per day
(or on a predefined frequency). -->
<PropertyDataSet>
<Property>180054</Property>
<!-- Can be reused by multiple Room Bundles -->
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Queen Room - Non-Smoking" language="en"/>
<Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<!-- Room can accommodate up to 4, but package data specifies occupancy
between 1 to 4 -->
<Capacity>4</Capacity>
</RoomData>
<RoomData>
<RoomID>436233</RoomID>
<Name>
<Text text="Premium King Room - Non-Smoking" language="en"/>
<Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<Capacity>4</Capacity>
</RoomData>
<!-- Can be reused by multiple Room Bundles -->
<PackageData>
<PackageID>P11111</PackageID>
<Occupancy>1</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P54321</PackageID>
<Occupancy>2</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P12345</PackageID>
<Occupancy>4</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="1"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
</PropertyDataSet>
<!-- Efficient method of defining Room Bundles -->
<!-- Part 2: Reference RoomData and PackageData through ID -->
<Result>
<!-- Single occupancy pricing will be specified in a room bundle below -->
<Property>180054</Property>
<Checkin>2017-10-07</Checkin>
<Nights>2</Nights>
<!-- Base Room Bundle -->
<RoomBundle>
<RoomID>060773</RoomID>
<PackageID>P54321</PackageID>
<Baserate currency="USD">199.99</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RatePlanID>060773-P54321</RatePlanID>
</RoomBundle>
<RoomBundle>
<RoomID>060773</RoomID>
<PackageID>P11111</PackageID>
<!-- Price for 1 ("occupancy") is the lowest price and will be
displayed -->
<Baserate currency="USD">174.99</Baserate>
<Tax currency="USD">22.08</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RatePlanID>060773-P11111</RatePlanID>
</RoomBundle>
<!-- Premium Room Bundle -->
<RoomBundle>
<RoomID>436233</RoomID>
<PackageID>P12345</PackageID>
<!-- Price for 4 ("occupancy"), any eligible room bundle with 1 or more
occupancy will be displayed-->
<Baserate currency="USD">298.88</Baserate>
<Tax currency="USD">42.12</Tax>
<OtherFees currency="USD">10.00</OtherFees>
<RatePlanID>436233-P12345</RatePlanID>
</RoomBundle>
<!-- ..Continue providing all available RoomBundle rates under matched
property for 1 or more occupancies..-->
</Result>
</Transaction>
Dos o más ocupaciones
En el siguiente ejemplo, se define una respuesta que contiene dos o más ocupaciones.
En este ejemplo, se hace referencia a los metadatos predefinidos de habitaciones y paquetes con los elementos <RoomID>
y <PackageID>
. Usa los elementos <RoomData>
y <PackageData>
para definir esa información.
<!-- Efficient method of defining Room Bundles-->
<!----- Occupancy of 3 example ----->
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="12345678">
<!-- Efficient method of defining Room Bundles-->
<!-- Part1: Define RoomData and PackageData in PropertyDataSet -->
<PropertyDataSet>
<Property>180054</Property>
<!-- Can be reused by multiple Room Bundles -->
<RoomData>
<RoomID>060773</RoomID>
<Name>
<Text text="Single Queen Room - Non-Smoking" language="en"/>
<Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<!-- Room can accommodate up to 4, but package data specifies occupancy
between 1 to 4 -->
<Capacity>4</Capacity>
</RoomData>
<RoomData>
<RoomID>436233</RoomID>
<Name>
<Text text="Premium King Room - Non-Smoking" language="en"/>
<Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/>
</Name>
<Capacity>4</Capacity>
</RoomData>
<!-- Can be reused by multiple Room Bundles -->
<PackageData>
<PackageID>P33333</PackageID>
<Occupancy>3</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="7"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
<PackageData>
<PackageID>P12345</PackageID>
<Occupancy>4</Occupancy>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="1" refundable_until_days="1"
refundable_until_time="18:00:00"/>
<ParkingIncluded>1</ParkingIncluded>
<InternetIncluded>1</InternetIncluded>
</PackageData>
</PropertyDataSet>
<Result>
<Property>180054</Property>
<Checkin>2017-10-07</Checkin>
<Nights>2</Nights>
<!-- Efficient method of defining Room Bundles -->
<!-- Part 2: Reference RoomData and PackageData through ID -->
<!-- Base Room Bundle -->
<RoomBundle>
<!-- Baserate above and attributes must match atleast one room bundle
below -->
<RoomID>060773</RoomID>
<PackageID>P33333</PackageID>
<Baserate currency="USD">499.99</Baserate>
<Tax currency="USD">55.12</Tax>
<OtherFees currency="USD">22.00</OtherFees>
</RoomBundle>
<!-- Premium Room Bundle -->
<RoomBundle>
<RoomID>436233</RoomID>
<PackageID>P12345</PackageID>
<!-- Lowest price for 3 ("occupancy"), shown below, will be displayed -->
<Baserate currency="USD">598.88</Baserate>
<Tax currency="USD">62.12</Tax>
<OtherFees currency="USD">30.00</OtherFees>
</RoomBundle>
<!-- ..Continue providing all available RoomBundle rates under matched
property for 2 or more occupancies..-->
</Result>
</Transaction>
Varios paquetes de habitaciones
En el siguiente ejemplo, se configura la ocupación en varios paquetes de habitaciones para demostrar los posibles precios de las habitaciones de un hostal.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction ... >
<Result>
...
<!-- Suite Room Bundle -->
<RoomBundle>
<RoomID>suite1</RoomID>
<PackageID>standard</PackageID>
<Occupancy>2</Occupancy>
<!-- Price for room -->
<Baserate currency="USD">80.00</Baserate>
<Tax currency="USD">5.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="Suite for 2" language="en"/>
</Name>
</RoomData>
</RoomBundle>
<!-- Small Dorm Room Bundle -->
<RoomBundle>
<RoomID>small_dorm</RoomID>
<PackageID>economy</PackageID>
<Occupancy>1</Occupancy>
<!-- Price per bed -->
<Baserate currency="USD">35.00</Baserate>
<Tax currency="USD">3.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="1 bed in small dorm" language="en"/>
</Name>
</RoomData>
</RoomBundle>
<!-- Large Dorm Room Bundle -->
<RoomBundle>
<RoomID>large_dorm</RoomID>
<PackageID>economy</PackageID>
<Occupancy>1</Occupancy>
<!-- Price per bed -->
<Baserate currency="USD">20.00</Baserate>
<Tax currency="USD">2.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<RoomData>
<Name>
<Text text="1 bed in large dorm" language="en"/>
</Name>
</RoomData>
</RoomBundle>
...
</Result>
</Transaction>
Varias tarifas condicionales
En el siguiente ejemplo, se define una tarifa base y varias tarifas condicionales dentro de una <RoomBundle>
:
<?xml version="1.0" encoding="UTF-8" ?>
<Transaction timestamp="2023-05-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2023-04-10</Checkin>
<Nights>2</Nights>
<!-- When Google receives new room bundle information for an itinerary, all
previous room bundle pricing is dropped from Google's cache. Thus, if you
want to delete a specific room bundle from Google's cache, you may do so
by simply not providing that specific room bundle in subsequent transaction
messages. -->
<RoomBundle>
...
<!-- RoomID is required, PackageID is recommended. -->
<RoomID>5</RoomID>
<PackageID>ABC</PackageID>
<!-- Baserate is required. -->
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<!-- RatePlanID is optional and represents the unique identifier for a
room and package data combination. We strongly recommend using RatePlanID
as a variable to build your dynamic landing page (formerly Point of Sale)
URL. For details, see Using Variables and Conditions. -->
<RatePlanID>5-ABC</RatePlanID>
<!-- Occupancy is mandatory for RoomBundle elements. -->
<!-- Elements below will get inherited to nested rate elements. -->
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
</OccupancyDetails>
<InternetIncluded>1</InternetIncluded>
<!-- Rate rule "mobile" overrides chargeCurrency, "us_or_gb" doesn't. -->
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<!-- Neither rate overrides Custom2. -->
<Custom2>ratebasic</Custom2>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides ChargeCurrency from roombundle. -->
<ChargeCurrency>hotel</ChargeCurrency>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode321</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<!-- The value below overrides Custom1 from roombundle. -->
<Custom1>ratecode432</Custom1>
<!-- Custom2 is inherited from roombundle. -->
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>
<OccupancyDetails>
<Occupancy>
en un mensaje de transacción especifica la cantidad máxima de huéspedes para una habitación o un paquete. <OccupancyDetails>
puede contener información adicional, como la cantidad y el tipo de huéspedes (adultos o niños).
Cuando <Occupancy>
y <OccupancyDetails>
aparecen dentro del elemento <Rates>
de <Result>
o <RoomBundle>
, significa que la tarifa está restringida por los detalles de ocupación.
Sintaxis
Cuando aparece <OccupancyDetails>
, siempre está precedido por <Occupancy>
.
Ten en cuenta la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?> <Transaction ... > <Result> ... <Occupancy>max_number_of_intended_occupants</Occupancy> <OccupancyDetails> <NumAdults>number_of_adults</NumAdults> <Children> <Child age=age_of_one_child_guest/> <Child age=age_of_one_child_guest/> </Children> </OccupancyDetails> </Result> </Transaction>
Elementos secundarios
El elemento <OccupancyDetails>
tiene los siguientes elementos secundarios:
Elemento secundario | ¿Obligatorio? | Tipo | Descripción |
---|---|---|---|
<NumAdults> | Required | integer | Indica la cantidad de huéspedes adultos. Min:1, Máx.:20. |
<Children> | Optional | Object | Un contenedor para uno o más elementos <Child> . |
<Child age> | Optional | integer | Es la edad máxima para este niño, por ejemplo, <Child age="17"> . |
Ejemplos
En los siguientes ejemplos, se muestra cómo puede aparecer <OccupancyDetails>
en <Results>
, <RoomBundle>
o el elemento secundario <Rates>
.
Respuesta de resultado
En el siguiente ejemplo, se define un itinerario y su precio para una propiedad en respuesta a una consulta de precios en tiempo real en la que el usuario especificó la cantidad y los tipos de huéspedes. Aquí, los <OccupancyDetails>
(2 adultos y un niño) se muestran en <Result>
.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>060773</Property>
<RoomID>RoomType101</RoomID>
<PackageID>Package101</PackageID>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">278.33</Baserate>
<Tax currency="USD">25.12</Tax>
<OtherFees currency="USD">2.00</OtherFees>
<AllowablePointsOfSale>
<PointOfSale id="site1"/>
</AllowablePointsOfSale>
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
</Result>
</Transaction>
Califica la respuesta
En el siguiente ejemplo, se define un itinerario y sus precios para 1 adulto y 1 niño. Aquí, los <OccupancyDetails>
se muestran en el elemento <Rates>
de <Result>
.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Transaction id="Wtdj8QoQIWcAAbaTGlIAAAC4" timestamp="2018-04-18T11:27:45-04:00">
<Result>
<Property>8251</Property>
<Checkin>2018-06-20</Checkin>
<Nights>1</Nights>
<Baserate currency="USD">62.18</Baserate>
<Tax currency="USD">2.45</Tax>
<OtherFees currency="USD">0.00</OtherFees>
<Rates>
<Rate rate_rule_id="rule-951">
<Occupancy>2</Occupancy>
<OccupancyDetails>
<NumAdults>1</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<Baserate currency="USD">42.61</Baserate>
<Tax currency="USD">5.70</Tax>
<OtherFees currency="USD">0.00</OtherFees>
<Custom1>abc4</Custom1>
<AllowablePointsOfSale>
<PointOfSale id="yourhotelpartnersite.com"/>
</AllowablePointsOfSale>
</Rate>
</Rates>
</Result>
</Transaction>
Paquete de habitación
En el siguiente ejemplo, se define una ocupación de 2 adultos y 1 niño por dos noches, con una tarifa reembolsable. Aquí, <OccupancyDetails>
aparece dentro de <RoomBundle>
.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-23T16:20:00-04:00" id="42">
<Result>
<Property>6781291</Property>
<Checkin>2017-08-05</Checkin>
<Nights>2</Nights>
...
<RoomBundle>
<RoomID>10291</RoomID>
<RatePlanID>564739</RatePlanID>
<PackageID>564739</PackageID>
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
</Children>
</OccupancyDetails>
<ChargeCurrency>web</ChargeCurrency>
<Refundable available="true" refundable_until_days="1" refundable_until_time="23:59:00" />
<Baserate currency="USD">185.34</Baserate>
<Tax currency="USD">37.06</Tax>
<OtherFees currency="USD">2.22</OtherFees>
</RoomBundle>
</Result>
</Transaction>
Varios paquetes de habitaciones
En el siguiente ejemplo, se definen varias tarifas de <RoomBundle>
que están restringidas a una capacidad para 2 adultos y 2 niños. Aquí, los <OccupancyDetails>
aparecen en el elemento <Rates>
de <RoomBundle>
.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
<Result>
<Property>1234</Property>
<Checkin>2018-06-10</Checkin>
<Nights>2</Nights>
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">0</OtherFees>
<RoomBundle>
<RoomID>5</RoomID>
<PackageID>STD</PackageID>
<Baserate currency="USD">275.00</Baserate>
<Tax currency="USD">27.50</Tax>
<OtherFees currency="USD">0</OtherFees>
<InternetIncluded>1</InternetIncluded>
<ChargeCurrency>web</ChargeCurrency>
<Custom1>ratebasic</Custom1>
<Custom2>ratebasic</Custom2>
<Occupancy>4</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<Children>
<Child age="17"/>
<Child age="17"/>
</Children>
</OccupancyDetails>
<Rates>
<Rate rate_rule_id="mobile">
<Baserate currency="USD">258.33</Baserate>
<Tax currency="USD">25.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<ChargeCurrency>hotel</ChargeCurrency>
<Custom1>ratecode321</Custom1>
</Rate>
<Rate rate_rule_id="us_or_gb">
<Baserate currency="USD">268.33</Baserate>
<Tax currency="USD">26.83</Tax>
<OtherFees currency="USD">1.00</OtherFees>
<Custom1>ratecode432</Custom1>
</Rate>
</Rates>
</RoomBundle>
</Result>
</Transaction>