Richieste
Sintassi
Il messaggio Transaction (Property Data)
utilizza la seguente sintassi:
<?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>
Elementi e attributi
Il messaggio Transaction (Property Data) contiene i seguenti elementi e attributi:
Elemento / @Attributo | Occorrenze | Tipo | Descrizione |
---|---|---|---|
Transaction | 1 | Complex element | In un'implementazione ARI, questo è l'elemento principale per un messaggio che definisce pacchetti e tipi di camera per una singola proprietà. |
Transaction / @timestamp | 1 | DateTime | La data e l'ora di creazione di questo messaggio. |
Transaction / @id | 1 | string | Un identificatore univoco per questo messaggio di richiesta. Questo valore viene restituito nel messaggio di risposta. I caratteri consentiti sono a-z, A-Z, 0-9, _ (trattino basso) e - (trattino). |
Transaction / @partner | 1 | string | L'account partner per questo messaggio. Questo valore di stringa è il
valore "Chiave partner" presente
nella
pagina Impostazioni account in Hotel Center.
Nota: se hai un backend che fornisce feed per
più account, questo valore deve corrispondere al valore dell'attributo |
Transaction / PropertyDataSet | 1.. | PropertyDataSet | Un contenitore per definire i tipi di camera e i pacchetti di una singola proprietà. |
Transaction / PropertyDataSet / @action | 0..1 | enum | Il tipo di aggiornamento da applicare alle definizioni delle tariffe delle camere. I valori validi sono:
Questo attributo è facoltativo e il valore predefinito è |
Transaction / PropertyDataSet / Property | 1 | string | L'identificatore univoco della struttura. Questo valore deve corrispondere all'ID hotel specificato utilizzando
<id> nell'elemento <listing>
del feed elenco hotel. L'ID hotel è indicato anche in Hotel Center. |
Transaction / PropertyDataSet / RoomData | 0..n | RoomData | Descrive una stanza. Nota: è richiesto almeno un valore tra |
Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | L'identificatore univoco di un tipo di camera. A questo valore viene fatto riferimento tramite
l'attributo InvTypeCode
nell'elemento
<StatusApplicationControl> nei
messaggi <OTA_HotelAvailNotifRQ> e
<OTA_HotelRateAmountNotifRQ> . |
Transaction / PropertyDataSet / RoomData / Name | 1 | Name | Contenitore per il nome della categoria della camera in una o più lingue. |
Transaction / PropertyDataSet / RoomData / Name / Text | 1..n | Text | Specifica il nome della categoria della camera in una lingua. |
Transaction / PropertyDataSet / RoomData / Name / Text / @text | 1..n | string | Il nome della categoria della camera nella lingua specificata
dall'attributo language . |
Transaction / PropertyDataSet / RoomData / Description | 1 | Name | Contenitore per la descrizione della categoria della camera in una o più lingue. |
Transaction / PropertyDataSet / RoomData / Description / Text | 1..n | Text | Specifica la descrizione della categoria della camera in una lingua. |
Transaction / PropertyDataSet / RoomData / Description / Text / @text | 1..n | string | La descrizione della categoria della camera nella lingua specificata
dall'attributo language . |
Transaction / PropertyDataSet / RoomData / Description / Text / @language | 1..n | string | Un codice lingua di due lettere. |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs | 0..1 | AllowablePackageIDs | Un contenitore per gli elementi <AllowablePackageID> .
Se Se Usa |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | Specifica il valore PackageID di un piano tariffario che può essere combinato con questo
tipo di camera. Un piano tariffario viene definito da una combinazione di
pacchetto, tariffe e disponibilità. PackageID
corrisponde a RatePlanCode nei
messaggi OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ.
|
Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | Il numero massimo di adulti e bambini che una camera può
ospitare fisicamente. Deve essere maggiore o uguale a
qualsiasi valore NumberOfGuests che invii con le tariffe.
Il valore di Nota: se |
Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | Il numero massimo di adulti che una camera può ospitare
fisicamente. Deve essere maggiore o uguale a qualsiasi valore NumberOfGuests inviato con le tariffe.
Il valore di |
Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | Il numero massimo di bambini che una camera può ospitare
fisicamente.
Il valore di |
Transaction / PropertyDataSet / RoomData / OccupancySettings | 0..1 | OccupancySettings | Impostazioni che possono limitare o modificare i requisiti relativi al numero di persone di una
camera.
L'elemento
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> Non è necessario includere tutti gli elementi secondari. |
Transaction / PropertyDataSet / RoomData / PhotoURL | 0..n | PhotoURL | Un URL e una didascalia facoltativa per una foto di una determinata camera o di un
pacchetto camera. Puoi specificare più di un <PhotoURL>
per una camera o un pacchetto camera.
Questo elemento prevede i seguenti elementi secondari:
<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 informazioni sulle caratteristiche della camera. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle | 0..1 | enum | Indica lo stile di una camera d'albergo giapponese. I valori validi sono:
|
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds | 0..1 | Object | Contiene un numero di <Bed> pari a quello della stanza. Tieni presente che i futon giapponesi non devono essere conteggiati qui.
Ogni
<Bed> ha i seguenti elementi secondari:
<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 | Fornisci questo elemento se questa camera è una suite. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule | 0..1 | enum | Fornisci questo elemento quando questa camera è una camera a capsule. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing | 0..1 | enum | Indica se la camera è condivisa con altri occupanti, come i proprietari o altri ospiti. I valori validi sono shared e private . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor | 0..1 | enum | Fornisci questo elemento quando questa camera è una struttura all'aperto che non ha pareti fisse, impianti idraulici e climatizzazione. Ad esempio, le camere d'albergo non sono strutture ricettive all'aperto, mentre i campeggi in cui gli ospiti soggiornano in tende e i parcheggi per camper in cui gli ospiti portano i propri camper sono alloggi all'aperto. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible | 0..1 | enum | Fornisci questo elemento quando la stanza è accessibile per persone con mobilità ridotta. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking | 0..1 | enum | Indica se si tratta di una camera per non fumatori o per fumatori. I valori validi sono non_smoking e smoking . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet | 0..1 | Object | Contiene informazioni su bagno e servizi igienici nella stanza.
L'attributo è:
Facoltativamente, l'elemento accetta i seguenti elementi secondari:
Esempio: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath | 0..1 | enum | Fornisci questo elemento quando questa camera dispone di un bagno privato all'aperto. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning | 0..1 | enum | Fornisci questo elemento quando questa camera dispone di aria condizionata. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony | 0..1 | enum | Fornisci questo elemento quando questa camera ha un balcone o una veranda. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views | 0..1 | Object | Le opzioni valide includono:
|
Transaction / PropertyDataSet / PackageData | 0..n | PackageData | Contenitore di elementi che descrivono le caratteristiche e i termini delle tariffe che non fanno parte della descrizione fisica della camera. Nota: è richiesto almeno un valore tra |
Transaction / PropertyDataSet / PackageData / PackageID | 1 | string | PackageID in questi messaggi corrisponde a
RatePlanCode nei messaggi OTA_HotelRateAmountNotifRQ e
OTA_HotelAvailNotifRQ. |
Transaction / PropertyDataSet / PackageData / Name | 1 | Name | Contenitore del nome del pacchetto in una o più lingue. |
Transaction / PropertyDataSet / PackageData / Name / Text | 1..n | Text | Specifica il nome del pacchetto in una lingua. |
Transaction / PropertyDataSet / PackageData / Name / Text / @text | 1..n | string | Il nome del pacchetto nella lingua specificata
dall'attributo language . |
Transaction / PropertyDataSet / PackageData / Description | 1 | Description | Contenitore per la descrizione del pacchetto in una o più lingue. |
Transaction / PropertyDataSet / PackageData / Description / Text | 1..n | Text | Specifica la descrizione del pacchetto in una lingua. |
Transaction / PropertyDataSet / PackageData / Description / Text / @text | 1..n | string | La descrizione del pacchetto nella lingua specificata
dall'attributo language . |
Transaction / PropertyDataSet / PackageData / Description / Text / @language | 1..n | string | Un codice lingua di due lettere. |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs | 0..1 | AllowableRoomIDs | Un contenitore per gli elementi <AllowableRoomID> .
Se Se Usa |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID | 1..n | AllowableRoomID | Specifica il RoomID di un tipo di camera che può essere combinato con questo
piano tariffario. Un tipo di camera viene definito in un elemento
<RoomData> .
|
Transaction / PropertyDataSet / PackageData / Refundable | 0..1 | Refundable | Consente di indicare una tariffa come completamente rimborsabile o annullabile. Se non viene specificato, non viene visualizzata alcuna informazione sul rimborso.
Nota:consigliamo di impostare tutti gli attributi. Quando non sono impostati uno o più attributi, viene generato un messaggio di avviso relativo allo stato dei feed. Se non imposti alcun attributo, la tariffa non viene visualizzata come rimborsabile. Quando imposti gli attributi, tieni presente quanto segue:
|
Transaction / PropertyDataSet / PackageData / Refundable / @available | 1 | boolean | (Obbligatorio) Imposta il valore 1 o true per indicare se la tariffa prevede un rimborso totale; in caso contrario, impostalo su 0 o false . |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days | 0..1 | integer | (Obbligatorio se
available è true ) Specifica
il numero di giorni prima del check-in entro cui è possibile richiedere
un rimborso totale. Il valore di refundable_until_days
deve essere un numero intero compreso tra 0 e 330 inclusi. |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time | 0.. | Time | (Fortemente consigliato se
available è true ) Specifica
l'ora più recente, nell'ora locale dell'hotel, entro cui verrà soddisfatta una
richiesta di rimborso totale. Questo valore può essere combinato con
refundable_until_days per specificare, ad esempio, che "i rimborsi sono disponibili fino alle 16:00 di due giorni prima del
check-in". Se refundable_until_time non è impostato, il valore
predefinito è mezzanotte. |
Transaction / PropertyDataSet / PackageData / BreakfastIncluded | 0..1 | boolean | Specifica se questo tipo di camera include la colazione.
I valori validi sono 0 (o false ) e 1 (o true ).
È preferibile utilizzare |
Transaction / PropertyDataSet / PackageData / CheckinTime | 0..1 | Time | Primo orario per il check-in possibile nell'ora locale dell'hotel. L'orario deve essere inferiore a 24:00. |
Transaction / PropertyDataSet / PackageData / CheckoutTime | 0..1 | Time | L'orario più recente del check-out nell'ora locale dell'hotel. |
Transaction / PropertyDataSet / PackageData / InternetIncluded | 0..1 | boolean | Specifica se la camera include l'accesso a internet gratuito,
mentre le altre camere non includono questo servizio. Non impostare questo elemento in un hotel che fornisce internet gratuito in tutte le camere. Questo elemento non si applica all'accesso cablato nelle camere o all'accesso wireless a internet non disponibile nelle camere. I valori validi sono 0 (o false ) e 1 (o true ).
|
Transaction / PropertyDataSet / PackageData / Meals | 0..1 | Object | Contiene informazioni sui pasti di questo pacchetto.
L'elemento
Gli attributi facoltativi vengono utilizzati solo quando Affinché i filtri pasti ( |
Transaction / PropertyDataSet / PackageData / ParkingIncluded | 0..1 | boolean | Indica se una camera include il parcheggio senza costi aggiuntivi, laddove il parcheggio sarebbe un servizio a pagamento in questo hotel. Non specificare un valore per questo elemento per un hotel che offre il parcheggio gratuito.
I valori validi sono 0 (o false ) e 1 (o true ). Il valore predefinito è false .
|
Transaction / PropertyDataSet / PackageData / PhotoURL | 0..1 | Object | (Uguale a <PhotoURL> in <RoomData> ,
ma per il pacchetto (ad es. foto dei pasti).)
|
Esempi
Dati di camere e pacchetti
Di seguito è riportato un esempio di base di come definire i dati di camere e
pacchetti di una proprietà in un messaggio Transaction (Property Data). L'attributo overlay
viene utilizzato per garantire che, nel caso in cui dei dati esistano già inaspettatamente,
tutti i dati esistenti vengano eliminati e sostituiti con quelli presenti in questo messaggio:
<?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>
Aggiungi un tipo di stanza
Di seguito è riportato un esempio di come aggiungere un pacchetto e un tipo di camera ai dati
<Transaction>
esistenti:
<?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>
Rimuovi tipi di camera
Di seguito è riportato un esempio di come rimuovere pacchetti e tipi di camere esistenti. In questo scenario, se i messaggi in "Dati su camere e pacchetti"
e "Aggiungi un tipo di camera" erano stati inviati a Google in precedenza, i tipi di camera King
e
Double
non esisterebbero più una volta che Google riceverà il messaggio
mostrato. Tieni presente che la rimozione dei dati del pacchetto influisce sul piano tariffario complessivo definito nei messaggi Transaction (Property Data), OTA_HotelRateAmountNotifRQ e OTA_HotelAvailNotifRQ
(facendo riferimento allo stesso valore PackageID
)
e, di conseguenza, gli aggiornamenti corrispondenti utilizzando gli altri tipi di messaggi potrebbero
essere necessari per indicare che PackageID_2
e PackageID_3
non sono più
definiti qui.
<?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>
Limitare i piani tariffari
Di seguito è riportato un esempio di come utilizzare l'elemento <AllowablePackageIDs>
per limitare i piani tariffari consentiti per un tipo di camera. In questo esempio,
il tipo di camera Queen
(RoomID_2
) può essere combinato solo con il pacchetto e
il piano tariffario identificati come 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>
Limita la capacità della sala
Di seguito è riportato un esempio di come utilizzare gli elementi <Capacity>
, <AdultCapacity>
,
<ChildCapacity>
per impostare limitazioni sulla capacità delle camere.
<?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>
Il tipo di camera doppia (RoomID_1) può avere fino a 4 persone in totale. Inoltre, può ospitare fino a 4 adulti e fino a 3 bambini. Affinché questa camera sia prenotabile, devono essere soddisfatti tutti e tre i requisiti di capacità. Questa configurazione è rappresentativa di una stanza tipica con due letti adatti a due persone. La capienza dei bambini è di 1 in meno rispetto a quella totale perché nella camera deve essere presente almeno un adulto.
Esempi estesi con <RoomFeatures>
e pasti
JapaneseHotelRoomStyle
non ha un valore predefinito.
L'omissione di un valore non comporta un errore XML, ma la tua scheda non viene visualizzata nei risultati di ricerca quando l'utente filtra per stile della camera o letti.
Due letti singoli
L'esempio seguente mostra come utilizzare <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>
Due letti matrimoniali
Di seguito è riportato un esempio di camera in stile western
con due
double
letti.
<?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>
Stile giapponese senza letto
Di seguito è riportato un esempio di camera in stile giapponese senza letto. Le informazioni sui letti non sono necessarie per una camera in stile 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>
Giapponese western con letto
Di seguito è riportato un esempio di una camera in stile japanese_western
con letto
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 il partner non dispone delle informazioni sul numero di letti in japanese_western
camera, fai riferimento al seguente esempio:
<?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>
Pasti
L'esempio seguente definisce i metadati di camere e pacchetti per pasti, foto e orari del check-in e del 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>
Solo colazione
<?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>
Risposte
Sintassi
Il messaggio TransactionResponse (Property Data)
utilizza la seguente sintassi:
<?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>
Elementi e attributi
Il messaggio TransactionResponse (Property Data)
contiene i seguenti elementi e attributi:
Elemento / @Attributo | Occorrenze | Tipo | Descrizione |
---|---|---|---|
TransactionResponse | 1 | Complex element | L'elemento principale che indica se l'esito è positivo o negativo per un messaggio di richiesta Transaction ricevuto. |
TransactionResponse / @timestamp | 1 | DateTime | La data e l'ora di creazione di questo messaggio. |
TransactionResponse / @id | 1 | string | L'identificatore univoco del messaggio Transaction associato. |
TransactionResponse / @partner | 1 | string | L'account partner per questo messaggio. |
TransactionResponse / Success | 0..1 | Success | Indica che il messaggio Transaction è stato elaborato correttamente
senza avvisi, errori o errori.
In ogni messaggio è presente |
TransactionResponse / Issues | 0..1 | Issues | Un contenitore per uno o più problemi riscontrati durante l'elaborazione del
messaggio Transaction.
In ogni messaggio è presente |
TransactionResponse / Issues / Issue | 1..n | Issue | La descrizione di un avviso, un errore o un errore riscontrato durante l'elaborazione del messaggio Transaction. Per maggiori dettagli su questi problemi, consulta la sezione Messaggi di errore relativi allo stato dei feed. |
TransactionResponse / Issues / Issue / @code | 1 | integer | L'identificatore del problema. |
TransactionResponse / Issues / Issue / @status | 1 | enum | Il tipo di problema riscontrato. I valori validi sono |
Esempi
Operazione riuscita
Di seguito è riportata una risposta a un messaggio Transaction correttamente elaborato.
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Success/>
</TransactionResponse>
Problemi
Di seguito è riportata una risposta a un messaggio Transaction non elaborato a causa di errori.
<?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>