Esta página oferece uma referência para as Mensagens de transação baseadas em XML.
<Transaction>
O elemento raiz de uma Mensagem de transação
é <Transaction>
. É um contêiner para informações descritivas sobre quartos e pacotes e preços e disponibilidade de quartos e pacotes.
O elemento <Transaction>
aparece no seguinte local na
hierarquia XML da Mensagem de transação:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Mensagens que usam <Transaction>
como elemento raiz exigem pelo menos um
elemento filho. As mensagens de transação podem ter qualquer número de elementos filhos, contanto
que o tamanho total da mensagem não exceda 100 MB.
Sintaxe
O elemento <Transaction>
usa a seguinte sintaxe:
<?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
O elemento <Transaction>
tem os seguintes atributos:
Atributo | Obrigatório? | Tipo | Descrição |
---|---|---|---|
id | Required | string | Um identificador exclusivo para cada Mensagem de transação. |
partner | Optional | string | A conta do parceiro referente à Mensagem de transação. Normalmente, isso é usado se o back-end fornecer feeds de preços para várias contas de parceiros. Esse valor da string é o valor da "Chave do parceiro" listado na página de configurações da conta na Central para Hotéis. |
timestamp | Required | DateTime | O momento em que a Mensagem de transação foi enviada. Todas as mensagens enviadas com um carimbo de data/hora nas últimas 24 horas serão processadas, e as que não tiverem sido descartadas. As mensagens são processadas na ordem de |
Elementos filhos
O elemento <Transaction>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<PropertyDataSet> | Optional* | <PropertyDataSet> |
Descreve um quarto e Categorias de quarto específicos. Normalmente, esse elemento é usado em uma Mensagem de transação separada para definir valores compartilhados para Categorias de quarto e reduzir o tamanho das Mensagens de transação. |
<Result> | Optional* | <Result> |
Dados de preço para o itinerário de um quarto ou um elemento |
* É necessário incluir pelo menos <PropertyDataSet> ou <Result> . |
Exemplos
Dados do quarto
O exemplo a seguir define os dados do quarto em uma Mensagem de transação:
<?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>
Dados dos preços
O exemplo a seguir define os dados de preços em uma Mensagem de transação:
<?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 noite
O exemplo a seguir define os dados de preços para uma a sete noites a partir de 7 de junho 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 básicas e condicionais
O exemplo a seguir mostra uma Mensagem de transação que contém uma taxa básica e uma 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>
Remover inventário
O exemplo a seguir remove do inventário vários inventários (estadias de uma noite para várias datas diferentes) de um 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>
Um contêiner para informações de quarto e pacote (ou Categoria de quarto) em uma
mensagem <Transaction>
. Os valores definidos em um hotel substituem os definidos em um parceiro.
O Google armazena essas informações para que você não precise defini-las sempre que enviar atualizações de preços.
O elemento <PropertyDataSet>
aparece no seguinte local na
hierarquia XML da Mensagem de transação:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Para mais informações, consulte os metadados da Categoria de quarto.
Sintaxe
O elemento <PropertyDataSet>
usa a seguinte sintaxe:
<?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
O elemento <PropertyDataSet>
não tem atributos.
Elementos filhos
O elemento <PropertyDataSet>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<PackageData> | Optional* | <PackageData> |
Descreve uma Categoria de quarto. Esses dados são associados a um parceiro e
hotel, mas não a um itinerário. Esse elemento é semelhante a
<RoomData> , mas descreve comodidades e termos que não fazem parte
da descrição física do quarto.
Faça referência ao ID do pacote nas atualizações de preço. Para mais informações, consulte os Metadados de Categoria de quarto. |
<Property> | Required | string | O ID de um hotel ao qual os dados associados se aplicam. O valor desse elemento precisa ser uma string que corresponda ao <id> da ficha no seu feed de lista de hotéis.
|
<RoomData> | Optional* | <RoomData> |
Descreve um quarto. Esses dados são associados a um parceiro e hotel,
mas não a um itinerário.
Faça referência ao ID do quarto nas atualizações de preço. |
* É necessário incluir pelo menos <PackageData> ou <RoomData> . |
Exemplos
Dados de quartos e pacotes
O exemplo a seguir mostra dados de quartos e pacotes em um
<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>
Ao enviar preços e disponibilidade para este quarto e Categoria de quarto, você faz referência aos códigos de quarto e pacote nas mensagens de preço. O resultado é a redução significativa do tamanho das mensagens e da quantidade de erros que podem ocorrer devido a dados duplicados. Para mais informações, consulte os metadados da Categoria de quarto.
<RoomData>
Define metadados independentes do itinerário sobre os quartos e, por extensão, as Categorias de quarto (já que Categorias de quarto são quartos além de outras comodidades). Use <RoomData>
para reduzir a repetição de dados descritivos no seu feed de preços.
O elemento <RoomData>
aparece no seguinte local na
hierarquia XML da Mensagem de transação:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Os elementos <RoomData>
contêm informações associadas a um
parceiro e hotel, mas não a um itinerário. A finalidade pretendida é todos os dados não relacionados a itinerário.
O elemento <RoomData>
é semelhante a <PackageData>
, mas descreve
o quarto físico em vez de comodidades e termos de um pacote. Você usa
<RoomData>
e <PackageData>
em combinação para fornecer detalhes sobre
Categorias de quarto. Para quartos individuais que não fazem parte de um pacote, use apenas
<RoomData>
.
Você pode definir os elementos <RoomData>
e <PackageData>
para
o mesmo quarto ou Categoria de quarto. Quando o Google mostra esse quarto ou pacote nos resultados da pesquisa, ele inclui as descrições de ambos, separadas por um hífen.
Para mais informações, consulte os metadados da Categoria de quarto.
Sintaxe
O elemento <RoomData>
usa a seguinte sintaxe:
<?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
O elemento <RoomData>
não tem atributos.
Elementos filhos
O elemento <RoomData>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<Capacity> | Optional | integer | O número máximo de hóspedes que um quarto pode acomodar fisicamente. A capacidade de um quarto é maior ou igual à ocupação.
Quando especificado, esse valor precisa ser igual ou maior que o valor do elemento O valor de |
<Description> | Optional | Object | Uma descrição detalhada do cômodo. Esse elemento precisa conter informações não descritas em outros elementos ou no elemento <Name> . Não use todas as letras maiúsculas ao especificar a descrição do quarto.
O elemento
Use um elemento O exemplo a seguir mostra as versões em francês e inglês da descrição da sala: <Description> <Text text="Two queen-sized beds" language="en"/> <Text text="Deux lits de la reine" language="fr"/> </Description> |
<Name> | Required | string | O nome da categoria do quarto. Esse valor precisa corresponder ao que aparece na página de destino do hotel (antigo ponto de venda). Não defina o valor desse elemento com todas as letras maiúsculas.
Esse elemento tem somente um elemento filho,
Use um elemento O exemplo a seguir mostra as versões em francês e inglês do nome do quarto: <Name> <Text text="Standard Double Room" language="en"/> <Text text="Le chambre double" language="fr"/> </Name> |
<Occupancy> | Optional | integer | O número máximo de hóspedes para o qual uma sala se destina.
Por exemplo, uma suíte grande pode acomodar fisicamente seis hóspedes (capacidade = 6), mas destina-se apenas a até quatro pessoas.
Esse valor precisa ser menor ou igual ao elemento O valor de
|
<OccupancySettings> | Optional | Object | Configurações que podem restringir ou modificar os requisitos de ocupação de um quarto.
O elemento
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> Nem todos os elementos filhos precisam ser incluídos. |
<PhotoURL> | Optional | Object | Um URL e legenda opcional para uma foto do quarto ou da Categoria de quarto especificado. Você pode especificar mais de um <PhotoURL> para um quarto ou uma Categoria de quarto. Cada URL de foto precisa estar no próprio
<PhotoURL> .
Esse elemento tem os seguintes elementos-filho:
Exemplo: <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> |
Contém informações sobre as funcionalidades do quarto. |
<RoomID> | Required | string | O código exclusivo do quarto. Use esse ID para corresponder os dados do quarto aos blocos <Result> nas atualizações de preço. Para
mais informações, consulte os metadados da Categoria de quarto. Você também pode usar esse código para fazer referência a uma definição de quarto comum em uma única Mensagem de transação ao definir os dados do quarto inline. |
Exemplos
Dados do quarto
O exemplo a seguir define os dados do quarto:
<?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>
Metadados de quartos e pacotes
O exemplo a seguir define metadados de quartos e pacotes:
<?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>
Várias categorias de quarto
O exemplo a seguir define metadados de quartos e pacotes para vários Room Bundles:
<?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 os recursos encontrados na sala.
O elemento <RoomFeatures>
aparece no seguinte local na
hierarquia XML da Mensagem de transação:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<RoomFeatures>
Sintaxe
O elemento <RoomFeatures>
usa a seguinte sintaxe:
<?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
O elemento <RoomFeatures>
não tem atributos.
Elementos filhos
O elemento <RoomFeatures>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<JapaneseHotelRoomStyle> | Optional | enum | Indica o estilo de um quarto de hotel japonês. Os valores válidos são:
|
<Beds> | Optional | Object | Contém a quantidade de <Bed> que a sala tiver. Os futons japoneses não devem ser considerados aqui.
Cada
<Bed> tem os seguintes elementos filhos:
<Beds> <Bed size="double"> <Width unit="cm" number="140"/> <Length unit="cm" number="195"/> </Bed> <Bed/> <!-- Size unknown --> </Beds> |
<Suite> | Optional | empty | Forneça esse elemento quando o quarto for uma suíte. |
<Capsule> | Optional | empty | Informe esse elemento quando o quarto for uma sala-cápsula. |
<Roomsharing> | Optional | enum | Se a sala é compartilhada com outros ocupantes, como proprietários ou outros
convidados. Os valores válidos são: shared e private . |
<Outdoor> | Optional | empty | Forneça esse elemento quando a sala for um ambiente externo que não tenha paredes fixas, encanamento e controle de temperatura. Por exemplo, os quartos de hotel não são acomodações ao ar livre, enquanto acampamentos em que os hóspedes ficam em barracas e parques para trailers onde os hóspedes trazem seu próprio trailer são acomodações ao ar livre. |
<MobilityAccessible> | Optional | empty | Forneça esse elemento quando a sala tiver acessibilidade. |
<Smoking> | Optional | enum | Se este quarto é uma sala para não fumantes ou uma sala para fumantes. Os valores válidos
são non_smoking e smoking . |
<BathAndToilet> | Optional | Object | Contém informações sobre uma banheira e um vaso sanitário no quarto.
O atributo é:
Opcionalmente, o elemento tem os seguintes elementos-filho:
Exemplo: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
<OpenAirBath> | Optional | empty | Informe esse elemento quando o quarto tiver uma banheira privativa ao ar livre. |
<AirConditioning> | Optional | empty | Informe esse elemento quando o quarto tiver ar-condicionado. |
<Balcony> | Optional | empty | Forneça esse elemento quando o quarto tiver uma varanda ou uma varanda. |
<Views> | Optional | Object | As opções válidas incluem:
|
Exemplos
JapaneseHotelRoomStyle
não tem um valor padrão. A omissão de um valor não resulta em um erro de XML, mas sua página de detalhes não aparece nos resultados da pesquisa quando o usuário filtra por estilo de quarto ou camas.
Duas camas de solteiro
O exemplo abaixo mostra como 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>
Duas camas de casal
Confira a seguir um exemplo de quarto japonês no estilo western
com duas
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 sem cama
Veja a seguir um exemplo de um quarto em estilo japonês sem cama. As informações de cama não são necessárias para o quarto do 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>
Faroeste japonês com uma cama
Veja a seguir um exemplo de um quarto no estilo japanese_western
com cama do tamanho 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>
Se o parceiro não tiver a informação do número de camas nos quartos japanese_western
, siga este exemplo:
<?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 metadados independentes do itinerário sobre Categorias de quarto de uma propriedade. Esse elemento contém informações associadas a um parceiro e a um hotel, mas não a um itinerário. O objetivo é definir todos os dados que não são de itinerário uma vez e referenciá-los com base nesses dados.
O elemento <PackageData>
aparece no seguinte local na
hierarquia XML da Mensagem de transação:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
O elemento <PackageData>
é semelhante ao <RoomData>
, mas
descreve características e termos da tarifa que não fazem parte da descrição física
do quarto. Você usa <RoomData>
e <PackageData>
em combinação para
fornecer detalhes sobre Categorias de quarto e recursos de tarifa. Para quartos individuais que
não fazem parte de um pacote, use apenas <RoomData>
.
Você pode definir os elementos <RoomData>
e <PackageData>
para o
mesmo quarto ou Categoria de quarto. Quando o Google mostra esse quarto ou pacote nos resultados da pesquisa, ele inclui as descrições de ambos, separadas por um hífen.
Se você atualizar um único elemento <PackageData>
para uma propriedade, atualize todos os elementos <PackageData>
e <RoomData>
dela.
Cada <PropertyDataSet>
é considerado todos os dados sobre a propriedade e
substitui todos os dados existentes.
Para mais informações, consulte os metadados da Categoria de quarto.
Sintaxe
O elemento <PackageData>
usa a seguinte sintaxe:
<?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
O elemento <PackageData>
não tem atributos.
Elementos filhos
O elemento <PackageData>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<BreakfastIncluded> | Optional | boolean | Especifica se o pacote inclui café da manhã com a tarifa.
Os valores válidos são 0 (ou false ) e 1 (ou true ).
É preferível usar
|
<ChargeCurrency> | Optional | enum | Quando e onde o usuário paga uma reserva. Esse elemento usa a mesma sintaxe que <ChargeCurrency> em um <Result> .
O valor padrão é |
<CheckinTime> | Optional | Time | Horário de check-in mais cedo possível. As horas precisam ser menos de 24h no horário local do hotel. |
<CheckoutTime> | Optional | Time | Último horário de check-out possível no horário local do hotel. |
<Description> | Optional | Object | Uma descrição detalhada do pacote. Esse elemento precisa conter informações não descritas em outros elementos ou no elemento <Name> . Não use todas as letras maiúsculas ao especificar a descrição do quarto.
O 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 | Se um pacote inclui acesso à Internet sem custos financeiros,
mas outros não incluem essa comodidade. Não defina este elemento para Categorias de quarto em um hotel que oferece Internet gratuita para todos os quartos. Este elemento não se aplica à Internet com fio no quarto ou à Internet sem fio que não está disponível nos quartos de hóspedes. Os valores válidos são
0 (ou false ) e 1
(ou true ).
|
<Meals> | Optional | Object | Contém informações sobre as refeições neste pacote.
O elemento
Os atributos opcionais são usados apenas quando Para que os filtros de refeições ( |
<Name> | Required | string | O nome do pacote. Esse valor precisa corresponder ao que aparece na página de destino do hotel. Não defina o valor desse elemento com todas as letras
maiúsculas.
Esse elemento tem um único elemento filho, <Name> <Text text="Bed and Breakfast" language="en"/> <Text text="Lit et petit déjeuné" language="fr"/> </Name> |
<Occupancy> | Optional | integer | O número máximo de hóspedes para o qual uma Categoria de quarto se destina.
Por exemplo, uma suíte grande pode acomodar fisicamente seis hóspedes, mas destina-se apenas a até quatro pessoas.
Esse valor precisa ser menor ou igual ao elemento O valor de Se você especificar esse elemento em Observação: <Occupancy> pode estar acompanhado por <OccupancyDetails> ,que especifica o tipo de hóspedes (adultos ou crianças). Consulte <OccupancyDetails> para ver a sintaxe e a descrição dos elementos filhos.
|
<PackageID> | Required | string | O ID exclusivo do pacote. Use esse ID para corresponder os
dados da Categoria de quarto aos blocos Você também pode usar esse ID para fazer referência a uma definição comum de Categoria de quarto usada em uma única Mensagem de transação ao definir os dados de Categoria de quarto in-line. |
<ParkingIncluded> | Optional | boolean | Se uma Categoria de quarto inclui estacionamento sem custo financeiro, onde o estacionamento seria um serviço pago neste hotel. Não especifique um valor para esse elemento em um hotel que ofereça estacionamento gratuito.
Os valores válidos são |
<PhotoURL> | Optional | Object | O mesmo que <PhotoURL> em <RoomData> ,
mas para o pacote (por exemplo, fotos de refeições).
|
<Refundable> | Optional | Object | Permite listar uma tarifa como totalmente reembolsável ou fornecer um cancelamento
sem custo financeiro. Se não for fornecido, nenhuma informação sobre reembolso será exibida.
Uma política de reembolso no nível <PackageData> substitui a política de reembolso no
nível <Result> . Uma política de reembolso no nível <Rates> substitui
a política de reembolso no nível <PackageData> . Os preços reembolsáveis também
podem ser destacados aos usuários por opções alternativas sem modificar
diretamente o esquema da mensagem de transação. Saiba mais sobre essas opções na
política de tarifas reembolsáveis.
O exemplo a seguir mostra o elemento <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Observação:recomendamos configurar todos os atributos. Uma mensagem de aviso de status do feed é gerada quando um ou mais atributos não estão definidos. Se você não definir nenhum atributo, a tarifa não vai ser mostrada como reembolsável. Os atributos são:
Ao definir os atributos, observe o seguinte:
|
<MembershipBenefits |
Optional | boolean | A tarifa inclui os benefícios do status de elite pela duração da estadia. Inclui os seguintes parâmetros:
|
<CarRentalIncluded> | Optional | boolean | A tarifa inclui aluguel sem custo financeiro de carro para a duração da estadia. |
<MilesIncluded>> | Optional | boolean | A tarifa inclui milhas do programa de milhagem. Os parâmetros incluem:
|
<OnPropertyCredit> | Optional | boolean | A tarifa inclui crédito no local (F&B, resort, spa etc.). Parâmetro:
|
<AirportTransportationIncluded> | Optional | Object | A tarifa inclui transporte sem custo financeiro de ida e volta para um aeroporto próximo. O atributo opcional direction especifica a direção do transporte. Os valores válidos incluem:
from : o transporte é fornecido do aeroporto para a
propriedade. Esse será o valor padrão se nenhuma direção for especificada.
to : o transporte para o aeroporto é disponibilizado na propriedade.
round_trip : o transporte é fornecido de ida e volta para o aeroporto.
|
Exemplos
Pacote para um quarto
O exemplo a seguir define uma Categoria de quarto individual, com ocupação de 2 pessoas (um adulto e uma criança) e inclui café da manhã:
<?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>
Metadados de quartos e pacotes
O exemplo a seguir define metadados de quartos e pacotes:
<?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>
Várias categorias de quarto
O exemplo a seguir define metadados de quartos e pacotes para vários Room Bundles:
<?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>
Categoria de quarto com tarifas
O exemplo a seguir define metadados de quartos e pacotes para uma categoria de quarto com 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>
Refeições e fotos
O exemplo a seguir define metadados de quartos e pacotes para refeições, fotos e horários de check-in e check-out:
<?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>
Café da manhã
<?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>
Um contêiner para atualizações de preços e disponibilidade em uma mensagem
<Transaction>
.
O elemento <Result>
aparece no seguinte local na
hierarquia XML da Mensagem de transação:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Use <Result>
para definir ou atualizar os preços dos quartos e definir o inventário disponível. Os itens definidos nesse elemento normalmente fazem referência a
metadados independentes de itinerário sobre um quarto ou pacote (como uma descrição ou
conjunto de comodidades) definidos em <PackageData>
e <RoomData>
.
Você envia Mensagens de transação com atualizações de preço com muita frequência. Exatamente com que frequência e com que você faz isso depende de seu modo de transferência.
É possível usar <Result>
em uma Mensagem de transação para remover itinerários, conforme
descrito em Remover inventário.
Para mais informações sobre como usar Mensagens de transação para atualizar preços e disponibilidade, consulte Como adicionar e atualizar inventário.
Uma única Mensagem de transação pode incluir qualquer número de elementos <Result>
, desde que o tamanho da mensagem não exceda 100 MB.
Sintaxe
O elemento <Result>
usa a seguinte sintaxe:
<?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
O elemento <Result>
tem os seguintes atributos:
Atributo | Obrigatório? | Tipo | Descrição |
---|---|---|---|
mergeable | Optional | boolean | Por padrão, os novos preços de um hotel e um par de itinerários específicos vão
substituir os valores anteriores (não expirados) presentes no cache do Google. O
atributo que pode ser mesclado permite armazenar outros preços no cache do Google
sem excluir as informações de preços anteriores. A consulta de preços em tempo real com respostas de contexto sempre terá esse atributo definido como true , independentemente da resposta da mensagem de transação. |
Elementos filhos
O elemento <Result>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<AllowablePointsOfSale> | Optional | Object | Uma ou mais páginas de destino qualificadas para o hotel. A página de destino é um site que gerencia o processo de reserva do usuário final. Para incluir explicitamente determinadas páginas de destino (e excluir
outras), adicione um ou mais elementos <AllowablePointsOfSale>
que correspondam ao atributo id
do elemento <PointOfSale> no arquivo das páginas de destino.
Se você não incluir esse elemento, todas as páginas de destino definidas no arquivo serão consideradas qualificadas para reserva do quarto. Para mais informações, consulte Sintaxe do arquivo de páginas de destino. |
<Baserate> | Optional | float | O preço do quarto para a estadia. O valor desse elemento precisa refletir o seguinte:
Quando o quarto não estiver disponível para o itinerário, o Para remover uma Categoria de quarto, siga as instruções em Remover uma Categoria de quarto. O <Baserate currency="USD">1200.40</Baserate> O elemento
|
<ChargeCurrency> | Optional | enum | Quando e onde o usuário paga uma reserva. Este elemento pode ser usado em uma Mensagem de transação no elemento <Result> para o Preço do hotel ou o bloco <PackageData> para uma Categoria de quarto.
Os valores válidos são:
O valor padrão é |
<Checkin> | Required | Date | A data de check-in para um itinerário usando o formato Date. A combinação dos elementos <Nights> e <Checkin> forma um itinerário. |
<Custom[1‑5]> | Optional | string | Define um campo personalizado que você pode usar para transmitir outros dados associados a um hotel. É possível transmitir até cinco valores personalizados com os seguintes nomes de elementos:
Os elementos Os elementos <Custom> fornecidos no elemento |
<ExpirationTime> | Optional | DateTime | É a data e a hora em que o preço é considerado expirado (no mínimo
três horas).
Recomendamos que você não forneça carimbos de data/hora de expiração se isso não for essencial para a estrutura de preços. O Google não exibe preços expirados, e qualquer itinerário com preço expirado se qualifica para a Consulta de preços em tempo real. |
<Nights> | Required | integer | O número de noites de um itinerário. O valor do elemento
<Nights> precisa ser um número inteiro positivo.
A combinação de <Nights> e <Checkin> forma um itinerário. |
<OtherFees> | Optional | float | Taxas diferentes da tarifa básica e tributos que influenciam o preço final de um quarto. O elemento <OtherFees> usa
um único atributo obrigatório, currency , que define o
código da moeda de três letras para as taxas. Por exemplo, USD .
O elemento |
<Occupancy> | Optional | integer | Especifica o número máximo de ocupantes.
Quando <Occupancy> aparece em <Result> ,
é necessário especificar 2 ou mais. <Occupancy> pode
estar acompanhado por <OccupancyDetails> , que especifica
o tipo de hóspedes (adultos ou crianças). Consulte <OccupancyDetails> para ver a sintaxe e a descrição dos elementos filhos. Se o elemento <Occupancy> não for fornecido, a ocupação será padronizada como 2 .
Observação: entre em contato com sua equipe de suporte para ativar o recurso de envio de preços para hóspedes que não sejam duplos. |
<PackageID> | Optional | string | O ID exclusivo do pacote para mapeá-lo para os dados de pacote predefinidos. Também usado para preencher a variável de página de destino PACKAGE-ID. Para ver mais informações, consulte os metadados do pacote de quarto. |
<Property> | Required | string | O ID de um hotel afetado pelos dados associados (preço, itinerário, Categoria de quarto ou metadados). O valor desse elemento precisa ser uma string. O valor desse elemento precisa corresponder ao <id> da ficha da empresa definido no seu feed de lista de hotéis.
|
<Rates> | Optional | <Rates> |
Um contêiner para um ou mais blocos <Rate> . Cada <Rate> em <Rates> define um preço diferente para a combinação de quarto/itinerário.
Use o elemento |
<Refundable> | Optional | Object | Permite listar uma tarifa como totalmente reembolsável ou fornecer um cancelamento
sem custo financeiro. Se não for fornecido, nenhuma informação sobre reembolso será exibida.
Uma política de reembolso no nível <PackageData> substitui a política de reembolso no
nível <Result> . Uma política de reembolso no nível <Rates> substitui
a política de reembolso no nível <PackageData> . Os preços reembolsáveis também
podem ser destacados aos usuários por opções alternativas sem modificar
diretamente o esquema da mensagem de transação. Saiba mais sobre a
política de tarifas reembolsáveis.
O exemplo a seguir mostra o elemento <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Observação:recomendamos configurar todos os atributos. Uma mensagem de aviso de status do feed é gerada quando um ou mais atributos não estão definidos. Se você não definir nenhum atributo, a tarifa não vai ser mostrada como reembolsável. Os atributos são:
Ao definir os atributos, observe o seguinte:
|
<RoomBundle> | Optional | <RoomBundle> |
Um contêiner com informações sobre descrições físicas cobradas de um quarto,
embalagens de comodidades e alguns detalhes da política de compra do
hotel e itinerário em questão.
Em geral, use esse elemento para definir os preços do quarto base e diferentes tipos de quarto na mesma propriedade. Embora seja possível definir as descrições de Categoria de quarto in-line, você precisa usar uma Mensagem de transação separada para definir essas informações. O Google armazenará os metadados para que você possa referenciá-los, em vez de repeti-los, em todas as atualizações de preços futuras. |
<RoomID> | Optional | string | O código exclusivo do quarto para mapeá-lo para os dados predefinidos do quarto. Também é usado para preencher a variável da página de destino PARTNER-ROOM-ID. Para ver mais informações, consulte os metadados do pacote de quarto. |
<Tax> | Optional | float | Os tributos calculados para o preço final de um quarto.
O elemento <Tax> usa um único atributo obrigatório,
currency , que define o código da moeda
de três letras para os tributos. Por exemplo, USD . O elemento <Tax> será necessário se <Baserate> for maior que zero. |
<Unavailable> | Optional | Object | Indica que o itinerário não está disponível para reserva. Serve como um contêiner para motivos mais detalhados pela qual o itinerário não estava disponível. Um
ou mais dos seguintes motivos de indisponibilidade podem estar aninhados sob a tag
<Unavailable> :
|
Exemplos
Exemplo de várias propriedades
O exemplo a seguir define um itinerário e o preço de duas propriedades:
<?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>
Este exemplo não mostra detalhes sobre o quarto, como descrição, imagem, legenda, nome e capacidade do quarto.
Você pode definir essas informações uma vez em uma mensagem de transação separada que o Google armazena. Assim, será possível fazer referência a ele em todas as atualizações de preços e inventário subsequentes. Para mais informações, consulte os Metadados de Categoria de quarto.
Exemplo de várias taxas
O exemplo a seguir define um único itinerário e propriedade com várias taxas para várias ocupações. O elemento <Rates>
pode ser usado para informar preços de várias taxas para uma propriedade específica. O exemplo a seguir também é útil para propriedades de aluguel por temporada (VR):
<?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>
Exemplo indisponível
O exemplo a seguir define um itinerário em que a disponibilidade não pode ser recuperada de canais downstream, um segundo que está abaixo da estadia mínima e já reservado para as datas especificadas e um terceiro em que a propriedade está fechada na data de chegada, mas que é aberto durante a estadia:
<?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>
Um contêiner para um ou mais blocos <Rate>
. Cada <Rate>
em <Rates>
define um preço diferente para a combinação de quarto ou itinerário.
Use o elemento <Rates>
somente quando houver várias tarifas para a mesma combinação de quarto ou itinerário. Por exemplo, você define várias
tarifas para tarifas condicionais,
tarifas exclusivas ou
tarifas condicionais em Categorias de quarto.
O elemento <Rates>
aparece no seguinte local na
hierarquia XML da Mensagem de transação:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
(Can also contain<Rates>
) + ...
Os valores definidos em um <Rate>
substituem os relacionados ao preço no
elemento pai <Result>
ou <RoomBundle>
. Se eles não forem definidos em <Rate>
,
eles herdarão o valor do elemento pai. Somente <AllowablePointsofSale> é herdado para o elemento <RoomBundle>
.
Sintaxe
O elemento <Rates>
usa a seguinte sintaxe:
<?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
O elemento <Rates>
tem os seguintes atributos:
Atributo | Obrigatório? | Descrição |
---|---|---|
rate_rule_id | Optional | Para tarifas condicionais, esse ID faz a correspondência de uma tarifa com uma definição no arquivo de definição de regras de tarifação. O limite de caracteres para esse campo é de 40 caracteres. |
Elementos filhos
O elemento <Rates>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<AllowablePointsOfSale> | Optional | Object | Uma ou mais páginas de destino qualificadas para o hotel. Esse elemento usa a mesma sintaxe que o <AllowablePointsOfSale> no <Result> . |
<Baserate> | Required | float | O preço do quarto para a estadia. Esse elemento usa a mesma sintaxe que o <Baserate> no <Result> .
Observação:não é possível definir o elemento filho |
<ChargeCurrency> | Optional | enum | Quando e onde o usuário paga uma reserva. Esse elemento usa a mesma sintaxe de um <ChargeCurrency> em um <Result> . |
<Custom[1‑5]> | Optional | string | Campos personalizados que podem ser usados para transmitir outros dados associados a um hotel para uma página de destino. Esse elemento usa a mesma sintaxe de um <Custom[1‑5]> em um <Result> . Há um limite de 200 caracteres por campo personalizado. Para mais informações, consulte os
arquivos da página de destino.
Se elementos <Custom> forem fornecidos no
elemento |
<ExpirationTime> | Optional | DateTime | A data e a hora em que a taxa é considerada expirada. Esse elemento usa a mesma sintaxe de um <ExpirationTime> em um <Result> . |
<Occupancy> | Optional | integer | Especifica o número máximo de ocupantes.
|
<OtherFees> | Required | float | Taxas diferentes da tarifa de base e tributos que influenciam o preço final de um quarto. Esse elemento usa a mesma sintaxe que <OtherFees> em um <Result> . |
<Refundable> | Optional | Object | Permite listar uma tarifa como totalmente reembolsável ou fornecer um cancelamento
sem custo financeiro. Se não for fornecido, nenhuma informação sobre reembolso será exibida.
Uma política de reembolso no nível <PackageData> substitui a política
no nível <Result> . Uma política de reembolso no nível <Rates> substitui
a política de reembolso no nível <PackageData> . Os preços reembolsáveis também
podem ser destacados aos usuários por opções alternativas sem modificar
diretamente o esquema da mensagem de transação. Saiba mais sobre essas opções na
política de tarifas reembolsáveis.
O exemplo a seguir mostra o elemento <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Observação:recomendamos configurar todos os atributos. Uma mensagem de aviso de status do feed é gerada quando um ou mais atributos não estão definidos. Se você não definir nenhum atributo, a tarifa não vai ser mostrada como reembolsável. Os atributos são:
Ao definir os atributos, observe o seguinte:
|
<Tax> | Required | float | Os tributos calculados para o preço final de um quarto. Esse elemento usa a mesma sintaxe de um <Tax> em um <Result> . |
Exemplos
Tarifa básica e condicional
O exemplo a seguir mostra uma Mensagem de transação que contém uma taxa básica e uma 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>
Várias tarifas condicionais
O exemplo a seguir define uma tarifa básica e várias tarifas condicionais em um <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 o preço e a disponibilidade para Categorias de quarto como filha de
<Result>
em uma mensagem <Transaction>
. Defina um elemento separado para cada
combinação de pacote ou itinerário. Para definir o pacote e os termos das
Categorias de quarto, use <RoomData>
.
O elemento <RoomBundle>
aparece no seguinte local na
hierarquia XML da Mensagem de transação:
+<Transaction>
+<PropertyDataSet>
// Room and package metadata + <Property> +<RoomData>
+<PackageData>
+<Result>
// Pricing and availability +<Rates>
+<RoomBundle>
+ ...
Para mais informações, consulte Como usar Categorias de quarto.
Sintaxe
O elemento <RoomBundle>
usa a seguinte sintaxe:
<?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
O elemento <RoomBundle>
não tem atributos.
Elementos filhos
O elemento <RoomBundle>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<Baserate> | Required | float | Define o preço da Categoria de quarto para a estadia. Esse elemento usa
a mesma sintaxe de <Baserate> em <Result> , com a
seguinte exceção:
|
<BreakfastIncluded> | Optional | boolean | Especifica se esta Categoria de quarto inclui café da manhã com a tarifa. |
<ChargeCurrency> | Optional | enum | Quando e onde o usuário paga uma reserva. Esse elemento usa a mesma sintaxe que <ChargeCurrency> em um <Result> .
O valor padrão é |
<Custom[1‑5]> | Optional | string | Campos personalizados para transmitir dados adicionais às páginas de destino da Categoria de quarto. Esses elementos usam a mesma sintaxe que <Custom[1-5]> no <Result> . Há um limite de 200 caracteres por campo personalizado. Para mais informações, consulte os arquivos da página de destino.
Se elementos <Custom> forem fornecidos no
elemento |
<InternetIncluded> | Optional | boolean | Se uma Categoria de quarto incluir acesso à Internet sem custo financeiro, outros pacotes não incluiriam essa comodidade. Não defina este elemento para Categorias de quarto em um hotel que oferece Internet gratuita para todos os quartos. Este elemento não se aplica à Internet com fio no quarto ou à Internet sem fio que não está disponível nos quartos de hóspedes. |
<Occupancy> | Required | integer | O número máximo de hóspedes para o qual uma Categoria de quarto se destina. Por exemplo, uma suíte grande pode acomodar fisicamente seis hóspedes, mas o "Pacote lua de mel" é destinado apenas a duas pessoas.
Esse valor precisa ser menor ou igual a Ao definir a ocupação no URL da página de destino, use as variáveis O valor de Observações:
|
<OtherFees> | Required | float | Taxas diferentes da tarifa básica e tributos que influenciam o preço final de um quarto. O elemento <OtherFees> usa
um único atributo obrigatório, currency , que define o
código da moeda de três letras para as taxas. Por exemplo, use
USD para dólares americanos. |
<PackageID> | Optional (recommended) | string | O ID exclusivo dos dados do pacote. Use esse ID para corresponder os dados de Categoria de quarto ao que foi enviado em <PackageData> . Para
mais informações, consulte os
Metadados
do pacote de quarto. Você
também pode usar esse ID para fazer referência a uma definição comum de Categoria de quarto usada
em uma única Mensagem de transação ao definir os dados de Categoria de quarto in-line. |
<ParkingIncluded> | Optional | boolean | Se uma Categoria de quarto inclui estacionamento sem custo financeiro, onde o estacionamento seria um serviço pago neste hotel. Não especifique um valor para esse elemento em um hotel que ofereça estacionamento gratuito.
Os valores válidos são |
<RatePlanID> | Optional | string | O ID do plano de tarifa representa o identificador exclusivo de uma combinação de quarto e pacote. Por exemplo, considerando um valor <RoomID> de 5 e um valor <PackageID> de ABC, você poderia usar um valor de 5-ABC para <RatePlanID> . Recomendamos usar o
RatePlanID como uma variável para criar o URL dinâmico da página de destino
(antigo "Ponto de venda").
Para mais informações, consulte Como usar variáveis e condições. |
<Rates> | Optional | <Rates> |
Tarifas que substituem os padrões para esta Categoria de quarto. Esse elemento usa a mesma sintaxe que <Rates> no <Result> . |
<Refundable> | Optional | Object | Permite listar uma tarifa como totalmente reembolsável ou fornecer um cancelamento
sem custo financeiro. Se não for fornecido, nenhuma informação sobre reembolso será exibida.
Uma política de reembolso no nível <PackageData> substitui a política de reembolso no
nível <Result> . Uma política de reembolso no nível <Rates> substitui
a política de reembolso no nível <PackageData> . Os preços reembolsáveis também
podem ser destacados aos usuários por opções alternativas sem modificar
diretamente o esquema da mensagem de transação. Saiba mais sobre essas opções na
política de tarifas reembolsáveis.
O exemplo a seguir mostra o elemento <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> Observação:recomendamos configurar todos os atributos. Uma mensagem de aviso de status do feed é gerada quando um ou mais atributos não estão definidos. Se você não definir nenhum atributo, a tarifa não vai ser mostrada como reembolsável. Os atributos são:
Ao definir os atributos, observe o seguinte:
|
<RoomID> | Required | string | O ID exclusivo dos dados do quarto. Use esse ID para corresponder os dados de Categoria de quarto aos dados que você enviou em <RoomData> .
Para ver mais informações, consulte os
Metadados de Categoria de quarto. Você também pode usar esse código para fazer referência a uma definição de quarto comum em uma única Mensagem de transação ao definir os dados do quarto inline. |
<Tax> | Required | float | Os tributos calculados para o preço final de um quarto.
O elemento <Tax> usa um único atributo obrigatório,
currency , que define o código da moeda
de três letras para os tributos. Por exemplo, use USD para dólares americanos. |
Exemplos
Pacote para ocupação única
O exemplo a seguir define uma resposta com um único pacote de ocupação.
Quando um usuário seleciona 1
no seletor de ocupação, o Google exibe o preço qualificado mais baixo,
independentemente da ocupação.
Se um preço único não estiver disponível, o Google vai mostrar o menor preço para dois hóspedes. Os preços de ocupação única não serão consultados em tempo real se a ocupação dupla ou mais preços forem armazenados em cache para um itinerário.
Este exemplo faz referência a metadados predefinidos de quartos e pacotes com os
elementos <RoomID>
e <PackageID>
. Use os elementos <RoomData>
e
<PackageData>
para definir essas informações.
<!-- 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>
Duas ou mais ocupações
O exemplo a seguir define uma resposta que contém duas ou mais ocupações.
Este exemplo faz referência a metadados predefinidos de quartos e pacotes com os
elementos <RoomID>
e <PackageID>
. Use os elementos <RoomData>
e
<PackageData>
para definir essas informações.
<!-- 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>
Várias categorias de quarto
O exemplo a seguir define a ocupação em várias categorias de quarto para demonstrar o possível preço de um quarto no albergue.
<?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>
Várias tarifas condicionais
O exemplo a seguir define uma tarifa básica e várias tarifas condicionais em um <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>
em uma mensagem de transação especifica o número máximo de hóspedes
de um quarto ou pacote. <OccupancyDetails>
pode conter informações adicionais, como o número e o tipo de hóspedes (adultos ou crianças).
Quando <Occupancy>
e <OccupancyDetails>
aparecem no elemento <Rates>
de <Result>
ou <RoomBundle>
, isso significa que a taxa é restrita pelos detalhes de ocupação.
Sintaxe
Quando <OccupancyDetails>
aparece, ele é sempre precedido por <Occupancy>
.
Observe a seguinte sintaxe:
<?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 filhos
O elemento <OccupancyDetails>
tem os seguintes elementos filhos:
Elemento filho | Obrigatório? | Tipo | Descrição |
---|---|---|---|
<NumAdults> | Required | integer | O número de hóspedes adultos. Mín.:1, Máx.:20. |
<Children> | Optional | Object | Um contêiner para um ou mais elementos <Child> . |
<Child age> | Optional | integer | A idade máxima dessa Criança, por exemplo, <Child age="17"> . |
Exemplos
Os exemplos a seguir mostram como <OccupancyDetails>
pode aparecer em
<Results>
, <RoomBundle>
ou no elemento filho <Rates>
.
Resposta do resultado
O exemplo a seguir define um itinerário e o preço dele para uma propriedade em resposta a uma consulta de preço em tempo real em que o usuário especificou o número e os tipos de hóspedes. Aqui, <OccupancyDetails>
(dois adultos e uma criança) é retornado no <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>
Classifica a resposta
O exemplo a seguir define um itinerário e os preços dele para 1 adulto e 1 criança. Aqui, as <OccupancyDetails>
são retornadas no 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>
Categoria de quarto
O exemplo a seguir define uma ocupação de dois adultos e uma criança por duas noites, com uma tarifa reembolsável. Aqui, o <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>
Várias categorias de quarto
O exemplo a seguir define várias tarifas de <RoomBundle>
que são restritas a uma ocupação de 2 adultos e 2 crianças. Aqui, o
<OccupancyDetails>
aparece no 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>