Описание методов XML API

oktogo.ru Xml API бронирования
отелеи
Version 1.9
oktogo.ru Xml API бронирования отелей
Page 1
Общее описание
Веб-сервис может быть вызван любым веб- или классическим приложением
поддерживающим стандартные протоколы SOAP 1.1 и/или HTTP 1.1.
Вы можете выбрать один из следующих способов связи:
1. Использовать WSDL дескриптор для создания прокси к интерфейсу веб-сервиса. Полное
определение XML для операций веб-сервиса доступно по ссылке:
http://test1.oktogo.ru/travelxmlapi/TravelApiService.asmx?WSDL.
2. Открыть прямое соединение через HTTP протокол и передать методами POST или GET параметр
с XML запросом, соответствующим XSD схеме веб-сервиса. Чтобы напрямую подключиться к
тестовому веб-сервису используйте следующую ссылку:
http://test1.oktogo.ru/travelxmlapi/TravelApiService.asmx?op=request
Примечание: если используется прямое HTTP соединение, то подразумевается что параметр с XML
запросом будет передан с именем xmlRequest. Значением параметра должна быть строка,
содержащая XML документ с параметрами запроса. Если этот параметр будет передан с другим
именем, или будет содержать невалидный xml, то вернётся ошибка "There is an error in XML
document".
Запросы должны передаваться с использованием UTF-8 (Unicode) encoding. Ответы также будут в
UTF-8.
Схема работы с oktogo.ru Xml API
Работа с Xml API осуществляется путём посылки Xml запроса содержащего объект
HotelRequest. Свойство HotelRequestMethod данного объекта определяет, какая именно
операция должна быть выполнена: поиск доступных отелей, резервирование отелей, их отмена и
т.д.
На каждый запрос сервис осуществляет отсылку ответа. Этот ответ имеет структуру
HotelResponse. В зависимости от изначального запроса HotelResponse содержит
соответствующую информацию либо информацию об ошибках, которые произошли при
выполнении запроса.
oktogo.ru Xml API бронирования отелей
Page 2
Описание методов XML API:
Цветами отмечено
Запросы для получения доступности
Запросы для работы с резервациями
Запросы для получения контентной информации
Запрос
Обязательные параметры запроса
Ответ
GetAvailabilityByDestinati
ons
HotelSearchParameters,
HotelSearchParameters.DestinationId содержит идентификатор выбранного
местоположения,
HotelSearchParameters.Currency – тип
валюты,
HotelSearchParameters.CheckInDate – дата
въезда в номер,
HotelSearchParameters.CheckOutDate – дата
выезда из номера,
HotelSearchParameters.Rooms – список
комнат для бронирования,
HotelSearchParameters.Rooms.Guests –
список гостей в каждом номере,
HotelSearchParameters.Rooms.Guests.Age –
возраст каждого гостя
HotelSearchParameters,
HotelSearchParameters.HotelId содержит
идентификатор выбранного отеля,
HotelSearchParameters.Currency – тип
валюты,
HotelSearchParameters.CheckInDate – дата
въезда в номер,
HotelSearchParameters.CheckOutDate – дата
выезда из номера,
HotelSearchParameters.Rooms – список
комнат для бронирования,
HotelSearchParameters.Rooms.Guests –
список гостей в каждом номере,
HotelSearchParameters.Rooms.Guests.Age –
возраст каждого гостя
ReservationParameters,
ReservationParameters.HotelId –
идентификатор отеля,
ReservationParameters.Currency – тип
валюты,
ReservationParameters.AvailabilityCode – код,
полученный после вызова
GetAvailabilityByHotel,
ReservationParameters.Rates.RateId –
идентификатор рейта, полученого через
GetAvailabilityByHotel
SearchResponse
содержит список
доступных отелей
и их минимальные
цены
Availability
GetAvailabilityByHotels
GetHotelbedsFinalRate
(примечание: уточнение
необходимо только для
рейтов от вендора
Hotelbeds)
oktogo.ru Xml API бронирования отелей
SearchResponse
содержит
AvailabilityCode и
список комнат и
рейтов по
выбранному
отелю
SearchResponse
содержит
AvailabilityCode и
комнату с
уточненным
рейтом по
выбранному
отелю, вместе с
правилами
отмены для
данного рейта
Page 3
GetHotelReservation
ReservationParameters,
ReservationParameters.HotelId –
идентификатор отеля,
ReservationParameters.Currency – тип
валюты,
ReservationParameters.AvailabilityCode – код,
полученный после вызова
GetAvailabilityByHotel ,
ReservationParameters.Persons – список
гостей,
ReservationParameters.Persons.ReservationPer
sonId – идентификатор гостя,
ReservationParameters.Persons.Age – возраст
гостя,
ReservationParameters.Persons.FirstName –
имя гостя,
ReservationParameters.Persons.LastName –
фамилия гостя,
ReservationParameters.ClientInfo –
информация по контактному лицу,
ReservationParameters.ClientInfo.FirstName –
имя контактного лица,
ReservationParameters.ClientInfo.LastName –
фамилия контактного лица,
ReservationParameters.Rates – список рейтов
для бронирования,
ReservationParameters.Rates.RateId –
идентификатор рейта, полученого через
GetAvailabilityByHotel,
ReservationParameters.Rates.Guests – список
идентификаторов гостей для рейта
(выбирается из идентификаторов гостей в
ReservationParameters.Persons)
ReservationParameters,
ReservationParameters.HotelId –
идентификатор отеля,
ReservationParameters.Currency – тип
валюты,
ReservationParameters.AvailabilityCode – код,
полученный после вызова
GetAvailabilityByHotel ,
ReservationParameters.Rates – список рейтов
для бронирования,
ReservationParameters.Rates.RateId –
идентификатор рейта, полученого через
GetAvailabilityByHotel
ReservationID – идентификатор резервации
CancelReservation
ReservationID – идентификатор резервации
Reservation
MakeHotelReservation
AddRoomsToShoppingCar
t
oktogo.ru Xml API бронирования отелей
Reservation
содержит всю
информацию по
сделанной
резервации
ShoppingCartId
содержит id
корзины
Reservation
содержит всю
информацию по
резервации
Reservation
содержит всю
информацию по
Page 4
GetReservationList
ReservationListFilter - содержит параметры
фильтрации резерваций
FindDestination
Destination – информация об искомом
местоположении,
Destination.City – название города
Content information
GetCountryList
GetCityList
GetChildLocations
GetHotelsContent
Destination – информация об искомом
местоположении,
Destination.DestinationId – идентификатор
местности
Destination – информация об искомом
местоположении,
Destination.DestinationId – идентификатор
местности
Hotels – список идентификаторов отелей
oktogo.ru Xml API бронирования отелей
отменённой
резервации
Reservations
содержит
страницу из
списка найденных
резерваций
(ReservationSumm
ary — краткая
информация) для
афторизованного
партнера
Список найденных
городов и их
идентификаторов
Список всех стран
и их
идентификаторов
Список всех
городов данной
страны и их
идентификаторов
Список дочерних
локаций.
Список отелей и
информации о них
Page 5
HotelRequest
Используется в качестве запроса
<AffiliateId>
string
Идентификатор партнёра
<Password>
string
Пароль партнёра
<HotelRequestMethod>
enum
Тип запроса к серверу. Может принимать одно из
следующих значений:
GetAvailabilityByDestinations : для поиска доступных отелей
в определённом населенном пункте
GetAvailabilityByHotels : для поиска мест в определённом
отеле
GetHotelbedsFinalRate – для уточнения данных рейта.
Необходим только для рейтов от вендора Hotelbeds
MakeHotelReservation : для резервирования мест в отеле
AddRoomsToShoppingCart : для добавления мест в корзину
CancelReservation : для отмены резервации
GetHotelReservation : для получения данных по резервации
GetReservationList : для получения списка резерваций
авторизованного партнера (с фильтрацией и разбиением на
страницы)
FindDestination : для поиска городов
GetCountryList : получение списка стран
GetCityList : получение списка всех городов для
определённой страны
GetChildLocations : получение списка всех местностей
входящих территориально в другую местность
GetHotelsContent : получение общей информации по
отелям
Используется при поиске по городу, при поиске по отелю и
при уточнении рейта от Hotelbeds
(GetAvailabilityByDestinations, GetAvailabilityByHotesl)
Используется при заказе (MakeHotelReservation,
AddRoomsToShoppingCart, GetHotelbedsFinalRate)
<HotelSearchParameters>
object
<ReservationParameters>
object
<ReservationId>
guid
Используется при отмене и при получении данных о
резервации (CancelReservation, GetHotelReservation)
<ReservationListFilter>
object
Используется при получении списка резерваций
(GetReservationList)
<Destination>
object
Используется при поиске идентификаторов городов
(FindDestination, GetCityList, GetChildLocations)
<Hotels>
array
Используется при получении информации по отелям
(GetHotelsContent)
Список отелей, по которым нужна информация
Идентификатор отеля для получения информации по
данному отелю
<HotelId>
int
oktogo.ru Xml API бронирования отелей
Page 6
HotelSearchParameters
Заполняется при HotelRequestMethod равным GetAvailabilityByHotel или
GetAvailabilityByDestination.
<HotelId>
int
<CheckInDate>
<CheckOutDate>
<DestinationId>
date
date
int
<Currency>
enum
<MinStarRating>
<MaxStarRating>
<Rooms>
<RoomInfo>
<Guests>
<Guest>
<Age>
int
int
array
object
array
object
int
<IsChild>
bool
Идентификатор отеля.
Обязательное при GetAvailabilityByHotels
Дата заезда
Дата выезда
Идентификатор города.
Обязательное при GetAvailabilityByDestination
Валюта поиска
Может принимать одно из следующих значений:
EUR - евро
USD - доллары США
GBP - английский фунт стерлингов
RUB - российский рубль
Минимальный рейтинг отеля (количество звёзд)
Максимальный рейтинг отеля (количество звёзд)
Список комнат, требуемых для резервации
Комната
Список гостей для данной комнаты
Гость
Возраст в годах, обязательное для ребёнка. При отсутствии
гость считается взрослым
Является ли гость ребёнком, обязательное для ребёнка
ReservationParameters
Заполняется при заказе резервации (методы MakeHotelReservation и AddRoomsToShoppingCart)
<HotelId>
<Persons>
<ReservationPerson>
<AvailabilityCode>
int
array
object
string
<Rates>
<RateInfo>
<RateId>
<Guests>
array
object
guid
array
<ClientInfo>
<Currency>
object
enum
Идентификатор отеля.
Список гостей, которые будут указаны в резервации
Информация о госте
Идентификатор поискового запроса, возвращённый в ответ
на GetAvailabilityByHotels
Список идентификаторов рейтов, выбранных для резервации
Идентификатор рейта
Список гостей для данного рейта (список из
ReservationPersonId (guid) элементов)
Информация о заказчике
Валюта поиска
Может принимать одно из следующих значений:
EUR - евро
USD - доллары США
GBP - английский фунт стерлингов
RUB - российский рубль
oktogo.ru Xml API бронирования отелей
Page 7
ReservationPerson
Заполняется при резервации комнаты.
<ReservationPersonId>
<Title>
<FirstName>
<LastName>
<Age>
guid
string
string
string
int
<IsChild>
<Gender>
<CitizenCountryCode>
bool
string
string
Идентификатор гостя
Обращение
Имя латиницей
Фамилия латиницей
Возраст гостя. Обязательное для ребёнка. При отсутствии
гость считается взрослым
Является ли ребёнком, обязательное для ребёнка
Пол гостя
Код страны гостя
ClientInfo
Заполняется при резервации.
<FirstName>
<LastName>
<Email>
<Phone>
string
string
string
string
Имя латиницей
Фамилия латиницей
Электронный адрес
телефон
ReservationListFilter
Заполняется при поиске резерваций.
<ReservationDateFrom>
<ReservationDateTo>
<CheckInFrom>
<CheckInTo>
<PageNumber>
<PageSize>
<ClientName>
<OrderDetails>
dateTime
dateTime
dateTime
dateTime
int
int
string
string
<ReservationNumber>
int
Начало диапазона дат создания резервации
Конец диапазона дат создания резервации
Начало диапазона дат заезда
Конец диапазона дат заезда
Номер страницы
Число резерваций на странице
Фильтр по имени, фамилии гостей, плательщика
Фильтр по деталям резервации (имена, фамилии
гостей, плательщика; название отеля; название
страны, города, где расположен отель)
Фильтр по номеру резервации
Destination
Используется при поиске городов
<City>
<Country>
<State>
<DestinationId>
<DestinationType>
string
string
string
int
enum
Город, обязательный параметр
Страна, необязательный параметр
Штат \ регион, необязательный параметр
Идентификатор местности, заполняется при ответе
Тип местности, заполняется при ответе
oktogo.ru Xml API бронирования отелей
Page 8
HotelResponse
Объект HotelResponse возвращается в ответ на все запросы отельного XML API
<Products>
array
<HotelRS>
<Currency>
<ShoppingCartId>
object
enum
guid
<AvailabilityCode>
guid
<Reservation>
object
<Reservations>
object
<Reservations>
<ReservationSummary>
<PageNumber>
<PageSize>
<TotalReservations>
<Destination>
object
object
Int
Int
Int
array
<Destination>
<HotelsInfo>
object
array
<HotelInfo>
<Errors>
object
array
<Error>
Список отелей, по которым найдены доступные места.
В случае поискового запроса по городу представляет собой
список отелей, каждый из которых содержит минимальную
цену для условий поиска.
В случае поиска по отелю содержит один элемент отеля,
который содержит список типов комнат и рейтов.
Описание отеля
Валюта поискового запроса.
Guid корзины. Возвращается в ответ на
AddRoomsToShoppingCart
Идентификатор поискового запроса, возвращается в ответ
на GetAvailabilityByHotels
Информация о резервации.
Возвращается в ответ на MakeHotelReservation,
CancelReservation, GetHotelReservation
Список резерваций - возвращается в ответ на
GetReservationList
Страница списка резерваций
Краткая информация о резервации
Номер страницы
Размер страницы
Общее кол-во резерваций
Список городов, удовлетворяющих поисковому запросу по
городам
Возвращается в ответ на FindDestination, GetCityList,
GetCountryList
Список отелей с информацией по ним
Возвращается в ответ на GetHotelsContent
Список ошибок.
Может быть возвращён на любой запрос в случае ошибки
object
<ErrorCode>
int
Код ошибки
<ErrorMessage>
<Module>
string
int
Текст ошибки
Код модуля, в котором произошла ошибка
HotelRS
<HotelId>
int
Идентификатор отеля
<StarRating>
int
Рейтинг отеля (количество звёзд)
<CheckIn>
<CheckOut>
<PriceFrom>
<DestinationId>
< CategoryId>
date
date
decimal
int
int
Дата заезда (время Московское)
Дата выезда (время Московское)
Минимальная цена в данном отеле
Идентификатор города
ID категории отеля
oktogo.ru Xml API бронирования отелей
Page 9
<Rooms>
<Room>
<RoomType>
<RoomName>
<RoomDescription>
<GuestAges>
<Age>
<Rates>
<Rate>
array
object
enum
string
string
array
int
array
object
Список доступных комнат\рейтов.
Заполняется при HotelRequestMethod равному
GetAvailabilityByHotels.
При GetAvailabilityByDestinations коллекция заполняется
только для некоторых вендоров (по запросу к админам).
Комната
Тип комнаты
Название комнаты
Описание комнаты
Список возрастов гостей
Возраст в полных годах
Список рейтов данной комнаты
Рейт
Rate
Детальное описание того, что входит в цену комнаты.
<RateId>
<Vendor>
guid
string
<RoomName>
<RoomDescription>
<Taxes>
<TotalPrice>
<BedType>
<MealType>
<RoomSubType>
<IsPostPay>
<IsOnRequest>
string
string
decimal
decimal
enum
enum
string
bool
bool
<IsNonRefundable>
<IsNonSmoking>
<IsCommissionable>
<AvailableCount>
bool
bool
bool
int
<CancellationPolicyRules>
<CancellationRule>
<Amount>
<UTCDateFrom>
<UTCDateTo>
<IsPossible>
array
object
decimal
date
date
bool
Идентификатор рейта
Вендор, предоставляющий данный рейт:
GTA, Hotelbeds, Miki Travel, Tourico, Expedia, Oktogo, Acase,
SunHotels
Название комнаты
Описание комнаты
Сумма налогов отеля
Общая стоимость, включая налоги
Тип кроватей
Тип питания
Подтип комнаты
Оплата возможна только в отеле
Точная информация о возможности резервирования
доступна только по запросу в отель
Данное предложение является невозмещаемым
Курение запрещено
Коммисионный рейт
Количество доступных для бронирования комнат. Если
значение равно 0 или -1, то считается, что количество
комнат неограничено.
Список правил отмены данной комнаты
Величина штрафа при отмене
Дата начала действия данного правила
Дата окончания действия данного правила
Определяет, возможна ли отмена резервации
oktogo.ru Xml API бронирования отелей
Page 10
Reservation
Возвращается в ответ на MakeHotelReservation, CancelReservation, GetHotelReservation
<ReservationId>
<ReservationDate>
<Currency>
<TotalPrice>
<Status>
<OktogoReservationNumber>
<DefaultCheckinTime>
<DefaultCheckoutTime>
<Persons>
<ReservationPerson>
<ClientInfo>
guid
date
enum
decimal
enum
string
String
string
array
object
object
<ReservationHotel>
<HotelId>
<Name>
<StarRating>
<DestinationId>
<Phone>
<Fax>
<Rooms>
<ReservationHotelRoom>
<RoomName>
<RoomDescription>
<Taxes>
<TotalPrice>
<RoomType>
<BedType>
<MealType>
<RoomSubType>
<CheckIn>
<CheckOut>
<Guests>
<GuestId>
<IsPostPay>
<IsOnRequest>
object
int
string
int
int
string
string
array
object
string
string
decimal
decimal
enum
enum
enum
string
date
date
array
guid
bool
bool
<IsNonRefundable>
<Vendor>
<VendorReservationId>
<CancellationPolicyRules>
<CancellationRule>
<Amount>
<UTCDateFrom>
bool
String
string
array
object
decimal
date
oktogo.ru Xml API бронирования отелей
Идентификатор резервации
Дата, когда резервация была сделана
Валюта резервации
Общая стоимость
Статус резервации
Идентификатор резервации в системе Oktogo
Время заселения в отель
Время выезда из отеля
Список гостей
Информация о госте
Информация о клиенте. Те же данные, что и при
MakeHotelReservation
Идентификатор отеля
Имя отеля
Рейтинг отеля (количество звёзд)
Идентификатор населенного пункта отеля
Телефон отеля
Факс отеля
Список комнат
Название комнаты
Описание типа комнаты
Налоги отеля
Общая цена комнаты
Тип комнаты
Тип кроватей
Тип питания
Подтип комнаты
Дата заезда
Дата выезда
Список гостей
Ссылка на идентификатор гостя из списка Persons
Оплата возможна только в отеле
Точная информация о возможности резервирования
доступна только по запросу в отель
Данное предложение является невозмещаемым
Название вендора
ID резевации в системе вендора
Список правил отмены данной комнаты
Величина штрафа при отмене
Дата начала действия данного правила
Page 11
<UTCDateTo>
<IsPossible>
date
bool
Дата окончания действия данного правила
Определяет, возможна ли отмена или нет
ReservationSummary
Возвращается в ответ на GetReservationList
<ReservationId>
<ReservationDate>
<ReservationStatus>
<ReservationNumber>
<CheckIn>
<CheckOut>
<ReservationAmount>
<CommissionPercent>
<CommissionAmount>
<Currency>
guid
dateTime
enum
string
dateTime
dateTime
decimal
decimal
decimal
enum
oktogo.ru Xml API бронирования отелей
Идентификатор резервации
Дата создания резервации
Статус резервации
Номер резервации
Дата заезда
Дата выезда
Сумма резервации
Процент комиссии
Сумма комиссии
Валюта резервации
Page 12
HotelInfo
Возвращается при получении информации по отелям
<HotelId>
<StarRating>
<YearOpened>
<YearRenovated>
<CheckInTime>
<CheckOutTime>
<Url>
<Email>
<Phone>
<Fax>
<HotelContentUrl>
<OktogoRating>
<IsCityCenter>
<Name>
<Description>
<CategoryId>
<Location>
<DestinationId>
<ZipCode>
<Latitude>
<Longitude>
<CityName>
<CityCode>
<Addresses>
<Address>
<Images>
<Image>
<Url>
<PreviewURL>
int
int
int
int
string
string
string
string
string
string
string
int
bool
string
string
int
Идентификатор отеля
Рейтинг отеля (количество звезд)
Год открытия отеля
Год реконструкции отеля
Время заезда в отель
Время выезда из отеля
Адрес отеля в сети
Электронный адрес отеля
Телефон отеля
Факс отеля
Страница отеля на сайте oktogo.ru
Рейтинг отеля на oktogo.ru
Находится ли отель в центре города
Имя отеля
Описание отеля
ID категории отеля
int
string
float
float
string
string
array
string
array
object
string
string
Идентификатор локации
Почтовый индекс
Широта
Долгота
Город
Код города
Список адресов отеля
Адрес
Фотографии отеля
<IsDefault>
<ImageCategory>
<Attractions>
<Attraction>
<AttractionId>
<Name>
<ShortName>
bool
byte
array
object
int
string
string
Адрес фото на сайте c.ok2go.ru
Адрес фото для предварительного просмотра на сайте
c.ok2go.ru
Является ли данное фото основным для отеля
Категория фото (на данный момент всегда = 1)
Список удобств
Идентификатор
Имя удобства
Короткое имя
oktogo.ru Xml API бронирования отелей
Page 13
Основные справочники
DestinationType
Тип местности
Country
Страна
StateOrProvinceOrRegion
Island
Штат, провинция, область и т.п.
Остров
Город
Аэропорт
Ж\д вокзал
Point of interest
Район/округ города
Страна
City
Airport
RailwayStation
POI
CityDistrict
Country
Status
Статус резервации
Unknown
Pending
Confirmed
Cancelled
Rejected
Error
CancelPending
Неизвестно - по каким-то причинам невозможно получить корректный
статус от поставщика. Запрос статуса необходимо повторить позже.
Ожидание (On Request) – ожидание подтверждения бронирования.
Подтверждено
Отменено или было отклонено отелем.
Отклонено (On Request) – бронирование было отклонено отелем.
Ошибка
В процессе отмены
MealType
Возможные типы питания
RO
Без питания
AI
Все включено
BB
Завтрак
HB
Завтрак и обед/завтрак и ужин
FB
Завтрак, обед, ужин
DI
Питание Deluxe
SC
Самообслуживание
RB
Комната с завтраком
CB
Континентальный завтрак
HBP
Завтрак и обед/завтрак и ужин + напитки местного производства
UAI
Улучшенный вариант "Все включено"
FBP
Завтрак, обед, ужин + напитки местного производства
Lunch
Обед
oktogo.ru Xml API бронирования отелей
Page 14
Dinner
Ужин
BR
Бранч
AC
A la carte
oktogo.ru Xml API бронирования отелей
Page 15
RoomType
Возможные типы комнат
RunOfHouse
Deluxe
Executive
Luxury
Premium
Standard
Studio
Suite
JuniorSuite
Apartment
DeluxeSuite
ExecutiveSuite
Bungalow
Villa
Penthouse
DeluxeStudio
SharedRoom
Tent
StudioSuite
ParlorSuite
FamilyRoom
Superior
SuperiorSuite
SuperiorStudio
PresidentialSuite
Chalet
DeluxeFamily
DeluxeVilla
FamilySuite
LuxurySuite
LuxuryVilla
SuperiorVilla
Cabin
DeluxeBungalow
eluxeExecutive
Lodge
EconomyBudget
SuperiorBungalow
RoyalSuite
LuxuryStudio
GrandRoom
GrandSuite
GrandDeluxe
Duplex
Comfort
oktogo.ru Xml API бронирования отелей
Page 16
BedType
Возможные типы кроватей
RunOfHouse
Double
Futon
King
Murphy
Queen
Sofa
Tatami
Twin
Single
Bunk
QueenBedAndSingleBed
DoubleBedAndTwoSingleBeds
TwoSingleBedsAndTwoBunkBeds
TwoSingleBeds
ThreeSingleBeds
KingBedAndSingleBed
TwoKingBeds
KingBedAndDoubleBed
KingBedAndTwoQueenBedsAndDoubleBed
DoubleBedAndTwinBed
QueenBedAndDoubleBed
DoubleBedWithSofaBed
KingBedAndTwoDoubleBeds
TwoQueenBedsAndDoubleBed
TwoDoubleBeds
TwoQueenBeds
ThreeQueenBeds
OneDoubleBedAndOneSingleBed
OneKingBedAndTwoTwinBeds
OneKingBedOrTwoDoubleBeds
OneQueenBedAndTwoDoubleBeds
OneQueenBedAndTwoTwinBeds
OneKingBedAndOneQueenBed
OneKingBedOrOneQueenBed
OneQueenBedAndTwoSingleBeds
OneQueenBedWithSofaBed
OneDoubleBedOrOneTwinBed
ThreeDoubleBeds
FourDoubleBeds
ThreeTwinBeds
FourTwinBeds
ThreeKingBeds
FourKingBeds
FourQueenBeds
TwoTwinBeds
FourSingleBeds
FullBed
TwoFullBeds
TwoSofaBeds
ThreeSofaBeds
TrundleBed
oktogo.ru Xml API бронирования отелей
Page 17
Hotel CategoryId
Категории отеля
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Hotel
Apartment Hotel
Apartment/Condominium
Hostel
Motel
Bed And Breakfast
Boatel
Bungalow
Campsite
Castle/Châteaux/Fortress
Cottage
Farmhouse
Guesthouse
House
Huts
Inn
Lodge
Pension
Pousada
Resort
Serviced Apartments
Tented Camp
Timeshare
Townhouse
Villa
Mini-hotel
oktogo.ru Xml API бронирования отелей
Page 18
Примеры запросов
Поиск по населенному пункту
Запрос
<HotelRequest>
<AffiliateId>oktogo</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>GetAvailabilityByDestinations</HotelRequestMethod>
<HotelSearchParameters>
<CheckInDate>2012-05-07</CheckInDate>
<CheckOutDate>2012-05-09</CheckOutDate>
<DestinationId>186</DestinationId>
<Currency>RUB</Currency>
<Rooms>
<RoomInfo>
<Guests>
<Guest>
<Age>30</Age>
<IsChild>false</IsChild>
</Guest>
</Guests>
</RoomInfo>
</Rooms>
</HotelSearchParameters>
</HotelRequest>
Ответ
<HotelResponse>
<Currency>RUB</Currency>
<Products>
<HotelRS>
<HotelId>11947</HotelId>
<StarRating>0</StarRating>
<CheckIn>2012-05-07T00:00:00</CheckIn>
<CheckOut>2012-05-09T00:00:00</CheckOut>
<PriceFrom>9410</PriceFrom>
<DestinationId>12196</DestinationId>
<Rooms />
</HotelRS>
<HotelRS>
<HotelId>96987</HotelId>
<StarRating>0</StarRating>
<CheckIn>2012-05-07T00:00:00</CheckIn>
<CheckOut>2012-05-09T00:00:00</CheckOut>
<PriceFrom>1470</PriceFrom>
<DestinationId>12196</DestinationId>
<Rooms>
<Room>
<RoomType>RunOfHouse</RoomType>
<GuestAges>
<Age>19</Age>
</GuestAges>
<Rates>
<Rate>
<RateId>73a69eb3-ee4b-4bda-86db-d34fef69c63b</RateId>
<Vendor>Oktogo</Vendor>
<RoomName>Место в 4-местном</RoomName>
<RoomDescription>Standard</RoomDescription>
<Taxes>0</Taxes>
oktogo.ru Xml API бронирования отелей
Page 19
<TotalPrice>1470</TotalPrice>
<BedType>Single</BedType>
<MealType>BB</MealType>
<RoomSubType>RunOfHouse</RoomSubType>
<IsPostPay>false</IsPostPay>
<IsOnRequest>false</IsOnRequest>
<IsNonRefundable>false</IsNonRefundable>
<IsNonSmoking>false</IsNonSmoking>
<IsCommissionable>true</IsCommissionable>
<CancellationPolicyRules>
<CancellationRule>
<Amount>740</Amount>
<UTCDateFrom>2012-05-03T20:00:00</UTCDateFrom>
<UTCDateTo>2012-05-06T20:00:00</UTCDateTo>
<IsPossible>true</IsPossible>
</CancellationRule>
</CancellationPolicyRules>
</Rate>
</Rates>
</Room>
<Room>
<RoomType>RunOfHouse</RoomType>
<GuestAges>
<Age>19</Age>
</GuestAges>
<Rates>
<Rate>
<RateId>99661935-d038-46ab-8b55-b5c520128398</RateId>
<Vendor>Oktogo</Vendor>
<RoomName>Standard Single Room</RoomName>
<RoomDescription>EconomyBudget</RoomDescription>
<Taxes>0</Taxes>
<TotalPrice>3790</TotalPrice>
<BedType>Double</BedType>
<MealType>BB</MealType>
<RoomSubType>RunOfHouse</RoomSubType>
<IsPostPay>false</IsPostPay>
<IsOnRequest>false</IsOnRequest>
<IsNonRefundable>false</IsNonRefundable>
<IsNonSmoking>false</IsNonSmoking>
<IsCommissionable>true</IsCommissionable>
<CancellationPolicyRules>
<CancellationRule>
<Amount>1890</Amount>
<UTCDateFrom>2012-05-03T20:00:00</UTCDateFrom>
<UTCDateTo>2012-05-06T20:00:00</UTCDateTo>
<IsPossible>true</IsPossible>
</CancellationRule>
</CancellationPolicyRules>
</Rate>
</Rates>
</Room>
</Rooms>
</HotelRS>
</Products>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 20
Поиск по отелю
Запрос
<HotelRequest>
<AffiliateId>oktogo</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>GetAvailabilityByHotels</HotelRequestMethod>
<HotelSearchParameters>
<HotelId>2051</HotelId>
<CheckInDate>2012-05-07</CheckInDate>
<CheckOutDate>2012-05-09</CheckOutDate>
<Currency>RUB</Currency>
<Rooms>
<RoomInfo>
<Guests>
<Guest>
<Age>30</Age>
<IsChild>false</IsChild>
</Guest>
</Guests>
</RoomInfo>
</Rooms>
</HotelSearchParameters>
</HotelRequest>
Ответ
<HotelResponse>
<Currency>RUB</Currency>
<AvailabilityCode>6c48e4b0-3512-4023-b8e7-4192710d3e01</AvailabilityCode>
<Products>
<HotelRS>
<HotelId>2051</HotelId>
<StarRating>3</StarRating>
<CheckIn>2012-05-07T00:00:00</CheckIn>
<CheckOut>2012-05-09T00:00:00</CheckOut>
<PriceFrom>7190</PriceFrom>
<DestinationId>12153</DestinationId>
<Rooms>
<Room>
<RoomType>RunOfHouse</RoomType>
<GuestAges>
<Age>19</Age>
</GuestAges>
<Rates>
<Rate>
<RateId>09e258da-d0ff-4e64-8cc6-68a996167814</RateId>
<Vendor>Oktogo</Vendor>
<RoomName>Стандартный номер</RoomName>
<RoomDescription>Standard</RoomDescription>
<Taxes>1043.39</Taxes>
<TotalPrice>7190</TotalPrice>
<BedType>Double</BedType>
<MealType>RO</MealType>
<RoomSubType>RunOfHouse</RoomSubType>
<IsPostPay>false</IsPostPay>
<IsOnRequest>false</IsOnRequest>
<IsNonRefundable>false</IsNonRefundable>
<IsNonSmoking>false</IsNonSmoking>
<IsCommissionable>true</IsCommissionable>
<CancellationPolicyRules>
<CancellationRule>
<Amount>3600</Amount>
oktogo.ru Xml API бронирования отелей
Page 21
<UTCDateFrom>2012-05-05T20:00:00</UTCDateFrom>
<UTCDateTo>2012-05-06T20:00:00</UTCDateTo>
<IsPossible>true</IsPossible>
</CancellationRule>
</CancellationPolicyRules>
<AvailableCount>20</AvailableCount>
</Rate>
</Rates>
</Room>
<Room>
<RoomType>RunOfHouse</RoomType>
<GuestAges>
<Age>19</Age>
</GuestAges>
<Rates>
<Rate>
<RateId>8b0c9b0c-8331-4a03-b1b8-6dc19b4b1682</RateId>
<Vendor>Oktogo</Vendor>
<RoomName>Бизнес</RoomName>
<RoomDescription>Comfort</RoomDescription>
<Taxes>1180.68</Taxes>
<TotalPrice>8130</TotalPrice>
<BedType>Double</BedType>
<MealType>RO</MealType>
<RoomSubType>RunOfHouse</RoomSubType>
<IsPostPay>false</IsPostPay>
<IsOnRequest>false</IsOnRequest>
<IsNonRefundable>false</IsNonRefundable>
<IsNonSmoking>false</IsNonSmoking>
<IsCommissionable>true</IsCommissionable>
<CancellationPolicyRules>
<CancellationRule>
<Amount>4070</Amount>
<UTCDateFrom>2012-05-05T20:00:00</UTCDateFrom>
<UTCDateTo>2012-05-06T20:00:00</UTCDateTo>
<IsPossible>true</IsPossible>
</CancellationRule>
</CancellationPolicyRules>
<AvailableCount>20</AvailableCount>
</Rate>
</Rates>
</Room>
</Rooms>
</HotelRS>
</Products>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 22
Уточнение данных рейта для Hotelbeds
Запрос
<HotelRequest>
<AffiliateId>oktogo</AffiliateId>
<Password>123</Password>
<HotelRequestMethod> GetHotelbedsFinalRate</HotelRequestMethod>
<ReservationParameters>
<HotelId>32165</HotelId>
<AvailabilityCode>6c48e4b0-3512-4023-b8e7-4192710d3e01</AvailabilityCode>
<Currency>RUB</Currency>
<Rates>
<Rate>
<RateId>09e258da-d0ff-4e64-8cc6-68a996167814</RateId>
</Rate>
</Rates>
</ReservationParameters>
</HotelRequest>
Ответ
<HotelResponse>
<Currency>RUB</Currency>
<AvailabilityCode>bbcc94ee-f84b-44a5-9f5e-bea2e398d332</AvailabilityCode>
<Products>
<HotelRS>
<HotelId>32165</HotelId>
<StarRating>3</StarRating>
<CheckIn>2012-08-07T00:00:00</CheckIn>
<CheckOut>2012-08-09T00:00:00</CheckOut>
<PriceFrom>13790</PriceFrom>
<DestinationId>7896</DestinationId>
<Rooms>
<Room>
<RoomType>RunOfHouse</RoomType>
<GuestAges>
<Age>30</Age>
</GuestAges>
<Rates>
<Rate>
<RateId>2cd0b994-1d43-46c5-b5fa-1049ddb1b039</RateId>
<Vendor>Hotelbeds</Vendor>
<RoomName>SINGLE STANDARD</RoomName>
<RoomDescription>SINGLE STANDARD</RoomDescription>
<Taxes>0</Taxes>
<TotalPrice>8880</TotalPrice>
<BedType>Single</BedType>
<MealType>RO</MealType>
<RoomSubType>ParkView</RoomSubType>
<IsPostPay>false</IsPostPay>
<IsOnRequest>false</IsOnRequest>
<IsNonRefundable>false</IsNonRefundable>
<IsNonSmoking>false</IsNonSmoking>
<IsCommissionable>false</IsCommissionable>
<CancellationPolicyRules>
<CancellationRule>
<Amount>8880</Amount>
<UTCDateFrom>2012-07-10T23:00:00</UTCDateFrom>
<UTCDateTo>2012-08-06T23:00:00</UTCDateTo>
<IsPossible>true</IsPossible>
</CancellationRule>
</CancellationPolicyRules>
<AvailableCount>20</AvailableCount>
oktogo.ru Xml API бронирования отелей
Page 23
</Rate>
</Rates>
</Room>
</Rooms>
</HotelRS>
</Products>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 24
Резервация
Запрос
<HotelRequest>
<AffiliateId>test</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>MakeHotelReservation</HotelRequestMethod>
<ReservationParameters>
<Persons>
<ReservationPerson>
<ReservationPersonID>b307cf18-b88e-4703-9a08-b762601d5f22</ReservationPersonID>
<FirstName>Tom</FirstName>
<LastName>Johnes</LastName>
<Age>32</Age>
<CitizenCountryCode>ru</CitizenCountryCode>
</ReservationPerson>
<ReservationPerson>
<ReservationPersonID>68cb4bd3-daff-4305-a506-82f6a8de0f6f</ReservationPersonID>
<FirstName>Bill</FirstName>
<LastName>Doe</LastName>
<Age>32</Age>
<CitizenCountryCode>ru</CitizenCountryCode>
</ReservationPerson>
</Persons>
<HotelId>35716</HotelId>
<AvailabilityCode>2a0f896a-b03a-4352-beb7-10174243e4f7</AvailabilityCode>
<Currency>RUB</Currency>
<ClientInfo>
<FirstName>Tom</FirstName>
<LastName>Johnes</LastName>
<Email>mail@mail.mail</Email>
<Phone>+1 1343545654</Phone>
</ClientInfo>
<Rates>
<RateInfo>
<RateId>574cf29b-ed1c-4fbf-8b1d-748d12f7b701</RateId>
<Guests>
<ReservationPersonId>68cb4bd3-daff-4305-a506-82f6a8de0f6f</ReservationPersonId>
<ReservationPersonId>b307cf18-b88e-4703-9a08-b762601d5f22</ReservationPersonId>
</Guests>
</RateInfo>
</Rates>
</ReservationParameters>
</HotelRequest>
Ответ
<HotelResponse>
<Reservation>
<ReservationId>21e3ba59-7678-4d0d-9779-71ddcf5a599f</ReservationId>
<ReservationDate>2012-09-12T14:16:01.427</ReservationDate>
<Currency>RUB</Currency>
<TotalPrice>4204.0000</TotalPrice>
<Status>Confirmed</Status>
oktogo.ru Xml API бронирования отелей
Page 25
<Persons>
<ReservationPerson>
<ReservationPersonID>1ab44b48-15a4-486c-bcc2-88989ac3f4db</ReservationPersonID>
<FirstName>Bill</FirstName>
<LastName>Doe</LastName>
<Gender />
<Age>32</Age>
<CitizenCountryCode>ru</CitizenCountryCode>
</ReservationPerson>
<ReservationPerson>
<ReservationPersonID>18be11d7-4c58-4a70-a69f-d24f51d40346</ReservationPersonID>
<FirstName>Tom</FirstName>
<LastName>Johnes</LastName>
<Gender />
<Age>32</Age>
<CitizenCountryCode>ru</CitizenCountryCode>
</ReservationPerson>
</Persons>
<ClientInfo>
<FirstName>Tom</FirstName>
<LastName>Johnes</LastName>
<Email>mail@mail.mail</Email>
<Phone>+1 1343545654</Phone>
</ClientInfo>
<ReservationHotel>
<HotelId>35716</HotelId>
<Name>Скай Отель</Name>
<StarRating>2</StarRating>
<DestinationId>1416615</DestinationId>
<Rooms>
<ReservationHotelRoom>
<RoomName>Twin/Double room - Shared bath</RoomName>
<Taxes>0.0000</Taxes>
<TotalPrice>4204.0000</TotalPrice>
<RoomType>Standard</RoomType>
<BedType>RunOfHouse</BedType>
<MealType>BB</MealType>
<CheckIn>2012-09-25T00:00:00</CheckIn>
<CheckOut>2012-09-27T00:00:00</CheckOut>
<Guests />
<IsPostPay>false</IsPostPay>
<IsOnRequest>false</IsOnRequest>
<IsNonRefundable>false</IsNonRefundable>
<CancellationPolicyRules>
<CancellationRule>
<Amount>2102.0000</Amount>
<UTCDateFrom>2012-09-23T08:00:00</UTCDateFrom>
<UTCDateTo>2012-09-24T20:00:00</UTCDateTo>
<IsPossible>true</IsPossible>
</CancellationRule>
</CancellationPolicyRules>
<Vendor>Sunhotels</Vendor>
<VendorReservationId>SH2529637</VendorReservationId>
oktogo.ru Xml API бронирования отелей
Page 26
</ReservationHotelRoom>
</Rooms>
<Phone>7 812 600 21 20</Phone>
<Fax>7 812 600 21 20</Fax>
</ReservationHotel>
<DefaultCheckinTime>заселение после 14:00</DefaultCheckinTime>
<DefaultCheckoutTime>отъезд до 12:00</DefaultCheckoutTime>
<OktogoReservationNumber>647755723</OktogoReservationNumber>
</Reservation>
<Currency>RUB</Currency>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 27
Добавление в корзину
Запрос
<HotelRequest>
<AffiliateId>oktogo</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>AddRoomsToShoppingCart</HotelRequestMethod>
<ReservationParameters>
<HotelId>2051</HotelId>
<AvailabilityCode>dbf2c4a1-86b5-474f-8792-4493efea0ff7</AvailabilityCode>
<Currency>RUB</Currency>
<Rates>
<RateInfo>
<RateId>3b309e31-034f-4b2f-82aa-d37ad88262b4</RateId>
</RateInfo>
</Rates>
</ReservationParameters>
</HotelRequest>
Ответ
<HotelResponse>
<Currency>RUB</Currency>
<ShoppingCartId>4e9df2aa-84db-4b7e-a3e6-89ec127df19c</ShoppingCartId>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 28
Отмена резервации:
Запрос
<HotelRequest>
<AffiliateId>oktogo</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>CancelReservation</HotelRequestMethod>
<ReservationId>bb399c3c-57ef-4b1c-9981-8ba017c6cb37</ReservationId>
</HotelRequest>
Ответ
<HotelResponse>
<Reservation>
<ReservationId>bb399c3c-57ef-4b1c-9981-8ba017c6cb37</ReservationId>
<ReservationDate>2012-05-02T14:45:30.383</ReservationDate>
<Currency>RUB</Currency>
<TotalPrice>6840.0000</TotalPrice>
<Status>Cancelled</Status>
<Persons>
<ReservationPerson>
<ReservationPersonID>90d9674c-f2e7-4231-9853-9923e99365b0</ReservationPersonID>
<FirstName>Ivan</FirstName>
<LastName>Ivanoff</LastName>
<Gender>
</Gender>
<Age>30</Age>
<CitizenCountryCode>ru</CitizenCountryCode>
</ReservationPerson>
</Persons>
<ClientInfo>
<FirstName>Ivan</FirstName>
<LastName>Ivanoff</LastName>
<Email>ivan@ivan.ru</Email>
<Phone>1234567</Phone>
</ClientInfo>
<ReservationHotel>
<HotelId>2051</HotelId>
<Name>Измайлово Гамма-Дельта</Name>
<StarRating>3</StarRating>
<DestinationId>12153</DestinationId>
<Rooms>
<ReservationHotelRoom>
<RoomName>Стандартный номер</RoomName>
<Taxes>1043.3898</Taxes>
<TotalPrice>6840.0000</TotalPrice>
<RoomType>Standard</RoomType>
<BedType>Double</BedType>
<MealType>RO</MealType>
<RoomSubType>Double/ Twin</RoomSubType>
<CheckIn>2012-05-07T00:00:00</CheckIn>
<CheckOut>2012-05-09T00:00:00</CheckOut>
<Guests>
<GuestId>90d9674c-f2e7-4231-9853-9923e99365b0</GuestId>
</Guests>
<IsPostPay>false</IsPostPay>
<IsOnRequest>false</IsOnRequest>
<IsNonRefundable>false</IsNonRefundable>
<CancellationPolicyRules>
<CancellationRule>
<Amount>3600.0000</Amount>
<UTCDateFrom>2012-05-05T20:00:00</UTCDateFrom>
<UTCDateTo>2012-05-06T20:00:00</UTCDateTo>
<IsPossible>true</IsPossible>
oktogo.ru Xml API бронирования отелей
Page 29
</CancellationRule>
</CancellationPolicyRules>
</ReservationHotelRoom>
</Rooms>
</ReservationHotel>
</Reservation>
<Currency>EUR</Currency>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 30
Получение информации о резервации:
Запрос
<HotelRequest>
<AffiliateId>test</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>GetHotelReservation</HotelRequestMethod>
<ReservationId>21e3ba59-7678-4d0d-9779-71ddcf5a599f</ReservationId>
</HotelRequest>
Ответ
<HotelResponse>
<Reservation>
<ReservationId>21e3ba59-7678-4d0d-9779-71ddcf5a599f</ReservationId>
<ReservationDate>2012-09-12T14:16:01.427</ReservationDate>
<Currency>RUB</Currency>
<TotalPrice>4204.0000</TotalPrice>
<Status>Confirmed</Status>
<Persons>
<ReservationPerson>
<ReservationPersonID>1ab44b48-15a4-486c-bcc2-88989ac3f4db</ReservationPersonID>
<FirstName>Bill</FirstName>
<LastName>Doe</LastName>
<Gender />
<Age>32</Age>
<CitizenCountryCode>ru</CitizenCountryCode>
</ReservationPerson>
<ReservationPerson>
<ReservationPersonID>18be11d7-4c58-4a70-a69f-d24f51d40346</ReservationPersonID>
<FirstName>Tom</FirstName>
<LastName>Johnes</LastName>
<Gender />
<Age>32</Age>
<CitizenCountryCode>ru</CitizenCountryCode>
</ReservationPerson>
</Persons>
<ClientInfo>
<FirstName>Tom</FirstName>
<LastName>Johnes</LastName>
<Email>mail@mail.mail</Email>
<Phone>+1 1343545654</Phone>
</ClientInfo>
<ReservationHotel>
<HotelId>35716</HotelId>
<Name>Скай Отель</Name>
<StarRating>2</StarRating>
<DestinationId>1416615</DestinationId>
<Rooms>
<ReservationHotelRoom>
<RoomName>Twin/Double room - Shared bath</RoomName>
<Taxes>0.0000</Taxes>
<TotalPrice>4204.0000</TotalPrice>
oktogo.ru Xml API бронирования отелей
Page 31
<RoomType>Standard</RoomType>
<BedType>RunOfHouse</BedType>
<MealType>BB</MealType>
<CheckIn>2012-09-25T00:00:00</CheckIn>
<CheckOut>2012-09-27T00:00:00</CheckOut>
<Guests>
<GuestId>1ab44b48-15a4-486c-bcc2-88989ac3f4db</GuestId>
<GuestId>18be11d7-4c58-4a70-a69f-d24f51d40346</GuestId>
</Guests>
<IsPostPay>false</IsPostPay>
<IsOnRequest>false</IsOnRequest>
<IsNonRefundable>false</IsNonRefundable>
<CancellationPolicyRules>
<CancellationRule>
<Amount>2102.0000</Amount>
<UTCDateFrom>2012-09-23T08:00:00</UTCDateFrom>
<UTCDateTo>2012-09-24T20:00:00</UTCDateTo>
<IsPossible>true</IsPossible>
</CancellationRule>
</CancellationPolicyRules>
<Vendor>Sunhotels</Vendor>
<VendorReservationId>SH2529637</VendorReservationId>
</ReservationHotelRoom>
</Rooms>
<Phone>7 812 600 21 20</Phone>
<Fax>7 812 600 21 20</Fax>
</ReservationHotel>
<DefaultCheckinTime>заселение после 14:00</DefaultCheckinTime>
<DefaultCheckoutTime>отъезд до 12:00</DefaultCheckoutTime>
<OktogoReservationNumber>647755723</OktogoReservationNumber>
</Reservation>
<Currency>EUR</Currency>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 32
Получение списка резерваций:
Запрос
<HotelRequest>
<AffiliateId>oktogo</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>GetReservationList</HotelRequestMethod>
<ReservationListFilter>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<ReservationNumber>0</ReservationNumber>
</ReservationListFilter>
</HotelRequest>
Ответ
<HotelResponse>
<Currency>EUR</Currency>
<Reservations>
<Reservations>
<ReservationSummary>
<ReservationId>2cba405f-1c48-4635-9ccf-1bca7f92d090</ReservationId>
<ReservationDate>2011-11-22T18:32:53.877</ReservationDate>
<ReservationStatus>Confirmed</ReservationStatus>
<ReservationNumber>737281786</ReservationNumber>
<CheckIn>2011-12-15T00:00:00</CheckIn>
<CheckOut>2011-12-16T00:00:00</CheckOut>
<ReservationAmount>3130.00</ReservationAmount>
<CommissionPercent>6.50</CommissionPercent>
<CommissionAmount>203.4500</CommissionAmount>
<Currency>RUB</Currency>
</ReservationSummary>
<ReservationSummary>
<ReservationId>0475ef20-d04a-4613-bb69-fb800294e951</ReservationId>
<ReservationDate>2011-11-22T18:34:52.653</ReservationDate>
<ReservationStatus>Cancelled</ReservationStatus>
<ReservationNumber>792701282</ReservationNumber>
<CheckIn>2011-12-22T00:00:00</CheckIn>
<CheckOut>2011-12-23T00:00:00</CheckOut>
<ReservationAmount>7570.00</ReservationAmount>
<CommissionPercent>6.50</CommissionPercent>
<CommissionAmount>492.0500</CommissionAmount>
<Currency>RUB</Currency>
</ReservationSummary>
</Reservations>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<TotalReservations>369</TotalReservations>
</Reservations>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 33
Получение списка стран:
Запрос
<HotelRequest>
<AffiliateId>oktogo</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>GetCountryList</HotelRequestMethod>
</HotelRequest>
Ответ
<HotelResponse>
<Currency>EUR</Currency>
<Destinations>
<Destination>
<DestinationId>198</DestinationId>
<Name>Австралия</Name>
<DestinationType>Country</DestinationType>
</Destination>
<Destination>
<DestinationId>153</DestinationId>
<Name>Австрия</Name>
<DestinationType>Country</DestinationType>
</Destination>
<Destination>
<DestinationId>67</DestinationId>
<Name>Азербайджан</Name>
<DestinationType>Country</DestinationType>
</Destination>
</Destinations>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 34
Получение списка городов:
Запрос
<HotelRequest>
<AffiliateId>oktogo</AffiliateId>
<Password>123</Password>
<HotelRequestMethod>GetCityList</HotelRequestMethod>
<Destination>
<DestinationId>186</DestinationId>
<DestinationType>Country</DestinationType>
</Destination>
</HotelRequest>
Ответ
<HotelResponse>
<Currency>EUR</Currency>
<Destinations>
<Destination>
<DestinationId>12196</DestinationId>
<Name>Санкт-Петербург</Name>
<DestinationType>City</DestinationType>
</Destination>
<Destination>
<DestinationId>12153</DestinationId>
<Name>Москва</Name>
<DestinationType>City</DestinationType>
</Destination>
<Destination>
<DestinationId>12115</DestinationId>
<Name>Екатеринбург</Name>
<DestinationType>City</DestinationType>
</Destination>
</Destinations>
</HotelResponse>
oktogo.ru Xml API бронирования отелей
Page 35
Общее описание .......................................................................................................................................... 2
Схема работы с oktogo.ru Xml API .............................................................................................................. 2
Описание методов XML API: ....................................................................................................................... 3
HotelRequest............................................................................................................................................. 6
HotelSearchParameters ............................................................................................................................ 7
ReservationParameters ............................................................................................................................. 7
ReservationPerson .................................................................................................................................... 8
ClientInfo ................................................................................................................................................... 8
ReservationListFilter.................................................................................................................................. 8
Destination ................................................................................................................................................ 8
HotelResponse .......................................................................................................................................... 9
HotelRS ...................................................................................................................................................... 9
Rate .........................................................................................................................................................10
Reservation .............................................................................................................................................11
ReservationSummary ..............................................................................................................................12
HotelInfo .................................................................................................................................................13
Основные справочники.............................................................................................................................14
DestinationType ......................................................................................................................................14
Status.......................................................................................................................................................14
MealType.................................................................................................................................................14
RoomType ...............................................................................................................................................16
BedType...................................................................................................................................................17
Hotel CategoryId .....................................................................................................................................18
Примеры запросов ....................................................................................................................................19
Поиск по населенному пункту ..............................................................................................................19
Запрос .................................................................................................................................................19
Ответ ...................................................................................................................................................19
Поиск по отелю ......................................................................................................................................21
Запрос .................................................................................................................................................21
Ответ ...................................................................................................................................................21
Уточнение данных рейта для Hotelbeds ..............................................................................................23
Запрос .................................................................................................................................................23
Ответ ...................................................................................................................................................23
Резервация .............................................................................................................................................25
Запрос .................................................................................................................................................25
oktogo.ru Xml API бронирования отелей
Page 36
Ответ ...................................................................................................................................................25
Добавление в корзину ..........................................................................................................................28
Запрос .................................................................................................................................................28
Ответ ...................................................................................................................................................28
Отмена резервации: ..............................................................................................................................29
Запрос .................................................................................................................................................29
Ответ ...................................................................................................................................................29
Получение информации о резервации: ..............................................................................................31
Запрос .................................................................................................................................................31
Ответ ...................................................................................................................................................31
Получение списка резерваций: ............................................................................................................33
Запрос .................................................................................................................................................33
Ответ ...................................................................................................................................................33
Получение списка стран:.......................................................................................................................34
Запрос .................................................................................................................................................34
Ответ ...................................................................................................................................................34
Получение списка городов: ..................................................................................................................35
Запрос .................................................................................................................................................35
Ответ ...................................................................................................................................................35
oktogo.ru Xml API бронирования отелей
Page 37