GetHotelAvailability
GetHotelAvailability
Запрос
- SearchID - идентификатор совершившегося поиска. Тип данных - целое 32-битное число.
- HotelID - идентификатор отеля для проверки доступности. Тип данных - целое 32-битное число.
- Rooms - контейнер с информацией о комнатах. Тип данных - сложный.
- Rooms.RoomData - контейнер с информацией о комнате, которую требуется забронировать. Тип данных - сложный.
- Rooms.RoomData.RoomSearchIndex - идентификатор порядкового номера искомой комнаты. Тип данных - целое беззнаковое 32-битное число.
- Rooms.RoomData.RoomVariantID - идентификатор бронируемой комнаты. Тип данных - целое беззнаковое 32-битное число.
Пример запроса (XML)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:stl="http://nemo-ibe.com/STL" xmlns:hot="http://nemo-ibe.com/Hotels">
<soapenv:Header/>
<soapenv:Body>
<tem:GetHotelAvailability>
<!--Optional:-->
<tem:Request>
<stl:Requisites>
<!--Optional:-->
<stl:Login>...</stl:Login>
<!--Optional:-->
<stl:Password>...</stl:Password>
</stl:Requisites>
<stl:UserID>...</stl:UserID>
<stl:RequestBody>
<hot:SearchId>41350</hot:SearchId>
<hot:HotelId>50229500</hot:HotelId>
<hot:Rooms>
<!--Zero or more repetitions:-->
<hot:RoomData>
<hot:RoomSearchIndex>0</hot:RoomSearchIndex>
<hot:RoomVariantId>3</hot:RoomVariantId>
</hot:RoomData>
</hot:Rooms>
</stl:RequestBody>
</tem:Request>
</tem:GetHotelAvailability>
</soapenv:Body>
</soapenv:Envelope>
Ответ
- SearchID - идентификатор совершившегося поиска. Тип данных - целое 32-битное число.
- RoomsRequestData** - контейнер с информацией о поисковом запросе. Тип данных - сложный.
- RoomsRequestData.Room - контейнер с информацией о количестве постояльцев. Тип данных - сложный.
- RoomsRequestData.Room.AdultsCount - количество взрослых постояльцев. Тип данных - целое беззнаковое 32-битное число.
- RoomsRequestData.Room.ChidrenCount - количество детей. Тип данных - целое беззнаковое 32-битное число.
- RoomsRequestData.Room.ChildrenAges - контейнер с информацией о возрасте детей. Тип данных - целое беззнаковое 32-битное число.
- RoomsRequestData.Room.ChildrenAges.Age - возраст детей в запросе. Тип данных - целое беззнаковое 32-битное число.
- RoomTypesGroup - контейнер с информацией о найденных типах комнат. Тип данных - сложный.
- RoomTypesGroup.Type - контейнер с информацией о комнате. Тип данных - сложный.
- RoomTypesGroup.Type.ID - идентификатор типа комнаты в рамках этого результата поиска. Тип данных - целое беззнаковое 32-битное число.
- RoomTypesGroup.Type.Name - название типа комнаты. Тип данных - строка.
- RoomTypesGroup.Type.CommonName - распространенное название комнаты. Тип данных - строка.
- RoomMealsGroup - контейнер с информацией о возможных типах питания. Тип данных - сложный.
- RoomMealsGroup.Meal - контейнер с информацией о типе питания. Тип данных - сложный.
- RoomMealsGroup.Meal.ID - идентификатор типа питания в рамках этого результата поиска. Тип данных - целое беззнаковое 32-битное число.
- RoomMealsGroup.Meal.MealCode - код типа питания. Тип данных - строка.
- RoomMealsGroup.Meal.Name - название типа питания. Тип данных - строка.
- RoomRatesGroup - контейнер с информацией о стоимости комнат. Тип данных - сложный.
- RoomRatesGroup.Rate - контейнер с информацией о стоимости, тариф. Тип данных - сложный.
- RoomRatesGroup.Rate.DiscountID - код корпоративных отелей. Тип данных - строка.
- RoomRatesGroup.Rate.ID - идентификатор тарифа в рамках этого результата поиска. Тип данных - целое беззнаковое 32-битное число.
- RoomRatesGroup.Rate.Price - контейнер с информацией о валюте. Тип данных - сложный.
- RoomRatesGroup.Rate.Price.Amount - сумма базовый цены. Тип данных - дробное число.
- RoomRatesGroup.Rate.Price.Currency - код валюты базовой цены. Тип данных - строка.
- RoomRatesGroup.Rate.IsSpecialOffer - признак данного тарифа как специального предложения. Тип данных - булевский.
- RoomRatesGroup.Rate.VisaSupportProvided - признак наличия визовой поддержки отеля. Тип данных - булевский.
- RoomRatesGroup.Rate.IsNonRefundable - признак возвратности. Тип данных - булевский.
- RoomRatesGroup.Rate.BookingRemarks - контейнер с ремарками. Тип данных - сложный.
- RoomRatesGroup.Rate.CancellationRules - контейнер с правилами отмены. Тип данных - сложный.
- RoomRatesGroup.Rate.CancellationRules.CancellationRule - контейнер с правилами отмены. Тип данных - сложный.
- RoomRatesGroup.Rate.CancellationRules.CancellationRule.ID - идентификатор правила отмены. Тип данных - целое беззнаковое 32-битное число.
- RoomRatesGroup.Rate.CancellationRules.CancellationRule.DeadLine - крайний срок отмены брони без штрафа. Часовой пояс - UTC. Тип данных - строка.
- RoomRatesGroup.Rate.CancellationRules.CancellationRule.PercentValue - значение штрафа в процентах. Тип данных - целое беззнаковое 32-битное число.
- RoomRatesGroup.Rate.CancellationRules.CancellationRule.AbsoluteValue - значение штрафа в заданной валюте. Тип данных - целое беззнаковое 32-битное число.
- RoomRatesGroup.Rate.FreeCount - отражает количество доступных для продажи комнат (реализовано только у поставщика Bronevik, не является обязательным). Тип данных - целое беззнаковое 32-битное число.
- RoomRatesGroup.Rate.AgencyTimeLimit - таймлимит от поставщика. Тип данных - дата, YYYY-MM-DDTHH:MM:SSZ
- RoomRatesGroup.Rate.AdditionalInfo - контейнер с дополнительной информацией о номере. Тип данных - сложный.
- RoomRatesGroup.Rate.AdditionalInfo SupplierInformation - контейнер с дополнительной информацией от поставщика о номере. Тип данных - сложный.
- RoomRatesGroup.Rate.AdditionalInfo SupplierInformation.Name - название информации. Тип данных - строка.
- RoomRatesGroup.Rate.AdditionalInfo SupplierInformation.Value - контейнер с описанием дополнительной информации. Тип данных - сложный.
- RoomRatesGroup.Rate.AdditionalInfo SupplierInformation.Value.string - описанием дополнительной информации. Тип данных - строка.
- RoomRatesGroup.Rate.EarlyCheckInInd - отражает информацию о доступности раннего заезда (используется на этапе проверки отеля). Тип данных - булевский.
- RoomRatesGroup.Rate.LateCheckOutInd - отражает информацию о доступности позднего выезда (используется на этапе проверки отеля). Тип данных - булевский.
- RoomsGroup - контейнер с информацией о различных вариантов комнат. Тип данных - сложный.
- RoomsGroup.Room - контейнер с идентификаторами параметров комнаты. Тип данных - сложный.
- RoomsGroup.Room.ID - идентификатор комнаты. Тип данных - целое беззнаковое 32-битное число.
- RoomsGroup.Room.TypeID - идентификатор типа комнаты. Тип данных - целое беззнаковое 32-битное число.
- RoomsGroup.Room.MealID - идентификатор типа питания. Тип данных - целое беззнаковое 32-битное число.
- RoomsGroup.Room.RateID - идентификатор тарифа. Тип данных - целое беззнаковое 32-битное число.
- Hotels - контейнер с информацией об отелях в поисковой выдаче. Тип данных - сложный.
- Hotels.Hotel - контейнер с информацией об отеле. Тип данных - сложный.
- Hotels.Hotel.HotelID - идентификатор отеля. Тип данных - целое беззнаковое 32-битное число.
- Hotels.Hotel.Name - название отеля. Тип данных - строка.
- Hotels.Hotel.RoomCombinationsм - контейнер со списком всех доступных комбинациях определенных номеров и комнат . Тип данных - сложный.
- Hotels.Hotel.RoomCombinations.RoomCombination - контейнер с информацией о конкретной комбинации, которую можно использовать в запросе бронирования. Тип данных - сложный.
- Hotels.Hotel.RoomCombinations.RoomCombination.Room - контейнер с информацией о комнате. Тип данных - сложный.
- Hotels.Hotel.RoomCombinations.RoomCombination.Room.SearchRoomID - идентификатор порядкового номера искомой комнаты, данное значение используется в RoomData.RoomSearchIndex при бронировании. Тип данных - целое беззнаковое 32-битное число.
- Hotels.Hotel.RoomCombinations.RoomCombination.Room.RoomVariantID - идентификатор комнаты, данное значение используется в RoomData.RoomVariantId при бронировании. Тип данных - целое беззнаковое 32-битное число.
- Hotels.Hotel.RoomGroups - контейнер с информацией о доступных комнатах. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room - контейнер с информацией о комнате. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.SearchRoomID - идентификатор запрашиваемой комнаты из запроса RunCitySearch Rooms.Room. Тип данных - целое беззнаковое 32-битное число.
- Hotels.Hotel.RoomGroups.Room.RoomVariants - контейнер с номерами комнат, подходящих под запрос. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.RoomVariants.RoomID - идентификатор подходящих комнат. Тип данных - целое беззнаковое 32-битное число.
- Hotels.Hotel.RoomGroups.Room.Markups - контейнер с информацией о наценках, рассчитываемых в соответствии с настройками. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.Markups.Markup - контейнер с информацией о наценке. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.Markups.Markup.RoomVariantID - идентификатор комнаты. Тип данных - целое беззнаковое 32-битное число.
- Hotels.Hotel.RoomGroups.Room.Markups.Markup.Sum - контейнер с информацией о сумме и валюте наценки. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.Markups.Markup.Sum.Amount - сумма наценки. Тип данных - дробное число.
- Hotels.Hotel.RoomGroups.Room.Markups.Markup.Sum.Currency - код валюты наценки. Тип данных - строка.
- Hotels.Hotel.RoomGroups.Room.AgencyCharges - контейнер с информацией о сборах агенства, рассчитываемых в соответствии с настройками. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.AgencyCharges.AgencyCharge - контейнер с информацией о сборе агенства. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.AgencyCharges.AgencyCharge.RoomVariantID - идентификатор комнаты. Тип данных - целое беззнаковое 32-битное число.
- Hotels.Hotel.RoomGroups.Room.AgencyCharges.AgencyCharge.Sum - контейнер с информацией о сумме и валюте сбора. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.AgencyCharges.AgencyCharge.Sum.Amount - сумма сбора. Тип данных - дробное число.
- Hotels.Hotel.RoomGroups.Room.AgencyCharges.AgencyCharge.Sum.Currency - код валюты сбора. Тип данных - строка.
- Hotels.Hotel.RoomGroups.Room.ServiceCharges - контейнер с информацией о сборах сервис провайдера, рассчитываемых в соответствии с настройками. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.ServiceCharges.ServiceCharge - контейнер с информацией о сборе сервис провайдера. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.ServiceCharges.ServiceCharge.RoomVariantID - идентификатор комнаты. Тип данных - целое беззнаковое 32-битное число.
- Hotels.Hotel.RoomGroups.Room.ServiceCharges.ServiceCharge.Sum - контейнер с информацией о сумме и валюте сбора. Тип данных - сложный.
- Hotels.Hotel.RoomGroups.Room.ServiceCharges.ServiceCharge.Sum.Amount - сумма сбора. Тип данных - дробное число.
- Hotels.Hotel.RoomGroups.Room.ServiceCharges.ServiceCharge.Sum.Currency - код валюты сбора. Тип данных - строка.
- Hotels.Hotel.EarlyCheckInGroup - контейнер с информацией о предлагаемых вариантах раннего заселения (используется на этапе проверки комнаты). Тип данных - сложный.
- Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer - контейнер с информацией о варианте. Цена указана за один номер. Тип данных - сложный.
- Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer.Time - контейнер с информацией о предлагаемом времени. Тип данных - строка формата hh:mm.
- Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer.Price - контейнер с информацией о цене данного предложения. Тип данных - сложный.
- Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer.Price.Amount - сумма цены. Тип данных - дробное число.
- Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer.Price.Currency - код валюты. Тип данных - строка.
- Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer.Description - дополнительная информация. Тип данных - строка.
- Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer.Guaranteed - признак гарантированности услуги. Тип данных - булевский.
- Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer.PriceRule - правила, по которым предоставляется услуга. Тип данных - перечисление, возможные значения:
- Unknown - Неизвестно
- Free - Бесплатно
- AdditionalPrice - Доплата
- Hotels.Hotel.LateCheckOutGroup - информация о предлагаемых вариантах позднего выезда из отеля (используется на этапе проверки комнаты). Тип данных - сложный.
- Hotels.Hotel.LateCheckOutGroup.CheckInOutOffer - контейнер с информацией о варианте. Тип данных - сложный. Идентичен Hotels.Hotel.EarlyCheckInGroup.CheckInOutOffer
Пример ответа (XML)
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetHotelAvailabilityResponse xmlns="http://tempuri.org/">
<GetHotelAvailabilityResult xmlns:a="http://nemo-ibe.com/STL" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:RequestID>2900</a:RequestID>
<a:Errors/>
<a:ResponseBody xmlns:b="http://nemo-ibe.com/Hotels">
<b:SearchId>41350</b:SearchId>
<b:RoomsRequestData>
<b:Room>
<b:AdultsCount>1</b:AdultsCount>
<b:ChildrenCount>1</b:ChildrenCount>
<b:ChildrenAges>
<b:Age>10</b:Age>
</b:ChildrenAges>
</b:Room>
</b:RoomsRequestData>
<b:RoomTypesGroup>
<b:Type>
<b:Id>0</b:Id>
<b:Name>Double Standard</b:Name>
<b:CommonName>Standard Double</b:CommonName>
</b:Type>
</b:RoomTypesGroup>
<b:RoomMealsGroup>
<b:Meal>
<b:Id>0</b:Id>
<b:MealCode>BB</b:MealCode>
<b:Name>Breakfast</b:Name>
</b:Meal>
</b:RoomMealsGroup>
<b:RoomRatesGroup>
<b:Rate>
<b:Id>1</b:Id>
<b:Price>
<a:Amount>184.68</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Price>
<b:IsSpecialOffer>false</b:IsSpecialOffer>
<b:VisaSupportProvided>false</b:VisaSupportProvided>
<b:IsNonRefundable>false</b:IsNonRefundable>
<b:BookingRemarks i:nil="true"/>
<b:CancellationRules>
<b:RuleId>0</b:RuleId>
</b:CancellationRules>
<b:FreeCount>2</b:FreeCount>
<b:AgencyTimeLimit>2019-06-28T13:00:00Z</b:AgencyTimeLimit>
</b:Rate>
</b:RoomRatesGroup>
<b:RoomsGroup>
<b:Room>
<b:Id>3</b:Id>
<b:TypeId>0</b:TypeId>
<b:MealId>0</b:MealId>
<b:RateId>1</b:RateId>
</b:Room>
</b:RoomsGroup>
<b:CancellationRules>
<b:CancellationRule>
<b:Id>0</b:Id>
<b:DeadLine>2016-09-21T00:00:00</b:DeadLine>
<b:PercentValue>30</b:PercentValue>
<b:AbsoluteValue>0</b:AbsoluteValue>
</b:CancellationRule>
</b:CancellationRules>
<b:Hotels>
<b:Hotel>
<b:HotelId>50229500</b:HotelId>
<b:Name>Best Western Plus Vega Hotel & Convention Center</b:Name>
<b:RoomGroups>
<b:Room>
<b:SearchRoomId>0</b:SearchRoomId>
<b:RoomVariants>
<b:RoomId>3</b:RoomId>
</b:RoomVariants>
<b:Markups>
<b:Markup>
<b:RoomVariantId>4491230000000</b:RoomVariantId>
<b:Sum>
<a:Amount>-26.8307638168335</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Sum>
</b:Markup>
</b:Markups>
<b:AgencyCharges>
<b:AgencyCharge>
<b:RoomVariantId>4491230000000</b:RoomVariantId>
<b:Sum>
<a:Amount>-1.24884233810008</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Sum>
</b:AgencyCharge>
</b:AgencyCharges>
<b:ServiceCharges>
<b:ServiceCharge>
<b:RoomVariantId>4491230000000</b:RoomVariantId>
<b:Sum>
<a:Amount>-3.43047529459</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Sum>
</b:ServiceCharge>
</b:ServiceCharges>
</b:Room>
</b:RoomGroups>
<b:EarlyCheckInGroup/>
<b:LateCheckOutGroup>
<b:CheckInOutOffer>
<b:Time>12:30</b:Time>
<b:Price>
<a:Amount>15</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Price>
<b:Description/>
<b:Guaranteed>false</b:Guaranteed>
<b:PriceRule>AdditionalPrice</b:PriceRule>
</b:CheckInOutOffer>
<b:CheckInOutOffer>
<b:Time>13:00</b:Time>
<b:Price>
<a:Amount>10</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Price>
<b:Description/>
<b:Guaranteed>false</b:Guaranteed>
<b:PriceRule>AdditionalPrice</b:PriceRule>
</b:CheckInOutOffer>
<b:CheckInOutOffer>
<b:Time>13:30</b:Time>
<b:Price>
<a:Amount>14</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Price>
<b:Description/>
<b:Guaranteed>false</b:Guaranteed>
<b:PriceRule>AdditionalPrice</b:PriceRule>
</b:CheckInOutOffer>
<b:CheckInOutOffer>
<b:Time>14:00</b:Time>
<b:Price>
<a:Amount>15</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Price>
<b:Description/>
<b:Guaranteed>false</b:Guaranteed>
<b:PriceRule>AdditionalPrice</b:PriceRule>
</b:CheckInOutOffer>
<b:CheckInOutOffer>
<b:Time>14:30</b:Time>
<b:Price>
<a:Amount>15</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Price>
<b:Description/>
<b:Guaranteed>false</b:Guaranteed>
<b:PriceRule>AdditionalPrice</b:PriceRule>
</b:CheckInOutOffer>
<b:CheckInOutOffer>
<b:Time>15:00</b:Time>
<b:Price>
<a:Amount>15</a:Amount>
<a:Currency>EUR</a:Currency>
</b:Price>
<b:Description/>
<b:Guaranteed>false</b:Guaranteed>
<b:PriceRule>AdditionalPrice</b:PriceRule>
</b:CheckInOutOffer>
</b:LateCheckOutGroup>
</b:Hotel>
</b:Hotels>
</a:ResponseBody>
</GetHotelAvailabilityResult>
</GetHotelAvailabilityResponse>
</s:Body>
</s:Envelope>