Solicitudes
Sintaxis
El mensaje Transaction (Property Data)
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp"
id="message_ID"
partner="partner_key">
<PropertyDataSet action="[overlay|delta]">
<!-- (Required) ID that matches the Hotel List Feed -->
<Property>HotelID</Property>
<RoomData>
<!-- (Required) One room ID per RoomData element -->
<RoomID>RoomID</RoomID>
<Name>
<Text text="room_name" language="language_code"/>
</Name>
<Description>
<Text text="room_description" language="language_code"/>
</Description>
<!-- (Optional) Restricts the rate plans allowed for this room type to
those listed here. If specified, don't specify AllowableRoomIDs. -->
<AllowablePackageIDs>
<AllowablePackageID>PackageID</AllowablePackageID>
</AllowablePackageIDs>
<Capacity>max_number_of_occupants</Capacity>
<AdultCapacity>max_number_of_adult_occupants</AdultCapacity>
<ChildCapacity>max_number_of_child_occupants</ChildCapacity>
<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>
<JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle>
<Beds>
<Bed size="[single|semi_double|double|queen|king]">
<Width unit="cm" number="bed_width"/>
<Length unit="cm" number="bed_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>
<PackageData>
<!-- (Required) One package ID per PackageData element -->
<PackageID>PackageID</PackageID>
<Name>
<Text text="package_name" language="language_code"/>
</Name>
<Description>
<Text text="package_description" language="language_code"/>
</Description>
<!-- (Optional) Restricts the room types allowed for this rate plan to
those listed here. If specified, don't specify AllowablePackageIDs. -->
<AllowableRoomIDs>
<AllowableRoomID>RoomID</AllowableRoomID>
</AllowableRoomIDs>
<Refundable available="[false|true]" refundable_until_days="number_of_days"
refundable_until_time="time"/>
<!-- 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>
</PackageData>
</PropertyDataSet>
</Transaction>
Elementos y atributos
El mensaje de transacción (datos de propiedad) tiene los siguientes elementos y atributos:
Elemento / @Attribute | Occurrences | Tipo | Descripción |
---|---|---|---|
Transaction | 1 | Complex element | En una implementación de ARI, este es el elemento raíz de un mensaje que define los tipos de habitaciones y los paquetes para una sola propiedad. |
Transaction / @timestamp | 1 | DateTime | La fecha y hora de creación de este mensaje. |
Transaction / @id | 1 | string | Un identificador único para este mensaje de solicitud. Este valor se muestra en el mensaje de respuesta. Los caracteres permitidos son a-z, A-Z, 0-9, _ (guion bajo) y - (guion). |
Transaction / @partner | 1 | string | La cuenta de socio de este mensaje. Este valor de string es el valor de “Clave de socio” que aparece en la
página Configuración de la cuenta de Hotel Center.
Nota: Si tienes un backend que proporciona feeds para varias cuentas, este valor debe coincidir con el valor del atributo |
Transaction / PropertyDataSet | 1.. | PropertyDataSet | Es un contenedor para definir los tipos de habitaciones y paquetes de una sola propiedad. |
Transaction / PropertyDataSet / @action | 0..1 | enum | Es el tipo de actualización que se aplica a las definiciones de tarifa de la habitación. Estos son los valores válidos:
Este atributo es opcional y, si no se especifica, se establece de forma predeterminada como |
Transaction / PropertyDataSet / Property | 1 | string | Es el identificador único de la propiedad. Este valor debe coincidir con el ID de hotel especificado con
<id> en el elemento <listing> del feed de lista de hoteles. El ID de hotel también aparece en Hotel Center. |
Transaction / PropertyDataSet / RoomData | 0..n | RoomData | Describe una habitación. Nota: Se requiere al menos uno de los valores |
Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | Es un identificador único para un tipo de habitación. Se hace referencia a este valor mediante el atributo InvTypeCode en el elemento <StatusApplicationControl> en los mensajes <OTA_HotelAvailNotifRQ> y <OTA_HotelRateAmountNotifRQ> . |
Transaction / PropertyDataSet / RoomData / Name | 1 | Name | Es el contenedor para el nombre de la categoría de la habitación en uno o más idiomas. |
Transaction / PropertyDataSet / RoomData / Name / Text | 1..n | Text | Especifica el nombre de la categoría de habitación en un idioma. |
Transaction / PropertyDataSet / RoomData / Name / Text / @text | 1..n | string | Es el nombre de la categoría de habitación en el idioma especificado por el atributo language . |
Transaction / PropertyDataSet / RoomData / Description | 1 | Name | Es el contenedor para la descripción de la categoría de habitación en uno o más idiomas. |
Transaction / PropertyDataSet / RoomData / Description / Text | 1..n | Text | Especifica la descripción de la categoría de habitación en un idioma. |
Transaction / PropertyDataSet / RoomData / Description / Text / @text | 1..n | string | Es la descripción de la categoría de habitación en el idioma especificado por el atributo language . |
Transaction / PropertyDataSet / RoomData / Description / Text / @language | 1..n | string | Un código de idioma de dos letras. |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs | 0..1 | AllowablePackageIDs | Un contenedor para elementos <AllowablePackageID> .
Si se especifica Si no se especifica Usa |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | Especifica el PackageID de un plan de tarifas que se puede combinar con este
tipo de habitación. Un plan de tarifas se define mediante una combinación de
paquetes, tarifas y disponibilidad. El PackageID corresponde al RatePlanCode en los mensajes OTA_HotelRateAmountNotifRQ y OTA_HotelAvailNotifRQ.
|
Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | Indica la cantidad máxima de adultos y niños que puede alcanzar físicamente una habitación. Debe ser mayor o igual que cualquier valor de NumberOfGuests que envíes con las tarifas.
El valor de Nota: Si no se configura |
Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | Corresponde a la cantidad máxima de adultos que pueden hospedarse físicamente en una habitación. Debe ser mayor o igual que cualquier valor de NumberOfGuests que envíes con las tarifas.
El valor de |
Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | Corresponde a la cantidad máxima de niños que puede alcanzar físicamente una habitación.
El valor de |
Transaction / PropertyDataSet / RoomData / OccupancySettings | 0..1 | OccupancySettings | 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. |
Transaction / PropertyDataSet / RoomData / PhotoURL | 0..n | PhotoURL | 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.
Este elemento toma los siguientes elementos secundarios:
<PhotoURL> <URL>http://www.example.com/image1.jpg</URL> <Caption> <Text text="A bright way to enjoy your mornin' cuppa tea." language="en"/> <Text text="Une façon lumineuse pour profiter de votre tasse de thé." language="fr"/> </Caption> </PhotoURL> |
Transaction / PropertyDataSet / RoomData / RoomFeatures | 0..1 | <RoomFeatures> |
Contiene información sobre las características de la habitación. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle | 0..1 | enum | Indica el estilo de una habitación de hotel japonesa. Estos son los valores válidos:
|
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds | 0..1 | Object | Contiene tantos <Bed> como la sala. Ten en cuenta
que los futones japoneses no deben 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> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Suite | 0.. | enum | Proporciona este elemento cuando la habitación sea una suite. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule | 0..1 | enum | Proporciona este elemento cuando esta habitación sea una sala tipo cápsula. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing | 0..1 | enum | Si esta habitación se comparte con otros ocupantes, como otros huéspedes o propietarios. Los valores válidos son shared y private . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor | 0..1 | enum | Proporciona este elemento cuando la habitación sea un alojamiento al aire libre que no tenga paredes fijas, plomería ni climatización. Por ejemplo, las habitaciones de hotel no son alojamiento al aire libre, mientras que los campamentos donde los huéspedes se hospedan en carpas y parques para autocaravanas en los que los huéspedes traen su propia casa rodante son alojamiento al aire libre. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible | 0..1 | enum | Proporciona este elemento cuando la sala sea accesible para personas con movilidad reducida. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking | 0..1 | enum | Indica si esta habitación es para no fumadores o para fumadores. Los valores válidos son non_smoking y smoking . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet | 0..1 | Object | Contiene información sobre un baño y el baño de 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> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath | 0..1 | enum | Proporciona este elemento cuando la habitación tenga baño privado al aire libre. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning | 0..1 | enum | Proporciona este elemento cuando la habitación tenga aire acondicionado. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony | 0..1 | enum | Proporciona este elemento cuando la habitación tenga balcón o terraza. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views | 0..1 | Object | Entre las opciones válidas, se incluyen las siguientes:
|
Transaction / PropertyDataSet / PackageData | 0..n | PackageData | Contenedor de elementos que describen características y términos de tarifas que no forman parte de la descripción de la sala física. Nota: Se requiere al menos uno de los valores |
Transaction / PropertyDataSet / PackageData / PackageID | 1 | string | Las PackageID de estos mensajes corresponden a las RatePlanCode en los mensajes OTA_HotelRateAmountNotifRQ y OTA_HotelAvailNotifRQ. |
Transaction / PropertyDataSet / PackageData / Name | 1 | Name | Es el contenedor del nombre del paquete en uno o más idiomas. |
Transaction / PropertyDataSet / PackageData / Name / Text | 1..n | Text | Especifica el nombre del paquete en un idioma. |
Transaction / PropertyDataSet / PackageData / Name / Text / @text | 1..n | string | Es el nombre del paquete en el idioma especificado por el atributo language . |
Transaction / PropertyDataSet / PackageData / Description | 1 | Description | Es el contenedor de la descripción del paquete en uno o más idiomas. |
Transaction / PropertyDataSet / PackageData / Description / Text | 1..n | Text | Especifica la descripción del paquete en un idioma. |
Transaction / PropertyDataSet / PackageData / Description / Text / @text | 1..n | string | Es la descripción del paquete en el idioma especificado por el atributo language . |
Transaction / PropertyDataSet / PackageData / Description / Text / @language | 1..n | string | Un código de idioma de dos letras. |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs | 0..1 | AllowableRoomIDs | Un contenedor para elementos <AllowableRoomID> .
Si se especifica Si no se especifica Usa |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID | 1..n | AllowableRoomID | Especifica el RoomID de un tipo de habitación que se puede combinar con este plan de tarifas. Un tipo de habitación se define en un elemento <RoomData> .
|
Transaction / PropertyDataSet / PackageData / Refundable | 0..1 | Refundable | Permite mostrar una tarifa como completamente reembolsable o cancelable. Si no se proporciona, no se mostrará información sobre el reembolso.
Nota: Te recomendamos que configures 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 estableces ningún atributo, la tarifa no se muestra como reembolsable. Cuando configures los atributos, ten en cuenta lo siguiente:
|
Transaction / PropertyDataSet / PackageData / Refundable / @available | 1 | boolean | Configúralo como 1 o true para indicar si la tarifa permite un reembolso total; de lo contrario, configúralo como 0 o false (obligatorio). |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days | 0..1 | integer | (Obligatorio si available es true ). Especifica la cantidad de días antes de la entrada en los que se puede solicitar un reembolso total. El valor de refundable_until_days debe ser un número entero entre 0 y 330, inclusive. |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time | 0.. | Time | (Se recomienda especialmente si available es true ). Especifica que se aceptará una solicitud de reembolso total en la última hora del día, en la hora local del hotel. Se puede combinar con
refundable_until_days para especificar, por
ejemplo, que “los reembolsos están disponibles hasta las 4:00 p.m. dos días antes de la
entrada”. Si no se configura refundable_until_time , el valor se establece de forma predeterminada en la medianoche. |
Transaction / PropertyDataSet / PackageData / BreakfastIncluded | 0..1 | boolean | Especifica si este tipo de habitación incluye desayuno.
Los valores válidos son 0 (o false ) y 1 (o true ).
Se recomienda que uses |
Transaction / PropertyDataSet / PackageData / CheckinTime | 0..1 | Time | Es la hora más temprana posible de registro de entrada en la hora local del hotel. La hora debe ser inferior a las 24:00. |
Transaction / PropertyDataSet / PackageData / CheckoutTime | 0..1 | Time | Hora de salida más reciente posible en la hora local del hotel. |
Transaction / PropertyDataSet / PackageData / InternetIncluded | 0..1 | boolean | Especifica si la habitación incluye acceso a Internet sin costo adicional, mientras que otras no lo incluyen. No configures este elemento en un hotel que ofrece Internet sin costo adicional 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 ).
|
Transaction / PropertyDataSet / PackageData / Meals | 0..1 | Object | Contiene información sobre las comidas de este paquete.
El elemento
Los atributos opcionales se usan solo cuando Para que los filtros de comida ( |
Transaction / PropertyDataSet / PackageData / ParkingIncluded | 0..1 | boolean | Indica si una habitación incluye estacionamiento sin cargo; de lo contrario, el estacionamiento sería un servicio pagado en este hotel. No especifiques un valor para este elemento en el caso de un hotel que ofrece estacionamiento gratuito.
Los valores válidos son 0 (o false ) y 1 (o true ). El valor predeterminado es false .
|
Transaction / PropertyDataSet / PackageData / PhotoURL | 0..1 | Object | (Igual que <PhotoURL> en <RoomData> , pero para el paquete (p.ej., fotos de comida).
|
Ejemplos
Datos de habitaciones y paquetes
El siguiente es un ejemplo básico de cómo definir los datos de la habitación y el paquete de una propiedad en un mensaje de transacción (datos de propiedad). Se usa el atributo overlay
para garantizar que, si ya existe algún dato inesperadamente, se borren todos los datos existentes y se reemplacen por los de este mensaje:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<Name>
<Text text="King" language="en"/>
</Name>
<Description>
<Text text="Room with a king bed" language="en"/>
</Description>
<Capacity>2</Capacity>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image.jpg</URL>
<Caption>
<Text text="Room with a king bed" language="en"/>
</Caption>
</PhotoURL>
</RoomData>
<RoomData>
<RoomID>RoomID_2</RoomID>
<Name>
<Text text="Double" language="en"/>
</Name>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Standard" language="en"/>
</Name>
<Description>
<Text text="Standard rate" language="en"/>
</Description>
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>0</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>PackageID_2</PackageID>
<Name>
<Text text="Free Breakfast" language="en"/>
</Name>
<Description>
<Text text="Free breakfast rate" language="en"/>
</Description>
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Agregar un tipo de habitación
El siguiente es un ejemplo de cómo agregar un tipo de habitación y un paquete a los datos de <Transaction>
existentes:
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="delta">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_3</RoomID>
<Name>
<Text text="Queen" language="en"/>
</Name>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
<PackageData>
<PackageID>PackageID_3</PackageID>
<Name>
<Text text="Non-Refundable" language="en"/>
</Name>
<!-- Additional PackageData child elements omitted. -->
<Refundable available="false"/>
</PackageData>
</PropertyDataSet>
</Transaction>
Quitar tipos de habitaciones
El siguiente es un ejemplo de cómo quitar paquetes y tipos de habitaciones existentes. En este caso, si los mensajes de "Datos de la habitación y el paquete" y "Agregar un tipo de habitación" ya se habían enviado a Google, los tipos de sala King
y Double
ya no existirían una vez que Google reciba el mensaje que se muestra. Ten en cuenta que quitar los datos de paquetes afecta el plan de tarifas general según se define en los mensajes de Transaction (Property), OTA_HotelRateAmountNotifRQ (cuando se hace referencia al mismo valor PackageID
) y, por lo tanto, es posible que se requieran actualizaciones correspondientes que usan los otros tipos de mensajes para reflejar que PackageID_2
y PackageID_3
ya no se definen aquí.OTA_HotelAvailNotifRQ
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-08-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<Name>
<Text text="Queen" language="en"/>
</Name>
<!-- Additional RoomData child elements omitted. -->
<Capacity>2</Capacity>
<PhotoURL>
<URL>http://www.foo.com/static/bar/image.jpg</URL>
<Caption>
<Text text="Room with a queen bed" language="en"/>
</Caption>
</PhotoURL>
</RoomData>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Refundable" language="en"/>
</Name>
<!-- Additional PackageData child elements omitted. -->
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>0</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Restringe planes de tarifas
El siguiente es un ejemplo de cómo usar el elemento <AllowablePackageIDs>
para restringir los planes de tarifas permitidos para un tipo de habitación. En este ejemplo, el tipo de habitación Queen
(RoomID_2
) solo se puede combinar con el paquete y el plan de tarifas identificados como PackageID_1.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<Name>
<Text text="King" language="en"/>
</Name>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
<RoomData>
<RoomID>RoomID_2</RoomID>
<Name>
<Text text="Queen" language="en"/>
</Name>
<AllowablePackageIDs>
<AllowablePackageID>PackageID_1</AllowablePackageID>
</AllowablePackageIDs>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
<PackageData>
<PackageID>PackageID_1</PackageID>
<Name>
<Text text="Standard" language="en"/>
</Name>
<!-- Additional PackageData child elements omitted. -->
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>0</BreakfastIncluded>
</PackageData>
<PackageData>
<PackageID>PackageID_2</PackageID>
<Name>
<Text text="Free Breakfast" language="en"/>
</Name>
<!-- Additional PackageData child elements omitted. -->
<Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
<BreakfastIncluded>1</BreakfastIncluded>
</PackageData>
</PropertyDataSet>
</Transaction>
Restringir la capacidad de la sala de reuniones
El siguiente es un ejemplo de cómo usar los elementos <Capacity>
, <AdultCapacity>
y <ChildCapacity>
para establecer restricciones en las capacidades de una sala.
<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<PropertyDataSet action="overlay">
<Property>Property_1</Property>
<RoomData>
<RoomID>RoomID_1</RoomID>
<Name>
<Text text="Double" language="en"/>
</Name>
<Capacity>4</Capacity>
<AdultCapacity>4</AdultCapacity>
<ChildCapacity>3</ChildCapacity>
<!-- Additional RoomData child elements omitted. -->
</RoomData>
</PropertyDataSet>
</Transaction>
El tipo de habitación doble (RoomID_1) puede incluir hasta 4 huéspedes en total. Además, puede tener hasta 4 adultos y 3 niños. Se deben cumplir los tres requisitos de capacidad para que se pueda reservar esta sala de reuniones. Esta configuración es representativa de una habitación típica con dos camas que tienen capacidad para dos personas. La capacidad secundaria es una menos que la capacidad total porque la habitación debe tener al menos un adulto presente.
Ejemplos ampliados con <RoomFeatures>
y comidas
JapaneseHotelRoomStyle
no tiene un valor predeterminado.
Si omites un valor, no se generará un error XML, pero tu ficha no se mostrará en los resultados de la búsqueda cuando el usuario filtre por el estilo de la habitación o las 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 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 información sobre la cantidad de camas en las habitaciones japanese_western
, consulta el siguiente 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>
Comidas
En el siguiente ejemplo, se definen los metadatos de habitaciones y paquetes correspondientes a comidas, fotos y horarios 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>
Solo 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>
Respuestas
Sintaxis
El mensaje TransactionResponse (Property Data)
usa la siguiente sintaxis:
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="timestamp"
id="message_ID"
partner="partner_key">
<!-- Either Success or Issues will be populated. -->
<Success/>
<Issues>
<Issue code="issue_code" status="issue_type">issue_description</Issue>
</Issues>
</TransactionResponse>
Elementos y atributos
El mensaje TransactionResponse (Property Data)
tiene los siguientes elementos y atributos:
Elemento / @Attribute | Occurrences | Tipo | Descripción |
---|---|---|---|
TransactionResponse | 1 | Complex element | Es el elemento raíz que indica el éxito o los problemas de un mensaje de solicitud de transacción recibido. |
TransactionResponse / @timestamp | 1 | DateTime | La fecha y hora de creación de este mensaje. |
TransactionResponse / @id | 1 | string | Es el identificador único del mensaje de transacción asociado. |
TransactionResponse / @partner | 1 | string | La cuenta de socio de este mensaje. |
TransactionResponse / Success | 0..1 | Success | Indica que el mensaje de transacción se procesó correctamente sin advertencias, errores ni fallas.
Cada mensaje contiene |
TransactionResponse / Issues | 0..1 | Issues | Es un contenedor para uno o más problemas encontrados durante el procesamiento del mensaje de transacción.
Cada mensaje contiene |
TransactionResponse / Issues / Issue | 1..n | Issue | Es la descripción de una advertencia, un error o una falla que se encontró durante el procesamiento del mensaje de transacción. Puedes encontrar detalles sobre estos problemas en Mensajes de error sobre el estado del feed. |
TransactionResponse / Issues / Issue / @code | 1 | integer | Es el identificador del problema. |
TransactionResponse / Issues / Issue / @status | 1 | enum | El tipo de problema detectado. Los valores válidos son |
Ejemplos
Se completó correctamente
La siguiente es una respuesta a un mensaje de transacción procesado correctamente.
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Success/>
</TransactionResponse>
Con problemas
La siguiente es una respuesta a un mensaje de transacción que no se procesó debido a errores.
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Issues>
<Issue code="1001" status="error">Example</Issue>
</Issues>
</TransactionResponse>