Żądania
Składnia
Komunikat Transaction (Property Data)
ma taką składnię:
<?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>
Elementy i atrybuty
Wiadomość transakcji (dane usługi) składa się z następujących elementów: atrybuty:
Element / @Atrybut | Wystąpienia | Typ | Opis |
---|---|---|---|
Transaction | 1 | Complex element | W implementacji ARI jest to główny element wiadomości i określić typy pokojów i pakiety w pojedynczym obiekcie. |
Transaction / @timestamp | 1 | DateTime | Data i godzina utworzenia tej wiadomości. |
Transaction / @id | 1 | string | Unikalny identyfikator tej wiadomości z żądaniem. Ta wartość jest zwracana w wiadomości z odpowiedzią. Dozwolone znaki to a–z, A–Z, 0–9, _ (podkreślenie) i - (myślnik). |
Transaction / @partner | 1 | string | Konto partnera, z którego pochodzi ta wiadomość. Ta wartość ciągu znaków to parametr
„Klucz partnera” wartość podana na
Strona Ustawienia konta w Hotel Center.
Uwaga: jeśli masz backend, który dostarcza pliki danych dla
dla wielu kont, ta wartość musi odpowiadać wartości w kolumnie |
Transaction / PropertyDataSet | 1.. | PropertyDataSet | Kontener do definiowania rodzajów pokojów i pakietów w pojedynczej usłudze. |
Transaction / PropertyDataSet / @action | 0..1 | enum | Typ aktualizacji, która ma zostać zastosowana do definicji stawek za pokój. Prawidłowe wartości to:
Ten atrybut jest opcjonalny. W przeciwnym razie przyjmuje domyślnie wartość |
Transaction / PropertyDataSet / Property | 1 | string | Unikalny identyfikator usługi. Ta wartość musi pasować do
Identyfikator hotelu określony za pomocą atrybutu
<id> w elemencie <listing>
w pliku danych z listą hoteli. Identyfikator hotelu jest też podany w Hotel Center. |
Transaction / PropertyDataSet / RoomData | 0..n | RoomData | Opisuje pomieszczenie. Uwaga: co najmniej 1 z tych elementów: |
Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | Unikalny identyfikator typu pomieszczenia. Do tej wartości odwołuje się funkcja
w atrybucie InvTypeCode w
<StatusApplicationControl> element w
<OTA_HotelAvailNotifRQ> i
<OTA_HotelRateAmountNotifRQ> wiadomości. |
Transaction / PropertyDataSet / RoomData / Name | 1 | Name | Kontener nazwy kategorii pomieszczenia w co najmniej jednej języki. |
Transaction / PropertyDataSet / RoomData / Name / Text | 1..n | Text | Określa nazwę kategorii pokoju w jednym języku. |
Transaction / PropertyDataSet / RoomData / Name / Text / @text | 1..n | string | Nazwa kategorii pokoju w języku określonym przez
language . |
Transaction / PropertyDataSet / RoomData / Description | 1 | Name | Kontener na opis kategorii pokoju w co najmniej jednym miejscu języki. |
Transaction / PropertyDataSet / RoomData / Description / Text | 1..n | Text | Określa opis kategorii pokoju w jednym języku. |
Transaction / PropertyDataSet / RoomData / Description / Text / @text | 1..n | string | Opis kategorii pokoju w określonym języku
za pomocą atrybutu language . |
Transaction / PropertyDataSet / RoomData / Description / Text / @language | 1..n | string | Dwuliterowy kod języka. |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs | 0..1 | AllowablePackageIDs | Kontener elementów <AllowablePackageID> .
Jeśli określono Jeśli nie określisz wartości Użyj opcji |
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | Określa identyfikator PackageID planu stawek, który można z nim połączyć.
typu pokoju. Plan stawek jest definiowany przez
pakietu, stawek i dostępności. PackageID
odpowiada RatePlanCode w
Komunikaty OTA_HotelRateAmountNotifRQ i OTA_HotelAvailNotifRQ.
|
Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | Maksymalna liczba dorosłych i dzieci, które mogą pomieścić w sali
fizycznie dostosować. Powinna być większa lub równa
wszystkie wartości NumberOfGuests , które przesyłasz wraz ze stawkami.
Wartość Uwaga: jeśli |
Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | Maksymalna liczba osób dorosłych, które fizycznie mogą obsłużyć pokój
w domu. Powinna być większa lub równa
NumberOfGuests wartości, które wysyłasz razem ze stawkami.
Wartość |
Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | Maksymalna liczba dzieci, które fizycznie mogą obsłużyć pokój
w domu.
Wartość |
Transaction / PropertyDataSet / RoomData / OccupancySettings | 0..1 | OccupancySettings | Ustawienia, które mogą ograniczać lub modyfikować wymagania dotyczące liczby osób w
pokoju.
Element
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> Nie trzeba uwzględniać wszystkich elementów podrzędnych. |
Transaction / PropertyDataSet / RoomData / PhotoURL | 0..n | PhotoURL | adres URL i opcjonalny podpis zdjęcia danego pokoju,
Zestaw pokojów. Możesz określić więcej niż jeden <PhotoURL>
dla pokoju lub pakietu pokojów.
Ten element przyjmuje te elementy podrzędne:
<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> |
Zawiera informacje o funkcjach pokoju. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle | 0..1 | enum | Wskazuje styl japońskiego pokoju hotelowego. Prawidłowe wartości to:
|
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds | 0..1 | Object | Zawiera tyle elementów typu <Bed> , ile jest w sali. Uwaga:
że japońskie futony nie powinny tu być uwzględniane.
Każdy element
<Bed> ma te elementy podrzędne:
<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 | Podaj ten element, jeśli jest to pokój typu suite. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule | 0..1 | enum | Podaj ten element, jeśli jest to pokój kapsułowy. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing | 0..1 | enum | Określa, czy pokój jest współużytkowany z innymi domownikami, np. właścicielami
lub innym gościom. Prawidłowe wartości to shared i private . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor | 0..1 | enum | Podaj ten element, jeśli pokój jest obiektem na świeżym powietrzu, który nie mają stałe ściany, hydraulikę i klimatyzację. Na przykład pokoje hotelowe nie są miejscami noclegowymi na świeżym powietrzu, natomiast pola kempingowe, w których goście przebywają w namiotach Parkingi dla kamperów, do których goście przynoszą kamper, mają zakwaterowanie na świeżym powietrzu. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible | 0..1 | enum | Stosuj ten element, jeśli pomieszczenie jest dostosowane do potrzeb osób poruszających się. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking | 0..1 | enum | Określa, czy jest to pokój dla niepalących czy dla palących. Prawidłowa
wartości to non_smoking i smoking . |
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet | 0..1 | Object | Zawiera informacje o łazience i toalecie w pokoju.
Ten atrybut to:
Element opcjonalnie przyjmuje te elementy podrzędne:
Przykład: <BathAndToilet relation="separate"> <Bath bathtub="1" shower="1"/> <Toilet electronic_bidet="1" mobility_accessible="1"/> </BathAndToilet> |
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath | 0..1 | enum | Użyj tego elementu, jeśli pokój ma prywatną łaźnię na świeżym powietrzu. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning | 0..1 | enum | Użyj tego elementu, jeśli pokój jest klimatyzowany. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony | 0..1 | enum | Użyj tego elementu, jeśli pokój ma balkon lub werandę. |
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views | 0..1 | Object | Możliwe opcje to:
|
Transaction / PropertyDataSet / PackageData | 0..n | PackageData | Kontener na elementy opisujące funkcje i terminy związane z ceną, nie są częścią opisu fizycznego pomieszczeń. Uwaga: co najmniej 1 z tych elementów: |
Transaction / PropertyDataSet / PackageData / PackageID | 1 | string | PackageID w tych wiadomościach odpowiada
RatePlanCode w OTA_HotelRateAmountNotifRQ oraz
Komunikaty OTA_HotelAvailNotifRQ. |
Transaction / PropertyDataSet / PackageData / Name | 1 | Name | Kontener na nazwę pakietu w co najmniej jednym języku. |
Transaction / PropertyDataSet / PackageData / Name / Text | 1..n | Text | Określa nazwę pakietu w jednym języku. |
Transaction / PropertyDataSet / PackageData / Name / Text / @text | 1..n | string | Nazwa pakietu w języku określonym przez
language . |
Transaction / PropertyDataSet / PackageData / Description | 1 | Description | Kontener na opis pakietu w jednym lub kilku językach. |
Transaction / PropertyDataSet / PackageData / Description / Text | 1..n | Text | Określa opis pakietu w jednym języku. |
Transaction / PropertyDataSet / PackageData / Description / Text / @text | 1..n | string | Opis pakietu w języku określonym przez
language . |
Transaction / PropertyDataSet / PackageData / Description / Text / @language | 1..n | string | Dwuliterowy kod języka. |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs | 0..1 | AllowableRoomIDs | Kontener elementów <AllowableRoomID> .
Jeśli określono Jeśli nie podasz Użyj opcji |
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID | 1..n | AllowableRoomID | Określa identyfikator pokoju typu pokoju, który można połączyć z tym parametrem
planu taryfowego. Typ pokoju jest określony w: <RoomData>
.
|
Transaction / PropertyDataSet / PackageData / Refundable | 0..1 | Refundable | Umożliwia wyświetlanie informacji o cenie jako podlegającej pełnym zwrotowi lub możliwości anulowania. Jeśli jej nie podasz, nie pojawią się żadne informacje o zwrocie środków.
Uwaga: zalecamy skonfigurowanie wszystkich atrybutów. Plik danych Komunikat ostrzegawczy o stanie jest generowany, gdy co najmniej jeden atrybut nie ustawiono. Jeśli nie ustawisz żadnych atrybutów, stawka nie będzie wyświetlana jako podlega zwrotowi. Podczas ustawiania atrybutów pamiętaj o tych kwestiach:
|
Transaction / PropertyDataSet / PackageData / Refundable / @available | 1 | boolean | (Wymagane) Ustaw na 1 lub
true wskazuje, czy stawka zezwala na pełne
refund; w przeciwnym razie ma wartość 0 lub false . |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days | 0..1 | integer | (Wymagane, jeśli
available to true ) Wskazuje
liczbę dni przed datą zameldowania, na które można otrzymać pełny zwrot środków.
poproszono o dostęp. Wartość refundable_until_days
musi być liczbą całkowitą z zakresu od 0 do 330 włącznie. |
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time | 0.. | Time | (Zdecydowanie zalecany, jeśli
available to true ) Wskazuje
o ostatniej porze dnia, według lokalnego czasu hotelu,
Żądanie zwrotu kosztów zostanie uwzględnione. Może to być połączone z
refundable_until_days do określenia, dla
Na przykład: „Zwroty środków są dostępne do 16:00 dwa dni przed
zameldowania”. Jeśli refundable_until_time nie jest ustawiony, wartość
ustawiana jest domyślnie północ. |
Transaction / PropertyDataSet / PackageData / BreakfastIncluded | 0..1 | boolean | Określa, czy w pokoju tego typu jest śniadanie.
Prawidłowe wartości to 0 (lub false ) i 1
(lub true ).
Zalecamy używanie interfejsu |
Transaction / PropertyDataSet / PackageData / CheckinTime | 0..1 | Time | Najwcześniejszy możliwy czas zameldowania w czasie lokalnym w hotelu. Godzina musi być mniejsza niż 24:00. |
Transaction / PropertyDataSet / PackageData / CheckoutTime | 0..1 | Time | Najpóźniejszy możliwy czas wymeldowania według lokalnego czasu hotelu. |
Transaction / PropertyDataSet / PackageData / InternetIncluded | 0..1 | boolean | Określa, czy w pokoju jest bezpłatny dostęp do internetu
a pozostałe pokoje nie mają tego udogodnień. Nie ustawiaj tego elementu w:
hotel oferujący bezpłatny dostęp do internetu we wszystkich pokojach. Ten element
nie dotyczy przewodowego lub bezprzewodowego internetu w pokoju, który jest
niedostępne w pokojach gości. Prawidłowe wartości to 0 (lub
false ) i 1 (lub true ).
|
Transaction / PropertyDataSet / PackageData / Meals | 0..1 | Object | Zawiera informacje o posiłkach w tej paczce.
Element
Atrybuty opcjonalne są używane tylko wtedy, gdy atrybut W przypadku filtrów posiłków ( |
Transaction / PropertyDataSet / PackageData / ParkingIncluded | 0..1 | boolean | czy pokój ma bezpłatny parking, gdzie
W przeciwnym razie parking w tym hotelu byłby płatny. Nie określaj
wartość tego elementu w przypadku hotelu z bezpłatnym parkingiem.
Prawidłowe wartości to 0 (lub false ) i
1 (lub true ). Wartość domyślna to
false
|
Transaction / PropertyDataSet / PackageData / PhotoURL | 0..1 | Object | (Tak samo jak <PhotoURL> w <RoomData> ,
ale dotyczące opakowania (np. zdjęć posiłków).
|
Przykłady
Dane dotyczące pomieszczeń i pakietów
Oto podstawowy przykład zdefiniowania pokoju w usłudze
danych pakietu w wiadomości transakcji (dane usługi). overlay
jest używany do sprawdzania, czy ewentualne nieoczekiwanie już istnieją
Wszystkie dotychczasowe dane zostaną usunięte i zastąpione danymi z tej wiadomości:
<?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>
Dodaj typ pomieszczenia
Poniżej znajdziesz przykład dodawania typu pokoju i pakietu do
istniejące dane <Transaction>
:
<?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>
Usuń typy pomieszczeń
Poniższy przykład pokazuje, jak usunąć istniejące typy pomieszczeń.
przesyłek. Jeśli w tym przykładzie wiadomości w sekcji „Dane sal i pakietów”
i „Dodaj typ pomieszczenia” zostały już wysłane do Google, King
i
Gdy Google otrzyma tę wiadomość, Double
typu pokoju nie będzie już istnieć
wyświetlane. Pamiętaj, że usunięcie danych pakietu wpłynie na ogólny plan stawek
zgodnie z definicją zawartą w Transaction (Dane usługi), OTA_HotelRateAmountNotifRQ,
i OTA_HotelAvailNotifRQ
wiadomości (odwołując się do tego samego elementu PackageID
), a odpowiednie aktualizacje korzystające z innych typów wiadomości mogą być
wymagane, aby wskazać, że domeny PackageID_2
i PackageID_3
nie są już
tutaj zdefiniowane.
<?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>
Ogranicz plany stawek
Oto przykład użycia atrybutu <AllowablePackageIDs>
element ograniczający plany stawek dozwolone dla danego typu pokoju. W tym przykładzie
typ pokoju Queen
(RoomID_2
) można połączyć tylko z pakietem i
plan stawek określony jako 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>
Ogranicz pojemność sali
Oto przykład użycia: <Capacity>
, <AdultCapacity>
,
<ChildCapacity>
elementów, aby ustawić ograniczenia dotyczące pojemności sal.
<?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>
Pokój dwuosobowy (RoomID_1) może pomieścić do 4 osób. Dodatkowo: może pomieścić do 4 dorosłych i 3 dzieci. Wszystkie 3 pojemności określone wymagania, aby można było zarezerwować ten pokój. Ten jest reprezentatywna dla typowego pokoju z 2 łóżkami, z których każde dla dwóch osób. Limit podrzędny jest o 1 mniejszy niż łączna pojemność ponieważ w sali musi być co najmniej jedna osoba dorosła.
Rozszerzone przykłady zawierające atrybut <RoomFeatures>
i posiłki
JapaneseHotelRoomStyle
nie ma wartości domyślnej.
Pominięcie wartości nie powoduje błędu XML, ale informacje o firmie nie są
wyświetlane w wynikach wyszukiwania, gdy użytkownik filtruje według stylu pokoju lub łóżek.
2 łóżka pojedyncze
Poniższy przykład pokazuje, jak używać atrybutu <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>
2 łóżka podwójne
Oto przykład pokoju stylistycznego western
z 2 elementami
double
łóżka.
<?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>
Japoński styl bez łóżka
Poniżej znajdziesz przykład pokoju w stylu japońskim bez łóżka. Łóżko
informacje nie są wymagane w przypadku pokoju typu 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>
Japoński western z łóżkiem
Oto przykład pomieszczenia w stylu japanese_western
z elementem king
łóżko.
<?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>
Jeśli partner nie ma informacji o liczbie łóżek w: japanese_western
salach, spójrz na ten przykład:
<?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>
Posiłki
Poniższy przykład pokazuje metadane pomieszczenia i pakietu posiłków, zdjęć, oraz godzin zameldowania i wymeldowania:
<?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>
Tylko śniadanie
<?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>
Odpowiedzi
Składnia
Komunikat TransactionResponse (Property Data)
ma taką składnię:
<?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>
Elementy i atrybuty
Wiadomość TransactionResponse (Property Data)
zawiera te elementy
elementy i atrybuty:
Element / @Atrybut | Wystąpienia | Typ | Opis |
---|---|---|---|
TransactionResponse | 1 | Complex element | Element główny wskazujący na powodzenie lub problemy odebrane Komunikat z prośbą o transakcję. |
TransactionResponse / @timestamp | 1 | DateTime | Data i godzina utworzenia tej wiadomości. |
TransactionResponse / @id | 1 | string | Unikalny identyfikator powiązanej wiadomości transakcji. |
TransactionResponse / @partner | 1 | string | Konto partnera, z którego pochodzi ta wiadomość. |
TransactionResponse / Success | 0..1 | Success | Wskazuje, że komunikat transakcji został przetworzony
bez ostrzeżeń, błędów i błędów.
Dozwolone wartości |
TransactionResponse / Issues | 0..1 | Issues | Kontener dla co najmniej jednego problemu napotkanego podczas przetwarzania
Wiadomość dotycząca transakcji.
Dozwolone wartości |
TransactionResponse / Issues / Issue | 1..n | Issue | Opis ostrzeżenia, błędu lub błędu napotkanych podczas przetwarzania wiadomości transakcji. Szczegóły dotyczące tych problemów można znaleźć w artykule Komunikaty o błędach stanu pliku danych. |
TransactionResponse / Issues / Issue / @code | 1 | integer | Identyfikator problemu. |
TransactionResponse / Issues / Issue / @status | 1 | enum | Typ napotkanego problemu. Prawidłowe wartości to |
Przykłady
Sukces
Poniżej znajdziesz odpowiedź na pomyślnie przetworzony komunikat dotyczący transakcji.
<?xml version="1.0" encoding="UTF-8"?>
<TransactionResponse timestamp="2020-05-18T16:20:00-04:00"
id="12345678"
partner="partner_key">
<Success/>
</TransactionResponse>
Problemy
Poniżej znajdziesz odpowiedź na wiadomość dotyczącą transakcji, która nie została przetworzona z powodu .
<?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>