wiki.Sletat.ru - Вклад участника [ru]

Подключение туроператоров

2017-02-14T09:26:11Z

Vm: /* SletatRu Provider API v2.0 */

[[Category:Подключение_туроператоров]]
== SletatRu Provider API ==
Актуальная версия документации доступна по ссылке: http://static.sletat.ru/Files/api/SletatRu_Provider_API.pdf

Подключение туроператоров

2017-02-14T09:22:00Z

Vm: /* SletatRu Provider API v1.08 */

[[Category:Подключение_туроператоров]]
== SletatRu Provider API v2.0 ==
Актуальная версия документации доступна по ссылке: http://static.sletat.ru/Files/api/SletatRu_Provider_API.pdf

Подключение туроператоров

2017-02-14T09:21:48Z

Vm: /* SletatRu Provider API v1.08 */

[[Category:Подключение_туроператоров]]
== SletatRu Provider API v1.08 ==
Актуальная версия документации доступна по ссылке: http://static.sletat.ru/Files/api/SletatRu_Provider_API.pdf

Заглавная страница

2016-11-29T14:34:28Z

Vm: /* Подключение туроператоров */

__NOTOC__
== Модули поиска туров ==

[[Лицензия]]

=== [[:Category:Модуль поиска туров 5.0|Модуль поиска туров 5.0]] ===

[[Модуль поиска туров 5.0|Описание модуля]]

[[Создание модуля поиска туров 5.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 5.0|Дополнительные настройки]]

=== [[:Category:Модуль поиска туров 4.0|Модуль поиска туров 4.0]] ===
[[Модуль поиска туров 4.0|Описание модуля]]

[[Создание модуля поиска туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 4.0|Дополнительные настройки]]

=== [[:Category:Модуль горящих туров 4.0|Модуль горящих туров 4.0]] ===

[[Модуль горящих туров 4.0|Описание модуля]]

[[Создание модуля горящих туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля горящих туров 4.0|Дополнительные настройки]]

=== [[:Category:Слайдер 4.0|Слайдер 4.0]] ===

[[Слайдер 4.0|Описание модуля]]

[[Создание Слайдера 4.0|Создание модуля]]

[[Дополнительные настройки Слайдера 4.0|Дополнительные настройки]]

=== [[:Category:Витрина отелей|Витрина отелей]] ===

=== [[:Category:Модуль Вконтакте|Модуль Вконтакте]] ===
[[Модуль Вконтакте|Описание модуля]]

=== [[:Category:Настройка модулей в Личном кабинете|Настройка модулей в Личном кабинете]] ===

[[Настройка уведомлений]]

[[Настройка модулей]]

[[Добавление офисов]]

[[Мастер Умных Ссылок]]

[[Статистика]]

[[Быстрый поиск тура по короткому номеру]]

=== [[:Category:Дополнения к модулям поиска|Дополнения]] ===
[[Блок отзывов об отелях]]

== Шлюзы поиска, расширения и дополнения ==
=== [[:Category:Шлюзы поиска туров|Шлюзы поиска туров]] ===
[[Шлюз поиска туров (xml)]]

[[Шлюз поиска туров (json)]]

[[Шлюз поиска горящих туров (json)]]

=== [[:Category:Расширения и дополнения|Расширения и дополнения]] ===
[[Отельная база (xml)]]

[[Аналитика (json)]]

[[Детальная актуализация (xml)]]

[[Суточный кеш (xml)]]

[[Онлайн-оплата (xml)]]

== Система биллинга: подключение и настройка ==
=== [[:Category:Система биллинга|Система биллинга]] ===
[[Начало работы]]

[[Базовые настройки]]

[[Процесс оплаты]]

[[Список заказов]]

[[Ручное создание тура]]

[[Расширенные настройки]]

[[Дизайнер документов]]

=== [[:Category:Подключение платежных провайдеров|Подключение платежных провайдеров]] ===

[[Банк «Русский стандарт» — интеграция]]

[[«AquiroPay» — интеграция]]

[[«PayOnline» — интеграция]]

[[«Uniteller» — интеграция]]

[[«Payture» — интеграция]]

[[«Сбербанк» — интеграция]]

== Подключение туроператоров ==

=== [[:Category:Подключение_туроператоров|Подключение туроператоров]] ===

[[Подключение_туроператоров]]

Заглавная страница

2016-11-29T14:33:41Z

Vm: /* Подключение туроператоров */

Заглавная страница

2016-11-29T14:32:11Z

Vm: /* Подключение туроператоров */

Подключение туроператоров

2016-11-29T14:30:10Z

Vm: Содержимое страницы заменено на «Category:Подключение_туроператоров == SletatRu Provider API v1.08 == Актуальная версия…»

Способы подключения туроператоров

2016-02-16T13:28:29Z

Vm: /* Парсинг поисковой формы */

[[Category:Подключение_туроператоров]]
== Парсинг поисковой формы ==

'''Этапы подключения данным способом:'''
* Туроператором предоставляется ссылка на онлайн (форму поиска)
* С нашей стороны производится подключение.
* После завершения работ по подключению проводится линковка справочников (отелей, курортов, типов питания и т.д.)

'''Примеры самых распространенных поисковых форм:'''
Мегатек - http://i.imgur.com/lVvH54g.png
Самософт - http://i.imgur.com/UHz9yNr.png

== Подключение по нашему API ==

В данном случае, туроператору высылается документация на основе которой ТО реализует сервис, который мы в итоге и подключаем.
Русская версия документации:
http://wiki.sletat.ru/w/%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5_%D1%82%D1%83%D1%80%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%BE%D0%B2
English version:
http://wiki.sletat.ru/w/Sletat_Ru_Provider_API
После написания туроператором сервиса, он также предоставляет нам ссылку (или ссылки) и мы проводим тестирование на предмет корректной работы. Сервис должен строго соответствовать нашей документации. Далее идет подключение и линковка.

== Подключение через какой-либо шлюз ТО. ==

Производится при наличии такового у туроператора. При данном способе подключения мы сначала проводим оценку возможности подключения указанного шлюза.
Если шлюз подходит, то в обычном режиме происходит подключение и линковка.

== Подключение через стандартные шлюзы самых распространенных систем автоматизации Самософт и Мегатек. ==

Шлюз Мегатек. (применимо только к тем ТО, которые его используют).
Шлюз Мегатек - это набор сервисов, который приобретается туроператором. У большинства ТО, которые использует поисковую форму Мегатек, т.е. Мастер Вэб - он есть.

Если принимается решение переключать или подключать туроператора через Мегатековский шлюз, то им нужно сообщить список сервисов, которые нам потребуются в обязательном порядке:
Поисковый сервис
Сервис по загрузке поисковых фильтров
Сервис по работе с курсами валют

Шлюз Самософта. (применимо только к тем ТО, которые его используют).
Точно также, ТО предоставляет ссылку и документации (при необходимости) и мы начинаем работы по подключению.

Способы подключения туроператоров

2016-02-16T13:15:51Z

Vm: /* Парсинг поисковой формы */

[[Category:Подключение_туроператоров]]
== Парсинг поисковой формы ==

'''Этапы подключения данным способом:'''
* Туроператором предоставляется ссылка на онлайн (форму поиска)
* С нашей стороны производится подключение. После подключения происходит линковка справочников (отелей, курортов, типов питания и т.д. с нашими)
Примеры самых распространенных поисковых форм:

Мегатек - http://i.imgur.com/lVvH54g.png
Самософт - http://i.imgur.com/UHz9yNr.png

== Подключение по нашему API ==

В данном случае, туроператору высылается документация на основе которой ТО реализует сервис, который мы в итоге и подключаем.
Русская версия документации:
http://wiki.sletat.ru/w/%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5_%D1%82%D1%83%D1%80%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%BE%D0%B2
English version:
http://wiki.sletat.ru/w/Sletat_Ru_Provider_API
После написания туроператором сервиса, он также предоставляет нам ссылку (или ссылки) и мы проводим тестирование на предмет корректной работы. Сервис должен строго соответствовать нашей документации. Далее идет подключение и линковка.

== Подключение через какой-либо шлюз ТО. ==

Производится при наличии такового у туроператора. При данном способе подключения мы сначала проводим оценку возможности подключения указанного шлюза.
Если шлюз подходит, то в обычном режиме происходит подключение и линковка.

== Подключение через стандартные шлюзы самых распространенных систем автоматизации Самософт и Мегатек. ==

Шлюз Мегатек. (применимо только к тем ТО, которые его используют).
Шлюз Мегатек - это набор сервисов, который приобретается туроператором. У большинства ТО, которые использует поисковую форму Мегатек, т.е. Мастер Вэб - он есть.

Если принимается решение переключать или подключать туроператора через Мегатековский шлюз, то им нужно сообщить список сервисов, которые нам потребуются в обязательном порядке:
Поисковый сервис
Сервис по загрузке поисковых фильтров
Сервис по работе с курсами валют

Шлюз Самософта. (применимо только к тем ТО, которые его используют).
Точно также, ТО предоставляет ссылку и документации (при необходимости) и мы начинаем работы по подключению.

Способы подключения туроператоров

2016-02-16T13:13:37Z

Vm: Новая страница: «Category:Подключение_туроператоров == Парсинг поисковой формы == * Туроператором предоста…»

[[Category:Подключение_туроператоров]]
== Парсинг поисковой формы ==

* Туроператором предоставляется ссылка на онлайн (форму поиска)
* С нашей стороны производится подключение. После подключения происходит линковка справочников (отелей, курортов, типов питания и т.д. с нашими)
Примеры самых распространенных поисковых форм:

Мегатек - http://i.imgur.com/lVvH54g.png
Самософт - http://i.imgur.com/UHz9yNr.png

== Подключение по нашему API ==

В данном случае, туроператору высылается документация на основе которой ТО реализует сервис, который мы в итоге и подключаем.
Русская версия документации:
http://wiki.sletat.ru/w/%D0%9F%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5_%D1%82%D1%83%D1%80%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%BE%D0%B2
English version:
http://wiki.sletat.ru/w/Sletat_Ru_Provider_API
После написания туроператором сервиса, он также предоставляет нам ссылку (или ссылки) и мы проводим тестирование на предмет корректной работы. Сервис должен строго соответствовать нашей документации. Далее идет подключение и линковка.

== Подключение через какой-либо шлюз ТО. ==

Производится при наличии такового у туроператора. При данном способе подключения мы сначала проводим оценку возможности подключения указанного шлюза.
Если шлюз подходит, то в обычном режиме происходит подключение и линковка.

== Подключение через стандартные шлюзы самых распространенных систем автоматизации Самософт и Мегатек. ==

Шлюз Мегатек. (применимо только к тем ТО, которые его используют).
Шлюз Мегатек - это набор сервисов, который приобретается туроператором. У большинства ТО, которые использует поисковую форму Мегатек, т.е. Мастер Вэб - он есть.

Если принимается решение переключать или подключать туроператора через Мегатековский шлюз, то им нужно сообщить список сервисов, которые нам потребуются в обязательном порядке:
Поисковый сервис
Сервис по загрузке поисковых фильтров
Сервис по работе с курсами валют

Шлюз Самософта. (применимо только к тем ТО, которые его используют).
Точно также, ТО предоставляет ссылку и документации (при необходимости) и мы начинаем работы по подключению.

Sletat Ru Provider API

2016-02-02T09:53:59Z

Vm: /* Service Description */

Заглавная страница

2016-01-29T08:45:54Z

Vm: /* Подключение туроператоров */

__NOTOC__
== Модули поиска туров ==

[[Лицензия]]

=== [[:Category:Модуль поиска туров 5.0|Модуль поиска туров 5.0]] ===

[[Модуль поиска туров 5.0|Описание модуля]]

[[Создание модуля поиска туров 5.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 5.0|Дополнительные настройки]]

=== [[:Category:Модуль поиска туров 4.0|Модуль поиска туров 4.0]] ===
[[Модуль поиска туров 4.0|Описание модуля]]

[[Создание модуля поиска туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 4.0|Дополнительные настройки]]

=== [[:Category:Модуль горящих туров 4.0|Модуль горящих туров 4.0]] ===

[[Модуль горящих туров 4.0|Описание модуля]]

[[Создание модуля горящих туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля горящих туров 4.0|Дополнительные настройки]]

=== [[:Category:Слайдер 4.0|Слайдер 4.0]] ===

[[Слайдер 4.0|Описание модуля]]

[[Создание Слайдера 4.0|Создание модуля]]

[[Дополнительные настройки Слайдера 4.0|Дополнительные настройки]]

=== [[:Category:Настройка модулей в Личном кабинете|Настройка модулей в Личном кабинете]] ===

[[Настройка уведомлений]]

[[Настройка модулей]]

[[Добавление офисов]]

[[Мастер Умных Ссылок]]

[[Статистика]]

[[Быстрый поиск тура по короткому номеру]]

=== [[:Category:Дополнения к модулям поиска|Дополнения]] ===
[[Блок отзывов об отелях]]

== Шлюзы поиска, расширения и дополнения ==
=== [[:Category:Шлюзы поиска туров|Шлюзы поиска туров]] ===
[[Шлюз поиска туров (xml)]]

[[Шлюз поиска туров (json)]]

[[Шлюз поиска горящих туров (json)]]

=== [[:Category:Расширения и дополнения|Расширения и дополнения]] ===
[[Отельная база (xml)]]

[[Аналитика (json)]]

[[Детальная актуализация (xml)]]

[[Суточный кеш (xml)]]

[[Онлайн-оплата (xml)]]

== Система биллинга: подключение и настройка ==
=== [[:Category:Система биллинга|Система биллинга]] ===
[[Начало работы]]

[[Базовые настройки]]

[[Процесс оплаты]]

[[Список заказов]]

[[Ручное создание тура]]

[[Расширенные настройки]]

[[Дизайнер документов]]

=== [[:Category:Подключение платежных провайдеров|Подключение платежных провайдеров]] ===

[[Банк «Русский стандарт» — интеграция]]

[[«Кредит Европа Банк» — интеграция]]

[[«AquiroPay» — интеграция]]

[[«PayOnline» — интеграция]]

[[«Uniteller» — интеграция]]

[[«Payture» — интеграция]]

== Подключение туроператоров ==

=== [[:Category:Подключение_туроператоров|Подключение туроператоров]] ===

[[Подключение_туроператоров]]

[[Sletat_Ru_Provider_API]] - English version

Заглавная страница

2016-01-29T08:43:36Z

Vm: /* Подключение туроператоров */

__NOTOC__
== Модули поиска туров ==

[[Лицензия]]

=== [[:Category:Модуль поиска туров 5.0|Модуль поиска туров 5.0]] ===

[[Модуль поиска туров 5.0|Описание модуля]]

[[Создание модуля поиска туров 5.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 5.0|Дополнительные настройки]]

=== [[:Category:Модуль поиска туров 4.0|Модуль поиска туров 4.0]] ===
[[Модуль поиска туров 4.0|Описание модуля]]

[[Создание модуля поиска туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 4.0|Дополнительные настройки]]

=== [[:Category:Модуль горящих туров 4.0|Модуль горящих туров 4.0]] ===

[[Модуль горящих туров 4.0|Описание модуля]]

[[Создание модуля горящих туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля горящих туров 4.0|Дополнительные настройки]]

=== [[:Category:Слайдер 4.0|Слайдер 4.0]] ===

[[Слайдер 4.0|Описание модуля]]

[[Создание Слайдера 4.0|Создание модуля]]

[[Дополнительные настройки Слайдера 4.0|Дополнительные настройки]]

=== [[:Category:Настройка модулей в Личном кабинете|Настройка модулей в Личном кабинете]] ===

[[Настройка уведомлений]]

[[Настройка модулей]]

[[Добавление офисов]]

[[Мастер Умных Ссылок]]

[[Статистика]]

[[Быстрый поиск тура по короткому номеру]]

=== [[:Category:Дополнения к модулям поиска|Дополнения]] ===
[[Блок отзывов об отелях]]

== Шлюзы поиска, расширения и дополнения ==
=== [[:Category:Шлюзы поиска туров|Шлюзы поиска туров]] ===
[[Шлюз поиска туров (xml)]]

[[Шлюз поиска туров (json)]]

[[Шлюз поиска горящих туров (json)]]

=== [[:Category:Расширения и дополнения|Расширения и дополнения]] ===
[[Отельная база (xml)]]

[[Аналитика (json)]]

[[Детальная актуализация (xml)]]

[[Суточный кеш (xml)]]

[[Онлайн-оплата (xml)]]

== Система биллинга: подключение и настройка ==
=== [[:Category:Система биллинга|Система биллинга]] ===
[[Начало работы]]

[[Базовые настройки]]

[[Процесс оплаты]]

[[Список заказов]]

[[Ручное создание тура]]

[[Расширенные настройки]]

[[Дизайнер документов]]

=== [[:Category:Подключение платежных провайдеров|Подключение платежных провайдеров]] ===

[[Банк «Русский стандарт» — интеграция]]

[[«Кредит Европа Банк» — интеграция]]

[[«AquiroPay» — интеграция]]

[[«PayOnline» — интеграция]]

[[«Uniteller» — интеграция]]

[[«Payture» — интеграция]]

== Подключение туроператоров ==

=== [[:Category:Подключение_туроператоров|Подключение туроператоров]] ===

[[Подключение_туроператоров]]

[[Sletat_Ru_Provider_API]]

Sletat Ru Provider API

2016-01-29T08:41:14Z

Vm: /* Tour Search */

Sletat Ru Provider API

2016-01-29T08:39:54Z

Vm: /* Tour Search */

Sletat Ru Provider API

2016-01-29T08:36:09Z

Vm: /* Service Description */

Sletat Ru Provider API

2016-01-27T08:56:55Z

Vm: /* Tour Search */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Hotels ===

This method returns the list of all available hotels, preferably only those, which actual prices are available through the tour operator.

'''Format of the query:''' ?action=GetHotels

'''Parameters:'''

* id – hotel identifier (optional; if specified, only one entry is queried).

'''The output format:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

The root element '''getHotelsResult''' contains an arbitrary number of '''hotel''' elements, where each one of them describes a hotel with attributes: '''id''' (identifier), '''name''' (name of the hotel), '''hotelCategoryId''' (hotel category identifier) and '''resortId''' (identifier of the resort in which this hotel is located).

=== Returning Meal Options ===

This method returns the list of meal options available, e.g. HB, BB, no meals, etc.

'''Format of the query:''' ?action=GetMeals

'''Parameters:'''

* id – identifier of the meal type (optional; if specified, only one entry is queried)

'''The output format:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

The root element '''getMealsResult''' contains an arbitrary number of '''meal''' elements, where each of them describes a meal option with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Currencies ===

This method returns the list of used currencies. At the very least it has to contain Russian Rubles, US Dollars and Euros.

'''Format of the query:''' ?action=GetCurrencies

'''Parameters:'''

* id – currency identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

The root element '''getCurrenciesResult''' contains an arbitrary number of '''currency''' elements, where each one of them describes the currency with attributes: '''id''' (identifier) and '''name''' (name).

=== Tour Search ===

The tour search method has multiple parameters of search and tour filtration. The method should return only the cheapest deals, filtered out by a specified parameter. The number of returned tours is regulated by the parameter '''count'''.

'''Format of the query:''' ?action=GetTours

'''Parameters:'''

{| class="wikitable"
|Parameter; '''required'''
|Type of Data
|Description
|-
|offerId
|Int64
|Unique identifier of the previously found offer. If specified, all other parameters are unnecessary and should be omitted, as well as the method should return only one entry.
|-
|'''count'''
|Int32
|Maximum number of offers returned by the query.
|-
|'''countryId'''
|Int32
|Country identifier.
|-
|'''departCityId'''
|Int32
|Departure city identifier.
|-
|'''dateFrom'''
|String
|First date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''dateTo'''
|String
|Last date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''adults'''
|Int32
|Number of adults.
|-
|'''kids'''
|Int32
|Number of children.
|-
|kidsAges
|String
|Number of full years of age of each child, transmitted as a string, enumeration separated by comma, e.g. 3, 6. Values 0 or 1 have been used to indicate age of infants.
|-
|'''nightsMin'''
|Int32
|Minimum number of nights in the tour.
|-
|'''nightsMax'''
|Int32
|Maximum number of nights in the tour.
|-
|resorts
|String
|Identifiers of the resorts, enumeration separated by comma.
|-
|hotelCategories
|String
|Identifiers of hotel categories, enumeration separated by comma.
|-
|hotels
|String
|Hotel identifiers, enumeration separated by comma.
|-
|meals
|String
|Identifiers of meal options, enumeration separated by comma.
|-
|'''currencyId'''
|Int32
|Currency, which also includes prices, as well as currency for input parameters priceMin and priceMax (if specified).
|-
|priceMin
|Int32
|Minimum price of the tour.
|-
|priceMax
|Int32
|Maximum price of the tour.
|-
|hotelIsNotInStop
|Int32
|If input value equals to 1, the results should not contain any hotels with no places available (hotels with the status «on request» are acceptable).
|-
|ticketsIncluded
|Int32
|If input value equals to 1, the results should contain only the tours, for which the flight fare is included into the total price (option only hotel is unacceptable).
|-
|hasTickets
|Int32
|If input value equals to 1, the results should contain only the tours, for which the tickets are currently available, there should not be flights with no places available or flights with on request status.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''The output format:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

The root element '''getToursResult''' contains an arbitrary number of '''tour''' elements (cannot exceed the number specified in '''count''' parameter), where each one of them describes the tour with the following atributes:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''offerId'''
|Unique identifier of the offer for further tour actualization or booking.
|-
|'''tourName'''
|Arbitrary name of the tour.
|-
|'''hotelId'''
|Hotel identifier.
|-
|hotelUrl
|Link to the page with the tour description.
|-
|'''resortId'''
|Identifier of the resort in which the hotel is located.
|-
|'''hotelCategoryId'''
|Hotel category identifier.
|-
|'''mealId'''
|Meal option identifier.
|-
|'''htPlaceName'''
|Arbitrary name for hotel accommodation preferences, e.g. DBL, TRP, 2 ADL + 1 CH (2-12), 2 ADL + INF). The name should express age of children (if the number of children older than 0 y.o. was specified) or indicate the request for accommodation of an infant (+ INF) respectively.
|-
|'''roomTypeName'''
|Name of the room type, e.g. standard, deluxe, family, deluxe super, ocean view.
|-
|'''tourDate'''
|Beginning date of the tour in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|The number of nights in the tour.
|-
|'''price'''
|Price of the tour in currency, specified in the input parameter '''currencyId'''.
|-
|'''hotelIsInStop'''
|Hotel rooms availability. The following values are acceptable: 0 – rooms available, 1 – rooms unavailable, 2 – on request.
|-
|'''ticketsIncluded'''
|Indicator if the ticket prices are included in the tour price. The following values are acceptable: 0 – not included (hotel only tour), 1 – included (package tour).
|-
|'''hasEconomTicketsDpt'''
|Availability of economy class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasEconomTicketsRtn'''
|Availability of economy class return tickets. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsDpt'''
|Availability of business class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 - tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsRtn'''
|Availability of the business class return tickets. The following parameters are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''tourUrl'''
|Link to the booking page (the link can first lead to the page of authorization, and when authorization is complete it should take the customer to the booking page automatically).
|-
|spoUrl
|Link to the tour description and the tour programs (if available).
|-
|fewPlacesInHotel
|The field may be filled if there is an indication that there only few rooms available in the hotel. If the exact number of remaining rooms is not specified, the return value equals to -1, otherwise the value is the exact number of remaining rooms.
|-
|fewTicketsDptY
|The field may be filled if there is an indication that there are only few economy class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsRtnY
|The field may be filled if there is an indication that there are only few return flight economy class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsDptB
|The field may be filled if there is an indication that there are only few business class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsRtnB
|The field may be filled if there is an indication that there are only few return flight business class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|flags
|The set of bit flags of the tour. Multiple flags can be attributed to the same tour simultaneously, and the sum of them makes the value of this parameter. Possible flags of the tour:
* 1 – recommended by the tour operator;
* 2 – instant confirmation available;
* 4 – best offer;
* 8 – early booking available;
* 16 – late booking available;
* 32 – discounted tour;
* 64 – VIP offer;
* 128 – credit for this tour available;
* 256 – exclusive offer;
* 512 – gift offered upon purchase;
* 1024 – combined tour;
* 2048 – tour with obligation (shopping tour);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Additional information on the tour, e.g. hotel accommodation info for combined tours.
|-
|receivingParty
|Receiving party.
|-
|earlyBookingValidTill
|If the tour is available for early booking and the last date of early booking is known, then the field should contain this date.
|-
|}

=== Tour Actualization ===

This method gets the tour final price (including all mandatory surcharges and fees), list of included services, flight options, additional services and surcharges. The method should return the price of the least expensive configuration of the offer queried. For correct functioning of this method it is necessary that '''offerId''' be unique for the offers with various composition of the tourist group even if all the other parameters of the offers have the same values.

'''The format of the query:''' ?action=ActualizeTour

'''Parameters:'''

{| class="wikitable"
|Parameter; '''required'''
|Type of Data
|Description
|-
|'''offerId'''
|Int64
|Unique identifier of the previously found offer.
|-
|'''currencyId'''
|Int32
|Currency to calculate the price and surcharges in.
|-
|}

'''The output format:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

The root element '''actualizeTourResult''' should only contain a single '''actualizedTour''' element, described with the following attributes:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''price'''
|Actualized price of the tour in currency, specified in the '''currencyId''' input parameter.
|-
|'''ticketsIsIncluded'''
|Indicator if the tickets price is included in the tour price. The following values are acceptable: 0 – not included (hotel tour only), 1 – included (package tour).
|-
|'''hasEconomTicketsDpt'''
|Availability of economy class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasEconomTicketsRtn'''
|Availability of return tickets of economy class. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsDpt'''
|Availability of business class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsRtn'''
|Availability of return tickets of the business class. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|fewPlacesInHotel
|The field is may be filled if there is an indication that there only few rooms available in the hotel. If the exact number of remaining rooms is not specified, the return value equals to -1, otherwise the value is the exact number of remaining rooms.
|-
|fewEconomTicketsDpt
|The field may be filled if there is an indication that there are only few economy class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewEconomTicketsRtn
|The field may be filled if there is an indication that there are only few return flight economy class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewBusinessTicketsDpt
|The field may be filled if there is an indication that there are only few business class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewBusinessTicketsRtn
|The field may be filled if there is an indication that there are only few return flight business class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|tourUrl
|Link to the booking page (the link can first lead to the page of authorization, and when authorization is complete it should take the customer to the booking page automatically).
|-
|}

The element '''actualizedTour''' can contain '''services''' section, which in turn contains an arbitrary number of '''service''' elements. Each '''service''' element describes the service either included into the price of the tour or the service which can be added to the current configuration of the tour. Attributes of '''service''' element are as following:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''id'''
|Service identifier, unique for this offer.
|-
|'''type'''
|Service type. Accepts one of the following values:
* “Insurance” – insurance;
* “DptTransport” – destination flight;
* “RtnTransport” – return flight;
* “AdditionalService ” – additional service;
* “AdditionalMeal” – extra meals;
* “Transfer” – transfer;
* “Excursion” – excursion;
* “Charge” – surcharges;
* “Visa” – visa;
* “NoGoGuarantee” – insurance for the case of tour cancellation;
|-
|'''name'''
|Service name.
|-
|'''isIncluded'''
|Indicator if the current service is included into the price of the current configuration of the tour. The following values are acceptable: 0 – not included, 1 – included.
|-
|description
|Description of the service in a free form.
|-
|surcharge
|Surcharges for inclusion of the service into the tour price. Applies only to the services, not included in the current configuration of the tour.
|-
|flightCompatibleIds
|Compatible flights. Identifiers of flight services from the services section, which can be applied together with the current flight service. For the destination flight, id of return flights is filled out and vice versa. This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightClass
|Flight class. Can accept one of the following values:
* “ECONOM” – economy;
* “BUSINESS” – business;
This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightAvailability
|Tickets availability with the following acceptable values: 0 – no tickets available, 1 – tickets available, 2 – on request. This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightPlacesCount
|Number of available tickets. The field is completed only if there are few tickets available. If the number of available tickets is known, the value is this number. Otherwise, the value equals to -1. The may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAirportFrom
|Departure airport. The value should begin with IATA code, followed by additional information, e.g. the terminal (example: SVO C). This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightAirportTo
|Arrival airport. The value should begin with IATA code, followed by additional information, e.g. the terminal (example: AYT 1). This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightNum
|Flight, e.g. UN 7422. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAirline
|Airline. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightStartDateTime
|Departure date and time in the format dd.MM.yyyy HH:mm (e.g.: 31.12.2015 14:30). The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightEndDateTime
|Arrival date and time in the format dd.MM.yyyy HH:mm (e.g.: 31.12.2015 14:30). The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAircraft
|Information about the aircraft. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|}

Подключение туроператоров

2016-01-27T08:56:03Z

Vm: /* Поиск туров */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать '''30 секунд'''. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до '''5 секунд'''. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|'''roomTypeName'''
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если количество билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T13:34:53Z

Vm: /* Returning Meal Options */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Hotels ===

This method returns the list of all available hotels, preferably only those, which actual prices are available through the tour operator.

'''Format of the query:''' ?action=GetHotels

'''Parameters:'''

* id – hotel identifier (optional; if specified, only one entry is queried).

'''The output format:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

The root element '''getHotelsResult''' contains an arbitrary number of '''hotel''' elements, where each one of them describes a hotel with attributes: '''id''' (identifier), '''name''' (name of the hotel), '''hotelCategoryId''' (hotel category identifier) and '''resortId''' (identifier of the resort in which this hotel is located).

=== Returning Meal Options ===

This method returns the list of meal options available, e.g. HB, BB, no meals, etc.

'''Format of the query:''' ?action=GetMeals

'''Parameters:'''

* id – identifier of the meal type (optional; if specified, only one entry is queried)

'''The output format:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

The root element '''getMealsResult''' contains an arbitrary number of '''meal''' elements, where each of them describes a meal option with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Currencies ===

This method returns the list of used currencies. At the very least it has to contain Russian Rubles, US Dollars and Euros.

'''Format of the query:''' ?action=GetCurrencies

'''Parameters:'''

* id – currency identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

The root element '''getCurrenciesResult''' contains an arbitrary number of '''currency''' elements, where each one of them describes the currency with attributes: '''id''' (identifier) and '''name''' (name).

=== Tour Search ===

The tour search method has multiple parameters of search and tour filtration. The method should return only the cheapest deals, filtered out by a specified parameter. The number of returned tours is regulated by the parameter '''count'''.

'''Format of the query:''' ?action=GetTours

'''Parameters:'''

{| class="wikitable"
|Parameter; '''required'''
|Type of Data
|Description
|-
|offerId
|Int64
|Unique identifier of the previously found offer. If specified, all other parameters are unnecessary and should be omitted, as well as the method should return only one entry.
|-
|'''count'''
|Int32
|Maximum number of offers returned by the query.
|-
|'''countryId'''
|Int32
|Country identifier.
|-
|'''departCityId'''
|Int32
|Departure city identifier.
|-
|'''dateFrom'''
|String
|First date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''dateTo'''
|String
|Last date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''adults'''
|Int32
|Number of adults.
|-
|'''kids'''
|Int32
|Number of children.
|-
|kidsAges
|String
|Number of full years of age of each child, transmitted as a string, enumeration separated by comma, e.g. 3, 6. Values 0 or 1 have been used to indicate age of infants.
|-
|'''nightsMin'''
|Int32
|Minimum number of nights in the tour.
|-
|'''nightsMax'''
|Int32
|Maximum number of nights in the tour.
|-
|resorts
|String
|Identifiers of the resorts, enumeration separated by comma.
|-
|hotelCategories
|String
|Identifiers of hotel categories, enumeration separated by comma.
|-
|hotels
|String
|Hotel identifiers, enumeration separated by comma.
|-
|meals
|String
|Identifiers of meal options, enumeration separated by comma.
|-
|'''currencyId'''
|Int32
|Currency, which also includes prices, as well as currency for input parameters priceMin and priceMax (if specified).
|-
|priceMin
|Int32
|Minimum price of the tour.
|-
|priceMax
|Int32
|Maximum price of the tour.
|-
|hotelIsNotInStop
|Int32
|If input value equals to 1, the results should not contain any hotels with no places available (hotels with the status «on request» are acceptable).
|-
|ticketsIncluded
|Int32
|If input value equals to 1, the results should contain only the tours, for which the flight fare is included into the total price (option only hotel is unacceptable).
|-
|hasTickets
|Int32
|If input value equals to 1, the results should contain only the tours, for which the tickets are currently available, there should not be flights with no places available or flights with on request status.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''The output format:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

The root element '''getToursResult''' contains an arbitrary number of '''tour''' elements (cannot exceed the number specified in '''count''' parameter), where each one of them describes the tour with the following atributes:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''offerId'''
|Unique identifier of the offer for further tour actualization or booking.
|-
|'''tourName'''
|Arbitrary name of the tour.
|-
|'''hotelId'''
|Hotel identifier.
|-
|hotelUrl
|Link to the page with the tour description.
|-
|'''resortId'''
|Identifier of the resort in which the hotel is located.
|-
|'''hotelCategoryId'''
|Hotel category identifier.
|-
|'''mealId'''
|Meal option identifier.
|-
|'''htPlaceName'''
|Arbitrary name for hotel accommodation preferences, e.g. DBL, TRP, 2 ADL + 1 CH (2-12), 2 ADL + INF). The name should express age of children (if the number of children older than 0 y.o. was specified) or indicate the request for accommodation of an infant (+ INF) respectively.
|-
|roomTypeName
|Name of the room type, e.g. standard, deluxe, family, deluxe super, ocean view.
|-
|'''tourDate'''
|Beginning date of the tour in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|The number of nights in the tour.
|-
|'''price'''
|Price of the tour in currency, specified in the input parameter '''currencyId'''.
|-
|'''hotelIsInStop'''
|Hotel rooms availability. The following values are acceptable: 0 – rooms available, 1 – rooms unavailable, 2 – on request.
|-
|'''ticketsIncluded'''
|Indicator if the ticket prices are included in the tour price. The following values are acceptable: 0 – not included (hotel only tour), 1 – included (package tour).
|-
|'''hasEconomTicketsDpt'''
|Availability of economy class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasEconomTicketsRtn'''
|Availability of economy class return tickets. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsDpt'''
|Availability of business class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 - tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsRtn'''
|Availability of the business class return tickets. The following parameters are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''tourUrl'''
|Link to the booking page (the link can first lead to the page of authorization, and when authorization is complete it should take the customer to the booking page automatically).
|-
|spoUrl
|Link to the tour description and the tour programs (if available).
|-
|fewPlacesInHotel
|The field may be filled if there is an indication that there only few rooms available in the hotel. If the exact number of remaining rooms is not specified, the return value equals to -1, otherwise the value is the exact number of remaining rooms.
|-
|fewTicketsDptY
|The field may be filled if there is an indication that there are only few economy class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsRtnY
|The field may be filled if there is an indication that there are only few return flight economy class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsDptB
|The field may be filled if there is an indication that there are only few business class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsRtnB
|The field may be filled if there is an indication that there are only few return flight business class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|flags
|The set of bit flags of the tour. Multiple flags can be attributed to the same tour simultaneously, and the sum of them makes the value of this parameter. Possible flags of the tour:
* 1 – recommended by the tour operator;
* 2 – instant confirmation available;
* 4 – best offer;
* 8 – early booking available;
* 16 – late booking available;
* 32 – discounted tour;
* 64 – VIP offer;
* 128 – credit for this tour available;
* 256 – exclusive offer;
* 512 – gift offered upon purchase;
* 1024 – combined tour;
* 2048 – tour with obligation (shopping tour);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Additional information on the tour, e.g. hotel accommodation info for combined tours.
|-
|receivingParty
|Receiving party.
|-
|earlyBookingValidTill
|If the tour is available for early booking and the last date of early booking is known, then the field should contain this date.
|-
|}

=== Tour Actualization ===

This method gets the tour final price (including all mandatory surcharges and fees), list of included services, flight options, additional services and surcharges. The method should return the price of the least expensive configuration of the offer queried. For correct functioning of this method it is necessary that '''offerId''' be unique for the offers with various composition of the tourist group even if all the other parameters of the offers have the same values.

'''The format of the query:''' ?action=ActualizeTour

'''Parameters:'''

{| class="wikitable"
|Parameter; '''required'''
|Type of Data
|Description
|-
|'''offerId'''
|Int64
|Unique identifier of the previously found offer.
|-
|'''currencyId'''
|Int32
|Currency to calculate the price and surcharges in.
|-
|}

'''The output format:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

The root element '''actualizeTourResult''' should only contain a single '''actualizedTour''' element, described with the following attributes:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''price'''
|Actualized price of the tour in currency, specified in the '''currencyId''' input parameter.
|-
|'''ticketsIsIncluded'''
|Indicator if the tickets price is included in the tour price. The following values are acceptable: 0 – not included (hotel tour only), 1 – included (package tour).
|-
|'''hasEconomTicketsDpt'''
|Availability of economy class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasEconomTicketsRtn'''
|Availability of return tickets of economy class. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsDpt'''
|Availability of business class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsRtn'''
|Availability of return tickets of the business class. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|fewPlacesInHotel
|The field is may be filled if there is an indication that there only few rooms available in the hotel. If the exact number of remaining rooms is not specified, the return value equals to -1, otherwise the value is the exact number of remaining rooms.
|-
|fewEconomTicketsDpt
|The field may be filled if there is an indication that there are only few economy class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewEconomTicketsRtn
|The field may be filled if there is an indication that there are only few return flight economy class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewBusinessTicketsDpt
|The field may be filled if there is an indication that there are only few business class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewBusinessTicketsRtn
|The field may be filled if there is an indication that there are only few return flight business class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|tourUrl
|Link to the booking page (the link can first lead to the page of authorization, and when authorization is complete it should take the customer to the booking page automatically).
|-
|}

The element '''actualizedTour''' can contain '''services''' section, which in turn contains an arbitrary number of '''service''' elements. Each '''service''' element describes the service either included into the price of the tour or the service which can be added to the current configuration of the tour. Attributes of '''service''' element are as following:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''id'''
|Service identifier, unique for this offer.
|-
|'''type'''
|Service type. Accepts one of the following values:
* “Insurance” – insurance;
* “DptTransport” – destination flight;
* “RtnTransport” – return flight;
* “AdditionalService ” – additional service;
* “AdditionalMeal” – extra meals;
* “Transfer” – transfer;
* “Excursion” – excursion;
* “Charge” – surcharges;
* “Visa” – visa;
* “NoGoGuarantee” – insurance for the case of tour cancellation;
|-
|'''name'''
|Service name.
|-
|'''isIncluded'''
|Indicator if the current service is included into the price of the current configuration of the tour. The following values are acceptable: 0 – not included, 1 – included.
|-
|description
|Description of the service in a free form.
|-
|surcharge
|Surcharges for inclusion of the service into the tour price. Applies only to the services, not included in the current configuration of the tour.
|-
|flightCompatibleIds
|Compatible flights. Identifiers of flight services from the services section, which can be applied together with the current flight service. For the destination flight, id of return flights is filled out and vice versa. This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightClass
|Flight class. Can accept one of the following values:
* “ECONOM” – economy;
* “BUSINESS” – business;
This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightAvailability
|Tickets availability with the following acceptable values: 0 – no tickets available, 1 – tickets available, 2 – on request. This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightPlacesCount
|Number of available tickets. The field is completed only if there are few tickets available. If the number of available tickets is known, the value is this number. Otherwise, the value equals to -1. The may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAirportFrom
|Departure airport. The value should begin with IATA code, followed by additional information, e.g. the terminal (example: SVO C). This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightAirportTo
|Arrival airport. The value should begin with IATA code, followed by additional information, e.g. the terminal (example: AYT 1). This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightNum
|Flight, e.g. UN 7422. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAirline
|Airline. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightStartDateTime
|Departure date and time in the format dd.MM.yyyy HH:mm (e.g.: 31.12.2015 14:30). The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightEndDateTime
|Arrival date and time in the format dd.MM.yyyy HH:mm (e.g.: 31.12.2015 14:30). The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAircraft
|Information about the aircraft. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|}

Подключение туроператоров

2016-01-21T13:30:08Z

Vm: /* Актуализация тура */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать '''30 секунд'''. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до '''5 секунд'''. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если количество билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T13:28:29Z

Vm: /* Актуализация тура */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Hotels ===

This method returns the list of all available hotels, preferably only those, which actual prices are available through the tour operator.

'''Format of the query:''' ?action=GetHotels

'''Parameters:'''

* id – hotel identifier (optional; if specified, only one entry is queried).

'''The output format:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

The root element '''getHotelsResult''' contains an arbitrary number of '''hotel''' elements, where each one of them describes a hotel with attributes: '''id''' (identifier), '''name''' (name of the hotel), '''hotelCategoryId''' (hotel category identifier) and '''resortId''' (identifier of the resort in which this hotel is located).

=== Returning Meal Options ===

This method returns the list of meal options available, e.g. HB, BB, no meals, etc.

'''Format of the query:''' ?action=GetMeals

'''Parameters:'''

* id – identifier of the meal type (optional; if specified, only one entry is queried)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

The root element '''getMealsResult''' contains an arbitrary number of '''meal''' elements, where each of them describes a meal option with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Currencies ===

This method returns the list of used currencies. At the very least it has to contain Russian Rubles, US Dollars and Euros.

'''Format of the query:''' ?action=GetCurrencies

'''Parameters:'''

* id – currency identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

The root element '''getCurrenciesResult''' contains an arbitrary number of '''currency''' elements, where each one of them describes the currency with attributes: '''id''' (identifier) and '''name''' (name).

=== Tour Search ===

The tour search method has multiple parameters of search and tour filtration. The method should return only the cheapest deals, filtered out by a specified parameter. The number of returned tours is regulated by the parameter '''count'''.

'''Format of the query:''' ?action=GetTours

'''Parameters:'''

{| class="wikitable"
|Parameter; '''required'''
|Type of Data
|Description
|-
|offerId
|Int64
|Unique identifier of the previously found offer. If specified, all other parameters are unnecessary and should be omitted, as well as the method should return only one entry.
|-
|'''count'''
|Int32
|Maximum number of offers returned by the query.
|-
|'''countryId'''
|Int32
|Country identifier.
|-
|'''departCityId'''
|Int32
|Departure city identifier.
|-
|'''dateFrom'''
|String
|First date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''dateTo'''
|String
|Last date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''adults'''
|Int32
|Number of adults.
|-
|'''kids'''
|Int32
|Number of children.
|-
|kidsAges
|String
|Number of full years of age of each child, transmitted as a string, enumeration separated by comma, e.g. 3, 6. Values 0 or 1 have been used to indicate age of infants.
|-
|'''nightsMin'''
|Int32
|Minimum number of nights in the tour.
|-
|'''nightsMax'''
|Int32
|Maximum number of nights in the tour.
|-
|resorts
|String
|Identifiers of the resorts, enumeration separated by comma.
|-
|hotelCategories
|String
|Identifiers of hotel categories, enumeration separated by comma.
|-
|hotels
|String
|Hotel identifiers, enumeration separated by comma.
|-
|meals
|String
|Identifiers of meal options, enumeration separated by comma.
|-
|'''currencyId'''
|Int32
|Currency, which also includes prices, as well as currency for input parameters priceMin and priceMax (if specified).
|-
|priceMin
|Int32
|Minimum price of the tour.
|-
|priceMax
|Int32
|Maximum price of the tour.
|-
|hotelIsNotInStop
|Int32
|If input value equals to 1, the results should not contain any hotels with no places available (hotels with the status «on request» are acceptable).
|-
|ticketsIncluded
|Int32
|If input value equals to 1, the results should contain only the tours, for which the flight fare is included into the total price (option only hotel is unacceptable).
|-
|hasTickets
|Int32
|If input value equals to 1, the results should contain only the tours, for which the tickets are currently available, there should not be flights with no places available or flights with on request status.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''The output format:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

The root element '''getToursResult''' contains an arbitrary number of '''tour''' elements (cannot exceed the number specified in '''count''' parameter), where each one of them describes the tour with the following atributes:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''offerId'''
|Unique identifier of the offer for further tour actualization or booking.
|-
|'''tourName'''
|Arbitrary name of the tour.
|-
|'''hotelId'''
|Hotel identifier.
|-
|hotelUrl
|Link to the page with the tour description.
|-
|'''resortId'''
|Identifier of the resort in which the hotel is located.
|-
|'''hotelCategoryId'''
|Hotel category identifier.
|-
|'''mealId'''
|Meal option identifier.
|-
|'''htPlaceName'''
|Arbitrary name for hotel accommodation preferences, e.g. DBL, TRP, 2 ADL + 1 CH (2-12), 2 ADL + INF). The name should express age of children (if the number of children older than 0 y.o. was specified) or indicate the request for accommodation of an infant (+ INF) respectively.
|-
|roomTypeName
|Name of the room type, e.g. standard, deluxe, family, deluxe super, ocean view.
|-
|'''tourDate'''
|Beginning date of the tour in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|The number of nights in the tour.
|-
|'''price'''
|Price of the tour in currency, specified in the input parameter '''currencyId'''.
|-
|'''hotelIsInStop'''
|Hotel rooms availability. The following values are acceptable: 0 – rooms available, 1 – rooms unavailable, 2 – on request.
|-
|'''ticketsIncluded'''
|Indicator if the ticket prices are included in the tour price. The following values are acceptable: 0 – not included (hotel only tour), 1 – included (package tour).
|-
|'''hasEconomTicketsDpt'''
|Availability of economy class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasEconomTicketsRtn'''
|Availability of economy class return tickets. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsDpt'''
|Availability of business class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 - tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsRtn'''
|Availability of the business class return tickets. The following parameters are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''tourUrl'''
|Link to the booking page (the link can first lead to the page of authorization, and when authorization is complete it should take the customer to the booking page automatically).
|-
|spoUrl
|Link to the tour description and the tour programs (if available).
|-
|fewPlacesInHotel
|The field may be filled if there is an indication that there only few rooms available in the hotel. If the exact number of remaining rooms is not specified, the return value equals to -1, otherwise the value is the exact number of remaining rooms.
|-
|fewTicketsDptY
|The field may be filled if there is an indication that there are only few economy class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsRtnY
|The field may be filled if there is an indication that there are only few return flight economy class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsDptB
|The field may be filled if there is an indication that there are only few business class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsRtnB
|The field may be filled if there is an indication that there are only few return flight business class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|flags
|The set of bit flags of the tour. Multiple flags can be attributed to the same tour simultaneously, and the sum of them makes the value of this parameter. Possible flags of the tour:
* 1 – recommended by the tour operator;
* 2 – instant confirmation available;
* 4 – best offer;
* 8 – early booking available;
* 16 – late booking available;
* 32 – discounted tour;
* 64 – VIP offer;
* 128 – credit for this tour available;
* 256 – exclusive offer;
* 512 – gift offered upon purchase;
* 1024 – combined tour;
* 2048 – tour with obligation (shopping tour);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Additional information on the tour, e.g. hotel accommodation info for combined tours.
|-
|receivingParty
|Receiving party.
|-
|earlyBookingValidTill
|If the tour is available for early booking and the last date of early booking is known, then the field should contain this date.
|-
|}

=== Tour Actualization ===

This method gets the tour final price (including all mandatory surcharges and fees), list of included services, flight options, additional services and surcharges. The method should return the price of the least expensive configuration of the offer queried. For correct functioning of this method it is necessary that '''offerId''' be unique for the offers with various composition of the tourist group even if all the other parameters of the offers have the same values.

'''The format of the query:''' ?action=ActualizeTour

'''Parameters:'''

{| class="wikitable"
|Parameter; '''required'''
|Type of Data
|Description
|-
|'''offerId'''
|Int64
|Unique identifier of the previously found offer.
|-
|'''currencyId'''
|Int32
|Currency to calculate the price and surcharges in.
|-
|}

'''The output format:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

The root element '''actualizeTourResult''' should only contain a single '''actualizedTour''' element, described with the following attributes:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''price'''
|Actualized price of the tour in currency, specified in the '''currencyId''' input parameter.
|-
|'''ticketsIsIncluded'''
|Indicator if the tickets price is included in the tour price. The following values are acceptable: 0 – not included (hotel tour only), 1 – included (package tour).
|-
|'''hasEconomTicketsDpt'''
|Availability of economy class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasEconomTicketsRtn'''
|Availability of return tickets of economy class. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsDpt'''
|Availability of business class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsRtn'''
|Availability of return tickets of the business class. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|fewPlacesInHotel
|The field is may be filled if there is an indication that there only few rooms available in the hotel. If the exact number of remaining rooms is not specified, the return value equals to -1, otherwise the value is the exact number of remaining rooms.
|-
|fewEconomTicketsDpt
|The field may be filled if there is an indication that there are only few economy class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewEconomTicketsRtn
|The field may be filled if there is an indication that there are only few return flight economy class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewBusinessTicketsDpt
|The field may be filled if there is an indication that there are only few business class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewBusinessTicketsRtn
|The field may be filled if there is an indication that there are only few return flight business class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|tourUrl
|Link to the booking page (the link can first lead to the page of authorization, and when authorization is complete it should take the customer to the booking page automatically).
|-
|}

The element '''actualizedTour''' can contain '''services''' section, which in turn contains an arbitrary number of '''service''' elements. Each '''service''' element describes the service either included into the price of the tour or the service which can be added to the current configuration of the tour. Attributes of '''service''' element are as following:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''id'''
|Service identifier, unique for this offer.
|-
|'''type'''
|Service type. Accepts one of the following values:
* “Insurance” – insurance;
* “DptTransport” – destination flight;
* “RtnTransport” – return flight;
* “AdditionalService ” – additional service;
* “AdditionalMeal” – extra meals;
* “Transfer” – transfer;
* “Excursion” – excursion;
* “Charge” – surcharges;
* “Visa” – visa;
* “NoGoGuarantee” – insurance for the case of tour cancellation;
|-
|'''name'''
|Service name.
|-
|'''isIncluded'''
|Indicator if the current service is included into the price of the current configuration of the tour. The following values are acceptable: 0 – not included, 1 – included.
|-
|description
|Description of the service in a free form.
|-
|surcharge
|Surcharges for inclusion of the service into the tour price. Applies only to the services, not included in the current configuration of the tour.
|-
|flightCompatibleIds
|Compatible flights. Identifiers of flight services from the services section, which can be applied together with the current flight service. For the destination flight, id of return flights is filled out and vice versa. This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightClass
|Flight class. Can accept one of the following values:
* “ECONOM” – economy;
* “BUSINESS” – business;
This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightAvailability
|Tickets availability with the following acceptable values: 0 – no tickets available, 1 – tickets available, 2 – on request. This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightPlacesCount
|Number of available tickets. The field is completed only if there are few tickets available. If the number of available tickets is known, the value is this number. Otherwise, the value equals to -1. The may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAirportFrom
|Departure airport. The value should begin with IATA code, followed by additional information, e.g. the terminal (example: SVO C). This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightAirportTo
|Arrival airport. The value should begin with IATA code, followed by additional information, e.g. the terminal (example: AYT 1). This parameter applies and is required only for the services of DptTransport and RtnTransport types.
|-
|flightNum
|Flight, e.g. UN 7422. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAirline
|Airline. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightStartDateTime
|Departure date and time in the format dd.MM.yyyy HH:mm (e.g.: 31.12.2015 14:30). The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightEndDateTime
|Arrival date and time in the format dd.MM.yyyy HH:mm (e.g.: 31.12.2015 14:30). The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|flightAircraft
|Information about the aircraft. The field may be filled only for the services of DptTransport and RtnTransport types.
|-
|}

Sletat Ru Provider API

2016-01-21T13:04:24Z

Vm: /* Tour Search */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Hotels ===

This method returns the list of all available hotels, preferably only those, which actual prices are available through the tour operator.

'''Format of the query:''' ?action=GetHotels

'''Parameters:'''

* id – hotel identifier (optional; if specified, only one entry is queried).

'''The output format:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

The root element '''getHotelsResult''' contains an arbitrary number of '''hotel''' elements, where each one of them describes a hotel with attributes: '''id''' (identifier), '''name''' (name of the hotel), '''hotelCategoryId''' (hotel category identifier) and '''resortId''' (identifier of the resort in which this hotel is located).

=== Returning Meal Options ===

This method returns the list of meal options available, e.g. HB, BB, no meals, etc.

'''Format of the query:''' ?action=GetMeals

'''Parameters:'''

* id – identifier of the meal type (optional; if specified, only one entry is queried)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

The root element '''getMealsResult''' contains an arbitrary number of '''meal''' elements, where each of them describes a meal option with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Currencies ===

This method returns the list of used currencies. At the very least it has to contain Russian Rubles, US Dollars and Euros.

'''Format of the query:''' ?action=GetCurrencies

'''Parameters:'''

* id – currency identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

The root element '''getCurrenciesResult''' contains an arbitrary number of '''currency''' elements, where each one of them describes the currency with attributes: '''id''' (identifier) and '''name''' (name).

=== Tour Search ===

The tour search method has multiple parameters of search and tour filtration. The method should return only the cheapest deals, filtered out by a specified parameter. The number of returned tours is regulated by the parameter '''count'''.

'''Format of the query:''' ?action=GetTours

'''Parameters:'''

{| class="wikitable"
|Parameter; '''required'''
|Type of Data
|Description
|-
|offerId
|Int64
|Unique identifier of the previously found offer. If specified, all other parameters are unnecessary and should be omitted, as well as the method should return only one entry.
|-
|'''count'''
|Int32
|Maximum number of offers returned by the query.
|-
|'''countryId'''
|Int32
|Country identifier.
|-
|'''departCityId'''
|Int32
|Departure city identifier.
|-
|'''dateFrom'''
|String
|First date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''dateTo'''
|String
|Last date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''adults'''
|Int32
|Number of adults.
|-
|'''kids'''
|Int32
|Number of children.
|-
|kidsAges
|String
|Number of full years of age of each child, transmitted as a string, enumeration separated by comma, e.g. 3, 6. Values 0 or 1 have been used to indicate age of infants.
|-
|'''nightsMin'''
|Int32
|Minimum number of nights in the tour.
|-
|'''nightsMax'''
|Int32
|Maximum number of nights in the tour.
|-
|resorts
|String
|Identifiers of the resorts, enumeration separated by comma.
|-
|hotelCategories
|String
|Identifiers of hotel categories, enumeration separated by comma.
|-
|hotels
|String
|Hotel identifiers, enumeration separated by comma.
|-
|meals
|String
|Identifiers of meal options, enumeration separated by comma.
|-
|'''currencyId'''
|Int32
|Currency, which also includes prices, as well as currency for input parameters priceMin and priceMax (if specified).
|-
|priceMin
|Int32
|Minimum price of the tour.
|-
|priceMax
|Int32
|Maximum price of the tour.
|-
|hotelIsNotInStop
|Int32
|If input value equals to 1, the results should not contain any hotels with no places available (hotels with the status «on request» are acceptable).
|-
|ticketsIncluded
|Int32
|If input value equals to 1, the results should contain only the tours, for which the flight fare is included into the total price (option only hotel is unacceptable).
|-
|hasTickets
|Int32
|If input value equals to 1, the results should contain only the tours, for which the tickets are currently available, there should not be flights with no places available or flights with on request status.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''The output format:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

The root element '''getToursResult''' contains an arbitrary number of '''tour''' elements (cannot exceed the number specified in '''count''' parameter), where each one of them describes the tour with the following atributes:

{| class="wikitable"
|Parameter; '''required'''
|Description
|-
|'''offerId'''
|Unique identifier of the offer for further tour actualization or booking.
|-
|'''tourName'''
|Arbitrary name of the tour.
|-
|'''hotelId'''
|Hotel identifier.
|-
|hotelUrl
|Link to the page with the tour description.
|-
|'''resortId'''
|Identifier of the resort in which the hotel is located.
|-
|'''hotelCategoryId'''
|Hotel category identifier.
|-
|'''mealId'''
|Meal option identifier.
|-
|'''htPlaceName'''
|Arbitrary name for hotel accommodation preferences, e.g. DBL, TRP, 2 ADL + 1 CH (2-12), 2 ADL + INF). The name should express age of children (if the number of children older than 0 y.o. was specified) or indicate the request for accommodation of an infant (+ INF) respectively.
|-
|roomTypeName
|Name of the room type, e.g. standard, deluxe, family, deluxe super, ocean view.
|-
|'''tourDate'''
|Beginning date of the tour in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|The number of nights in the tour.
|-
|'''price'''
|Price of the tour in currency, specified in the input parameter '''currencyId'''.
|-
|'''hotelIsInStop'''
|Hotel rooms availability. The following values are acceptable: 0 – rooms available, 1 – rooms unavailable, 2 – on request.
|-
|'''ticketsIncluded'''
|Indicator if the ticket prices are included in the tour price. The following values are acceptable: 0 – not included (hotel only tour), 1 – included (package tour).
|-
|'''hasEconomTicketsDpt'''
|Availability of economy class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasEconomTicketsRtn'''
|Availability of economy class return tickets. The following values are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsDpt'''
|Availability of business class tickets to the place of destination. The following values are acceptable: 0 – no tickets available, 1 - tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''hasBusinessTicketsRtn'''
|Availability of the business class return tickets. The following parameters are acceptable: 0 – no tickets available, 1 – tickets available, 2 – on request. If the value of the attribute ticketsIncluded equals to 0, then the value of this parameter will be ignored.
|-
|'''tourUrl'''
|Link to the booking page (the link can first lead to the page of authorization, and when authorization is complete it should take the customer to the booking page automatically).
|-
|spoUrl
|Link to the tour description and the tour programs (if available).
|-
|fewPlacesInHotel
|The field may be filled if there is an indication that there only few rooms available in the hotel. If the exact number of remaining rooms is not specified, the return value equals to -1, otherwise the value is the exact number of remaining rooms.
|-
|fewTicketsDptY
|The field may be filled if there is an indication that there are only few economy class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsRtnY
|The field may be filled if there is an indication that there are only few return flight economy class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsDptB
|The field may be filled if there is an indication that there are only few business class seats available. If the exact number of remaining seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|fewTicketsRtnB
|The field may be filled if there is an indication that there are only few return flight business class seats available. If the exact number of remaining return flight seats is not specified, the return value equals to -1, otherwise the value is the exact number of remaining seats.
|-
|flags
|The set of bit flags of the tour. Multiple flags can be attributed to the same tour simultaneously, and the sum of them makes the value of this parameter. Possible flags of the tour:
* 1 – recommended by the tour operator;
* 2 – instant confirmation available;
* 4 – best offer;
* 8 – early booking available;
* 16 – late booking available;
* 32 – discounted tour;
* 64 – VIP offer;
* 128 – credit for this tour available;
* 256 – exclusive offer;
* 512 – gift offered upon purchase;
* 1024 – combined tour;
* 2048 – tour with obligation (shopping tour);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Additional information on the tour, e.g. hotel accommodation info for combined tours.
|-
|receivingParty
|Receiving party.
|-
|earlyBookingValidTill
|If the tour is available for early booking and the last date of early booking is known, then the field should contain this date.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T12:44:54Z

Vm: /* Поиск туров */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Hotels ===

This method returns the list of all available hotels, preferably only those, which actual prices are available through the tour operator.

'''Format of the query:''' ?action=GetHotels

'''Parameters:'''

* id – hotel identifier (optional; if specified, only one entry is queried).

'''The output format:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

The root element '''getHotelsResult''' contains an arbitrary number of '''hotel''' elements, where each one of them describes a hotel with attributes: '''id''' (identifier), '''name''' (name of the hotel), '''hotelCategoryId''' (hotel category identifier) and '''resortId''' (identifier of the resort in which this hotel is located).

=== Returning Meal Options ===

This method returns the list of meal options available, e.g. HB, BB, no meals, etc.

'''Format of the query:''' ?action=GetMeals

'''Parameters:'''

* id – identifier of the meal type (optional; if specified, only one entry is queried)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

The root element '''getMealsResult''' contains an arbitrary number of '''meal''' elements, where each of them describes a meal option with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Currencies ===

This method returns the list of used currencies. At the very least it has to contain Russian Rubles, US Dollars and Euros.

'''Format of the query:''' ?action=GetCurrencies

'''Parameters:'''

* id – currency identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

The root element '''getCurrenciesResult''' contains an arbitrary number of '''currency''' elements, where each one of them describes the currency with attributes: '''id''' (identifier) and '''name''' (name).

=== Tour Search ===

The tour search method has multiple parameters of search and tour filtration. The method should return only the cheapest deals, filtered out by a specified parameter. The number of returned tours is regulated by the parameter '''count'''.

'''Format of the query:''' ?action=GetTours

'''Parameters:'''

{| class="wikitable"
|Parameter; '''required'''
|Type of Data
|Description
|-
|offerId
|Int64
|Unique identifier of the previously found offer. If specified, all other parameters are unnecessary and should be omitted, as well as the method should return only one entry.
|-
|'''count'''
|Int32
|Maximum number of offers returned by the query.
|-
|'''countryId'''
|Int32
|Country identifier.
|-
|'''departCityId'''
|Int32
|Departure city identifier.
|-
|'''dateFrom'''
|String
|First date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''dateTo'''
|String
|Last date in the range of departure dates presented in the format dd.MM.yyyy, e.g. 31.12.2015.
|-
|'''adults'''
|Int32
|Number of adults.
|-
|'''kids'''
|Int32
|Number of children.
|-
|kidsAges
|String
|Number of full years of age of each child, transmitted as a string, enumeration separated by comma, e.g. 3, 6. Values 0 or 1 have been used to indicate age of infants.
|-
|'''nightsMin'''
|Int32
|Minimum number of nights in the tour.
|-
|'''nightsMax'''
|Int32
|Maximum number of nights in the tour.
|-
|resorts
|String
|Identifiers of the resorts, enumeration separated by comma.
|-
|hotelCategories
|String
|Identifiers of hotel categories, enumeration separated by comma.
|-
|hotels
|String
|Hotel identifiers, enumeration separated by comma.
|-
|meals
|String
|Identifiers of meal options, enumeration separated by comma.
|-
|'''currencyId'''
|Int32
|Currency, which also includes prices, as well as currency for input parameters priceMin and priceMax (if specified).
|-
|priceMin
|Int32
|Minimum price of the tour.
|-
|priceMax
|Int32
|Maximum price of the tour.
|-
|hotelIsNotInStop
|Int32
|If input value equals to 1, the results should not contain any hotels with no places available (hotels with the status «on request» are acceptable).
|-
|ticketsIncluded
|Int32
|If input value equals to 1, the results should contain only the tours, for which the flight fare is included into the total price (option only hotel is unacceptable).
|-
|hasTickets
|Int32
|If input value equals to 1, the results should contain only the tours, for which the tickets are currently available, there should not be flights with no places available or flights with on request status.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T12:36:40Z

Vm: /* Выгрузка списка валют */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Hotels ===

This method returns the list of all available hotels, preferably only those, which actual prices are available through the tour operator.

'''Format of the query:''' ?action=GetHotels

'''Parameters:'''

* id – hotel identifier (optional; if specified, only one entry is queried).

'''The output format:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

The root element '''getHotelsResult''' contains an arbitrary number of '''hotel''' elements, where each one of them describes a hotel with attributes: '''id''' (identifier), '''name''' (name of the hotel), '''hotelCategoryId''' (hotel category identifier) and '''resortId''' (identifier of the resort in which this hotel is located).

=== Returning Meal Options ===

This method returns the list of meal options available, e.g. HB, BB, no meals, etc.

'''Format of the query:''' ?action=GetMeals

'''Parameters:'''

* id – identifier of the meal type (optional; if specified, only one entry is queried)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

The root element '''getMealsResult''' contains an arbitrary number of '''meal''' elements, where each of them describes a meal option with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Currencies ===

This method returns the list of used currencies. At the very least it has to contain Russian Rubles, US Dollars and Euros.

'''Format of the query:''' ?action=GetCurrencies

'''Parameters:'''

* id – currency identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

The root element '''getCurrenciesResult''' contains an arbitrary number of '''currency''' elements, where each one of them describes the currency with attributes: '''id''' (identifier) and '''name''' (name).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T12:33:06Z

Vm: /* Выгрузка видов питания */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Hotels ===

This method returns the list of all available hotels, preferably only those, which actual prices are available through the tour operator.

'''Format of the query:''' ?action=GetHotels

'''Parameters:'''

* id – hotel identifier (optional; if specified, only one entry is queried).

'''The output format:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

The root element '''getHotelsResult''' contains an arbitrary number of '''hotel''' elements, where each one of them describes a hotel with attributes: '''id''' (identifier), '''name''' (name of the hotel), '''hotelCategoryId''' (hotel category identifier) and '''resortId''' (identifier of the resort in which this hotel is located).

=== Returning Meal Options ===

This method returns the list of meal options available, e.g. HB, BB, no meals, etc.

'''Format of the query:''' ?action=GetMeals

'''Parameters:'''

* id – identifier of the meal type (optional; if specified, only one entry is queried)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

The root element '''getMealsResult''' contains an arbitrary number of '''meal''' elements, where each of them describes a meal option with attributes: '''id''' (identifier) and '''name''' (name).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T12:31:35Z

Vm: /* Выгрузка списка отелей */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Returning the List of Hotels ===

This method returns the list of all available hotels, preferably only those, which actual prices are available through the tour operator.

'''Format of the query:''' ?action=GetHotels

'''Parameters:'''

* id – hotel identifier (optional; if specified, only one entry is queried).

'''The output format:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

The root element '''getHotelsResult''' contains an arbitrary number of '''hotel''' elements, where each one of them describes a hotel with attributes: '''id''' (identifier), '''name''' (name of the hotel), '''hotelCategoryId''' (hotel category identifier) and '''resortId''' (identifier of the resort in which this hotel is located).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Подключение туроператоров

2016-01-21T12:28:04Z

Vm: /* Выгрузка списка категорий отелей */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать '''30 секунд'''. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до '''5 секунд'''. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T12:27:22Z

Vm: /* Выгрузка списка категорий отелей */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Returning the List of Hotel Categories ===

This method returns the list of hotel categories, e.g. 3*, 4*, Apts, etc.

'''Format of the query:''' ?action=GetHotelCategories

'''Parameters:'''

* id – hotel category identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

The root element '''getHotelCategoriesResult''' contains an arbitrary number of '''hotelCategory''' elements, where each one of them describes a hotel category with attributes: '''id''' (identifier) and '''name''' (name).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T12:25:52Z

Vm: /* Выгрузка списка курортов */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Returning the List of Resorts ===

This method returns the list of all available resorts.

'''Format of the query:''' ?action=GetResorts

'''Parameters:'''

* id – resort identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

The root element '''getResortsResult''' contains an arbitrary number of '''resort''' elements, where each one of them describes the resort with attributes: '''id''' (resort identifier), '''name''' (name of the resort, language Ru/Eng) and '''countryId''' (identifier of the home country of the resort).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T11:47:21Z

Vm: /* Returning the List of Departure Cities */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T11:46:57Z

Vm: /* Выгрузка списка городов вылета */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Returning the List of Departure Cities ===

The method returns all available cities of departure, and also contains data on what tour destinations are available from each city of departure. SletatRu service calls this method periodically in order to update the list of available destinations from each city of departure.

'''Format of the query:''' ?action=GetDepartCities

'''Parameters:'''

* id – departure city identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

The root element '''getDepartCitiesResult''' contains an arbitrary number of '''city''' elements, where each one of them describes the city of departure with attributes: '''id''' (city identifier) и '''name''' (name of the city, language Ru/Eng). Each '''city''' element also should contain a set of '''countryTo''' elements, where each one of them describes available destination from the city of departure; for '''countryTo''' element, '''id''' attribute (destination country identifier) should be specified.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T11:31:54Z

Vm: /* Returning the List of Countries */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Format of the query:''' ?action=GetCountries

'''Parameters:'''

* id – destination country identifier (optional; if specified, only one entry is queried)

'''The output format:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

The root element '''getCountriesResult''' contains an arbitrary number of elements '''country''', where each one of them describes destination with attributes: '''id''' (destination country identifier) and '''name''' (name of the country, Ru/Eng language).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T11:29:05Z

Vm: /* Реализуемые методы */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Methods to Be Realized ==

The following elements have been specified in the document for each method: purpose of each method, the list of input parameters, the output format, description and the types of data used in the output of the methods.

'''The types of data listed below have been used in the methods:'''

* Int32 – integer (32 bits signed) from 2, 147, 483, 648 to 2, 147, 483, 647
* Int64 – integer (64 bits signed)
* UInt64 – integer (64 bits unsigned)
* String - text

=== Returning the List of Countries ===

This method returns all destinations of the tour operator.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Подключение туроператоров

2016-01-21T11:25:54Z

Vm: /* Дополнительные требования к сервису */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать '''30 секунд'''. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до '''5 секунд'''. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T11:25:34Z

Vm: /* Дополнительные требования к сервису */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Additional Requirements to the Service ==

Maximum time of work with any executed method of service should not exceed '''30 seconds''', the recommended response time (including the tour booking method) is up to '''5 seconds'''. If any method takes longer than 30 seconds to return the results, SletatRu will not process the data.

Any method of the service can be called simultaneously by different threads. Therefore, in realization of the methods, there should not be locks which synchronize access to the methods. The tour booking method must support simultaneous execution of multiple search queries.

The number of queries per day can be determined separately and depends on the following parameters:
* the number and popularity of the tour operator’s destinations
* the number of departure cities
* the number of search queries in SletatRu service.

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T11:13:33Z

Vm: /* Service Description */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

The results should be presented in XML. Described format should be applied for each method in the document.

'''Version''' attribute indicating the version of the protocol should be specified for the root element in the result. The attribute is needed to determine the version of the tour provider with SletatRu service.

Example:
<getCountriesResult version="1.0">
...
</getCountriesResult>

This document describes 1.0 version of the protocol.

All methods should return XML in UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Pool of IP addresses, from which the service SletatRu communicates the realized tour provider, is provided separately. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T10:52:30Z

Vm: /* Актуализация тура */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Подключение туроператоров

2016-01-21T10:52:06Z

Vm: /* Актуализация тура */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2015 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T10:41:07Z

Vm: /* Описание сервиса */

[[Category:Подключение_туроператоров]]
== Service Description ==

In order to integrate with SLETAT.RU you need to create a web service that will perform the following tasks:
* Unload directories: cities of departure, countries, resorts, hotels, etc.
* Implement parameterized price search
* Actualize the selected tour by its ID

'''For simplicity, the service can be made as a web page that accepts GET or POST parameters and returns the answer in XML (not SOAP) format'''

The same address should be used for all methods of the web service. For example, if you implement the service at: http://mysite.com/services/sletatru.xml , then this address must remain the same for all requests.

For example: :
* http://mysite.com/services/sletatru.xml?action=GetCountries – list of countries request
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – list of departure cities request

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Sletat Ru Provider API

2016-01-21T10:29:43Z

Vm: Новая страница: «Category:Подключение_туроператоров == Описание сервиса == Для интеграции со Слетать.ру ну…»

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Подключение туроператоров

2016-01-21T10:15:16Z

Vm: /* Поиск туров */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Подключение туроператоров

2016-01-21T10:14:56Z

Vm: /* Поиск туров */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Подключение туроператоров

2016-01-21T10:01:49Z

Vm: /* Описание сервиса */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут '''version''' с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Заглавная страница

2016-01-20T13:21:51Z

Vm: /* Подключение туроператоров */

__NOTOC__
== Модули поиска туров ==

[[Лицензия]]

=== [[:Category:Модуль поиска туров 5.0|Модуль поиска туров 5.0]] ===

[[Модуль поиска туров 5.0|Описание модуля]]

[[Создание модуля поиска туров 5.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 5.0|Дополнительные настройки]]

=== [[:Category:Модуль поиска туров 4.0|Модуль поиска туров 4.0]] ===
[[Модуль поиска туров 4.0|Описание модуля]]

[[Создание модуля поиска туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 4.0|Дополнительные настройки]]

=== [[:Category:Модуль горящих туров 4.0|Модуль горящих туров 4.0]] ===

[[Модуль горящих туров 4.0|Описание модуля]]

[[Создание модуля горящих туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля горящих туров 4.0|Дополнительные настройки]]

=== [[:Category:Слайдер 4.0|Слайдер 4.0]] ===

[[Слайдер 4.0|Описание модуля]]

[[Создание Слайдера 4.0|Создание модуля]]

[[Дополнительные настройки Слайдера 4.0|Дополнительные настройки]]

=== [[:Category:Настройка модулей в Личном кабинете|Настройка модулей в Личном кабинете]] ===

[[Настройка уведомлений]]

[[Настройка модулей]]

[[Добавление офисов]]

[[Мастер Умных Ссылок]]

[[Статистика]]

[[Быстрый поиск тура по короткому номеру]]

=== [[:Category:Дополнения к модулям поиска|Дополнения]] ===
[[Блок отзывов об отелях]]

== Шлюзы поиска, расширения и дополнения ==
=== [[:Category:Шлюзы поиска туров|Шлюзы поиска туров]] ===
[[Шлюз поиска туров (xml)]]

[[Шлюз поиска туров (json)]]

[[Шлюз поиска горящих туров (json)]]

=== [[:Category:Расширения и дополнения|Расширения и дополнения]] ===
[[Отельная база (xml)]]

[[Аналитика (json)]]

[[Детальная актуализация (xml)]]

[[Суточный кеш (xml)]]

[[Онлайн-оплата (xml)]]

== Система биллинга: подключение и настройка ==
=== [[:Category:Система биллинга|Система биллинга]] ===
[[Начало работы]]

[[Базовые настройки]]

[[Процесс оплаты]]

[[Список заказов]]

[[Ручное создание тура]]

[[Расширенные настройки]]

[[Дизайнер документов]]

=== [[:Category:Подключение платежных провайдеров|Подключение платежных провайдеров]] ===

[[Банк «Русский стандарт» — интеграция]]

[[«Кредит Европа Банк» — интеграция]]

[[«AquiroPay» — интеграция]]

[[«PayOnline» — интеграция]]

[[«Uniteller» — интеграция]]

[[«Payture» — интеграция]]

== Подключение туроператоров ==

=== [[:Category:Подключение_туроператоров|Подключение туроператоров]] ===

[[Подключение_туроператоров]]

Заглавная страница

2016-01-20T13:18:28Z

Vm: /* Подключение_туроператоров */

__NOTOC__
== Модули поиска туров ==

[[Лицензия]]

=== [[:Category:Модуль поиска туров 5.0|Модуль поиска туров 5.0]] ===

[[Модуль поиска туров 5.0|Описание модуля]]

[[Создание модуля поиска туров 5.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 5.0|Дополнительные настройки]]

=== [[:Category:Модуль поиска туров 4.0|Модуль поиска туров 4.0]] ===
[[Модуль поиска туров 4.0|Описание модуля]]

[[Создание модуля поиска туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 4.0|Дополнительные настройки]]

=== [[:Category:Модуль горящих туров 4.0|Модуль горящих туров 4.0]] ===

[[Модуль горящих туров 4.0|Описание модуля]]

[[Создание модуля горящих туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля горящих туров 4.0|Дополнительные настройки]]

=== [[:Category:Слайдер 4.0|Слайдер 4.0]] ===

[[Слайдер 4.0|Описание модуля]]

[[Создание Слайдера 4.0|Создание модуля]]

[[Дополнительные настройки Слайдера 4.0|Дополнительные настройки]]

=== [[:Category:Настройка модулей в Личном кабинете|Настройка модулей в Личном кабинете]] ===

[[Настройка уведомлений]]

[[Настройка модулей]]

[[Добавление офисов]]

[[Мастер Умных Ссылок]]

[[Статистика]]

[[Быстрый поиск тура по короткому номеру]]

=== [[:Category:Дополнения к модулям поиска|Дополнения]] ===
[[Блок отзывов об отелях]]

== Шлюзы поиска, расширения и дополнения ==
=== [[:Category:Шлюзы поиска туров|Шлюзы поиска туров]] ===
[[Шлюз поиска туров (xml)]]

[[Шлюз поиска туров (json)]]

[[Шлюз поиска горящих туров (json)]]

=== [[:Category:Расширения и дополнения|Расширения и дополнения]] ===
[[Отельная база (xml)]]

[[Аналитика (json)]]

[[Детальная актуализация (xml)]]

[[Суточный кеш (xml)]]

[[Онлайн-оплата (xml)]]

== Система биллинга: подключение и настройка ==
=== [[:Category:Система биллинга|Система биллинга]] ===
[[Начало работы]]

[[Базовые настройки]]

[[Процесс оплаты]]

[[Список заказов]]

[[Ручное создание тура]]

[[Расширенные настройки]]

[[Дизайнер документов]]

=== [[:Category:Подключение платежных провайдеров|Подключение платежных провайдеров]] ===

[[Банк «Русский стандарт» — интеграция]]

[[«Кредит Европа Банк» — интеграция]]

[[«AquiroPay» — интеграция]]

[[«PayOnline» — интеграция]]

[[«Uniteller» — интеграция]]

[[«Payture» — интеграция]]

== Подключение туроператоров ==

=== [[:Category:Подключение_туроператоров|Подключение туроператоров]] ===

Заглавная страница

2016-01-20T13:18:21Z

Vm: /* Подключение туроператоров */

__NOTOC__
== Модули поиска туров ==

[[Лицензия]]

=== [[:Category:Модуль поиска туров 5.0|Модуль поиска туров 5.0]] ===

[[Модуль поиска туров 5.0|Описание модуля]]

[[Создание модуля поиска туров 5.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 5.0|Дополнительные настройки]]

=== [[:Category:Модуль поиска туров 4.0|Модуль поиска туров 4.0]] ===
[[Модуль поиска туров 4.0|Описание модуля]]

[[Создание модуля поиска туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля поиска туров 4.0|Дополнительные настройки]]

=== [[:Category:Модуль горящих туров 4.0|Модуль горящих туров 4.0]] ===

[[Модуль горящих туров 4.0|Описание модуля]]

[[Создание модуля горящих туров 4.0|Создание модуля]]

[[Дополнительные настройки модуля горящих туров 4.0|Дополнительные настройки]]

=== [[:Category:Слайдер 4.0|Слайдер 4.0]] ===

[[Слайдер 4.0|Описание модуля]]

[[Создание Слайдера 4.0|Создание модуля]]

[[Дополнительные настройки Слайдера 4.0|Дополнительные настройки]]

=== [[:Category:Настройка модулей в Личном кабинете|Настройка модулей в Личном кабинете]] ===

[[Настройка уведомлений]]

[[Настройка модулей]]

[[Добавление офисов]]

[[Мастер Умных Ссылок]]

[[Статистика]]

[[Быстрый поиск тура по короткому номеру]]

=== [[:Category:Дополнения к модулям поиска|Дополнения]] ===
[[Блок отзывов об отелях]]

== Шлюзы поиска, расширения и дополнения ==
=== [[:Category:Шлюзы поиска туров|Шлюзы поиска туров]] ===
[[Шлюз поиска туров (xml)]]

[[Шлюз поиска туров (json)]]

[[Шлюз поиска горящих туров (json)]]

=== [[:Category:Расширения и дополнения|Расширения и дополнения]] ===
[[Отельная база (xml)]]

[[Аналитика (json)]]

[[Детальная актуализация (xml)]]

[[Суточный кеш (xml)]]

[[Онлайн-оплата (xml)]]

== Система биллинга: подключение и настройка ==
=== [[:Category:Система биллинга|Система биллинга]] ===
[[Начало работы]]

[[Базовые настройки]]

[[Процесс оплаты]]

[[Список заказов]]

[[Ручное создание тура]]

[[Расширенные настройки]]

[[Дизайнер документов]]

=== [[:Category:Подключение платежных провайдеров|Подключение платежных провайдеров]] ===

[[Банк «Русский стандарт» — интеграция]]

[[«Кредит Европа Банк» — интеграция]]

[[«AquiroPay» — интеграция]]

[[«PayOnline» — интеграция]]

[[«Uniteller» — интеграция]]

[[«Payture» — интеграция]]

== Подключение туроператоров ==

=== [[:Category:Подключение_туроператоров|Подключение_туроператоров]] ===

Категория:Подключение туроператоров

2016-01-20T13:17:14Z

Vm: Полностью удалено содержимое страницы

Подключение туроператоров

2016-01-20T13:13:55Z

Vm: /* Актуализация тура */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут version с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Элемент '''actualizedTour''' может содержать секцию '''services''', которая в свою очередь содержит произвольное число элементов '''service'''. Каждый элемент '''service''' описывает услугу включенную в стоимость тура, либо услугу, добавление которой возможно в текущей конфигурации тура. Атрибуты элемента '''service''':

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''id'''
|Идентификатор услуги, уникальный в рамках данного предложения.
|-
|'''type'''
|Тип услуги. Может принимать одно из следующих значений:
* “Insurance” – страховка;
* “DptTransport” – перелет туда;
* “RtnTransport” – перелет обратно;
* “AdditionalService ” – дополнительная услуга;
* “AdditionalMeal” – дополнительное питание;
* “Transfer” – трансфер;
* “Excursion” – экскурсия;
* “Charge” – доплата;
* “Visa” – виза;
* “NoGoGuarantee” – страховка от невыезда;
|-
|'''name'''
|Наименование услуги.
|-
|'''isIncluded'''
|Включена ли данная услуга в стоимость текущей конфигурации тура, допустимы значения: 0 – не включена, 1 – включена.
|-
|description
|Описание услуги в произвольной форме.
|-
|surcharge
|Доплата за включение услуги в стоимость тура. Применяется только для услуг, не включенных в стоимость текущей конфигурации тура.
|-
|flightCompatibleIds
|Совместимые перелеты. Идентификаторы услуг перелетов, представленных в секции services, которые могут применяться совместно с текущей услугой перелета. Для перелета туда заполняется id перелетов обратно и наоборот. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightClass
|Класс перелета. Может принимать одно из следующих значений:
* “ECONOM” – эконом;
* “BUSINESS” – бизнес;
Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAvailability
|Наличие билетов, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightPlacesCount
|Количество оставшихся билетов. Заполняется, если количество билетов мало. Если кол-во билетов известно – заполняется этим числом, иначе значением -1. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportFrom
|Аэропорт отправления. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: SVO C). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirportTo
|Аэропорт прибытия. Значение должно начинаться с кода IATA, за которым может следовать дополнительная информация, например о терминале (пример: AYT 1). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightNum
|Рейс (например UN 7422). Применяется и является обязательным только для услуг типа DptTransport и RtnTransport.
|-
|flightAirline
|Авиакомпания. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightStartDateTime
|Дата и время вылета в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightEndDateTime
|Дата и время прибытия в формате dd.MM.yyyy HH:mm (пример: 31.12.2012 14:30). Применяется только для услуг типа DptTransport и RtnTransport.
|-
|flightAircraft
|Информация о воздушном судне. Применяется только для услуг типа DptTransport и RtnTransport.
|-
|}

Подключение туроператоров

2016-01-20T13:03:23Z

Vm: /* Актуализация тура */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут version с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>

Корневой элемент '''actualizeTourResult''' должен содержать единственный элемент '''actualizedTour''', который описывается следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''price'''
|Актуализированная цена тура в валюте, которая была указана во входном параметре '''currencyId'''
|-
|'''ticketsIsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур)
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsDpt
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewEconomTicketsRtn
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsDpt
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|fewBusinessTicketsRtn
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное кол-во оставшихся мест, то заполняется значением -1, иначе указывается точное кол-во оставшихся мест.
|-
|tourUrl
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|}

Подключение туроператоров

2016-01-20T12:54:04Z

Vm: /* Актуализация тура */

[[Category:Подключение_туроператоров]]
== Описание сервиса ==

Для интеграции со Слетать.ру нужно создать веб-сервис, который будет выполнять следующие задачи:
* Выгружать справочники: города вылета, страны, курорты, отели и т.д.
* Осуществлять параметризованный поиск цен
* Актуализировать выбранный тур по его идентификатору

'''Для упрощения, сервис можно представить веб-страничкой, которая принимает GET или POST параметры и выдаёт ответ в формате XML (не SOAP).'''

Для всех методов сервиса должен использоваться один адрес. Например, если вы реализуете сервис по адресу: http://mysite.com/services/sletatru.xml , то этот адрес должен быть общим для всех запросов.

Примеры:
* http://mysite.com/services/sletatru.xml?action=GetCountries – запрос списка стран
* http://mysite.com/services/sletatru.xml?action=GetDepartCities – запрос списка городов вылета

Выдача результатов должна быть в формате XML, для каждого метода описан формат.

Для корневого элемента в результате должен быть указан атрибут version с указанием версии протокола. Атрибут нужен для определения версии провайдера туров сервисом Слетать.ру.

Пример:
<getCountriesResult version="1.0">
...
</getCountriesResult>
Данный документ описывает версию прокола 1.0.

Все методы должны возвращать XML в кодировке UTF-8.

Все параметры запросов, не помеченные как обязательные, являются необязательными только для стороны, формирующей запрос. '''Для серверной стороны обработка всех полученных параметров запроса обязательна.'''

Результат выполнения запросов (поискового в частности) должен строго соответствовать указанным параметрам. Если параметр не обязателен и не указан, запрос его не учитывает и возвращает все варианты.

Пул IP адресов, с которых сервис Слетать.ру будет обращаться к реализуемому провайдеру туров уточняется отдельно. Для его уточнения необходимо написать на support@sletat.ru

== Дополнительные требования к сервису ==

Максимально допустимое время при работе с любым методом сервиса не должно превышать 30 секунд. Рекомендуемая скорость ответов (в том числе для метода выдачи туров) до 5 секунд. Если какой-либо метод вернёт результат за период более 30 секунд, то сервис Слетать.ру не обработает эти данные.

Любой метод реализуемого сервиса может быть вызван одновременно различными потоками. Поэтому в реализации методов не должно быть блокировок, синхронизирующих доступ к методам. Метод выдачи туров должен поддерживать параллельное выполнение нескольких поисковых запросов.

Количество запросов в сутки к реализуемому сервису уточняется отдельно и зависит от следующих параметров:
* количества и популярности направлений туроператора
* количества городов вылета
* количества поисковых запросов в сервисе Слетать.ру

== Реализуемые методы ==

Для каждого метода указано назначение, список входящих параметров, формат выдачи, а также описание и типы данных в выдаче методов.

'''В методах используются следующие типы данных:'''

* Int32 – целое число (32 бита со знаком) от 2, 147, 483, 648 до 2, 147, 483, 647
* Int64 – целое число (64 бита со знаком)
* UInt64 – целое число (64 бита без знака)
* String - строка

=== Выгрузка списка стран ===

Метод производит выгрузку всех направлений туроператора.

'''Формат запроса:''' ?action=GetCountries

'''Параметры:'''

* id – идентификатор страны (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCountriesResult version="1.0">
<country id="{Int32}" name="{String}" />
...
</getCountriesResult>

Корневой элемент '''getCountriesResult''' содержит произвольное количество элементов '''country''', каждый из которых описывает направление атрибутами '''id''' (идентификатор страны) и '''name''' (название страны, язык рус/анг).

=== Выгрузка списка городов вылета ===

Метод производит выгрузку всех доступных городов вылета, а также содержит данные о том, какие направления доступны из каждого города вылета. Сервис Слетать.ру периодически обращается к данному методу для обновления данных о доступных направлениях для каждого города вылета у туроператора.

'''Формат запроса:''' ?action=GetDepartCities

'''Параметры:'''

* id – идентификатор города вылета (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getDepartCitiesResult version="1.0">
<city id="{Int32}" name="{String}">
<countryTo id="{Int32}" />
...
</city>...
</getDepartCitiesResult>

Корневой элемент '''getDepartCitiesResult''' содержит произвольное количество элементов '''city''', каждый из которых описывает город вылета атрибутами '''id''' (идентификатор города) и '''name''' (название города, язык рус/анг). Каждый элемент '''city''' также должен содержать набор элементов '''countryTo''', каждый из которых описывает доступное направление из города вылета. Для элемента '''countryTo''' указывается атрибут '''id''' с идентификатором страны.

=== Выгрузка списка курортов ===

Метод возвращает список всех доступных курортов.

'''Формат запроса:''' ?action=GetResorts

'''Параметры:'''

* id – идентификатор курорта (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getResortsResult version="1.0">
<resort id="{Int32}" name="{String}" countryId="{Int32}" />
...
</getResortsResult>

Корневой элемент '''getResortsResult''' содержит произвольное количество элементов '''resort''', каждый из которых описывает курорт атрибутами '''id''' (идентификатор курорта), '''name''' (название курорта, язык рус/анг) и '''countryId''' (идентификатор страны в котором расположен курорт).

=== Выгрузка списка категорий отелей ===

Метод возвращает список категорий отелей (примеры: 3*, 4*, Apts и т.д.).

'''Формат запроса:''' ?action=GetHotelCategories

'''Параметры:'''

* id – идентификатор категории отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelCategoriesResult version="1.0">
<hotelCategory id="{Int32}" name="{String}" />
...
</getHotelCategoriesResult>

Корневой элемент '''getHotelCategoriesResult''' содержит произвольное количество элементов '''hotelCategory''', каждый из которых описывает категорию отеля атрибутами '''id''' (идентификар) и '''name''' (название).

=== Выгрузка списка отелей ===

Метод возвращает список всех доступных отелей. В данном методе желательно возвращать только те отели, по которым в базе туроператора есть актуальные цены.

'''Формат запроса:''' ?action=GetHotels

'''Параметры:'''

* id – идентификатор отеля (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getHotelsResult version="1.0">
<hotel id="{Int32}" name="{String}" hotelCategoryId="{Int32}" resortId="{Int32}" />
...
</getHotelsResult>

Корневой элемент '''getHotelsResult''' содержит произвольное количество элементов '''hotel''', каждый из которых описывает отель атрибутами '''id''' (идентификатор), '''name''' (название отеля), '''hotelCategoryId''' (идентификатор категории отеля) и '''resortId''' (идентификатор курорта в котором расположен отель).

=== Выгрузка видов питания ===

Метод возвращает список видов питания (примеры: HB, BB, без питания и т.д.).

'''Формат запроса:''' ?action=GetMeals

'''Параметры:'''

* id – идентификатор вида питания (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getMealsResult version="1.0">
<meal id="{Int32}" name="{String}" />
...
</getMealsResult>

Корневой элемент '''getMealsResult''' содержит произвольное количество элементов '''meal''', каждый из которых описывает вид питания атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Выгрузка списка валют ===

Метод возвращает список используемых валют. Список обязательно должен содержать рубли, доллары и евро.

'''Формат запроса:''' ?action=GetCurrencies

'''Параметры:'''

* id – идентификатор валюты (опциональный; если указан, то запрашивается только одна запись)

'''Формат выдачи:'''

<getCurrenciesResult version="1.0">
<currency id="{Int32}" name="{String}" />
...
</getCurrenciesResult>

Корневой элемент '''getCurrenciesResult''' содержит произвольное количество элементов '''currency''', каждый из которых описывает валюту атрибутами '''id''' (идентификатор) и '''name''' (название).

=== Поиск туров ===

Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод лишь должен возвращать наиболее дешевые предложения, найденные по предоставленным параметрам. Количество туров в выдаче регулируется параметром '''count'''.

'''Формат запроса:''' ?action=GetTours

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|offerId
|Int64
|Уникальный идентификатор ранее найденного предложения. В случае, если данный параметр задан, все остальные параметры не обязательны и не должны приниматься в расчет. Метод должен возвращать одну запись.
|-
|'''count'''
|Int32
|Максимальное количество предложений в выдаче.
|-
|'''countryId'''
|Int32
|Идентификатор страны.
|-
|'''departCityId'''
|Int32
|Идентификатор города вылета.
|-
|'''dateFrom'''
|String
|Начальная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''dateTo'''
|String
|Конечная дата в диапазоне дат вылета в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''adults'''
|Int32
|Количество взрослых.
|-
|'''kids'''
|Int32
|Количество детей.
|-
|kidsAges
|String
|Количество полных лет каждому ребёнку. Передаётся в виде строки, перечисление через запятую (пример: 3,6). Значения 0 или 1 используются для обозначения инфантов.
|-
|'''nightsMin'''
|Int32
|Минимальное количество ночей в туре.
|-
|'''nightsMax'''
|Int32
|Максимальное количество ночей в туре.
|-
|resorts
|String
|Идентификаторы курортов, перечисление через запятую.
|-
|hotelCategories
|String
|Идентификаторы категорий отелей, перечисление через запятую.
|-
|hotels
|String
|Идентификаторы отелей, перечисление через запятую.
|-
|meals
|String
|Идентификаторы видов питания, перечисление через запятую.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должны быть выданы цены, а также валюта для входящих параметров priceMin и priceMax (если они есть).
|-
|priceMin
|Int32
|Цена тура от.
|-
|priceMax
|Int32
|Цена тура до.
|-
|hotelIsNotInStop
|Int32
|При значении "1" - в результатах не должно быть отелей в стопе (отели со статусом «под запрос» допустимы). При значении "0" в результат должны попадать как отели в стопе, так и отели с наличием мест и с местами по запросу.
|-
|ticketsIncluded
|Int32
|При значении "1" в результатах должны быть только туры с включенной стоимостью перелёта («только отель» - недопустимы). При значении "0" в результат должны попадать как туры без перелета, так и туры с перелетом.
|-
|hasTickets
|Int32
|При значении "1" в результатах должны быть туры только с реальным наличием билетов в перелёте. Не должно быть туров со стопом на перелёте, перелёты со статусом «под запрос» недопустимы. При значении "0" в результат должны попадать как туры без билетов на рейс, так и туры с наличием билетов и с билетами по запросу.
|-
|excludeUsualTours
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся обычными турами (не являющиеся комбинированными, экскурсионными или шоп-турами). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeCombined
|Int32
|При значении "1" из результатов должны быть исключены туры, являющиеся комбинированными (в рамках которых турист посещает несколько курортов). При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeShopTours
|Int32
|При значении "1" из результатов должны быть исключены шоп-туры и туры с обязательствами. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|excludeExcursionTours
|Int32
|При значении "1" из результатов должны быть исключены экскурсионные туры. При значении "0" или отсутствии данного параметра, такие туры должны быть включены в результат.
|-
|}

'''Формат выдачи:'''

<getToursResult version="1.0">
<tour
offerId="{Int64}"
tourName="{String}"
hotelId="{Int32}"
hotelUrl="{String}"
resortId="{Int32}"
hotelCategoryId="{Int32}"
mealId="{Int32}"
htPlaceName="{String}"
roomTypeName="{String}"
tourDate="{String}"
nights="{Int32}"
price="{Int32}"
hotelIsInStop="{Int32}"
ticketsIncluded="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
spoUrl="{String}"
fewPlacesInHotel="{Int32}"
fewTicketsDptY="{Int32}"
fewTicketsRtnY="{Int32}"
fewTicketsDptB="{Int32}"
fewTicketsRtnB="{Int32}"
flags="{UInt64}"
description="{String}"
receivingParty="{String}"
earlyBookingValidTill="{String}"
/>
...
</getToursResult>

Корневой элемент '''getToursResult''' содержит произвольное количество элементов '''tour''' (от 0 элементов, но не более количества указанного в параметре '''count'''), каждый из которых описывает тур следующими атрибутами:

{| class="wikitable"
|Параметр; '''обязательный'''
|Описание
|-
|'''offerId'''
|Уникальный идентификатор предложения, по которому в дальнейшем можно провести актуализацию тура или бронирование.
|-
|'''tourName'''
|Произвольное название тура.
|-
|'''hotelId'''
|Идентификатор отеля.
|-
|hotelUrl
|Ссылка на страницу с описанием отеля.
|-
|'''resortId'''
|Идентификатор курорта, в котором расположен отель.
|-
|'''hotelCategoryId'''
|Идентификатор категории отеля.
|-
|'''mealId'''
|Идентификатор вида питания.
|-
|'''htPlaceName'''
|Произвольное название размещения в номере (примеры: DBL, TRP, 2 ADL + 1 CH (212), 2 ADL + INF). Название должно отображать допустимые возрасты детей (если поиск был с указанием количества детей более 0) или то, что размещение с учетом инфанта (+ INF), в соответствующем случае.
|-
|roomTypeName
|Название типа номера (примеры: standard, deluxe, family, deluxe super ocean view).
|-
|'''tourDate'''
|Дата начала тура в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|tourEndDate
|Дата окончания тура (дата прилета) в формате dd.MM.yyyy (пример: 31.12.2015).
|-
|'''nights'''
|Количество ночей в туре.
|-
|'''price'''
|Цена тура в валюте, которая была указана во входном параметре '''currencyId'''.
|-
|'''hotelIsInStop'''
|Наличие мест в отеле, допустимы значения: 0 – есть места, 1 – нет мест, 2 – запрос.
|-
|'''ticketsIncluded'''
|Включена ли стоимость билетов в стоимость тура, допустимы значения: 0 – не включена (тур только отель), 1 – включена (пакетный тур).
|-
|'''hasEconomTicketsDpt'''
|Наличие билетов эконом класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasEconomTicketsRtn'''
|Наличие обратных билетов эконом класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsDpt'''
|Наличие билетов бизнес класса на место отдыха, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''hasBusinessTicketsRtn'''
|Наличие обратных билетов бизнес класса, допустимы значения: 0 – нет мест, 1 есть места, 2 – запрос. При значении атрибута ticketsIncluded = 0 значение данного параметра будет проигнорировано.
|-
|'''tourUrl'''
|Ссылка, при переходе по которой можно забронировать тур (ссылка может вести на страницу авторизации, но после авторизации должны автоматически попасть на страницу бронирования тура).
|-
|spoUrl
|Ссылка на описание тура, его программы (если есть).
|-
|fewPlacesInHotel
|Поле заполняется, если есть указание на то, что мест в отеле мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptY
|Поле заполняется, если есть указание на то, что мест эконом класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnY
|Поле заполняется, если есть указание на то, что мест эконом класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsDptB
|Поле заполняется, если есть указание на то, что мест бизнес класса туда мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|fewTicketsRtnB
|Поле заполняется, если есть указание на то, что мест бизнес класса обратно мало. Если нельзя указать точное количество оставшихся мест, то заполняется значением -1, иначе указывается точное количество оставшихся мест.
|-
|flags
|Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура туристу подарок;
* 1024 – тур является комбинированным (турист посещает несколько курортов);
* 2048 – тур с обязательством (шоп - тур);
* 4096 – зарезервировано для использования системой;
* 8192 – экскурсионный тур;
|-
|description
|Дополнительная информация по туру, например, для комбинированных туров может содержать информацию о проживании в отелях.
|-
|receivingParty
|Принимающая сторона.
|-
|earlyBookingValidTill
|Если тур является туром раннего бронирования и известна последняя дата ранней брони, то в данном поле должна быть указана эта дата.
|-
|}

=== Актуализация тура ===

Метод служит для получения окончательной цены тура (со всеми обязательными доплатами и сборами), списка включенных в стоимость тура услуг, а также вариантов перелета, возможных дополнительных услуг и доплат по ним. Метод должен возвращать цену самой дешевой конфигурации запрашиваемого предложения. Для корректной работы метода необходимо, чтобы '''offerId''' был уникален для предложений с разным составом группы туристов, даже в случае если все прочие параметры предложений совпадают.

'''Формат запроса:''' ?action=ActualizeTour

'''Параметры:'''

{| class="wikitable"
|Параметр; '''обязательный'''
|Тип данных
|Описание
|-
|'''offerId'''
|Int64
|Уникальный идентификатор ранее найденного предложения.
|-
|'''currencyId'''
|Int32
|Валюта, в которой должна быть рассчитана цена и доплаты.
|-
|}

'''Формат выдачи:'''

<actualizeTourResult version="1.0">
<actualizedTour
price="{Int32}"
ticketsIsIncluded="{Int32}"
hotelIsInStop="{Int32}"
hasEconomTicketsDpt="{Int32}"
hasEconomTicketsRtn="{Int32}"
hasBusinessTicketsDpt="{Int32}"
hasBusinessTicketsRtn="{Int32}"
fewPlacesInHotel="{Int32}"
fewEconomTicketsDpt="{Int32}"
fewEconomTicketsRtn="{Int32}"
fewBusinessTicketsDpt="{Int32}"
fewBusinessTicketsRtn="{Int32}"
tourUrl="{String}"
>
<services>
<service
id="{Int32}"
type="{String}"
name="{String}"
isIncluded="{Int32}"
description="{String}"
surcharge="{Int32}"
flightCompatibleIds="{String}"
flightClass="{String}"
flightAvailability="{Int32}"
flightPlacesCount="{Int32}"
flightAirportFrom="{String}"
flightAirportTo="{String}"
flightNum="{String}"
flightAirline="{String}"
flightStartDateTime="{String}"
flightEndDateTime="{String}"
flightAircraft="{String}"
/>
...
</services>
</actualizedTour>
</actualizeTourResult>