Просмотр исходного текста страницы Шлюз поиска туров (xml) - устарел

[[Category:Шлюзы поиска туров]]
== Описание сервиса ==
API поиска туров позволит вам создать собственную туристическую поисковую систему. Используя методы этого сервиса, вы сможете:
* Загружать справочники городов вылета, стран, курортов, отелей, категорий отелей, видов питания, туроператоров;
* Искать продукты более чем 130 крупнейших туроператоров России.
* Настроить автоматическое SMS- и email-оповещение менеджеров о заказах.

{| class="standard sWarning"
|Внимание! На момент написания настоящего руководства функция онлайн бронирования сервисом не предусмотрена.
|}

{| class="standard sWarning"
|Внимание! Доступ к данным отдельных операторов может быть ограничен лицензией. По всем вопросам, пожалуйста, обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru.
|}

Это стандартный веб-сервис, предоставляющий WSDL-документ с описанием всех методов и типов данных. Версия, выпущенная на момент написания настоящего руководства, работает только по протоколу HTTP/2+TLS/1.2. Для большей совместимости с различными клиентами сервис основан на SOAP версии 1.1.

Взаимодействие с сервисом возможно одним из двух способов: 
* Как с обычным веб-сервисом посредством SOAP-запросов, WSDL доступен. 
* Как с сервисом WCF (Windows Communication Foundation) – самый простой способ, если клиент под .NET Framework 3.5 или выше.

Логика обработки запросов не зависит от способа работы с сервисом. 

При передаче строк и XML-пакетов используется кодировка UTF-8. 

Работа сервиса не требует сессий, и методы не зависят друг от друга с точки зрения очередности вызова. Таким образом, очередность вызова методов диктуется реализуемым алгоритмом работы с поисковым сервисом.

{| class="standard sWarning"
|Внимание! Сервис требует авторизации. Для работы используйте логин и пароль от личного кабинета на сайте sletat.ru.
|}

{| class="standard sWarning"
|Внимание! Работа с поисковым запросом (создание, запрос состояния и загрузка туров) должна выполняться с одного IP-адреса. При выполнении этого условия взаимодействие с сервисом возможно с нескольких IP адресов. 
|}

== Подключение к сервису ==
Чтобы начать работу с сервисом, зарегистрируйтесь на сайте sletat.ru и получите тестовую лицензию, обратившись по электронной почте info@sletat.ru. После получения лицензии можно начинать работать с API.
 
Для работы с сервисом используйте WSDL-документ, расположенный по адресу:
 https://module.sletat.ru/XmlGate.svc?singlewsdl

Современные среды разработки позволяют автоматически создавать все необходимые классы, используя WSDL-документ. Это избавляет разработчика от необходимости работать с SOAP-конвертами вручную.

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

=== Старый клиент на .NET 1.0 - 2.0 ===
Добавьте в проект ссылку на WSDL документ, используя Web Reference. После добавления ссылки ваш проект готов к работе с сервисом. Ниже приведен пример вызова метода для получения списка городов вылета: 

<source lang="csharp">

using System; using WebClient.Gate; 
 
namespace WebClient 
{ 
    class Program 
    { 
        static void Main() 
        { 
            // создаём экземпляр обёртки для работы с поисковым сервисом 
            using (var gate = new Soap11Gate()) 
            { 
                // указываем данные для авторизации на сервисе 
                gate.AuthInfo = new AuthData() { Login = "********", Password = "********" };  
                // далее нам доступен вызов любых методов сервиса 
                var cities = gate.GetDepartCities(); 
            } 
        } 
    } 
} 

</source>

Не забудьте указать логин и пароль вашей учетной записи на сайте sletat.ru. Данные авторизации передаются первым параметром для всех методов сервиса.

=== Клиент на .NET 3.5 или выше ===
Добавьте в проект ссылку на WSDL-документ, используя Service Reference. После добавления ссылки ваш проект готов к работе с сервисом, ниже приведен пример вызова метода для получения списка городов вылета:

<source lang="csharp">

using System; using WcfClient.Gate; 
 
namespace WcfClient 
 { 
    class Program 
    { 
        static void Main() 
        { 
            // создаём экземпляр обёртки для работы с поисковым сервисом 
            using (var gate = new Soap11GateClient()) 
            { 
                // указываем данные для авторизации на сервисе 
                var authInfo = new AuthData() { Login = "********", Password = "********" }; 
                // далее нам доступен вызов любых методов сервиса 
                var cities = gate.GetDepartCities(authInfo); 
            } 
        } 
    } 
}

</source>

Не забудьте указать логин и пароль вашей учетной записи на сайте sletat.ru. Данные авторизации передаются первым параметром для всех методов сервиса.

== Версионность ==
Сервис может содержать несколько контрактов. Каждое изменение, несовместимое с предыдущей, публикацией будет вести к созданию контракта новой версии. Описание контрактов всех поддерживаемых версий включено в WSDL.

Каждый контракт веб-сервиса имеет уникальное имя, используемое для его идентификации. В имени любым удобным образом указывается его версия (например, в виде даты публикации). Для обозначения имени контракта используется URN (Uniform Resource Name).
 
Версия, выпущенная на момент написания настоящего руководства, состоит из одного контракта, использующего следующее имя:
 urn:SletatRu:Soap11Gate:v1

Все разрабатываемые сервисы имеют префикс SletatRu, после которого указывается название контракта и его версия. Следующие версии контракта Soap11Gate будут иметь другое значение версии в последней части URN. Например:

 urn:SletatRu:Soap11Gate:v2

Чтобы использовать нужную версию контракта, укажите её номер в SOAP конверте:
<source lang="xml">

<soap:Envelope> 
  <soap:Body> 
    <GetDepartCities xmlns="urn:SletatRu:Soap11Gate:v1"> 
      ... 
    </GetProductKeys> 
  </soap:Body> 
</soap:Envelope>

</source>

Если вы используете автоматически создаваемую обёртку, то при изменении текущего контракта или создании контракта новой версии заново создайте обёртку к поисковому сервису.

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

Версионность также соблюдается для всех типов данных. 

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

== Логика работы с сервисом ==
Метод поиска туров '''[[#CreateRequest | CreateRequest]]''' использует идентификаторы городов вылета, стран, отелей и т.д., поэтому сначала нужно загрузить все соответствующие справочники, используя методы: 
* '''[[#GetDepartCities | GetDepartCities]]''' – список городов вылета;
* '''[[#GetCountries | GetCountries]]''' – список доступных стран;
* '''[[#GetCities | GetCities]]''' – список курортов;
* '''[[#GetHotelStars | GetHotelStars]]''' – список категорий отелей;
* '''[[#GetMeals | GetMeals]]''' – список типов питания;
* '''[[#GetHotels | GetHotels]]''' – список отелей;
* '''[[#GetTourOperators | GetTourOperators]]''' – список туроператоров.
* '''[[#GetTourDates | GetTourDates]]''' – список дат вылета для выбранного города.

После того как все справочники загружены и отображены пользователю, можно приступать к поиску туров. Для этого используются следующие методы:

* '''[[#CreateRequest | CreateRequest]]''' – создание поискового запроса;
* '''[[#GetRequestState | GetRequestState]]''' – получение данных о статусе загрузки туров для каждого туроператора;
* '''[[#GetRequestResult | GetRequestResult]]''' – возвращает результаты поиска;
* '''[[#ContinueSearch | ContinueSearch]]''' – продолжает поиск с использованием данных указанного запроса среди предложений с более высокой ценой.

Сервис производит асинхронный поиск туров. После получения ответа от метода '''[[#CreateRequest | CreateRequest]]''' (обычно не более секунды) нужно отслеживать состояние поискового запроса, поскольку туроператоры отдают данные за разное время – от 1 секунды до 2 минут. 

В ответе '''[[#CreateRequest | CreateRequest]]''' приходит идентификатор созданного поискового запроса, который в дальнейшем используется для отслеживания состояния поискового запроса методом '''[[#GetRequestState | GetRequestState]]''' и получения результатов поиска методом '''[[#GetRequestResult | GetRequestResult]]'''. 

Логика работы с сервисом зависит от того, нужно ли вам получать данные до полного завершения поискового запроса. Возможны два варианта – единовременное получение полной поисковой выдачи и получение данных о турах по мере их поступления.

=== Получение полного набора туров ===
# Создаётся поисковый запрос методом '''[[#CreateRequest | CreateRequest]]'''. Сохраняется идентификатор запроса, полученный в ответе.
# Создаётся цикл для получения статуса поискового запроса. В цикле вызывается метод '''[[#GetRequestState | GetRequestState]]''' с использованием идентификатора запроса. В итерации цикла обязательно должна быть пауза (рекомендованное минимальное значение – 1,5 секунды). В результате вызова '''[[#GetRequestState | GetRequestState]]''' проверяется, все ли туроператоры обработали запрос (т.е. значение поля IsProcessed = “true”). На основе проверки принимается решение о продолжении цикла или (если все туроператоры обработали запрос) о переходе к методу получения туров.
# Вызывается метод '''GetRequestResult''' с использованием идентификатора, полученного в ответе метода '''[[#CreateRequest | CreateRequest]]'''. Метод вернет все найденные туры в рам-ках поискового запроса.

{| class="standard sWarning"
|Внимание! Сервер не хранит результаты поискового запроса продолжительное время. Данные должны быть получены и сохранены локально.
|}

{| class="standard sWarning"
|Внимание! В цикле получения статуса поискового запроса должен быть внутренний таймаут, чтобы ни при каких обстоятельствах не могли возникнуть бесконечные циклы.
|}

=== Получение данных по мере их поступления ===
# Создаётся поисковый запрос методом '''[[#CreateRequest | CreateRequest]]'''. Сохраняется полученный идентификатор. 
# Создаётся цикл для получения статуса поискового запроса. В цикле вызывается метод [[#GetRequestState | GetRequestState]] с использованием идентификатора запроса. В итерации цикла обязательно должна быть пауза (рекомендованное минимальное значе-ние – 1,5 секунды). В результате вызова '''[[#GetRequestState | GetRequestState]]''' проверяется, есть ли найденные туры по поисковому запросу (т.е. как минимум один туроператор имеет значение поля '''RowsCount''' более нуля). Если найденных туров нет и не все туроператоры обработали запрос, цикл повторяется; если хотя бы один туропе-ратор сообщил о наличии туров, можно перейти к методу получения туров. 
# Вызывается метод '''[[#GetRequestResult | GetRequestResult]]''' с использованием идентификатора запроса. Метод вернет все туры, найденные на момент вызова, а также состояние обра-ботки поискового запроса (аналогично методу '''[[#GetRequestState | GetRequestState]]'''). Состояние обра-ботки поискового запроса сохраняется, а найденные туры отображаются поль-зователю. 
# Создаётся новый цикл, который работает до тех пор, пока все туроператоры не обработают запрос. В цикле вызывается метод '''[[#GetRequestState | GetRequestState]]''' с использованием идентификатора запроса. В итерации цикла обязательно должна быть пауза (рекомендованное минимальное значение – 1,5 секунды). Результат вызова '''[[#GetRequestState | GetRequestState]]''' сравнивается с сохранённым состоянием обработки запроса. Если результат сравнения показывает наличие новых туров, то пользователь уведомляется о новых найденных турах. Если пользователь хочет обновить результат, то необходимо повторить действия, описанные в п. 3. Если для всех туропе-раторов значение поля '''IsProcessed = “true”''', то цикл завершается, и пользователь получает уведомление об окончании поиска. 

{| class="standard sWarning"
|Внимание! Сервер не хранит результаты поискового запроса продолжительное время. Данные должны быть получены и сохранены локально.
|}

{| class="standard sWarning"
|Внимание! В цикле получения статуса поискового запроса должен быть внутренний таймаут, чтобы ни при каких обстоятельствах не могли возникнуть бесконечные циклы.
|}

=== Актуализация и сохранение данных ===
После того, как пользователь выбрал понравившийся тур, необходимо актуализировать данные с помощью метода '''[[#ActualizePrice |ActualizePrice]]'''. Метод возвращает не только наиболее актуальную информацию по туру, но и его подробное описание (на момент написания настоящего руководства функция реализована не для всех туроператоров).

Последний шаг – вызов метода '''[[#SaveTourOrder | SaveTourOrder]]''', который сохраняет информацию о заказе в системе sletat.ru и позволяет использовать средства оповещения для информирования ваших менеджеров о новом заказе. На момент написания настоящего руководства в личном кабинете на сайте sletat.ru можно настроить оповещения по электронной почте и SMS. Также доступна утилита SletatRu Agent для Windows, которая уведомляет обо всех новых заказах.

== Методы ==
В этом разделе описаны все методы поискового сервиса, приведены примеры запросов и ответов в SOAP. 

Все используемые методы требуют авторизации. Данные авторизации (логин и пароль от личного кабинета на сайте sletat.ru) передаются в заголовке SOAP:

<source lang="xml">

<soap:Envelope 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"  
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
>
  <soap:Header> 
    <AuthInfo 
      xmlns="urn:SletatRu:DataTypes:AuthData:v1"
    > 
      <Login>
        ********
      </Login> 
      <Password>
        ********
      </Password> 
    </AuthInfo> 
  </soap:Header> 
  <soap:Body> 
    <GetDepartCities 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1" 
    /> 
  </soap:Body> 
</soap:Envelope>

</source>

В примерах SOAP- запросов и ответов, которые приводятся ниже для каждого метода, элемент soap:Header убран для лучшей читаемости документа.

Все идентификаторы в методах используют тип Int32 (если не указано иного), который может принимать значения от -2 147 483 648 до 2 147 483 647. 

Справочник c  системными идентификаторами доступен по ссылке:
 https://module.sletat.ru/Dictionaries.xml

=== GetDepartCities ===

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

Сигнатура:
 CityCollection GetDepartCities() 

Параметры отсутствуют.

Пример SOAP-запроса:

<source lang="xml">

<soap:Envelope 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <soap:Body> 
    <GetDepartCities 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1" 
    /> 
  </soap:Body> 
</soap:Envelope>

</source>

Пример SOAP ответа:

<source lang="xml">

<s:Envelope 
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" 
> 
  <s:Body> 
    <GetDepartCitiesResponse xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <GetDepartCitiesResult 
        xmlns:a="urn:SletatRu:DataTypes:CityCollection:v1"
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
      >
        <a:City> 
          <Id 
            xmlns="urn:SletatRu:DataTypes:DbObject:v1"
          >
            1264
          </Id> 
          <Name 
            xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
          >
            Санкт-Петербург
          </Name> 
        </a:City> 
        ... 
      </GetDepartCitiesResult> 
    </GetDepartCitiesResponse> 
  </s:Body> 
</s:Envelope> 

</source>

Коллекция городов вылета '''CityCollection''' содержит n элементов '''City'''. 

Поля элемента '''City''':
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Name
|String
|Город вылета
|}

=== GetCountries ===
Метод '''GetCountries''' возвращает список доступных направлений для любого данного города вылета. В личном кабинете на сайте sletat.ru вы можете поставить на этот список различные фильтры, чтобы в ответ возвращались данные только о тех странах, с которыми вы работаете. Список городов вылета получается методом '''[[#GetDepartCities | GetDepartCities]]'''.

Сигнатура:
 CountryCollection GetCountries(
                     Int32 townFromId)

Параметр '''townFromId''' – идентификатор города вылета.

Пример SOAP-запроса доступных направлений для Санкт-Петербурга: 

<source lang="xml">

<soap:Envelope 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
>
  <soap:Body>
    <GetCountries 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <townFromId>1254</townFromId>
    </GetCountries>
  </soap:Body>
</soap:Envelope>

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> 
  <s:Body> 
    <GetCountriesResponse xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
      <GetCountriesResult 
        xmlns:a="urn:SletatRu:DataTypes:CountryCollection:v1" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:b="urn:SletatRu:DataTypes:Country:v1"
      >
        <a:Country> 
          <Id 
            xmlns="urn:SletatRu:DataTypes:DbObject:v1"
          >
            1
          </Id> 
          <Name 
            xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
          >
            Абхазия
          </Name> 
        </a:Country> 
        ... 
      </GetCountriesResult> 
    </GetCountriesResponse> 
  </s:Body> 
</s:Envelope>

</source>

В ответ возвращается коллекция направлений '''CountryCollection''', содержащая n элементов '''Country'''. 

Поля элемента '''Country''':
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|id
|Int32
|Идентификатор страны
|-
|Name
|String
|Наименование страны
|-
|IsProVisa
|Bool 
|Требуется ли в страну про-виза. Если в страну требуется про-виза, параметр принимает значение “true”; в противном случае — “false”. 
|-
|IsVisa
|bool
|Требуется ли виза гражданам РФ для въезда. Возможные значения: «false» — не требуется, «true» — требуется.
|-
|Alias
|String
|Текстовый код направления. 
|-
|Flags
|byte
|Дополнительные параметры страны (направления вылета). Возможные значения: 0 = None, Exotic = 1 (экзотическая страна),  SeaShore = 2 (Подходит для отдыха на море), Schengen = 4 (Является страной шенгенского соглашения).
|-
|HasTickets
|Int32
|Наличие билетов. Если билеты есть в наличии, параметр принимает значение “true”; в противном случае — “false”.
|-
|HotelIsNotInStop
|Int32
|Наличие мест в отеле. Если в отеле есть места, параметр принимает значение “true”; в противном случае — “false”. 
|-
|Rank
|Int32
|Ранг страны (0 — самый высокий).
|-
|TicketsIncluded
|Int32
|Объём турпакета. Если перелёт включён в стоимость тура, параметр принимает значение “true”; в противном случае — “false”.
|}

=== GetCities ===
Метод '''GetCities''' возвращает список курортов для выбранного направления. Список направлений получается методом '''[[#GetCountries | GetCountries]]'''.

Сигнатура:
 CityCollection GetCities(
                  Int32 countryId)

Параметр '''countryId''' – идентификатор страны.

Пример SOAP-запроса списка курортов для Египта:

<source lang="xml">

<soap:Envelope 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <soap:Body>
    <GetCities 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <countryId>
        40
      </countryId> 
    </GetCities> 
  </soap:Body>
</soap:Envelope>

</source>

Пример SOAP-ответа: 

<source lang="xml">

<s:Envelope 
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
>
  <s:Body> 
    <GetCitiesResponse 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <GetCitiesResult 
        xmlns:a="urn:SletatRu:DataTypes:CityCollection:v1"
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
      > 
        <a:City> 
          <Id 
            xmlns="urn:SletatRu:DataTypes:DbObject:v1"
          >
            26
          </Id> 
          <Name 
            xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
          >
            Айн Сохна
          </Name> 
        </a:City> 
        ... 
      </GetCitiesResult> 
    </GetCitiesResponse> 
  </s:Body> 
</s:Envelope>

</source>

В ответ возвращается коллекция курортов '''CityCollection''', содержащая n элементов '''City'''.

Поля элемента '''City''':
{| class="wikitable"
|Поле
|Тип
|Описание.
|-
|id
|Int32
|Идентификатор курорта.
|-
|Name 
|String
|Название курорта.  
|-
|CountryId
|Int 
|Идентификатор направления. 
|-
|Default
|Bool
|Устаревший параметр
|-
|DescriptionUrl 
|String
|Ссылка на описание курорта. Поле может быть пустым, если курорт не имеет описания.
|-
|IsPopular
|Bool
|Популярность курорта. Если курорт был признан популярным на основе статистики поисковых запросов, сделанных на сайте sletat.ru и сайтах партнёров, поле принимает значение “true”; в противном случае — “false”.
|-
|OriginalName
|String
|Название страны на латинице.
|-
|ParentId
|Int
|Идентификатор родительского курорта. Например, для греческих курортов Ираклиона, Лассити и Ретимно идентификатором родительского курорта будет 3071 - идентификатор о. Крит. Поле может быть пустым, если курорт не имеет родительского курорта.
|}

=== GetHotelStars ===

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

Сигнатура:

 HotelStarsCollection GetHotelStars(
                        Int32 countryId, 
                        Int32[] towns)

Параметры:
{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId
|Int32
|Идентификатор страны.
|-
|towns
|Int32[]
|Массив идентификаторов курортов. Если пуст, результаты возвращаются для всех курортов выбранной страны.
|}

Пример SOAP-запроса списка категорий отелей для Хургады и Шарм-Эль-Шейха (идентификаторы взяты из '''[[#GetCities | GetCities]]'''): 

<source lang="xml">

<soap:Envelope 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <soap:Body> 
    <GetHotelStars 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <countryId>40</countryId> 
      <towns> 
        <int
          xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays"
        >
          1592
        </int>
         <int
           xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays"
         >
           1642
         </int> 
      </towns> 
    </GetHotelStars> 
  </soap:Body> 
</soap:Envelope> 

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope 
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <s:Body> 
    <GetHotelStarsResponse 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <GetHotelStarsResult 
        xmlns:a="urn:SletatRu:DataTypes:HotelStarsCollection:v1" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:b="urn:SletatRu:DataTypes:HotelStars:v1"
      > 
        <a:HotelStars> 
          <Id 
            xmlns="urn:SletatRu:DataTypes:DbObject:v1"
          >
            401
          </Id> 
          <Name 
            xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
          >
            2*
          </Name> 
        </a:HotelStars> 
        ... 
      </GetHotelStarsResult> 
    </GetHotelStarsResponse> 
  </s:Body> 
</s:Envelope> 

</source>

В ответ возвращается коллекция категорий отелей '''HotelStarsCollection''', содержащая n элементов '''HotelStars'''.

Поля элемента '''HotelStars''':
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int32
|Идентификатор категории отеля.
|-
|Name
|String
|Категория отеля.
|}

=== GetMeals  ===

Метод '''GetMeals''' возвращает список типов питания.

Сигнатура:
 MealCollection GetMeals()

Параметры отсутствуют. 

Пример SOAP-запроса: 

<source lang="xml">

<soap:Envelope 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <soap:Body> 
    <GetMeals 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1" 
    /> 
  </soap:Body> 
</soap:Envelope>


</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope 
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
>
  <s:Body> 
    <GetMealsResponse 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <GetMealsResult 
        xmlns:a="urn:SletatRu:DataTypes:MealCollection:v1" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:b="urn:SletatRu:DataTypes:Meal:v1"
      > 
        <a:Meal> 
          <Id 
            xmlns="urn:SletatRu:DataTypes:DbObject:v1"
          >
            115
          </Id> 
          <Name 
            xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
          >
            AI
          </Name> 
        </a:Meal> 
        ... 
      </GetMealsResult> 
    </GetMealsResponse> 
  </s:Body> 
</s:Envelope>

</source>

В ответ возвращается коллекция типов питания '''MealCollection''', содержащая n элементов '''Meal'''.

Поля элемента '''Meal''':
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int32
|Идентификатор типа питания.
|-
|Name
|String
|Тип питания
|}

=== GetHotels ===

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

Сигнатура:
 HotelCollection GetHotels(
                   Int32 countryId, 
                   Int32[] towns, 
                   Int32[] stars, 
                   String filter, 
                   Int32 count) 

Параметры:
{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int32
|Идентификатор страны, обязательный параметр.
|-
|towns
|Int32[]
|Массив идентификаторов курортов. Если пуст, возвращается результат по всем курортам выбранной страны.
|-
|stars
|Int32[]
|Массив идентификаторов категорий отелей. Если пуст, возвращается результат по всем категориям.
|-
|filter
|String
|Фильтр для поиска отелей по названию. Если пуст, параметр игнорируется.
|-
|count *
|Int32
|Максимальное количество отелей в ответе (отели отбираются по рейтингу, потом сортируются по названию), обязательный параметр. При значении “-1” возвращаются данные по всем отелям.
|}

Пример SOAP-запроса списка 4- и 5-звёздочных 500 отелей Хургады и Шарм-Эль-Шейха:

<source lang="xml">

<soap:Envelope 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <soap:Body> 
    <GetHotels 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <countryId>40</countryId> 
      <towns> 
        <int 
          xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays"
        >
          1592
        </int>
        <int 
          xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays"
        >
          1642
        </int> 
      </towns> 
      <stars> 
        <int 
          xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays"
        >
          403
        </int> 
        <int 
          xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays"
        >
          404
        </int> 
      </stars> 
      <filter 
        xsi:nil="true" 
      /> 
      <count>500</count> 
    </GetHotels> 
  </soap:Body> 
</soap:Envelope>

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope 
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <s:Body> 
    <GetHotelsResponse 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <GetHotelsResult 
        xmlns:a="urn:SletatRu:DataTypes:HotelCollection:v1" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:b="urn:SletatRu:DataTypes:Hotel:v1"
      > 
        <a:Hotel> 
          <Id 
            xmlns="urn:SletatRu:DataTypes:DbObject:v1"
          >
            14646
          </Id> 
          <Name 
            xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
          >
            Four Seasons Resort
          </Name> 
          <b:Rate>4.94</b:Rate> 
          <b:StarName>5*</b:StarName> 
        </a:Hotel> 
        ... 
      </GetHotelsResult> 
    </GetHotelsResponse> 
  </s:Body> 
</s:Envelope>

</source>

В ответ возвращается коллекция отелей '''HotelsCollection''', содержащая n элементов '''Hotel'''. 

Поля элемента '''Hotel''':
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int32
|Идентификатор отеля.
|-
|Name
|String
|Название отеля.
|-
|BeachLineId
|Int32
|Пляжная линия. Варианты значений: 1, 2, 3 (первая, вторая или третья пляжная линия соответственно).
|-
|CommonRate
|Float
|Рейтинг отеля. На момент написания настоящего руководства параметр не используется, и данные не обновляются.
|-
|IsInBonusProgram
|Bool
|Бонусная программа Слетать.ру. Если отель предлагает турагентам бонусы за туристов, поле принимает значение “true”; в противном случае – “false”.
|-
|OriginalName
|Str
|Название отеля на латинице.
|-
|Phone
|Int
|Устаревший параметр.
|-
|PhotosCount
|Int
|Общее количество фотографий отеля.
|-
|PopularityLevel
|Int
|Уровень популярности отеля. Определяется на основе количества поисков в отель. 0 - Low, 1 - Normal, 2 - High
|-
|Rate 
|Float
|Ранг отеля.
|-
|SearchCount
|int
|Количество поисков по отелю за период (1 месяц).
|-
|StarId
|Int
|Идентификатор категории отеля.
|-
|StarName
|Str
|Категория отеля
|-
|TownId
|Int
|Идентификатор курорта.
|}

=== GetTourOperators ===

Метод '''GetTourOperators''' возвращает список доступных туроператоров. Последний может быть ограничен лицензией. Кроме того, вы можете настроить фильтрацию туроператоров в личном кабинете на сайте sletat.ru.

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

Сигнатура:
 TourOperatorCollection GetTourOperators(
                          Int32 townFromId, 
                          Int32 countryId) 

Параметры:
{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|townFromId
|Int32
|Идентификатор города вылета.
|-
|countryId
|Int32
|Идентификатор страны.
|}

Пример SOAP-запроса списка туроператоров c отметкой тех, у кого есть туры из Санкт-Петербурга в Египет: 

<source lang="xml">

<soap:Envelope 
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <soap:Body> 
    <GetTourOperators 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <townFromId>1264</townFromId> 
      <countryId>40</countryId> 
    </GetTourOperators> 
  </soap:Body> 
</soap:Envelope> 

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope 
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <s:Body> 
    <GetTourOperatorsResponse 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <GetTourOperatorsResult 
        xmlns:a="urn:SletatRu:DataTypes:TourOperatorCollection:v1" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:b="urn:SletatRu:DataTypes:TourOperator:v1"
      > 
        <a:TourOperator> 
          <Id 
            xmlns="urn:SletatRu:DataTypes:DbObject:v1"
          >
            7
          </Id> 
          <Name 
            xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
          >
            Biblio Globus
          </Name> 
          <b:Enabled>True</b:Enabled> 
        </a:TourOperator> 
        ... 
      </GetTourOperatorsResult> 
    </GetTourOperatorsResponse> 
  </s:Body> 
</s:Envelope> 

</source>

В ответ возвращается коллекция туроператоров '''TourOperatorCollection''', содержащая n элементов '''TourOperator'''.

Поля элемента '''TourOperator''':  
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int32
|Идентификатор туроператора
|-
|Name
|String
|Наименование туроператора
|-
|Enabled
|String
|Отметка о наличии туров. Возможные значения: “true” – есть туры; “false” – нет туров.
|}

=== GetTourDates  ===
Метод '''GetTourDates''' возвращает список доступных дат вылета для выбранных города вылета, страны и курорта, используя внутреннюю статистику, собранную по ранее найденным турам.
 
Сигнатура:
 XmlTourDates GetTourDates(
                Int32 dptCityId, 
                Int32 countryId, 
                Int32[] resorts,
                Int32[] sources,
                Bool checkLicenseSources)

Параметры:
{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|dptCityId
|Int32
|Идентификатор города вылета.
|-
|countryId
|Int32
|Идентификатор страны.
|-
|resorts
|Int32[]
|Массив идентификаторов курортов. Если ни один курорт не выбран, значение поля равно нулю.
|-
|sources
|Int32[]
|Массив идентификаторов туроператоров. Если ни один туроператор не выбран, значение поля равно нулю.
|-
|checkLicenseSources
|Bool
|Используется для внутренних сервисов Слетать.ру
|}

Пример SOAP-запроса доступных дат начала тура из Екатеринбурга в Тироль (Австрия): 

<source lang="xml">

<s:Envelope 
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <s:Body> 
    <GetTourDates 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <dptCityId>1265</dptCityId> 
      <countryId>3</countryId> 
      <resorts 
        xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
      > 
        <a:int>1442</a:int> 
      </resorts> 
    </GetTourDates> 
  </s:Body> 
</s:Envelope>

</source>

Пример SOAP-ответа: 

<source lang="xml">

<s:Envelope 
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <s:Body> 
    <GetTourDatesResponse 
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    > 
      <GetTourDatesResult 
        xmlns:a="urn:SletatRu:DataTypes:XmlTourDates:v1" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
      > 
        <a:Dates 
          xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"
        > 
          <b:string>09.03.2013</b:string> 
          <b:string>09.02.2013</b:string> 
          <b:string>23.02.2013</b:string> 
          <b:string>02.03.2013</b:string> 
          <b:string>16.03.2013</b:string> 
          <b:string>02.02.2013</b:string> 
          <b:string>16.02.2013</b:string> 
          <b:string>06.04.2013</b:string> 
        </a:Dates> 
      </GetTourDatesResult> 
    </GetTourDatesResponse> 
  </s:Body> 
</s:Envelope>

</source>

'''XmlTourDates''' содержит элемент '''Dates''' – коллекцию дат начала тура.

=== GetSourseAssurances  ===
Метод '''GetSourseAssurances''' возвращают массивы юрлиц по идентификатору туроператора в справочнике Слетать.ру
 
Сигнатура:
SourceRequisite[] GetSourseAssurances(int sourceId)

каждый элемент массива содержит следующие поля

string Number - Номер туроператора в реестре

string Name - Полное название

string Site - Сайт

string NameShort - Сокращенное наименование

string PhysicalAddress - Юридический адрес

string PostAddress - Почтовый адрес

SourceFinSecurityDocument[] FinSecurityDocuments - массив документов о предоставлении финансовых гарантий данному оператору

Каждый элемент массива FinSecurityDocuments имеет следующие поля:



int FinSecurityAmount - Размер финансового обеспечения

string WayToFinSecurity - Тип документа

string DocumentNumber - Номер документа в реестре

DateTime? DocumentDate - Номер документа в реестре

DateTime? DateOfFinSecurityFrom - Дата начала действия документа

DateTime? DateOfFinSecurityTo - Дата окончания действия документа

string OrgName - Название организации, предоставившей ТО финансовые гарантии

string OrgAddress - Юридический адрес организации, предоставившей ТО финансовые гарантии

string OrgPostAddress - Почтовый адрес организации, предоставившей ТО финансовые гарантии

=== Методы загрузки туров ===

Так как разные туроператоры возвращают результаты запроса в разные интервалы времени (до 90 секунд), в сервисе реализован '''асинхронный''' поиск туров. Для загрузки туров используются три метода: 
* '''[[#CreateRequest | CreateRequest]]''' используется для создания поискового запроса. Метод принимает все необходимые поисковые параметры. 
* '''[[#GetRequestState | GetRequestState]]''' отслеживает прогресс обработки поискового запроса туроператорами.
* '''[[#GetRequestResult | GetRequestResult]]''' возвращает все данные, найденные по запросу на момент вызова. 
* '''[[#ContinueSearch | ContinueSearch]]''' позволяет продолжить поиск по параметрам исходного поискового запроса среди предложений с более высокой ценой.

В этом разделе приведено подробное описание всех методов.

{| class="standard sWarning"
|Внимание! Варианты взаимодействия методов '''[[#CreateRequest | CreateRequest]]''', '''[[#GetRequestResult | GetRequestResult]]''' и '''[[#ContinueSearch |ContinueSearch]]''' описана в разделе «'''[[#Логика работы с сервисом |Логика работы с сервисом]]'''». 
|}

{| class="standard sWarning"
|Внимание! Работа с поисковым запросом (создание, запрос состояния и загрузка туров) должна выполняться с одного IP-адреса. При выполнении указанного условия взаимодействие с сервисом возможно с нескольких IP-адресов. 
|}

==== CreateRequest ====

Метод '''CreateRequest''' используется для создания поискового запроса. Ответ состоит из единственного элемента '''CreateRequestResult''', содержащего идентификатор созданного запроса. Присвоенный запросу идентификатор используется методами '''[[#GetRequestState | GetRequestState]]''', '''[[#GetRequestResult | GetRequestResult]]''' и '''[[#ContinueSearch |ContinueSearch]]''' в продолжение всего процесса поиска.

{| class="standard sWarning"
|Внимание! Варианты взаимодействия методов '''CreateRequest''', '''[[#GetRequestResult | GetRequestResult]]''' и '''[[#ContinueSearch |ContinueSearch]]''' описана в разделе «'''[[#Логика работы с сервисом |Логика работы с сервисом]]'''».
|}

Сигнатура:

 Int32 CreateRequest( 
            Int32 countryId, 
            Int32 cityFromId, 
            Int32[] cities, 
            Int32[] meals, 
            Int32[] stars, 
            Int32[] hotels,
            Int32 adults, 
            Int32 kids, 
            Int32[] kidsAges, 
            Int32 nightsMin, 
            Int32 nightsMax, 
            Int32 priceMin, 
            Int32 priceMax, 
            String currencyAlias, 
            String departFrom, 
            String departTo, 
            Boolean hotelIsNotInStop, 
            Boolean hasTickets, 
            Boolean ticketsIncluded, 
            Boolean useFilter, 
            Int32[] f_to_id,
            Boolean useTree, 
            Boolean includeDescriptions, 
            Boolean showEconomOnly, 
            Int32 cacheMode)

Параметры (обязательные отмечены знаком *):                                                                                                                         
                                                                                                                         
{| class="wikitable"
| 
Параметр
| 
Тип
| 
Описание
|-
| 
countryId *
| 
Int32
| 
Идентификатор страны.
|-
| 
cityFromId *
| 
Int32
| 
Идентификатор города вылета.
|-
| 
cities
| 
Int32[]
| 
Список идентификаторов курортов, по которым должен быть произведён поиск.

{| class="standard sWarning"
|Внимание! Из-за технических ограничений со стороны оператора «Натали Турс», он принимает в одном запросе не больше 5 идентификаторов курортов. При передаче в запросе более 5 идентификаторов курортов к оператору уходят только первые 5, из-за этого в результаты поиска по этому ТО могут попадать не самые дешевые туры.
|}
|-
| 
meals
| 
Int32[]
| 
Список идентификаторов типов питания, по которым должен быть произведён поиск.
|-
| 
stars
| 
Int32[]
| 
Список идентификаторов категорий отелей, по которым должен быть произведён поиск.
|-
| 
hotels
| 
Int32[]
| 
Список идентификаторов отелей, по которым должен быть произведён поиск. Не более 10 идентификаторов отелей в одном запросе.

{| class="standard sWarning"
|Внимание! Из-за технических ограничений со стороны оператора «Натали Турс», он принимает в одном запросе не больше 5 идентификаторов отелей. При передаче в запросе более 5 идентификаторов отелей к оператору уходят только первые 5, из-за этого в результаты поиска по этому ТО могут попадать не самые дешевые туры.
|}
|-
| 
adults
| 
Int32
| 
Количество туристов (взрослых). Значение по умолчанию «2».
|-
| 
kids
| 
Int32
| 
Количество туристов (детей). Значение по умолчанию «0».
|-
| 
kidsAges
| 
Int32
| 
Возраст каждого ребёнка. Если параметр используется, количество элементов в массиве должно быть равным значению параметра '''kids'''.
|-
| 
nightsMin
| 
Int32
| 
Минимальная продолжительность тура (ночей). Значение по умолчанию «7».
|-
| 
nightsMax
| 
Int32
| 
Максимальная продолжительность тура (ночей). Значение по умолчанию «7».
|-
| 
priceMin
| 
Int32
| 
Минимальная цена тура.
|-
| 
priceMax
| 
Int32
| 
Максимальная цена тура.
|-
| 
currencyAlias
| 
String
| 
Валюта для параметров priceMin и priceMax. Поддерживаются значения USD, EUR, RUB, BYN и UAH. Указанная валюта будет использована в поисковой выдаче.
|-
| 
departFrom
| 
String
| 
Начальная дата диапазона дат вылета в формате dd.MM.yyyy. Значение по умолчанию — текущая дата +1 день.
|-
| 
departTo
| 
String
| 
Конечная дата диапазона дат вылета в формате dd.MM.yyyy. Значение по умолчанию — значение параметра dateFrom +7 дней. Допустимый интервал между начальной и конечной датой диапазона — '''45 дней'''.
|-
| 
hotelIsNotInStop
| 
Boolean
| 
Фильтрация результатов поиска по наличию мест в отеле. Если значение равно «true», в выдачу попадут только отели со статусом «под запрос» и «есть места»; если «false», фильтр не применяется. Значение по умолчанию «false».
|-
| 
hasTickets
| 
Boolean
| 
Фильтрация результатов поиска по наличию билетов (туда и обратно, без учёта класса). Если значение равно «true», в результаты поиска попадут только туры, в которых ещё остались в наличии билеты; если «false», фильтр не применяется. Значение по умолчанию — «false».
|-
| 
ticketsIncluded
| 
Boolean
| 
Фильтрация результатов поиска по составу турпакета. Если значение параметра равно «true», в выдачу попадут только туры с перелётами; если «false», фильтр не применяется. Значение по умолчанию — «false».
|-
| 
useFilter
| 
Boolean
| 
Фильтрация результатов поиска по туроператорам. Если значение равно «true», в выдачу попадают продукты туроператоров, перечисленных в параметре '''f_to_id'''; если «false», фильтр не применяется. Фильтр применяется только после создания поискового запроса. Значение по умолчанию — «false». '''Использование параметра ограниченно лицензией.'''
|-
| 
f_to_id
| 
Int32[]
| 
Список идентификаторов туроператоров для параметра '''useFilter'''. '''Использование параметра ограниченно лицензией.'''
|-
| 
includeDescriptions
| 
Boolean
| 
Если значение равно «true», в выдаче будут подробно описаны отели, типы размещения и питания.
|-
| 
showEconomOnly
| 
Boolean
| 
Возвращает туры в которые есть билеты на эконом рейсы, если значение параметра равно «true»; если «false», фильтр не применяется. Значение по умолчанию — «false». (Данный параметр является устаревшим. Не рекомендуется к использованию).
|-
| 
cacheMode
| 
Int32
| 
Режим обращения к кешу системы поиска. Возможные значения: 0 – не использовать кеш; 1 – использовать кеш при ошибках поиска у туроператора; 2 – режим '''SmartCache''' (на основе статистики поисковых запросов и наполнения кеша будет принято решение об использовании кеша; если поиск по кешу не даёт достоверного результата, запрос направляется туроператору); 3 – запрос будет направлен только в кеш, без использования алгоритма '''SmartCache'''; 4 – запрос будет направлен только в кеш, алгоритм '''SmartCache''' используется для поиска наиболее актуального набора туров.
|}

В приведённом ниже примере создаётся поисковый запрос со следующими параметрами:
* город вылета Санкт-Петербург;
* направление Египет;
* курорты Хургада и Шарм-Эль-Шейх;
* отели Albatros Aqua Park Sharm и Akassia Swiss Resort;
* вид питания All Included;
* 2 взрослых туриста без детей;
* продолжительность тура 14 ночей;
* цены отобразить в рублях;
* дата начала вылета в диапазоне от 10 до 17 октября 2011 года;
* не выводить отели в стопе;
* выводить только туры с включенным перелётом;
* выводить только туры с наличием билетов туда и обратно.

Пример SOAP-запроса:

<source lang="xml">

<x:Envelope
    xmlns:x="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:urn="urn:SletatRu:Contracts:Soap11Gate:v1"
    xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays"
    xmlns:urn1="urn:SletatRu:DataTypes:AuthData:v1">
    <x:Header>
        <urn1:AuthInfo>
            <urn1:Login>****</urn1:Login>
            <urn1:Password>****</urn1:Password>
        </urn1:AuthInfo>
    </x:Header>
    <x:Body>
        <urn:CreateRequest>
            <urn:countryId>40</urn:countryId>
            <urn:cityFromId>1264</urn:cityFromId>
            <urn:cities>
                <arr:int>1592</arr:int>
                <arr:int>1642</arr:int>
            </urn:cities>
            <urn:meals>
                <arr:int>115</arr:int>
            </urn:meals>
            <urn:hotels>
                 <arr:int>109930</arr:int>
                 <arr:int>772</arr:int>
            </urn:hotels>
            <urn:adults>2</urn:adults>
            <urn:kids>0</urn:kids>
            <urn:kidsAges>
                <arr:int>0</arr:int>
            </urn:kidsAges>
            <urn:nightsMin>7</urn:nightsMin>
            <urn:nightsMax>7</urn:nightsMax>
            <urn:priceMin>10000</urn:priceMin>
            <urn:priceMax>1000000</urn:priceMax>
            <urn:currencyAlias>RUB</urn:currencyAlias>
            <urn:departFrom>10.04.2011</urn:departFrom>
            <urn:departTo>17.04.2011</urn:departTo>
            <urn:hotelIsNotInStop>true</urn:hotelIsNotInStop>
            <urn:hasTickets>true</urn:hasTickets>
            <urn:ticketsIncluded>true</urn:ticketsIncluded>
            <urn:includeDescriptions>true</urn:includeDescriptions>
        </urn:CreateRequest>
    </x:Body>
</x:Envelope>

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
>
  <s:Body>
    <CreateRequestResponse
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <CreateRequestResult>4355852</CreateRequestResult>
    </CreateRequestResponse>
  </s:Body>
</s:Envelope>

</source>

Элемент CreateRequestResult содержит идентификатор поискового запроса (Int32).

==== GetRequestState ====

Метод '''GetRequestState''' возвращает статус обработки запроса для каждого туроператора.

{| class="standard sWarning"
|Внимание! Варианты взаимодействия методов '''[[#CreateRequest | CreateRequest]]''', '''GetRequestResult''' и '''ContinueSearch''' описаны в разделе «'''Логика работы с сервисом'''».
|}

Сигнатура:
 OperatorLoadStateCollection GetRequestState(
                               Int32 requestId)

Метод принимает единственный параметр '''requestId''' – идентификатор поискового запроса, выданный методом '''[[#CreateRequest | CreateRequest]]''' при создании.
 
Пример SOAP-запроса:

<source lang="xml">

<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
>
  <soap:Body>
    <GetRequestState
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <requestId>4355852</requestId>
    </GetRequestState>
  </soap:Body>
</soap:Envelope>

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
>
  <s:Body>
    <GetRequestStateResponse
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <GetRequestStateResult
        xmlns:a="urn:SamoSoft:DataTypes:OperatorLoadStateCollection:v1"
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:b="urn:SamoSoft:DataTypes:OperatorLoadState:v1"
      >
        <a:OperatorLoadState>
          <Id
            xmlns="urn:SletatRu:DataTypes:DbObject:v1"
          >
            7
          </Id>
          <Name
            xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
          >
            Biblio Globus
          </Name>
          <b:ErrorMessage i:nil="true"/>
          <b:ExecutionTimeMs>1561</b:ExecutionTimeMs>
          <b:IsCached>false</b:IsCached>
          <b:IsError>false</b:IsError>
          <b:IsProcessed>true</b:IsProcessed>
          <b:IsSkipped>false</b:IsSkipped>
          <b:IsTimeout>false</b:IsTimeout>
          <b:RowsCount>150</b:RowsCount>
        </a:OperatorLoadState>
        ...
      </GetRequestStateResult>
    </GetRequestStateResponse>
  </s:Body>
</s:Envelope>

</source>

На примере видно, что туроператор '''Biblio Globus''' вернул 150 туров за 1,5 секунды, состояния загрузки по другим операторам из примера были убраны.
 
В ответ возвращается коллекция состояний обработки запроса '''OperatorLoadStateCollection''', содержащая n элементов '''OperatorLoadState''', каждый из которых описывает статус для одного оператора.
 
Описание полей элемента '''OperatorLoadState''':
                                                   
{| class="wikitable"
|Поле
| 
Тип
| 
Описание
|-
| 
Id
| 
Int32
| 
Идентификатор туроператора.
|-
| 
Name
| 
String
| 
Наименование туроператора.
|-
| 
IsPersistentCacheUsed 
| 
Boolean
| 
Параметр принимает значение “true” если туры найдены из временного кэша. 
|-
| 
IsProcessed
| 
Boolean
| 
Статус обработки запроса. Принимает значение “true”, даже если запрос обработан с ошибкой.
|-
| 
IsSkipped 
| 
Boolean
| 
Параметр принимает значение “true” если поиск по туроператору не был произведен.
|-
| 
IsCached
| 
Boolean
| 
Принимает значение “true”, если ответ выдан из кеша.
|-
| 
IsError
|  Boolean
| 
Принимает значение “true”, если. При обработке запроса произошла ошибка.
|-
| 
ErrorMessage
|  String
| 
Описание ошибки при IsError = true.
|-
| 
IsTimeout
|  
| 
Принимает значение “true”, если запрос
завершен по таймауту. Поле IsError также принимает значение “true”.
|-
| 
ExecutionTimeMs
|  
| 
Время обработки запроса в миллисекундах.
|-
| 
RowsCount
|  
| 
Количество найденных туров.
|-
|OnlineErrorMessage
|
|Сервисное сообщение от туроператора
|-
|MinPrice
|
|Минимальная цена найденных туров
|-
|MaxPrice
|
|Максимальная цена найденных туров
|}

{| class="standard sWarning"
|Внимание! Поисковый запрос считается обработанным, когда для каждого туроператора поле '''IsProcessed''' принимает значение “true”.
|}

==== GetRequestResult ====

Метод '''GetRequestResult''' возвращает все туры, найденные в рамках обработки поискового запроса.

{| class="standard sWarning"
|Внимание! Базовый алгоритм работы сервиса подразумевает асинхронную обработку поискового запроса. Если поисковый запрос не был обработан до конца (в результате метода '''[[#GetRequestState | GetRequestState]]''' не все туроператоры получили флаг '''IsProcessed = true'''), то метод '''GetRequestResult''' возвращает набор туров, доступный на момент его вызова. Итоговый набор туров постоянно обновляется по мере обработки запроса каждым туроператором. Если вы хотите, чтобы результаты поиска появлялись в выдаче одновременно, воспользуйтесь информацией, приведённой в разделе «'''Логика работы с сервисом'''».
|}

Сигнатура:

 TourData GetRequestResult(
           Int32 requestId
           Int32 pageSize
           Int32 pageNumber)

Метод принимает параметр requestId – идентификатор запроса, возвращённый методом '''[[#CreateRequest | CreateRequest]]''' при создании запроса.
 
Параметры (обязательные отмечены знаком *):

{| class="wikitable"
| Параметр
| Тип
| Описание
|-
| requestId*
| Int32
| Идентификатор запроса.
|-
| pageSize
| Int32
| Количество туров в ленте выдачи на одной странице. По умолчанию: не задан.
|-
| pageNumber
| Int32
| Номер страницы в ленте выдачи. По умолчанию: не задан.
|}

Пример SOAP-запроса:

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SletatRu:Contracts:Soap11Gate:v1">
   <x:Body>
       <urn:GetRequestResult>
           <urn:requestId>4355852</urn:requestId>
           <urn:pageSize>10</urn:pageSize>
           <urn:pageNumber>2</urn:pageNumber>
       </urn:GetRequestResult>
   </x:Body>
</x:Envelope>

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
> 
  <s:Body>
    <GetRequestResultResponse
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <GetRequestResultResult
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:a="urn:SletatRu:DataTypes:XmlTourData:v1"
      >
        <a:HotelCount>374</a:HotelCount>
        <a:LoadState
          xmlns:c="urn:SamoSoft:DataTypes:OperatorLoadState:v1"
          xmlns:b="urn:SamoSoft:DataTypes:OperatorLoadStateCollection:v1"
        >
          <b:OperatorLoadState>
            <Id
              xmlns="urn:SletatRu:DataTypes:DbObject:v1"
            >
              1819010031
            </Id>
            <Name
              xmlns="urn:SletatRu:DataTypes:NamedDbObject:v1"
            >
              Туроператор #1819010031
            </Name>
            <c:ErrorMessage i:nil="true"/>
            <c:ExecutionTimeMs>2812</c:ExecutionTimeMs>
            <c:IsCached>false</c:IsCached>
            <c:IsError>false</c:IsError>
            <c:IsPersistentCacheUsed>false</c:IsPersistentCacheUsed>
            <c:IsProcessed>true</c:IsProcessed>
            <c:IsSkipped>false</c:IsSkipped>
            <c:IsTimeout>false</c:IsTimeout>
            <c:MaxPrice>30952</c:MaxPrice>
            <c:MinPrice>19424</c:MinPrice>
            <c:RowsCount>40</c:RowsCount>
          </b:OperatorLoadState>
        </a:LoadState>
        <a:OilTaxes xmlns:b="urn:SletatRu:DataTypes:XmlTourOilTax:v1">
          <b:XmlTourOilTax>
            <b:AirCompanyName i:nil="true"/>
            <b:AirportName i:nil="true"/>
            <b:CurrencyName i:nil="true"/>
            <b:Date1>2013-11-25T00:00:00</b:Date1>
            <b:Date2>2014-12-31T00:00:00</b:Date2>
            <b:FlightNumber i:nil="true"/>
            <b:PartnerName i:nil="true"/>
            <b:ResortId i:nil="true"/>
            <b:ResortName i:nil="true"/>
            <b:SourceId>1819010041</b:SourceId>
            <b:Tax>0</b:Tax>
          </b:XmlTourOilTax>
        </a:OilTaxes>
        <a:RequestId>539037314</a:RequestId>
        <a:Rows xmlns:b="urn:SletatRu:DataTypes:XmlTourRecord:v1">
          <b:XmlTourRecord>
            <b:Adults>2</b:Adults>
            <b:BusinessTicketsDpt>Stop</b:BusinessTicketsDpt>
            <b:BusinessTicketsRtn>Stop</b:BusinessTicketsRtn>
            <b:CheckInDate>07.05.2014</b:CheckInDate>
            <b:CityFromId>832</b:CityFromId>
            <b:CityFromName>Москва</b:CityFromName>
            <b:CountryId>35</b:CountryId>
            <b:CountryName>Греция</b:CountryName>
            <b:CreditMonthlyPay i:nil="true"/>
            <b:CreditMonths i:nil="true"/>
            <b:Currency>RUB</b:Currency>
            <b:Description>
              1, Касторья, Хлои-Фундукли, Esperos Palace 4*+, Double Classical, _, 2Ad, Half Board 1, Халкидики-Афон, Урануполи, Dioni Apartments Apartments, Apartment 1 Broom, _, 2Ad, Room Rate
            </b:Description>
            <b:DiscountCaption/>
            <b:DiscountExpires i:nil="true"/>
            <b:DiscountPercent i:nil="true"/>
            <b:EarlyBookingValidTill i:nil="true"/>
            <b:EconomTicketsDpt>Available</b:EconomTicketsDpt>
            <b:EconomTicketsRtn>Available</b:EconomTicketsRtn>
            <b:FewBusinessTicketsDpt>0</b:FewBusinessTicketsDpt>
            <b:FewBusinessTicketsRtn>0</b:FewBusinessTicketsRtn>
            <b:FewEconomTicketsDpt>-1</b:FewEconomTicketsDpt>
            <b:FewEconomTicketsRtn>0</b:FewEconomTicketsRtn>
            <b:FewPlacesInHotel>0</b:FewPlacesInHotel>
            <b:Flags>3072</b:Flags>
            <b:Found i:nil="true"/>
            <b:GiftCaption/>
            <b:HotelDescription/>
            <b:HotelDescriptionUrl>
              https://hotels.sletat.ru/?id=13298
            </b:HotelDescriptionUrl>
            <b:HotelId>13298</b:HotelId>
            <b:HotelIsInStop>Available</b:HotelIsInStop>
            <b:HotelName>Esperos Palace</b:HotelName>
            <b:HotelPhotosCount>45</b:HotelPhotosCount>
            <b:HotelRating>9.62</b:HotelRating>
            <b:HotelTitleImageUrl>
              https://hotels.sletat.ru/i/p/13298_0.jpg
            </b:HotelTitleImageUrl>
            <b:HtPlaceDescription/>
            <b:HtPlaceId>13103</b:HtPlaceId>
            <b:HtPlaceName>DBL</b:HtPlaceName>
            <b:IsDemoMode>false</b:IsDemoMode>
            <b:Kids>0</b:Kids>
            <b:MealDescription/>
            <b:MealId>113</b:MealId>
            <b:MealName>HB</b:MealName>
            <b:Nights>2</b:Nights>
            <b:OfferId>985863881</b:OfferId>
            <b:OfferIdStr>985863881</b:OfferIdStr>
            <b:OriginalHotelName>Esperos Palace</b:OriginalHotelName>
            <b:OriginalHtPlaceName>2Ad</b:OriginalHtPlaceName>
            <b:OriginalMealName>Half Board</b:OriginalMealName>
            <b:OriginalRoomName>Double Classical,_          </b:OriginalRoomName>
            <b:OriginalStarName>4*</b:OriginalStarName>
            <b:OriginalTownName>Касторья, Хлои-Фундукли</b:OriginalTownName>
            <b:Price>50</b:Price>
            <b:PriceType>0</b:PriceType>
            <b:ReceivingParty/>
            <b:ResortDescriptionUrl/>
            <b:ResortId>546</b:ResortId>
            <b:ResortName>Кастория</b:ResortName>
            <b:RoomId>0</b:RoomId>
            <b:RoomName>Double Classical, _</b:RoomName>
            <b:SourceId>1819010039</b:SourceId>
            <b:SourceImageUrl/>
            <b:SourceName/>
            <b:SourceSearchFormUrl/>
            <b:StarId>403</b:StarId>
            <b:StarName>4*</b:StarName>
            <b:TicketsIncluded>Included</b:TicketsIncluded>
            <b:TourArchiveHash>AsBcr96RHxUv1810cTI28A==</b:TourArchiveHash>
            <b:TourHash>ZdVTLJ1FPydJIFpekzdUXg==</b:TourHash>
            <b:TourName>_МСК_Шоп-тур с обяз._2014_+Отд.</b:TourName>
            <b:TourUrl/>
          </b:XmlTourRecord>
        </a:Rows>
        <a:RowsCount>2318</a:RowsCount>
        <a:SourcesVisas
          xmlns:b="urn:SletatRu:DataTypes:XmlVisaRange:v1"
        >
          <b:CurrencyName>EUR</b:CurrencyName>
          <b:Items
            xmlns:c="urn:SletatRu:DataTypes:XmlVisaRangeItem:v1"
          >
            <c:XmlVisaRangeItem>
              <c:MaxPrice>70</c:MaxPrice>
              <c:MinPrice>30</c:MinPrice>
              <c:SourceId>1819010049</c:SourceId>
            </c:XmlVisaRangeItem>
          </b:Items>
        </a:SourcesVisas>
        <a:Visa
          xmlns:b="urn:SletatRu:DataTypes:XmlVisa:v1"
          i:nil="true"
        />
      </GetRequestResultResult>
    </GetRequestResultResponse>
  </s:Body>
</s:Envelope>

</source>

В ответ возвращается структура '''GetRequestResultResult''', состоящая из следующих полей:

* '''HotelCount''' – общее количество отелей в поисковой выдаче;
* '''LoadState''' – массив данных о состоянии обработки поискового запроса, в котором каждый элемент '''OperatorLoadState''' описывает состояние обработки запроса одним оператором (структура '''OperatorLoadState''' описана в разделе “'''GetRequestSate'''”);
* '''OilTaxes''' – массив данных о топливных сборах, в котором каждый элемент  информация о топливных сборах.
* '''RequestId''' – идентификатор поискового запроса;
* '''Rows''' – состоит из структур '''XmlTourRecord''', которые описывают найденные туры;
* '''RowsCount''' – количество туров, найденных в рамках поискового запроса на момент формирования ответа (в примере по заданному запросу найдено 410 цен);
* '''SourcesVisas''' – необходимо описание;
* '''Visa''' – информация о стоимости визы;

Поля структуры '''XmlTourRecord''':

{| class="wikitable"
| Поле
| Тип
| Описание
|-
| Adults
| Int32
| Количество туристов (взрослых).
|-
| 
BusinessTicketsDpt
| 
Enum
| 
Наличие билетов бизнес-класса (туда). Возможные значения: Stop – нет билетов, Available – есть билеты, Request – под запрос, и Unknown – нет данных.
|-
| 
BusinessTicketsRtn
| 
Enum
| 
Наличие билетов бизнес-класса (обратно). Возможные значения: Stop – нет билетов, Available – есть билеты, Request – под запрос, и Unknown – нет данных.
|-
| 
CheckInDate
| 
String
| 
Дата вылета в формате dd.MM.yyyy.
|-
| 
CityFromId
| 
Int32
| 
Идентификатор города вылета.
|-
| 
CityFromName
| 
String
| 
Город вылета.
|-
| 
CountryId
| 
Int32
| 
Идентификатор направления.
|-
| 
CountryName
| 
String
| 
Направление.
|-
| 
CreditMonthlyPay
|  
|
Данный параметр устарел.  
|-
| 
CreditMonths
|  
|
Данный параметр устарел.    
|-
| 
Currency
| 
String
| 
Валюта, в которой отображены цены. Возможные значения: RUB, USD, EUR, BYN и UAH.
|-
| 
Description
|  
|  
|-
| 
DiscountCaption
|  
|
Данный параметр устарел.  
|-
| 
DiscountExpires
|  
|
Данный параметр устарел.  
|-
| 
DiscountPercent
|  
|
Данный параметр устарел.  
|-
| 
EarlyBookingValidTill
|  
|
Данный параметр устарел.  
|-
| 
EconomTicketsDpt
| 
Enum
| 
Наличие билетов эконом-класса (туда). Возможные значения: Stop – нет билетов, Available – есть билеты, Request – под запрос, и Unknown – нет данных.
|-
| 
EconomTicketsRtn
| 
Enum
| 
Наличие билетов эконом-класса (обратно). Возможные значения: Stop – нет билетов, Available – есть билеты, Request – под запрос, и Unknown – нет данных.
|-
| 
FewBusinessTicketsDpt
| 
Int32
| 
Если есть билеты бизнес-класса (поле '''BusinessTicketsDpt''' имеет значение “Available”) и значение этого поля отлично от нуля, то билетов МАЛО. Если туроператор сообщает о том, что билетов мало, но не указывает точного количества, поле принимает значение “-1”. Если передано любое иное число, отличное от нуля, то это точное количество оставшихся билетов.
|-
| 
FewBusinessTicketsRtn
| 
Int32
| 
Если есть билеты бизнес-класса обратно (поле '''BusinessTicketsRtn''' имеет значение “Available”) и значение этого поля отлично от нуля, то билетов МАЛО. Если туроператор сообщает о том, что билетов мало, но не указывает точного количества, поле принимает значение “-1”. Если передано любое иное число, отличное от нуля, то это точное количество оставшихся билетов.
|-
| 
FewEconomTicketsDpt
| 
Int32
| 
Если есть билеты эконом-класса (поле '''EconomTicketsDpt''' имеет значение “Available”) и значение этого поля отлично от нуля, то билетов МАЛО. Если туроператор сообщает о том, что билетов мало, но не указывает точного количества, поле принимает значение “-1”. Если передано любое иное число, отличное от нуля, то это точное количество оставшихся билетов.
|-
| 
FewEconomTicketsRtn
| 
Int32
| 
Если есть места на перелёт эконом-классом обратно (поле '''EconomTicketsRtn''' имеет значение “Available”) и значение этого поля отлично от нуля, то билетов МАЛО. Если туроператор сообщает о том, что билетов мало, но не указывает точного количества, поле принимает значение “-1”. Если передано любое иное число, отличное от нуля, то это точное количество оставшихся билетов.
|-
| 
FewPlacesInHotel
| 
Int32
| 
Если есть места в отеле (поле '''HotelIsInStop''' имеет значение “Available”) и значение этого поля отлично от нуля, то мест в отеле МАЛО. Если туроператор сообщает о том, что мест мало, но не указывает точного количества, поле принимает значение “-1”. Если передано любое иное число, отличное от нуля, то это точное количество оставшихся мест.
|-
| 
Flags
|  UInt64
|  Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой. Возможные флаги тура:

1 – туроператор рекомендует данный тур;

2 – доступно мгновенное подтверждение;

4 – туроператор считает данный тур лучшим предложением;

8 – тур раннего бронирования;

16 – тур позднего бронирования;

32 – туроператор предоставляет скидку на данный тур;

64 – VIP предложение;

128 – тур доступен в кредит;

256 – тур является эксклюзивным предложением туроператора;

512 – при покупке тура туристу подарок;

1024 – тур является комбинированным;

2048 – тур с обязательством (шоп-тур);

4096 – зарезервировано для использования системой;

8192 – экскурсионный тур;

16384 - Промо цена на тур;

32768 - Тур где перелёт осуществляется на регулярных рейсах

65536 - Тур где перелёт осуществляется на чартерных рейсах

131072 - Туры на транспорте в виде Автобуса

262144 - Туры на транспорте в виде ЖД дороги
|-
| 
Found
|  
|  
|-
| 
GiftCaption
|  
|
Данный параметр устарел.  
|-
| 
HotelDescription
| 
String
| 
Краткое описание отеля. Выдаётся только если параметр includeDescriptions имеет значение “true”. Может быть пустым, если отель не слинкован или не имеет описания.
|-
| 
HotelDescriptionUrl
| 
String
| 
Ссылка на описание отеля.
|-
| 
HotelId
| 
Int32
| 
Идентификатор отеля. Если отель не слинкован, принимает значение “0”.
|-
| 
HotelIsInStop
| 
Enum
| 
Наличие мест в отеле. Возможные значения: Stop – нет мест, Available – есть места, Request – под запрос, и Unknown – нет данных.
|-
|IncludeServices
|array
|Данное поле представляет собой массив id включенных в тур услуг.
|- 
|
HotelName
| 
String
| 
Название отеля.
|-
| 
HotelPhotosCount
| 
Int32
| 
Количество фотографий отеля.
|-
| 
HotelRating
| 
Single
| 
Рейтинг отеля по десятибалльной шкале. Если рейтинг отсутствует, поле принимает значение “0”.
|-
| 
HotelTitleImageUrl
| 
String
| 
Ссылка на титульное изображение отеля в уменьшенном виде (115x80). Размеры изображения могут быть указаны самостоятельно с используется следующего шаблона ссылки:

https://hotels.sletat.ru/i/p/{hotel_id}_{image_index}_{h}_{w}.jpg – где:
* {hotel_id} – идентификатор отеля;
* {image_index} – индексизображения отеля, начинается с 0;
* {h} – высота изображения (максимальное значение 300);
* {w} – требуемая ширина изображения (максимальное значение 300);

Изображения не предоставляются для неслинкованных отелей, а также для отелей с отсутствующим описанием.
|-
| 
HtPlaceDescription
| 
String
| 
Описание размещения, выдаётся только если параметр '''includeDescriptions''' имеет значение “true”. Может быть пустым, если размещение не слинковано или не имеет описания.
|-
| 
HtPlaceId
| 
Int32
| 
Идентификатор типа размещения. Если данные не слинкованы, поле принимает значение “0”.
|-
| 
HtPlaceName
| 
String
| 
Тип размещения.
|-
| 
IsDemoMode
| 
Boolean
| 
Если выдача производится в
демо-режиме, поле принимает значение “true”. В демо-режиме не отображаются
цены, а также все результаты поиска заполнены демонстрационными данными.
|-
| 
Kids
| 
Int32
| 
Количество туристов (детей).
|-
| 
MealDescription
| 
String
| 
Описание типа питания. Выдаётся только если параметр includeDescriptions имеет значение “true”. Может быть пустым, если данные не слинкованы или тип питания не описан.
|-
| 
MealId
| 
Int32
| 
Идентификатор типа питания. Если данные не слинкованы, поле принимает значение “0”.
|-
| 
MealName
| 
String
| 
Тип питания.
|-
| 
Nights
| 
Int32
| 
Продолжительность тура (ночей).
|-
| 
OfferId
| 
Int64
| 
Идентификатор ценового предложения. Используется вместе с SourceId для актуализации тура и оформлении заказа.
|-
| 
OfferIdStr
|
String  
|
Идентификатор ценового предложения в строковом формате.  
|-
| 
OriginalHotelName
| 
String
| 
Название отеля по данным туроператора.
|-
| 
OriginalStarName
| 
String
| 
Категории отеля по данным туроператора.
|-
| 
OriginalTownName
| 
String
| 
Название курорта по данным туроператора.
|-
| 
OriginalMealName
| 
String
| 
Тип питания по данным туроператора.
|-
| 
OriginalHtPlaceName
| 
String
| 
Тип размещения по данным туроператора.
|-
| 
OriginalRoomName
| 
String
| 
Типа номера по данным туроператора.
|-
| 
Price
| 
Int32
| 
Цена тура в запрошенной валюте.
|-
| 
PriceType
| 
Int32
| 
Тип цены. Возможные значения: 0 – полная цена тура, 1- цена в пересчёте на человека. Независимо от типа цены стоимость тура выдаётся конечной.
|-
|
RawPrice
| 
Int32
| 
Цена тура без скидок и наценок, задаваемых в личном кабинете sletat.ru
|-
|  
ReceivingParty
|  
|
Данный параметр устарел.   
|-
| 
ResortDescriptionUrl
| 
String
| 
Ссылка на описание курорта. Строка может быть пустой, если курорт не слинкован или не имеет ссылки на описание.
|-
| 
ResortId
| 
Int32
| 
Идентификатор курорта. Если курорт не слинкован, поле принимает значение “0”.
|-
| 
ResortName
| 
String
| 
Курорт.
|-
| 
RoomId
| 
Int32
| 
Идентификатор типа номера. Если тип номера не слинкован, поле принимает значение “0”.
|-
| 
RoomName
| 
String
| 
Тип номера.
|-
| 
SourceId
| 
Int32
| 
Зашифрованный идентификатор туроператора, значение используется вместе с '''OfferId''' при актуализации и заказе туров. В расширенной версии сервиса предоставляется оригинальный идентификатор туроператора (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
| 
SourceImageUrl
| 
String
| 
Ссылка на логотип туроператора. Поле заполняется только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
| 
SourceName
| 
String
| 
Наименование туроператора. Поле заполняется только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
| 
SourceSearchFormUrl
| 
String
| 
Ссылка на форму поиска туроператора. Поле заполняется только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
| 
StarId
| 
Int32
| 
Идентификатор категории отеля. Если данные не слинкованы, поле принимает значение “0”.
|-
| 
StarName
| 
String
| 
Категория отеля.
|-
| 
TicketsIncluded
| 
Enum
| 
Состав турпакета. Возможные значения: '''NotIncluded''' – авиаперелёт не включён в стоимость тура, '''Included''' – авиаперелёт включён, и '''Unknown''' – нет данных.
|-
| 
TourArchiveHash
|  
|
Хэш тура для поиска цены в сервисе аналитики  
|-
| 
TourHash
|  
| 
Уникальный хэш тура. 
|-
| 
TourName
| 
String
| 
Название тура. Поле может быть пустым, если туроператор не предоставляет таких данных.
|-
| 
TourUrl
| 
String
| 
Ссылка на описание / бронирование тура на сайте туроператора, Поле заполняется только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
На момент написания настоящего руководства некоторые туроператоры не имеют ссылок в сервисе Слетать.ру.
|}

Элемент '''Visa''' содержит информацию о стоимости визы.
 
Поля элемента Visa:
{| class="wikitable"
|-
| 
Поле
| 
Тип
| 
Описание
|-
| 
Price
| 
Int32
| 
Размер визового сбора
|-
| 
CurrencyName
| 
String
| 
Валюта поля Price. Возможные значения: RUB, USD, EUR, BYN, UAH.
|}

Элемент Visa может быть пустым (NULL), если в системе нет информации о стоимости визы. Если элемент Visa не пустой, то все вложенные элементы обязательно имеют значение.
 
Структура OilTaxes заполняется информацией о топливных сборах (элементы XmlTourOilTax) для туров в результате поиска.
 
Поля элемента '''XmlTourOilTax''' (знаком * отмечены обязательные поля):

{| class="wikitable"
|-
| 
Поле
| 
Тип
| 
Описание
|-
|AgeFrom
|Int32
|Возраст туриста, от которого включается данный топливный сбор.
|-
|AgeTo
|Int32
|Возраст туриста, до которого включается данный топливный сбор.
|-
| 
AirCompanyName
| 
String
| 
Название авиакомпании, к которой относится информация по топливному сбору. Если информация относится ко всем авиакомпаниям, поле остаётся пустым.
Может быть несколько элементов '''OilTax''' с одинаковыми значениями всех полей, кроме '''AirCompanyName''' и '''Tax'''. Таким образом сообщается информация о размерах топливных сборов у разных авиакомпаний. Если у одного из элементов '''OilTax''' поле '''AirCompanyName''' оставлено пустым, то информация этого элемента относится ко всем авиакомпаниям, а остальные элементы '''OilTax''' описывают исключения.
|-
| 
AirportName
| 
String
| 
Название аэропорта.
|-
| 
CurrencyName*
| 
String
| 
Валюта поля Tax. Возможные значения: RUB, USD, EUR, BYN, UAH.
|-
| 
Date1*
| 
DateTime
| 
Дата начала действия топливного сбора.
|-
| 
Date2*
| 
DateTime
| 
Дата окончания действия топливного сбора.
|-
| 
FlightNumber
| 
Int32
| 
Номер рейса, к которому применяется сбор. Если информация относится ко всем авиакомпаниям, поле остаётся пустым.
|-
| 
PartnerName
| 
String
| 
Принимающая сторона. Если поле заполнено, топливный сбор действителен только для туров с указанной принимающей стороной.

Если топливный сбор действителен для всех принимающих сторон, поле остаётся пустым.

Может быть несколько элементов '''OilTax''' с одинаковыми значениями всех полей, кроме '''PartnerName''' и '''Tax'''.
|-
| 
ResortId
| 
Int32
| 
Идентификатор курорта.
|-
| 
ResortName
|  
| 
Название курорта.
|-
| 
SourceId*
| 
Int32
| 
Идентификатор туроператора в зашифрованном виде. В расширенной версии сервиса поле содержат оригинальные идентификаторы туроператоров (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
| 
Tax *
| 
Int32
| 
Размер топливного сбора. Если топливный сбор отсутствует, поле принимает значение “0”.
|}

Если в системе нет информации по топливным сборам для тура, то множество элементов '''OilTax''' будет пустым (NULL).

Чтобы сопоставить туры из выдачи и элементы '''XmlTOilTax''', нужно отфильтровать элементы '''OilTax''' по параметру '''SouceId''', и отобрать туры, даты вылета которых попадают в диапазон, заданный полями '''Date1''' и '''Date2'''.

==== ContinueSearch ====

Метод '''ContinueSearch''' создаёт новый поисковый запрос с использованием данных предыдущего. Логика работы метода:

# Проверяется статус обработки исходного поискового запроса (значение requestId последнего указывается в запросе метода '''ContinueSearch'''). Если поиск по проверяемому запросу ещё не завершён (т. е. если хотя бы один оператор ещё не выставил значение поля IsProcessed “true”), возвращается текст с описанием ошибки.
# Если проверяемый запрос обработан, то максимальная цена в его выдаче увеличивается на единицу и становится минимальной для нового запроса.
# Метод '''ContinueSearch''' создаёт новый поисковый запрос (в статистике такие запросы также учитываются как новые) и возвращает его идентификатор. Все параметры нового поискового запроса, кроме цены, остаются теми же, что и параметры исходного.
# Полученный запрос обрабатывается методами '''[[#GetRequestState | GetRequestState]]''' и '''[[#GetRequestResult | GetRequestResult]]'''.

{| class="standard"
| style="background-color:silver" |Важно! Продолжение поиска возможно в течение 20 минут c начала предыдущего поиска.
|}

Сигнатура:

 XmlContinueSearchData ContinueSearch(
                              Int32 requestId)

Метод принимает единственный параметр requestId – идентификатор завершённого поискового запроса.
 
Пример SOAP-запроса:

<source lang="xml">

<s:Envelope
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
>
  <s:Body>
    <ContinueSearch
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <requestId>69587384</requestId>
    </ContinueSearch>
  </s:Body>
</s:Envelope>

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
>
  <s:Body>
    <ContinueSearchResponse
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <ContinueSearchResult
        xmlns:a="urn:SletatRu:DataTypes:XmlContinueSearchData:v1"
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
      >
        <a:RequestId>69587436</a:RequestId>
      </ContinueSearchResult>
    </ContinueSearchResponse>
  </s:Body>
</s:Envelope>

</source>

Структура '''XmlContinueSearchData''' содержит поле '''RequestId''' с идентификатором нового поискового запроса.

=== ActualizePrice ===

Метод ActualizePrice необходим для актуализации предложений туроператоров.
 
Сигнатура:

 XmlActualPriceData ActualizePrice(
                            Int32 sourceId,
                            Int64 offerId,
                            Int32 requestId)

Параметры:

{| class="wikitable"
|-
| 
Параметр
| 
Тип
| 
Описание
|-
| 
requestId
| 
Int32
| 
Идентификатор поискового запроса. Выдаётся методами '''[[#CreateRequest | CreateRequest]]''' или '''[[#ContinueSearch | ContinueSearch]]'''.
|-
| 
offerId
| 
Int64
| 
Идентификатор ценового предложения. Выдаётся каждому туру методом '''[[#GetRequestResult | GetRequestResult]]'''.
|-
| 
sourceId
| 
Int32
| 
Зашифрованный идентификатор туроператора. Выдаётся каждому туру методом '''[[#GetRequestResult | GetRequestResult]]'''.
|-
| 
login
| 
| 
Логин от личного кабинета туроператора.
|-
| 
password
| 
| 
Пароль от личного кабинета туроператора.
|}

{| class="standard"
| style="background-color:silver" |Важно! При отсутствии в запросе логина и пароля от личного кабинета туроператора актуализация цены тура может быть не проведена. Ошибки при этом не возникнет.
|}

Пример SOAP-запроса:

<source lang="xml">

<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ActualizePrice xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
      <sourceId>14173204</sourceId>
      <offerId>1287318711</offerId>
      <requestId>2862432</requestId>
      <login>****</login>
      <password>***</password>
    </ActualizePrice>
  </soap:Body>
</soap:Envelope>

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope
  xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
>
  <s:Body>
    <ActualizePriceResponse
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <ActualizePriceResult xmlns:a="urn:SletatRu:DataTypes:XmlActualPriceData:v1" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:ErrorMessage i:nil="true"/>
                <a:IsError>false</a:IsError>
                <a:IsFound>true</a:IsFound>
                <a:NextPossibleCommands i:nil="true" xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                <a:OilTaxes xmlns:b="urn:SletatRu:DataTypes:XmlOilTax:v1">
                    <b:XmlOilTax>
                        <b:AgeFrom i:nil="true"/>
                        <b:AgeTo i:nil="true"/>
                        <b:AirCompanyName i:nil="true"/>
                        <b:AirportName i:nil="true"/>
                        <b:CurrencyName i:nil="true"/>
                        <b:FlightNumber i:nil="true"/>
                        <b:HostName i:nil="true"/>
                        <b:PartnerName>Good Time Travel</b:PartnerName>
                        <b:PeriodEndDate>31.12.2020</b:PeriodEndDate>
                        <b:PeriodStartDate>21.12.2018</b:PeriodStartDate>
                        <b:ResortName i:nil="true"/>
                        <b:Tax>0</b:Tax>
                    </b:XmlOilTax>
                </a:OilTaxes>
                <a:RandomNumber>2661</a:RandomNumber>
                <a:ResourceData xmlns:b="urn:SletatRu:DataTypes:XmlResourceData:v1">
                    <b:XmlResourceData>
                        <b:Name>AIRLINE</b:Name>
                        <b:ResourceId>-591287990</b:ResourceId>
                        <b:Value>Turkish Airlines</b:Value>
                    </b:XmlResourceData>
                    <b:XmlResourceData>
                        <b:Name>FLIGHT</b:Name>
                        <b:ResourceId>-591287990</b:ResourceId>
                        <b:Value>TK 420</b:Value>
                    </b:XmlResourceData>
                    <b:XmlResourceData>
                        <b:Name>AIRPORT_FROM</b:Name>
                        <b:ResourceId>-591287990</b:ResourceId>
                        <b:Value>VKO</b:Value>
                    </b:XmlResourceData>
                    <b:XmlResourceData>
                        <b:Name>AIRPORT_TO</b:Name>
                        <b:ResourceId>-591287990</b:ResourceId>
                        <b:Value>IST</b:Value>
                    </b:XmlResourceData>

               <a:Resources xmlns:b="urn:SletatRu:DataTypes:XmlResource:v1">
                    <b:XmlResource>
                        <b:Exclude/>
                        <b:GroupId>-759022283</b:GroupId>
                        <b:Id>-591287990</b:Id>
                        <b:IsChecked>true</b:IsChecked>
                        <b:IsEnabled>true</b:IsEnabled>
                        <b:LinkGroupsId>1146194747</b:LinkGroupsId>
                        <b:Name>TK 420 Москва VKO 08:40 - Стамбул IST 00:55</b:Name>
                        <b:Surcharge>0</b:Surcharge>
                        <b:SurchargeCurrencyId>5</b:SurchargeCurrencyId>
                        <b:SurchargeCurrencyIdOriginal i:nil="true"/>
                        <b:SurchargeOriginal i:nil="true"/>
                        <b:Type>4</b:Type>
                    </b:XmlResource>
                    <b:XmlResource>
                        <b:Exclude/>
                        <b:GroupId>1252486320</b:GroupId>
                        <b:Id>-591287988</b:Id>
                        <b:IsChecked>false</b:IsChecked>
                        <b:IsEnabled>true</b:IsEnabled>
                        <b:LinkGroupsId>895852864</b:LinkGroupsId>
                        <b:Name>TK 420 Москва VKO 08:40 - Стамбул IST 00:55</b:Name>
                        <b:Surcharge>0</b:Surcharge>
                        <b:SurchargeCurrencyId>5</b:SurchargeCurrencyId>
                        <b:SurchargeCurrencyIdOriginal i:nil="true"/>
                        <b:SurchargeOriginal i:nil="true"/>
                        <b:Type>4</b:Type>
                    </b:XmlResource>
                    <b:XmlResource>
                        <b:Exclude/>
                        <b:GroupId>281026895</b:GroupId>
                        <b:Id>-591287986</b:Id>
                        <b:IsChecked>false</b:IsChecked>
                        <b:IsEnabled>true</b:IsEnabled>
                        <b:LinkGroupsId>-380643850</b:LinkGroupsId>
                        <b:Name>TK 420 Москва VKO 08:40 - Стамбул IST 00:55</b:Name>
                        <b:Surcharge>0</b:Surcharge>
                        <b:SurchargeCurrencyId>5</b:SurchargeCurrencyId>
                        <b:SurchargeCurrencyIdOriginal i:nil="true"/>
                        <b:SurchargeOriginal i:nil="true"/>
                        <b:Type>4</b:Type>
                    </b:XmlResource>
                    <b:XmlResource>
                        <b:Exclude/>
                        <b:GroupId>-730380720</b:GroupId>
                        <b:Id>-971584364</b:Id>
                        <b:IsChecked>false</b:IsChecked>
                        <b:IsEnabled>true</b:IsEnabled>
                        <b:LinkGroupsId>-764732685</b:LinkGroupsId>
                        <b:Name>TK 412 Москва VKO 02:50 - Стамбул IST 00:55</b:Name>
                        <b:Surcharge>11632.44</b:Surcharge>
                        <b:SurchargeCurrencyId>5</b:SurchargeCurrencyId>
                        <b:SurchargeCurrencyIdOriginal i:nil="true"/>
                        <b:SurchargeOriginal i:nil="true"/>
                        <b:Type>4</b:Type>
                    </b:XmlResource>
                    <b:XmlResource>
                        <b:Exclude/>
                        <b:GroupId>398232089</b:GroupId>
                        <b:Id>792404789</b:Id>
                        <b:IsChecked>false</b:IsChecked>
                        <b:IsEnabled>true</b:IsEnabled>
                        <b:LinkGroupsId>1087744587</b:LinkGroupsId>
                        <b:Name>TK 414 Москва VKO 12:10 - Стамбул IST 00:55</b:Name>
                        <b:Surcharge>11632.44</b:Surcharge>
                        <b:SurchargeCurrencyId>5</b:SurchargeCurrencyId>
                        <b:SurchargeCurrencyIdOriginal i:nil="true"/>
                        <b:SurchargeOriginal i:nil="true"/>
                        <b:Type>4</b:Type>
                    </b:XmlResource>

                <a:SessionId>fUEmNh59tkadYw+IZdd1jQ==</a:SessionId>
                <a:TourInfo xmlns:b="urn:SletatRu:DataTypes:XmlActualTourInfo:v1">
                    <b:Adults>2</b:Adults>
                    <b:BusinessTicketsDpt>Stop</b:BusinessTicketsDpt>
                    <b:BusinessTicketsRtn>Stop</b:BusinessTicketsRtn>
                    <b:CheckIn>20.09.2019</b:CheckIn>
                    <b:CheckOut>27.09.2019</b:CheckOut>
                    <b:CityFromName>Москва</b:CityFromName>
                    <b:CountryName>Египет</b:CountryName>
                    <b:EconomTicketsDpt>Available</b:EconomTicketsDpt>
                    <b:EconomTicketsRtn>Available</b:EconomTicketsRtn>
                    <b:ExactOriginalPrice>126051</b:ExactOriginalPrice>
                    <b:ExactPrice>126051</b:ExactPrice>
                    <b:Flags>0</b:Flags>
                    <b:Hash>WP9Rc2J6mxoVkL/sd2XX+w==</b:Hash>
                    <b:HotelDesc/>
                    <b:HotelDescriptionUrl>https://hotels.sletat.ru/?id=104601</b:HotelDescriptionUrl>
                    <b:HotelIsInStop>Request</b:HotelIsInStop>
                    <b:HotelName>Mazar Resort &amp; Spa</b:HotelName>
                    <b:HotelPhotosCount>9</b:HotelPhotosCount>
                    <b:HotelTitleImageUrl>https://hotels.sletat.ru/i/p/104601_0.jpg</b:HotelTitleImageUrl>
                    <b:HtPlaceDesc>двухместный номер</b:HtPlaceDesc>
                    <b:HtPlaceName>DBL</b:HtPlaceName>
                    <b:Kids>0</b:Kids>
                    <b:MealDesc>Завтраки и ужины</b:MealDesc>
                    <b:MealName>HB</b:MealName>
                    <b:Nights>7</b:Nights>
                    <b:OfferId>1359485512</b:OfferId>
                    <b:OriginalCurrencyId>5</b:OriginalCurrencyId>
                    <b:OriginalPrice>126051</b:OriginalPrice>
                    <b:OriginalPriceCurrency>USD</b:OriginalPriceCurrency>
                    <b:Price>126051</b:Price>
                    <b:PriceCurrency>RUB</b:PriceCurrency>
                    <b:Rating>0</b:Rating>
                    <b:RequestId>592411141</b:RequestId>
                    <b:ResortName>Sharks Bay</b:ResortName>
                    <b:RoomName>STANDARD</b:RoomName>
                    <b:SourceId>304</b:SourceId>
                    <b:SourceName>Good Time Travel</b:SourceName>
                    <b:SourceSearchFormUrl>http://online.goodtimetravel.ru/search_tour</b:SourceSearchFormUrl>
                    <b:StarName>3*</b:StarName>
                    <b:SysCityFromId>832</b:SysCityFromId>
                    <b:SysCityFromName>Москва</b:SysCityFromName>
                    <b:SysCountryId>40</b:SysCountryId>
                    <b:SysCountryName>Египет</b:SysCountryName>
                    <b:SysHotelId>104601</b:SysHotelId>
                    <b:SysHotelName>Mazar Resort &amp; Spa</b:SysHotelName>
                    <b:SysHtPlaceId>13103</b:SysHtPlaceId>
                    <b:SysHtPlaceName>DBL</b:SysHtPlaceName>
                    <b:SysMealId>113</b:SysMealId>
                    <b:SysMealName>HB</b:SysMealName>
                    <b:SysResortId>1642</b:SysResortId>
                    <b:SysResortName>Шарм-Эль-Шейх</b:SysResortName>
                    <b:SysRoomId>5283</b:SysRoomId>
                    <b:SysRoomName>Standard</b:SysRoomName>
                    <b:SysStarId>402</b:SysStarId>
                    <b:SysStarName>3*</b:SysStarName>
                    <b:TicketsIncluded>Included</b:TicketsIncluded>
                    <b:TourName>Шарм-Эль-Шейх.Рег.рейсы SH1</b:TourName>
                    <b:TourUrl>https://sletat.ru/book/Good Time Travel/MzA0fDEzNTk0ODU1MTJ8ODMyfDU5MjQxMTE0MXw%3d</b:TourUrl>
                </a:TourInfo>
      </ActualizePriceResult>
    </ActualizePriceResponse>
  </s:Body>
</s:Envelope>

</source>

В ответ возвращается структура '''ActualizePriceResult''', состоящая из следующих полей:

* '''IsError''' – принимает значение “true”, если при актуализации тура возникла ошибка.
* '''IsFound''' – поле принимает значение “false”, если тур не был найден в базе туроператора;
* '''RandomNumber''' – случайное четырехзначное число, по которому можно просмотреть информацию о туре в личном кабинете на сайте sletat.ru или в программе SletatRu Agent, используется для того, чтобы ваши менеджеры могли точно идентифицировать тур, который клиент нашёл самостоятельно;
* '''ResourceId'''
* '''TourInfo''' – структура, содержащая основную информацию о туре;

В полях массива <b>Resources</b> представлены данные о перелетах с type = 4 (в сторону курорта) и с type = 10 (в обратную). По-данному id в массиве <b>ResourceData</b> можно найти описание перелетов (Имена аэропортов, городов вылета и т.д.)

Пример:

Путь в структуре ответа до данных о наличии перелета обратно: ActualizePriceResult.Resources [1] (где type = 10, id = 1)

Путь в структуре ответа до подробной информации о перелете обратно: ActualizePriceResult.ResourceData[0] (где resourceId = 1)

Сопоставление данных перелета и записи о его наличии происходит через id == resourceId.

Поля структуры <b>ResourceId</b>

{| class="wikitable"
|-
| 
Параметр
| 
Тип
| 
Описание
|-
| 
id
| 
long
| 
Идентификатор перелета
|-
| 
linkGroupsId
| 
long
| 
Идентификатор группы перелетов
|-
| 
surcharge
| 
int
| 
Cумма доплат за выбранные перелеты
|-
| 
surchargeCurrencyId
| 
byte
| 
Валюта доплаты за авиаперелеты
|}
Поля структуры '''TourInfo''':

{| class="wikitable"
| 
Поле
| 
Тип
| 
Описание
|-
| 
CountryName
| 
String
| 
Название страна по данным
туроператора.
|-
| 
CityFromName
| 
String
| 
Название города вылета по данным
туроператора.
|-
| 
ResortName
| 
String
| 
Название курорта по данным
туроператора.
|-
| 
TourName
| 
String
| 
Название тура по данным
туроператора.
|-
| 
TourDate
| 
String
| 
Дата вылета в формате
dd.MM.yyyy.
|-
| 
Nights
| 
Int32
| 
Продолжительность тура
(ночей).
|-
| 
HotelName
| 
String
| 
Название отеля по данным туроператора.
|-
| 
StarName
| 
String
| 
Категория отеля по данным
туроператора.
|-
| 
RoomName
| 
String
| 
Тип номера по данным
туроператора.
|-
| 
MealName
| 
String
| 
Тип питания по данным
туроператора.
|-
| 
TicketsIncluded
| 
Enum
| 
Состав турпакета. Возможные значения: NotIncluded – авиаперелёт в стоимость тура не включён, Included – авиаперелёт включён, и Unknown – нет данных.
|-
| 
HotelIsInStop
| 
Enum
| 
Наличие мест в отеле. Возможные значения: Stop – нет мест, Available – есть места, Request – под запрос, и Unknown – нет данных.
|-
| 
EconomTicketsDpt
| 
Enum
| 
Наличие билетов эконом-класса (туда). Возможные значения: Stop – нет билетов, Available – есть билеты, Request – под запрос, и Unknown – нет данных.
|-
| 
EconomTicketsRtn
| 
Enum
| 
Наличие билетов эконом-класса (обратно). Возможные значения: Stop – нет билетов, Available – есть билеты, Request – под запрос, и Unknown – нет данных.
|-
| 
BusinessTicketsDpt
| 
Enum
| 
Наличие билетов
бизнес-класса (туда). Возможные значения: Stop – нет билетов, Available
– есть билеты, Request – под запрос, и Unknown – нет
данных.
|-
| 
BusinessTicketsRtn
| 
Enum
| 
Наличие билетов бизнес-класса (обратно). Возможные значения: Stop – нет билетов, Available – есть билеты, Request – под запрос, и Unknown – нет данных.
|-
| 
HtPlaceName
| 
String
| 
Тип размещения по данным туроператора.
|-
| 
Price
| 
Int32
| 
Цена тура в запрошенной валюте (со скидкой и наценкой).
|-
| 
PriceCurrency
| 
String
| 
Обозначение валюты. Возможные значения: RUB, EUR, USD, BYN, UAH.
|-
| 
OriginalPrice
| 
Int32
| 
Оригинальная цена тура в исходной валюте (со скидкой и наценкой).
|-
| 
OriginalPriceCurrency
| 
String
| 
Обозначение валюты (по данным туроператора) поля '''OriginalPrice'''.
|-
| 
SourceId
| 
Int32
| 
Идентификатор туроператора. Поле заполняется только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
| 
SourceName
| 
String
| 
Наименование туроператора. Поле заполняется только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в службу поддержки support@sletat.ru).
|-
| 
SourceSearchFormUrl
| 
String
| 
Ссылка на форму поиска туроператора. Поле заполняется только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
| 
SysCountryId
| 
Int32
| 
Идентификатор страны по справочнику стран.
|-
| 
SysCountryName
| 
String
| 
Название страны по справочнику стран.
|-
| 
SysCityFromId
| 
Int32
| 
Идентификатор города вылета по справочнику городов вылета.
|-
| 
SysCityFromName
| 
String
| 
Название города вылета по справочнику городов вылета.
|-
| 
SysResortId
| 
Int32
| 
Идентификатор курорта по справочнику курортов. Если курорт туроператора не слинкован, поле принимает значение “0”.
|-
| 
SysResortName
| 
String
| 
Название курорта по
справочнику курортов. Если курорт туроператора не слинкован, поле принимает
пустое значение.
|-
| 
SysHotelId
| 
Int32
| 
Идентификатор отеля по
справочнику отелей. Если отель туроператора не слинкован, поле принимает
значение “0”.
|-
| 
SysHotelName
| 
String
| 
Название отеля по справочнику
отелей. Если отель туроператора не слинкован, поле принимает пустое значение.
|-
| 
SysStarId
| 
Int32
| 
Идентификатор категории
отеля по справочнику. Если категория отеля туроператора не слинкована, поле принимает
значение “0”.
|-
| 
SysStarName
| 
String
| 
Категория отеля по
справочнику. Если категория отеля туроператора не слинкована, поле принимает
пустое значение.
|-
| 
SysRoomId
| 
Int32
| 
Идентификатор типа номера по
справочнику. Если тип номера туроператора не слинкован, поле принимает
значение “0”.
|-
| 
SysRoomName
| 
String
| 
Тип номера по справочнику. Если
тип номера туроператора не слинкован, поле принимает пустое значение.
|-
| 
SysMealId
| 
Int32
| 
Идентификатор типа питания по
справочнику. Если тип питания туроператора не слинкован, поле принимает
значение “0”.
|-
| 
SysMealName
| 
String
| 
Тип питания по справочнику. Если
тип питания туроператора не слинкован, поле принимает пустое значение.
|-
| 
SysHtPlaceId
| 
Int32
| 
Идентификатор типа
размещения по справочнику. Если тип размещения туроператора не слинкован, поле
принимает значение “0”.
|-
| 
SysHtPlaceName
| 
String
| 
Тип размещения. Если
размещение туроператора не слинковано, поле принимает пустое значение.
|-
| 
HotelDescriptionUrl
| 
String
| 
Ссылка на описание отеля.
|-
| 
HotelTitleImageUrl
| 
String
| 
Ссылка на титульное изображение отеля в уменьшенном виде (115x80). Вы можете изменить размеры изображения, используя шаблон ссылки:

https://hotels.sletat.ru/i/p/{hotel_id}_{image_index}_{h}_{w}.jpg – где:

* {hotel_id} – идентификатор отеля;
* {image_index} – индекс изображения отеля, начинается с 0;
* {h} – высота изображения (максимальное значение 300);
* {w} – требуемая ширина изображения (максимальное значение 300);

Изображения не предоставляются для неслинкованных отелей, а также для отелей с отсутствующим описанием.
|-
| 
HotelPhotosCount
| 
Int32
| 
Количество фотографий отеля.
|-
| 
TourUrl
| 
String
| 
Ссылка на описание / бронирование тура на сайте туроператора. Поле заполняется только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
На момент написания настоящего руководства некоторые туроператоры не имеют ссылок в сервисе Слетать.ру.
|-
| 
OriginalCurrencyId
| 
Int32
| 
Идентификатор валюты тура по данным туроператора. Возможные значения: 2 – USD, 3 – EUR, 5 – RUR.
|-
|Adults
|Int32
|Количество туристов (взрослых).
|-
|Kids
|Int32
|Количество туристов (детей).
|-
|BAGGAGE_PLACES 
|string
|Количество мест.
|-
|BAGGAGE_WEIGHTS
|string
|Веса багажа для каждого из мест (по порядку).
|-
|BAGGAGE_INCLUDED
|string
|Идентификатор, показывающий, включён ли багаж в рейс. Возможные значения: true - включен, false - не включен.
|}
{| class="standard sWarning"
|Параметр <b>BAGGAGE_INCLUDED</b> может иметь значение "<b>true</b>", но если параметр <b>BAGGAGE_PLACES = 0</b> - то трактовать надо так, что багаж не включен.
|}

=== ActualizePriceByCode ===

Метод '''ActualizePriceByCode''' позволяет получать информацию о туре по пятизначному коду с сайта sletat.ru или по четырёхзначному коду, полученному с помощью метода актуализации расширенного сервиса поиска XML/JSON. Пятизначные коды отображаются на сайте sletat.ru в поиске, а также в разделе «Горящие туры».
 
Сигнатура:

 XmlActualPriceData ActualizePriceByCode(
                            Int32 code)

Метод принимает единственный параметр '''code''' – пятизначный код тура с сайта Sletat.Ru (целое число 10000-99999) или четырёхзначный код (целое число 1000-9999).
 
Пример SOAP-запроса:

<source lang="xml">

<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
>
  <soap:Body>
    <ActualizePriceByCode
      xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"
    >
      <code>9999</code>
    </ActualizePriceByCode>
  </soap:Body>
</soap:Envelope>

</source>

Ответ идентичен выдаче метода '''ActualizePrice'''.
 
Выполнение метода может быть завершено с ошибкой по следующим причинам:
 
* код тура устарел (действителен сутки с момента получения);
* код тура указан неверно (принимаются только четырёхзначные коды с сайта sletat.ru);
* нет подходящей лицензии для выполнения запроса (был указан трёхзначный код тура, но у клиента нет действительной лицензии на сервис актуализации или на расширенный сервис XML/JSON.
 
Описание ошибок всегда возвращается.

=== SaveTourOrder ===

Метод '''SaveTourOrder''' добавляет заказ тура в систему Слетать.ру. В вашем личном кабинете на сайте sletat.ru вы можете настроить SMS- и email-уведомления о новых заказах. Приложение SletatRu Agent для Windows также отслеживает новые заказы и присылает вам оповещения.
 
Сигнатура:

 void SaveTourOrder(
         Int32 requestId,
         Int64 offerId,
         Int32 sourceId,
         String user,
         String email,
         String phone,
         String info
         Int32 officeId)

Параметры:

{| class="wikitable"
|-
| 
Параметр
| 
Тип
| 
Описание
|-
| 
requestId
| 
Int32
| 
Идентификатор поискового запроса. Выдаётся методами '''[[#CreateRequest | CreateRequest]]''' или '''[[#ContinueSearch | ContinueSearch]]''' при создании нового поискового запроса;
|-
| 
offerId
| 
Int64
| 
Идентификатор ценового предложения. Выдаётся каждому туру методом '''[[#GetRequestResult | GetRequestResult]]'''.
|-
| 
sourceId
| 
Int32
| 
Идентификатор туроператора. Выдаётся каждому туру методом '''[[#GetRequestResult | GetRequestResult]]'''.
|-
| 
user
| 
String
| 
Имя туриста.
|-
| 
email
| 
String
| 
Контактный e-mail.
|-
| 
phone
| 
String
| 
Контактный телефон.
|-
| info
| String
| Комментарий туриста (необязательное поле).
|-
| officeId
| Int
| Идентификатор офиса, к которому привяжется созданная заявка. Получить список идентификаторов активных офисов можно обратившись к справочнику '''GetOffices''': https://module.sletat.ru/Main.svc/GetOffices?login=login&password=pass
|-
|originType
|
|Служебный параметр. Используется для внутренних сервисов Слетать.ру
|-
|touristId
|
|Служебный параметр. Используется для внутренних сервисов Слетать.ру
|-
|subwayIds
|
|Служебный параметр. Используется для внутренних сервисов Слетать.ру
|}

Пример SOAP-запроса:

<source lang="xml">

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SaveTourOrder xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
      <requestId>2857817</requestId>
      <offerId>225355464</offerId>
      <sourceId>14146146</sourceId>
      <user>John Doe</user>
      <email>johndoe@sample.com</email>
      <phone>+7 905 555 55 55</phone>
      <info>any additional information here</info>
    </SaveTourOrder>
  </soap:Body>
</soap:Envelope>

</source>

Пример SOAP-ответа:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <SaveTourOrderResponse xmlns="urn:SletatRu:Contracts:Soap11Gate:v1"/>
  </s:Body>
</s:Envelope>

</source>

В случае успешного добавления заказа никакой информации метод не возвращает.

=== AddLargeComment ===

Метод '''AddLargeComment''' добавляет отзыв к отелю.

Параметры:

{| class="wikitable"
|-
|Параметр
|Тип
|Описание
|-
|rate
| 
|Рейтинг (оценка отелю).
|-
|positive 
| 
|Что понравилось в отеле.
|-
|negative
| 
|Что не понравилось в отеле.
|-
|touristName
| 
|Имя туриста.
|-
|startRest
| 
|Начало проживание в отеле.
|-
|endRest
| 
|Окончание проживание в отеле.
|-
|hotelId
| 
|Идентификатор отеля
|}