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

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

2026-05-28T06:48:31Z

Kdadmin: Полностью удалено содержимое страницы

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

2026-05-28T06:43:22Z

Kdadmin: Снята защита с «Суточный кеш (xml)»

[[Category:Расширения и дополнения]]
== Описание сервиса ==

Сервис предназначен для выгрузки кеша туров проекта Слетать.ру в базу данных клиента. Раз в час система подготавливает сжатые алгоритмом GZIP XML-пакеты с новыми турами, по одному пакету на каждое направление ото всех туроператоров. Веб-сервис предоставляет метод для получения списка подготовленных пакетов. API выгрузки кеша – это стандартный веб-сервис, предоставляющий WSDL-документ с описанием всех методов и типов данных. Версия, выпущенная на момент написания настоящего документа, работает только по протоколу HTTPS. Для большей совместимости с различными клиентами сервис основан на SOAP версии 1.1. Взаимодействие с сервисом возможно одним из двух способов:
* Как с обычным веб-сервисом посредством SOAP запросов, WSDL доступен.
* Как с сервисом WCF (Windows Communication Foundation) — самый простой способ, если клиент под .NET Framework 3.5 или выше. Логика обработки запросов не зависит от способа работы с сервисом. При передаче строк и XML-пакетов используется кодировка UTF-8. Сервис не требует сессий при работе с ним, и все методы не зависят друг от друга с точки зрения очередности вызова. Таким образом, очередность вызова методов диктуется реализуемым алгоритмом для работы с поисковым сервисом.

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

{| class="standard"
| style="background-color:silver" |Все описанные ниже методы возвращают информацию только при наличии дополнительной лицензии для доступа к Отельной базе. По всем вопросам обращайтесь в службу поддержки по тел. 8(800)700-33-09 (звонок бесплатный для всех регионов России) или по электронной почте info@sletat.ru.
|}

== Подключение к сервису ==

Чтобы начать работу с сервисом, зарегистрируйтесь на сайте sletat.ru и получите тестовую лицензию в Службе технической поддержки Слетать.ру по электронному адресу info@sletat.ru. После получения лицензии можно начинать работать с API. Для работы с сервисом вам нужно использовать WSDL документ, который расположен по адресу:
https://bulk.sletat.ru/main.svc?singleWSDL

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

=== Клиент на .NET ===

Добавьте в проект ссылку на WSDL-документ используя Service Reference (или Web Reference для проектов на .NET 2.0). Теперь ваш проект готов к работе с сервисом. Ниже приведен пример вызова метода для получения списка городов вылета:

<source lang="xml">

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

</source>

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

== Логика работы с сервисом ==

Сервис предоставляет метод '''GetPacketList''' для получения списка всех доступных для выгрузки пакетов с турами. Каждый пакет имеет указание на город вылета, страну и туроператора, а также на временной интервал, за который пакет включает туры. Используя список, вы можете загрузить либо все туры, либо туры по интересующим направлениям и туроператорам. Каждый пакет имеет уникальный идентификатор, используя который можно загрузить содержимое пакета. Сервис также предоставляет методы для выгрузки топливных и визовых сборов '''GetFuelSurcharges''' и '''GetVisaSurcharges'''.

== Методы ==

В этом разделе описаны все методы поискового сервиса. К методам приведены примеры запросов и ответов в SOAP. Все методы требуют авторизации. Информация для авторизации (логин и пароль) передаётся в заголовке 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>
...
</soap:Body>
</soap:Envelope>

</source>

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

=== GetPacketList ===

Метод '''GetPacketList''' возвращает список всех пакетов, доступных для загрузки. Сигнатура:

PacketInfo[] GetPacketList(DateTime? createDatePoint)

'''CreateDatePoint''' – опциональный параметр; если передан, то будут возвращены пакеты, подготовленные после указанной даты. Каждый пакет ответа имеет следующие поля (знаком * здесь и далее отмечены обязательные поля):

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Id *
|
Int32
|
Идентификатор пакета.
|-
|
DptCityId *
|
Int32
|
Идентификатор города вылета.
|-
|
CountryId *
|
Int32
|
Идентификатор страны.
|-
|
SourceId *
|
Int32
|
Идентификатор туроператора.
|-
|
DateTimeFrom *
|
DateTime
|
Начало временного интервала, за который были собраны обновлённые туры (московское время).
|-
|
DateTimeTo *
|
DateTime
|
Окончание временного интервала, за который были собраны обновлённые туры (московское время).
|-
|
CreateDate *
|
DateTime
|
Дата и время подготовки пакета (московское время).
|}

=== BulkCacheDownload ===

'''BulkCacheDownload''' в интерфейсе сервиса выгрузки кеша является не методом, а отдельным инструментом для загрузки содержимого пакетов по их идентификаторам. Для работы с методом используются HTTP GET-запросы. Использование:

https://bulk.sletat.ru/BulkCacheDownload?packetId=[packetId]

Параметр '''packetId''' – идентификатор пакета.Ответом является сжатый алгоритмом GZIP XML-пакет, MIME-тип устанавливается application/x-gzip. XML-пакет имеет кодировку UTF-8 и несложную структуру в виде корневого элемента '''tours''' и элементов '''tour''', каждый из которых в атрибутах содержит описание одного тура. Ниже в таблице описаны все атрибуты для элементов '''tour''':

{| class="wikitable"
|-
|
Название атрибута
|
Тип
|
Описание
|-
|
adults *
|
Int32
|
Количество туристов (взрослых).
|-
|
hasBusinessTicketsDpt
|
Int32
|
Наличие
билетов бизнес-класса (туда). Возможные значения: 0 (нет билетов), 1 (есть
билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации.
|-
|
hasBusinessTicketsRtn
|
Int32
|
Наличие
билетов бизнес-класса (обратно). Возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
ticketsIncluded *
|
Int32
|
Включает
ли тур в стоимость перелёт: 0 (не включает) и 1 (включает). Если атрибут отсутствует, то нет такой информации о туре.
|-
|
checkIn *
|
String
|
Дата вылета в формате dd.MM.yyyy.
|-
|
hasEconomTicketsDpt
|
Int32
|
Наличие билетов эконом-класса (туда). Возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос).
|-
|
hasEconomTicketsRtn
|
Int32
|
Наличие билетов эконом-класса (обратно), возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
hotelId
|
Int32
|
Идентификатор отеля. Может отсутствовать, если отель не слинкован.
|-
|
hotelIsInStop
|
Int32
|
Наличие мест в отеле. Возможные значения: 1 (нет мест), 0 (есть места), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
hotelName *
|
String
|
Название отеля.
|-
|
htPlaceId
|
Int32
|
Идентификатор размещения. Атрибут может отсутствовать, если размещение не слинковано.
|-
|
htplaceName *
|
String
|
Тип размещения.
|-
|
kids *
|
Int32
|
Количество туристов (детей).
|-
|
kid1age
|
Int32
|
Возраст первого ребенка. Атрибут необязательный.
|-
|
kid2age
|
Int32
|
Возраст второго ребенка. Атрибут необязательный.
|-
|
kid3age
|
Int32
|
Возраст третьего ребенка. Атрибут необязательный.
|-
|
mealId
|
Int32
|
Идентификатор типа питания. Может отсутствовать, если тип питания не слинкован.
|-
|
mealName *
|
String
|
Тип
питания.
|-
|
nights *
|
Int32
|
Продолжительность тура, ночей.
|-
|
offerId *
|
Int64
|
Идентификатор ценового предложения. Используется вместе с sourceId и requestId для актуализации тура и для оформления заказа.
|-
|
price *
|
Int32
|
Цена тура в запрошенной валюте.
|-
|
currencyId *
|
Int32
|
Идентификатор валюты к атрибуту price (2 – USD, 3 – EUR, 5 – RUR).
|-
|
requestId
|
Int32
|
Идентификатор поискового запроса. Используется вместе с sourceId и requestId для актуализации тура и для оформления заказа.
|-
|
townId
|
Int32
|
Идентификатор курорта. Может отсутствовать, если курорт не слинкован.
|-
|
townName *
|
String
|
Название курорта.
|-
|
roomId
|
Int32
|
Идентификатор типа номера. Может отсутствовать, если тип номера не слинкован.
|-
|
roomName *
|
String
|
Тип номера.
|-
|
sourceId *
|
Int32
|
Идентификатор туроператора. Значение используется вместе с offerId и requestId для заказа и оформления туров.
|-
|
starId
|
Int32
|
Идентификатор категории отеля. Может отсутствовать, если категория отеля не слинкована.
|-
|
starName *
|
String
|
Категория отеля.
|-
|
tourName *
|
String
|
Название тура. Может быть пустым, если туроператор не предоставляет таких данных.
|-
|
tourUrl
|
String
|
Ссылка на описание / бронирование тура на сайте туроператора.
|-
|
originalHotelName *
|
String
|
Оригинальное название отеля (данные туроператора).
|-
|
originalStarName *
|
String
|
Оригинальная категория отеля (данные туроператора).
|-
|
originalTownName *
|
String
|
Оригинальное название курорта (данные туроператора).
|-
|
originalMealName *
|
String
|
Оригинальный тип питания (данные туроператора).
|-
|
originalHtPlaceName *
|
String
|
Оригинальный тип размещения (данные туроператора).
|-
|
originalRoomName *
|
String
|
Оригинальный тип номера (данные туроператора).
|-
|
originalCountryName *
|
String
|
Оригинальное название страны (данные туроператора).
|-
|
originalDptCityName *
|
String
|
Оригинальное название города вылета (данные туроператора).
|-
|
originalPrice *
|
Int32
|
Цена тура у туроператора (может отличаться от цены в атрибуте price, если туроператор предоставляет такую информацию).
|-
|
originalCurrencyId *
|
Int32
|
Идентификатор валюты к атрибуту originalPrice (2 – USD, 3 – EUR, 5 – RUR).
|-
|
originalCurrencyName *
|
String
|
Оригинальное название валюты у туроператора.
|-
|
fewPlacesInHotel''' '''
|
Int32
|
Если есть места в отеле (hotelIsInStop = 0) и данное значение отлично от нуля, то мест в
отеле МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что мест МАЛО, но не информирует о
точном количестве в остатке.
Если передано любое иное число, отличное от нуля, то это точное количество оставшихся мест.
|-
|
fewEconomTicketsDpt''' '''
|
Int32
|
Если есть места на перелёт эконом-классом (туда) (economTicketsDpt = 1) и
данное значение отлично от нуля, то билетов МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке.
Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewEconomTicketsRtn''' '''
|
Int32
|
Если есть места на перелёт эконом-классом (обратно) (economTicketsRtn = 1) и данное значение отлично от нуля, то билетов МАЛО. Значение -1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке. Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewBusinessTicketsDpt''' '''
|
Int32
|
Если есть места на перелёт бизнес-классом (туда) (businessTicketsDpt = 1) и
данное значение отлично от нуля, то билетов МАЛО. Значение -1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке.
Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewBusinessTicketsRtn''' '''
|
Int32
|
Если есть места на перелёт бизнес-классом (обратно) (businessTicketsRtn = 1) и
данное значение отлично от нуля, то билетов МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует
о точном количестве в остатке. Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
priceType *
|
Int32
|
Тип
цены у туроператора (0 – на номер, 1- на человека). Независимо от типа цены стоимость тура выдаётся конечной.
|-
|
flags''' '''
|
UInt64
|
Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой.
Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура турист получает подарок;
* 1024 – тур является комбинированным.
|-
|
creditMonths''' '''
|
Int32?
|
Если
тур доступен для покупки в кредит, то в данном поле указывается срок кредита
в месяцах, иначе атрибут будет отсутствовать.
|-
|
creditMonthlyPay''' '''
|
Int32?
|
Если
тур доступен для покупки в кредит, то в данном поле указывается размер
ежемесячных выплат, иначе атрибут будет отсутствовать.
|-
|
description''' '''
|
String
|
Дополнительная
информация по туру. Например, для комбинированных туров может содержать информацию
о проживании в отелях.
|-
|
discountPercent''' '''
|
Single?
|
Если
туроператор предоставляет скидку, то в данном поле выводится размер скидки,
иначе атрибут будет отсутствовать.
|-
|
discountExpires''' '''
|
DateTime ?
|
Если
туроператор предоставляет скидку и указывает срок её действия, то в данном
поле выводится дата окончания акции, иначе атрибут будет отсутствовать.
|-
|
discountCaption''' '''
|
String
|
Описание
скидки/акции.
|-
|
receivingParty''' '''
|
String
|
Принимающая
сторона (если информация предоставляется туроператором).
|-
|
giftCaption''' '''
|
String
|
Если по
акции туроператор предоставляет подарки, то в данном поле выводится их описание.
|-
|
earlyBookingValidTill''' '''
|
DateTime
?
|
Если
тур является туром раннего бронирования и туроператор предоставляет последнюю дату ранней брони, то в данном поле выводится это значение, иначе атрибут будет отсутствовать.
|-
|
updateDate *
|
DateTme
|
Дата и время (UTC) последнего обновления информации о туре.
|-
|
|
|
|
|
|}

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

https://bulk.sletat.ru/BulkCacheDownload?packetId=922AC42F-9927-4B8C-A1EB-0020C35C4F22

После загрузки и распаковки данных получаем следующий пакет (для читаемости оставлены только два элемента '''tour'''):

<source lang="xml">

<tours>
<tour offerId="200626003" requestId="116002036" sourceId="3" updateDate="2013-04-28 14:31:00" price="35382" currencyId="5" checkin="2013-05-26" nights="13" adults="1" kids="0" mealId="113" roomId="5283" htplaceId="13094" hotelIsInStop="0" ticketsIncluded="1" hasEconomTicketsDpt="1" hasEconomTicketsRtn="1" hasBusinessTicketsDpt="0" hasBusinessTicketsRtn="0" tourName="PALMA DE MALLORCA (KEMEROVO)" hotelName="HOTEL BLUE SEA DON JAIME" townName="PALMA DE MALLORCA" starName="3*" mealName="HB" roomName="Standard" htplaceName="SGL" originalHotelName="HOTEL BLUE SEA DON JAIME" originalTownName="PALMA DE MALLORCA" originalStarName="3*" originalMealName="HB" originalRoomName="Standard Room" originalHtplaceName="Single" originalCountryName="SPAIN" originalDptCityName="Кемерово" originalCurencyId="3" originalCurrencyName="EUR" originalPrice="853" tourUrl="https://agency.pegast.ru/samo5/bron?CLAIM=1717245082&TOWNFROMINC=75&STATEINC=58&SPOINC=397842" priceType="0" flags="128" creditMonths="6" creditMonthlyPay="5897" />
<tour offerId="200626009" requestId="116002036" sourceId="3" updateDate="2013-04-28 14:31:00" price="39282" currencyId="5" checkin="2013-05-26" nights="13" adults="1" kids="0" mealId="113" htplaceId="13094" hotelIsInStop="0" ticketsIncluded="1" hasEconomTicketsDpt="1" hasEconomTicketsRtn="1" hasBusinessTicketsDpt="0" hasBusinessTicketsRtn="0" tourName="PALMA DE MALLORCA (KEMEROVO)" hotelName="APARTHOTEL BLUE SEA CALA GUYA MAR" townName="PALMA DE MALLORCA" starName="3*" mealName="HB" roomName="One Bedroom Apartment" htplaceName="SGL" originalHotelName="APARTHOTEL BLUE SEA CALA GUYA MAR" originalTownName="PALMA DE MALLORCA" originalStarName="3*" originalMealName="HB" originalRoomName="One Bedroom Apartment" originalHtplaceName="Single" originalCountryName="SPAIN" originalDptCityName="Кемерово" originalCurencyId="3" originalCurrencyName="EUR" originalPrice="947" tourUrl="https://agency.pegast.ru/samo5/bron?CLAIM=1717245104&TOWNFROMINC=75&STATEINC=58&SPO INC=397842" priceType="0" flags="128" creditMonths="6" creditMonthlyPay="6547" />
</tours>

</source>

=== GetFuelSurcharges ===

Метод '''GetFuelSurcharges''' позволяет получить список всех топливных сборов.Сигнатура:
FuelSurchargeInfo[] GetFuelSurcharges()

Параметры отсутствуют.
В ответ возвращает массив описаний топливных сборов '''FuelSurchargeInfo'''. Каждый элемент содержит следующие поля:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
SourceId
|
Int32?
|
Идентификатор туроператора. Если null, значит сбор применяется вне зависимости от туроператора
|-
|
TownFromId
|
Int32?
|
Идентификатор города вылета. Если null, значит сбор применяется вне зависимости от города вылета.
|-
|
CountryId
|
Int32?
|
Идентификатор направления. Если null, значит сбор применяется вне зависимости от направления.
|-
|
ResortId
|
Int32?
|
Идентификатор курорта, если null, значит сбор применяется вне зависимости от курорта.
|-
|
AirportId
|
Int32?
|
Идентификатор аэропорта назначения. Если null, значит сбор применяется вне зависимости от аэропорта назначения.
|-
|
AircompanyId
|
Int32?
|
Идентификатор авиакомпании. Если null, значит сбор применяется вне зависимости от авиакомпании.
|-
|
FlightNumber
|
Int32?
|
Номер рейса. Если null, значит сбор применяется вне зависимости от номера рейса.
|-
|
HostId
|
Int32?
|
Идентификатор туроператора принимающей стороны. Если null, значит сбор применяется вне зависимости от туроператора принимающей стороны.
|-
|
PeriodStartDate
|
DateTime
|
Дата начала действия сбора.
|-
|
PeriodEndDate
|
DateTime
|
Дата окончания действия сбора.
|-
|
Price
|
Decimal ?
|
Сумма сбора. Если пусто, значит по данному фильтру сбор не взимается.
|-
|
CurrencyId
|
Int32?
|
Идентификатор валюты сбора. Пусто при отсутствии сбора
|}

Топливный сбор применяется по наибольшему совпадению параметров тура с параметрами сбора.Фильтровать сборы для тура нужно следующим образом:

# Выбрать сборы по туроператору и те, для которых поле SourceId = null;
# Из выбранных сборов взять те, чьи периоды действия включают даты начала и окончания тура;
# Из выбранных сборов взять те, для которых поле TownFromId = городу вылета или null;
# Из выбранных сборов взять те, для которых поле CountryId = стране или null;
# Из выбранных сборов взять те, для которых поле ResortId = курорту или null;
# Из выбранных удалить сборы с «широким фильтром» (среди параметров TownFromId, CountryId, ResortId, SourceId все или несколько равны null), у которых остальные параметры совпадают с параметрами сборов в выборке с более «узким фильтром» (среди параметров TownFromId, CountryId, ResortId, SourceId все или несколько равны параметрам тура соответственно).

=== GetVisaSurcharges ===

Метод '''GetVisaSurcharges''' позволяет получить список всех визовых сборов. Сигнатура:

VisaSurchargeInfo[] GetVisaSurcharges()

Параметры отсутствуют.В ответ возвращает массив описаний визовых сборов VisaSurchargeInfo. Каждый элемент содержит следующие поля:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
SourceId
|
Int32?
|
Идентификатор туроператора. Если null, значит сбор применяется вне зависимости от туроператора.
|-
|
TownFromId
|
Int32?
|
Идентификатор города оформления. Возможные исключения:
# Если null, значит сбор применяется вне зависимости от города вылета.
# Если 1, значит виза оформляется по прибытии.
|-
|
CountryId
|
Int32?
|
Идентификатор страны назначения. Если null, значит сбор применяется вне зависимости от страны назначения
|-
|
Citizenship
|
Int32?
|
Идентификатор страны, гражданином которой является турист. Если null, значит сбор применяется вне зависимости от гражданства.
|-
|
IsExpress
|
bool?
|
True – сбор указан для экспресс-оформления. False – сбор указан для обычного оформления, null – сбор для любого типа оформления.
|-
|
AgeFrom
|
Int32?
|
Нижняя возрастная граница оформления визы.
|-
|
AgeTo
|
Int32?
|
Верхняя возрастная граница оформления визы.
|-
|
PasportType
|
bool?
|
Тип паспорта: true – свой, false – вписан, null – сбор применяется вне зависимости от типа паспорта.
|-
|
IssueDaysFrom
|
Int32?
|
Минимальный срок оформления, дней.
|-
|
IssueDaysTo
|
Int32?
|
Максимальный срок оформления, дней.
|-
|
Price
|
Decimal
?
|
Сумма сбора. Если пусто, значит по данному фильтру сбор не взимается.
|-
|
CurrencyId
|
Int32?
|
Идентификатор валюты сбора. Пусто при отсутствии сбора.
|}

=== GetRequestInfo ===

Вспомогательный метод '''GetRequestInfo''' предназначен для получения данных о поисковом запросе по его идентификатору. Идентификаторы поисковых запросов присутствуют в выгрузке для всех туров. Сигнатура:

RequestInfo GetRequestInfo(Int32 requestId)

Параметр '''requestId''' – идентификатор поискового запроса. Если запрос был найден, то в ответ будет возвращена структура со следующими полями:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
CurrencyAlias *
|
Int32
|
Валюта поиска (RUB, USD, EUR, UAH и BYR).
|-
|
DptCityId *
|
Int32
|
Идентификатор города вылета.
|-
|
CountryId *
|
Int32
|
Идентификатор страны.
|-
|
Adults *
|
Int32
|
Количество туристов (взрослых).
|-
|
Kids *
|
Int32
|
Количество туристов (детей).
|-
|
KidsAges
|
Int32[]
|
Возрасты детей (если были указаны).
|-
|
NightsMin *
|
Int32
|
Минимальная продолжительность тура, ночей.
|-
|
NightsMax *
|
Int32
|
Максимальная продолжительность тура, ночей.
|-
|
PriceMin
|
Int32
|
Минимальная цена.
|-
|
PriceMax
|
Int32
|
Максимальная цена.
|-
|
Date1 *
|
DateTime
|
Диапазон дат вылета, первая дата.
|-
|
Date2 *
|
DateTime
|
Диапазон дат вылета, вторая дата.
|-
|
HotelIsNotInStop *
|
Boolean
|
Отмечен флажок «Есть места в отеле».
|-
|
TicketsIncluded *
|
Boolean
|
Отмечен флажок «Перелет включен».
|-
|
HasTickets *
|
Boolean
|
Отмечен флажок «Есть билеты».
|-
|
HotelIds
|
Int32[]
|
Выбранные отели (если были указаны).
|-
|
StarIds
|
Int32[]
|
Выбранные категории отелей (если были указаны).
|-
|
MealIds
|
Int32[]
|
Выбранные типы питания (если были указаны).
|-
|
TownIds
|
Int32[]
|
Выбранные курорты (если были указаны).
|}

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

2026-05-28T06:42:42Z

Kdadmin: Защищена страница «Суточный кеш (xml)» ([Редактирование=Разрешено только администраторам] (бессрочно) [Переименование=Разрешено только а…

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

2026-05-28T06:37:58Z

Kdadmin: /* Расширения и дополнения */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[[Номерной фонд (json)]]

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

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

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

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

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

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

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

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

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

[[«Аппекс» — интеграция|«Appex» — интеграция]]

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

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

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

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

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

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

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

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

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

2026-03-30T14:40:17Z

Kdadmin: Удаление валюты UZS

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

2026-03-30T14:39:27Z

Kdadmin:

[[Category:Расширения и дополнения]]
== Описание сервиса ==

Сервис предназначен для выгрузки кеша туров проекта Слетать.ру в базу данных клиента. Раз в час система подготавливает сжатые алгоритмом GZIP XML-пакеты с новыми турами, по одному пакету на каждое направление ото всех туроператоров. Веб-сервис предоставляет метод для получения списка подготовленных пакетов. API выгрузки кеша – это стандартный веб-сервис, предоставляющий WSDL-документ с описанием всех методов и типов данных. Версия, выпущенная на момент написания настоящего документа, работает только по протоколу HTTPS. Для большей совместимости с различными клиентами сервис основан на SOAP версии 1.1. Взаимодействие с сервисом возможно одним из двух способов:
* Как с обычным веб-сервисом посредством SOAP запросов, WSDL доступен.
* Как с сервисом WCF (Windows Communication Foundation) — самый простой способ, если клиент под .NET Framework 3.5 или выше. Логика обработки запросов не зависит от способа работы с сервисом. При передаче строк и XML-пакетов используется кодировка UTF-8. Сервис не требует сессий при работе с ним, и все методы не зависят друг от друга с точки зрения очередности вызова. Таким образом, очередность вызова методов диктуется реализуемым алгоритмом для работы с поисковым сервисом.

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

{| class="standard"
| style="background-color:silver" |Все описанные ниже методы возвращают информацию только при наличии дополнительной лицензии для доступа к Отельной базе. По всем вопросам обращайтесь в службу поддержки по тел. 8(800)700-33-09 (звонок бесплатный для всех регионов России) или по электронной почте info@sletat.ru.
|}

== Подключение к сервису ==

Чтобы начать работу с сервисом, зарегистрируйтесь на сайте sletat.ru и получите тестовую лицензию в Службе технической поддержки Слетать.ру по электронному адресу info@sletat.ru. После получения лицензии можно начинать работать с API. Для работы с сервисом вам нужно использовать WSDL документ, который расположен по адресу:
https://bulk.sletat.ru/main.svc?singleWSDL

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

=== Клиент на .NET ===

Добавьте в проект ссылку на WSDL-документ используя Service Reference (или Web Reference для проектов на .NET 2.0). Теперь ваш проект готов к работе с сервисом. Ниже приведен пример вызова метода для получения списка городов вылета:

<source lang="xml">

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

</source>

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

== Логика работы с сервисом ==

Сервис предоставляет метод '''GetPacketList''' для получения списка всех доступных для выгрузки пакетов с турами. Каждый пакет имеет указание на город вылета, страну и туроператора, а также на временной интервал, за который пакет включает туры. Используя список, вы можете загрузить либо все туры, либо туры по интересующим направлениям и туроператорам. Каждый пакет имеет уникальный идентификатор, используя который можно загрузить содержимое пакета. Сервис также предоставляет методы для выгрузки топливных и визовых сборов '''GetFuelSurcharges''' и '''GetVisaSurcharges'''.

== Методы ==

В этом разделе описаны все методы поискового сервиса. К методам приведены примеры запросов и ответов в SOAP. Все методы требуют авторизации. Информация для авторизации (логин и пароль) передаётся в заголовке 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>
...
</soap:Body>
</soap:Envelope>

</source>

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

=== GetPacketList ===

Метод '''GetPacketList''' возвращает список всех пакетов, доступных для загрузки. Сигнатура:

PacketInfo[] GetPacketList(DateTime? createDatePoint)

'''CreateDatePoint''' – опциональный параметр; если передан, то будут возвращены пакеты, подготовленные после указанной даты. Каждый пакет ответа имеет следующие поля (знаком * здесь и далее отмечены обязательные поля):

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Id *
|
Int32
|
Идентификатор пакета.
|-
|
DptCityId *
|
Int32
|
Идентификатор города вылета.
|-
|
CountryId *
|
Int32
|
Идентификатор страны.
|-
|
SourceId *
|
Int32
|
Идентификатор туроператора.
|-
|
DateTimeFrom *
|
DateTime
|
Начало временного интервала, за который были собраны обновлённые туры (московское время).
|-
|
DateTimeTo *
|
DateTime
|
Окончание временного интервала, за который были собраны обновлённые туры (московское время).
|-
|
CreateDate *
|
DateTime
|
Дата и время подготовки пакета (московское время).
|}

=== BulkCacheDownload ===

'''BulkCacheDownload''' в интерфейсе сервиса выгрузки кеша является не методом, а отдельным инструментом для загрузки содержимого пакетов по их идентификаторам. Для работы с методом используются HTTP GET-запросы. Использование:

https://bulk.sletat.ru/BulkCacheDownload?packetId=[packetId]

Параметр '''packetId''' – идентификатор пакета.Ответом является сжатый алгоритмом GZIP XML-пакет, MIME-тип устанавливается application/x-gzip. XML-пакет имеет кодировку UTF-8 и несложную структуру в виде корневого элемента '''tours''' и элементов '''tour''', каждый из которых в атрибутах содержит описание одного тура. Ниже в таблице описаны все атрибуты для элементов '''tour''':

{| class="wikitable"
|-
|
Название атрибута
|
Тип
|
Описание
|-
|
adults *
|
Int32
|
Количество туристов (взрослых).
|-
|
hasBusinessTicketsDpt
|
Int32
|
Наличие
билетов бизнес-класса (туда). Возможные значения: 0 (нет билетов), 1 (есть
билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации.
|-
|
hasBusinessTicketsRtn
|
Int32
|
Наличие
билетов бизнес-класса (обратно). Возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
ticketsIncluded *
|
Int32
|
Включает
ли тур в стоимость перелёт: 0 (не включает) и 1 (включает). Если атрибут отсутствует, то нет такой информации о туре.
|-
|
checkIn *
|
String
|
Дата вылета в формате dd.MM.yyyy.
|-
|
hasEconomTicketsDpt
|
Int32
|
Наличие билетов эконом-класса (туда). Возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос).
|-
|
hasEconomTicketsRtn
|
Int32
|
Наличие билетов эконом-класса (обратно), возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
hotelId
|
Int32
|
Идентификатор отеля. Может отсутствовать, если отель не слинкован.
|-
|
hotelIsInStop
|
Int32
|
Наличие мест в отеле. Возможные значения: 1 (нет мест), 0 (есть места), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
hotelName *
|
String
|
Название отеля.
|-
|
htPlaceId
|
Int32
|
Идентификатор размещения. Атрибут может отсутствовать, если размещение не слинковано.
|-
|
htplaceName *
|
String
|
Тип размещения.
|-
|
kids *
|
Int32
|
Количество туристов (детей).
|-
|
kid1age
|
Int32
|
Возраст первого ребенка. Атрибут необязательный.
|-
|
kid2age
|
Int32
|
Возраст второго ребенка. Атрибут необязательный.
|-
|
kid3age
|
Int32
|
Возраст третьего ребенка. Атрибут необязательный.
|-
|
mealId
|
Int32
|
Идентификатор типа питания. Может отсутствовать, если тип питания не слинкован.
|-
|
mealName *
|
String
|
Тип
питания.
|-
|
nights *
|
Int32
|
Продолжительность тура, ночей.
|-
|
offerId *
|
Int64
|
Идентификатор ценового предложения. Используется вместе с sourceId и requestId для актуализации тура и для оформления заказа.
|-
|
price *
|
Int32
|
Цена тура в запрошенной валюте.
|-
|
currencyId *
|
Int32
|
Идентификатор валюты к атрибуту price (2 – USD, 3 – EUR, 5 – RUR).
|-
|
requestId
|
Int32
|
Идентификатор поискового запроса. Используется вместе с sourceId и requestId для актуализации тура и для оформления заказа.
|-
|
townId
|
Int32
|
Идентификатор курорта. Может отсутствовать, если курорт не слинкован.
|-
|
townName *
|
String
|
Название курорта.
|-
|
roomId
|
Int32
|
Идентификатор типа номера. Может отсутствовать, если тип номера не слинкован.
|-
|
roomName *
|
String
|
Тип номера.
|-
|
sourceId *
|
Int32
|
Идентификатор туроператора. Значение используется вместе с offerId и requestId для заказа и оформления туров.
|-
|
starId
|
Int32
|
Идентификатор категории отеля. Может отсутствовать, если категория отеля не слинкована.
|-
|
starName *
|
String
|
Категория отеля.
|-
|
tourName *
|
String
|
Название тура. Может быть пустым, если туроператор не предоставляет таких данных.
|-
|
tourUrl
|
String
|
Ссылка на описание / бронирование тура на сайте туроператора.
|-
|
originalHotelName *
|
String
|
Оригинальное название отеля (данные туроператора).
|-
|
originalStarName *
|
String
|
Оригинальная категория отеля (данные туроператора).
|-
|
originalTownName *
|
String
|
Оригинальное название курорта (данные туроператора).
|-
|
originalMealName *
|
String
|
Оригинальный тип питания (данные туроператора).
|-
|
originalHtPlaceName *
|
String
|
Оригинальный тип размещения (данные туроператора).
|-
|
originalRoomName *
|
String
|
Оригинальный тип номера (данные туроператора).
|-
|
originalCountryName *
|
String
|
Оригинальное название страны (данные туроператора).
|-
|
originalDptCityName *
|
String
|
Оригинальное название города вылета (данные туроператора).
|-
|
originalPrice *
|
Int32
|
Цена тура у туроператора (может отличаться от цены в атрибуте price, если туроператор предоставляет такую информацию).
|-
|
originalCurrencyId *
|
Int32
|
Идентификатор валюты к атрибуту originalPrice (2 – USD, 3 – EUR, 5 – RUR).
|-
|
originalCurrencyName *
|
String
|
Оригинальное название валюты у туроператора.
|-
|
fewPlacesInHotel''' '''
|
Int32
|
Если есть места в отеле (hotelIsInStop = 0) и данное значение отлично от нуля, то мест в
отеле МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что мест МАЛО, но не информирует о
точном количестве в остатке.
Если передано любое иное число, отличное от нуля, то это точное количество оставшихся мест.
|-
|
fewEconomTicketsDpt''' '''
|
Int32
|
Если есть места на перелёт эконом-классом (туда) (economTicketsDpt = 1) и
данное значение отлично от нуля, то билетов МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке.
Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewEconomTicketsRtn''' '''
|
Int32
|
Если есть места на перелёт эконом-классом (обратно) (economTicketsRtn = 1) и данное значение отлично от нуля, то билетов МАЛО. Значение -1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке. Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewBusinessTicketsDpt''' '''
|
Int32
|
Если есть места на перелёт бизнес-классом (туда) (businessTicketsDpt = 1) и
данное значение отлично от нуля, то билетов МАЛО. Значение -1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке.
Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewBusinessTicketsRtn''' '''
|
Int32
|
Если есть места на перелёт бизнес-классом (обратно) (businessTicketsRtn = 1) и
данное значение отлично от нуля, то билетов МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует
о точном количестве в остатке. Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
priceType *
|
Int32
|
Тип
цены у туроператора (0 – на номер, 1- на человека). Независимо от типа цены стоимость тура выдаётся конечной.
|-
|
flags''' '''
|
UInt64
|
Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой.
Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура турист получает подарок;
* 1024 – тур является комбинированным.
|-
|
creditMonths''' '''
|
Int32?
|
Если
тур доступен для покупки в кредит, то в данном поле указывается срок кредита
в месяцах, иначе атрибут будет отсутствовать.
|-
|
creditMonthlyPay''' '''
|
Int32?
|
Если
тур доступен для покупки в кредит, то в данном поле указывается размер
ежемесячных выплат, иначе атрибут будет отсутствовать.
|-
|
description''' '''
|
String
|
Дополнительная
информация по туру. Например, для комбинированных туров может содержать информацию
о проживании в отелях.
|-
|
discountPercent''' '''
|
Single?
|
Если
туроператор предоставляет скидку, то в данном поле выводится размер скидки,
иначе атрибут будет отсутствовать.
|-
|
discountExpires''' '''
|
DateTime ?
|
Если
туроператор предоставляет скидку и указывает срок её действия, то в данном
поле выводится дата окончания акции, иначе атрибут будет отсутствовать.
|-
|
discountCaption''' '''
|
String
|
Описание
скидки/акции.
|-
|
receivingParty''' '''
|
String
|
Принимающая
сторона (если информация предоставляется туроператором).
|-
|
giftCaption''' '''
|
String
|
Если по
акции туроператор предоставляет подарки, то в данном поле выводится их описание.
|-
|
earlyBookingValidTill''' '''
|
DateTime
?
|
Если
тур является туром раннего бронирования и туроператор предоставляет последнюю дату ранней брони, то в данном поле выводится это значение, иначе атрибут будет отсутствовать.
|-
|
updateDate *
|
DateTme
|
Дата и время (UTC) последнего обновления информации о туре.
|-
|
|
|
|
|
|}

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

https://bulk.sletat.ru/BulkCacheDownload?packetId=922AC42F-9927-4B8C-A1EB-0020C35C4F22

После загрузки и распаковки данных получаем следующий пакет (для читаемости оставлены только два элемента '''tour'''):

<source lang="xml">

<tours>
<tour offerId="200626003" requestId="116002036" sourceId="3" updateDate="2013-04-28 14:31:00" price="35382" currencyId="5" checkin="2013-05-26" nights="13" adults="1" kids="0" mealId="113" roomId="5283" htplaceId="13094" hotelIsInStop="0" ticketsIncluded="1" hasEconomTicketsDpt="1" hasEconomTicketsRtn="1" hasBusinessTicketsDpt="0" hasBusinessTicketsRtn="0" tourName="PALMA DE MALLORCA (KEMEROVO)" hotelName="HOTEL BLUE SEA DON JAIME" townName="PALMA DE MALLORCA" starName="3*" mealName="HB" roomName="Standard" htplaceName="SGL" originalHotelName="HOTEL BLUE SEA DON JAIME" originalTownName="PALMA DE MALLORCA" originalStarName="3*" originalMealName="HB" originalRoomName="Standard Room" originalHtplaceName="Single" originalCountryName="SPAIN" originalDptCityName="Кемерово" originalCurencyId="3" originalCurrencyName="EUR" originalPrice="853" tourUrl="https://agency.pegast.ru/samo5/bron?CLAIM=1717245082&TOWNFROMINC=75&STATEINC=58&SPOINC=397842" priceType="0" flags="128" creditMonths="6" creditMonthlyPay="5897" />
<tour offerId="200626009" requestId="116002036" sourceId="3" updateDate="2013-04-28 14:31:00" price="39282" currencyId="5" checkin="2013-05-26" nights="13" adults="1" kids="0" mealId="113" htplaceId="13094" hotelIsInStop="0" ticketsIncluded="1" hasEconomTicketsDpt="1" hasEconomTicketsRtn="1" hasBusinessTicketsDpt="0" hasBusinessTicketsRtn="0" tourName="PALMA DE MALLORCA (KEMEROVO)" hotelName="APARTHOTEL BLUE SEA CALA GUYA MAR" townName="PALMA DE MALLORCA" starName="3*" mealName="HB" roomName="One Bedroom Apartment" htplaceName="SGL" originalHotelName="APARTHOTEL BLUE SEA CALA GUYA MAR" originalTownName="PALMA DE MALLORCA" originalStarName="3*" originalMealName="HB" originalRoomName="One Bedroom Apartment" originalHtplaceName="Single" originalCountryName="SPAIN" originalDptCityName="Кемерово" originalCurencyId="3" originalCurrencyName="EUR" originalPrice="947" tourUrl="https://agency.pegast.ru/samo5/bron?CLAIM=1717245104&TOWNFROMINC=75&STATEINC=58&SPO INC=397842" priceType="0" flags="128" creditMonths="6" creditMonthlyPay="6547" />
</tours>

</source>

=== GetFuelSurcharges ===

Метод '''GetFuelSurcharges''' позволяет получить список всех топливных сборов.Сигнатура:
FuelSurchargeInfo[] GetFuelSurcharges()

Параметры отсутствуют.
В ответ возвращает массив описаний топливных сборов '''FuelSurchargeInfo'''. Каждый элемент содержит следующие поля:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
SourceId
|
Int32?
|
Идентификатор туроператора. Если null, значит сбор применяется вне зависимости от туроператора
|-
|
TownFromId
|
Int32?
|
Идентификатор города вылета. Если null, значит сбор применяется вне зависимости от города вылета.
|-
|
CountryId
|
Int32?
|
Идентификатор направления. Если null, значит сбор применяется вне зависимости от направления.
|-
|
ResortId
|
Int32?
|
Идентификатор курорта, если null, значит сбор применяется вне зависимости от курорта.
|-
|
AirportId
|
Int32?
|
Идентификатор аэропорта назначения. Если null, значит сбор применяется вне зависимости от аэропорта назначения.
|-
|
AircompanyId
|
Int32?
|
Идентификатор авиакомпании. Если null, значит сбор применяется вне зависимости от авиакомпании.
|-
|
FlightNumber
|
Int32?
|
Номер рейса. Если null, значит сбор применяется вне зависимости от номера рейса.
|-
|
HostId
|
Int32?
|
Идентификатор туроператора принимающей стороны. Если null, значит сбор применяется вне зависимости от туроператора принимающей стороны.
|-
|
PeriodStartDate
|
DateTime
|
Дата начала действия сбора.
|-
|
PeriodEndDate
|
DateTime
|
Дата окончания действия сбора.
|-
|
Price
|
Decimal ?
|
Сумма сбора. Если пусто, значит по данному фильтру сбор не взимается.
|-
|
CurrencyId
|
Int32?
|
Идентификатор валюты сбора. Пусто при отсутствии сбора
|}

Топливный сбор применяется по наибольшему совпадению параметров тура с параметрами сбора.Фильтровать сборы для тура нужно следующим образом:

# Выбрать сборы по туроператору и те, для которых поле SourceId = null;
# Из выбранных сборов взять те, чьи периоды действия включают даты начала и окончания тура;
# Из выбранных сборов взять те, для которых поле TownFromId = городу вылета или null;
# Из выбранных сборов взять те, для которых поле CountryId = стране или null;
# Из выбранных сборов взять те, для которых поле ResortId = курорту или null;
# Из выбранных удалить сборы с «широким фильтром» (среди параметров TownFromId, CountryId, ResortId, SourceId все или несколько равны null), у которых остальные параметры совпадают с параметрами сборов в выборке с более «узким фильтром» (среди параметров TownFromId, CountryId, ResortId, SourceId все или несколько равны параметрам тура соответственно).

=== GetVisaSurcharges ===

Метод '''GetVisaSurcharges''' позволяет получить список всех визовых сборов. Сигнатура:

VisaSurchargeInfo[] GetVisaSurcharges()

Параметры отсутствуют.В ответ возвращает массив описаний визовых сборов VisaSurchargeInfo. Каждый элемент содержит следующие поля:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
SourceId
|
Int32?
|
Идентификатор туроператора. Если null, значит сбор применяется вне зависимости от туроператора.
|-
|
TownFromId
|
Int32?
|
Идентификатор города оформления. Возможные исключения:
# Если null, значит сбор применяется вне зависимости от города вылета.
# Если 1, значит виза оформляется по прибытии.
|-
|
CountryId
|
Int32?
|
Идентификатор страны назначения. Если null, значит сбор применяется вне зависимости от страны назначения
|-
|
Citizenship
|
Int32?
|
Идентификатор страны, гражданином которой является турист. Если null, значит сбор применяется вне зависимости от гражданства.
|-
|
IsExpress
|
bool?
|
True – сбор указан для экспресс-оформления. False – сбор указан для обычного оформления, null – сбор для любого типа оформления.
|-
|
AgeFrom
|
Int32?
|
Нижняя возрастная граница оформления визы.
|-
|
AgeTo
|
Int32?
|
Верхняя возрастная граница оформления визы.
|-
|
PasportType
|
bool?
|
Тип паспорта: true – свой, false – вписан, null – сбор применяется вне зависимости от типа паспорта.
|-
|
IssueDaysFrom
|
Int32?
|
Минимальный срок оформления, дней.
|-
|
IssueDaysTo
|
Int32?
|
Максимальный срок оформления, дней.
|-
|
Price
|
Decimal
?
|
Сумма сбора. Если пусто, значит по данному фильтру сбор не взимается.
|-
|
CurrencyId
|
Int32?
|
Идентификатор валюты сбора. Пусто при отсутствии сбора.
|}

=== GetRequestInfo ===

Вспомогательный метод '''GetRequestInfo''' предназначен для получения данных о поисковом запросе по его идентификатору. Идентификаторы поисковых запросов присутствуют в выгрузке для всех туров. Сигнатура:

RequestInfo GetRequestInfo(Int32 requestId)

Параметр '''requestId''' – идентификатор поискового запроса. Если запрос был найден, то в ответ будет возвращена структура со следующими полями:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
CurrencyAlias *
|
Int32
|
Валюта поиска (RUB, USD, EUR, UAH, BYR и EUR).
|-
|
DptCityId *
|
Int32
|
Идентификатор города вылета.
|-
|
CountryId *
|
Int32
|
Идентификатор страны.
|-
|
Adults *
|
Int32
|
Количество туристов (взрослых).
|-
|
Kids *
|
Int32
|
Количество туристов (детей).
|-
|
KidsAges
|
Int32[]
|
Возрасты детей (если были указаны).
|-
|
NightsMin *
|
Int32
|
Минимальная продолжительность тура, ночей.
|-
|
NightsMax *
|
Int32
|
Максимальная продолжительность тура, ночей.
|-
|
PriceMin
|
Int32
|
Минимальная цена.
|-
|
PriceMax
|
Int32
|
Максимальная цена.
|-
|
Date1 *
|
DateTime
|
Диапазон дат вылета, первая дата.
|-
|
Date2 *
|
DateTime
|
Диапазон дат вылета, вторая дата.
|-
|
HotelIsNotInStop *
|
Boolean
|
Отмечен флажок «Есть места в отеле».
|-
|
TicketsIncluded *
|
Boolean
|
Отмечен флажок «Перелет включен».
|-
|
HasTickets *
|
Boolean
|
Отмечен флажок «Есть билеты».
|-
|
HotelIds
|
Int32[]
|
Выбранные отели (если были указаны).
|-
|
StarIds
|
Int32[]
|
Выбранные категории отелей (если были указаны).
|-
|
MealIds
|
Int32[]
|
Выбранные типы питания (если были указаны).
|-
|
TownIds
|
Int32[]
|
Выбранные курорты (если были указаны).
|}

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

2026-03-30T14:28:24Z

Kdadmin: Добавление валюты UZS

[[Category:Расширения и дополнения]]
== Описание сервиса ==

Сервис предназначен для выгрузки кеша туров проекта Слетать.ру в базу данных клиента. Раз в час система подготавливает сжатые алгоритмом GZIP XML-пакеты с новыми турами, по одному пакету на каждое направление ото всех туроператоров. Веб-сервис предоставляет метод для получения списка подготовленных пакетов. API выгрузки кеша – это стандартный веб-сервис, предоставляющий WSDL-документ с описанием всех методов и типов данных. Версия, выпущенная на момент написания настоящего документа, работает только по протоколу HTTPS. Для большей совместимости с различными клиентами сервис основан на SOAP версии 1.1. Взаимодействие с сервисом возможно одним из двух способов:
* Как с обычным веб-сервисом посредством SOAP запросов, WSDL доступен.
* Как с сервисом WCF (Windows Communication Foundation) — самый простой способ, если клиент под .NET Framework 3.5 или выше. Логика обработки запросов не зависит от способа работы с сервисом. При передаче строк и XML-пакетов используется кодировка UTF-8. Сервис не требует сессий при работе с ним, и все методы не зависят друг от друга с точки зрения очередности вызова. Таким образом, очередность вызова методов диктуется реализуемым алгоритмом для работы с поисковым сервисом.

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

{| class="standard"
| style="background-color:silver" |Все описанные ниже методы возвращают информацию только при наличии дополнительной лицензии для доступа к Отельной базе. По всем вопросам обращайтесь в службу поддержки по тел. 8(800)700-33-09 (звонок бесплатный для всех регионов России) или по электронной почте info@sletat.ru.
|}

== Подключение к сервису ==

Чтобы начать работу с сервисом, зарегистрируйтесь на сайте sletat.ru и получите тестовую лицензию в Службе технической поддержки Слетать.ру по электронному адресу info@sletat.ru. После получения лицензии можно начинать работать с API. Для работы с сервисом вам нужно использовать WSDL документ, который расположен по адресу:
https://bulk.sletat.ru/main.svc?singleWSDL

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

=== Клиент на .NET ===

Добавьте в проект ссылку на WSDL-документ используя Service Reference (или Web Reference для проектов на .NET 2.0). Теперь ваш проект готов к работе с сервисом. Ниже приведен пример вызова метода для получения списка городов вылета:

<source lang="xml">

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

</source>

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

== Логика работы с сервисом ==

Сервис предоставляет метод '''GetPacketList''' для получения списка всех доступных для выгрузки пакетов с турами. Каждый пакет имеет указание на город вылета, страну и туроператора, а также на временной интервал, за который пакет включает туры. Используя список, вы можете загрузить либо все туры, либо туры по интересующим направлениям и туроператорам. Каждый пакет имеет уникальный идентификатор, используя который можно загрузить содержимое пакета. Сервис также предоставляет методы для выгрузки топливных и визовых сборов '''GetFuelSurcharges''' и '''GetVisaSurcharges'''.

== Методы ==

В этом разделе описаны все методы поискового сервиса. К методам приведены примеры запросов и ответов в SOAP. Все методы требуют авторизации. Информация для авторизации (логин и пароль) передаётся в заголовке 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>
...
</soap:Body>
</soap:Envelope>

</source>

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

=== GetPacketList ===

Метод '''GetPacketList''' возвращает список всех пакетов, доступных для загрузки. Сигнатура:

PacketInfo[] GetPacketList(DateTime? createDatePoint)

'''CreateDatePoint''' – опциональный параметр; если передан, то будут возвращены пакеты, подготовленные после указанной даты. Каждый пакет ответа имеет следующие поля (знаком * здесь и далее отмечены обязательные поля):

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Id *
|
Int32
|
Идентификатор пакета.
|-
|
DptCityId *
|
Int32
|
Идентификатор города вылета.
|-
|
CountryId *
|
Int32
|
Идентификатор страны.
|-
|
SourceId *
|
Int32
|
Идентификатор туроператора.
|-
|
DateTimeFrom *
|
DateTime
|
Начало временного интервала, за который были собраны обновлённые туры (московское время).
|-
|
DateTimeTo *
|
DateTime
|
Окончание временного интервала, за который были собраны обновлённые туры (московское время).
|-
|
CreateDate *
|
DateTime
|
Дата и время подготовки пакета (московское время).
|}

=== BulkCacheDownload ===

'''BulkCacheDownload''' в интерфейсе сервиса выгрузки кеша является не методом, а отдельным инструментом для загрузки содержимого пакетов по их идентификаторам. Для работы с методом используются HTTP GET-запросы. Использование:

https://bulk.sletat.ru/BulkCacheDownload?packetId=[packetId]

Параметр '''packetId''' – идентификатор пакета.Ответом является сжатый алгоритмом GZIP XML-пакет, MIME-тип устанавливается application/x-gzip. XML-пакет имеет кодировку UTF-8 и несложную структуру в виде корневого элемента '''tours''' и элементов '''tour''', каждый из которых в атрибутах содержит описание одного тура. Ниже в таблице описаны все атрибуты для элементов '''tour''':

{| class="wikitable"
|-
|
Название атрибута
|
Тип
|
Описание
|-
|
adults *
|
Int32
|
Количество туристов (взрослых).
|-
|
hasBusinessTicketsDpt
|
Int32
|
Наличие
билетов бизнес-класса (туда). Возможные значения: 0 (нет билетов), 1 (есть
билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации.
|-
|
hasBusinessTicketsRtn
|
Int32
|
Наличие
билетов бизнес-класса (обратно). Возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
ticketsIncluded *
|
Int32
|
Включает
ли тур в стоимость перелёт: 0 (не включает) и 1 (включает). Если атрибут отсутствует, то нет такой информации о туре.
|-
|
checkIn *
|
String
|
Дата вылета в формате dd.MM.yyyy.
|-
|
hasEconomTicketsDpt
|
Int32
|
Наличие билетов эконом-класса (туда). Возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос).
|-
|
hasEconomTicketsRtn
|
Int32
|
Наличие билетов эконом-класса (обратно), возможные значения: 0 (нет билетов), 1 (есть билеты), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
hotelId
|
Int32
|
Идентификатор отеля. Может отсутствовать, если отель не слинкован.
|-
|
hotelIsInStop
|
Int32
|
Наличие мест в отеле. Возможные значения: 1 (нет мест), 0 (есть места), 2 (под запрос). Если атрибут отсутствует, то этой информации нет.
|-
|
hotelName *
|
String
|
Название отеля.
|-
|
htPlaceId
|
Int32
|
Идентификатор размещения. Атрибут может отсутствовать, если размещение не слинковано.
|-
|
htplaceName *
|
String
|
Тип размещения.
|-
|
kids *
|
Int32
|
Количество туристов (детей).
|-
|
kid1age
|
Int32
|
Возраст первого ребенка. Атрибут необязательный.
|-
|
kid2age
|
Int32
|
Возраст второго ребенка. Атрибут необязательный.
|-
|
kid3age
|
Int32
|
Возраст третьего ребенка. Атрибут необязательный.
|-
|
mealId
|
Int32
|
Идентификатор типа питания. Может отсутствовать, если тип питания не слинкован.
|-
|
mealName *
|
String
|
Тип
питания.
|-
|
nights *
|
Int32
|
Продолжительность тура, ночей.
|-
|
offerId *
|
Int64
|
Идентификатор ценового предложения. Используется вместе с sourceId и requestId для актуализации тура и для оформления заказа.
|-
|
price *
|
Int32
|
Цена тура в запрошенной валюте.
|-
|
currencyId *
|
Int32
|
Идентификатор валюты к атрибуту price (2 – USD, 3 – EUR, 5 – RUR).
|-
|
requestId
|
Int32
|
Идентификатор поискового запроса. Используется вместе с sourceId и requestId для актуализации тура и для оформления заказа.
|-
|
townId
|
Int32
|
Идентификатор курорта. Может отсутствовать, если курорт не слинкован.
|-
|
townName *
|
String
|
Название курорта.
|-
|
roomId
|
Int32
|
Идентификатор типа номера. Может отсутствовать, если тип номера не слинкован.
|-
|
roomName *
|
String
|
Тип номера.
|-
|
sourceId *
|
Int32
|
Идентификатор туроператора. Значение используется вместе с offerId и requestId для заказа и оформления туров.
|-
|
starId
|
Int32
|
Идентификатор категории отеля. Может отсутствовать, если категория отеля не слинкована.
|-
|
starName *
|
String
|
Категория отеля.
|-
|
tourName *
|
String
|
Название тура. Может быть пустым, если туроператор не предоставляет таких данных.
|-
|
tourUrl
|
String
|
Ссылка на описание / бронирование тура на сайте туроператора.
|-
|
originalHotelName *
|
String
|
Оригинальное название отеля (данные туроператора).
|-
|
originalStarName *
|
String
|
Оригинальная категория отеля (данные туроператора).
|-
|
originalTownName *
|
String
|
Оригинальное название курорта (данные туроператора).
|-
|
originalMealName *
|
String
|
Оригинальный тип питания (данные туроператора).
|-
|
originalHtPlaceName *
|
String
|
Оригинальный тип размещения (данные туроператора).
|-
|
originalRoomName *
|
String
|
Оригинальный тип номера (данные туроператора).
|-
|
originalCountryName *
|
String
|
Оригинальное название страны (данные туроператора).
|-
|
originalDptCityName *
|
String
|
Оригинальное название города вылета (данные туроператора).
|-
|
originalPrice *
|
Int32
|
Цена тура у туроператора (может отличаться от цены в атрибуте price, если туроператор предоставляет такую информацию).
|-
|
originalCurrencyId *
|
Int32
|
Идентификатор валюты к атрибуту originalPrice (2 – USD, 3 – EUR, 5 – RUR).
|-
|
originalCurrencyName *
|
String
|
Оригинальное название валюты у туроператора.
|-
|
fewPlacesInHotel''' '''
|
Int32
|
Если есть места в отеле (hotelIsInStop = 0) и данное значение отлично от нуля, то мест в
отеле МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что мест МАЛО, но не информирует о
точном количестве в остатке.
Если передано любое иное число, отличное от нуля, то это точное количество оставшихся мест.
|-
|
fewEconomTicketsDpt''' '''
|
Int32
|
Если есть места на перелёт эконом-классом (туда) (economTicketsDpt = 1) и
данное значение отлично от нуля, то билетов МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке.
Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewEconomTicketsRtn''' '''
|
Int32
|
Если есть места на перелёт эконом-классом (обратно) (economTicketsRtn = 1) и данное значение отлично от нуля, то билетов МАЛО. Значение -1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке. Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewBusinessTicketsDpt''' '''
|
Int32
|
Если есть места на перелёт бизнес-классом (туда) (businessTicketsDpt = 1) и
данное значение отлично от нуля, то билетов МАЛО. Значение -1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует о точном количестве в остатке.
Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
fewBusinessTicketsRtn''' '''
|
Int32
|
Если есть места на перелёт бизнес-классом (обратно) (businessTicketsRtn = 1) и
данное значение отлично от нуля, то билетов МАЛО.
Значение
-1 передаётся, если туроператор сообщает, что билетов МАЛО, но не информирует
о точном количестве в остатке. Если передано любое иное число отличное от нуля, то это точное количество оставшихся билетов.
|-
|
priceType *
|
Int32
|
Тип
цены у туроператора (0 – на номер, 1- на человека). Независимо от типа цены стоимость тура выдаётся конечной.
|-
|
flags''' '''
|
UInt64
|
Набор битовых флагов тура. Тур может иметь несколько установленных флагов одновременно, данное значение является их суммой.
Возможные флаги тура:
* 1 – туроператор рекомендует данный тур;
* 2 – доступно мгновенное подтверждение;
* 4 – туроператор считает данный тур лучшим предложением;
* 8 – тур раннего бронирования;
* 16 – тур позднего бронирования;
* 32 – туроператор предоставляет скидку на данный тур;
* 64 – VIP предложение;
* 128 – тур доступен в кредит;
* 256 – тур является эксклюзивным предложением туроператора;
* 512 – при покупке тура турист получает подарок;
* 1024 – тур является комбинированным.
|-
|
creditMonths''' '''
|
Int32?
|
Если
тур доступен для покупки в кредит, то в данном поле указывается срок кредита
в месяцах, иначе атрибут будет отсутствовать.
|-
|
creditMonthlyPay''' '''
|
Int32?
|
Если
тур доступен для покупки в кредит, то в данном поле указывается размер
ежемесячных выплат, иначе атрибут будет отсутствовать.
|-
|
description''' '''
|
String
|
Дополнительная
информация по туру. Например, для комбинированных туров может содержать информацию
о проживании в отелях.
|-
|
discountPercent''' '''
|
Single?
|
Если
туроператор предоставляет скидку, то в данном поле выводится размер скидки,
иначе атрибут будет отсутствовать.
|-
|
discountExpires''' '''
|
DateTime ?
|
Если
туроператор предоставляет скидку и указывает срок её действия, то в данном
поле выводится дата окончания акции, иначе атрибут будет отсутствовать.
|-
|
discountCaption''' '''
|
String
|
Описание
скидки/акции.
|-
|
receivingParty''' '''
|
String
|
Принимающая
сторона (если информация предоставляется туроператором).
|-
|
giftCaption''' '''
|
String
|
Если по
акции туроператор предоставляет подарки, то в данном поле выводится их описание.
|-
|
earlyBookingValidTill''' '''
|
DateTime
?
|
Если
тур является туром раннего бронирования и туроператор предоставляет последнюю дату ранней брони, то в данном поле выводится это значение, иначе атрибут будет отсутствовать.
|-
|
updateDate *
|
DateTme
|
Дата и время (UTC) последнего обновления информации о туре.
|-
|
|
|
|
|
|}

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

https://bulk.sletat.ru/BulkCacheDownload?packetId=922AC42F-9927-4B8C-A1EB-0020C35C4F22

После загрузки и распаковки данных получаем следующий пакет (для читаемости оставлены только два элемента '''tour'''):

<source lang="xml">

<tours>
<tour offerId="200626003" requestId="116002036" sourceId="3" updateDate="2013-04-28 14:31:00" price="35382" currencyId="5" checkin="2013-05-26" nights="13" adults="1" kids="0" mealId="113" roomId="5283" htplaceId="13094" hotelIsInStop="0" ticketsIncluded="1" hasEconomTicketsDpt="1" hasEconomTicketsRtn="1" hasBusinessTicketsDpt="0" hasBusinessTicketsRtn="0" tourName="PALMA DE MALLORCA (KEMEROVO)" hotelName="HOTEL BLUE SEA DON JAIME" townName="PALMA DE MALLORCA" starName="3*" mealName="HB" roomName="Standard" htplaceName="SGL" originalHotelName="HOTEL BLUE SEA DON JAIME" originalTownName="PALMA DE MALLORCA" originalStarName="3*" originalMealName="HB" originalRoomName="Standard Room" originalHtplaceName="Single" originalCountryName="SPAIN" originalDptCityName="Кемерово" originalCurencyId="3" originalCurrencyName="EUR" originalPrice="853" tourUrl="https://agency.pegast.ru/samo5/bron?CLAIM=1717245082&TOWNFROMINC=75&STATEINC=58&SPOINC=397842" priceType="0" flags="128" creditMonths="6" creditMonthlyPay="5897" />
<tour offerId="200626009" requestId="116002036" sourceId="3" updateDate="2013-04-28 14:31:00" price="39282" currencyId="5" checkin="2013-05-26" nights="13" adults="1" kids="0" mealId="113" htplaceId="13094" hotelIsInStop="0" ticketsIncluded="1" hasEconomTicketsDpt="1" hasEconomTicketsRtn="1" hasBusinessTicketsDpt="0" hasBusinessTicketsRtn="0" tourName="PALMA DE MALLORCA (KEMEROVO)" hotelName="APARTHOTEL BLUE SEA CALA GUYA MAR" townName="PALMA DE MALLORCA" starName="3*" mealName="HB" roomName="One Bedroom Apartment" htplaceName="SGL" originalHotelName="APARTHOTEL BLUE SEA CALA GUYA MAR" originalTownName="PALMA DE MALLORCA" originalStarName="3*" originalMealName="HB" originalRoomName="One Bedroom Apartment" originalHtplaceName="Single" originalCountryName="SPAIN" originalDptCityName="Кемерово" originalCurencyId="3" originalCurrencyName="EUR" originalPrice="947" tourUrl="https://agency.pegast.ru/samo5/bron?CLAIM=1717245104&TOWNFROMINC=75&STATEINC=58&SPO INC=397842" priceType="0" flags="128" creditMonths="6" creditMonthlyPay="6547" />
</tours>

</source>

=== GetFuelSurcharges ===

Метод '''GetFuelSurcharges''' позволяет получить список всех топливных сборов.Сигнатура:
FuelSurchargeInfo[] GetFuelSurcharges()

Параметры отсутствуют.
В ответ возвращает массив описаний топливных сборов '''FuelSurchargeInfo'''. Каждый элемент содержит следующие поля:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
SourceId
|
Int32?
|
Идентификатор туроператора. Если null, значит сбор применяется вне зависимости от туроператора
|-
|
TownFromId
|
Int32?
|
Идентификатор города вылета. Если null, значит сбор применяется вне зависимости от города вылета.
|-
|
CountryId
|
Int32?
|
Идентификатор направления. Если null, значит сбор применяется вне зависимости от направления.
|-
|
ResortId
|
Int32?
|
Идентификатор курорта, если null, значит сбор применяется вне зависимости от курорта.
|-
|
AirportId
|
Int32?
|
Идентификатор аэропорта назначения. Если null, значит сбор применяется вне зависимости от аэропорта назначения.
|-
|
AircompanyId
|
Int32?
|
Идентификатор авиакомпании. Если null, значит сбор применяется вне зависимости от авиакомпании.
|-
|
FlightNumber
|
Int32?
|
Номер рейса. Если null, значит сбор применяется вне зависимости от номера рейса.
|-
|
HostId
|
Int32?
|
Идентификатор туроператора принимающей стороны. Если null, значит сбор применяется вне зависимости от туроператора принимающей стороны.
|-
|
PeriodStartDate
|
DateTime
|
Дата начала действия сбора.
|-
|
PeriodEndDate
|
DateTime
|
Дата окончания действия сбора.
|-
|
Price
|
Decimal ?
|
Сумма сбора. Если пусто, значит по данному фильтру сбор не взимается.
|-
|
CurrencyId
|
Int32?
|
Идентификатор валюты сбора. Пусто при отсутствии сбора
|}

Топливный сбор применяется по наибольшему совпадению параметров тура с параметрами сбора.Фильтровать сборы для тура нужно следующим образом:

# Выбрать сборы по туроператору и те, для которых поле SourceId = null;
# Из выбранных сборов взять те, чьи периоды действия включают даты начала и окончания тура;
# Из выбранных сборов взять те, для которых поле TownFromId = городу вылета или null;
# Из выбранных сборов взять те, для которых поле CountryId = стране или null;
# Из выбранных сборов взять те, для которых поле ResortId = курорту или null;
# Из выбранных удалить сборы с «широким фильтром» (среди параметров TownFromId, CountryId, ResortId, SourceId все или несколько равны null), у которых остальные параметры совпадают с параметрами сборов в выборке с более «узким фильтром» (среди параметров TownFromId, CountryId, ResortId, SourceId все или несколько равны параметрам тура соответственно).

=== GetVisaSurcharges ===

Метод '''GetVisaSurcharges''' позволяет получить список всех визовых сборов. Сигнатура:

VisaSurchargeInfo[] GetVisaSurcharges()

Параметры отсутствуют.В ответ возвращает массив описаний визовых сборов VisaSurchargeInfo. Каждый элемент содержит следующие поля:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
SourceId
|
Int32?
|
Идентификатор туроператора. Если null, значит сбор применяется вне зависимости от туроператора.
|-
|
TownFromId
|
Int32?
|
Идентификатор города оформления. Возможные исключения:
# Если null, значит сбор применяется вне зависимости от города вылета.
# Если 1, значит виза оформляется по прибытии.
|-
|
CountryId
|
Int32?
|
Идентификатор страны назначения. Если null, значит сбор применяется вне зависимости от страны назначения
|-
|
Citizenship
|
Int32?
|
Идентификатор страны, гражданином которой является турист. Если null, значит сбор применяется вне зависимости от гражданства.
|-
|
IsExpress
|
bool?
|
True – сбор указан для экспресс-оформления. False – сбор указан для обычного оформления, null – сбор для любого типа оформления.
|-
|
AgeFrom
|
Int32?
|
Нижняя возрастная граница оформления визы.
|-
|
AgeTo
|
Int32?
|
Верхняя возрастная граница оформления визы.
|-
|
PasportType
|
bool?
|
Тип паспорта: true – свой, false – вписан, null – сбор применяется вне зависимости от типа паспорта.
|-
|
IssueDaysFrom
|
Int32?
|
Минимальный срок оформления, дней.
|-
|
IssueDaysTo
|
Int32?
|
Максимальный срок оформления, дней.
|-
|
Price
|
Decimal
?
|
Сумма сбора. Если пусто, значит по данному фильтру сбор не взимается.
|-
|
CurrencyId
|
Int32?
|
Идентификатор валюты сбора. Пусто при отсутствии сбора.
|}

=== GetRequestInfo ===

Вспомогательный метод '''GetRequestInfo''' предназначен для получения данных о поисковом запросе по его идентификатору. Идентификаторы поисковых запросов присутствуют в выгрузке для всех туров. Сигнатура:

RequestInfo GetRequestInfo(Int32 requestId)

Параметр '''requestId''' – идентификатор поискового запроса. Если запрос был найден, то в ответ будет возвращена структура со следующими полями:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
CurrencyAlias *
|
Int32
|
Валюта поиска (RUB, USD, UAH, BYR, EUR и UZS).
|-
|
DptCityId *
|
Int32
|
Идентификатор города вылета.
|-
|
CountryId *
|
Int32
|
Идентификатор страны.
|-
|
Adults *
|
Int32
|
Количество туристов (взрослых).
|-
|
Kids *
|
Int32
|
Количество туристов (детей).
|-
|
KidsAges
|
Int32[]
|
Возрасты детей (если были указаны).
|-
|
NightsMin *
|
Int32
|
Минимальная продолжительность тура, ночей.
|-
|
NightsMax *
|
Int32
|
Максимальная продолжительность тура, ночей.
|-
|
PriceMin
|
Int32
|
Минимальная цена.
|-
|
PriceMax
|
Int32
|
Максимальная цена.
|-
|
Date1 *
|
DateTime
|
Диапазон дат вылета, первая дата.
|-
|
Date2 *
|
DateTime
|
Диапазон дат вылета, вторая дата.
|-
|
HotelIsNotInStop *
|
Boolean
|
Отмечен флажок «Есть места в отеле».
|-
|
TicketsIncluded *
|
Boolean
|
Отмечен флажок «Перелет включен».
|-
|
HasTickets *
|
Boolean
|
Отмечен флажок «Есть билеты».
|-
|
HotelIds
|
Int32[]
|
Выбранные отели (если были указаны).
|-
|
StarIds
|
Int32[]
|
Выбранные категории отелей (если были указаны).
|-
|
MealIds
|
Int32[]
|
Выбранные типы питания (если были указаны).
|-
|
TownIds
|
Int32[]
|
Выбранные курорты (если были указаны).
|}

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

2026-03-30T14:25:50Z

Kdadmin: Добавление валюты UZS

[[Category:Расширения и дополнения]]
== Актуализация и загрузка информации о туре ==

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

Сигнатура:
XmlActualPriceData ActualizePrice(Int32 sourceId, Int64 offerId, Int32 requestId, Int32[] selectedResources, String login, String password)

Параметры:
* requestId – идентификатор поискового запроса, выдается методом GetTours при создании
нового поискового запроса;
* offerId – идентификатор тура, выдаётся в методе GetTours для каждого тура;
* sourceId – идентификатор туроператора, выдаётся в методе GetTours для каждого тура;
* selectedResources – устарел.

* login – логин для авторизации в личном кабинете туроператора;
* password – пароль для авторизации в личном кабинете туроператора;
Если логин и пароль личного кабинета туроператора не передается в запросе, успешная актуализация информации по туру не гарантируется.
В ответ возвращается структура '''ActualizePriceResult''', которая состоит из следующих полей:
* TourInfo – структура описывает основную информацию о туре, формат описан ниже;
* RandomNumber – случайное четырехзначное число, по которому можно просмотреть информацию о туре в личном кабинете на сайте sletat.ru или в SletatRu Agent, используется для того, чтобы клиент мог точно сообщить менеджеру вашей компании о туре, который он нашёл;

* IsFound – поле принимает значение false, если тур не был найден в базе туроператора;
* IsError – принимает значение true, если при актуализации тура возникла ошибка;
* Resources – список услуг, входящих в тур, поле может быть пустым, если для туроператора
не реализована поддержка вывода подробной информации, формат списка услуг будет
описан ниже;
* ResourceData – список дополнительных произвольных данных к любой услуге из поля
Resources, формат будет описан ниже;

Описание структуры '''TourInfo''':

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
CountryName
|
String
|
Страна (данные от
туроператора).
|-
|
CityFromName
|
String
|
Город вылета (данные от
туроператора).
|-
|
ResortName
|
String
|
Курорт (данные от
туроператора).
|-
|
TourName
|
String
|
Название тура (данные от
туроператора).
|-
|
CheckIn
|
String
|
Дата вылета в формате
dd.MM.yyyy.
|-
|CheckOut
|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, BYR и UZS).
|-
|
OriginalPrice
|
Int32
|
Оригинальная цена тура в исходной валюте (со скидкой и наценкой).
|-
|
OriginalPriceCurrency
|
String
|
Обозначение валюты (данные
от туроператора) для цены '''OriginalPrice'''.
|-
|
SourceId
|
Int32
|
Идентификатор туроператора. Поле заполняется
только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).
|-
|
SourceName
|
String
|
Название туроператора. Поле
заполняется только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).
|-
|
SourceSearchFormUrl
|
String
|
Ссылка на форму поиска
туроператора. Поле заполняется только для партнёров sletat.ru (по всем вопросам
обращайтесь в службу поддержки info@sletat.ru).
|-
|
SysCountryId
|
Int32
|
Идентификатор страны из
справочника стран.
|-
|
SysCountryName
|
String
|
Название страны из
справочника стран.
|-
|
SysCityFromId
|
Int32
|
Идентификатор города вылета
из справочника городов вылета.
|-
|
SysCityFromName
|
String
|
Название города вылета из
справочника городов вылета.
|-
|
SysResortId
|
Int32
|
Идентификатор курорта из справочника курортов
(либо из справочника '''GetCtities''' или '''GetGeoTree''', в зависимости от параметра '''useTree''' исходного поискового запроса), параметр может быть равен 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
|
Ссылка на описание / бронирование тура на сайте туроператора. Поле заполняется только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).

В настоящий момент некоторые
туроператоры не имеют ссылок в сервисе Слетать.ру.
|-
|OriginalCurrencyId
|Int32
|Идентификатор валюты тура по данным туроператора. Возможные значения: 2 – USD, 3 – EUR, 5 – RUR.
|-
|Adults
|Int32
|Количество туристов (взрослых).
|-
|Kids
|Int32
|Количество туристов (детей).
|}

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

Структура '''Resources''' состоит из вложенных элементов '''Resource''', каждый из которых описывает одну услугу в туре полями:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Id
|
Int32
|
Идентификатор услуги
|-
| Type
| Int32
| Тип услуги, список возможных типов:
* 1 - тур;
* 2 - проживание;
* 3 - страховка;
* 4 - транспорт (туда);
* 5 - дополнительные сервисы;
* 6 - дополнительное питание;
* 7 - трансфер;
* 8 - экскурсии;
* 9 - различные сборы;
* 10 - транспорт (обратно);
* 11 - информация о визах;
* 12 - страховка от невыезда;
* 13 - возможность добавления младенца;
* 14 - информация о комиссии;
* 15 - доп. перелёт в комбинированном туре;
* 16 - выбор размещения в основном отеле;
* 18 - Услуги гида;
* 19 - Питание;
* 20 - Топливный сбор;
* 21 - Авиаперелёт;
* 22 - Ж/Д билеты;
* 23 - Автобусный переезд;
* 24 - Морское путешествие;
* 25 - Other;
* 26 - Экологический сбор или GreenTax.
|-
|
Name
|
String
|
Название услуги.
|-
|
IsChecked
|
Boolean
|
При значении true указывает,
что данная услуга входит в посчитанную цену.
|-
|
IsEnabled
|
Boolean
|
При значении true указывает, что данная услуга
может быть включена или исключена из стоимости тура, и стоимость может быть
пересчитана повторным вызовом данного метода с использованием параметра selectedResources.
|-
|
GroupId
|
Int32?
|
Идентификатор группы. Группы используются для указания на взаимоисключающие услуги, т.е. набор услуг, только одна из
которых может быть выбрана. Значение поля может быть NULL, в этом случае выбор
услуги никак не связан с другими услугами.
|-
|
Exclude
|
String
|
Список идентификаторов других ресурсов, пересчёт тура с которыми невозможен с использованием данного ресурса. С помощью данного поля, например, устанавливается список подходящих обратных перелётов для каждого перелёта в страну отдыха. Список разделён запятыми.
|}

Структура '''ResourceData''' может включать дополнительные описания для услуг из поля '''Resources'''. Каждый элемент состоит из полей:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Name
|
String
|
Название дополнительного поля с описанием.
|-
|
ResourceId
|
Int32
|
Идентификатор услуги из структуры '''Resources'''.
|-
|
Value
|
String
|
Содержание дополнительного поля с описанием.
|}

Ниже представлена таблица возможных значений поля '''Name''' для каждого типа услуг:

{| class="wikitable"
|-
|
Тип ресурса
|
Значение Name
|
Описание
|-
|
1 (тур)
|
COMMENT
|
Комментарий к туру.
|-
|
1 (тур)
|
DATEBEG
|
Дата начала тура.
|-
|
1 (тур)
|
DATEEND
|
Дата окончания тура.
|-
|
1 (тур)
|
PEOPLE_COUNT
|
Кол-во людей для заселения
(без учёта младенца, если есть)
|-
|
1 (тур)
|
BAGGAGE_INCLUDED
|
Указывает удалось ли получить информацию о багаже от туроператора
|-
|
1 (тур)
|
BAGGAGE_PLACES
|
Кол-во багажных мест
|-
|
1 (тур)
|
BAGGAGE_WEIGHT
|
Указывает допустимый вес багажа (кг)
|-
|
1 (тур)
|
BAGGAGE_SIZE
|
Допустимый размер багажа
|-
|
1 (тур)
|
LUGGAGE_INCLUDED
|
Указывает удалось ли получить информацию о ручной клади от туроператора
|-
|
1 (тур)
|
LUGGAGE_PLACES
|
Кол-во мест ручной клади
|-
|
1 (тур)
|
LUGGAGE_WEIGHT
|
Указывает допустимый вес ручной клади (кг)
|-
|
1 (тур)
|
LUGGAGE_SIZE
|
Допустимый размер ручной клади
|-
|
2
(проживание)
|
URL
|
Ссылка на описание отеля.
|-
|
2
(проживание)
|
RESORT
|
Курорт, в котором расположен
отель.
|-
|
2
(проживание)
|
HTPLACE
|
Размещение в отеле.
|-
|
2
(проживание)
|
ROOM
|
Тип номера.
|-
|
2
(проживание)
|
MEAL
|
Питание в отеле.
|-
|
2
(проживание)
|
CHECKIN
|
Дата заезда.
|-
|
2
(проживание)
|
CHECKOUT
|
Дата выезда.
|-
|
4, 10,
15 (перелёт)
|
FLIGHT
|
Номер рейса.
|-
|
4, 10,
15 (перелёт)
|
FLIGHT_IS_CONCRETE
|
Конкретизация авиаперелета (true - конкретизирован, false - не конкретизирован)
|-
|
4, 10,
15 (перелёт)
|
DATE
|
Дата перелёта.
|-
|
4, 10,
15 (перелёт)
|
START_TIME
|
Время начала перелёта.
|-
|
4, 10,
15 (перелёт)
|
END_TIME
|
Время окончания перелёта.
|-
|
4, 10,
15 (перелёт)
|
AIRPORT_FROM
|
Аэропорт вылета.
|-
|
4, 10,
15 (перелёт)
|
AIRPORT_TO
|
Аэропорт прилёта.
|-
|
4, 10,
15 (перелёт)
|
CLASS
|
Класс перелёта, возможны
значения ECONOM и BUSINESS.
|-
|
14
(комиссия)
|
COMISSION_BASE
|
Базовая комиссия агентства
(%).
|-
|
14
(комиссия)
|
COMISSION_EARLY_ORDER
|
Комиссия за раннее
бронирование (%).
|-
|
14
(комиссия)
|
COMISSION_BONUS
|
Бонус к комиссии (%).
|-
|
14
(комиссия)
|
COMISSION_SUM
|
Сумма комиссии в оригинальной валюте тура (для
туроператоров на основе СамоТур сумма комиссии появляется после пересчёта
цены тура).
|-
|
16
(размещение)
|
PEOPLE_COUNT
|
Кол-во людей в выбранном
размещении.
|-
|
16
(размещение)
|
IS_IN_STOP
|
Есть ли места, 2 –
запрос, 1 – стоп, 0 – есть места.
|-
|
16
(размещение)
|
PRICE
|
Цена размещения.
|-
|
16
(размещение)
|
CURRENCY_ID
|
Системный идентификатор
валюты (5 – рубли, 3 – евро, 2 – доллары).
|-
|
16
(размещение)
|
CURRENCY_NAME
|
Название валюты у
туроператора.
|}

Таблица '''ResourceData''' заполняется данными, если они предоставляются туроператором.

Пример реализации на PHP:

<source lang="php">

$searchParam = array(
"sourceId"=>"Зашифрованный идентификатор туроператора. Выдаётся каждому туру методом GetRequestResult.",
"offerId"=>"Идентификатор ценового предложения. Выдаётся каждому туру методом GetRequestResult.",
"requestId"=> 0,
"login"=> "логин от ЛК ТО",
"password"=>"пароль от ЛК ТО"
);

$soapClient = new SoapClient('https://module.sletat.ru/XmlGate.svc?singlewsdl');
$soapClient->__setSoapHeaders( new SoapHeader("urn:SletatRu:DataTypes:AuthData:v1", "AuthInfo", array(
"Login" => 'Логин в системе Слетать.ру',
"Password"=> 'Пароль в системе Слетать.ру'
)));
$result = $soapClient->ActualizePrice($searchParam);
</source>

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

2026-03-30T14:23:44Z

Kdadmin: Добавление валюты UZS

[[Category:Шлюзы поиска туров]]
== Описание сервиса ==

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

* Загружать справочники городов вылета, стран, курортов, отелей, категорий отелей, видов питания;
* Искать горящие туры, предварительно отобранные системой Слетать.ру по 70 различным шаблонам (в том числе по уникальному шаблону, который вы можете настроить самостоятельно).

{| class="standard"
| style="background-color:silver" |Внимание! Настройка уникального шаблона поиска горящих туров ограничена лицензией. По всем вопросам обращайтесь по электронной почте info@sletat.ru.
|}

{| class="standard"
| style="background-color:silver" |Внимание! В настоящем руководстве описаны методы и параметры запросов, являющиеся актуальными на текущий момент. Обращение к неописанным методам и параметрам может привести к некорректной работе сервиса.
|}

== Подключение к сервису ==

Все методы веб-сервиса располагаются по адресу:

https://module.sletat.ru/Main.svc?singlewsdl

Вызов любого метода должен иметь следующий синтаксис:

https://module.sletat.ru/Main.svc/{ИмяМетода}?{параметр1}={значение1}&{параметр2}={значение2}...

Пример вызова:

https://module.sletat.ru/Main.svc/GetTemplates?templatesList=all&login=XXX&password=YYY

{| class="standard"
| style="background-color:silver" |Внимание! Для корректной работы с методами поиска требуется авторизация. Каждый запрос должен содержать пару параметров '''login''' и '''password''' – ваши учетные данные на сайте sletat.ru. Требование не распространяется на получение справочников, однако к данным справочников '''[[Шлюз поиска горящих туров (json)#GetDepartCities|GetDepartCities]]''' и '''[[Шлюз поиска горящих туров (json)#GetCountries|GetCountries]]''' при указании этих параметров будут применены фильтры, настраиваемые в Личном кабинете (подробности см. в описании соответствующих методов).
|}

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

Передавать все параметры при вызове не обязательно. Обязательные параметры отмечены звёздочкой (*).

== Логика работы ==
# Основная логика работы шлюза подразумевает, что методы работают в рамках шаблона, по которому отбираются горящие туры. Поэтому для начала методом [[Шлюз поиска горящих туров (json)#GetTemplates|'''GetTemplates''']] запрашивается список доступных шаблонов.
# Методом '''[[Шлюз поиска горящих туров (json)#GetDepartCities|GetDepartCities]]''' с использованием названия шаблона '''templateName''', полученного в ответе метода '''[[Шлюз поиска горящих туров (json)#GetTemplates|GetTemplates]]''', запрашивается описание города вылета, доступного в рамках используемого шаблона.
# В ответе метода '''[[Шлюз поиска горящих туров (json)#GetShowcaseRewiew|GetShowcaseRewiew]]''' приходят данные о направлениях, доступных для города вылета: идентификатор и название страны, диапазон доступных параметров поиска, а также описание шаблона и самого дешёвого тура, найденного по нему.
# Методом '''[[Шлюз поиска горящих туров (json)#GetTours|GetTours]]''' запускается поиск туров, соответствующих параметрам шаблона.
# Методом '''[[Шлюз поиска горящих туров (json)#ActualizePrice|ActualizePrice]]''' запрашивается текущее состояние тура у оператора: наличие билетов и мест в отеле, размеры топливных и визовых сборов.
# Метод '''[[Шлюз поиска горящих туров (json)#SaveTourOrder|SaveTourOrder]]''' передаёт данные о заказе в систему Слетать.ру. Список заказов, а также вся сопутствующая статистика, отображаются в вашем Личном кабинете. Все данные можно выгрузить в формате XML.

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

Вы можете работать с сервисом и без обращения к справочникам – все необходимые данные приходят в ответах методов '''[[Шлюз поиска горящих туров (json)#GetDepartCities|GetDepartCities]]''' и '''[[Шлюз поиска горящих туров (json)#GetShowcaseReview|GetShowcaseReview]]'''. Однако знание структуры справочников поможет вам глубже понять устройство сервиса и реализовать более широкий функционал, нежели тот, который был бы доступен при использовании одних только методов поиска горящих туров.

Ответ каждого метода содержит поле '''Data''' – массив данных, запрашиваемых методов, а также следующие технические поля:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
ErrorMessage
|
str
|
Текст
сообщения об ошибке. Поле принимает значение «'''null»''', если
значение поля '''IsError = false'''.
|-
|
ExecutionTimeMs
|
int
|
Время
обработки запроса в миллисекундах.
|-
|
IsError
|
bool
|
Сообщение
об ошибке. Если при обработке запроса произошла ошибка, поле принимает
значение «'''true'''»; в противном случае оно остаётся равным «'''false»'''.
|}

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

=== Методы получения справочников ===
Наиболее полный справочник доступен по ссылке:
https://module.sletat.ru/Dictionaries.xml

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

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

https://module.sletat.ru/Main.svc/GetDepartCities?templateName=%D0%93%D0%BE%D1%80%D1%8F%D1%89%D0%B8%D0%B5+%D1%82%D1%83%D1%80%D1%8B+(%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0)&showcase=1&login=XXX&password=YYY

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
templateName
|
Название шаблона,
полученное в поле name структуры '''GetTemplatesResult.Data.templates[]'''. Если параметр передан, возвращаются данные о городе вылета, доступном для данного
шаблона; в противном случае возвращается описание города для шаблона, используемого по умолчанию в Личном кабинете на сайте sletat.ru. Требует
передачи параметра '''showcase'''.
|-
|
showcase
|
Режим поиска горящих
туров. Возможные значения «1» — включён. Требует передачи параметров '''login''' и '''password'''.
|}

{| class="standard"
| style="background-color:silver" |Внимание! Если на вашу учётную запись выписана активная лицензия на шлюз поиска туров и при обращении к методу вы передаёте параметры '''login''' и '''password''' без параметра '''showcase''', список городов вылета будет отфильтрован в соответствии с настройками для шлюза поиска туров (раздел «Настройки модулей => XML-шлюз поиска туров => Направления и города вылета»).
|}

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

<source lang="xml">

{
"GetDepartCitiesResult":{
"Data":[
{
"Id": 832,
"Name": "Москва",
"CountryId": 150,
"Default": true,
"DescriptionUrl": null,
"IsPopular": true,
"ParentId": null
},
...
],
}
}

</source>

В ответ возвращается массив '''GetDepartCitiesResult.Data''', каждый объект которого имеет следующие поля:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
int
|
Идентификатор города
вылета.
|-
|
Name
|
str
|
Город вылета.
|-
|
CountryId
|
int
|
Идентификатор
страны.
|-
|
Default
|
bool
|
Если город
используется для поиска туров по умолчанию, поле принимает значение true, в противном случае
– false.
|-
|
DescriptonUrl
|
str
|
Ссылка на описание
города. Поле принимает значение '''null''', если данные не слинкованы.
|-
|
IsPopular
|
bool
|
Если по данным
аналитики Слетать.ру, город является популярным, поле принимает значение '''true'''; в противном случае
– '''false'''.
|-
|
ParentId
|
int
|
Идентификатор родительского города (см. поле '''ParentId''' в описании ответа метода '''[[Шлюз поиска горящих туров (json)#GetCities|GetCities]]'''). Поле может иметь значение null, если город вылета не имеет родительского города.
|}

==== GetCountries ====
Метод '''GetCountries''' возвращает список доступных направлений перелета (стран) для любого данного города вылета.

Пример запроса:
https://module.sletat.ru/Main.svc/GetCountries?townFromId=1264&showcase=1&login=XXX&password=YYY

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

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
townFromId
|
Идентификатор
города вылета, полученный методом '''[[Шлюз поиска горящих туров (json)#GetDepartCities|GetDepartCities]]'''.
|-
| showcase
| Режим
поиска горящих туров. Возможные значения «1» — включён. Требует передачи параметров '''login''' и '''password'''. Если режим включён, список стран будет отфильтрован в соответствии с настройками вашего Личного кабинета (раздел «Настройки модулей => XML-шлюз поиска туров => Направления»).
|-
| templateName
| Имя шаблона горящих туров
|}

{| class="standard"
| style="background-color:silver" |Внимание! Если на вашу учётную запись выписана активная лицензия на шлюз поиска туров и при обращении к методу вы передаёте параметры '''login''' и '''password''' без параметра '''showcase''', список стран будет отфильтрован в соответствии с настройками для шлюза поиска туров (раздел «Настройки модулей => XML-шлюз поиска туров => Направления и города вылета»).
|}

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

<source lang="xml">

{
"GetCountriesResult":{
"Data":[
{
"Id":1,
"Name":"Абхазия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
...
],
}
}

</source>

В ответ возвращается массив '''GetCountriesResult.Data''', каждый из объектов которого содержит данные о направлениях, доступных для указанного города вылета:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
int
| Идентификатор страны (направления перелета).
|-
| Name
| str
| Наименование страны (направления перелета).
|-
| Alias
| str
|
Текстовый код страны (направления перелета).
|-
|
HasTickets
|
bool
|
Значение
по умолчанию для параметра наличия билетов. Возможные значения:
* '''true''' — в выдачу должны попадать только туры, для которых есть авиабилеты;
* '''false''' — в выдачу могут попадать все туры.
Полученное значение будет использовано в поиске, если в запросе метода '''[[Шлюз поиска горящих туров (json)#GetTours|GetTours]]''' не передан соответствующий параметр.
|-
|
HotelIsNotInStop
|
bool
|
Значение
по умолчанию для параметра наличия мест в отеле. Возможные значения: '''true''' — в выдачу должны попадать только туры,
для которых есть места в отеле; '''false''' — в выдачу могут попадать все туры.
Полученное значение будет использовано в поиске, если в запросе метода '''[[Шлюз поиска горящих туров (json)#GetTours|GetTours]]''' не передан соответствующий параметр.
|-
|
Rank
|
int
| Рейтинг страны (0 — самый высокий).
|-
| TicketsIncluded
| bool
| Значение по умолчанию для параметра включения перелёта в стоимость тура. Возможные значения: '''true''' — в выдачу должны попадать только туры, в
стоимость которых включён перелёт; '''false''' — в выдачу могут попадать все туры. Полученное
значение будет использовано в поиске, если в запросе метода '''[[Шлюз поиска горящих туров (json)#GetTours|GetTours]]''' не передан соответствующий параметр.
|-
|IsVisa
|bool
|Требуется ли виза гражданам РФ для въезда. Возможные значения: «false» — не требуется, «true» — требуется.
|-
|Flags
|byte
|Дополнительные параметры страны (направления вылета). Возможные значения: 0 = None, Exotic = 1 (экзотическая страна), SeaShore = 2 (Подходит для отдыха на море), Schengen = 4 (Является страной шенгенского соглашения).
|}

==== GetCities ====
Метод '''GetCities''' возвращает список курортов для выбранного направления.

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

https://module.sletat.ru/Main.svc/GetCities?countryId=40

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|Тип
|
Описание
|-
|
countryId *
|Int32
|
Идентификатор
направления, полученный методом '''GetCountries'''.
|-
|lang
|String
|Язык возвращаемого названия курорта. Возможные варианты: ru-Ru (по умолчанию), en-En.
|-
|top
|String
|
|}

Запрашивается справочник курортов Египта.

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

<source lang="xml">

{
"GetCitiesResult":{
"Data":[
{
"Id":3769,
"Name":"Адабия",
"Default":false,
"DescriptionUrl":"",
"IsPopular":false,
"ParentId":null
},
...
],
}
}

</source>

В ответ возвращается массив '''GetCitiesResult.Data''', каждый из объектов которого содержит описание курорта запрошенной страны:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
int
|
Идентификатор
курорта.
|-
|
Name
|
str
|
Название
курорта.
|-
|CountryId
|int
|Идентификатор страны
|-
|
Default
|
bool
|
Принимает
значение '''true''', если курорт используется для поиска туров по
умолчанию; в противном случае – '''false'''.
|-
|
DescriptionUrl
|
str
|
Ссылка
на описание курорта. Поле может быть пустым, если курорт не имеет описания.
|-
|
IsPopular
|
bool
|
Принимает значение '''true''', если курорт был признан популярным на основе
статистики поисковых запросов, сделанных на сайте sletat.ru и сайтах
партнёров; в противном случае — '''false'''.
|-
|
ParentId
|
int
|
Идентификатор родительского курорта. Например,
для греческих курортов Ираклиона, Лассити и Ретимно идентификатором родительского
курорта будет 3071 - идентификатор о. Крит. Поле может быть пустым, если курорт не имеет родительской записи.
|}

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

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

https://module.sletat.ru/Main.svc/GetHotelStars?countryId=40&towns=372,1592,1642

Запрашиваются справочники категорий отелей для Шарм-эль-Шейха, Хургады и Дахаба (Египет).

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
countryId '''*'''
|
Идентификатор страны.
|-
|
towns
|
Идентификаторы курортов, разделённые запятой.
|}

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

<source lang="xml">

{
"GetHotelStarsResult":{
"Data":[
{
"Id":401,
"Name":"2*"
},
...
],
}
}

</source>

В ответ возвращается массив '''GetHotelStarsResult.Data''', каждый объект которого содержит описание категории отеля:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
int
|
Идентификатор
категории отеля.
|-
|
Name
|
str
|
Категория
отеля.
|}

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

Пример запроса:
https://module.sletat.ru/Main.svc/GetHotels?countryId=40&towns=1642&stars=404&all=-1

Запрашивается справочник по пятизвёздочным отелям Шарм-эль-Шейха (Египет).

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
all
|
Количество
отелей в выдаче. Возможные значения: “-1” – в выдачу попадают все
отели; любое положительное целое число – точное количество отелей.
|-
|
countryId
|
Идентификатор
направления.
|-
|
filter
|
Фильтрация
по названию отеля.
|-
|
id
|
Идентификатор отеля.
|-
|
page
|
Номер страницы.
|-
|
pageSize
|
Количество отелей в ответе.
|-
|
stars
|
Идентификаторы
категорий отелей, разделённые запятыми.
|-
|
towns
|
Идентификаторы
курортов, разделённые запятыми.
|}

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

<source lang="xml">

{
"GetHotelsResult":{
"Data":[
{
"Id":2153,
"Name":"Amwaj Oyoun Hotel & Resort",
"CommonRate":6.21481466,
"IsInBonusProgram":false,
"PhotosCount":12,
"Rate":3.92,
"StarId":404,
"StarName":"5*",
"TownId":1642
},
...
],
"Count":94
}
}

</source>

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

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Data
|
arr[]
|
Массив
описаний отелей.
|-
|
Count
|
int
|
Количество
записей об отелях.
|}

Каждый объект массива '''Data''' содержит данные об отеле:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
int
|
Идентификатор отеля.
|-
|
Name
|
str
|
Название отеля.
|-
|
CommonRate
|
float
|
Рейтинг
отеля. На момент написания настоящего руководства параметр не используется, и
данные не обновляются.
|-
|
IsInBonusProgram
|
bool
|
Флаг
участия в бонусной программе Слетать.ру. Так как программа закрыта, значение
не используется.
|-
|
PhotosCount
|
int
|
Общее
количество фотографий отеля.
|-
|
Rate
|
float
|
Рейтинг
отеля, определяемый голосованием пользователей на сайте sletat.ru, а
также рейтингами компаний ТурПравда, Booking.com, TripAdvisor и HotelsCombined.
|-
|
StarId
|
int
|
Идентификатор
категории отеля.
|-
|
StarName
|
str
|
Категория
отеля
|-
|
TownId
|
int
|
Идентификатор
курорта.
|}

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

Пример запроса:
https://module.sletat.ru/Main.svc/GetMeals?

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

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

<source lang="xml">

{
"GetMealsResult":{
"Data":[
{
"Id":115,
"Name":"AI"
},
...
],
}
}

</source>

В ответ возвращается массив '''GetMealsResult.Data''', каждый объект которого содержит описание типа питания:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
int
|
Идентификатор типа питания.
|-
|
Name
|
str
|
Тип питания.
|}

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

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

https://module.sletat.ru/Main.svc/GetTourOperators?townFromId=1264&countryId=40

Запрашивается справочник туроператоров, предлагающих туры из Санкт-Петербурга в Египет.

Параметры запроса:

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

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

<source lang="xml">

{
"GetTourOperatorsResult":{
"Data":[
{
"Id":19,
"Name":"Anex",
"Enabled":true
},
...
],
}
}

</source>

В ответ возвращается массив '''GetTourOperatorsResult.Data''', каждый объект которого содержит описание туроператора:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
int
|
Идентификатор туроператора.
|-
|
Name
|
str
|
Наименование туроператора.
|-
|
Enabled
|
bool
|
Флаг
наличия туров по указанной паре '''townFromId-countryId'''. Если туроператор работает,
поле принимает значение '''true'''; в противном случае – '''false'''.
|}

=== Методы поиска горящих туров ===

==== GetTemplates ====
Метод '''GetTemplates''' возвращает список шаблонов, по которым Слетать.ру отбирает горящие туры.

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

https://module.sletat.ru/Main.svc/GetTemplates?templatesList=all&login=XXX&password=YYY

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
templatesList
|
Возможные значения:
* '''shared''' - возвращается список всех стандартных шаблонов горящих туров;
* '''all''' - возвращается список всех стандартных шаблонов и ваш пользовательский шаблон;
* если параметр не передан, возвращаются все шаблоны, используемые для шлюзов и модулей горящих туров, вне зависимости от того, активна ли лицензия.
|-
|
type
|
Если параметр имеет значение «1», возвращаются шаблоны сезонных туров; если «0» - горящих
туров. Кроме того, если параметр '''templateList''' имеет значение all, возвращается пользовательский шаблон. Если параметр не передан,
возвращается список шаблонов горящих туров.
|}

Данные возвращаемые при всех возможных сочетаниях значений '''templaеsList''' и '''type''', приведены в таблице:

{| class="wikitable"
|-
|
Значения
параметров
|
Шаблоны
|-
|
Без параметров
|
Шаблон, выбранный
в настройках Личного кабинета, и пользовательский шаблон.
|-
|
templatesList=shared;
type=1
|
Все стандартные
шаблоны сезонных туров.
|-
|
templatesList=shared; type=0
|
Все стандартные
шаблоны горящих туров.
|-
|
templatesList=all; type=1
|
Все стандартные
шаблоны сезонных туров и пользовательский шаблон.
|-
|
templatesList=all; type=0
|
Все стандартные
шаблоны горящих туров и пользовательский шаблон.
|}

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

<source lang="xml">

{
"GetTemplatesResult":{
"Data":{
"templates":[
{
"departureCity": "Санкт-Петербург",
"id": 1,
"name": "Горящие туры (СПб)"
},
...
]
},
}
}

</source>

Каждый объект массива '''GetTemplatesResult.Data.templates''' содержит описание шаблона:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
departureCity
|
str
|
Город вылета.
|-
|
id
|
int
|
Идентификатор
шаблона.
|-
|
name
|
str
|
Название шаблона.
|}

==== GetShowcaseReview ====
Метод GetShowcaseRewiew возвращает данные о направлениях, доступных для города вылета: идентификатор и название страны, диапазон доступных параметров поиска, а также описание самых дешёвых туров (по одному на направление), найденных по шаблону.

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

Пример вызова:

https://module.sletat.ru/Main.svc/GetShowcaseReview?templateName=%D0%93%D0%BE%D1%80%D1%8F%D1%89%D0%B8%D0%B5+%D1%82%D1%83%D1%80%D1%8B+(%D0%A1%D0%9F%D0%B1)&login=XXX&password=YYY

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
templateName
|
Название шаблона, полученное в поле name структуры '''GetTemplatesResult.Data.templates[]'''. Если параметр не передан, метод возвращает данные обо всех направлениях, доступных
для шаблона, используемого по умолчанию.
|-
| includeResorts
| Включить в ответ идентификаторы и названия отелей, найденных по данному шаблону. Возможные значения: 1 – включать данные; 0 – не включать.
|-
| countryToursCount
| Максимальное количество туров в одну страну. По умолчанию 1.
|-
| currencyAlias
| Название валюты (USD, EUR, RUB, BYR, UAH и UZS)
|}

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

<source lang="xml">

{
"GetShowcaseReviewResult":{
"Data":[
{
"AvailableMealIds": [112, 113, 114, 115, 117],
"AvailableMealNames": ["FB", "HB", "BB", "AI", "RO"],
"AvailableNights": [3, 6, 7, 10, 14],
"AvailableResortsIds": null,
"AvailableResortsNames": null,
"AvailableStarIds": [401, 402, 403, 404, 405],
"AvailableStarNames": ["2*", "3*", "4*", "5*", "Apts"],
"CapitalWeather": null,
"CountryId": 3,
"CountryImageUrl": "http:\/\/static.sletat.ru\/images\/countries\/3.jpg",
"CountryName": "Австрия",
"HotelId": "1775",
"HotelName": "Hotel am Konzerthaus - MGallery Collection",
"HotelUrl": "http:\/\/hotels.sletat.ru\/?id=1775",
"HtPlaceName": "1\/2 DBL",
"MealName": "BB",
"MinPrice": "20987 RUB",
"MinPriceDate": "09\/08\/2014",
"Nights": 3,
"OfferId": 865285531,
"ResortName": "Вена",
"SourceId": 352723657,
"StarName": "4*",
"Template":{
"adults": 2,
"checkInFrom": "08\/08\/2014",
"checkInTo": "14\/08\/2014",
"hasTickets": true,
"hotelIsNotInStop": true,
"kids": 0,
"lastPricePercent": 0,
"meals": [],
"nightsMax": 14,
"nightsMin": 3,
"priceMax": null,
"priceMin": null,
"stars": [402, 403, 404, 410, 411],
"ticketsIncluded": true,
"townFromId": 1264,
"useRandomPricePercent": false
}
},
...
],
}
}

</source>

В ответ возвращается массив '''GetShowcaseReviewResult.Data''', каждый объект которого содержит описания направления, по которому найдены туры, соответствующие шаблону поиска, с перечислением доступных параметров поиска и описанием самого дешёвого тура, найденного по направлению:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
AvailableMealIds
|
arr[]
|
Список
идентификаторов типов питания, найденных по данному шаблону.
|-
|
AvailableMealNames
|
arr[]
|
Список типов
питания, найденных по данному шаблону.
|-
|
AvailableNights
|
arr[]
|
Список
продолжительностей туров (в ночах), найденных по данному шаблону.
|-
|
AvailableResortsIds
|
arr[]
|
Идентификаторы
отелей, найденных по данному шаблону. Передаётся при includeResorts=1.
|-
|
AvailableResortsNames
|
arr[]
|
Названия отелей,
найденных по данному шаблону. Передаётся при includeResorts=1.
|-
|
AvailableStarsIds
|
arr[]
|
Идентификаторы
категорий отелей, найденных по данному шаблону.
|-
|
AvailableStarsNames
|
arr[]
|
Список категорий
отелей, найденных по данному шаблону.
|-
|
CapitalWeather
|
|
Данные о погоде в
столице.
|-
|
CountryId
|
int
|
Идентификатор
страны.
|-
|
CountryImageUrl
|
str
|
Ссылка на изображение
флага страны.
|-
|
CountryName
|
str
|
Название страны.
|-
|
HotelId
|
str
|
Идентификатор
отеля в самом дешёвом найденном турпакете.
|-
|
HotelName
|
str
|
Название отеля в самом
дешёвом найденном турпакете.
|-
|
HotelUrl
|
str
|
Ссылка на описание
отеля в самом дешёвом найденном турпакете. Принимает значение “null”, если данные не
слинкованы.
|-
|
HtPlaceName
|
str
|
Тип размещения для
предложения с минимальной ценой.
|-
|
MealName
|
str
|
Тип питания для
предложения с минимальной ценой.
|-
|
MinPrice
|
str
|
Минимальная цена тура,
найденная по шаблону.
|-
|
MinPriceData
|
str
|
Дата заезда для
предложения с минимальной ценой.
|-
|
Nights
|
int
|
Продолжительность
тура с минимальной ценой.
|-
|
OfferId
|
int
|
Идентификатор
ценового предложения.
|-
|
ResortName
|
str
|
Курорт для
предложения с минимальной ценой.
|-
|
SourceId
|
int
|
Идентификатор
туроператора. При отсутствии расширенной лицензии на шлюз значение поля
шифруется. За подробностями обращайтесь по электронной почте info@sletat.ru.
|-
|
StarName
|
str
|
Категория отеля
для предложения с минимальной ценой.
|-
|
Template
|
obj
|
Описание шаблона,
по которому отбирались туры.
|}

Поля объекта Template:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
adults
|
int
|
Количество
туристов (взрослых).
|-
|
checkInFrom
|
str
|
Начальная дата
интервала дат вылета в формате DD/MM/YYYY.
|-
|
checkInTo
|
str
|
Конечная дата интервала
дат вылета в формате DD/MM/YYYY.
|-
|
hasTickets
|
bool
|
Наличие билетов.
Принимает значение “'''true'''”, если билеты есть. В противном случае – “'''false'''”.
|-
|
hotelIsNotInStop
|
bool
|
Принимает значение
“'''true'''”, если
места есть; в противном случае – “'''false'''”.
|-
|
kids
|
int
|
Количество
туристов (детей). Всегда возвращается «0».
|-
|
lastPricePercent
|
Int
|
Размер псевдоскидки.
|-
|
meals
|
arr[]
|
Идентификаторы
типов питания.
|-
|
nightsMax
|
int
|
Максимальная
продолжительность тура (ночей).
|-
|
nightsMin
|
int
|
Минимальная
продолжительность тура (ночей).
|-
|
priceMax
|
int
|
Максимальная цена
тура.
|-
|
priceMin
|
int
|
Минимальная цена
тура.
|-
|
stars
|
arr[]
|
Идентификаторы
категорий отеля.
|-
|
ticketsIncluded
|
bool
|
Состав турпакета. Принимает
значение “'''true'''”, если перелёт включён в стоимость. В противном случае – “'''false'''”.
|-
|
townFromId
|
int
|
Идентификатор
города вылета.
|-
|
useRandomPricePercent
|
bool
|
Случайный размер
псевдоскидки.
|}

==== GetTours ====
Метод GetTours используется для создания поискового запроса, а также – если в запросе передаётся параметр requestId и параметр updateResult=1 – для получения результатов поиска по запросу.

Обратите внимание: указание параметров requestId=***&updateResult=1 обязательно для получения результатов поиска. В некоторых случаях повторное обращение к методу GetTours без указания этих параметров также вернет результаты, но их корректность не гарантируется.

Пример вызова:

[https://module.sletat.ru/Main.svc/GetTours?groupBy=hotel&countryId=40&cityFromId=832&currencyAlias=RUB&pageSize=4&pageNumber=1&s_nightsMin=3&s_nightsMax=14&s_showcase=true&includeOilTaxesAndVisa=1&login=XXX&password=YYY https://module.sletat.ru/Main.svc/GetTours?groupBy=hotel&countryId=40&cityFromId=832&currencyAlias=RUB&pageSize=4&pageNumber=1&s_nightsMin=3 &s_nightsMax=14&s_showcase=true&includeOilTaxesAndVisa=1&login=XXX&password=YYY]

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Тип
|
Описание
|-
|
cityFromId *
|
int
|
Идентификатор
города вылета.
|-
|
countryId *
|
int
|
Идентификатор
страны.
|-
|
s_showcase *
|
string(int)
|
Всегда
передавать true.
|-
|
cities
|
string(int[])
|
Список
курортов, разделение запятой.
|-
|
currencyAlias
|
string
|
Валюта. Возможные значения: USD, EUR, RUB, BYR, UAH и UZS
|-
|
fake
|
string(bool)
|
Симулировать выдачу.
|-
|hotels
|
string(int[])
|Для Горящих туров параметр игнорируется.
|-
|
groupBy
|
string
|
Сортировка выдачи. Возможные значения:
* '''hotel''' – группировка по цене, начиная с минимальной; при одинаковой цене группировка по названию отеля; только слинкованные отели;
* '''sortedHotels''' - группировка по названию отеля; туры в каждый отель отсортированы по цене, начиная с минимальной; только слинкованные отели;
* '''so_price''' – сортировка по цене, начиная с минимальной.
Если параметр не передан, используется сортировка по цене, а максимальное количество туров в выдаче ограничивается тысячей (см. также параметр '''PageSize''').
|-
|
hiddenOperators
|
string[]
|
Список наименований операторов, которых следует исключить из выдачи, разделение
запятой. Для корректной работы используйте URL-кодирование.
|-
|
includeDescriptions
|
int
|
Описания типа питания и отеля. Возможные значения: «1» – запрашивать описания; «0» – не запрашивать.
|-
|
includeOilTaxesAndVisa
|
int
|
Описания топливных и визовых сборов. Возможные значения:
* «1» — запрашивать описания;
* «0» — не запрашивать.
|-
|
meals
|
string(int[])
|
Список идентификаторов типов питания, разделенных запятой.
|-
|
pageNumber
|
int
|
Номер
страницы.
|-
|
pageSize
|
int
|
Количество туров в выдаче. Если параметр не передан, максимальное количество ограничено двадцатью.
|-
|
s_nightsMax
|
int
|
Максимальная продолжительность тура, ночей.
|-
|
s_nightsMin
|
int
|
Минимальная продолжительность тура, ночей.
|-
|
stars
|
string(int[])
|
Список идентификаторов категорий отеля, разделенных запятой.
|-
| visibleOperators
|
string[]
| Список идентификаторов операторов, которых следует включить в выдачу (остальные будут исключены), разделение запятой.
|-
| economOnly
|
int
| Поиск только туров с перелётом в эконом классе. Возможные значения: 0 или 1.
|-
| hideShopTours
|
int
| Скрыть шоп туры. Возможные значения: 0 или 1.
|-
| siteSessionId
|
string
| Идентификатор сессии на сайте Слетать.ру для отображения статистики.
|-
| useAccount
|
string(int)
| Использовать параметры для стопов из Личного кабинета Слетать.ру вместо пришедших из формы. Возможные значения: 1 — использовать параметры ЛК; 0 — параметры формы.
|-
| TemplateName
|
string
| Название шаблона горящих туров.
|}

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

<source lang="xml">

{
"GetToursResult":{
"Data":{
"aaData":[
[
"727267006",
359789733,
"http:\/\/hotels.sletat.ru\/?id=12755",
12755,
"",
1592,
"MOSCOW HURGHADA HURG-8967",
"El Tabia",
"2*",
"Standard",
"HB",
"1\/2 DBL",
"13.08.2014",
"19.08.2014",
6,
"11754 RUB",
2,
0,
"",
"Хургада",
[""],
"2",
"1",
"1",
"1",
"0",
"0",
"Ср.",
"19.08",
"http:\/\/hotels.sletat.ru\/i\/p\/12755_0.jpg",
40,
"Египет",
832,
"Москва",
"",
"4.98",
"",
"",
"",
13103,
false,
113,
11754,
"RUB",
5283,
401,
7,
"",
"El Tabia",
"2*",
"Хургада",
"HB",
"DBL",
"Standard",
"",
"",
"",
"",
"",
0,
null,
null,
null,
null,
null,
null,
401,
0,
"FkX90fD3oBh90q8uytsEzA==",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"8gJsOSQg\/R7Z+oA5Bcp5gA==",
0,
null,
-1,
False
],
...
],
"cacheIsEmpty": false,
"countryCurrencyId": "2",
"hotelsCount": 386,
"iTotalDisplayRecords": 386,
"iTotalRecords": 386,
"isInTheBasket": 0,
"loadState": [],
"oilTaxes":[
[
"361683864",
"03.04.2014",
"31.12.2014",
40,
"USD",
null,
null,
null,
null,
null,
null,
832
],
...
],
"requestId": 739707152,
"visa": null,
"visaRange":[
"USD",[
[
361683864,
0,
25
],
...
]
},
}
}

</source>

Поля объекта GetToursResult.Data:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
aaData
|
arr[]
|
Массив записей о
найденных турах.
|-
|
cacheIsEmpty
|
bool
|
Состояние кеша.
Принимает значение '''true''', если кеш пуст. Поскольку сервис поиска горящих туров обращается
исключительно к кешу, значение этого поля всегда будет равно '''false'''.
|-
|
countryCurrencyId
|
str
|
Идентификатор
валюты, используемой в стране.
|-
|
hotelsCount
|
int
|
Количество отелей
в выдаче.
|-
|
iTotalDisplayRecords
|
Int
|
Количество туров в
выдаче. Если >2500 выведет 2500.
|-
|
iTotalRecords
|
int
|
Количество туров в
выдаче. Поле идентично '''iTotalDisplayRecords'''.
|-
|
isInTheBasket
|
int
|
Технический
параметр. Используется только на сайте sletat.ru
|-
|
loadState
|
arr[]
|
Состояние
получения данных от туроператора. В поиске горящих туров не используются,
поскольку все данные получаются из кеша системы поиска Слетать.ру.
|-
|
oilTaxes
|
arr[]
|
Массив записей о топливных сборах.
Возвращается, если параметр '''includeOilTaxesAndVisa''' был передан со
значением 1.
|-
|
requestId
|
int
|
Идентификатор
поискового запроса.
|-
|
visa
|
arr[]
|
На момент
написания настоящего руководства поле не используется.
|-
|
visaRange
|
arr[]
|
Массив записей о
визовых сборах. Возвращается, если параметр includeOilTaxesAndVisa был передан со значением 1.
|}

Каждый элемент массива '''GetToursResult.Data.aaData''' содержит описание найденного тура:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
aaData[0]
|
int
|
Идентификатор
ценового предложения (тура).
|-
|
aaData[1]
|
int
|
Идентификатор туроператора. При отсутствии расширенной лицензии на шлюз значение поля шифруется. За подробностями обращайтесь по электронной почте info@sletat.ru
|-
|
aaData[2]
|
str
|
Ссылка на описание
отеля.
|-
|
aaData[3]
|
int
|
Идентификатор
отеля.
|-
|
aaData[4]
|
str
|
Ссылка на описание
курорта. Поле может быть пустым, если данные не слинкованы.
|-
|
aaData[5]
|
int
|
Идентификатор
курорта.
|-
|
aaData[6]
|
str
|
Название тура.
|-
|
aaData[7]
|
str
|
Название отеля.
|-
|
aaData[8]
|
str
|
Категория отеля.
|-
|
aaData[9]
|
str
|
Тип номера.
|-
|
aaData[10]
|
str
|
Тип питания.
|-
|
aaData[11]
|
str
|
Тип размещения.
|-
|
aaData[12]
|
str
|
Дата вылета (туда)
в формате DD.MM.YYYY.
|-
|
aaData[13]
|
str
|
Дата вылета
(обратно) в формате DD.MM.YYYY.
|-
|
aaData[14]
|
int
|
Продолжительность
тура, ночей.
|-
|
aaData[15]
|
str
|
Цена тура с указанием
валюты.
|-
|
aaData[16]
|
int
|
Количество туристов
(взрослых).
|-
|
aaData[17]
|
int
|
Количество туристов
(детей).
|-
|
aaData[18]
|
str
|
Наименование
туроператора. Доступ к данным может быть ограничен лицензией. По всем
вопросам обращайтесь по электронной почте info@sletat.ru.
|-
|
aaData[19]
|
str
|
Курорт.
|-
|
aaData[20]
|
arr[]
|
Ссылка на поиск
тура в системе туроператора. Доступ к данным может быть ограничен лицензией.
По всем вопросам обращайтесь по электронной почте info@sletat.ru.
|-
|
aaData[21]
|
str
|
Количество мест в отеле. Возможные значения: 0
– есть места; 1 – нет мест; 2 – по запросу.
|-
|
aaData[22]
|
str
|
Билеты включены в цену.
|-
|
aaData[23]
|
int
|
Наличие билетов
эконом-класса (туда). Возможные значения: 0 — нет, 1 — есть, 2 — по запросу.
|-
|
aaData[24]
|
int
|
Наличие билетов
эконом-класса (обратно). Возможные значения: 0 — нет, 1 — есть, 2 — по запросу.
|-
|
aaData[25]
|
int
|
Наличие билетов
бизнес-класса (туда). Возможные значения: 0 — нет, 1 — есть, 2 — по запросу.
|-
|
aaData[26]
|
int
|
Наличие билетов
бизнес-класса (обратно). Возможные значения: 0 — нет, 1 — есть, 2 — по запросу.
|-
|
aaData[27]
|
str
|
День начала тура. Используется только в текстовом представлении. Возможные значения: Пн. Вт. Ср. Чт. Пн. Сб. Вс.
|-
|
aaData[28]
|
str
|
Дата окончания тура. Используется только в текстовом представлении.
|-
|
aaData[29]
|
str
|
Ссылка на
изображение отеля. Поле может быть пустым, если данные не слинкованы.
|-
|
aaData[30]
|
int
|
Идентификатор
направления.
|-
|
aaData[31]
|
str
|
Направление.
|-
|
aaData[32]
|
int
|
Идентификатор города
вылета.
|-
|
aaData[33]
|
str
|
Город вылета.
|-
|
aaData[34]
|
str
|
Ссылка на логотип
туроператора. Предоставляется при наличии расширенной лицензии на шлюз. За
подробностями обращайтесь по электронной почте info@sletat.ru.
|-
|
aaData[35]
|
float
|
Рейтинг отеля по
десятибалльной шкале.
|-
|
aaData[36]
|
int
|
Описание типа
питания. Возвращается, если параметр '''includeDescriptions''' был передан со значением 1.
|-
|
aaData[37]
|
int
|
Описание типа
размещения. Передаётся, если параметр '''includeDescriptions''' был передан со значением 1.
|-
|
aaData[38]
|
int
|
Описание отеля.
Передаётся, если значение параметр '''includeDescriptions''' был передан со значением 1.
|-
|
aaData[39]
|
int
|
Системный идентификатор типа размещения (поле может быть пустым, если данные не слинкованы).
|-
|
aaData[40]
|
bool
|
Флаг демо-режима. Если шлюз работает в демо-режиме, поле принимает значение true; в противном случае – false.
|-
|
aaData[41]
|
int
|
Системный идентификатор типа питания (поле может быть пустым, если данные
не слинкованы).
|-
|
aaData[42]
|
int
|
Цена тура в виде числа без указания валюты.
|-
|
aaData[43]
|
int
|
Валюта поля '''aaData[42]'''.
|-
|
aaData[44]
|
int
|
Системный идентификатор типа номера. Поле может быть пустым, если данные не слинкованы.
|-
|
aaData[45]
|
int
|
Системный идентификатор категории отеля. Поле может быть пустым, если
данные не слинкованы.
|-
|
aaData[46]
|
int
|
Количество фотографий отеля. Поле может быть пустым, если данные не слинкованы.
|-
|
aaData[47]
|
str
|
Ссылка на личный кабинет туроператора. Предоставляется
при наличии расширенной лицензии на шлюз. За подробностями обращайтесь по электронной
почте info@sletat.ru.
|-
|
aaData[48]
|
str
|
Название отеля в системе оператора.
|-
|
aaData[49]
|
str
|
Категория отеля в системе оператора.
|-
|
aaData[50]
|
str
|
Название курорта в системе оператора.
|-
|
aaData[51]
|
str
|
Тип питания в системе оператора.
|-
|
aaData[52]
|
str
|
Тип размещения в системе оператора.
|-
|
aaData[53]
|
str
|
Тип номера в системе оператора.
|-
|
aaData[54]
|
str
|
|-
|
aaData[55]
|
int
|
Количество билетов эконом-класса (туда). Возможные значения:
«-1» — нет данных;

целое число, меньшее или равное нулю — точное количество билетов;

пустое значение — билетов много.
|-
|
aaData[56]
|
int
|
Количество билетов эконом-класса (обратно). Возможные значения:

«-1» — нет данных;

целое число, меньшее или равное нулю — точное количество билетов;

пустое значение — билетов много.
|-
|
aaData[57]
|
int
|
Количество билетов бизнес-класса (туда). Возможные значения:

«-1» — нет данных;

целое число, меньшее или равное нулю — точное количество билетов;

пустое значение — билетов много.
|-
|
aaData[58]
|
int
|
Количество билетов бизнес-класса (обратно). Возможные значения:

«-1» — нет данных;

целое число, меньшее или равное нулю — точное количество билетов;

пустое значение — билетов много.
|-
|
aaData[59]
|
int
|
Флаг тура с обязательствами (тур, спонсируемый коммерческой
компанией, которая в обмен обязует туриста приобрести её продукт). Возможные
значения: 0 – обычный тур; 1 – тур с обязательствами.

|-
|
aaData[60]
|
|
|-
|
aaData[61]
|
|
|-
|
aaData[62]
|
|
|-
|
aaData[63]
|
|
|-
|
aaData[64]
|
|
|-
|
aaData[65]
|
|
|-
|
aaData[66]
|
int
|
Идентификатор
категории отеля.
|-
|
aaData[67]
|
|
|-
|
aaData[68]
|
|
|-
|
aaData[69]
|
|
|-
|
aaData[70]
|
|
|-
|
aaData[71]
|
|
|-
|
aaData[72]
|
|
|-
|
aaData[73]
|
|
|-
|
aaData[74]
|
|
|-
|
aaData[75]
|
|
|-
|
aaData[76]
|
|
|-
|
aaData[77]
|
|
|-
|
aaData[78]
|
|
|-
|
aaData[79]
|
|
|-
|
aaData[80]
|
|
|-
|
aaData[81]
|
|
|-
|
aaData[82]
|
|
|-
|
aaData[83]
|
|
|-
|
aaData[84]
|
|
|-
|
aaData[85]
|
|
|}

Каждый элемент массива '''oilTaxes''' (передаётся при '''includeOilTaxesAndVisa=1''') содержит описание топливного сбора:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
oilTaxes[0]
|
int
|
Идентификатор туроператора. При отсутствии расширенной
лицензии на шлюз значение поля шифруется. За подробностями обращайтесь по
электронной почте info@sletat.ru.
|-
|
oilTaxes[1]
|
str
|
Дата начала действия топливного сбора.
|-
|
oilTaxes[2]
|
str
|
Дата окончания действия топливного сбора.
|-
|
oilTaxes[3]
|
int
|
Размер топливного сбора.
|-
|
oilTaxes[4]
|
str
|
Валюта поля '''oilTaxes[3]'''.
|-
|
oilTaxes[5]
|
str
|
Наименование авиакомпании.
|-
|
oilTaxes[6]
|
str
|
Наименование принимающей стороны.
|-
|
oilTaxes[7]
|
str
|
Название курорта.
|-
|
oilTaxes[8]
|
str
|
Название аэропорта прибытия.
|-
|
oilTaxes[9]
|
int?
|
Идентификатор курорта.
|-
|
oilTaxes[10]
|
int?
|
Номер рейса.
|-
|
oilTaxes[11]
|
int
|
Идентификатор
города вылета.
|}

Каждый массив '''visaRange''' (передаётся при '''includeOilTaxesAndVisa=1''') содержит описание визового сбора:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
visaRange[0]
|
str
|
Валюта полей '''visaRange[1][1]''' и '''visaRange[1][2]'''.
|-
|
visaRange[1][0]
|
int
|
Идентификатор туроператора.
При отсутствии расширенной лицензии на шлюз значение поля шифруется. За
подробностями обращайтесь по электронной
почте info@sletat.ru.
|-
|
visaRange[1][1]
|
int
|
Минимальный размер
визового сбора.
|-
|
visaRange[1][2]
|
int
|
Максимальный
размер визового сбора.
|}

=== Методы работы с заказом ===

==== ActualizePrice ====
Метод '''ActualizePrice''' необходим для актуализации предложений туроператоров. Он позволяет проверить наличие билетов и мест в отеле, топливных и визовых сборов, а также других обязательных доплат.

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

https://module.sletat.ru/Main.svc/ActualizePrice?requestId=745227237&offerId=131755672&sourceId=163&showcase=1&login=XXX&password=YYY

Запрашиваются актуальные данные по туру №131755672 от туроператора №163, найденному по запросу №745227237.

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
sourceId *
|
Идентификатор
туроператора, полученный методом '''GetTours''' (значение поля '''aaData[1]'''). При отсутствии расширенной лицензии на шлюз возможна
передача шифрованного значения.
|-
|
offerId *
|
Идентификатор
ценового предложения, полученный методом '''GetTours''' (значение поля '''aaData[0]''').
|-
|
showcase *
|
Всегда передавать 1.
|-
|
requestId *
|
Идентификатор поискового запроса, полученный методом '''GetTours''' (значение поля '''requestId''').
|}

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

<source lang="xml">

{
"ActualizePriceResult":{
"Data":{
"actualizationSessionId": "PiwGlGdaIUC\/3Kje1v69WA==",
"data":[
"Египет",
"Москва",
"Хургада",
"Хургада - TARIFF-117174",
"20.08.2014",
"3",
"TRITON EMPIRE HOTEL",
"745227237",
"3*",
"Standard room",
"23.08.2014",
"HB",
"True",
"0",
"1",
"1",
"0",
"0",
"11649",
"11649",
"",
"RUR",
"1\/2 DBL",
"RUB",
"163",
"GoldTravel",
"40",
"Египет",
"832",
"Москва",
"1592",
"Хургада",
"42896",
"Three Corners Triton Empire Hotel",
"402",
"3*",
"5283",
"Standard",
"113",
"HB",
"13103",
"DBL",
"http:\/\/www.goldtravel.ru\/main\/search_tour.view",
"http:\/\/hotels.sletat.ru\/?id=42896",
"http:\/\/hotels.sletat.ru\/i\/p\/42896_0.jpg",
30,
"http:\/\/sletat.ru\/book\/GoldTravel\/MTYzfDEwIOxNTODfDcTyNINw%3d%3d",
"5",
"8.4",
"Завтрак, ужин (или иногда обед на выбор)",
"двухместный номер",
"Отель входит в систему TRITON HOTELS вместе с отелями TRITON EMPIRE BEACH RESORT 3* (1-линия) и TRITON EMPIRE INN 2* (2-линия). Гости всех трех отелей могут пользоваться всеми услугами каждого отеля кроме ресторанов во время ужина. Отдельный комплекс состоит из 6-этажных корпусов. Этот экономичный отель построен практически в центре Старой Хургады. Последний ремонт осуществлялся в 2005 году.",
"1032490153",
"2",
"0",
"VO8awcPXWXrGUsF8KgBdqQ==",
"40F144D46805DB45C83D64AD2EB1AF99"
],
"errorMessage": null,
"isCompleted": true,
"isDetailedExists": false,
"isError": false,
"isFound": true,
"nextPossibleCommands": null,
"oilTaxes":[
[
40,
"USD",
null,
"GoldTravel",
null,
"03.04.2014",
"31.12.2014",
null,
null,
null,
832
]
],
"randomNumber": 4319,
"resourceData": [],
"resources": [],
"visa": [25, "USD"],
"visaExtendedInfo":[
{
"AgeFrom": null,
"AgeTo": 12,
"CitizenshipName": "Россия",
"CurrencyName": "USD",
"HostName": "",
"IsExpress": false,
"IssueDaysFrom": null,
"IssueDaysTo": null,
"IssueOnArrival": true,
"IssueTownName": "По прибытии",
"PassportType": false,
"Price": 0,
"SourceId": null
},
...
]
},
}
}

</source>

Поля объекта '''ActualizePriceResult.Data''':

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
actualizationSessionId
|
str
|
Идентификатор сессии актуализации.
|-
|
data
|
arr[]
|
Массив данных о туре.
|-
|
errorMessage
|
str
|
Текст ошибки. Выводится, если поле '''isError''' принимает
значение '''true'''.
|-
|
isCompleted
|
bool
|
Если актуализация выполнена, поле принимает значение
'''true'''; в
противном случае – '''false'''.
|-
|
IsDetailedExists
|
bool
|
Если была проведена
детальная актуализация, поле принимает значение '''true'''; в противном случае
– '''false'''.
|-
|
isError
|
bool
|
Если в процессе обработки запроса произошла ошибка,
поле принимает значение '''true''', в противном случае – '''false'''.
|-
|
isFound
|
bool
|
Если тур был найден в системе оператора, поле принимает
значение '''true'''; в
противном случае – '''false'''.
|-
|
nextPossibleCommands
|
arr[]
|
На момент написания настоящего руководства поле
не используется. Всегда возвращается '''null'''.
|-
|
oilTaxes
|
arr[]
|
Массив записей о визовых сборах.
|-
|
randomNumber
|
int
|
Случайный номер тура в рамках запроса. Используется
методом '''ActualizePriceByCode'''.
|-
|
resourceData
|
|
На момент написания настоящего руководства поле
не используется. Всегда возвращается '''null'''.
|-
|
recources
|
|
На момент написания настоящего руководства поле
не используется. Всегда возвращается '''null'''.
|-
|
visa[0]
|
int
|
Размер визового сбора.
|-
|
visa[1]
|
str
|
Валюта поля '''visa[0]'''.
|-
|
visaExtendedInfo
|
arr[]
|
Массив записей о визовых сборах.
|}

Поля массива data:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
data[0]
|
str
|
Направление.
|-
|
data[1]
|
str
|
Город
вылета.
|-
|
data[2]
|
str
|
Курорт.
|-
|
data[3]
|
str
|
Название
программы.
|-
|
data[4]
|
str
|
Дата вылета
в формате DD.MM.YYYY.
|-
|
data[5]
|
int
|
Продолжительность
тура, ночей.
|-
|
data[6]
|
str
|
Название
отеля.
|-
|
data[7]
|
str
|
Идентификатор
поискового запроса.
|-
|
data[8]
|
str
|
Категория
отеля.
|-
|
data[9]
|
str
|
Тип
номера.
|-
|
data[10]
|
str
|
Дата
выезда в формате DD.MM.YYYY.
|-
|
data[11]
|
str
|
Тип
питания.
|-
|
data[12]
|
bool
|
Объём
турпакета. Если перелёт включён в стоимость тура, поле принимает значение '''true''', в противном случае – '''false'''.
|-
|
data[13]
|
int
|
Наличие
мест в отеле. Возможные значения: 0
– есть места; 1
– нет мест; 2 – по запросу.
|-
|
data[14]
|
int
|
Билеты
эконом-класса (туда). Возможные значения: 0
– нет билетов; 1
– есть билеты; 2
– по запросу.
|-
|
data[15]
|
int
|
Билеты
эконом-класса (обратно). Возможные значения: 0
– нет билетов; 1
– есть билеты; 2
– по запросу.
|-
|
data[16]
|
int
|
Билеты
бизнес-класса (туда). Возможные значения: 0
– нет билетов; 1
– есть билеты; 2
– по запросу.
|-
|
data[17]
|
int
|
Билеты
бизнес-класса (обратно). Возможные значения: 0
– нет билетов; 1
– есть билеты; 2
– по запросу.
|-
|
data[18]
|
int
|
Оригинальная
цена в пересчёте на человека.
|-
|
data[19]
|
int
|
Цена в запрошенной валюте в пересчёте на человека.
|-
|
data[20]
|
str
|
Дополнительное описание тура.
|-
|
data[21]
|
str
|
Валюта полей
'''data[18]''' и '''data[19]'''.
|-
|
data[22]
|
str
|
Тип
размещения.
|-
|
data[23]
|
str
|
Системное
наименование валюты.
|-
|
data[24]
|
str
|
Идентификатор
туроператора. Не поддерживается в шлюзе горящих туров.
|-
|
data[25]
|
str
|
Наименование
туроператора. Не поддерживается в шлюзе горящих туров.
|-
|
data[26]
|
str
|
Идентификатор
направления. Поле может быть пустым, если данные не слинкованы.
|-
|
data[27]
|
str
|
Направление.
Поле может быть пустым, если данные не слинкованы.
|-
|
data[28]
|
str
|
Идентификатор
города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|
data[29]
|
str
|
Город
вылета. Поле может быть пустым, если данные не слинкованы.
|-
|
data[30]
|
str
|
Идентификатор
курорта. Поле может быть пустым, если данные не слинкованы.
|-
|
data[31]
|
str
|
Курорт.
Поле может быть пустым, если данные не слинкованы.
|-
|
data[32]
|
str
|
Идентификатор
отеля. Поле может быть пустым, если данные не слинкованы.
|-
|
data[33]
|
str
|
Отель. Поле
может быть пустым, если данные не слинкованы.
|-
|
data[34]
|
str
|
Идентификатор
категории отеля. Поле может быть пустым, если данные не слинкованы.
|-
|
data[35]
|
str
|
Категория
отеля. Поле может быть пустым, если данные не слинкованы.
|-
|
data[36]
|
str
|
Идентификатор
типа номера. Поле может быть пустым, если данные не слинкованы.
|-
|
data[37]
|
str
|
Тип
номера. Поле может быть пустым, если данные не слинкованы.
|-
|
data[38]
|
str
|
Идентификатор
типа питания. Поле может быть пустым, если данные не слинкованы.
|-
|
data[39]
|
str
|
Тип питания.
Поле может быть пустым, если данные не слинкованы.
|-
|
data[40]
|
str
|
Идентификатор
типа размещения. Поле может быть пустым, если данные не слинкованы.
|-
|
data[41]
|
str
|
Тип
размещения. Поле может быть пустым, если данные не слинкованы.
|-
|
data[42]
|
str
|
Ссылка
на туроператора. При
отсутствии расширенной лицензии на шлюз поле может быть пустым. За
подробностями обращайтесь по электронной почте info@sletat.ru.
|-
|
data[43]
|
str
|
Ссылка
на описание отеля в системе Слетать.ру.
|-
|
data[44]
|
str
|
Ссылка
на первую фотографию отеля.
|-
|
data[45]
|
int
|
Количество
доступных фотографий отеля.
|-
|
data[46]
|
str
|
Ссылка на систему бронирования туроператора. При отсутствии расширенной лицензии на шлюз поле
может быть пустым. За подробностями обращайтесь по электронной почте info@sletat.ru.
|-
|
data[47]
|
str
|
|-
|
data[48]
|
str
|
Рейтинг отеля по десятибалльной шкале.
|-
|
data[49]
|
str
|
Описание типа питания.
|-
|
data[50]
|
str
|
Описание типа размещения.
|-
|
data[51]
|
str
|
Описание отеля.
|-
|
data[52]
|
str
|
Идентификатор ценового предложения (тура).
|-
|
data[53]
|
str
|
Количество туристов (взрослых). Всегда передаётся
«2».
|-
|
data[54]
|
str
|
Количество туристов (детей). Всегда передаётся
«0».
|-
|
data[55]
|
str
|
Техническое поле. Используется только сайтом sletat.ru.
|-
|
data[56]
|
str
|
Техническое поле. Используется только сайтом sletat.ru.
|}

Каждый элемент массива '''oilTaxes''' содержит данные о топливном сборе:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
oilTaxes[0]
|
int
|
Размер топливного сбора.
|-
|
oilTaxes[1]
|
str
|
Валюта поля '''oilTaxes[0]'''.
|-
|
oilTaxes[2]
|
str
|
Наименование авиакомпании. Поле может быть
пустым, если сбор не зависит от авиакомпании.
|-
|
oilTaxes[3]
|
str
|
Наименование туроператора. При отсутствии расширенной лицензии на шлюз поле
может быть пустым. За подробностями обращайтесь по электронной почте info@sletat.ru.
|-
|
oilTaxes[4]
|
str
|
Курорт. Поле может быть пустым, если сбор не
зависит от курорта.
|-
|
oilTaxes[5]
|
str
|
Дата начала действия.
|-
|
oilTaxes[6]
|
str
|
Дата окончания действия.
|-
|
oilTaxes[7]
|
str
|
Наименование принимающей стороны. Поле может быть
пустым, если сбор не зависит от принимающей стороны.
|-
|
oilTaxes[8]
|
str
|
Аэропорт прибытия Поле может быть пустым, если
сбор не зависит от аэропорта прибытия.
|-
|
oilTaxes[9]
|
int?
|
Номер рейса. Поле может быть пустым, если сбор не
зависит от номера рейса.
|-
|
oilTaxes[10]
|
int
|
Идентификатор
города вылета.
|}

Каждый объект массива '''visaExtendedInfo''' содержит данные о визовом сборе:

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
AgeFrom
|
int
|
Нижняя возрастная граница
для выдачи визы.
|-
|
AgeTo
|
int
|
Верхняя возрастная граница
для выдачи визы.
|-
|
CitizenshipName
|
str
|
Гражданство получателя визы.
|-
|
CurrencyName
|
str
|
Валюта поля
'''Price'''.
|-
|
HostName
|
str
|
Наименование
принимающей стороны. Если поле заполнено, визовый сбор действителен только
для туров с указанной принимающей стороной.
|-
|
IsExpress
|
bool
|
Если
сбор взимается за экспресс-оформление, поле принимает значение '''true'''; в противном случае – '''false'''. Поле принимает значение '''null''', если
размер сбора не зависит от срочности оформления.
|-
|
IssueDaysFrom
|
int
|
Минимальный
срок оформления.
|-
|
IssueDaysTo
|
int
|
Максимальный
срок оформления.
|-
|
IssueOnArrival
|
bool
|
Если
виза выдаётся по прибытии, поле принимает значение '''true'''; в
противном случае – '''false'''.
|-
|
IssueTownName
|
str
|
Город
выдачи визы (или «По прибытии», если поле '''IssueOnArrival''' имеет значение '''true''').
|-
|
PassportType
|
bool
|
Поле
принимает значение '''true''', если
турист имеет свой паспорт, и '''false''', если данные о нём вписаны в паспорт другого
туриста.
|-
|
Price
|
int
|
Размер
сбора.
|-
|
SourceId
|
|
Идентификатор
туроператора.
|}

==== ActualizePriceByCode ====
Метод '''ActualizePriceByCode''' необходим для актуализации предложений туроператоров. Ответ полностью идентичен методу '''[[Шлюз поиска горящих туров (json)#ActualizePrice|ActualizePrice]]''', но в запросе используется случайный номер, который присваивается всем турам, найденным в Системе Слетать.ру, при первой актуализации.

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

https://module.sletat.ru/Main.svc/ActualizePriceByCode?code=7406&showcase=true&login=XXX&password=YYY

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
code *
|
Случайный номер тура, полученный при первой
актуализации (поле '''randomNumber''' структуры '''ActualizePriceResult.Data''').
|-
|
showcase *
|
Режим
горящих туров. Всегда передавать 1.
|}

{| class="standard"
| style="background-color:silver" |Внимание! Случайный номер хранится в Системе Слетать.ру в течение суток.
|}

Пример и описание ответа – см. метод '''ActualizePrice'''.

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

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

[https://module.sletat.ru/Main.svc/SaveTourOrder?searchRequestId=575366173&offerId=12242442&sourceId=1922198339&user=%D0%98%D0%B2%D0%B0%D0%BD+%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%87+%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9&email=test%40mail.ru&phone=%2B71111111111&login=XXX&password=YYY https://module.sletat.ru/Main.svc/SaveTourOrder?searchRequestId=575366173&offerId=12242442&sourceId=1922198339& user=%D0%98%D0%B2%D0%B0%D0%BD+%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%87+%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9&email=test%40mail.ru&phone=%2B71111111111&login=XXX&password=YYY]

Передаются данные о заказе тура №12242442 от туроператора №1922198339, найденного по запросу №575366173: ФИО, телефон, e-mail.

Параметры запроса:

{| class="wikitable"
|-
|
Параметр
|
Описание
|-
|
searchRequestId *
|
Идентификатор поискового запроса, полученный методом '''[[Шлюз поиска горящих туров (json)#GetTours|GetTours]]''' (значение поля '''requestId''').
|-
|
sourceId *
|
Идентификатор туроператора, полученный методом '''[[Шлюз поиска горящих туров (json)#GetTours|GetTours]]''' (значение поля '''aaData[1]'''). При отсутствии расширенной лицензии на шлюз возможна передача шифрованного значения.
|-
|
offerId *
|
Идентификатор ценового предложения, полученный методом '''[[Шлюз поиска горящих туров (json)#GetTours|GetTours]]''' (значение поля '''aaData[0]''').
|-
|
user
|
Имя заказчика.
|-
|
email *
|
Электронная почта заказчика.
|-
|
phone *
|
Телефон заказчика.
|-
| info
| Комментарий заказчика.
|-
| countryName
| Наименование страны.
|-
| cityFromName
| Наименование города вылета.
|-
| currencyAlias
| Валюта (USD, EUR, RUB, UAH, BYR или UZS).
|-
| officeId
| Идентификатор офиса (при использовании «многоофисности»)
|-
| moduleTpl
| Идентификатор поискового модуля (для версии 3.0 генерируется отдельный идентификатор для каждого модуля).
|-
| orderReferrer
| Полный URL, с которого делался заказ.
|-
| sendMeCopy
| Флаг для отправки туристу уведомления о создании заказа. Возможные значения: true или false.
|}

{| class="standard"
| style="background-color:silver" |Внимание! При обращении к методу обязательно передавать один из параметров '''email''' или '''phone''' (т. е. передача одного параметра делает необязательной передачу другого).
|}

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

<source lang="xml">

{
"SaveTourOrderResult":{
"Data":0,
"ErrorMessage":null,
"ExecutionTimeMs":117,
"IsError":false
}
}

</source>

В ответ возвращается объект '''SaveTourOrderRequest''', с пустым свойством '''Data''' и полями, содержащими данные об ошибке (см. описание в разделе «'''[[Шлюз поиска горящих туров (json)#Методы |Методы]]'''»).

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

2026-03-30T14:20:41Z

Kdadmin: Добавление валюты UZS

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

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

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

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

== Подключение к сервису ==
Все методы веб-сервиса располагаются по адресу:

https://module.sletat.ru/Main.svc

Вызов любого метода должен иметь следующий синтаксис:

https://module.sletat.ru/Main.svc/{ИмяМетода}?{параметр1}={значение1}&{параметр2}={значение2}...

Пример вызова:

[http://module.sletat.ru/Main.svc/GetHotels?countryId=40 https://module.sletat.ru/Main.svc/GetHotels?countryId=40]

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

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

Передавать все параметры при вызове не обязательно. Обязательные параметры отмечены звёздочкой (*).

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

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

* '''GetTours''' – создание поискового запроса;
* '''GetLoadState''' – получение данных о статусе загрузки туров для каждого туроператора;
* '''GetTours''' (с указанием параметра requestId и параметра updateResult со значением "1") – возвращает результаты поиска;

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

В ответе первого обращения к '''GetTours''' приходит идентификатор созданного поискового запроса, который в дальнейшем используется для отслеживания состояния поискового запроса методом '''GetLoadState''' и получения результатов поиска повторным обращением к методу '''GetTours '''с указанием requestId и параметра updateResult=1.

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

=== Получение полного набора туров ===
# Создаётся поисковый запрос методом '''GetTours'''. Сохраняется идентификатор запроса, полученный в ответе.
# Создаётся цикл для получения статуса поискового запроса. В цикле вызывается метод '''GetLoadState''' с использованием идентификатора запроса. В итерации цикла обязательно должна быть пауза (рекомендованное минимальное значение – 1,5 секунды). В результате вызова GetLoadState проверяется, все ли туроператоры обработали запрос (т.е. для всех туроператоров поле IsProcessed принимает значение "true"). На ос-нове проверки принимается решение о продолжении цикла или (если все туропера-торы обработали запрос) о переходе к методу получения туров.
# Снова вызывается метод GetTours, но уже с использованием полученного ранее идентификатора и параметра updateResult=1. Метод вернет все найденные туры в рамках поискового запроса.

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

== Методы ==
В этом разделе описаны все методы поискового сервиса. В соответствии с логикой работы сервиса (см. соответствующий раздел) они разделены на три группы:

* Методы получения справочников. При помощи методов этой группы вы можете загрузить списки стран, курортов, городов вылета, отелей, туроператоров и т. д. Обращение к этим методам необходимо на этапе подготовки к формированию поискового запроса.
* Методы загрузки туров. Методы этой группы позволяют провести весь цикл работ с поисковым запросом – от формирования до получения поисковой выдачи.
* Методы работы с заказом. Эти методы позволяют актуализировать данные о туре, получив информацию о перелётах, размерах топливных сборов и других доплат, а также оформить заказ и передать его на сайт sletat.ru для последующего оповещения менеджеров или статистического анализа.

Запрос каждого метода может содержать технический параметр debug, запускающий режим отладки, если передано значение “1”. По умолчанию передаётся значение “0”. Для удобства чтения параметр исключён из примеров запросов.

Ответ каждого из методов содержит поле Data – массив данных, запрашиваемых методов, а также следующие технические поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Поле принимает значение “null”, если значение поля IsError = “false”.
|-
|ExecutionTimeMs
|Int
|Время обработки запроса в миллисекундах.
|-
|IsError
|Bool
|Сообщение об ошибке. Если при обработке запроса произошла ошибка, поле принимает значение “true”; в прот
|}

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

=== Методы получения справочников ===
Наиболее полный справочник доступен по ссылке:
https://module.sletat.ru/Dictionaries.xml

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

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

https://module.sletat.ru/Main.svc/GetDepartCities?

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

Пример ответа (для удобства чтения данные представлены только по трём городам):

<source lang="xml">
{
"GetDepartCitiesResult":
{
"Data":
[
{
"Id":832,
"Name":"Москва",
"Default":true,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
{
"Id":1264,
"Name":"Санкт-Петербург",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1327,
"Name":"Ялта",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
}
],
...
}
}
</source>

В ответ возвращается структура GetDepartCitiesResult.Data – массив данных о городах вылета.

Поля структуры GetDepartCitiesResult.Data:
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор города вылета.
|-
|Name
|Str
|Город вылета..
|-
|Default
|Bool
|
|-
|DescriptionUrl
|Str
|Ссылка на описание города.
|-
|IsPopular
|Bool
|Популярность города вылета. Если город вылета был признан популярным на основе статистики поисковых запросов, сделанных на сайте sletat.ru и сайтах партнёров, поле принимает значение “true”; в противном случае — “false”.
|-
|ParentId
|Int
|Идентификатор родительского города (см. поле ParentId в описании ответа метода GetCities). Поле может иметь значение “null”, если город вылета не имеет родительского города.
|}

==== GetAvailableFeatures — Список услуг отеля ====
Метод GetAvailableFeatures возвращает список доступных услуг отелей в выбранных курортах.

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

https://module.sletat.ru/Main.svc/GetAvailableFeatures?countryId=40&towns=372,1592,1642

Запрашиваются справочники списка услуг отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три типа услуг):

<source lang="xml">
{
"GetAvailableFeaturesResult":
{
"Data": [
{
"Filters": [
{
"Id": 3,
"IsAvailable": true,
"Name": "Песок"
},
{
"Id": 5,
"IsAvailable": true,
"Name": "Каменистый"
},
{
"Id": 6,
"IsAvailable": true,
"Name": "Бетонный"
},
{
"Id": 7,
"IsAvailable": true,
"Name": "Частный"
},
{
"Id": 4,
"IsAvailable": true,
"Name": "Галька"
}
],
"Id": 2,
"Name": "Тип пляжа"
},
{
"Filters": [
{
"Id": 8,
"IsAvailable": true,
"Name": "Частная"
},
{
"Id": 9,
"IsAvailable": true,
"Name": "Общественная"
}
],
"Id": 3,
"Name": "Парковка"
},
{
"Filters": [
{
"Id": 1,
"IsAvailable": true,
"Name": "Есть"
},
{
"Id": 2,
"IsAvailable": true,
"Name": "Бесплатный"
}
],
"Id": 1,
"Name": "Wi-Fi"
},
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

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

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

https://module.sletat.ru/Main.svc/GetCountries?townFromId=1264

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

Запрос имеет единственный параметр townFromId* - целочисленный идентификатор города вылета.

Пример ответа (для удобства чтения представлены только три направления):

<source lang="xml">
{
"GetCountriesResult":
{
"Data":
[
{
"Id":1,
"Name":"Абхазия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
{
"Id":2,
"Name":"Австралия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
...
{
"Id":139,
"Name":"Япония",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
}
],
...
}
}
</source>

В ответ возвращается структура GetCountriesResult.Data – массив данных о направлениях, доступных для указанного города вылета.

Поля структуры GetCountriesResult.Data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор направления.
|-
|Name
|Str
|Направление.
|-
|Alias
|Str
|Текстовый код направления.
|-
|Flags
|Int
|Указатель группы, в которую входит страна (Экзотическая страна, подходит для отдыха на море, является страной шенгенского соглашения).
|-
|HasTickets
|Bool
|Наличие билетов. Если билеты есть в наличии, параметр принимает значение “true”; в противном случае — “false”.
|-
|HotelIsNotInStop
|Bool
|Наличие мест в отеле. Если в отеле есть места, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsProVisa
|Bool
|Требуется ли в страну про-виза. Если в страну требуется про-виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsVisa
|Bool
|Требуется ли в страну виза. Если в страну требуется виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|OriginalName
|Str
|Название страны на латинице.
|-
|Rank
|Int
|Ранг страны (0 — самый высокий).
|-
|TicketsIncluded
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, параметр принимает значение “true”; в противном случае — “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetCities?countryId=40

Запрашивается справочник курортов Египта.

Запрос имеет единственный параметр countryId * - целочисленный идентификатор направления.

Пример ответа (для удобства чтения представлены только три курорта):

<source lang="xml">
{
"GetCitiesResult":
{
"Data":
[
{
"Id":3769,
"Name":"Адабия",
"Default":false,
"DescriptionUrl":"",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":37,
"Name":"Александрия",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Александрия",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1662,
"Name":"Эль Гуна",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Эль-Гуна",
"IsPopular":true,
“ParentId”:null
}
],
…
}
}
</source>

В ответ возвращается структура GetCitiesResult.Data, имеющая следующие поля:

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

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

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

https://module.sletat.ru/Main.svc/GetHotels?countryId=40&towns=1642&stars=404&filter=&all=-1

Запрашивается справочник по 5-звёздочным отелям Шарм-эль-Шейха (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор направления.
|-
|towns
|Int[]
|Идентификаторы городов, разделённые запятыми.
|-
|stars
|Int[]
|Идентификаторы категорий отелей, разделённые запятыми.
|-
|filter
|Str
|Фильтрация по названию отеля.
|-
|all
|Int
|Количество отелей в выдаче. Возможные значения: “-1” – в выдачу попадают все отели; любое положительное целое число – точное количество отелей.
|}

Пример ответа (для удобства чтения представлены данные только по трём отелям)

<source lang="xml">
{
"GetHotelsResult":
{
"Data":
[{
"GetHotelsResult": {
"ErrorMessage": null,
"ExecutionTimeMs": 0,
"IsError": false,
"Data": [
{
"Id": 104202,
"Name": "Acalam Country Club",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 15,
"PopularityLevel": 0,
"Rate": 9.8,
"SearchCount": 53,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
},
{
"Id": 103114,
"Name": "Akua Resort Hotel",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 20,
"PopularityLevel": 0,
"Rate": 8.5,
"SearchCount": 181,
"StarId": 402,
"StarName": "3*",
"TownId": 6571
},
{
"Id": 104198,
"Name": "Al Mare",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 11,
"PopularityLevel": 0,
"Rate": 0,
"SearchCount": 25,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
}
],
...
"Count":94
}
}
</source>

В ответ возвращается структура GetHotelsResult, состоящая из структуры Data – массива данных об отелях, а также поля Count - общего количества отелей в возвращённом справочнике.

Поля структуры Data:

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

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

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

https://module.sletat.ru/Main.svc/GetHotelStars?countryId=40&towns=372,1592,1642

Запрашиваются справочники категорий отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три категории):

<source lang="xml">
{
"GetHotelStarsResult":
{
"Data":
[
{
"Id":401,
"Name":"2*"
},
{
"Id":402,
"Name":"3*"
},
...
{
"Id":410,
"Name":"HV-1"
}
],
...
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

==== GetMeals — Типы питания ====
Метод GetMeals возвращает список типов питания.

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

https://module.sletat.ru/Main.svc/GetMeals?

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

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

<source lang="xml">
{
"GetMealsResult":
{
"Data":
[
{
"Id":115,
"Name":"AI"
},
{
"Id":114,
"Name":"BB"
},
...
{
"Id":116,
"Name":"UAI"
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор типа питания.
|-
|Name
|Str
|Тип питания.
|}

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

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

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

https://module.sletat.ru/Main.svc/GetTourOperators?townFromId=1264&countryId=40

Запрашивается справочник туроператоров, предлагающих туры из Санкт-Петербурга в Египет.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|townFromId *
|Int
|Идентификатор города вылета. См. параметр Enabled в описании ответа.
|-
|countryId *
|Int
|Идентификатор направления. См. параметр Enabled в описании ответа.
|-
|login
|Str
|Логин пользователя Слетать.ру
|-
|password
|Str
|Пароль пользователя Слетать.ру
|-
|userId
|Int
|Идентификатор пользователя. Используется в сервисах Слетать.ру для передачи параметров, установленных пользователем в личном кабинете.
|}

Пример ответа (для удобства чтения представлены данные только по трём туроператорам):

<source lang="xml">
{
"GetTourOperatorsResult":
{
"Data":
[
{
"Id":19,
"Name":"Anex",
"Enabled":true
},
{
"Id":7,
"Name":"Biblio Globus",
"Enabled":true
},
...
{
"Id":17,
"Name":"Южный крест",
"Enabled":false
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|Enabled
|Bool
|Работа по указанной паре townFromId-countryId. Если туропера-тор предлагает туры, поле принимает значение “true”; в против-ном случае – “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetTourDates?dptCityId=1264&countryId=40&resorts=372,1592,1642

Запрашиваются доступные даты туров из Санкт-Петербурга в Шарм-эль-Шейх, Хургаду и Дахаб (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|dptCityId *
|Int
|Идентификатор города вылета.
|-
|countryId *
|Int
|Идентификатор страны
|-
|resorts
|String
|Список идентификаторов курортов, разделённых запятой.
|-
|sources
|String
|Список идентификаторов туроператоро, разделенных запятой.
|-
|login
|String
|Логин пользователя Слетать.ру
|-
|password
|String
|Пароль пользователя Слетать.ру
|-
|target
|String
|Используется для внутренних сервисов Слетать.ру
|}

Пример ответа (для удобства чтения представлены только три даты):

<source lang="xml">
{
"GetTourDatesResult":
{
"Data":
{
"dates":
[
"13.05.2014",
"14.05.2014",
...
"15.05.2014"
]
}
...
}
}
</source>

В ответ возвращается структура GetTourDatesResult.Data, имеющая единственное поле dates – массив доступных дат вылета в строковом отображении.

==== GetSourseAssurances — Фингарантии операторов ====
Метод '''GetSourseAssurances''' возвращают массивы юрлиц по идентификатору туроператора в справочнике Слетать.ру

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|Number
|string
|Номер туроператора в реестре.
|-
|Name
|string
|Полное наименование туроператора
|-
|Site
|string
|Ссылка на сайт туроператора
|-
|NameShort
|string
|Сокращенное наименование
|-
|PhysicalAddress
|string
|Юридический адрес
|-
|PostAddress
|string
|Почтовый адрес
|}

SourceFinSecurityDocument[]

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

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

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|FinSecurityAmount
|int
|Размер финансового обеспечения
|-
|WayToFinSecurity
|string
|Тип документа
|-
|DocumentNumber
|string
|Номер документа в реестре
|-
|DocumentDate
|DateTime
|Дата размещения документа
|-
|DateOfFinSecurityFrom
|DateTime
|Дата начала действия документа
|-
|DateOfFinSecurityTo
|DateTime
|Дата окончания действия документа
|-
|OrgName
|string
|Название организации, предоставившей ТО финансовые гарантии
|-
|OrgAddress
|string
|Юридический адрес организации, предоставившей ТО финансовые гарантии
|-
|OrgPostAddress
|string
|Почтовый адрес организации, предоставившей ТО финансовые гарантии
|}

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

https://module.sletat.ru/Main.svc/GetSourseAssurances?sourceId=7

=== Методы загрузки туров ===
==== GetTours — Список туров по заданным параметрам ====
Метод GetTours используется для создания поискового запроса, а также – если в запросе передаётся параметр requestId и параметр updateResult=1 – для получения результатов поиска по запросу.

Обратите внимание: указание параметров requestId=***&updateResult=1 обязательно для получения результатов поиска. В некоторых случаях повторное обращение к методу GetTours без указания этих параметров также вернет результаты, но их корректность не гарантируется.

Пример запроса (для краткости оставлены только обязательные параметры):

[https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832&countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019&requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1 https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832 &countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019 &requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1]

Запрашиваются туры:
* из Москвы в Турцию;
* по всем отеля;
* на двоих;
* без детей;
* продолжительностью от 3 до 10 ночей;
* с интервалом дат вылета 19.09.19 – 25.09.19;
* с включённым перелётом, гарантированным наличием билетов и мест в отеле;
* на странице выдачи должно располагаться 10 результатов;
* описание отеля должно выводиться в ленте выдачи;
* дополнительно запрашиваются данные о визовых и топливных сборах;
* услуги предоставляемые в отеле;

Параметры запроса:

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

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

{| class="standard sWarning"
|Внимание! Из-за технических ограничений со стороны оператора «Натали Турс», он принимает в одном запросе не больше 5 идентификаторов отелей. При передаче в запросе более 5 идентификаторов отелей к оператору уходят только первые 5, из-за этого в результаты поиска по этому ТО могут попадать не самые дешевые туры.
|}
|-
|s_adults
|Int
|Количество туристов (взрослых). По умолчанию: 2.
|-
|s_kids
|Int
|Количество туристов (детей). По умолчанию: 0.
|-
|s_kids_ages
|Int[]
|Список возрастов детей, разделённых запятыми. Количество значению соответствует значению параметра s_kids. По умолчанию: не задан.
|-
|s_nightsMin
|Int
|Минимальная продолжительность тура, ночей. По умолчанию: 3.
|-
|s_nightsMax
|Int
|Максимальная продолжительность тура, ночей. По умолчанию: 15.
|-
|s_priceMin
|Int
|Минимальная цена. По умолчанию: не задан.
|-
|s_priceMax
|Int
|Максимальная цена. По умолчанию: не задан.
|-
|currencyAlias
|Str
|Валюта параметров s_priceMin и s_PriceMax. Допустимые значения: USD, EUR, RUB, UAH, BYN, KZT и UZS. По умолчанию: RUB.
|-
|s_departFrom
|Str
|Начальная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата.
|-
|s_departTo
|Str
|Конечная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата + 7 дней. Допустимый интервал между начальной и конечной датой диапазона — '''45 дней'''.
|-
|visibleOperators
|Str[]
|Список видимых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|hiddenOperators
|Str[]
|Список скрытых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|calcFullPrice
|Bool
|Учитывать топливный сбор. Если в ответе нужно учитывать топливный сбор, параметр передаёт значение “1”; если допускаются цена без учёта топливного сбора – “0”. По умолчанию: “0”.
|-
|s_hotelIsNotInStop
|Str
|Наличие мест в отеле. Если в ответе нужны только отели с местами, параметр передаёт значение “true”; в противном случае – “false”. По умолчанию: “false”.
|-
|s_hasTickets
|Str
|Наличие билетов. Если в ответе нужны только туры с билетами, параметр передаёт значение “true”; если допускаются туры без билетов – “false”. По умолчанию: “false”.
|-
|s_ticketsIncluded
|Str
|Объём турпакета. Если в ответе нужны только туры с включённым перелётом, параметр передаёт значение “true”; если допускаются туры без перелёта – “false”. По умолчанию: “false”.
|-
|features
|Int[]
|Фильтрация данных ответа по услугам курорта. (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filter
|Int
|Фильтрация данных ответа по туроператорам. Возможные значения: “0” — выключено; “1” — включено. Если фильтр включён, используются идентификаторы из параметра f_to_id. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filterToursForType
|Ulong
|filterToursForType - параметр фильтра, который позволяет вывести в ответ определённые туры. 
Например, если вы хотите, чтобы в ответе были только туры с Чартером необходимо передать filterToursForType = 65536. 
Остальные возможные параметры:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

262144 - Туры на транспорте в виде ЖД дороги

524288 - Туры с прямыми перелёты
|-
|f_to_id
|Int[]
|Идентификаторы туроператоров, подлежащих фильтрации. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|fake
|Int
| Демо-выдача. По умолчанию: не задан.
|-
|extend
|Int
|Используется для сайта Слетать.ру
|-
|requestId
|Int
|Идентификатор запроса для получения результатов поиска. По умолчанию: не задан. Обязателен для получения результатов запроса.
|-
|pageSize
|Int
|Количество туров в ленте выдачи на одной странице. По умолчанию: не задан и выводит 20 туров.
|-
|pageNumber
|Int
|Номер страницы в ленте выдачи. По умолчанию: не задан.
|-
|updateResult
|Bool
|Получить свежие цены. Требует обязательной передачи параметра requestId. '''Требует значения "1"''' при повторном обращении к GetTours для получения результатов поиска.
|-
|includeDescriptions
|Bool
|Включить в выдачу описания отеля, типов размещения и питания. Если в ответе нужны описания, параметр передаёт значение “1”; если описания не нужны – “0”.
|-
|economOnly
|Bool
|Показывать туры с перелетом в экономическом классе. Варианты значений: 1 и 0. По умолчанию: не задан.
|-
|excludeToursForType
|Ulong
|excludeToursForType - параметр фильтра, который позволяет исключить из ответа типы туров.
Например, если из результатов поиска надо исключить Промо туры (16384) и туры на Регулярных рейсах (32768): excludeToursForType = 49152.
|-
|userId
|Int
|Используется для сайта Слетать.ру
|-
|includeOilTaxesAndVisa
|Bool
|Топливные и визовые сборы. Если данные нужны в ответе, параметр передаёт значение “true”; если не нужны – “false”. По умолчанию: не задан. Передавать как 1 или 0.
|-
|groupBy
|Str
|Группировка выдачи. Возможные значения:
* "so_checkin_price": Туры будут отсортированы по дате заезда (сначала ближайшие даты) и потом по цене
* "so_price": Туры будут отсортированы по цене
* "all_sortedHotels": Сортировка по умолчанию, туры будут сгруппированы по отелю и отсортированы по цене по возростанию
* "all_sortedHotelsDesc": Туры будут сгруппированы по отелю и отсортированы по цене по убыванию
* "sortedHotels": Туры будут отсортированы по отелю и полной цене (в случае ее недоступности будет использована простая цена) (FullPrice & Price)
* "hotel": Туры будут сгруппированы только по отелю (без сортировки)
* "hotelsPopularity": Туры будут сгруппированы по отелю и отсортированы по убыванию рейтинга
* "special_hotels": Туры для ТОП3
"": По умолчанию, будет проверено состояние поискового запроса если он в процессе то будут запрошены и возвращены результаты для ТОП3 отсортированные по цене, если нет, то будет возвращен пустой массив.
Если параметр не передан, используется сортировка по цене, а максимальное количество туров в выдаче ограничивается тысячей (см. также параметр '''PageSize''').
|-
|}

Пример ответа (для удобства чтения представлены данные в общем виде):

<source lang="xml">
{
"GetToursResult":
{
"Data":
{
"aaData":
[
...
[
"1792097464",
4,
"https://hotels.sletat.ru/?id=120282",
120282,
"",
1334,
"ANTALYA, SIDE TWINGS RESIDENCE HOME (3 ноч.)",
"Twings Residence Home",
"3*",
"Studio Apartment",
"RO",
"DBL",
"22.09.2019",
"25.09.2019",
3,
"30233 RUB",
2,
0,
"TEZ TOUR",
"Сиде",
[
"http://www.tez-tour.com/ru/spb/search.html"
],
"0",
"1",
"1",
"1",
"1",
"1",
"Вс.",
"25.09",
"",
119,
"Турция",
832,
"Москва",
"//static.sletat.ru/images/to/4.png",
"0",
"",
"",
"",
13103,
false,
117,
30233,
"RUB",
5753,
402,
0,
"https://sletat.ru/book/TEZ TOUR/NHwxNzkyMDk3NDY0fDgzMnw1OTIwMDY3MDJ8",
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
"",
"7",
"",
"2",
"-1",
0,
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
402,
0,
"+j0faDzJV6UBHpT16oUO9A==",
"65536",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"Y4I6oFV4RRG6pnjmHab8Pw==",
0,
null,
-1,
false,
"",
"",
30233,
0,
0,
null,
null,
[
17
],
36.7794571,
31.398035,
"",
[
7
],
0.00105993031
]
],
"cacheIsEmpty":false,
"countryCurrencyId":"3",
"hotelDetailedTypes": null,
"hotelFacilitiesData": {
"facilities": [
{
"id": 2,
"name": "Чистка обуви"
},
{
"id": 3,
"name": "Экскурсии"
},
{
"id": 6,
"name": "Частная"
},
{
"id": 8,
"name": "Глажка одежды"
},
{
"id": 9,
"name": "Пункт обмена валюты"
},
"groups": [
{
"id": 2,
"name": "Общие услуги"
},
{
"id": 3,
"name": "Парковка"
},
{
"id": 6,
"name": "Пляжная линия"
},
{
"id": 8,
"name": "Удобства в номерах"
},
{
"id": 9,
"name": "Специальные номера"
},
"hotelFacilities": [
{
"facilities": [
{
"facilityId": 16,
"groupId": 2,
"hit": null
},
{
"facilityId": 24,
"groupId": 8,
"hit": null
},
{
"facilityId": 26,
"groupId": 15,
"hit": null
},
{
"facilityId": 30,
"groupId": 12,
"hit": null
}
"hotelsCount":8,
"iTotalDisplayRecords":105,
"iTotalRecords":105,
"isInTheBasket":0,
"loadState": [
{
"Id": 51,
"Name": "Ambotis Holidays",
"ErrorMessage": null,
"ExecutionTimeMs": 2491,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 53086,
"MinFullPrice": 0,
"MinPrice": 46492,
"OnlineErrorMessage": null,
"RowsCount": 74
},
{
"Id": 171,
"Name": "Amigo S",
"ErrorMessage": null,
"ExecutionTimeMs": 4708,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 50726,
"MinFullPrice": 0,
"MinPrice": 44120,
"OnlineErrorMessage": null,
"RowsCount": 50
}
],
"oilTaxes": [
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Аланья",
null,
34,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Анталья",
null,
72,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Белек",
null,
149,
null,
832,
null,
null
]
},
...
}
}
</source>

В ответ возвращается структура GetToursResult.Data, состоящая из структур:
* aaData – массив записей о турах, каждый элемент которого является массивом данных о туре,
* LoadState (см. описание в «GetLoadState – Статус обработки запроса»);
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visa – массив записей о визовых сборах, применимых к выбранным турам, каждый элемент которого является массивом данных о визовом сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visaRange, включающей в себя единственный параметр visaRange[1] – валюту визового сбора, а также массив записей о диапазоне визовых сборов, каждый элемент которого является массивом данных о минимальном и максимальном визовом сборе, включаемом в стоимость отдельным туроператором.

{| class="standard sWarning"
|Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

Кроме того, структура GetToursResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|cacheIsEmpty
|bool
|Состояние кеша. Принимает значение '''true''', если кеш пуст
|-
|countryCurrencyId
|str
|Идентификатор валюты, используемой в стране
|-
|hotelsCount"
|int
|Количество отелей в выдаче
|-
|iTotalDisplayRecords
|int
|Количество туров в выдаче; Если >2500 возвращаем 2500;
|-
|iTotalRecords"
|int
|iTotalRecords идентично iTotalDisplayRecords
|-
|isInTheBasket
|int
|Технический параметр. Используется только на сайте sletat.ru
|-
|requestId
|Int
|Идентификатор поискового запроса.
|}

Поля структуры aaData:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Int
|Идентификатор цены.
|-
|aaData[1]
|Int
|Шифрованный идентификатор туроператора.
|-
|aaData[2]
|Str
|Ссылка на описание отеля.
|-
|aaData[3]
|Int
|Идентификатор отеля.
|-
|aaData[4]
|Str
|Ссылка на описание курорта.
|-
|aaData[5]
|Int
|Идентификатор курорта.
|-
|aaData[6]
|Str
|Название тура.
|-
|aaData[7]
|Str
|Название отеля.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип комнаты (не размещение).
|-
|aaData[10]
|Str
|Тип питания.
|-
|aaData[11]
|Str
|Тип размещения.
|-
|aaData[12]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[13]
|Str
|Дата прибытия в формате DD.MM.YYYY.
|-
|aaData[14]
|Int
|Продолжительность тура, ночей.
|-
|aaData[15]
|Str
|Стоимость тура с указанием валюты.
|-
|aaData[16]
|Int
|Количество туристов (взрослых).
|-
|aaData[17]
|Int
|Количество туристов (детей).
|-
|aaData[18]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[19]
|Str
|Название курорта.
|-
|aaData[20][0]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[21]
|Bool
|Наличие мест в отеле. Возможные значения: “0” — есть; “1” — нет, “2” — по запросу.
|-
|aaData[22]
|Bool
|Объём турпакета.
|-
|aaData[23]
|Int
|Наличие билетов эконом-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[24]
|Int
|Наличие билетов эконом-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[25]
|Int
|Наличие билетов бизнес-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[26]
|Int
|Наличие билетов бизнес-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[27]
|Str
|День начала тура. Используется только в текстовом представлении. Возможные значения: Пн. Вт. Ср. Чт. Пн. Сб. Вс.
|-
|aaData[28]
|Str
|Дата окончания тура. Используется только в текстовом представлении.
|-
|aaData[29]
|Str
|Ссылка на миниатюрную фотографию отеля.
|-
|aaData[30]
|Int
|Идентификатор направления.
|-
|aaData[31]
|Str
|Название страны.
|-
|aaData[32]
|Int
|Идентификатор города вылета.
|-
|aaData[33]
|Str
|Название города вылета.
|-
|aaData[34]
|Str
|Ссылка на логотип туроператора.
|-
|aaData[35]
|Float
|Рейтинг отеля от 0 до 10.
|-
|aaData[36]
|Str
|Описание типа питания (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[37]
|Str
|Описание типа размещения (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[38]
|Str
|Описание отеля (выдаётся если параметр запроса includeDescriptions = “true”).
|-
|aaData[39]
|Int
|Системный идентификатор типа размещения (поле может быть пустым, если данные не слинкованы).
|-
|aaData[40]
|Bool
|Флаг демо-режима. Если шлюз работает в демо-режиме, поле принимает значение “true”; в противном случае – “false”.
|-
|aaData[41]
|Int
|Системный идентификатор питания (поле может быть пустым, если данные не слинкованы).
|-
|aaData[42]
|Int
|Цена тура в виде числа (без прибавления к строке валюты).
|-
|aaData[43]
|Int
|Валюта полня aaData[42].
|-
|aaData[44]
|Int
|Системный идентификатор типа номера в отеле (поле может быть пустым, если данные не слинкованы).
|-
|aaData[45]
|Int
|Системный идентификатор категории отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[46]
|Int
|Количество фотографий отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[47]
|Str
|Ссылка на личный кабинет туроператора.
|-
|aaData[48]
|Str
|Оригинальное название тура.
|-
|aaData[49]
|Str
|Оригинальное название категории.
|-
|aaData[50]
|Str
|Оригинальное название курорта.
|-
|aaData[51]
|Str
|Оригинальное название питания.
|-
|aaData[52]
|Str
|Оригинальное название размещения.
|-
|aaData[53]
|Str
|Оригинальное название типа номера.
|-
|aaData[54]
|Str
|Количество мест в отеле. Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество мест.
|-
|aaData[55]
|Int
|Количество билетов эконом-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[56]
|Int
|Количество билетов эконом-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[57]
|Int
|Количество билетов бизнес-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[58]
|Int
|Количество билетов бизнес-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[59]
|Int
|Флаг тура с обязательствами; «0» – обычный тур; «1» – тур с обязательствами.
|-
|aaData[60]
|
|Наименование отеля
|-
|aaData[61]
|
|Описание категории отеля
|-
|aaData[62]
|
|Наименование тура
|-
|aaData[63]
|
|Тип питания
|-
|aaData[64]
|
|Тип размещения
|-
|aaData[65]
|
|Тип нормера в отеле
|-
|aaData[66]
|
|Идентификатор категории отеля
|-
|aaData[67]
|
|Тип цены
|-
|aaData[68]
|
|Хеш идентификатор тура в архиве
|-
|aaData[69]
|int
|Признак чартера и регулярного перелета. Поле представляет из себя целочисленное беззнаковое число (ulong). Для регулярного перелета - 32768, для чартерного - 65536.
Все возможные признаки на данный момент следующие:
* None = 0 - нет,
* Recommended = 1 - Рекомендованный тур,
* Instant = 2 - Тур с моментальным подтверждением,
* BestOfffer = 4 - Лучшее предложение,
* EarlyBook = 8 - Тур с ранним бронированием,
* LateBook = 16 - Тур с поздним бронированием,
* Discount = 32 - Тур со скидкой,
* VipOffer = 64 - VIP туры ,
* CreditAvailable = 128 - Доступно в кредит,
* Exclusive = 256 - Эксклюзивный тур,
* GoesWithGifts = 512 - Тур с подарками,
* IsCombined = 1024 - Комбинированный тур,
* ShopTour = 2048 - Шоп тур,
* ExcursionTour = 8192 - Экскурсионный тур,
* PROMO = 16384 - Тур с промо ценой,
* FlightRegular = 32768 - Тур с регулярным перелётом,
* FlightCharter = 65536 - Тур с чартерным перелётом,
* Bus = 131072 - Автобусный тур,
* Railway = 262144 - Ж/д тур,
* Target = 524288- Прямой перелёт
|-
|aaData[70]
|
|(устарело) — CreditMonths
|-
|aaData[71]
|
|(устарело) — CreditMonthlyPay
|-
|aaData[72]
|
|(устарело) — Описание тура
|-
|aaData[73]
|
|(устарело) — Скидка
|-
|aaData[74]
|
|(устарело) — Срок действия скидки
|-
|aaData[75]
|
|(устарело) — Описание скидки
|-
|aaData[76]
|
|(устарело) — ReceivingParty
|-
|aaData[77]
|
|(устарело) — GiftCaption
|-
|aaData[78]
|
|(устарело) — EarlyBookingValidTill
|-
|aaData[79]
|
|Хеш идентификатор тура в кеше
|-
|aaData[80]
|
|(устарело)
|-
|aaData[80]
|
|(устарело)
|-
|aaData[81]
|
|Дата первого обнаружения тура в системе. (Количество минут)
|-
|aaData[82]
|
|(используется для сайта Слетать.ру)
|-
|aaData[83]
|
|(используется для сайта Слетать.ру)
|-
|aaData[84]
|
|(используется для сайта Слетать.ру)
|-
|aaData[85]
|
|(используется для сайта Слетать.ру)
|-
|aaData[86]
|
|Цена тура без скидок и наценок, задаваемых в личном кабинете sletat.ru
|-
|aaData[87]
|
|Пляжная линия
|-
|aaData[88]
|
|
|-
|aaData[89]
|
|Рейтинг отеля на основе данных от TripAdVisor.
|-
|aaData[90]
|
|Количество отзывов в отель от TripAdVisor.
|-
|aaData[91]
|
|Список возможных типов размещения для отеля.
|-
|aaData[92]
|
|Координата расположения отеля - широта
|-
|aaData[93]
|
|Координата расположения отеля - долгота
|-
|aaData[94]
|
|Телефон.
|-
|aaData[95]
|int
|Данное поле представляет собой массив id включенных в тур услуг
Услуги отдаваемые на этапе поиска:

* Insurance = 3, - Страховка
* Transfer = 7, Трансфер от и до аэропорта
* Excursion = 8, Экскурсии
* Visa = 11, Виза в страну
* NoGoGuarantee = 12, страховка от невыезда
* OperatorLiabilityInsurance = 17, - Страхование ответственности ТО
* GuideServices = 18, - Услуги гида
* FuelSurcharge = 20, - Топливный сбор

Чтобы получить услуги отдаваемые при актуализации (все те же что при поиске и плюс описанные ниже), используйте метод актуализации:

* TourInfo = 1, - Информация по туру
* HotelInfo = 2, - Информация по доп отелям в туре (если вдруг тур комбинированный)
* DptTransport = 4, - Информация о транспорте туда
* RtnTransport = 10, - Информация о транспорте обратно
* AdditionalService = 5, Доп услуги
* AdditionalMeal = 6, Доп питание
* Charge = 9, Доп комиссия
* Infant = 13, - Включен в стоимость ребенок до 2ух лет
* Comission = 14, - Комиссия от туроператора (агента за тур)
* MidTransport = 15, - Информация о промежуточном транспорте
* HtPlace = 16, - Тип размещения
* Meal = 19, - Питание
* Avia = 21 - Авиаперелёт
* Railway = 22 - Билеты Ж/Д
* Bus = 23 - Автобусный переезд
* Cruise = 24 - Морское путешествие
|-
|aaData[96]
|float
|Рейтинг популярности отеля
|}

Поля структуры hotelFacilitiesData (передаются, если параметр запроса showHotelFacilities = 1)

{|class="wikitable"
|Поле
|Описание
|-
|"facilities"
|Словарь услуг в отеле.
|-
|"groups"
|Словарь групп услуг.
|-
|"hotelFacilities"
|Массив структур, содержащих id отеля и массив услуг этого отеля c указанием группы, к которой принадлежит услуга.
|}

Поля структуры visa (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|visa[0]
|Int
|Размер сбора.
|-
|visa[1]
|Str
|Валюта поля x[0].
|}

Поля структуры oilTaxes (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|oilTaxes[0]
|Int
|Идентификатор туроператора.
|-
|oilTaxes[1]
|Str
|Дата начала действия топливного сбора.
|-
|oilTaxes[2]
|Str
|Дата окончания действия топливного сбора.
|-
|oilTaxes[3]
|Int
|Размер топливного сбора.
|-
|oilTaxes[4]
|Str
|Валюта поля oilTaxes[3].
|-
|oilTaxes[5]
|Str
|Наименование авиакомпании.
|-
|oilTaxes[6]
|Str
|Наименование принимающей стороны.
|-
|oilTaxes[7]
|Str
|Название курорта.
|-
|oilTaxes[8]
|Str
|Название аэропорта прибытия.
|-
|oilTaxes [9]
|Int
|Идентификатор курорта.
|-
|oilTaxes[10]
|Int
|Номер рейса.
|-
|oilTaxes[11]
|Int
|Идентификатор города отбытия
|-
|oilTaxes[12]
|Int
|Возраст туриста, от которого включается топливный сбор.
|-
|oilTaxes[13]
|Int
|Возраст туриста, до которого включается топливный сбор.
|}

Для получения результатов выдачи методом GetTours используется идентификатор запроса requestId.

==== GetLoadState — Статус обработки запроса ====
Метод GetLoadState возвращает статус обработки запроса для каждого туроператора.

{| class="standard sWarning"
| Внимание! Варианты взаимодействия методов GetTours и GetLoadState описаны в разделе «Логика работы с сервисом».
|}

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

https://module.sletat.ru/Main.svc/GetLoadState?requestId=574187440&userId=

Запрашивается состояние обработки поискового запроса с идентификатором 574187440.

Запрос имеет единственный параметр requestId * - идентификатор поискового запроса, полученный в ответе метода GetTours.

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

<source lang="xml">
{
"GetLoadStateResult":
{
"Data":
[
{
"Id":1919263563,
"Name":"Туроператор #1919263563",
"ErrorMessage":null,
"ExecutionTimeMs":15,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
},
...
{
"Id":1919263596,
"Name":"Туроператор #1919263596",
"ErrorMessage":null,
"ExecutionTimeMs":719,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Шифрованный идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Выводится, если поле IsError принимает значение “true”.
|-
|ExecutionTime Ms
|Int
|Время обработки запроса туроператором в миллисекундах.
|-
|IsCached
|Bool
|Использование кэша. Если данные получены из кэша, поле принимает значение “true”; в противном случае – “false”.
|-
|IsError
|Bool
|Ошибка в поиске. Если при обработке запроса была допущена ошибка, поле принимает значение “true”; в противном случае – “false”.
|-
|IsPersistentCacheUsed
|Bool
|
|-
|IsProcessed
|Bool
|Завершение поиска. Если туроператор завершил обработку запроса, поле принимает значение “true”; в противном случае – “false”.
|-
|IsSkipped
|Bool
|
|-
|IsTimeout
|Bool
|Таймаут. Если обработка запроса завершена по таймауту, поле принимает значение “true”; в противном случае – “false”.
|-
|RowsCount
|Int
|Количество результатов поиска.
|}

=== Методы работы с заказом ===
==== ActualizePrice — Актуализация цены ====
Метод ActualizePrice необходим для актуализации предложений туроператоров. Он проверяет наличие билетов и мест в отеле, топливных и визовых сборов, а также других обязательных доплат и, при наличии, прибавляет их к стоимости тура.

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

https://module.sletat.ru/Main.svc/ActualizePrice?sourceId=970&offerId=1467001328&currencyAlias=RUB&showcase=0&countryId=119&requestId=343658640&detailed=1

Запрашиваются актуальные данные по туру в Турцию с идентификатором 1467001328 от туроператора 970, найденному по запросу 343658640; Указывается параметр detailed=1, чтобы провести актуализацию. Результат возвращается в рублях.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Str
|Идентификатор ценового предложения (тура).
|-
|currencyAlias
|Int
|Валюта. Возможные значения: USD, EUR, RUB, UAH, BYN и UZS
|-
|showcase *
|Int
|Включение режима выдачи для горящих туров.
|-
|countryId
|Int
|Идентификатор направления.
|-
|requestId *
|Int
|Идентификатор поискового запроса.
|-
|userId
|
|-
|detailed
|int
|Флаг, который позволяет выполнить актуализацию.
|}

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

<source lang="xml">
{
"ActualizePriceResult": {
"ErrorCode": 0,
"ErrorMessage": null,
"ExecutionTimeMs": 13757,
"IsError": false,
"Data": {
"actualizationSessionId": "c0AxpC6AOU2ua9Jr2IHaFg==",
"buyOnlineAvailabilityStatus": 1,
"data": [
"TURKEY",
"Moscow",
"ISTANBUL",
"MOW-IST(4)_ПРОМО 7_Hotel commission Standard",
"01.06.2025",
"7",
"Raimond Hotel",
"343658640",
"3*",
"Standard With French Bed",
"08.06.2025",
"BB",
"True",
"0",
"1",
"1",
"0",
"0",
"860",
"87711",
"",
"EUR",
"2Взр.",
"RUB",
"970",
"Турплатформа",
"119",
"Турция",
"832",
"Москва",
"1365",
"Стамбул",
"120625",
"Raimond Hotel",
"402",
"3*",
"",
"Standard With French Bed",
"114",
"BB",
"13103",
"DBL",
null,
"/turkey/fatih/raimond_hotel/",
"https://hotels.sletat.ru/i/p/120625_0.jpg",
33,
"/book/Турплатформа/OTcwfDE0NjcwMDEzMjh8ODMyfDM0MzY1ODY0MHw%3d",
"3",
"7.2",
"Завтраки",
"двухместный номер",
"Отель Raimond находится в тихом районе, всего в 10 минутах ходьбы от Голубой мечети. К услугам гостей круглосуточная стойка регистрации и звукоизолированные номера с бесплатным Wi-Fi.\n\nЭлегантно оформленные номера отеля Raimond оснащены телевизором с плоским экраном, кондиционером, сейфом и мини-баром. В собственной ванной комнате предоставляются бесплатные туалетно-косметические принадлежности. В некоторых номерах есть балкон.\n\nВ ресторане отеля ежедневно сервируется завтрак \"шведский стол\". Поблизости работает множество ресторанов и кафе.\n\nДо магазинов Лалели и ресторанов Кумкапы можно дойти пешком.",
"1467001328",
"2",
"0",
"Wb7pVPm82TDPEjqWLoqGAQ==",
"A0E1378CCF687358A0D816750E6862E8",
"",
0,
"5",
false,
false,
false,
false,
"Turkey",
"Moscow",
"/touroperators/tourplatform2",
"49154"
],
"errorMessage": null,
"hotelPlaces": [
{
"description": "Cтандартный типовой номер в отеле",
"id": 13,
"isMain": true,
"name": "Стандартный номер"
}
],
"isBuyOnlineAvailability": true,
"isCompleted": true,
"isDetailedExists": true,
"isError": false,
"isFound": true,
"nextPossibleCommands": null,
"oilTaxes": [
[
0,
null,
null,
"Турплатформа",
null,
"17.03.2025",
"28.02.2026",
null,
null,
null,
null,
null,
null
]
],
"randomNumber": 83120,
"resourceData": [
{
"name": "AIRLINE",
"resourceId": 4020001,
"value": "Southwind"
},
...
],
"resources": [
{
"exclude": "",
"groupId": 2,
"id": 4020001,
"isChecked": true,
"isEnabled": true,
"isGeneratedInternally": false,
"linkGroupsId": 733282017,
"name": "2S 086 Southwind Airlines SVO 01.06.2025 12:35:00 - IST 01.06.2025 17:45:00 Econom",
"surcharge": 0,
"surchargeCurrencyId": 5,
"surchargeCurrencyIdOriginal": 3,
"surchargeOriginal": 0,
"type": 4
},
...
],
"rtbHash": "25843CB000E440B877E1D9713FE024A5",
"specialPromoOffers": [],
"visa": null,
"visaExtendedInfo": []
}
}
}
</source>

В ответ возвращается структура ActualizePriceResult.Data, состоящая из структур:
* data – массив данных о туре;
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе;
* resourceData;
* recources;
* visa – массив записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе;
* visaExtendedInfo – масссив расширенных записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе.

Кроме того, структура ActualizePriceResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|actualizationSessionId
|
|
|-
|errorMessage
|Str
|Текст ошибки. Выводится, если поле isError принимает значение “true”.
|-
|isCompleted
|
|
|-
|isError
|
|Сообщение об ошибке. Если в процессе обработки запроса произошла ошибка, поле принимает значение “true”, в противном случае – “false”.
|-
|isFound
|
|
|-
|nextPossibleCommands
|
|
|-
|randomNumber
|Int
|«Быстрый» номер тура в рамках запроса.
|-
|buyOnlineAvailabilityStatus
|Int
|Показывает статус доступности тура к покупке онлайн
|}

Описание статусов поля buyOnlineAvailabilityStatus:

{| class="wikitable"
|Значение
|Описание
|-
|1
|Доступна оплата без дополнительных условий.
|-
|2
|Оплата недоступна.
|-
|3
|Оператор не поддерживает онлайн оплату.
|-
|4
|Тур продан. Или нет перелётов (при этом ticketIncluded= true) или отеля (при этом hasTicket= true).
|-
|5
|Валюта тура отличная от RUB.
|-
|6
|До отправления меньше 24 ч.
|-
|7
|Тур не найден.
|}

Поля структуры data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Str
|Направление.
|-
|aaData[1]
|Str
|Город вылета.
|-
|aaData[2]
|Str
|Курорт.
|-
|aaData[3]
|Str
|Название программы.
|-
|aaData[4]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[5]
|Int
|Продолжительность тура, ночей.
|-
|aaData[6]
|Str
|Название отеля.
|-
|aaData[7]
|Str
|Не используется.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип номера.
|-
|aaData[10]
|Str
|Зарезервировано.
|-
|aaData[11]
|Str
|Тип питания.
|-
|aaData[12]
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, поле принимает значение “true”, в противном случае – “false”.
|-
|aaData[13]
|Int
|Наличие мест в отеле. 0 - места есть, 1 - отель в стопе, 2 - места под запрос
|-
|aaData[14]
|Int
|Билеты эконом-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[15]
|Int
|Билеты эконом-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[16]
|Int
|Билеты бизнес-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[17]
|Int
|Билеты бизнес-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[18]
|Int
|Оригинальная цена (со скидкой и наценкой).
|-
|aaData[19]
|Int
|Цена в запрошенной валюте (со скидкой и наценкой).
|-
|aaData[20]
|Str
|Дополнительное описание тура.
|-
|aaData[21]
|Str
|Валюта полей aaData[18] и aaData[19].
|-
|aaData[22]
|Str
|Тип размещения.
|-
|aaData[23]
|Str
|Системное название валюты.
|-
|aaData[24]
|Int
|Идентификатор туроператора. Получение значения этого поля может быть ограничено лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[25]
|Str
|Наименование туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[26]
|Int
|Идентификатор направления. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[27]
|Str
|Направление. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[28]
|Int
|Идентификатор города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[29]
|Str
|Название города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[30]
|Int
|Идентификатор курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[31]
|Str
|Название курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[32]
|Int
|Идентификатор отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[33]
|Str
|Название отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[34]
|Int
|Идентификатор категории отеля.
|-
|aaData[35]
|Str
|Категория отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[36]
|
|Идентификатор типа номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[37]
|Str
|Тип номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[38]
|Int
|Идентификатор типа питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[39]
|Str
|Тип питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[40]
|Int
|Идентификатор типа размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[41]
|Str
|Тип размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[42]
|Str
|Ссылка на туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[43]
|Str
|Ссылка на сайт отеля.
|-
|aaData[44]
|Str
|Ссылка на первую фотографию отеля.
|-
|aaData[45]
|Int
|Количество доступных фотографий отеля.
|}

Данные о топливных сборах

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|x[0]
|Int
|Размер топливного сбора.
|-
|x[1]
|Str
|Валюта поля x[0].
|-
|x[2]
|Str
|Наименование авиакомпании.
|-
|x[3]
|Int
|Идентификатор туроператора.
|-
|x[4]
|Str
|Курорт.
|-
|x[5]
|Str
|Дата начала действия топливного сбора.
|-
|x[6]
|Str
|Дата окончания действия топливного сбора.
|-
|x[7]
|Str
|Наименование принимающей стороны.
|-
|x[8]
|Str
|Аэропорт прибытия
|-
|x[9]
|Int?
|Номер рейса.
|}

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

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

https://module.sletat.ru/Main.svc/SaveTourOrder?searchRequestId=575366173&offerId=12242442&sourceId=1922198339&user=%D0%98%D0%B2%D0%B0%D0%BD+%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%87+%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9&email=test%40mail.ru&phone=%2B71111111111&info=%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9+%D0%BA%D0%BE%D0%BC%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%80%D0%B8%D0%B9.+%D0%98%D0%B7%D0%B2%D0%B8%D0%BD%D0%B8%D1%82%D0%B5.&countryName=undefined&cityFromName=undefined&currencyAlias=RUB&userId=

Передаются данные о заказе тура #12242442 от туроператора #1922198339, найденного по запросу #575366173: ФИО, телефон, e-mail, комментарий к заказу, город вылета и направление, валюта цены тура (рубли).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|searchRequestId *
|Int
|Идентификатор поискового запроса.
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Int
|Идентификатор ценового предложения (тура).
|-
|user *
|Str
|Имя заказчика.
|-
|email *
|Str
|Электронная почта заказчика.
|-
|phone *
|Str
|Телефон заказчика.
|-
|info
|Str
|Комментарий заказчика.
|-
|countryName *
|Str
|Направление.
|-
|cityFromName *
|Str
|Город вылета.
|-
|currencyAlias *
|Str
|Валюта. Допустимые значения: USD, EUR, RUR, BYN.
|-
|userId
|
|
|}

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

<source lang="xml">
{
"SaveTourOrderResult":
{
"Data":0,
"ErrorMessage":null,
"ExecutionTimeMs":117,
"IsError":false
}
}
</source>

В ответ передаётся структура SaveTourOrderRequest, с пустым массивом Data и полями, возвращающими данными об ошибки (см. описание в разделе «Методы»).

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

2026-03-30T14:18:56Z

Kdadmin: Добавление валюты UZS

[[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">
...
</GetDepartCities>
</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 и UZS. Указанная валюта будет использована в поисковой выдаче.
|-
|
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-запроса:
<source lang="xml">
<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 и UZS.
|-
|
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 - Туры на транспорте в виде ЖД дороги

524288 - Туры с прямыми перелёты
|-
|
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 и UZS.
|}

Элемент 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 и UZS.
|-
|
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 & 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 & 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''' – структура, содержащая основную информацию о туре;

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

Пример:

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

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

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

Поля структуры ResourceId

{| 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 и UZS.
|-
|
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"
|Параметр BAGGAGE_INCLUDED может иметь значение "true", но если параметр BAGGAGE_PLACES = 0 - то трактовать надо так, что багаж не включен.
|}

=== 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
|
|Идентификатор отеля
|}

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

2026-03-30T14:13:24Z

Kdadmin: Правка отображения синтаксиса запросов

[[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">
...
</GetDepartCities>
</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-запроса:
<source lang="xml">
<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 - Туры на транспорте в виде ЖД дороги

524288 - Туры с прямыми перелёты
|-
|
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 & 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 & 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''' – структура, содержащая основную информацию о туре;

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

Пример:

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

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

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

Поля структуры ResourceId

{| 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"
|Параметр BAGGAGE_INCLUDED может иметь значение "true", но если параметр BAGGAGE_PLACES = 0 - то трактовать надо так, что багаж не включен.
|}

=== 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
|
|Идентификатор отеля
|}

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

2026-01-28T09:26:42Z

Kdadmin: /* ActualizePrice — Актуализация цены */

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

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

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

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

== Подключение к сервису ==
Все методы веб-сервиса располагаются по адресу:

https://module.sletat.ru/Main.svc

Вызов любого метода должен иметь следующий синтаксис:

https://module.sletat.ru/Main.svc/{ИмяМетода}?{параметр1}={значение1}&{параметр2}={значение2}...

Пример вызова:

[http://module.sletat.ru/Main.svc/GetHotels?countryId=40 https://module.sletat.ru/Main.svc/GetHotels?countryId=40]

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

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

Передавать все параметры при вызове не обязательно. Обязательные параметры отмечены звёздочкой (*).

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

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

* '''GetTours''' – создание поискового запроса;
* '''GetLoadState''' – получение данных о статусе загрузки туров для каждого туроператора;
* '''GetTours''' (с указанием параметра requestId и параметра updateResult со значением "1") – возвращает результаты поиска;

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

В ответе первого обращения к '''GetTours''' приходит идентификатор созданного поискового запроса, который в дальнейшем используется для отслеживания состояния поискового запроса методом '''GetLoadState''' и получения результатов поиска повторным обращением к методу '''GetTours '''с указанием requestId и параметра updateResult=1.

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

=== Получение полного набора туров ===
# Создаётся поисковый запрос методом '''GetTours'''. Сохраняется идентификатор запроса, полученный в ответе.
# Создаётся цикл для получения статуса поискового запроса. В цикле вызывается метод '''GetLoadState''' с использованием идентификатора запроса. В итерации цикла обязательно должна быть пауза (рекомендованное минимальное значение – 1,5 секунды). В результате вызова GetLoadState проверяется, все ли туроператоры обработали запрос (т.е. для всех туроператоров поле IsProcessed принимает значение "true"). На ос-нове проверки принимается решение о продолжении цикла или (если все туропера-торы обработали запрос) о переходе к методу получения туров.
# Снова вызывается метод GetTours, но уже с использованием полученного ранее идентификатора и параметра updateResult=1. Метод вернет все найденные туры в рамках поискового запроса.

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

== Методы ==
В этом разделе описаны все методы поискового сервиса. В соответствии с логикой работы сервиса (см. соответствующий раздел) они разделены на три группы:

* Методы получения справочников. При помощи методов этой группы вы можете загрузить списки стран, курортов, городов вылета, отелей, туроператоров и т. д. Обращение к этим методам необходимо на этапе подготовки к формированию поискового запроса.
* Методы загрузки туров. Методы этой группы позволяют провести весь цикл работ с поисковым запросом – от формирования до получения поисковой выдачи.
* Методы работы с заказом. Эти методы позволяют актуализировать данные о туре, получив информацию о перелётах, размерах топливных сборов и других доплат, а также оформить заказ и передать его на сайт sletat.ru для последующего оповещения менеджеров или статистического анализа.

Запрос каждого метода может содержать технический параметр debug, запускающий режим отладки, если передано значение “1”. По умолчанию передаётся значение “0”. Для удобства чтения параметр исключён из примеров запросов.

Ответ каждого из методов содержит поле Data – массив данных, запрашиваемых методов, а также следующие технические поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Поле принимает значение “null”, если значение поля IsError = “false”.
|-
|ExecutionTimeMs
|Int
|Время обработки запроса в миллисекундах.
|-
|IsError
|Bool
|Сообщение об ошибке. Если при обработке запроса произошла ошибка, поле принимает значение “true”; в прот
|}

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

=== Методы получения справочников ===
Наиболее полный справочник доступен по ссылке:
https://module.sletat.ru/Dictionaries.xml

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

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

https://module.sletat.ru/Main.svc/GetDepartCities?

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

Пример ответа (для удобства чтения данные представлены только по трём городам):

<source lang="xml">
{
"GetDepartCitiesResult":
{
"Data":
[
{
"Id":832,
"Name":"Москва",
"Default":true,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
{
"Id":1264,
"Name":"Санкт-Петербург",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1327,
"Name":"Ялта",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
}
],
...
}
}
</source>

В ответ возвращается структура GetDepartCitiesResult.Data – массив данных о городах вылета.

Поля структуры GetDepartCitiesResult.Data:
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор города вылета.
|-
|Name
|Str
|Город вылета..
|-
|Default
|Bool
|
|-
|DescriptionUrl
|Str
|Ссылка на описание города.
|-
|IsPopular
|Bool
|Популярность города вылета. Если город вылета был признан популярным на основе статистики поисковых запросов, сделанных на сайте sletat.ru и сайтах партнёров, поле принимает значение “true”; в противном случае — “false”.
|-
|ParentId
|Int
|Идентификатор родительского города (см. поле ParentId в описании ответа метода GetCities). Поле может иметь значение “null”, если город вылета не имеет родительского города.
|}

==== GetAvailableFeatures — Список услуг отеля ====
Метод GetAvailableFeatures возвращает список доступных услуг отелей в выбранных курортах.

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

https://module.sletat.ru/Main.svc/GetAvailableFeatures?countryId=40&towns=372,1592,1642

Запрашиваются справочники списка услуг отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три типа услуг):

<source lang="xml">
{
"GetAvailableFeaturesResult":
{
"Data": [
{
"Filters": [
{
"Id": 3,
"IsAvailable": true,
"Name": "Песок"
},
{
"Id": 5,
"IsAvailable": true,
"Name": "Каменистый"
},
{
"Id": 6,
"IsAvailable": true,
"Name": "Бетонный"
},
{
"Id": 7,
"IsAvailable": true,
"Name": "Частный"
},
{
"Id": 4,
"IsAvailable": true,
"Name": "Галька"
}
],
"Id": 2,
"Name": "Тип пляжа"
},
{
"Filters": [
{
"Id": 8,
"IsAvailable": true,
"Name": "Частная"
},
{
"Id": 9,
"IsAvailable": true,
"Name": "Общественная"
}
],
"Id": 3,
"Name": "Парковка"
},
{
"Filters": [
{
"Id": 1,
"IsAvailable": true,
"Name": "Есть"
},
{
"Id": 2,
"IsAvailable": true,
"Name": "Бесплатный"
}
],
"Id": 1,
"Name": "Wi-Fi"
},
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

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

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

https://module.sletat.ru/Main.svc/GetCountries?townFromId=1264

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

Запрос имеет единственный параметр townFromId* - целочисленный идентификатор города вылета.

Пример ответа (для удобства чтения представлены только три направления):

<source lang="xml">
{
"GetCountriesResult":
{
"Data":
[
{
"Id":1,
"Name":"Абхазия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
{
"Id":2,
"Name":"Австралия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
...
{
"Id":139,
"Name":"Япония",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
}
],
...
}
}
</source>

В ответ возвращается структура GetCountriesResult.Data – массив данных о направлениях, доступных для указанного города вылета.

Поля структуры GetCountriesResult.Data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор направления.
|-
|Name
|Str
|Направление.
|-
|Alias
|Str
|Текстовый код направления.
|-
|Flags
|Int
|Указатель группы, в которую входит страна (Экзотическая страна, подходит для отдыха на море, является страной шенгенского соглашения).
|-
|HasTickets
|Bool
|Наличие билетов. Если билеты есть в наличии, параметр принимает значение “true”; в противном случае — “false”.
|-
|HotelIsNotInStop
|Bool
|Наличие мест в отеле. Если в отеле есть места, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsProVisa
|Bool
|Требуется ли в страну про-виза. Если в страну требуется про-виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsVisa
|Bool
|Требуется ли в страну виза. Если в страну требуется виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|OriginalName
|Str
|Название страны на латинице.
|-
|Rank
|Int
|Ранг страны (0 — самый высокий).
|-
|TicketsIncluded
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, параметр принимает значение “true”; в противном случае — “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetCities?countryId=40

Запрашивается справочник курортов Египта.

Запрос имеет единственный параметр countryId * - целочисленный идентификатор направления.

Пример ответа (для удобства чтения представлены только три курорта):

<source lang="xml">
{
"GetCitiesResult":
{
"Data":
[
{
"Id":3769,
"Name":"Адабия",
"Default":false,
"DescriptionUrl":"",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":37,
"Name":"Александрия",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Александрия",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1662,
"Name":"Эль Гуна",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Эль-Гуна",
"IsPopular":true,
“ParentId”:null
}
],
…
}
}
</source>

В ответ возвращается структура GetCitiesResult.Data, имеющая следующие поля:

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

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

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

https://module.sletat.ru/Main.svc/GetHotels?countryId=40&towns=1642&stars=404&filter=&all=-1

Запрашивается справочник по 5-звёздочным отелям Шарм-эль-Шейха (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор направления.
|-
|towns
|Int[]
|Идентификаторы городов, разделённые запятыми.
|-
|stars
|Int[]
|Идентификаторы категорий отелей, разделённые запятыми.
|-
|filter
|Str
|Фильтрация по названию отеля.
|-
|all
|Int
|Количество отелей в выдаче. Возможные значения: “-1” – в выдачу попадают все отели; любое положительное целое число – точное количество отелей.
|}

Пример ответа (для удобства чтения представлены данные только по трём отелям)

<source lang="xml">
{
"GetHotelsResult":
{
"Data":
[{
"GetHotelsResult": {
"ErrorMessage": null,
"ExecutionTimeMs": 0,
"IsError": false,
"Data": [
{
"Id": 104202,
"Name": "Acalam Country Club",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 15,
"PopularityLevel": 0,
"Rate": 9.8,
"SearchCount": 53,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
},
{
"Id": 103114,
"Name": "Akua Resort Hotel",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 20,
"PopularityLevel": 0,
"Rate": 8.5,
"SearchCount": 181,
"StarId": 402,
"StarName": "3*",
"TownId": 6571
},
{
"Id": 104198,
"Name": "Al Mare",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 11,
"PopularityLevel": 0,
"Rate": 0,
"SearchCount": 25,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
}
],
...
"Count":94
}
}
</source>

В ответ возвращается структура GetHotelsResult, состоящая из структуры Data – массива данных об отелях, а также поля Count - общего количества отелей в возвращённом справочнике.

Поля структуры Data:

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

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

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

https://module.sletat.ru/Main.svc/GetHotelStars?countryId=40&towns=372,1592,1642

Запрашиваются справочники категорий отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три категории):

<source lang="xml">
{
"GetHotelStarsResult":
{
"Data":
[
{
"Id":401,
"Name":"2*"
},
{
"Id":402,
"Name":"3*"
},
...
{
"Id":410,
"Name":"HV-1"
}
],
...
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

==== GetMeals — Типы питания ====
Метод GetMeals возвращает список типов питания.

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

https://module.sletat.ru/Main.svc/GetMeals?

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

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

<source lang="xml">
{
"GetMealsResult":
{
"Data":
[
{
"Id":115,
"Name":"AI"
},
{
"Id":114,
"Name":"BB"
},
...
{
"Id":116,
"Name":"UAI"
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор типа питания.
|-
|Name
|Str
|Тип питания.
|}

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

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

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

https://module.sletat.ru/Main.svc/GetTourOperators?townFromId=1264&countryId=40

Запрашивается справочник туроператоров, предлагающих туры из Санкт-Петербурга в Египет.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|townFromId *
|Int
|Идентификатор города вылета. См. параметр Enabled в описании ответа.
|-
|countryId *
|Int
|Идентификатор направления. См. параметр Enabled в описании ответа.
|-
|login
|Str
|Логин пользователя Слетать.ру
|-
|password
|Str
|Пароль пользователя Слетать.ру
|-
|userId
|Int
|Идентификатор пользователя. Используется в сервисах Слетать.ру для передачи параметров, установленных пользователем в личном кабинете.
|}

Пример ответа (для удобства чтения представлены данные только по трём туроператорам):

<source lang="xml">
{
"GetTourOperatorsResult":
{
"Data":
[
{
"Id":19,
"Name":"Anex",
"Enabled":true
},
{
"Id":7,
"Name":"Biblio Globus",
"Enabled":true
},
...
{
"Id":17,
"Name":"Южный крест",
"Enabled":false
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|Enabled
|Bool
|Работа по указанной паре townFromId-countryId. Если туропера-тор предлагает туры, поле принимает значение “true”; в против-ном случае – “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetTourDates?dptCityId=1264&countryId=40&resorts=372,1592,1642

Запрашиваются доступные даты туров из Санкт-Петербурга в Шарм-эль-Шейх, Хургаду и Дахаб (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|dptCityId *
|Int
|Идентификатор города вылета.
|-
|countryId *
|Int
|Идентификатор страны
|-
|resorts
|String
|Список идентификаторов курортов, разделённых запятой.
|-
|sources
|String
|Список идентификаторов туроператоро, разделенных запятой.
|-
|login
|String
|Логин пользователя Слетать.ру
|-
|password
|String
|Пароль пользователя Слетать.ру
|-
|target
|String
|Используется для внутренних сервисов Слетать.ру
|}

Пример ответа (для удобства чтения представлены только три даты):

<source lang="xml">
{
"GetTourDatesResult":
{
"Data":
{
"dates":
[
"13.05.2014",
"14.05.2014",
...
"15.05.2014"
]
}
...
}
}
</source>

В ответ возвращается структура GetTourDatesResult.Data, имеющая единственное поле dates – массив доступных дат вылета в строковом отображении.

==== GetSourseAssurances — Фингарантии операторов ====
Метод '''GetSourseAssurances''' возвращают массивы юрлиц по идентификатору туроператора в справочнике Слетать.ру

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|Number
|string
|Номер туроператора в реестре.
|-
|Name
|string
|Полное наименование туроператора
|-
|Site
|string
|Ссылка на сайт туроператора
|-
|NameShort
|string
|Сокращенное наименование
|-
|PhysicalAddress
|string
|Юридический адрес
|-
|PostAddress
|string
|Почтовый адрес
|}

SourceFinSecurityDocument[]

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

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

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|FinSecurityAmount
|int
|Размер финансового обеспечения
|-
|WayToFinSecurity
|string
|Тип документа
|-
|DocumentNumber
|string
|Номер документа в реестре
|-
|DocumentDate
|DateTime
|Дата размещения документа
|-
|DateOfFinSecurityFrom
|DateTime
|Дата начала действия документа
|-
|DateOfFinSecurityTo
|DateTime
|Дата окончания действия документа
|-
|OrgName
|string
|Название организации, предоставившей ТО финансовые гарантии
|-
|OrgAddress
|string
|Юридический адрес организации, предоставившей ТО финансовые гарантии
|-
|OrgPostAddress
|string
|Почтовый адрес организации, предоставившей ТО финансовые гарантии
|}

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

https://module.sletat.ru/Main.svc/GetSourseAssurances?sourceId=7

=== Методы загрузки туров ===
==== GetTours — Список туров по заданным параметрам ====
Метод GetTours используется для создания поискового запроса, а также – если в запросе передаётся параметр requestId и параметр updateResult=1 – для получения результатов поиска по запросу.

Обратите внимание: указание параметров requestId=***&updateResult=1 обязательно для получения результатов поиска. В некоторых случаях повторное обращение к методу GetTours без указания этих параметров также вернет результаты, но их корректность не гарантируется.

Пример запроса (для краткости оставлены только обязательные параметры):

[https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832&countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019&requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1 https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832 &countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019 &requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1]

Запрашиваются туры:
* из Москвы в Турцию;
* по всем отеля;
* на двоих;
* без детей;
* продолжительностью от 3 до 10 ночей;
* с интервалом дат вылета 19.09.19 – 25.09.19;
* с включённым перелётом, гарантированным наличием билетов и мест в отеле;
* на странице выдачи должно располагаться 10 результатов;
* описание отеля должно выводиться в ленте выдачи;
* дополнительно запрашиваются данные о визовых и топливных сборах;
* услуги предоставляемые в отеле;

Параметры запроса:

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

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

{| class="standard sWarning"
|Внимание! Из-за технических ограничений со стороны оператора «Натали Турс», он принимает в одном запросе не больше 5 идентификаторов отелей. При передаче в запросе более 5 идентификаторов отелей к оператору уходят только первые 5, из-за этого в результаты поиска по этому ТО могут попадать не самые дешевые туры.
|}
|-
|s_adults
|Int
|Количество туристов (взрослых). По умолчанию: 2.
|-
|s_kids
|Int
|Количество туристов (детей). По умолчанию: 0.
|-
|s_kids_ages
|Int[]
|Список возрастов детей, разделённых запятыми. Количество значению соответствует значению параметра s_kids. По умолчанию: не задан.
|-
|s_nightsMin
|Int
|Минимальная продолжительность тура, ночей. По умолчанию: 3.
|-
|s_nightsMax
|Int
|Максимальная продолжительность тура, ночей. По умолчанию: 15.
|-
|s_priceMin
|Int
|Минимальная цена. По умолчанию: не задан.
|-
|s_priceMax
|Int
|Максимальная цена. По умолчанию: не задан.
|-
|currencyAlias
|Str
|Валюта параметров s_priceMin и s_PriceMax. Допустимые значения: USD, EUR, RUR, UAH, BYN, KZT. По умолчанию: RUB.
|-
|s_departFrom
|Str
|Начальная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата.
|-
|s_departTo
|Str
|Конечная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата + 7 дней. Допустимый интервал между начальной и конечной датой диапазона — '''45 дней'''.
|-
|visibleOperators
|Str[]
|Список видимых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|hiddenOperators
|Str[]
|Список скрытых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|calcFullPrice
|Bool
|Учитывать топливный сбор. Если в ответе нужно учитывать топливный сбор, параметр передаёт значение “1”; если допускаются цена без учёта топливного сбора – “0”. По умолчанию: “0”.
|-
|s_hotelIsNotInStop
|Str
|Наличие мест в отеле. Если в ответе нужны только отели с местами, параметр передаёт значение “true”; в противном случае – “false”. По умолчанию: “false”.
|-
|s_hasTickets
|Str
|Наличие билетов. Если в ответе нужны только туры с билетами, параметр передаёт значение “true”; если допускаются туры без билетов – “false”. По умолчанию: “false”.
|-
|s_ticketsIncluded
|Str
|Объём турпакета. Если в ответе нужны только туры с включённым перелётом, параметр передаёт значение “true”; если допускаются туры без перелёта – “false”. По умолчанию: “false”.
|-
|features
|Int[]
|Фильтрация данных ответа по услугам курорта. (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filter
|Int
|Фильтрация данных ответа по туроператорам. Возможные значения: “0” — выключено; “1” — включено. Если фильтр включён, используются идентификаторы из параметра f_to_id. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filterToursForType
|Ulong
|filterToursForType - параметр фильтра, который позволяет вывести в ответ определённые туры. 
Например, если вы хотите, чтобы в ответе были только туры с Чартером необходимо передать filterToursForType = 65536. 
Остальные возможные параметры:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

262144 - Туры на транспорте в виде ЖД дороги

524288 - Туры с прямыми перелёты
|-
|f_to_id
|Int[]
|Идентификаторы туроператоров, подлежащих фильтрации. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|fake
|Int
| Демо-выдача. По умолчанию: не задан.
|-
|extend
|Int
|Используется для сайта Слетать.ру
|-
|requestId
|Int
|Идентификатор запроса для получения результатов поиска. По умолчанию: не задан. Обязателен для получения результатов запроса.
|-
|pageSize
|Int
|Количество туров в ленте выдачи на одной странице. По умолчанию: не задан и выводит 20 туров.
|-
|pageNumber
|Int
|Номер страницы в ленте выдачи. По умолчанию: не задан.
|-
|updateResult
|Bool
|Получить свежие цены. Требует обязательной передачи параметра requestId. '''Требует значения "1"''' при повторном обращении к GetTours для получения результатов поиска.
|-
|includeDescriptions
|Bool
|Включить в выдачу описания отеля, типов размещения и питания. Если в ответе нужны описания, параметр передаёт значение “1”; если описания не нужны – “0”.
|-
|economOnly
|Bool
|Показывать туры с перелетом в экономическом классе. Варианты значений: 1 и 0. По умолчанию: не задан.
|-
|excludeToursForType
|Ulong
|excludeToursForType - параметр фильтра, который позволяет исключить из ответа типы туров.
Например, если из результатов поиска надо исключить Промо туры (16384) и туры на Регулярных рейсах (32768): excludeToursForType = 49152.
|-
|userId
|Int
|Используется для сайта Слетать.ру
|-
|includeOilTaxesAndVisa
|Bool
|Топливные и визовые сборы. Если данные нужны в ответе, параметр передаёт значение “true”; если не нужны – “false”. По умолчанию: не задан. Передавать как 1 или 0.
|-
|groupBy
|Str
|Группировка выдачи. Возможные значения:
* "so_checkin_price": Туры будут отсортированы по дате заезда (сначала ближайшие даты) и потом по цене
* "so_price": Туры будут отсортированы по цене
* "all_sortedHotels": Сортировка по умолчанию, туры будут сгруппированы по отелю и отсортированы по цене по возростанию
* "all_sortedHotelsDesc": Туры будут сгруппированы по отелю и отсортированы по цене по убыванию
* "sortedHotels": Туры будут отсортированы по отелю и полной цене (в случае ее недоступности будет использована простая цена) (FullPrice & Price)
* "hotel": Туры будут сгруппированы только по отелю (без сортировки)
* "hotelsPopularity": Туры будут сгруппированы по отелю и отсортированы по убыванию рейтинга
* "special_hotels": Туры для ТОП3
"": По умолчанию, будет проверено состояние поискового запроса если он в процессе то будут запрошены и возвращены результаты для ТОП3 отсортированные по цене, если нет, то будет возвращен пустой массив.
Если параметр не передан, используется сортировка по цене, а максимальное количество туров в выдаче ограничивается тысячей (см. также параметр '''PageSize''').
|-
|}

Пример ответа (для удобства чтения представлены данные в общем виде):

<source lang="xml">
{
"GetToursResult":
{
"Data":
{
"aaData":
[
...
[
"1792097464",
4,
"https://hotels.sletat.ru/?id=120282",
120282,
"",
1334,
"ANTALYA, SIDE TWINGS RESIDENCE HOME (3 ноч.)",
"Twings Residence Home",
"3*",
"Studio Apartment",
"RO",
"DBL",
"22.09.2019",
"25.09.2019",
3,
"30233 RUB",
2,
0,
"TEZ TOUR",
"Сиде",
[
"http://www.tez-tour.com/ru/spb/search.html"
],
"0",
"1",
"1",
"1",
"1",
"1",
"Вс.",
"25.09",
"",
119,
"Турция",
832,
"Москва",
"//static.sletat.ru/images/to/4.png",
"0",
"",
"",
"",
13103,
false,
117,
30233,
"RUB",
5753,
402,
0,
"https://sletat.ru/book/TEZ TOUR/NHwxNzkyMDk3NDY0fDgzMnw1OTIwMDY3MDJ8",
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
"",
"7",
"",
"2",
"-1",
0,
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
402,
0,
"+j0faDzJV6UBHpT16oUO9A==",
"65536",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"Y4I6oFV4RRG6pnjmHab8Pw==",
0,
null,
-1,
false,
"",
"",
30233,
0,
0,
null,
null,
[
17
],
36.7794571,
31.398035,
"",
[
7
],
0.00105993031
]
],
"cacheIsEmpty":false,
"countryCurrencyId":"3",
"hotelDetailedTypes": null,
"hotelFacilitiesData": {
"facilities": [
{
"id": 2,
"name": "Чистка обуви"
},
{
"id": 3,
"name": "Экскурсии"
},
{
"id": 6,
"name": "Частная"
},
{
"id": 8,
"name": "Глажка одежды"
},
{
"id": 9,
"name": "Пункт обмена валюты"
},
"groups": [
{
"id": 2,
"name": "Общие услуги"
},
{
"id": 3,
"name": "Парковка"
},
{
"id": 6,
"name": "Пляжная линия"
},
{
"id": 8,
"name": "Удобства в номерах"
},
{
"id": 9,
"name": "Специальные номера"
},
"hotelFacilities": [
{
"facilities": [
{
"facilityId": 16,
"groupId": 2,
"hit": null
},
{
"facilityId": 24,
"groupId": 8,
"hit": null
},
{
"facilityId": 26,
"groupId": 15,
"hit": null
},
{
"facilityId": 30,
"groupId": 12,
"hit": null
}
"hotelsCount":8,
"iTotalDisplayRecords":105,
"iTotalRecords":105,
"isInTheBasket":0,
"loadState": [
{
"Id": 51,
"Name": "Ambotis Holidays",
"ErrorMessage": null,
"ExecutionTimeMs": 2491,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 53086,
"MinFullPrice": 0,
"MinPrice": 46492,
"OnlineErrorMessage": null,
"RowsCount": 74
},
{
"Id": 171,
"Name": "Amigo S",
"ErrorMessage": null,
"ExecutionTimeMs": 4708,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 50726,
"MinFullPrice": 0,
"MinPrice": 44120,
"OnlineErrorMessage": null,
"RowsCount": 50
}
],
"oilTaxes": [
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Аланья",
null,
34,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Анталья",
null,
72,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Белек",
null,
149,
null,
832,
null,
null
]
},
...
}
}
</source>

В ответ возвращается структура GetToursResult.Data, состоящая из структур:
* aaData – массив записей о турах, каждый элемент которого является массивом данных о туре,
* LoadState (см. описание в «GetLoadState – Статус обработки запроса»);
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visa – массив записей о визовых сборах, применимых к выбранным турам, каждый элемент которого является массивом данных о визовом сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visaRange, включающей в себя единственный параметр visaRange[1] – валюту визового сбора, а также массив записей о диапазоне визовых сборов, каждый элемент которого является массивом данных о минимальном и максимальном визовом сборе, включаемом в стоимость отдельным туроператором.

{| class="standard sWarning"
|Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

Кроме того, структура GetToursResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|cacheIsEmpty
|bool
|Состояние кеша. Принимает значение '''true''', если кеш пуст
|-
|countryCurrencyId
|str
|Идентификатор валюты, используемой в стране
|-
|hotelsCount"
|int
|Количество отелей в выдаче
|-
|iTotalDisplayRecords
|int
|Количество туров в выдаче; Если >2500 возвращаем 2500;
|-
|iTotalRecords"
|int
|iTotalRecords идентично iTotalDisplayRecords
|-
|isInTheBasket
|int
|Технический параметр. Используется только на сайте sletat.ru
|-
|requestId
|Int
|Идентификатор поискового запроса.
|}

Поля структуры aaData:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Int
|Идентификатор цены.
|-
|aaData[1]
|Int
|Шифрованный идентификатор туроператора.
|-
|aaData[2]
|Str
|Ссылка на описание отеля.
|-
|aaData[3]
|Int
|Идентификатор отеля.
|-
|aaData[4]
|Str
|Ссылка на описание курорта.
|-
|aaData[5]
|Int
|Идентификатор курорта.
|-
|aaData[6]
|Str
|Название тура.
|-
|aaData[7]
|Str
|Название отеля.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип комнаты (не размещение).
|-
|aaData[10]
|Str
|Тип питания.
|-
|aaData[11]
|Str
|Тип размещения.
|-
|aaData[12]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[13]
|Str
|Дата прибытия в формате DD.MM.YYYY.
|-
|aaData[14]
|Int
|Продолжительность тура, ночей.
|-
|aaData[15]
|Str
|Стоимость тура с указанием валюты.
|-
|aaData[16]
|Int
|Количество туристов (взрослых).
|-
|aaData[17]
|Int
|Количество туристов (детей).
|-
|aaData[18]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[19]
|Str
|Название курорта.
|-
|aaData[20][0]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[21]
|Bool
|Наличие мест в отеле. Возможные значения: “0” — есть; “1” — нет, “2” — по запросу.
|-
|aaData[22]
|Bool
|Объём турпакета.
|-
|aaData[23]
|Int
|Наличие билетов эконом-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[24]
|Int
|Наличие билетов эконом-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[25]
|Int
|Наличие билетов бизнес-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[26]
|Int
|Наличие билетов бизнес-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[27]
|Str
|День начала тура. Используется только в текстовом представлении. Возможные значения: Пн. Вт. Ср. Чт. Пн. Сб. Вс.
|-
|aaData[28]
|Str
|Дата окончания тура. Используется только в текстовом представлении.
|-
|aaData[29]
|Str
|Ссылка на миниатюрную фотографию отеля.
|-
|aaData[30]
|Int
|Идентификатор направления.
|-
|aaData[31]
|Str
|Название страны.
|-
|aaData[32]
|Int
|Идентификатор города вылета.
|-
|aaData[33]
|Str
|Название города вылета.
|-
|aaData[34]
|Str
|Ссылка на логотип туроператора.
|-
|aaData[35]
|Float
|Рейтинг отеля от 0 до 10.
|-
|aaData[36]
|Str
|Описание типа питания (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[37]
|Str
|Описание типа размещения (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[38]
|Str
|Описание отеля (выдаётся если параметр запроса includeDescriptions = “true”).
|-
|aaData[39]
|Int
|Системный идентификатор типа размещения (поле может быть пустым, если данные не слинкованы).
|-
|aaData[40]
|Bool
|Флаг демо-режима. Если шлюз работает в демо-режиме, поле принимает значение “true”; в противном случае – “false”.
|-
|aaData[41]
|Int
|Системный идентификатор питания (поле может быть пустым, если данные не слинкованы).
|-
|aaData[42]
|Int
|Цена тура в виде числа (без прибавления к строке валюты).
|-
|aaData[43]
|Int
|Валюта полня aaData[42].
|-
|aaData[44]
|Int
|Системный идентификатор типа номера в отеле (поле может быть пустым, если данные не слинкованы).
|-
|aaData[45]
|Int
|Системный идентификатор категории отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[46]
|Int
|Количество фотографий отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[47]
|Str
|Ссылка на личный кабинет туроператора.
|-
|aaData[48]
|Str
|Оригинальное название тура.
|-
|aaData[49]
|Str
|Оригинальное название категории.
|-
|aaData[50]
|Str
|Оригинальное название курорта.
|-
|aaData[51]
|Str
|Оригинальное название питания.
|-
|aaData[52]
|Str
|Оригинальное название размещения.
|-
|aaData[53]
|Str
|Оригинальное название типа номера.
|-
|aaData[54]
|Str
|Количество мест в отеле. Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество мест.
|-
|aaData[55]
|Int
|Количество билетов эконом-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[56]
|Int
|Количество билетов эконом-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[57]
|Int
|Количество билетов бизнес-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[58]
|Int
|Количество билетов бизнес-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[59]
|Int
|Флаг тура с обязательствами; «0» – обычный тур; «1» – тур с обязательствами.
|-
|aaData[60]
|
|Наименование отеля
|-
|aaData[61]
|
|Описание категории отеля
|-
|aaData[62]
|
|Наименование тура
|-
|aaData[63]
|
|Тип питания
|-
|aaData[64]
|
|Тип размещения
|-
|aaData[65]
|
|Тип нормера в отеле
|-
|aaData[66]
|
|Идентификатор категории отеля
|-
|aaData[67]
|
|Тип цены
|-
|aaData[68]
|
|Хеш идентификатор тура в архиве
|-
|aaData[69]
|int
|Признак чартера и регулярного перелета. Поле представляет из себя целочисленное беззнаковое число (ulong). Для регулярного перелета - 32768, для чартерного - 65536.
Все возможные признаки на данный момент следующие:
* None = 0 - нет,
* Recommended = 1 - Рекомендованный тур,
* Instant = 2 - Тур с моментальным подтверждением,
* BestOfffer = 4 - Лучшее предложение,
* EarlyBook = 8 - Тур с ранним бронированием,
* LateBook = 16 - Тур с поздним бронированием,
* Discount = 32 - Тур со скидкой,
* VipOffer = 64 - VIP туры ,
* CreditAvailable = 128 - Доступно в кредит,
* Exclusive = 256 - Эксклюзивный тур,
* GoesWithGifts = 512 - Тур с подарками,
* IsCombined = 1024 - Комбинированный тур,
* ShopTour = 2048 - Шоп тур,
* ExcursionTour = 8192 - Экскурсионный тур,
* PROMO = 16384 - Тур с промо ценой,
* FlightRegular = 32768 - Тур с регулярным перелётом,
* FlightCharter = 65536 - Тур с чартерным перелётом,
* Bus = 131072 - Автобусный тур,
* Railway = 262144 - Ж/д тур,
* Target = 524288- Прямой перелёт
|-
|aaData[70]
|
|(устарело) — CreditMonths
|-
|aaData[71]
|
|(устарело) — CreditMonthlyPay
|-
|aaData[72]
|
|(устарело) — Описание тура
|-
|aaData[73]
|
|(устарело) — Скидка
|-
|aaData[74]
|
|(устарело) — Срок действия скидки
|-
|aaData[75]
|
|(устарело) — Описание скидки
|-
|aaData[76]
|
|(устарело) — ReceivingParty
|-
|aaData[77]
|
|(устарело) — GiftCaption
|-
|aaData[78]
|
|(устарело) — EarlyBookingValidTill
|-
|aaData[79]
|
|Хеш идентификатор тура в кеше
|-
|aaData[80]
|
|(устарело)
|-
|aaData[80]
|
|(устарело)
|-
|aaData[81]
|
|Дата первого обнаружения тура в системе. (Количество минут)
|-
|aaData[82]
|
|(используется для сайта Слетать.ру)
|-
|aaData[83]
|
|(используется для сайта Слетать.ру)
|-
|aaData[84]
|
|(используется для сайта Слетать.ру)
|-
|aaData[85]
|
|(используется для сайта Слетать.ру)
|-
|aaData[86]
|
|Цена тура без скидок и наценок, задаваемых в личном кабинете sletat.ru
|-
|aaData[87]
|
|Пляжная линия
|-
|aaData[88]
|
|
|-
|aaData[89]
|
|Рейтинг отеля на основе данных от TripAdVisor.
|-
|aaData[90]
|
|Количество отзывов в отель от TripAdVisor.
|-
|aaData[91]
|
|Список возможных типов размещения для отеля.
|-
|aaData[92]
|
|Координата расположения отеля - широта
|-
|aaData[93]
|
|Координата расположения отеля - долгота
|-
|aaData[94]
|
|Телефон.
|-
|aaData[95]
|int
|Данное поле представляет собой массив id включенных в тур услуг
Услуги отдаваемые на этапе поиска:

* Insurance = 3, - Страховка
* Transfer = 7, Трансфер от и до аэропорта
* Excursion = 8, Экскурсии
* Visa = 11, Виза в страну
* NoGoGuarantee = 12, страховка от невыезда
* OperatorLiabilityInsurance = 17, - Страхование ответственности ТО
* GuideServices = 18, - Услуги гида
* FuelSurcharge = 20, - Топливный сбор

Чтобы получить услуги отдаваемые при актуализации (все те же что при поиске и плюс описанные ниже), используйте метод актуализации:

* TourInfo = 1, - Информация по туру
* HotelInfo = 2, - Информация по доп отелям в туре (если вдруг тур комбинированный)
* DptTransport = 4, - Информация о транспорте туда
* RtnTransport = 10, - Информация о транспорте обратно
* AdditionalService = 5, Доп услуги
* AdditionalMeal = 6, Доп питание
* Charge = 9, Доп комиссия
* Infant = 13, - Включен в стоимость ребенок до 2ух лет
* Comission = 14, - Комиссия от туроператора (агента за тур)
* MidTransport = 15, - Информация о промежуточном транспорте
* HtPlace = 16, - Тип размещения
* Meal = 19, - Питание
* Avia = 21 - Авиаперелёт
* Railway = 22 - Билеты Ж/Д
* Bus = 23 - Автобусный переезд
* Cruise = 24 - Морское путешествие
|-
|aaData[96]
|float
|Рейтинг популярности отеля
|}

Поля структуры hotelFacilitiesData (передаются, если параметр запроса showHotelFacilities = 1)

{|class="wikitable"
|Поле
|Описание
|-
|"facilities"
|Словарь услуг в отеле.
|-
|"groups"
|Словарь групп услуг.
|-
|"hotelFacilities"
|Массив структур, содержащих id отеля и массив услуг этого отеля c указанием группы, к которой принадлежит услуга.
|}

Поля структуры visa (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|visa[0]
|Int
|Размер сбора.
|-
|visa[1]
|Str
|Валюта поля x[0].
|}

Поля структуры oilTaxes (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|oilTaxes[0]
|Int
|Идентификатор туроператора.
|-
|oilTaxes[1]
|Str
|Дата начала действия топливного сбора.
|-
|oilTaxes[2]
|Str
|Дата окончания действия топливного сбора.
|-
|oilTaxes[3]
|Int
|Размер топливного сбора.
|-
|oilTaxes[4]
|Str
|Валюта поля oilTaxes[3].
|-
|oilTaxes[5]
|Str
|Наименование авиакомпании.
|-
|oilTaxes[6]
|Str
|Наименование принимающей стороны.
|-
|oilTaxes[7]
|Str
|Название курорта.
|-
|oilTaxes[8]
|Str
|Название аэропорта прибытия.
|-
|oilTaxes [9]
|Int
|Идентификатор курорта.
|-
|oilTaxes[10]
|Int
|Номер рейса.
|-
|oilTaxes[11]
|Int
|Идентификатор города отбытия
|-
|oilTaxes[12]
|Int
|Возраст туриста, от которого включается топливный сбор.
|-
|oilTaxes[13]
|Int
|Возраст туриста, до которого включается топливный сбор.
|}

Для получения результатов выдачи методом GetTours используется идентификатор запроса requestId.

==== GetLoadState — Статус обработки запроса ====
Метод GetLoadState возвращает статус обработки запроса для каждого туроператора.

{| class="standard sWarning"
| Внимание! Варианты взаимодействия методов GetTours и GetLoadState описаны в разделе «Логика работы с сервисом».
|}

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

https://module.sletat.ru/Main.svc/GetLoadState?requestId=574187440&userId=

Запрашивается состояние обработки поискового запроса с идентификатором 574187440.

Запрос имеет единственный параметр requestId * - идентификатор поискового запроса, полученный в ответе метода GetTours.

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

<source lang="xml">
{
"GetLoadStateResult":
{
"Data":
[
{
"Id":1919263563,
"Name":"Туроператор #1919263563",
"ErrorMessage":null,
"ExecutionTimeMs":15,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
},
...
{
"Id":1919263596,
"Name":"Туроператор #1919263596",
"ErrorMessage":null,
"ExecutionTimeMs":719,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Шифрованный идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Выводится, если поле IsError принимает значение “true”.
|-
|ExecutionTime Ms
|Int
|Время обработки запроса туроператором в миллисекундах.
|-
|IsCached
|Bool
|Использование кэша. Если данные получены из кэша, поле принимает значение “true”; в противном случае – “false”.
|-
|IsError
|Bool
|Ошибка в поиске. Если при обработке запроса была допущена ошибка, поле принимает значение “true”; в противном случае – “false”.
|-
|IsPersistentCacheUsed
|Bool
|
|-
|IsProcessed
|Bool
|Завершение поиска. Если туроператор завершил обработку запроса, поле принимает значение “true”; в противном случае – “false”.
|-
|IsSkipped
|Bool
|
|-
|IsTimeout
|Bool
|Таймаут. Если обработка запроса завершена по таймауту, поле принимает значение “true”; в противном случае – “false”.
|-
|RowsCount
|Int
|Количество результатов поиска.
|}

=== Методы работы с заказом ===
==== ActualizePrice — Актуализация цены ====
Метод ActualizePrice необходим для актуализации предложений туроператоров. Он проверяет наличие билетов и мест в отеле, топливных и визовых сборов, а также других обязательных доплат и, при наличии, прибавляет их к стоимости тура.

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

https://module.sletat.ru/Main.svc/ActualizePrice?sourceId=970&offerId=1467001328&currencyAlias=RUB&showcase=0&countryId=119&requestId=343658640&detailed=1

Запрашиваются актуальные данные по туру в Турцию с идентификатором 1467001328 от туроператора 970, найденному по запросу 343658640; Указывается параметр detailed=1, чтобы провести актуализацию. Результат возвращается в рублях.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Str
|Идентификатор ценового предложения (тура).
|-
|currencyAlias
|Int
|Валюта. Возможные значения: USD, EUR, RUB, UAH, BYN
|-
|showcase *
|Int
|Включение режима выдачи для горящих туров.
|-
|countryId
|Int
|Идентификатор направления.
|-
|requestId *
|Int
|Идентификатор поискового запроса.
|-
|userId
|
|-
|detailed
|int
|Флаг, который позволяет выполнить актуализацию.
|}

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

<source lang="xml">
{
"ActualizePriceResult": {
"ErrorCode": 0,
"ErrorMessage": null,
"ExecutionTimeMs": 13757,
"IsError": false,
"Data": {
"actualizationSessionId": "c0AxpC6AOU2ua9Jr2IHaFg==",
"buyOnlineAvailabilityStatus": 1,
"data": [
"TURKEY",
"Moscow",
"ISTANBUL",
"MOW-IST(4)_ПРОМО 7_Hotel commission Standard",
"01.06.2025",
"7",
"Raimond Hotel",
"343658640",
"3*",
"Standard With French Bed",
"08.06.2025",
"BB",
"True",
"0",
"1",
"1",
"0",
"0",
"860",
"87711",
"",
"EUR",
"2Взр.",
"RUB",
"970",
"Турплатформа",
"119",
"Турция",
"832",
"Москва",
"1365",
"Стамбул",
"120625",
"Raimond Hotel",
"402",
"3*",
"",
"Standard With French Bed",
"114",
"BB",
"13103",
"DBL",
null,
"/turkey/fatih/raimond_hotel/",
"https://hotels.sletat.ru/i/p/120625_0.jpg",
33,
"/book/Турплатформа/OTcwfDE0NjcwMDEzMjh8ODMyfDM0MzY1ODY0MHw%3d",
"3",
"7.2",
"Завтраки",
"двухместный номер",
"Отель Raimond находится в тихом районе, всего в 10 минутах ходьбы от Голубой мечети. К услугам гостей круглосуточная стойка регистрации и звукоизолированные номера с бесплатным Wi-Fi.\n\nЭлегантно оформленные номера отеля Raimond оснащены телевизором с плоским экраном, кондиционером, сейфом и мини-баром. В собственной ванной комнате предоставляются бесплатные туалетно-косметические принадлежности. В некоторых номерах есть балкон.\n\nВ ресторане отеля ежедневно сервируется завтрак \"шведский стол\". Поблизости работает множество ресторанов и кафе.\n\nДо магазинов Лалели и ресторанов Кумкапы можно дойти пешком.",
"1467001328",
"2",
"0",
"Wb7pVPm82TDPEjqWLoqGAQ==",
"A0E1378CCF687358A0D816750E6862E8",
"",
0,
"5",
false,
false,
false,
false,
"Turkey",
"Moscow",
"/touroperators/tourplatform2",
"49154"
],
"errorMessage": null,
"hotelPlaces": [
{
"description": "Cтандартный типовой номер в отеле",
"id": 13,
"isMain": true,
"name": "Стандартный номер"
}
],
"isBuyOnlineAvailability": true,
"isCompleted": true,
"isDetailedExists": true,
"isError": false,
"isFound": true,
"nextPossibleCommands": null,
"oilTaxes": [
[
0,
null,
null,
"Турплатформа",
null,
"17.03.2025",
"28.02.2026",
null,
null,
null,
null,
null,
null
]
],
"randomNumber": 83120,
"resourceData": [
{
"name": "AIRLINE",
"resourceId": 4020001,
"value": "Southwind"
},
...
],
"resources": [
{
"exclude": "",
"groupId": 2,
"id": 4020001,
"isChecked": true,
"isEnabled": true,
"isGeneratedInternally": false,
"linkGroupsId": 733282017,
"name": "2S 086 Southwind Airlines SVO 01.06.2025 12:35:00 - IST 01.06.2025 17:45:00 Econom",
"surcharge": 0,
"surchargeCurrencyId": 5,
"surchargeCurrencyIdOriginal": 3,
"surchargeOriginal": 0,
"type": 4
},
...
],
"rtbHash": "25843CB000E440B877E1D9713FE024A5",
"specialPromoOffers": [],
"visa": null,
"visaExtendedInfo": []
}
}
}
</source>

В ответ возвращается структура ActualizePriceResult.Data, состоящая из структур:
* data – массив данных о туре;
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе;
* resourceData;
* recources;
* visa – массив записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе;
* visaExtendedInfo – масссив расширенных записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе.

Кроме того, структура ActualizePriceResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|actualizationSessionId
|
|
|-
|errorMessage
|Str
|Текст ошибки. Выводится, если поле isError принимает значение “true”.
|-
|isCompleted
|
|
|-
|isError
|
|Сообщение об ошибке. Если в процессе обработки запроса произошла ошибка, поле принимает значение “true”, в противном случае – “false”.
|-
|isFound
|
|
|-
|nextPossibleCommands
|
|
|-
|randomNumber
|Int
|«Быстрый» номер тура в рамках запроса.
|-
|buyOnlineAvailabilityStatus
|Int
|Показывает статус доступности тура к покупке онлайн
|}

Описание статусов поля buyOnlineAvailabilityStatus:

{| class="wikitable"
|Значение
|Описание
|-
|1
|Доступна оплата без дополнительных условий.
|-
|2
|Оплата недоступна.
|-
|3
|Оператор не поддерживает онлайн оплату.
|-
|4
|Тур продан. Или нет перелётов (при этом ticketIncluded= true) или отеля (при этом hasTicket= true).
|-
|5
|Валюта тура отличная от RUB.
|-
|6
|До отправления меньше 24 ч.
|-
|7
|Тур не найден.
|}

Поля структуры data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Str
|Направление.
|-
|aaData[1]
|Str
|Город вылета.
|-
|aaData[2]
|Str
|Курорт.
|-
|aaData[3]
|Str
|Название программы.
|-
|aaData[4]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[5]
|Int
|Продолжительность тура, ночей.
|-
|aaData[6]
|Str
|Название отеля.
|-
|aaData[7]
|Str
|Не используется.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип номера.
|-
|aaData[10]
|Str
|Зарезервировано.
|-
|aaData[11]
|Str
|Тип питания.
|-
|aaData[12]
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, поле принимает значение “true”, в противном случае – “false”.
|-
|aaData[13]
|Int
|Наличие мест в отеле. 0 - места есть, 1 - отель в стопе, 2 - места под запрос
|-
|aaData[14]
|Int
|Билеты эконом-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[15]
|Int
|Билеты эконом-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[16]
|Int
|Билеты бизнес-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[17]
|Int
|Билеты бизнес-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[18]
|Int
|Оригинальная цена (со скидкой и наценкой).
|-
|aaData[19]
|Int
|Цена в запрошенной валюте (со скидкой и наценкой).
|-
|aaData[20]
|Str
|Дополнительное описание тура.
|-
|aaData[21]
|Str
|Валюта полей aaData[18] и aaData[19].
|-
|aaData[22]
|Str
|Тип размещения.
|-
|aaData[23]
|Str
|Системное название валюты.
|-
|aaData[24]
|Int
|Идентификатор туроператора. Получение значения этого поля может быть ограничено лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[25]
|Str
|Наименование туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[26]
|Int
|Идентификатор направления. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[27]
|Str
|Направление. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[28]
|Int
|Идентификатор города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[29]
|Str
|Название города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[30]
|Int
|Идентификатор курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[31]
|Str
|Название курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[32]
|Int
|Идентификатор отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[33]
|Str
|Название отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[34]
|Int
|Идентификатор категории отеля.
|-
|aaData[35]
|Str
|Категория отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[36]
|
|Идентификатор типа номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[37]
|Str
|Тип номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[38]
|Int
|Идентификатор типа питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[39]
|Str
|Тип питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[40]
|Int
|Идентификатор типа размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[41]
|Str
|Тип размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[42]
|Str
|Ссылка на туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[43]
|Str
|Ссылка на сайт отеля.
|-
|aaData[44]
|Str
|Ссылка на первую фотографию отеля.
|-
|aaData[45]
|Int
|Количество доступных фотографий отеля.
|}

Данные о топливных сборах

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|x[0]
|Int
|Размер топливного сбора.
|-
|x[1]
|Str
|Валюта поля x[0].
|-
|x[2]
|Str
|Наименование авиакомпании.
|-
|x[3]
|Int
|Идентификатор туроператора.
|-
|x[4]
|Str
|Курорт.
|-
|x[5]
|Str
|Дата начала действия топливного сбора.
|-
|x[6]
|Str
|Дата окончания действия топливного сбора.
|-
|x[7]
|Str
|Наименование принимающей стороны.
|-
|x[8]
|Str
|Аэропорт прибытия
|-
|x[9]
|Int?
|Номер рейса.
|}

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

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

https://module.sletat.ru/Main.svc/SaveTourOrder?searchRequestId=575366173&offerId=12242442&sourceId=1922198339&user=%D0%98%D0%B2%D0%B0%D0%BD+%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%87+%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9&email=test%40mail.ru&phone=%2B71111111111&info=%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9+%D0%BA%D0%BE%D0%BC%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%80%D0%B8%D0%B9.+%D0%98%D0%B7%D0%B2%D0%B8%D0%BD%D0%B8%D1%82%D0%B5.&countryName=undefined&cityFromName=undefined&currencyAlias=RUB&userId=

Передаются данные о заказе тура #12242442 от туроператора #1922198339, найденного по запросу #575366173: ФИО, телефон, e-mail, комментарий к заказу, город вылета и направление, валюта цены тура (рубли).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|searchRequestId *
|Int
|Идентификатор поискового запроса.
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Int
|Идентификатор ценового предложения (тура).
|-
|user *
|Str
|Имя заказчика.
|-
|email *
|Str
|Электронная почта заказчика.
|-
|phone *
|Str
|Телефон заказчика.
|-
|info
|Str
|Комментарий заказчика.
|-
|countryName *
|Str
|Направление.
|-
|cityFromName *
|Str
|Город вылета.
|-
|currencyAlias *
|Str
|Валюта. Допустимые значения: USD, EUR, RUR, BYN.
|-
|userId
|
|
|}

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

<source lang="xml">
{
"SaveTourOrderResult":
{
"Data":0,
"ErrorMessage":null,
"ExecutionTimeMs":117,
"IsError":false
}
}
</source>

В ответ передаётся структура SaveTourOrderRequest, с пустым массивом Data и полями, возвращающими данными об ошибки (см. описание в разделе «Методы»).

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

2025-11-19T07:36:43Z

Kdadmin: /* Актуализация и загрузка информации о туре */

[[Category:Расширения и дополнения]]
== Актуализация и загрузка информации о туре ==

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

Сигнатура:
XmlActualPriceData ActualizePrice(Int32 sourceId, Int64 offerId, Int32 requestId, Int32[] selectedResources, String login, String password)

Параметры:
* requestId – идентификатор поискового запроса, выдается методом GetTours при создании
нового поискового запроса;
* offerId – идентификатор тура, выдаётся в методе GetTours для каждого тура;
* sourceId – идентификатор туроператора, выдаётся в методе GetTours для каждого тура;
* selectedResources – устарел.

* login – логин для авторизации в личном кабинете туроператора;
* password – пароль для авторизации в личном кабинете туроператора;
Если логин и пароль личного кабинета туроператора не передается в запросе, успешная актуализация информации по туру не гарантируется.
В ответ возвращается структура '''ActualizePriceResult''', которая состоит из следующих полей:
* TourInfo – структура описывает основную информацию о туре, формат описан ниже;
* RandomNumber – случайное четырехзначное число, по которому можно просмотреть информацию о туре в личном кабинете на сайте sletat.ru или в SletatRu Agent, используется для того, чтобы клиент мог точно сообщить менеджеру вашей компании о туре, который он нашёл;

* IsFound – поле принимает значение false, если тур не был найден в базе туроператора;
* IsError – принимает значение true, если при актуализации тура возникла ошибка;
* Resources – список услуг, входящих в тур, поле может быть пустым, если для туроператора
не реализована поддержка вывода подробной информации, формат списка услуг будет
описан ниже;
* ResourceData – список дополнительных произвольных данных к любой услуге из поля
Resources, формат будет описан ниже;

Описание структуры '''TourInfo''':

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
CountryName
|
String
|
Страна (данные от
туроператора).
|-
|
CityFromName
|
String
|
Город вылета (данные от
туроператора).
|-
|
ResortName
|
String
|
Курорт (данные от
туроператора).
|-
|
TourName
|
String
|
Название тура (данные от
туроператора).
|-
|
CheckIn
|
String
|
Дата вылета в формате
dd.MM.yyyy.
|-
|CheckOut
|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 или BYR).
|-
|
OriginalPrice
|
Int32
|
Оригинальная цена тура в исходной валюте (со скидкой и наценкой).
|-
|
OriginalPriceCurrency
|
String
|
Обозначение валюты (данные
от туроператора) для цены '''OriginalPrice'''.
|-
|
SourceId
|
Int32
|
Идентификатор туроператора. Поле заполняется
только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).
|-
|
SourceName
|
String
|
Название туроператора. Поле
заполняется только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).
|-
|
SourceSearchFormUrl
|
String
|
Ссылка на форму поиска
туроператора. Поле заполняется только для партнёров sletat.ru (по всем вопросам
обращайтесь в службу поддержки info@sletat.ru).
|-
|
SysCountryId
|
Int32
|
Идентификатор страны из
справочника стран.
|-
|
SysCountryName
|
String
|
Название страны из
справочника стран.
|-
|
SysCityFromId
|
Int32
|
Идентификатор города вылета
из справочника городов вылета.
|-
|
SysCityFromName
|
String
|
Название города вылета из
справочника городов вылета.
|-
|
SysResortId
|
Int32
|
Идентификатор курорта из справочника курортов
(либо из справочника '''GetCtities''' или '''GetGeoTree''', в зависимости от параметра '''useTree''' исходного поискового запроса), параметр может быть равен 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
|
Ссылка на описание / бронирование тура на сайте туроператора. Поле заполняется только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).

В настоящий момент некоторые
туроператоры не имеют ссылок в сервисе Слетать.ру.
|-
|OriginalCurrencyId
|Int32
|Идентификатор валюты тура по данным туроператора. Возможные значения: 2 – USD, 3 – EUR, 5 – RUR.
|-
|Adults
|Int32
|Количество туристов (взрослых).
|-
|Kids
|Int32
|Количество туристов (детей).
|}

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

Структура '''Resources''' состоит из вложенных элементов '''Resource''', каждый из которых описывает одну услугу в туре полями:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Id
|
Int32
|
Идентификатор услуги
|-
| Type
| Int32
| Тип услуги, список возможных типов:
* 1 - тур;
* 2 - проживание;
* 3 - страховка;
* 4 - транспорт (туда);
* 5 - дополнительные сервисы;
* 6 - дополнительное питание;
* 7 - трансфер;
* 8 - экскурсии;
* 9 - различные сборы;
* 10 - транспорт (обратно);
* 11 - информация о визах;
* 12 - страховка от невыезда;
* 13 - возможность добавления младенца;
* 14 - информация о комиссии;
* 15 - доп. перелёт в комбинированном туре;
* 16 - выбор размещения в основном отеле;
* 18 - Услуги гида;
* 19 - Питание;
* 20 - Топливный сбор;
* 21 - Авиаперелёт;
* 22 - Ж/Д билеты;
* 23 - Автобусный переезд;
* 24 - Морское путешествие;
* 25 - Other;
* 26 - Экологический сбор или GreenTax.
|-
|
Name
|
String
|
Название услуги.
|-
|
IsChecked
|
Boolean
|
При значении true указывает,
что данная услуга входит в посчитанную цену.
|-
|
IsEnabled
|
Boolean
|
При значении true указывает, что данная услуга
может быть включена или исключена из стоимости тура, и стоимость может быть
пересчитана повторным вызовом данного метода с использованием параметра selectedResources.
|-
|
GroupId
|
Int32?
|
Идентификатор группы. Группы используются для указания на взаимоисключающие услуги, т.е. набор услуг, только одна из
которых может быть выбрана. Значение поля может быть NULL, в этом случае выбор
услуги никак не связан с другими услугами.
|-
|
Exclude
|
String
|
Список идентификаторов других ресурсов, пересчёт тура с которыми невозможен с использованием данного ресурса. С помощью данного поля, например, устанавливается список подходящих обратных перелётов для каждого перелёта в страну отдыха. Список разделён запятыми.
|}

Структура '''ResourceData''' может включать дополнительные описания для услуг из поля '''Resources'''. Каждый элемент состоит из полей:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Name
|
String
|
Название дополнительного поля с описанием.
|-
|
ResourceId
|
Int32
|
Идентификатор услуги из структуры '''Resources'''.
|-
|
Value
|
String
|
Содержание дополнительного поля с описанием.
|}

Ниже представлена таблица возможных значений поля '''Name''' для каждого типа услуг:

{| class="wikitable"
|-
|
Тип ресурса
|
Значение Name
|
Описание
|-
|
1 (тур)
|
COMMENT
|
Комментарий к туру.
|-
|
1 (тур)
|
DATEBEG
|
Дата начала тура.
|-
|
1 (тур)
|
DATEEND
|
Дата окончания тура.
|-
|
1 (тур)
|
PEOPLE_COUNT
|
Кол-во людей для заселения
(без учёта младенца, если есть)
|-
|
1 (тур)
|
BAGGAGE_INCLUDED
|
Указывает удалось ли получить информацию о багаже от туроператора
|-
|
1 (тур)
|
BAGGAGE_PLACES
|
Кол-во багажных мест
|-
|
1 (тур)
|
BAGGAGE_WEIGHT
|
Указывает допустимый вес багажа (кг)
|-
|
1 (тур)
|
BAGGAGE_SIZE
|
Допустимый размер багажа
|-
|
1 (тур)
|
LUGGAGE_INCLUDED
|
Указывает удалось ли получить информацию о ручной клади от туроператора
|-
|
1 (тур)
|
LUGGAGE_PLACES
|
Кол-во мест ручной клади
|-
|
1 (тур)
|
LUGGAGE_WEIGHT
|
Указывает допустимый вес ручной клади (кг)
|-
|
1 (тур)
|
LUGGAGE_SIZE
|
Допустимый размер ручной клади
|-
|
2
(проживание)
|
URL
|
Ссылка на описание отеля.
|-
|
2
(проживание)
|
RESORT
|
Курорт, в котором расположен
отель.
|-
|
2
(проживание)
|
HTPLACE
|
Размещение в отеле.
|-
|
2
(проживание)
|
ROOM
|
Тип номера.
|-
|
2
(проживание)
|
MEAL
|
Питание в отеле.
|-
|
2
(проживание)
|
CHECKIN
|
Дата заезда.
|-
|
2
(проживание)
|
CHECKOUT
|
Дата выезда.
|-
|
4, 10,
15 (перелёт)
|
FLIGHT
|
Номер рейса.
|-
|
4, 10,
15 (перелёт)
|
FLIGHT_IS_CONCRETE
|
Конкретизация авиаперелета (true - конкретизирован, false - не конкретизирован)
|-
|
4, 10,
15 (перелёт)
|
DATE
|
Дата перелёта.
|-
|
4, 10,
15 (перелёт)
|
START_TIME
|
Время начала перелёта.
|-
|
4, 10,
15 (перелёт)
|
END_TIME
|
Время окончания перелёта.
|-
|
4, 10,
15 (перелёт)
|
AIRPORT_FROM
|
Аэропорт вылета.
|-
|
4, 10,
15 (перелёт)
|
AIRPORT_TO
|
Аэропорт прилёта.
|-
|
4, 10,
15 (перелёт)
|
CLASS
|
Класс перелёта, возможны
значения ECONOM и BUSINESS.
|-
|
14
(комиссия)
|
COMISSION_BASE
|
Базовая комиссия агентства
(%).
|-
|
14
(комиссия)
|
COMISSION_EARLY_ORDER
|
Комиссия за раннее
бронирование (%).
|-
|
14
(комиссия)
|
COMISSION_BONUS
|
Бонус к комиссии (%).
|-
|
14
(комиссия)
|
COMISSION_SUM
|
Сумма комиссии в оригинальной валюте тура (для
туроператоров на основе СамоТур сумма комиссии появляется после пересчёта
цены тура).
|-
|
16
(размещение)
|
PEOPLE_COUNT
|
Кол-во людей в выбранном
размещении.
|-
|
16
(размещение)
|
IS_IN_STOP
|
Есть ли места, 2 –
запрос, 1 – стоп, 0 – есть места.
|-
|
16
(размещение)
|
PRICE
|
Цена размещения.
|-
|
16
(размещение)
|
CURRENCY_ID
|
Системный идентификатор
валюты (5 – рубли, 3 – евро, 2 – доллары).
|-
|
16
(размещение)
|
CURRENCY_NAME
|
Название валюты у
туроператора.
|}

Таблица '''ResourceData''' заполняется данными, если они предоставляются туроператором.

Пример реализации на PHP:

<source lang="php">

$searchParam = array(
"sourceId"=>"Зашифрованный идентификатор туроператора. Выдаётся каждому туру методом GetRequestResult.",
"offerId"=>"Идентификатор ценового предложения. Выдаётся каждому туру методом GetRequestResult.",
"requestId"=> 0,
"login"=> "логин от ЛК ТО",
"password"=>"пароль от ЛК ТО"
);

$soapClient = new SoapClient('https://module.sletat.ru/XmlGate.svc?singlewsdl');
$soapClient->__setSoapHeaders( new SoapHeader("urn:SletatRu:DataTypes:AuthData:v1", "AuthInfo", array(
"Login" => 'Логин в системе Слетать.ру',
"Password"=> 'Пароль в системе Слетать.ру'
)));
$result = $soapClient->ActualizePrice($searchParam);
</source>

Отельная база (xml)

2025-10-27T15:29:06Z

Kdadmin: /* GetHotelComments */

[[Category:Расширения и дополнения]]
== Описание сервиса ==
Отельная база Слетать.ру даёт вам доступ к информации обо всех отелях, представленных в системе поиска Слетать.ру, включая адреса, банки фотографий и отзывы реальных туристов. Это стандартный веб-сервис, предоставляющий WSDL-документ с описанием всех методов и типов данных. Текущая версия сервиса работает только по протоколу HTTP/2 и TLS/1.2. Для большей совместимости с различными клиентами сервис основан на SOAP версии 1.1.

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

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

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

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

{| class="standard"
| style="background-color:silver" |Все описанные ниже методы возвращают информацию только при наличии дополнительной лицензии для доступа к Отельной базе. По всем вопросам обращайтесь в службу поддержки по тел. 8(800)700-33-09 (звонок бесплатный для всех регионов России) или по электронной почте support@sletat.ru.
|}

== Подключение к сервису ==
Чтобы начать работу с сервисом, зарегистрируйтесь на сайте sletat.ru и получите тестовую лицензию в Службе технической поддержки Слетать.ру по электронной почте support@sletat.ru. После получения лицензии можно начинать работать с API. Для работы с сервисом используйте WSDL-документ, расположенный по адресу:

https://module.sletat.ru/XmlGate.svc?singleWSDL

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

=== Клиент на .NET ===

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

<source lang="xml">

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

</source>

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

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

https://module.sletat.ru/Dictionaries.xml

== Методы ==
В этом разделе описаны все методы поискового сервиса. К методам приведены примеры запросов и ответов в SOAP. Все методы требуют авторизации, информация для авторизации (логин и пароль) передаётся в заголовке 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>
<GetHotelComments xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
<hotelId>15523</hotelId>
</GetHotelComments>
</soap:Body>
</soap:Envelope>

</source>

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

=== GetHotelInformation ===

Метод возвращает полную информацию по отелю.Сигнатура:

HotelInformation GetHotelInformation(
Int32 hotelId,
String cssStylesheet)

Параметры:
* '''hotelId''' – идентификатор отеля;
* '''cssStylesheet''' – '''(устаревший параметр)''' URL-адрес внешнего файла CSS, который необходимо подключить на странице с описанием отеля. В текущей версии можно подключить нужный файл таблицы стилей в GET-параметре вызова iframe, например: https://hotels.sletat.ru/hotel_desc/?id=36064&cssStylesheet=http://ya.ru/style.css

В ответ возвращается структура '''HotelInformation''':

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
|
Int32
|
Идентификатор
отеля.
|-
|
Address
|
String
|
Адрес
отеля.
|-
|
AirportDistance
|
Double
|
Расстояние
до аэропорта.
|-
|
Area
|
String
|
Регион,
в котором расположен отель.
|-
|
BuildingDate
|
String
|
Дата
постройки отеля.
|-
|
CityCenterDistance
|
Double
|
Расстояние
от центра города.
|-
|
CountryId
|
Int32
|
Идентификатор
страны, в которой расположен отель.
|-
|
CountryName
|
String
|
Наименование
страны, в которой расположен отель.
|-
|
Description
|
String
|
HTML-код, содержащий iframe с описанием отеля. К коду HTML-страницы внутри iframe подключается таблица стилей, указанная в GET-параметре '''cssStylesheet'''. Пример вызова iframe с указанием файла таблицы стилей: https://hotels.sletat.ru/hotel_desc/?id=36064&cssStylesheet=http://ya.ru/style.css
|-
|
DistanceToLifts
|
String
|
Расстояние
до подъемников.
|-
|
District
|
String
|
Район,
в котором расположен отель.
|-
|
Email
|
String
|
Адрес
электронной почты.
|-
|
Fax
|
String
|
Номер
факса.
|-
|
HotelRate
|
Float
|
Рейтинг
отеля.
|-
|
HouseNumber
|
String
|
Номер
дома, в котором расположен отель.
|-
|
ImageCount
|
Int32
|
Объём
банка фотографий.
|-
|
Latitude
|
Float
|
Широта,
на которой расположен отель.
|-
|
Longitude
|
Float
|
Долгота,
на которой расположен отель.
|-
|
Name
|
String
|
Наименование
отеля.
|-
|
NativeAddress
|
String
|
Адрес
отеля на языке страны, в которой отель расположен.
|-
|
OldCyrillicName
|
String
|
Старое
название кириллицей.
|-
|
OldLatinName
|
String
|
Старое
название латиницей.
|-
|
Phone
|
String
|
Номер
телефона.
|-
|
PostIndex
|
String
|
Почтовый
индекс.
|-
|
RatingMeal
|
Int32
|
Рейтинг
отеля по показателю качества еды.
|-
|
RatingOverall
|
Int32
|
Суммарный
рейтинг отеля.
|-
|
RatingPlace
|
Int32
|
Рейтинг
отеля по его расположению.
|-
|
RatingService
|
Int32
|
Рейтинг
отеля по показателю качества обслуживания.
|-
|
Region
|
String
|
Область,
в которой расположен отель.
|-
|
Renovation
|
String
|
Дата
реконструкции.
|-
|
ResortId
|
Int32
|
Идентификатор
курорта, в котором расположен отель.
|-
|
Resort
|
String
|
Название
курорта, в котором расположен отель.
|-
|
RoomsCount
|
Int32
|
Количество
номеров в отеле.
|-
|
Site
|
String
|
Адрес
вебсайта отеля.
|-
|
Square
|
String
|
Площадь,
занимаемая отелем.
|-
|
StarId
|
Int32
|
Идентификатор
категории отеля из справочника, параметр может быть равен 0, если категория
отеля туроператора не слинкована.
|-
|
StarName
|
String
|
Название
категории отеля из справочника, параметр может иметь пустое значение, если категория
отеля туроператора не слинкована.
|-
|
Street
|
String
|
Название
улицы, на которой расположен отель.
|-
|
Video
|
String
|
Ссылка
на видео об отеле.
|-
|
ImageUrls
|
String[]
|
Массив
строк, в которых указаны URL-адреса всех изображений из банка фотографий отеля
|-
|
HotelFacilities
|
HotelInfoFacilityGroup[]
|
Массив
структур '''HotelInfoFacilityGroup''', содержащих
группы услуг отеля. Структура '''HotelInfoFacilityGroup''' описана ниже.
|-
|
Error
|
Boolean
|
True,
если при поиске отеля произошла ошибка.
|-
|
ErrorDescription
|
String
|
Текстовое
описание ошибки. Например, «Отель не найден в базе данных».
|}

{| class="standard"
| style="background-color:silver" |Внимание! Условия использования API-сервиса запрещают каким-либо образом изменять содержание поля '''Description''', а также размещать данные поля в блоках, доступных для индексирования поисковыми системами. Все авторские права на контент, передаваемый в этом поле, принадлежат Слетать.ру. Согласно Договору, в случае нарушения этого требования все действующие лицензии будут отозваны без возврата стоимости недооказанных услуг.
|}

Описание структуры '''HotelInfoFacilityGroup''':

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
Int32
|
Идентификатор
группы услуг.
|-
|
Name
|
String
|
Наименование
группы услуг.
|-
|
Facilities
|
HotelInfoFacility[]
|
Массив
структур '''HotelInfoFacility''', содержащих услуги отеля в данной группе.
Структура '''HotelInfoFacility''' описана ниже.
|}

Описание структуры '''HotelInfoFacility''':HotelInfoFacilityGroup

{| class="wikitable"
|-
|Поле
|Тип
|Описание
|-
|
Id
|
Int32
|
Идентификатор
услуги.
|-
|
Name
|
String
|
Наименование
услуги.
|-
|
Hit
|
String
|
Дополнительные
сведения об услуге.
|}

Соответствие полей Name и ID отображены в [https://wiki.sletat.ru/images/f/f2/ID_facilities.xlsx файле]

==== Работа с изображениями отелей ====

Для вставки изображений используйте следующий шаблон генерации ссылки:

https://hotels.sletat.ru/i/p/{hotelId}_{imageNumber}_{height}_{width}_{method}.jpg

где:
* hotelId – идентификатор отеля;
* imageNumber – номер изображения;[[Файл:Example.jpg]]
* height – необходимая высота изображения;
* width – необходимая ширина изображения;
* method – метод обработки, имеет всего 2 значения (0 – не сохранять пропорции изображения, сжимать, растягивать под указанный размер; 1 – сохранять пропорции изображения, обрезать под указанный размер)

Если площадь изображения превышает 90 000 px (или если вы хотите получить максимально качественную картинку), необходимо загружать исходное изображение по следующей ссылке:

https://hotels.sletat.ru/i/f/{hotelId}_{imageNumber}.jpg

где '''hotelId''' – идентификатор отеля; '''imageNumber''' – номер изображения.

На всех изображениях, площадь которых превышает 40 000 пикселей (200x200px), автоматически размещается водяной знак. Если у вас активна лицензия на отельную базу, в качестве водяного знака будет размещен адрес вашего сайта (возможно размещение другой строки по согласованию с менеджером). В противном случае будет размещен водяной знак проекта Слетать.ру.

{| class="standard"
| style="background-color:silver" |Внимание! Если вы вставляете на свой сайт теги img и указываете в атрибуте src адреса изображений, созданных по указанным выше шаблонам, вы получите на изображении корректный водяной знак с адресом вашего сайта. Если вы будете загружать изображения программным методом на свои сервера, они будут отданы с водяным знаком проекта Слетать.ру. Это сделано для того, чтобы фотографии отелей использовать только при непосредственном выводе их с сервера https://hotels.sletat.ru.
|}

Пример SOAP-запроса информации об отеле с идентификатором 15523:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetHotelInformation xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
<hotelId>15523</hotelId>
<cssStylesheet i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
</GetHotelInformation>
</s:Body>
</s:Envelope>

</source>

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

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetHotelInformationResponse xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
<GetHotelInformationResult xmlns:a="urn:SletatRu:DataTypes:HotelInformation:v1" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Address i:nil="true"/>
<a:AirportDistance>10</a:AirportDistance>
<a:Area>Red Sea, Sinai</a:Area>
<a:BuildingDate>1987</a:BuildingDate>
<a:CityCenterDistance>2</a:CityCenterDistance>
<a:CountryId>40</a:CountryId>
<a:CountryName>Египет</a:CountryName>
<a:Description><iframe src="https://hotels.sletat.ru/hotel_desc/?id=15523"></iframe></a:Description>
<a:DistanceToLifts i:nil="true"/>
<a:District>Naama Bay</a:District>
<a:Email>ghazala@redseahotels.com</a:Email>
<a:Fax>+20 65 346 31 05</a:Fax>
<a:HotelFacilities xmlns:b="urn:SletatRu:DataTypes:HotelInfoFacilityGroup:v1">
<b:HotelInfoFacilityGroup>
<b:Facilities xmlns:c="urn:SletatRu:DataTypes:HotelInfoFacility:v1">
<c:HotelInfoFacility>
<c:Hit>за доп. плату</c:Hit>
<c:Id>69</c:Id>
<c:Name>Интернет-кафе</c:Name>
</c:HotelInfoFacility>
...
</b:Facilities>
<b:Id>1</b:Id>
<b:Name>Интернет</b:Name>
</b:HotelInfoFacilityGroup>
...
</a:HotelFacilities>
<a:HotelId>15523</a:HotelId>
<a:HotelRate>8.2</a:HotelRate>
<a:HouseNumber i:nil="true"/>
<a:ImageCount>16</a:ImageCount>
<a:ImageUrls xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<b:string>https://hotels.sletat.ru/i/f/15523_0.jpg</b:string>
...
</a:ImageUrls>
<a:Latitude>27.9130287</a:Latitude>
<a:Longitude>34.32538</a:Longitude>
<a:Name>Ghazala Beach</a:Name>
<a:NativeAddress i:nil="true"/>
<a:OldCyrillicName i:nil="true"/>
<a:OldLatinName i:nil="true"/>
<a:Phone>+20 65 346 31 00</a:Phone>
<a:PostIndex i:nil="true"/>
<a:RatingMeal>79</a:RatingMeal>
<a:RatingOverall>82</a:RatingOverall>
<a:RatingPlace>83</a:RatingPlace>
<a:RatingService>82</a:RatingService>
<a:Region i:nil="true"/>
<a:Renovation>2011</a:Renovation>
<a:Resort>Sharm El Sheikh</a:Resort>
<a:RoomsCount>256</a:RoomsCount>
<a:Site>http://redseahotels.com/index.php?id=251</a:Site>
<a:Square>23000</a:Square>
<a:StarId>403</a:StarId>
<a:StarName>4*</a:StarName>
<a:Street i:nil="true"/>
<a:Video i:nil="true"/>
</GetHotelInformationResult>
</GetHotelInformationResponse>
</s:Body>
</s:Envelope>

</source>

=== GetHotelComments ===

Метод '''GetHotelComments''' возвращает отзывы об отеле, оставленные реальными туристами.

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

Сигнатура:

HotelCommentCollection GetHotelComments(
Int32 hotelId)

Параметр '''hotelId''' – идентификатор отеля. В ответ возвращается структура '''HotelCommentCollection''' – коллекция структур типа '''HotelComment''', каждая из которых описывает отдельный отзыв. Описание структуры '''HotelComment''':

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
Int32
|
Идентификатор отзыва.
|-
|
UserName
|
String
|
Имя пользователя.
|-
|
Negative
|
String
|
Отрицательный отзыв.
|-
|
Positive
|
String
|
Положительный отзыв.
|-
|
StartRestFormatted
|
String
|
Дата заезда.
|-
|
EndRestFormatted
|
String
|
Дата выезда.
|-
|
CreateDateFormatted
|
String
|
Дата написания отзыва.
|-
|
SourceKind
|
Int32
|
Источник отзыва. SletatRu = 0, TourPravda = 1, TripAdvisor = 2, TopHotels = 3 и Booking = 4.
|-
|
CityName
|
String
|
Наименование города.
|-
|
WasThere
|
Boolean
|
Был ли в этом месте автор отзыва.
|-
|
IsTourist
|
Boolean
|
Является ли автор отзыва туристом.
|-
|
Rate
|
Int32
|
Оценка по десятибалльной шкале.
|-
|
ShortComment
|
String
|
Короткий комментарий.
|}

{| class="standard"
| style="background-color:silver" |Внимание! Условия использования API-сервиса запрещают каким-либо образом изменять содержание полей '''Positive''' и '''Negative''', а также размещать их данные в блоках, доступных для индексирования поисковыми системами. Все авторские права на контент, передаваемый в этом поле, принадлежат Слетать.ру. Согласно Договору, в случае нарушения этого требования все действующие лицензии будут отозваны без возврата стоимости недооказанных услуг.
|}

Пример SOAP-запроса отзывов об отеле с идентификатором 15523:

<source lang="xml">

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

</source>

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

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetHotelCommentsResponse xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
<GetHotelCommentsResult xmlns:a="urn:SletatRu:DataTypes:HotelCommentCollection:v1" xmlns:i=" http://www.w3.org/2001/XMLSchema-instance" xmlns:b="urn:SletatRu:DataTypes:HotelComment:v1">
<a:HotelComment>
<b:CityName i:nil="true"/>
<b:CreateDateFormatted>25.09.2010</b:CreateDateFormatted>
<b:EndRestFormatted>25.06.2009</b:EndRestFormatted>
<b:Id>-1</b:Id>
<b:IsTourist i:nil="true"/>
<b:Negative/>
<b:Positive>Заход в море - песок, рядом коралловый остров, рыбы плавают прямо у берега. Тихий спокойный очень зеленый отель.</b:Positive>
<b:Rate>8</b:Rate>
<b:ShortComment i:nil="true"/>
<b:StartRestFormatted>15.06.2009</b:StartRestFormatted>
<b:UserName>ryazan</b:UserName>
<b:WasThere i:nil="true"/>
</a:HotelComment>
...
</GetHotelCommentsResult>
</GetHotelCommentsResponse>
</s:Body>
</s:Envelope>

</source>

Отельная база (xml)

2025-10-27T15:28:38Z

Kdadmin: /* GetHotelComments */

[[Category:Расширения и дополнения]]
== Описание сервиса ==
Отельная база Слетать.ру даёт вам доступ к информации обо всех отелях, представленных в системе поиска Слетать.ру, включая адреса, банки фотографий и отзывы реальных туристов. Это стандартный веб-сервис, предоставляющий WSDL-документ с описанием всех методов и типов данных. Текущая версия сервиса работает только по протоколу HTTP/2 и TLS/1.2. Для большей совместимости с различными клиентами сервис основан на SOAP версии 1.1.

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

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

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

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

{| class="standard"
| style="background-color:silver" |Все описанные ниже методы возвращают информацию только при наличии дополнительной лицензии для доступа к Отельной базе. По всем вопросам обращайтесь в службу поддержки по тел. 8(800)700-33-09 (звонок бесплатный для всех регионов России) или по электронной почте support@sletat.ru.
|}

== Подключение к сервису ==
Чтобы начать работу с сервисом, зарегистрируйтесь на сайте sletat.ru и получите тестовую лицензию в Службе технической поддержки Слетать.ру по электронной почте support@sletat.ru. После получения лицензии можно начинать работать с API. Для работы с сервисом используйте WSDL-документ, расположенный по адресу:

https://module.sletat.ru/XmlGate.svc?singleWSDL

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

=== Клиент на .NET ===

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

<source lang="xml">

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

</source>

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

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

https://module.sletat.ru/Dictionaries.xml

== Методы ==
В этом разделе описаны все методы поискового сервиса. К методам приведены примеры запросов и ответов в SOAP. Все методы требуют авторизации, информация для авторизации (логин и пароль) передаётся в заголовке 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>
<GetHotelComments xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
<hotelId>15523</hotelId>
</GetHotelComments>
</soap:Body>
</soap:Envelope>

</source>

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

=== GetHotelInformation ===

Метод возвращает полную информацию по отелю.Сигнатура:

HotelInformation GetHotelInformation(
Int32 hotelId,
String cssStylesheet)

Параметры:
* '''hotelId''' – идентификатор отеля;
* '''cssStylesheet''' – '''(устаревший параметр)''' URL-адрес внешнего файла CSS, который необходимо подключить на странице с описанием отеля. В текущей версии можно подключить нужный файл таблицы стилей в GET-параметре вызова iframe, например: https://hotels.sletat.ru/hotel_desc/?id=36064&cssStylesheet=http://ya.ru/style.css

В ответ возвращается структура '''HotelInformation''':

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
|
Int32
|
Идентификатор
отеля.
|-
|
Address
|
String
|
Адрес
отеля.
|-
|
AirportDistance
|
Double
|
Расстояние
до аэропорта.
|-
|
Area
|
String
|
Регион,
в котором расположен отель.
|-
|
BuildingDate
|
String
|
Дата
постройки отеля.
|-
|
CityCenterDistance
|
Double
|
Расстояние
от центра города.
|-
|
CountryId
|
Int32
|
Идентификатор
страны, в которой расположен отель.
|-
|
CountryName
|
String
|
Наименование
страны, в которой расположен отель.
|-
|
Description
|
String
|
HTML-код, содержащий iframe с описанием отеля. К коду HTML-страницы внутри iframe подключается таблица стилей, указанная в GET-параметре '''cssStylesheet'''. Пример вызова iframe с указанием файла таблицы стилей: https://hotels.sletat.ru/hotel_desc/?id=36064&cssStylesheet=http://ya.ru/style.css
|-
|
DistanceToLifts
|
String
|
Расстояние
до подъемников.
|-
|
District
|
String
|
Район,
в котором расположен отель.
|-
|
Email
|
String
|
Адрес
электронной почты.
|-
|
Fax
|
String
|
Номер
факса.
|-
|
HotelRate
|
Float
|
Рейтинг
отеля.
|-
|
HouseNumber
|
String
|
Номер
дома, в котором расположен отель.
|-
|
ImageCount
|
Int32
|
Объём
банка фотографий.
|-
|
Latitude
|
Float
|
Широта,
на которой расположен отель.
|-
|
Longitude
|
Float
|
Долгота,
на которой расположен отель.
|-
|
Name
|
String
|
Наименование
отеля.
|-
|
NativeAddress
|
String
|
Адрес
отеля на языке страны, в которой отель расположен.
|-
|
OldCyrillicName
|
String
|
Старое
название кириллицей.
|-
|
OldLatinName
|
String
|
Старое
название латиницей.
|-
|
Phone
|
String
|
Номер
телефона.
|-
|
PostIndex
|
String
|
Почтовый
индекс.
|-
|
RatingMeal
|
Int32
|
Рейтинг
отеля по показателю качества еды.
|-
|
RatingOverall
|
Int32
|
Суммарный
рейтинг отеля.
|-
|
RatingPlace
|
Int32
|
Рейтинг
отеля по его расположению.
|-
|
RatingService
|
Int32
|
Рейтинг
отеля по показателю качества обслуживания.
|-
|
Region
|
String
|
Область,
в которой расположен отель.
|-
|
Renovation
|
String
|
Дата
реконструкции.
|-
|
ResortId
|
Int32
|
Идентификатор
курорта, в котором расположен отель.
|-
|
Resort
|
String
|
Название
курорта, в котором расположен отель.
|-
|
RoomsCount
|
Int32
|
Количество
номеров в отеле.
|-
|
Site
|
String
|
Адрес
вебсайта отеля.
|-
|
Square
|
String
|
Площадь,
занимаемая отелем.
|-
|
StarId
|
Int32
|
Идентификатор
категории отеля из справочника, параметр может быть равен 0, если категория
отеля туроператора не слинкована.
|-
|
StarName
|
String
|
Название
категории отеля из справочника, параметр может иметь пустое значение, если категория
отеля туроператора не слинкована.
|-
|
Street
|
String
|
Название
улицы, на которой расположен отель.
|-
|
Video
|
String
|
Ссылка
на видео об отеле.
|-
|
ImageUrls
|
String[]
|
Массив
строк, в которых указаны URL-адреса всех изображений из банка фотографий отеля
|-
|
HotelFacilities
|
HotelInfoFacilityGroup[]
|
Массив
структур '''HotelInfoFacilityGroup''', содержащих
группы услуг отеля. Структура '''HotelInfoFacilityGroup''' описана ниже.
|-
|
Error
|
Boolean
|
True,
если при поиске отеля произошла ошибка.
|-
|
ErrorDescription
|
String
|
Текстовое
описание ошибки. Например, «Отель не найден в базе данных».
|}

{| class="standard"
| style="background-color:silver" |Внимание! Условия использования API-сервиса запрещают каким-либо образом изменять содержание поля '''Description''', а также размещать данные поля в блоках, доступных для индексирования поисковыми системами. Все авторские права на контент, передаваемый в этом поле, принадлежат Слетать.ру. Согласно Договору, в случае нарушения этого требования все действующие лицензии будут отозваны без возврата стоимости недооказанных услуг.
|}

Описание структуры '''HotelInfoFacilityGroup''':

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
Id
|
Int32
|
Идентификатор
группы услуг.
|-
|
Name
|
String
|
Наименование
группы услуг.
|-
|
Facilities
|
HotelInfoFacility[]
|
Массив
структур '''HotelInfoFacility''', содержащих услуги отеля в данной группе.
Структура '''HotelInfoFacility''' описана ниже.
|}

Описание структуры '''HotelInfoFacility''':HotelInfoFacilityGroup

{| class="wikitable"
|-
|Поле
|Тип
|Описание
|-
|
Id
|
Int32
|
Идентификатор
услуги.
|-
|
Name
|
String
|
Наименование
услуги.
|-
|
Hit
|
String
|
Дополнительные
сведения об услуге.
|}

Соответствие полей Name и ID отображены в [https://wiki.sletat.ru/images/f/f2/ID_facilities.xlsx файле]

==== Работа с изображениями отелей ====

Для вставки изображений используйте следующий шаблон генерации ссылки:

https://hotels.sletat.ru/i/p/{hotelId}_{imageNumber}_{height}_{width}_{method}.jpg

где:
* hotelId – идентификатор отеля;
* imageNumber – номер изображения;[[Файл:Example.jpg]]
* height – необходимая высота изображения;
* width – необходимая ширина изображения;
* method – метод обработки, имеет всего 2 значения (0 – не сохранять пропорции изображения, сжимать, растягивать под указанный размер; 1 – сохранять пропорции изображения, обрезать под указанный размер)

Если площадь изображения превышает 90 000 px (или если вы хотите получить максимально качественную картинку), необходимо загружать исходное изображение по следующей ссылке:

https://hotels.sletat.ru/i/f/{hotelId}_{imageNumber}.jpg

где '''hotelId''' – идентификатор отеля; '''imageNumber''' – номер изображения.

На всех изображениях, площадь которых превышает 40 000 пикселей (200x200px), автоматически размещается водяной знак. Если у вас активна лицензия на отельную базу, в качестве водяного знака будет размещен адрес вашего сайта (возможно размещение другой строки по согласованию с менеджером). В противном случае будет размещен водяной знак проекта Слетать.ру.

{| class="standard"
| style="background-color:silver" |Внимание! Если вы вставляете на свой сайт теги img и указываете в атрибуте src адреса изображений, созданных по указанным выше шаблонам, вы получите на изображении корректный водяной знак с адресом вашего сайта. Если вы будете загружать изображения программным методом на свои сервера, они будут отданы с водяным знаком проекта Слетать.ру. Это сделано для того, чтобы фотографии отелей использовать только при непосредственном выводе их с сервера https://hotels.sletat.ru.
|}

Пример SOAP-запроса информации об отеле с идентификатором 15523:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetHotelInformation xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
<hotelId>15523</hotelId>
<cssStylesheet i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
</GetHotelInformation>
</s:Body>
</s:Envelope>

</source>

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

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetHotelInformationResponse xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
<GetHotelInformationResult xmlns:a="urn:SletatRu:DataTypes:HotelInformation:v1" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:Address i:nil="true"/>
<a:AirportDistance>10</a:AirportDistance>
<a:Area>Red Sea, Sinai</a:Area>
<a:BuildingDate>1987</a:BuildingDate>
<a:CityCenterDistance>2</a:CityCenterDistance>
<a:CountryId>40</a:CountryId>
<a:CountryName>Египет</a:CountryName>
<a:Description><iframe src="https://hotels.sletat.ru/hotel_desc/?id=15523"></iframe></a:Description>
<a:DistanceToLifts i:nil="true"/>
<a:District>Naama Bay</a:District>
<a:Email>ghazala@redseahotels.com</a:Email>
<a:Fax>+20 65 346 31 05</a:Fax>
<a:HotelFacilities xmlns:b="urn:SletatRu:DataTypes:HotelInfoFacilityGroup:v1">
<b:HotelInfoFacilityGroup>
<b:Facilities xmlns:c="urn:SletatRu:DataTypes:HotelInfoFacility:v1">
<c:HotelInfoFacility>
<c:Hit>за доп. плату</c:Hit>
<c:Id>69</c:Id>
<c:Name>Интернет-кафе</c:Name>
</c:HotelInfoFacility>
...
</b:Facilities>
<b:Id>1</b:Id>
<b:Name>Интернет</b:Name>
</b:HotelInfoFacilityGroup>
...
</a:HotelFacilities>
<a:HotelId>15523</a:HotelId>
<a:HotelRate>8.2</a:HotelRate>
<a:HouseNumber i:nil="true"/>
<a:ImageCount>16</a:ImageCount>
<a:ImageUrls xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<b:string>https://hotels.sletat.ru/i/f/15523_0.jpg</b:string>
...
</a:ImageUrls>
<a:Latitude>27.9130287</a:Latitude>
<a:Longitude>34.32538</a:Longitude>
<a:Name>Ghazala Beach</a:Name>
<a:NativeAddress i:nil="true"/>
<a:OldCyrillicName i:nil="true"/>
<a:OldLatinName i:nil="true"/>
<a:Phone>+20 65 346 31 00</a:Phone>
<a:PostIndex i:nil="true"/>
<a:RatingMeal>79</a:RatingMeal>
<a:RatingOverall>82</a:RatingOverall>
<a:RatingPlace>83</a:RatingPlace>
<a:RatingService>82</a:RatingService>
<a:Region i:nil="true"/>
<a:Renovation>2011</a:Renovation>
<a:Resort>Sharm El Sheikh</a:Resort>
<a:RoomsCount>256</a:RoomsCount>
<a:Site>http://redseahotels.com/index.php?id=251</a:Site>
<a:Square>23000</a:Square>
<a:StarId>403</a:StarId>
<a:StarName>4*</a:StarName>
<a:Street i:nil="true"/>
<a:Video i:nil="true"/>
</GetHotelInformationResult>
</GetHotelInformationResponse>
</s:Body>
</s:Envelope>

</source>

=== GetHotelComments ===

Метод '''GetHotelComments''' возвращает отзывы об отеле, оставленные реальными туристами.

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

Сигнатура:

HotelCommentCollection GetHotelComments(
Int32 hotelId)

Параметр '''hotelId''' – идентификатор отеля. В ответ возвращается структура '''HotelCommentCollection''' – коллекция структур типа '''HotelComment''', каждая из которых описывает отдельный отзыв. Описание структуры '''HotelComment''':

{| class="wikitable"
|-
|
Поле
|
Тип
|
Описание
|-
|
SourceKind
|
Int32
|
Источник отзыва. SletatRu = 0, TourPravda = 1, TripAdvisor = 2, TopHotels = 3 и Booking = 4.
|-
|
Id
|
Int32
|
Идентификатор отзыва.
|-
|
UserName
|
String
|
Имя пользователя.
|-
|
Negative
|
String
|
Отрицательный отзыв.
|-
|
Positive
|
String
|
Положительный отзыв.
|-
|
StartRestFormatted
|
String
|
Дата заезда.
|-
|
EndRestFormatted
|
String
|
Дата выезда.
|-
|
CreateDateFormatted
|
String
|
Дата написания отзыва.
|-
|
CityName
|
String
|
Наименование города.
|-
|
WasThere
|
Boolean
|
Был ли в этом месте автор отзыва.
|-
|
IsTourist
|
Boolean
|
Является ли автор отзыва туристом.
|-
|
Rate
|
Int32
|
Оценка по десятибалльной шкале.
|-
|
ShortComment
|
String
|
Короткий комментарий.
|}

{| class="standard"
| style="background-color:silver" |Внимание! Условия использования API-сервиса запрещают каким-либо образом изменять содержание полей '''Positive''' и '''Negative''', а также размещать их данные в блоках, доступных для индексирования поисковыми системами. Все авторские права на контент, передаваемый в этом поле, принадлежат Слетать.ру. Согласно Договору, в случае нарушения этого требования все действующие лицензии будут отозваны без возврата стоимости недооказанных услуг.
|}

Пример SOAP-запроса отзывов об отеле с идентификатором 15523:

<source lang="xml">

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

</source>

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

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetHotelCommentsResponse xmlns="urn:SletatRu:Contracts:Soap11Gate:v1">
<GetHotelCommentsResult xmlns:a="urn:SletatRu:DataTypes:HotelCommentCollection:v1" xmlns:i=" http://www.w3.org/2001/XMLSchema-instance" xmlns:b="urn:SletatRu:DataTypes:HotelComment:v1">
<a:HotelComment>
<b:CityName i:nil="true"/>
<b:CreateDateFormatted>25.09.2010</b:CreateDateFormatted>
<b:EndRestFormatted>25.06.2009</b:EndRestFormatted>
<b:Id>-1</b:Id>
<b:IsTourist i:nil="true"/>
<b:Negative/>
<b:Positive>Заход в море - песок, рядом коралловый остров, рыбы плавают прямо у берега. Тихий спокойный очень зеленый отель.</b:Positive>
<b:Rate>8</b:Rate>
<b:ShortComment i:nil="true"/>
<b:StartRestFormatted>15.06.2009</b:StartRestFormatted>
<b:UserName>ryazan</b:UserName>
<b:WasThere i:nil="true"/>
</a:HotelComment>
...
</GetHotelCommentsResult>
</GetHotelCommentsResponse>
</s:Body>
</s:Envelope>

</source>

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

2025-10-20T13:17:48Z

Kdadmin: /* GetTours — Список туров по заданным параметрам */

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

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

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

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

== Подключение к сервису ==
Все методы веб-сервиса располагаются по адресу:

https://module.sletat.ru/Main.svc

Вызов любого метода должен иметь следующий синтаксис:

https://module.sletat.ru/Main.svc/{ИмяМетода}?{параметр1}={значение1}&{параметр2}={значение2}...

Пример вызова:

[http://module.sletat.ru/Main.svc/GetHotels?countryId=40 https://module.sletat.ru/Main.svc/GetHotels?countryId=40]

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

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

Передавать все параметры при вызове не обязательно. Обязательные параметры отмечены звёздочкой (*).

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

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

* '''GetTours''' – создание поискового запроса;
* '''GetLoadState''' – получение данных о статусе загрузки туров для каждого туроператора;
* '''GetTours''' (с указанием параметра requestId и параметра updateResult со значением "1") – возвращает результаты поиска;

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

В ответе первого обращения к '''GetTours''' приходит идентификатор созданного поискового запроса, который в дальнейшем используется для отслеживания состояния поискового запроса методом '''GetLoadState''' и получения результатов поиска повторным обращением к методу '''GetTours '''с указанием requestId и параметра updateResult=1.

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

=== Получение полного набора туров ===
# Создаётся поисковый запрос методом '''GetTours'''. Сохраняется идентификатор запроса, полученный в ответе.
# Создаётся цикл для получения статуса поискового запроса. В цикле вызывается метод '''GetLoadState''' с использованием идентификатора запроса. В итерации цикла обязательно должна быть пауза (рекомендованное минимальное значение – 1,5 секунды). В результате вызова GetLoadState проверяется, все ли туроператоры обработали запрос (т.е. для всех туроператоров поле IsProcessed принимает значение "true"). На ос-нове проверки принимается решение о продолжении цикла или (если все туропера-торы обработали запрос) о переходе к методу получения туров.
# Снова вызывается метод GetTours, но уже с использованием полученного ранее идентификатора и параметра updateResult=1. Метод вернет все найденные туры в рамках поискового запроса.

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

== Методы ==
В этом разделе описаны все методы поискового сервиса. В соответствии с логикой работы сервиса (см. соответствующий раздел) они разделены на три группы:

* Методы получения справочников. При помощи методов этой группы вы можете загрузить списки стран, курортов, городов вылета, отелей, туроператоров и т. д. Обращение к этим методам необходимо на этапе подготовки к формированию поискового запроса.
* Методы загрузки туров. Методы этой группы позволяют провести весь цикл работ с поисковым запросом – от формирования до получения поисковой выдачи.
* Методы работы с заказом. Эти методы позволяют актуализировать данные о туре, получив информацию о перелётах, размерах топливных сборов и других доплат, а также оформить заказ и передать его на сайт sletat.ru для последующего оповещения менеджеров или статистического анализа.

Запрос каждого метода может содержать технический параметр debug, запускающий режим отладки, если передано значение “1”. По умолчанию передаётся значение “0”. Для удобства чтения параметр исключён из примеров запросов.

Ответ каждого из методов содержит поле Data – массив данных, запрашиваемых методов, а также следующие технические поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Поле принимает значение “null”, если значение поля IsError = “false”.
|-
|ExecutionTimeMs
|Int
|Время обработки запроса в миллисекундах.
|-
|IsError
|Bool
|Сообщение об ошибке. Если при обработке запроса произошла ошибка, поле принимает значение “true”; в прот
|}

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

=== Методы получения справочников ===
Наиболее полный справочник доступен по ссылке:
https://module.sletat.ru/Dictionaries.xml

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

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

https://module.sletat.ru/Main.svc/GetDepartCities?

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

Пример ответа (для удобства чтения данные представлены только по трём городам):

<source lang="xml">
{
"GetDepartCitiesResult":
{
"Data":
[
{
"Id":832,
"Name":"Москва",
"Default":true,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
{
"Id":1264,
"Name":"Санкт-Петербург",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1327,
"Name":"Ялта",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
}
],
...
}
}
</source>

В ответ возвращается структура GetDepartCitiesResult.Data – массив данных о городах вылета.

Поля структуры GetDepartCitiesResult.Data:
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор города вылета.
|-
|Name
|Str
|Город вылета..
|-
|Default
|Bool
|
|-
|DescriptionUrl
|Str
|Ссылка на описание города.
|-
|IsPopular
|Bool
|Популярность города вылета. Если город вылета был признан популярным на основе статистики поисковых запросов, сделанных на сайте sletat.ru и сайтах партнёров, поле принимает значение “true”; в противном случае — “false”.
|-
|ParentId
|Int
|Идентификатор родительского города (см. поле ParentId в описании ответа метода GetCities). Поле может иметь значение “null”, если город вылета не имеет родительского города.
|}

==== GetAvailableFeatures — Список услуг отеля ====
Метод GetAvailableFeatures возвращает список доступных услуг отелей в выбранных курортах.

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

https://module.sletat.ru/Main.svc/GetAvailableFeatures?countryId=40&towns=372,1592,1642

Запрашиваются справочники списка услуг отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три типа услуг):

<source lang="xml">
{
"GetAvailableFeaturesResult":
{
"Data": [
{
"Filters": [
{
"Id": 3,
"IsAvailable": true,
"Name": "Песок"
},
{
"Id": 5,
"IsAvailable": true,
"Name": "Каменистый"
},
{
"Id": 6,
"IsAvailable": true,
"Name": "Бетонный"
},
{
"Id": 7,
"IsAvailable": true,
"Name": "Частный"
},
{
"Id": 4,
"IsAvailable": true,
"Name": "Галька"
}
],
"Id": 2,
"Name": "Тип пляжа"
},
{
"Filters": [
{
"Id": 8,
"IsAvailable": true,
"Name": "Частная"
},
{
"Id": 9,
"IsAvailable": true,
"Name": "Общественная"
}
],
"Id": 3,
"Name": "Парковка"
},
{
"Filters": [
{
"Id": 1,
"IsAvailable": true,
"Name": "Есть"
},
{
"Id": 2,
"IsAvailable": true,
"Name": "Бесплатный"
}
],
"Id": 1,
"Name": "Wi-Fi"
},
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

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

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

https://module.sletat.ru/Main.svc/GetCountries?townFromId=1264

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

Запрос имеет единственный параметр townFromId* - целочисленный идентификатор города вылета.

Пример ответа (для удобства чтения представлены только три направления):

<source lang="xml">
{
"GetCountriesResult":
{
"Data":
[
{
"Id":1,
"Name":"Абхазия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
{
"Id":2,
"Name":"Австралия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
...
{
"Id":139,
"Name":"Япония",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
}
],
...
}
}
</source>

В ответ возвращается структура GetCountriesResult.Data – массив данных о направлениях, доступных для указанного города вылета.

Поля структуры GetCountriesResult.Data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор направления.
|-
|Name
|Str
|Направление.
|-
|Alias
|Str
|Текстовый код направления.
|-
|Flags
|Int
|Указатель группы, в которую входит страна (Экзотическая страна, подходит для отдыха на море, является страной шенгенского соглашения).
|-
|HasTickets
|Bool
|Наличие билетов. Если билеты есть в наличии, параметр принимает значение “true”; в противном случае — “false”.
|-
|HotelIsNotInStop
|Bool
|Наличие мест в отеле. Если в отеле есть места, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsProVisa
|Bool
|Требуется ли в страну про-виза. Если в страну требуется про-виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsVisa
|Bool
|Требуется ли в страну виза. Если в страну требуется виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|OriginalName
|Str
|Название страны на латинице.
|-
|Rank
|Int
|Ранг страны (0 — самый высокий).
|-
|TicketsIncluded
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, параметр принимает значение “true”; в противном случае — “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetCities?countryId=40

Запрашивается справочник курортов Египта.

Запрос имеет единственный параметр countryId * - целочисленный идентификатор направления.

Пример ответа (для удобства чтения представлены только три курорта):

<source lang="xml">
{
"GetCitiesResult":
{
"Data":
[
{
"Id":3769,
"Name":"Адабия",
"Default":false,
"DescriptionUrl":"",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":37,
"Name":"Александрия",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Александрия",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1662,
"Name":"Эль Гуна",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Эль-Гуна",
"IsPopular":true,
“ParentId”:null
}
],
…
}
}
</source>

В ответ возвращается структура GetCitiesResult.Data, имеющая следующие поля:

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

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

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

https://module.sletat.ru/Main.svc/GetHotels?countryId=40&towns=1642&stars=404&filter=&all=-1

Запрашивается справочник по 5-звёздочным отелям Шарм-эль-Шейха (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор направления.
|-
|towns
|Int[]
|Идентификаторы городов, разделённые запятыми.
|-
|stars
|Int[]
|Идентификаторы категорий отелей, разделённые запятыми.
|-
|filter
|Str
|Фильтрация по названию отеля.
|-
|all
|Int
|Количество отелей в выдаче. Возможные значения: “-1” – в выдачу попадают все отели; любое положительное целое число – точное количество отелей.
|}

Пример ответа (для удобства чтения представлены данные только по трём отелям)

<source lang="xml">
{
"GetHotelsResult":
{
"Data":
[{
"GetHotelsResult": {
"ErrorMessage": null,
"ExecutionTimeMs": 0,
"IsError": false,
"Data": [
{
"Id": 104202,
"Name": "Acalam Country Club",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 15,
"PopularityLevel": 0,
"Rate": 9.8,
"SearchCount": 53,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
},
{
"Id": 103114,
"Name": "Akua Resort Hotel",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 20,
"PopularityLevel": 0,
"Rate": 8.5,
"SearchCount": 181,
"StarId": 402,
"StarName": "3*",
"TownId": 6571
},
{
"Id": 104198,
"Name": "Al Mare",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 11,
"PopularityLevel": 0,
"Rate": 0,
"SearchCount": 25,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
}
],
...
"Count":94
}
}
</source>

В ответ возвращается структура GetHotelsResult, состоящая из структуры Data – массива данных об отелях, а также поля Count - общего количества отелей в возвращённом справочнике.

Поля структуры Data:

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

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

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

https://module.sletat.ru/Main.svc/GetHotelStars?countryId=40&towns=372,1592,1642

Запрашиваются справочники категорий отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три категории):

<source lang="xml">
{
"GetHotelStarsResult":
{
"Data":
[
{
"Id":401,
"Name":"2*"
},
{
"Id":402,
"Name":"3*"
},
...
{
"Id":410,
"Name":"HV-1"
}
],
...
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

==== GetMeals — Типы питания ====
Метод GetMeals возвращает список типов питания.

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

https://module.sletat.ru/Main.svc/GetMeals?

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

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

<source lang="xml">
{
"GetMealsResult":
{
"Data":
[
{
"Id":115,
"Name":"AI"
},
{
"Id":114,
"Name":"BB"
},
...
{
"Id":116,
"Name":"UAI"
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор типа питания.
|-
|Name
|Str
|Тип питания.
|}

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

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

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

https://module.sletat.ru/Main.svc/GetTourOperators?townFromId=1264&countryId=40

Запрашивается справочник туроператоров, предлагающих туры из Санкт-Петербурга в Египет.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|townFromId *
|Int
|Идентификатор города вылета. См. параметр Enabled в описании ответа.
|-
|countryId *
|Int
|Идентификатор направления. См. параметр Enabled в описании ответа.
|-
|login
|Str
|Логин пользователя Слетать.ру
|-
|password
|Str
|Пароль пользователя Слетать.ру
|-
|userId
|Int
|Идентификатор пользователя. Используется в сервисах Слетать.ру для передачи параметров, установленных пользователем в личном кабинете.
|}

Пример ответа (для удобства чтения представлены данные только по трём туроператорам):

<source lang="xml">
{
"GetTourOperatorsResult":
{
"Data":
[
{
"Id":19,
"Name":"Anex",
"Enabled":true
},
{
"Id":7,
"Name":"Biblio Globus",
"Enabled":true
},
...
{
"Id":17,
"Name":"Южный крест",
"Enabled":false
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|Enabled
|Bool
|Работа по указанной паре townFromId-countryId. Если туропера-тор предлагает туры, поле принимает значение “true”; в против-ном случае – “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetTourDates?dptCityId=1264&countryId=40&resorts=372,1592,1642

Запрашиваются доступные даты туров из Санкт-Петербурга в Шарм-эль-Шейх, Хургаду и Дахаб (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|dptCityId *
|Int
|Идентификатор города вылета.
|-
|countryId *
|Int
|Идентификатор страны
|-
|resorts
|String
|Список идентификаторов курортов, разделённых запятой.
|-
|sources
|String
|Список идентификаторов туроператоро, разделенных запятой.
|-
|login
|String
|Логин пользователя Слетать.ру
|-
|password
|String
|Пароль пользователя Слетать.ру
|-
|target
|String
|Используется для внутренних сервисов Слетать.ру
|}

Пример ответа (для удобства чтения представлены только три даты):

<source lang="xml">
{
"GetTourDatesResult":
{
"Data":
{
"dates":
[
"13.05.2014",
"14.05.2014",
...
"15.05.2014"
]
}
...
}
}
</source>

В ответ возвращается структура GetTourDatesResult.Data, имеющая единственное поле dates – массив доступных дат вылета в строковом отображении.

==== GetSourseAssurances — Фингарантии операторов ====
Метод '''GetSourseAssurances''' возвращают массивы юрлиц по идентификатору туроператора в справочнике Слетать.ру

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|Number
|string
|Номер туроператора в реестре.
|-
|Name
|string
|Полное наименование туроператора
|-
|Site
|string
|Ссылка на сайт туроператора
|-
|NameShort
|string
|Сокращенное наименование
|-
|PhysicalAddress
|string
|Юридический адрес
|-
|PostAddress
|string
|Почтовый адрес
|}

SourceFinSecurityDocument[]

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

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

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|FinSecurityAmount
|int
|Размер финансового обеспечения
|-
|WayToFinSecurity
|string
|Тип документа
|-
|DocumentNumber
|string
|Номер документа в реестре
|-
|DocumentDate
|DateTime
|Дата размещения документа
|-
|DateOfFinSecurityFrom
|DateTime
|Дата начала действия документа
|-
|DateOfFinSecurityTo
|DateTime
|Дата окончания действия документа
|-
|OrgName
|string
|Название организации, предоставившей ТО финансовые гарантии
|-
|OrgAddress
|string
|Юридический адрес организации, предоставившей ТО финансовые гарантии
|-
|OrgPostAddress
|string
|Почтовый адрес организации, предоставившей ТО финансовые гарантии
|}

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

https://module.sletat.ru/Main.svc/GetSourseAssurances?sourceId=7

=== Методы загрузки туров ===
==== GetTours — Список туров по заданным параметрам ====
Метод GetTours используется для создания поискового запроса, а также – если в запросе передаётся параметр requestId и параметр updateResult=1 – для получения результатов поиска по запросу.

Обратите внимание: указание параметров requestId=***&updateResult=1 обязательно для получения результатов поиска. В некоторых случаях повторное обращение к методу GetTours без указания этих параметров также вернет результаты, но их корректность не гарантируется.

Пример запроса (для краткости оставлены только обязательные параметры):

[https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832&countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019&requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1 https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832 &countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019 &requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1]

Запрашиваются туры:
* из Москвы в Турцию;
* по всем отеля;
* на двоих;
* без детей;
* продолжительностью от 3 до 10 ночей;
* с интервалом дат вылета 19.09.19 – 25.09.19;
* с включённым перелётом, гарантированным наличием билетов и мест в отеле;
* на странице выдачи должно располагаться 10 результатов;
* описание отеля должно выводиться в ленте выдачи;
* дополнительно запрашиваются данные о визовых и топливных сборах;
* услуги предоставляемые в отеле;

Параметры запроса:

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

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

{| class="standard sWarning"
|Внимание! Из-за технических ограничений со стороны оператора «Натали Турс», он принимает в одном запросе не больше 5 идентификаторов отелей. При передаче в запросе более 5 идентификаторов отелей к оператору уходят только первые 5, из-за этого в результаты поиска по этому ТО могут попадать не самые дешевые туры.
|}
|-
|s_adults
|Int
|Количество туристов (взрослых). По умолчанию: 2.
|-
|s_kids
|Int
|Количество туристов (детей). По умолчанию: 0.
|-
|s_kids_ages
|Int[]
|Список возрастов детей, разделённых запятыми. Количество значению соответствует значению параметра s_kids. По умолчанию: не задан.
|-
|s_nightsMin
|Int
|Минимальная продолжительность тура, ночей. По умолчанию: 3.
|-
|s_nightsMax
|Int
|Максимальная продолжительность тура, ночей. По умолчанию: 15.
|-
|s_priceMin
|Int
|Минимальная цена. По умолчанию: не задан.
|-
|s_priceMax
|Int
|Максимальная цена. По умолчанию: не задан.
|-
|currencyAlias
|Str
|Валюта параметров s_priceMin и s_PriceMax. Допустимые значения: USD, EUR, RUR, UAH, BYN, KZT. По умолчанию: RUB.
|-
|s_departFrom
|Str
|Начальная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата.
|-
|s_departTo
|Str
|Конечная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата + 7 дней. Допустимый интервал между начальной и конечной датой диапазона — '''45 дней'''.
|-
|visibleOperators
|Str[]
|Список видимых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|hiddenOperators
|Str[]
|Список скрытых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|calcFullPrice
|Bool
|Учитывать топливный сбор. Если в ответе нужно учитывать топливный сбор, параметр передаёт значение “1”; если допускаются цена без учёта топливного сбора – “0”. По умолчанию: “0”.
|-
|s_hotelIsNotInStop
|Str
|Наличие мест в отеле. Если в ответе нужны только отели с местами, параметр передаёт значение “true”; в противном случае – “false”. По умолчанию: “false”.
|-
|s_hasTickets
|Str
|Наличие билетов. Если в ответе нужны только туры с билетами, параметр передаёт значение “true”; если допускаются туры без билетов – “false”. По умолчанию: “false”.
|-
|s_ticketsIncluded
|Str
|Объём турпакета. Если в ответе нужны только туры с включённым перелётом, параметр передаёт значение “true”; если допускаются туры без перелёта – “false”. По умолчанию: “false”.
|-
|features
|Int[]
|Фильтрация данных ответа по услугам курорта. (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filter
|Int
|Фильтрация данных ответа по туроператорам. Возможные значения: “0” — выключено; “1” — включено. Если фильтр включён, используются идентификаторы из параметра f_to_id. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filterToursForType
|Ulong
|filterToursForType - параметр фильтра, который позволяет вывести в ответ определённые туры. 
Например, если вы хотите, чтобы в ответе были только туры с Чартером необходимо передать filterToursForType = 65536. 
Остальные возможные параметры:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

262144 - Туры на транспорте в виде ЖД дороги

524288 - Туры с прямыми перелёты
|-
|f_to_id
|Int[]
|Идентификаторы туроператоров, подлежащих фильтрации. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|fake
|Int
| Демо-выдача. По умолчанию: не задан.
|-
|extend
|Int
|Используется для сайта Слетать.ру
|-
|requestId
|Int
|Идентификатор запроса для получения результатов поиска. По умолчанию: не задан. Обязателен для получения результатов запроса.
|-
|pageSize
|Int
|Количество туров в ленте выдачи на одной странице. По умолчанию: не задан и выводит 20 туров.
|-
|pageNumber
|Int
|Номер страницы в ленте выдачи. По умолчанию: не задан.
|-
|updateResult
|Bool
|Получить свежие цены. Требует обязательной передачи параметра requestId. '''Требует значения "1"''' при повторном обращении к GetTours для получения результатов поиска.
|-
|includeDescriptions
|Bool
|Включить в выдачу описания отеля, типов размещения и питания. Если в ответе нужны описания, параметр передаёт значение “1”; если описания не нужны – “0”.
|-
|economOnly
|Bool
|Показывать туры с перелетом в экономическом классе. Варианты значений: 1 и 0. По умолчанию: не задан.
|-
|excludeToursForType
|Ulong
|excludeToursForType - параметр фильтра, который позволяет исключить из ответа типы туров.
Например, если из результатов поиска надо исключить Промо туры (16384) и туры на Регулярных рейсах (32768): excludeToursForType = 49152.
|-
|userId
|Int
|Используется для сайта Слетать.ру
|-
|includeOilTaxesAndVisa
|Bool
|Топливные и визовые сборы. Если данные нужны в ответе, параметр передаёт значение “true”; если не нужны – “false”. По умолчанию: не задан. Передавать как 1 или 0.
|-
|groupBy
|Str
|Группировка выдачи. Возможные значения:
* "so_checkin_price": Туры будут отсортированы по дате заезда (сначала ближайшие даты) и потом по цене
* "so_price": Туры будут отсортированы по цене
* "all_sortedHotels": Сортировка по умолчанию, туры будут сгруппированы по отелю и отсортированы по цене по возростанию
* "all_sortedHotelsDesc": Туры будут сгруппированы по отелю и отсортированы по цене по убыванию
* "sortedHotels": Туры будут отсортированы по отелю и полной цене (в случае ее недоступности будет использована простая цена) (FullPrice & Price)
* "hotel": Туры будут сгруппированы только по отелю (без сортировки)
* "hotelsPopularity": Туры будут сгруппированы по отелю и отсортированы по убыванию рейтинга
* "special_hotels": Туры для ТОП3
"": По умолчанию, будет проверено состояние поискового запроса если он в процессе то будут запрошены и возвращены результаты для ТОП3 отсортированные по цене, если нет, то будет возвращен пустой массив.
Если параметр не передан, используется сортировка по цене, а максимальное количество туров в выдаче ограничивается тысячей (см. также параметр '''PageSize''').
|-
|}

Пример ответа (для удобства чтения представлены данные в общем виде):

<source lang="xml">
{
"GetToursResult":
{
"Data":
{
"aaData":
[
...
[
"1792097464",
4,
"https://hotels.sletat.ru/?id=120282",
120282,
"",
1334,
"ANTALYA, SIDE TWINGS RESIDENCE HOME (3 ноч.)",
"Twings Residence Home",
"3*",
"Studio Apartment",
"RO",
"DBL",
"22.09.2019",
"25.09.2019",
3,
"30233 RUB",
2,
0,
"TEZ TOUR",
"Сиде",
[
"http://www.tez-tour.com/ru/spb/search.html"
],
"0",
"1",
"1",
"1",
"1",
"1",
"Вс.",
"25.09",
"",
119,
"Турция",
832,
"Москва",
"//static.sletat.ru/images/to/4.png",
"0",
"",
"",
"",
13103,
false,
117,
30233,
"RUB",
5753,
402,
0,
"https://sletat.ru/book/TEZ TOUR/NHwxNzkyMDk3NDY0fDgzMnw1OTIwMDY3MDJ8",
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
"",
"7",
"",
"2",
"-1",
0,
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
402,
0,
"+j0faDzJV6UBHpT16oUO9A==",
"65536",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"Y4I6oFV4RRG6pnjmHab8Pw==",
0,
null,
-1,
false,
"",
"",
30233,
0,
0,
null,
null,
[
17
],
36.7794571,
31.398035,
"",
[
7
],
0.00105993031
]
],
"cacheIsEmpty":false,
"countryCurrencyId":"3",
"hotelDetailedTypes": null,
"hotelFacilitiesData": {
"facilities": [
{
"id": 2,
"name": "Чистка обуви"
},
{
"id": 3,
"name": "Экскурсии"
},
{
"id": 6,
"name": "Частная"
},
{
"id": 8,
"name": "Глажка одежды"
},
{
"id": 9,
"name": "Пункт обмена валюты"
},
"groups": [
{
"id": 2,
"name": "Общие услуги"
},
{
"id": 3,
"name": "Парковка"
},
{
"id": 6,
"name": "Пляжная линия"
},
{
"id": 8,
"name": "Удобства в номерах"
},
{
"id": 9,
"name": "Специальные номера"
},
"hotelFacilities": [
{
"facilities": [
{
"facilityId": 16,
"groupId": 2,
"hit": null
},
{
"facilityId": 24,
"groupId": 8,
"hit": null
},
{
"facilityId": 26,
"groupId": 15,
"hit": null
},
{
"facilityId": 30,
"groupId": 12,
"hit": null
}
"hotelsCount":8,
"iTotalDisplayRecords":105,
"iTotalRecords":105,
"isInTheBasket":0,
"loadState": [
{
"Id": 51,
"Name": "Ambotis Holidays",
"ErrorMessage": null,
"ExecutionTimeMs": 2491,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 53086,
"MinFullPrice": 0,
"MinPrice": 46492,
"OnlineErrorMessage": null,
"RowsCount": 74
},
{
"Id": 171,
"Name": "Amigo S",
"ErrorMessage": null,
"ExecutionTimeMs": 4708,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 50726,
"MinFullPrice": 0,
"MinPrice": 44120,
"OnlineErrorMessage": null,
"RowsCount": 50
}
],
"oilTaxes": [
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Аланья",
null,
34,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Анталья",
null,
72,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Белек",
null,
149,
null,
832,
null,
null
]
},
...
}
}
</source>

В ответ возвращается структура GetToursResult.Data, состоящая из структур:
* aaData – массив записей о турах, каждый элемент которого является массивом данных о туре,
* LoadState (см. описание в «GetLoadState – Статус обработки запроса»);
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visa – массив записей о визовых сборах, применимых к выбранным турам, каждый элемент которого является массивом данных о визовом сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visaRange, включающей в себя единственный параметр visaRange[1] – валюту визового сбора, а также массив записей о диапазоне визовых сборов, каждый элемент которого является массивом данных о минимальном и максимальном визовом сборе, включаемом в стоимость отдельным туроператором.

{| class="standard sWarning"
|Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

Кроме того, структура GetToursResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|cacheIsEmpty
|bool
|Состояние кеша. Принимает значение '''true''', если кеш пуст
|-
|countryCurrencyId
|str
|Идентификатор валюты, используемой в стране
|-
|hotelsCount"
|int
|Количество отелей в выдаче
|-
|iTotalDisplayRecords
|int
|Количество туров в выдаче; Если >2500 возвращаем 2500;
|-
|iTotalRecords"
|int
|iTotalRecords идентично iTotalDisplayRecords
|-
|isInTheBasket
|int
|Технический параметр. Используется только на сайте sletat.ru
|-
|requestId
|Int
|Идентификатор поискового запроса.
|}

Поля структуры aaData:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Int
|Идентификатор цены.
|-
|aaData[1]
|Int
|Шифрованный идентификатор туроператора.
|-
|aaData[2]
|Str
|Ссылка на описание отеля.
|-
|aaData[3]
|Int
|Идентификатор отеля.
|-
|aaData[4]
|Str
|Ссылка на описание курорта.
|-
|aaData[5]
|Int
|Идентификатор курорта.
|-
|aaData[6]
|Str
|Название тура.
|-
|aaData[7]
|Str
|Название отеля.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип комнаты (не размещение).
|-
|aaData[10]
|Str
|Тип питания.
|-
|aaData[11]
|Str
|Тип размещения.
|-
|aaData[12]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[13]
|Str
|Дата прибытия в формате DD.MM.YYYY.
|-
|aaData[14]
|Int
|Продолжительность тура, ночей.
|-
|aaData[15]
|Str
|Стоимость тура с указанием валюты.
|-
|aaData[16]
|Int
|Количество туристов (взрослых).
|-
|aaData[17]
|Int
|Количество туристов (детей).
|-
|aaData[18]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[19]
|Str
|Название курорта.
|-
|aaData[20][0]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[21]
|Bool
|Наличие мест в отеле. Возможные значения: “0” — есть; “1” — нет, “2” — по запросу.
|-
|aaData[22]
|Bool
|Объём турпакета.
|-
|aaData[23]
|Int
|Наличие билетов эконом-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[24]
|Int
|Наличие билетов эконом-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[25]
|Int
|Наличие билетов бизнес-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[26]
|Int
|Наличие билетов бизнес-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[27]
|Str
|День начала тура. Используется только в текстовом представлении. Возможные значения: Пн. Вт. Ср. Чт. Пн. Сб. Вс.
|-
|aaData[28]
|Str
|Дата окончания тура. Используется только в текстовом представлении.
|-
|aaData[29]
|Str
|Ссылка на миниатюрную фотографию отеля.
|-
|aaData[30]
|Int
|Идентификатор направления.
|-
|aaData[31]
|Str
|Название страны.
|-
|aaData[32]
|Int
|Идентификатор города вылета.
|-
|aaData[33]
|Str
|Название города вылета.
|-
|aaData[34]
|Str
|Ссылка на логотип туроператора.
|-
|aaData[35]
|Float
|Рейтинг отеля от 0 до 10.
|-
|aaData[36]
|Str
|Описание типа питания (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[37]
|Str
|Описание типа размещения (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[38]
|Str
|Описание отеля (выдаётся если параметр запроса includeDescriptions = “true”).
|-
|aaData[39]
|Int
|Системный идентификатор типа размещения (поле может быть пустым, если данные не слинкованы).
|-
|aaData[40]
|Bool
|Флаг демо-режима. Если шлюз работает в демо-режиме, поле принимает значение “true”; в противном случае – “false”.
|-
|aaData[41]
|Int
|Системный идентификатор питания (поле может быть пустым, если данные не слинкованы).
|-
|aaData[42]
|Int
|Цена тура в виде числа (без прибавления к строке валюты).
|-
|aaData[43]
|Int
|Валюта полня aaData[42].
|-
|aaData[44]
|Int
|Системный идентификатор типа номера в отеле (поле может быть пустым, если данные не слинкованы).
|-
|aaData[45]
|Int
|Системный идентификатор категории отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[46]
|Int
|Количество фотографий отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[47]
|Str
|Ссылка на личный кабинет туроператора.
|-
|aaData[48]
|Str
|Оригинальное название тура.
|-
|aaData[49]
|Str
|Оригинальное название категории.
|-
|aaData[50]
|Str
|Оригинальное название курорта.
|-
|aaData[51]
|Str
|Оригинальное название питания.
|-
|aaData[52]
|Str
|Оригинальное название размещения.
|-
|aaData[53]
|Str
|Оригинальное название типа номера.
|-
|aaData[54]
|Str
|Количество мест в отеле. Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество мест.
|-
|aaData[55]
|Int
|Количество билетов эконом-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[56]
|Int
|Количество билетов эконом-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[57]
|Int
|Количество билетов бизнес-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[58]
|Int
|Количество билетов бизнес-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[59]
|Int
|Флаг тура с обязательствами; «0» – обычный тур; «1» – тур с обязательствами.
|-
|aaData[60]
|
|Наименование отеля
|-
|aaData[61]
|
|Описание категории отеля
|-
|aaData[62]
|
|Наименование тура
|-
|aaData[63]
|
|Тип питания
|-
|aaData[64]
|
|Тип размещения
|-
|aaData[65]
|
|Тип нормера в отеле
|-
|aaData[66]
|
|Идентификатор категории отеля
|-
|aaData[67]
|
|Тип цены
|-
|aaData[68]
|
|Хеш идентификатор тура в архиве
|-
|aaData[69]
|int
|Признак чартера и регулярного перелета. Поле представляет из себя целочисленное беззнаковое число (ulong). Для регулярного перелета - 32768, для чартерного - 65536.
Все возможные признаки на данный момент следующие:
* None = 0 - нет,
* Recommended = 1 - Рекомендованный тур,
* Instant = 2 - Тур с моментальным подтверждением,
* BestOfffer = 4 - Лучшее предложение,
* EarlyBook = 8 - Тур с ранним бронированием,
* LateBook = 16 - Тур с поздним бронированием,
* Discount = 32 - Тур со скидкой,
* VipOffer = 64 - VIP туры ,
* CreditAvailable = 128 - Доступно в кредит,
* Exclusive = 256 - Эксклюзивный тур,
* GoesWithGifts = 512 - Тур с подарками,
* IsCombined = 1024 - Комбинированный тур,
* ShopTour = 2048 - Шоп тур,
* ExcursionTour = 8192 - Экскурсионный тур,
* PROMO = 16384 - Тур с промо ценой,
* FlightRegular = 32768 - Тур с регулярным перелётом,
* FlightCharter = 65536 - Тур с чартерным перелётом,
* Bus = 131072 - Автобусный тур,
* Railway = 262144 - Ж/д тур,
* Target = 524288- Прямой перелёт
|-
|aaData[70]
|
|(устарело) — CreditMonths
|-
|aaData[71]
|
|(устарело) — CreditMonthlyPay
|-
|aaData[72]
|
|(устарело) — Описание тура
|-
|aaData[73]
|
|(устарело) — Скидка
|-
|aaData[74]
|
|(устарело) — Срок действия скидки
|-
|aaData[75]
|
|(устарело) — Описание скидки
|-
|aaData[76]
|
|(устарело) — ReceivingParty
|-
|aaData[77]
|
|(устарело) — GiftCaption
|-
|aaData[78]
|
|(устарело) — EarlyBookingValidTill
|-
|aaData[79]
|
|Хеш идентификатор тура в кеше
|-
|aaData[80]
|
|(устарело)
|-
|aaData[80]
|
|(устарело)
|-
|aaData[81]
|
|Дата первого обнаружения тура в системе. (Количество минут)
|-
|aaData[82]
|
|(используется для сайта Слетать.ру)
|-
|aaData[83]
|
|(используется для сайта Слетать.ру)
|-
|aaData[84]
|
|(используется для сайта Слетать.ру)
|-
|aaData[85]
|
|(используется для сайта Слетать.ру)
|-
|aaData[86]
|
|Цена тура без скидок и наценок, задаваемых в личном кабинете sletat.ru
|-
|aaData[87]
|
|Пляжная линия
|-
|aaData[88]
|
|
|-
|aaData[89]
|
|Рейтинг отеля на основе данных от TripAdVisor.
|-
|aaData[90]
|
|Количество отзывов в отель от TripAdVisor.
|-
|aaData[91]
|
|Список возможных типов размещения для отеля.
|-
|aaData[92]
|
|Координата расположения отеля - широта
|-
|aaData[93]
|
|Координата расположения отеля - долгота
|-
|aaData[94]
|
|Телефон.
|-
|aaData[95]
|int
|Данное поле представляет собой массив id включенных в тур услуг
Услуги отдаваемые на этапе поиска:

* Insurance = 3, - Страховка
* Transfer = 7, Трансфер от и до аэропорта
* Excursion = 8, Экскурсии
* Visa = 11, Виза в страну
* NoGoGuarantee = 12, страховка от невыезда
* OperatorLiabilityInsurance = 17, - Страхование ответственности ТО
* GuideServices = 18, - Услуги гида
* FuelSurcharge = 20, - Топливный сбор

Чтобы получить услуги отдаваемые при актуализации (все те же что при поиске и плюс описанные ниже), используйте метод актуализации:

* TourInfo = 1, - Информация по туру
* HotelInfo = 2, - Информация по доп отелям в туре (если вдруг тур комбинированный)
* DptTransport = 4, - Информация о транспорте туда
* RtnTransport = 10, - Информация о транспорте обратно
* AdditionalService = 5, Доп услуги
* AdditionalMeal = 6, Доп питание
* Charge = 9, Доп комиссия
* Infant = 13, - Включен в стоимость ребенок до 2ух лет
* Comission = 14, - Комиссия от туроператора (агента за тур)
* MidTransport = 15, - Информация о промежуточном транспорте
* HtPlace = 16, - Тип размещения
* Meal = 19, - Питание
* Avia = 21 - Авиаперелёт
* Railway = 22 - Билеты Ж/Д
* Bus = 23 - Автобусный переезд
* Cruise = 24 - Морское путешествие
|-
|aaData[96]
|float
|Рейтинг популярности отеля
|}

Поля структуры hotelFacilitiesData (передаются, если параметр запроса showHotelFacilities = 1)

{|class="wikitable"
|Поле
|Описание
|-
|"facilities"
|Словарь услуг в отеле.
|-
|"groups"
|Словарь групп услуг.
|-
|"hotelFacilities"
|Массив структур, содержащих id отеля и массив услуг этого отеля c указанием группы, к которой принадлежит услуга.
|}

Поля структуры visa (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|visa[0]
|Int
|Размер сбора.
|-
|visa[1]
|Str
|Валюта поля x[0].
|}

Поля структуры oilTaxes (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|oilTaxes[0]
|Int
|Идентификатор туроператора.
|-
|oilTaxes[1]
|Str
|Дата начала действия топливного сбора.
|-
|oilTaxes[2]
|Str
|Дата окончания действия топливного сбора.
|-
|oilTaxes[3]
|Int
|Размер топливного сбора.
|-
|oilTaxes[4]
|Str
|Валюта поля oilTaxes[3].
|-
|oilTaxes[5]
|Str
|Наименование авиакомпании.
|-
|oilTaxes[6]
|Str
|Наименование принимающей стороны.
|-
|oilTaxes[7]
|Str
|Название курорта.
|-
|oilTaxes[8]
|Str
|Название аэропорта прибытия.
|-
|oilTaxes [9]
|Int
|Идентификатор курорта.
|-
|oilTaxes[10]
|Int
|Номер рейса.
|-
|oilTaxes[11]
|Int
|Идентификатор города отбытия
|-
|oilTaxes[12]
|Int
|Возраст туриста, от которого включается топливный сбор.
|-
|oilTaxes[13]
|Int
|Возраст туриста, до которого включается топливный сбор.
|}

Для получения результатов выдачи методом GetTours используется идентификатор запроса requestId.

==== GetLoadState — Статус обработки запроса ====
Метод GetLoadState возвращает статус обработки запроса для каждого туроператора.

{| class="standard sWarning"
| Внимание! Варианты взаимодействия методов GetTours и GetLoadState описаны в разделе «Логика работы с сервисом».
|}

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

https://module.sletat.ru/Main.svc/GetLoadState?requestId=574187440&userId=

Запрашивается состояние обработки поискового запроса с идентификатором 574187440.

Запрос имеет единственный параметр requestId * - идентификатор поискового запроса, полученный в ответе метода GetTours.

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

<source lang="xml">
{
"GetLoadStateResult":
{
"Data":
[
{
"Id":1919263563,
"Name":"Туроператор #1919263563",
"ErrorMessage":null,
"ExecutionTimeMs":15,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
},
...
{
"Id":1919263596,
"Name":"Туроператор #1919263596",
"ErrorMessage":null,
"ExecutionTimeMs":719,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Шифрованный идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Выводится, если поле IsError принимает значение “true”.
|-
|ExecutionTime Ms
|Int
|Время обработки запроса туроператором в миллисекундах.
|-
|IsCached
|Bool
|Использование кэша. Если данные получены из кэша, поле принимает значение “true”; в противном случае – “false”.
|-
|IsError
|Bool
|Ошибка в поиске. Если при обработке запроса была допущена ошибка, поле принимает значение “true”; в противном случае – “false”.
|-
|IsPersistentCacheUsed
|Bool
|
|-
|IsProcessed
|Bool
|Завершение поиска. Если туроператор завершил обработку запроса, поле принимает значение “true”; в противном случае – “false”.
|-
|IsSkipped
|Bool
|
|-
|IsTimeout
|Bool
|Таймаут. Если обработка запроса завершена по таймауту, поле принимает значение “true”; в противном случае – “false”.
|-
|RowsCount
|Int
|Количество результатов поиска.
|}

=== Методы работы с заказом ===
==== ActualizePrice — Актуализация цены ====
Метод ActualizePrice необходим для актуализации предложений туроператоров. Он проверяет наличие билетов и мест в отеле, топливных и визовых сборов, а также других обязательных доплат и, при наличии, прибавляет их к стоимости тура.

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

https://module.sletat.ru/Main.svc/ActualizePrice?sourceId=970&offerId=1467001328&currencyAlias=RUB&showcase=0&countryId=119&requestId=343658640&detailed=1

Запрашиваются актуальные данные по туру в Турцию с идентификатором 1467001328 от туроператора 970, найденному по запросу 343658640; Указывается параметр detailed=1, чтобы провести актуализацию. Результат возвращается в рублях.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Str
|Идентификатор ценового предложения (тура).
|-
|currencyAlias
|Int
|Валюта. Возможные значения: USD, EUR, RUB, UAH, BYN
|-
|showcase *
|Int
|Включение режима выдачи для горящих туров.
|-
|countryId
|Int
|Идентификатор направления.
|-
|requestId *
|Int
|Идентификатор поискового запроса.
|-
|userId
|
|-
|detailed
|int
|Флаг, который позволяет выполнить актуализацию.
|}

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

<source lang="xml">
{
"ActualizePriceResult": {
"ErrorCode": 0,
"ErrorMessage": null,
"ExecutionTimeMs": 13757,
"IsError": false,
"Data": {
"actualizationSessionId": "c0AxpC6AOU2ua9Jr2IHaFg==",
"buyOnlineAvailabilityStatus": 1,
"data": [
"TURKEY",
"Moscow",
"ISTANBUL",
"MOW-IST(4)_ПРОМО 7_Hotel commission Standard",
"01.06.2025",
"7",
"Raimond Hotel",
"343658640",
"3*",
"Standard With French Bed",
"08.06.2025",
"BB",
"True",
"0",
"1",
"1",
"0",
"0",
"860",
"87711",
"",
"EUR",
"2Взр.",
"RUB",
"970",
"Турплатформа",
"119",
"Турция",
"832",
"Москва",
"1365",
"Стамбул",
"120625",
"Raimond Hotel",
"402",
"3*",
"",
"Standard With French Bed",
"114",
"BB",
"13103",
"DBL",
null,
"/turkey/fatih/raimond_hotel/",
"https://hotels.sletat.ru/i/p/120625_0.jpg",
33,
"/book/Турплатформа/OTcwfDE0NjcwMDEzMjh8ODMyfDM0MzY1ODY0MHw%3d",
"3",
"7.2",
"Завтраки",
"двухместный номер",
"Отель Raimond находится в тихом районе, всего в 10 минутах ходьбы от Голубой мечети. К услугам гостей круглосуточная стойка регистрации и звукоизолированные номера с бесплатным Wi-Fi.\n\nЭлегантно оформленные номера отеля Raimond оснащены телевизором с плоским экраном, кондиционером, сейфом и мини-баром. В собственной ванной комнате предоставляются бесплатные туалетно-косметические принадлежности. В некоторых номерах есть балкон.\n\nВ ресторане отеля ежедневно сервируется завтрак \"шведский стол\". Поблизости работает множество ресторанов и кафе.\n\nДо магазинов Лалели и ресторанов Кумкапы можно дойти пешком.",
"1467001328",
"2",
"0",
"Wb7pVPm82TDPEjqWLoqGAQ==",
"A0E1378CCF687358A0D816750E6862E8",
"",
0,
"5",
false,
false,
false,
false,
"Turkey",
"Moscow",
"/touroperators/tourplatform2",
"49154"
],
"errorMessage": null,
"hotelPlaces": [
{
"description": "Cтандартный типовой номер в отеле",
"id": 13,
"isMain": true,
"name": "Стандартный номер"
}
],
"isBuyOnlineAvailability": true,
"isCompleted": true,
"isDetailedExists": true,
"isError": false,
"isFound": true,
"nextPossibleCommands": null,
"oilTaxes": [
[
0,
null,
null,
"Турплатформа",
null,
"17.03.2025",
"28.02.2026",
null,
null,
null,
null,
null,
null
]
],
"randomNumber": 83120,
"resourceData": [
{
"name": "AIRLINE",
"resourceId": 4020001,
"value": "Southwind"
},
...
],
"resources": [
{
"exclude": "",
"groupId": 2,
"id": 4020001,
"isChecked": true,
"isEnabled": true,
"isGeneratedInternally": false,
"linkGroupsId": 733282017,
"name": "2S 086 Southwind Airlines SVO 01.06.2025 12:35:00 - IST 01.06.2025 17:45:00 Econom",
"surcharge": 0,
"surchargeCurrencyId": 5,
"surchargeCurrencyIdOriginal": 3,
"surchargeOriginal": 0,
"type": 4
},
...
],
"rtbHash": "25843CB000E440B877E1D9713FE024A5",
"specialPromoOffers": [],
"visa": null,
"visaExtendedInfo": []
}
}
}
</source>

В ответ возвращается структура ActualizePriceResult.Data, состоящая из структур:
* data – массив данных о туре;
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе;
* resourceData;
* recources;
* visa – массив записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе;
* visaExtendedInfo – масссив расширенных записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе.

Кроме того, структура ActualizePriceResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|actualizationSessionId
|
|
|-
|errorMessage
|Str
|Текст ошибки. Выводится, если поле isError принимает значение “true”.
|-
|isCompleted
|
|
|-
|isError
|
|Сообщение об ошибке. Если в процессе обработки запроса произошла ошибка, поле принимает значение “true”, в противном случае – “false”.
|-
|isFound
|
|
|-
|nextPossibleCommands
|
|
|-
|randomNumber
|Int
|«Быстрый» номер тура в рамках запроса.
|-
|buyOnlineAvailabilityStatus
|Int
|Показывает статус доступности тура к покупке онлайн
|}

Описание статусов поля buyOnlineAvailabilityStatus:

{| class="wikitable"
|Значение
|Описание
|-
|1
|Доступна оплата без дополнительных условий.
|-
|2
|Оплата недоступна.
|-
|3
|Оператор не поддерживает онлайн оплату.
|-
|4
|Тур продан. Или нет перелётов (при этом ticketIncluded= true) или отеля (при этом hasTicket= true).
|-
|5
|Валюта тура отличная от RUB.
|-
|6
|До отправления меньше 24 ч.
|-
|7
|Тур не найден.
|}

Поля структуры data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Str
|Направление.
|-
|aaData[1]
|Str
|Город вылета.
|-
|aaData[2]
|Str
|Курорт.
|-
|aaData[3]
|Str
|Название программы.
|-
|aaData[4]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[5]
|Int
|Продолжительность тура, ночей.
|-
|aaData[6]
|Str
|Название отеля.
|-
|aaData[7]
|Str
|Не используется.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип номера.
|-
|aaData[10]
|Str
|Зарезервировано.
|-
|aaData[11]
|Str
|Тип питания.
|-
|aaData[12]
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, поле принимает значение “true”, в противном случае – “false”.
|-
|aaData[13]
|Bool
|Наличие мест в отеле. Если отель находится в стопе, поле принимает значение “true”, в противном случае – “false”.
|-
|aaData[14]
|Int
|Билеты эконом-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[15]
|Int
|Билеты эконом-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[16]
|Int
|Билеты бизнес-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[17]
|Int
|Билеты бизнес-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[18]
|Int
|Оригинальная цена (со скидкой и наценкой).
|-
|aaData[19]
|Int
|Цена в запрошенной валюте (со скидкой и наценкой).
|-
|aaData[20]
|Str
|Дополнительное описание тура.
|-
|aaData[21]
|Str
|Валюта полей aaData[18] и aaData[19].
|-
|aaData[22]
|Str
|Тип размещения.
|-
|aaData[23]
|Str
|Системное название валюты.
|-
|aaData[24]
|Int
|Идентификатор туроператора. Получение значения этого поля может быть ограничено лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[25]
|Str
|Наименование туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[26]
|Int
|Идентификатор направления. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[27]
|Str
|Направление. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[28]
|Int
|Идентификатор города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[29]
|Str
|Название города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[30]
|Int
|Идентификатор курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[31]
|Str
|Название курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[32]
|Int
|Идентификатор отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[33]
|Str
|Название отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[34]
|Int
|Идентификатор категории отеля.
|-
|aaData[35]
|Str
|Категория отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[36]
|
|Идентификатор типа номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[37]
|Str
|Тип номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[38]
|Int
|Идентификатор типа питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[39]
|Str
|Тип питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[40]
|Int
|Идентификатор типа размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[41]
|Str
|Тип размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[42]
|Str
|Ссылка на туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[43]
|Str
|Ссылка на сайт отеля.
|-
|aaData[44]
|Str
|Ссылка на первую фотографию отеля.
|-
|aaData[45]
|Int
|Количество доступных фотографий отеля.
|}

Данные о топливных сборах

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|x[0]
|Int
|Размер топливного сбора.
|-
|x[1]
|Str
|Валюта поля x[0].
|-
|x[2]
|Str
|Наименование авиакомпании.
|-
|x[3]
|Int
|Идентификатор туроператора.
|-
|x[4]
|Str
|Курорт.
|-
|x[5]
|Str
|Дата начала действия топливного сбора.
|-
|x[6]
|Str
|Дата окончания действия топливного сбора.
|-
|x[7]
|Str
|Наименование принимающей стороны.
|-
|x[8]
|Str
|Аэропорт прибытия
|-
|x[9]
|Int?
|Номер рейса.
|}

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

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

https://module.sletat.ru/Main.svc/SaveTourOrder?searchRequestId=575366173&offerId=12242442&sourceId=1922198339&user=%D0%98%D0%B2%D0%B0%D0%BD+%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%87+%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9&email=test%40mail.ru&phone=%2B71111111111&info=%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9+%D0%BA%D0%BE%D0%BC%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%80%D0%B8%D0%B9.+%D0%98%D0%B7%D0%B2%D0%B8%D0%BD%D0%B8%D1%82%D0%B5.&countryName=undefined&cityFromName=undefined&currencyAlias=RUB&userId=

Передаются данные о заказе тура #12242442 от туроператора #1922198339, найденного по запросу #575366173: ФИО, телефон, e-mail, комментарий к заказу, город вылета и направление, валюта цены тура (рубли).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|searchRequestId *
|Int
|Идентификатор поискового запроса.
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Int
|Идентификатор ценового предложения (тура).
|-
|user *
|Str
|Имя заказчика.
|-
|email *
|Str
|Электронная почта заказчика.
|-
|phone *
|Str
|Телефон заказчика.
|-
|info
|Str
|Комментарий заказчика.
|-
|countryName *
|Str
|Направление.
|-
|cityFromName *
|Str
|Город вылета.
|-
|currencyAlias *
|Str
|Валюта. Допустимые значения: USD, EUR, RUR, BYN.
|-
|userId
|
|
|}

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

<source lang="xml">
{
"SaveTourOrderResult":
{
"Data":0,
"ErrorMessage":null,
"ExecutionTimeMs":117,
"IsError":false
}
}
</source>

В ответ передаётся структура SaveTourOrderRequest, с пустым массивом Data и полями, возвращающими данными об ошибки (см. описание в разделе «Методы»).

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

2025-10-20T13:17:29Z

Kdadmin: /* GetTours — Список туров по заданным параметрам */

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

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

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

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

== Подключение к сервису ==
Все методы веб-сервиса располагаются по адресу:

https://module.sletat.ru/Main.svc

Вызов любого метода должен иметь следующий синтаксис:

https://module.sletat.ru/Main.svc/{ИмяМетода}?{параметр1}={значение1}&{параметр2}={значение2}...

Пример вызова:

[http://module.sletat.ru/Main.svc/GetHotels?countryId=40 https://module.sletat.ru/Main.svc/GetHotels?countryId=40]

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

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

Передавать все параметры при вызове не обязательно. Обязательные параметры отмечены звёздочкой (*).

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

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

* '''GetTours''' – создание поискового запроса;
* '''GetLoadState''' – получение данных о статусе загрузки туров для каждого туроператора;
* '''GetTours''' (с указанием параметра requestId и параметра updateResult со значением "1") – возвращает результаты поиска;

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

В ответе первого обращения к '''GetTours''' приходит идентификатор созданного поискового запроса, который в дальнейшем используется для отслеживания состояния поискового запроса методом '''GetLoadState''' и получения результатов поиска повторным обращением к методу '''GetTours '''с указанием requestId и параметра updateResult=1.

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

=== Получение полного набора туров ===
# Создаётся поисковый запрос методом '''GetTours'''. Сохраняется идентификатор запроса, полученный в ответе.
# Создаётся цикл для получения статуса поискового запроса. В цикле вызывается метод '''GetLoadState''' с использованием идентификатора запроса. В итерации цикла обязательно должна быть пауза (рекомендованное минимальное значение – 1,5 секунды). В результате вызова GetLoadState проверяется, все ли туроператоры обработали запрос (т.е. для всех туроператоров поле IsProcessed принимает значение "true"). На ос-нове проверки принимается решение о продолжении цикла или (если все туропера-торы обработали запрос) о переходе к методу получения туров.
# Снова вызывается метод GetTours, но уже с использованием полученного ранее идентификатора и параметра updateResult=1. Метод вернет все найденные туры в рамках поискового запроса.

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

== Методы ==
В этом разделе описаны все методы поискового сервиса. В соответствии с логикой работы сервиса (см. соответствующий раздел) они разделены на три группы:

* Методы получения справочников. При помощи методов этой группы вы можете загрузить списки стран, курортов, городов вылета, отелей, туроператоров и т. д. Обращение к этим методам необходимо на этапе подготовки к формированию поискового запроса.
* Методы загрузки туров. Методы этой группы позволяют провести весь цикл работ с поисковым запросом – от формирования до получения поисковой выдачи.
* Методы работы с заказом. Эти методы позволяют актуализировать данные о туре, получив информацию о перелётах, размерах топливных сборов и других доплат, а также оформить заказ и передать его на сайт sletat.ru для последующего оповещения менеджеров или статистического анализа.

Запрос каждого метода может содержать технический параметр debug, запускающий режим отладки, если передано значение “1”. По умолчанию передаётся значение “0”. Для удобства чтения параметр исключён из примеров запросов.

Ответ каждого из методов содержит поле Data – массив данных, запрашиваемых методов, а также следующие технические поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Поле принимает значение “null”, если значение поля IsError = “false”.
|-
|ExecutionTimeMs
|Int
|Время обработки запроса в миллисекундах.
|-
|IsError
|Bool
|Сообщение об ошибке. Если при обработке запроса произошла ошибка, поле принимает значение “true”; в прот
|}

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

=== Методы получения справочников ===
Наиболее полный справочник доступен по ссылке:
https://module.sletat.ru/Dictionaries.xml

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

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

https://module.sletat.ru/Main.svc/GetDepartCities?

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

Пример ответа (для удобства чтения данные представлены только по трём городам):

<source lang="xml">
{
"GetDepartCitiesResult":
{
"Data":
[
{
"Id":832,
"Name":"Москва",
"Default":true,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
{
"Id":1264,
"Name":"Санкт-Петербург",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1327,
"Name":"Ялта",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
}
],
...
}
}
</source>

В ответ возвращается структура GetDepartCitiesResult.Data – массив данных о городах вылета.

Поля структуры GetDepartCitiesResult.Data:
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор города вылета.
|-
|Name
|Str
|Город вылета..
|-
|Default
|Bool
|
|-
|DescriptionUrl
|Str
|Ссылка на описание города.
|-
|IsPopular
|Bool
|Популярность города вылета. Если город вылета был признан популярным на основе статистики поисковых запросов, сделанных на сайте sletat.ru и сайтах партнёров, поле принимает значение “true”; в противном случае — “false”.
|-
|ParentId
|Int
|Идентификатор родительского города (см. поле ParentId в описании ответа метода GetCities). Поле может иметь значение “null”, если город вылета не имеет родительского города.
|}

==== GetAvailableFeatures — Список услуг отеля ====
Метод GetAvailableFeatures возвращает список доступных услуг отелей в выбранных курортах.

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

https://module.sletat.ru/Main.svc/GetAvailableFeatures?countryId=40&towns=372,1592,1642

Запрашиваются справочники списка услуг отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три типа услуг):

<source lang="xml">
{
"GetAvailableFeaturesResult":
{
"Data": [
{
"Filters": [
{
"Id": 3,
"IsAvailable": true,
"Name": "Песок"
},
{
"Id": 5,
"IsAvailable": true,
"Name": "Каменистый"
},
{
"Id": 6,
"IsAvailable": true,
"Name": "Бетонный"
},
{
"Id": 7,
"IsAvailable": true,
"Name": "Частный"
},
{
"Id": 4,
"IsAvailable": true,
"Name": "Галька"
}
],
"Id": 2,
"Name": "Тип пляжа"
},
{
"Filters": [
{
"Id": 8,
"IsAvailable": true,
"Name": "Частная"
},
{
"Id": 9,
"IsAvailable": true,
"Name": "Общественная"
}
],
"Id": 3,
"Name": "Парковка"
},
{
"Filters": [
{
"Id": 1,
"IsAvailable": true,
"Name": "Есть"
},
{
"Id": 2,
"IsAvailable": true,
"Name": "Бесплатный"
}
],
"Id": 1,
"Name": "Wi-Fi"
},
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

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

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

https://module.sletat.ru/Main.svc/GetCountries?townFromId=1264

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

Запрос имеет единственный параметр townFromId* - целочисленный идентификатор города вылета.

Пример ответа (для удобства чтения представлены только три направления):

<source lang="xml">
{
"GetCountriesResult":
{
"Data":
[
{
"Id":1,
"Name":"Абхазия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
{
"Id":2,
"Name":"Австралия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
...
{
"Id":139,
"Name":"Япония",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
}
],
...
}
}
</source>

В ответ возвращается структура GetCountriesResult.Data – массив данных о направлениях, доступных для указанного города вылета.

Поля структуры GetCountriesResult.Data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор направления.
|-
|Name
|Str
|Направление.
|-
|Alias
|Str
|Текстовый код направления.
|-
|Flags
|Int
|Указатель группы, в которую входит страна (Экзотическая страна, подходит для отдыха на море, является страной шенгенского соглашения).
|-
|HasTickets
|Bool
|Наличие билетов. Если билеты есть в наличии, параметр принимает значение “true”; в противном случае — “false”.
|-
|HotelIsNotInStop
|Bool
|Наличие мест в отеле. Если в отеле есть места, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsProVisa
|Bool
|Требуется ли в страну про-виза. Если в страну требуется про-виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsVisa
|Bool
|Требуется ли в страну виза. Если в страну требуется виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|OriginalName
|Str
|Название страны на латинице.
|-
|Rank
|Int
|Ранг страны (0 — самый высокий).
|-
|TicketsIncluded
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, параметр принимает значение “true”; в противном случае — “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetCities?countryId=40

Запрашивается справочник курортов Египта.

Запрос имеет единственный параметр countryId * - целочисленный идентификатор направления.

Пример ответа (для удобства чтения представлены только три курорта):

<source lang="xml">
{
"GetCitiesResult":
{
"Data":
[
{
"Id":3769,
"Name":"Адабия",
"Default":false,
"DescriptionUrl":"",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":37,
"Name":"Александрия",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Александрия",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1662,
"Name":"Эль Гуна",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Эль-Гуна",
"IsPopular":true,
“ParentId”:null
}
],
…
}
}
</source>

В ответ возвращается структура GetCitiesResult.Data, имеющая следующие поля:

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

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

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

https://module.sletat.ru/Main.svc/GetHotels?countryId=40&towns=1642&stars=404&filter=&all=-1

Запрашивается справочник по 5-звёздочным отелям Шарм-эль-Шейха (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор направления.
|-
|towns
|Int[]
|Идентификаторы городов, разделённые запятыми.
|-
|stars
|Int[]
|Идентификаторы категорий отелей, разделённые запятыми.
|-
|filter
|Str
|Фильтрация по названию отеля.
|-
|all
|Int
|Количество отелей в выдаче. Возможные значения: “-1” – в выдачу попадают все отели; любое положительное целое число – точное количество отелей.
|}

Пример ответа (для удобства чтения представлены данные только по трём отелям)

<source lang="xml">
{
"GetHotelsResult":
{
"Data":
[{
"GetHotelsResult": {
"ErrorMessage": null,
"ExecutionTimeMs": 0,
"IsError": false,
"Data": [
{
"Id": 104202,
"Name": "Acalam Country Club",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 15,
"PopularityLevel": 0,
"Rate": 9.8,
"SearchCount": 53,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
},
{
"Id": 103114,
"Name": "Akua Resort Hotel",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 20,
"PopularityLevel": 0,
"Rate": 8.5,
"SearchCount": 181,
"StarId": 402,
"StarName": "3*",
"TownId": 6571
},
{
"Id": 104198,
"Name": "Al Mare",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 11,
"PopularityLevel": 0,
"Rate": 0,
"SearchCount": 25,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
}
],
...
"Count":94
}
}
</source>

В ответ возвращается структура GetHotelsResult, состоящая из структуры Data – массива данных об отелях, а также поля Count - общего количества отелей в возвращённом справочнике.

Поля структуры Data:

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

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

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

https://module.sletat.ru/Main.svc/GetHotelStars?countryId=40&towns=372,1592,1642

Запрашиваются справочники категорий отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три категории):

<source lang="xml">
{
"GetHotelStarsResult":
{
"Data":
[
{
"Id":401,
"Name":"2*"
},
{
"Id":402,
"Name":"3*"
},
...
{
"Id":410,
"Name":"HV-1"
}
],
...
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

==== GetMeals — Типы питания ====
Метод GetMeals возвращает список типов питания.

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

https://module.sletat.ru/Main.svc/GetMeals?

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

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

<source lang="xml">
{
"GetMealsResult":
{
"Data":
[
{
"Id":115,
"Name":"AI"
},
{
"Id":114,
"Name":"BB"
},
...
{
"Id":116,
"Name":"UAI"
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор типа питания.
|-
|Name
|Str
|Тип питания.
|}

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

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

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

https://module.sletat.ru/Main.svc/GetTourOperators?townFromId=1264&countryId=40

Запрашивается справочник туроператоров, предлагающих туры из Санкт-Петербурга в Египет.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|townFromId *
|Int
|Идентификатор города вылета. См. параметр Enabled в описании ответа.
|-
|countryId *
|Int
|Идентификатор направления. См. параметр Enabled в описании ответа.
|-
|login
|Str
|Логин пользователя Слетать.ру
|-
|password
|Str
|Пароль пользователя Слетать.ру
|-
|userId
|Int
|Идентификатор пользователя. Используется в сервисах Слетать.ру для передачи параметров, установленных пользователем в личном кабинете.
|}

Пример ответа (для удобства чтения представлены данные только по трём туроператорам):

<source lang="xml">
{
"GetTourOperatorsResult":
{
"Data":
[
{
"Id":19,
"Name":"Anex",
"Enabled":true
},
{
"Id":7,
"Name":"Biblio Globus",
"Enabled":true
},
...
{
"Id":17,
"Name":"Южный крест",
"Enabled":false
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|Enabled
|Bool
|Работа по указанной паре townFromId-countryId. Если туропера-тор предлагает туры, поле принимает значение “true”; в против-ном случае – “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetTourDates?dptCityId=1264&countryId=40&resorts=372,1592,1642

Запрашиваются доступные даты туров из Санкт-Петербурга в Шарм-эль-Шейх, Хургаду и Дахаб (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|dptCityId *
|Int
|Идентификатор города вылета.
|-
|countryId *
|Int
|Идентификатор страны
|-
|resorts
|String
|Список идентификаторов курортов, разделённых запятой.
|-
|sources
|String
|Список идентификаторов туроператоро, разделенных запятой.
|-
|login
|String
|Логин пользователя Слетать.ру
|-
|password
|String
|Пароль пользователя Слетать.ру
|-
|target
|String
|Используется для внутренних сервисов Слетать.ру
|}

Пример ответа (для удобства чтения представлены только три даты):

<source lang="xml">
{
"GetTourDatesResult":
{
"Data":
{
"dates":
[
"13.05.2014",
"14.05.2014",
...
"15.05.2014"
]
}
...
}
}
</source>

В ответ возвращается структура GetTourDatesResult.Data, имеющая единственное поле dates – массив доступных дат вылета в строковом отображении.

==== GetSourseAssurances — Фингарантии операторов ====
Метод '''GetSourseAssurances''' возвращают массивы юрлиц по идентификатору туроператора в справочнике Слетать.ру

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|Number
|string
|Номер туроператора в реестре.
|-
|Name
|string
|Полное наименование туроператора
|-
|Site
|string
|Ссылка на сайт туроператора
|-
|NameShort
|string
|Сокращенное наименование
|-
|PhysicalAddress
|string
|Юридический адрес
|-
|PostAddress
|string
|Почтовый адрес
|}

SourceFinSecurityDocument[]

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

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

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|FinSecurityAmount
|int
|Размер финансового обеспечения
|-
|WayToFinSecurity
|string
|Тип документа
|-
|DocumentNumber
|string
|Номер документа в реестре
|-
|DocumentDate
|DateTime
|Дата размещения документа
|-
|DateOfFinSecurityFrom
|DateTime
|Дата начала действия документа
|-
|DateOfFinSecurityTo
|DateTime
|Дата окончания действия документа
|-
|OrgName
|string
|Название организации, предоставившей ТО финансовые гарантии
|-
|OrgAddress
|string
|Юридический адрес организации, предоставившей ТО финансовые гарантии
|-
|OrgPostAddress
|string
|Почтовый адрес организации, предоставившей ТО финансовые гарантии
|}

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

https://module.sletat.ru/Main.svc/GetSourseAssurances?sourceId=7

=== Методы загрузки туров ===
==== GetTours — Список туров по заданным параметрам ====
Метод GetTours используется для создания поискового запроса, а также – если в запросе передаётся параметр requestId и параметр updateResult=1 – для получения результатов поиска по запросу.

Обратите внимание: указание параметров requestId=***&updateResult=1 обязательно для получения результатов поиска. В некоторых случаях повторное обращение к методу GetTours без указания этих параметров также вернет результаты, но их корректность не гарантируется.

Пример запроса (для краткости оставлены только обязательные параметры):

[https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832&countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019&requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1 https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832 &countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019 &requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1]

Запрашиваются туры:
* из Москвы в Турцию;
* по всем отеля;
* на двоих;
* без детей;
* продолжительностью от 3 до 10 ночей;
* с интервалом дат вылета 19.09.19 – 25.09.19;
* с включённым перелётом, гарантированным наличием билетов и мест в отеле;
* на странице выдачи должно располагаться 10 результатов;
* описание отеля должно выводиться в ленте выдачи;
* дополнительно запрашиваются данные о визовых и топливных сборах;
* услуги предоставляемые в отеле;

Параметры запроса:

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

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

{| class="standard sWarning"
|Внимание! Из-за технических ограничений со стороны оператора «Натали Турс», он принимает в одном запросе не больше 5 идентификаторов отелей. При передаче в запросе более 5 идентификаторов отелей к оператору уходят только первые 5, из-за этого в результаты поиска по этому ТО могут попадать не самые дешевые туры.
|}
|-
|s_adults
|Int
|Количество туристов (взрослых). По умолчанию: 2.
|-
|s_kids
|Int
|Количество туристов (детей). По умолчанию: 0.
|-
|s_kids_ages
|Int[]
|Список возрастов детей, разделённых запятыми. Количество значению соответствует значению параметра s_kids. По умолчанию: не задан.
|-
|s_nightsMin
|Int
|Минимальная продолжительность тура, ночей. По умолчанию: 3.
|-
|s_nightsMax
|Int
|Максимальная продолжительность тура, ночей. По умолчанию: 15.
|-
|s_priceMin
|Int
|Минимальная цена. По умолчанию: не задан.
|-
|s_priceMax
|Int
|Максимальная цена. По умолчанию: не задан.
|-
|currencyAlias
|Str
|Валюта параметров s_priceMin и s_PriceMax. Допустимые значения: USD, EUR, RUR, UAH, BYN, KZT. По умолчанию: RUB.
|-
|s_departFrom
|Str
|Начальная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата.
|-
|s_departTo
|Str
|Конечная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата + 7 дней. Допустимый интервал между начальной и конечной датой диапазона — '''45 дней'''.
|-
|visibleOperators
|Str[]
|Список видимых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|hiddenOperators
|Str[]
|Список скрытых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|calcFullPrice
|Bool
|Учитывать топливный сбор. Если в ответе нужно учитывать топливный сбор, параметр передаёт значение “1”; если допускаются цена без учёта топливного сбора – “0”. По умолчанию: “0”.
|-
|s_hotelIsNotInStop
|Str
|Наличие мест в отеле. Если в ответе нужны только отели с местами, параметр передаёт значение “true”; в противном случае – “false”. По умолчанию: “false”.
|-
|s_hasTickets
|Str
|Наличие билетов. Если в ответе нужны только туры с билетами, параметр передаёт значение “true”; если допускаются туры без билетов – “false”. По умолчанию: “false”.
|-
|s_ticketsIncluded
|Str
|Объём турпакета. Если в ответе нужны только туры с включённым перелётом, параметр передаёт значение “true”; если допускаются туры без перелёта – “false”. По умолчанию: “false”.
|-
|features
|Int[]
|Фильтрация данных ответа по услугам курорта. (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filter
|Int
|Фильтрация данных ответа по туроператорам. Возможные значения: “0” — выключено; “1” — включено. Если фильтр включён, используются идентификаторы из параметра f_to_id. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filterToursForType
|Ulong
|filterToursForType - параметр фильтра, который позволяет вывести в ответ определённые туры. 
Например, если вы хотите, чтобы в ответе были только туры с Чартером необходимо передать filterToursForType = 65536. 
Остальные возможные параметры
1 – туроператор рекомендует данный тур;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

262144 - Туры на транспорте в виде ЖД дороги

524288 - Туры с прямыми перелёты
|-
|f_to_id
|Int[]
|Идентификаторы туроператоров, подлежащих фильтрации. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|fake
|Int
| Демо-выдача. По умолчанию: не задан.
|-
|extend
|Int
|Используется для сайта Слетать.ру
|-
|requestId
|Int
|Идентификатор запроса для получения результатов поиска. По умолчанию: не задан. Обязателен для получения результатов запроса.
|-
|pageSize
|Int
|Количество туров в ленте выдачи на одной странице. По умолчанию: не задан и выводит 20 туров.
|-
|pageNumber
|Int
|Номер страницы в ленте выдачи. По умолчанию: не задан.
|-
|updateResult
|Bool
|Получить свежие цены. Требует обязательной передачи параметра requestId. '''Требует значения "1"''' при повторном обращении к GetTours для получения результатов поиска.
|-
|includeDescriptions
|Bool
|Включить в выдачу описания отеля, типов размещения и питания. Если в ответе нужны описания, параметр передаёт значение “1”; если описания не нужны – “0”.
|-
|economOnly
|Bool
|Показывать туры с перелетом в экономическом классе. Варианты значений: 1 и 0. По умолчанию: не задан.
|-
|excludeToursForType
|Ulong
|excludeToursForType - параметр фильтра, который позволяет исключить из ответа типы туров.
Например, если из результатов поиска надо исключить Промо туры (16384) и туры на Регулярных рейсах (32768): excludeToursForType = 49152.
|-
|userId
|Int
|Используется для сайта Слетать.ру
|-
|includeOilTaxesAndVisa
|Bool
|Топливные и визовые сборы. Если данные нужны в ответе, параметр передаёт значение “true”; если не нужны – “false”. По умолчанию: не задан. Передавать как 1 или 0.
|-
|groupBy
|Str
|Группировка выдачи. Возможные значения:
* "so_checkin_price": Туры будут отсортированы по дате заезда (сначала ближайшие даты) и потом по цене
* "so_price": Туры будут отсортированы по цене
* "all_sortedHotels": Сортировка по умолчанию, туры будут сгруппированы по отелю и отсортированы по цене по возростанию
* "all_sortedHotelsDesc": Туры будут сгруппированы по отелю и отсортированы по цене по убыванию
* "sortedHotels": Туры будут отсортированы по отелю и полной цене (в случае ее недоступности будет использована простая цена) (FullPrice & Price)
* "hotel": Туры будут сгруппированы только по отелю (без сортировки)
* "hotelsPopularity": Туры будут сгруппированы по отелю и отсортированы по убыванию рейтинга
* "special_hotels": Туры для ТОП3
"": По умолчанию, будет проверено состояние поискового запроса если он в процессе то будут запрошены и возвращены результаты для ТОП3 отсортированные по цене, если нет, то будет возвращен пустой массив.
Если параметр не передан, используется сортировка по цене, а максимальное количество туров в выдаче ограничивается тысячей (см. также параметр '''PageSize''').
|-
|}

Пример ответа (для удобства чтения представлены данные в общем виде):

<source lang="xml">
{
"GetToursResult":
{
"Data":
{
"aaData":
[
...
[
"1792097464",
4,
"https://hotels.sletat.ru/?id=120282",
120282,
"",
1334,
"ANTALYA, SIDE TWINGS RESIDENCE HOME (3 ноч.)",
"Twings Residence Home",
"3*",
"Studio Apartment",
"RO",
"DBL",
"22.09.2019",
"25.09.2019",
3,
"30233 RUB",
2,
0,
"TEZ TOUR",
"Сиде",
[
"http://www.tez-tour.com/ru/spb/search.html"
],
"0",
"1",
"1",
"1",
"1",
"1",
"Вс.",
"25.09",
"",
119,
"Турция",
832,
"Москва",
"//static.sletat.ru/images/to/4.png",
"0",
"",
"",
"",
13103,
false,
117,
30233,
"RUB",
5753,
402,
0,
"https://sletat.ru/book/TEZ TOUR/NHwxNzkyMDk3NDY0fDgzMnw1OTIwMDY3MDJ8",
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
"",
"7",
"",
"2",
"-1",
0,
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
402,
0,
"+j0faDzJV6UBHpT16oUO9A==",
"65536",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"Y4I6oFV4RRG6pnjmHab8Pw==",
0,
null,
-1,
false,
"",
"",
30233,
0,
0,
null,
null,
[
17
],
36.7794571,
31.398035,
"",
[
7
],
0.00105993031
]
],
"cacheIsEmpty":false,
"countryCurrencyId":"3",
"hotelDetailedTypes": null,
"hotelFacilitiesData": {
"facilities": [
{
"id": 2,
"name": "Чистка обуви"
},
{
"id": 3,
"name": "Экскурсии"
},
{
"id": 6,
"name": "Частная"
},
{
"id": 8,
"name": "Глажка одежды"
},
{
"id": 9,
"name": "Пункт обмена валюты"
},
"groups": [
{
"id": 2,
"name": "Общие услуги"
},
{
"id": 3,
"name": "Парковка"
},
{
"id": 6,
"name": "Пляжная линия"
},
{
"id": 8,
"name": "Удобства в номерах"
},
{
"id": 9,
"name": "Специальные номера"
},
"hotelFacilities": [
{
"facilities": [
{
"facilityId": 16,
"groupId": 2,
"hit": null
},
{
"facilityId": 24,
"groupId": 8,
"hit": null
},
{
"facilityId": 26,
"groupId": 15,
"hit": null
},
{
"facilityId": 30,
"groupId": 12,
"hit": null
}
"hotelsCount":8,
"iTotalDisplayRecords":105,
"iTotalRecords":105,
"isInTheBasket":0,
"loadState": [
{
"Id": 51,
"Name": "Ambotis Holidays",
"ErrorMessage": null,
"ExecutionTimeMs": 2491,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 53086,
"MinFullPrice": 0,
"MinPrice": 46492,
"OnlineErrorMessage": null,
"RowsCount": 74
},
{
"Id": 171,
"Name": "Amigo S",
"ErrorMessage": null,
"ExecutionTimeMs": 4708,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 50726,
"MinFullPrice": 0,
"MinPrice": 44120,
"OnlineErrorMessage": null,
"RowsCount": 50
}
],
"oilTaxes": [
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Аланья",
null,
34,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Анталья",
null,
72,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Белек",
null,
149,
null,
832,
null,
null
]
},
...
}
}
</source>

В ответ возвращается структура GetToursResult.Data, состоящая из структур:
* aaData – массив записей о турах, каждый элемент которого является массивом данных о туре,
* LoadState (см. описание в «GetLoadState – Статус обработки запроса»);
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visa – массив записей о визовых сборах, применимых к выбранным турам, каждый элемент которого является массивом данных о визовом сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visaRange, включающей в себя единственный параметр visaRange[1] – валюту визового сбора, а также массив записей о диапазоне визовых сборов, каждый элемент которого является массивом данных о минимальном и максимальном визовом сборе, включаемом в стоимость отдельным туроператором.

{| class="standard sWarning"
|Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

Кроме того, структура GetToursResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|cacheIsEmpty
|bool
|Состояние кеша. Принимает значение '''true''', если кеш пуст
|-
|countryCurrencyId
|str
|Идентификатор валюты, используемой в стране
|-
|hotelsCount"
|int
|Количество отелей в выдаче
|-
|iTotalDisplayRecords
|int
|Количество туров в выдаче; Если >2500 возвращаем 2500;
|-
|iTotalRecords"
|int
|iTotalRecords идентично iTotalDisplayRecords
|-
|isInTheBasket
|int
|Технический параметр. Используется только на сайте sletat.ru
|-
|requestId
|Int
|Идентификатор поискового запроса.
|}

Поля структуры aaData:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Int
|Идентификатор цены.
|-
|aaData[1]
|Int
|Шифрованный идентификатор туроператора.
|-
|aaData[2]
|Str
|Ссылка на описание отеля.
|-
|aaData[3]
|Int
|Идентификатор отеля.
|-
|aaData[4]
|Str
|Ссылка на описание курорта.
|-
|aaData[5]
|Int
|Идентификатор курорта.
|-
|aaData[6]
|Str
|Название тура.
|-
|aaData[7]
|Str
|Название отеля.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип комнаты (не размещение).
|-
|aaData[10]
|Str
|Тип питания.
|-
|aaData[11]
|Str
|Тип размещения.
|-
|aaData[12]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[13]
|Str
|Дата прибытия в формате DD.MM.YYYY.
|-
|aaData[14]
|Int
|Продолжительность тура, ночей.
|-
|aaData[15]
|Str
|Стоимость тура с указанием валюты.
|-
|aaData[16]
|Int
|Количество туристов (взрослых).
|-
|aaData[17]
|Int
|Количество туристов (детей).
|-
|aaData[18]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[19]
|Str
|Название курорта.
|-
|aaData[20][0]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[21]
|Bool
|Наличие мест в отеле. Возможные значения: “0” — есть; “1” — нет, “2” — по запросу.
|-
|aaData[22]
|Bool
|Объём турпакета.
|-
|aaData[23]
|Int
|Наличие билетов эконом-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[24]
|Int
|Наличие билетов эконом-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[25]
|Int
|Наличие билетов бизнес-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[26]
|Int
|Наличие билетов бизнес-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[27]
|Str
|День начала тура. Используется только в текстовом представлении. Возможные значения: Пн. Вт. Ср. Чт. Пн. Сб. Вс.
|-
|aaData[28]
|Str
|Дата окончания тура. Используется только в текстовом представлении.
|-
|aaData[29]
|Str
|Ссылка на миниатюрную фотографию отеля.
|-
|aaData[30]
|Int
|Идентификатор направления.
|-
|aaData[31]
|Str
|Название страны.
|-
|aaData[32]
|Int
|Идентификатор города вылета.
|-
|aaData[33]
|Str
|Название города вылета.
|-
|aaData[34]
|Str
|Ссылка на логотип туроператора.
|-
|aaData[35]
|Float
|Рейтинг отеля от 0 до 10.
|-
|aaData[36]
|Str
|Описание типа питания (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[37]
|Str
|Описание типа размещения (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[38]
|Str
|Описание отеля (выдаётся если параметр запроса includeDescriptions = “true”).
|-
|aaData[39]
|Int
|Системный идентификатор типа размещения (поле может быть пустым, если данные не слинкованы).
|-
|aaData[40]
|Bool
|Флаг демо-режима. Если шлюз работает в демо-режиме, поле принимает значение “true”; в противном случае – “false”.
|-
|aaData[41]
|Int
|Системный идентификатор питания (поле может быть пустым, если данные не слинкованы).
|-
|aaData[42]
|Int
|Цена тура в виде числа (без прибавления к строке валюты).
|-
|aaData[43]
|Int
|Валюта полня aaData[42].
|-
|aaData[44]
|Int
|Системный идентификатор типа номера в отеле (поле может быть пустым, если данные не слинкованы).
|-
|aaData[45]
|Int
|Системный идентификатор категории отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[46]
|Int
|Количество фотографий отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[47]
|Str
|Ссылка на личный кабинет туроператора.
|-
|aaData[48]
|Str
|Оригинальное название тура.
|-
|aaData[49]
|Str
|Оригинальное название категории.
|-
|aaData[50]
|Str
|Оригинальное название курорта.
|-
|aaData[51]
|Str
|Оригинальное название питания.
|-
|aaData[52]
|Str
|Оригинальное название размещения.
|-
|aaData[53]
|Str
|Оригинальное название типа номера.
|-
|aaData[54]
|Str
|Количество мест в отеле. Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество мест.
|-
|aaData[55]
|Int
|Количество билетов эконом-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[56]
|Int
|Количество билетов эконом-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[57]
|Int
|Количество билетов бизнес-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[58]
|Int
|Количество билетов бизнес-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[59]
|Int
|Флаг тура с обязательствами; «0» – обычный тур; «1» – тур с обязательствами.
|-
|aaData[60]
|
|Наименование отеля
|-
|aaData[61]
|
|Описание категории отеля
|-
|aaData[62]
|
|Наименование тура
|-
|aaData[63]
|
|Тип питания
|-
|aaData[64]
|
|Тип размещения
|-
|aaData[65]
|
|Тип нормера в отеле
|-
|aaData[66]
|
|Идентификатор категории отеля
|-
|aaData[67]
|
|Тип цены
|-
|aaData[68]
|
|Хеш идентификатор тура в архиве
|-
|aaData[69]
|int
|Признак чартера и регулярного перелета. Поле представляет из себя целочисленное беззнаковое число (ulong). Для регулярного перелета - 32768, для чартерного - 65536.
Все возможные признаки на данный момент следующие:
* None = 0 - нет,
* Recommended = 1 - Рекомендованный тур,
* Instant = 2 - Тур с моментальным подтверждением,
* BestOfffer = 4 - Лучшее предложение,
* EarlyBook = 8 - Тур с ранним бронированием,
* LateBook = 16 - Тур с поздним бронированием,
* Discount = 32 - Тур со скидкой,
* VipOffer = 64 - VIP туры ,
* CreditAvailable = 128 - Доступно в кредит,
* Exclusive = 256 - Эксклюзивный тур,
* GoesWithGifts = 512 - Тур с подарками,
* IsCombined = 1024 - Комбинированный тур,
* ShopTour = 2048 - Шоп тур,
* ExcursionTour = 8192 - Экскурсионный тур,
* PROMO = 16384 - Тур с промо ценой,
* FlightRegular = 32768 - Тур с регулярным перелётом,
* FlightCharter = 65536 - Тур с чартерным перелётом,
* Bus = 131072 - Автобусный тур,
* Railway = 262144 - Ж/д тур,
* Target = 524288- Прямой перелёт
|-
|aaData[70]
|
|(устарело) — CreditMonths
|-
|aaData[71]
|
|(устарело) — CreditMonthlyPay
|-
|aaData[72]
|
|(устарело) — Описание тура
|-
|aaData[73]
|
|(устарело) — Скидка
|-
|aaData[74]
|
|(устарело) — Срок действия скидки
|-
|aaData[75]
|
|(устарело) — Описание скидки
|-
|aaData[76]
|
|(устарело) — ReceivingParty
|-
|aaData[77]
|
|(устарело) — GiftCaption
|-
|aaData[78]
|
|(устарело) — EarlyBookingValidTill
|-
|aaData[79]
|
|Хеш идентификатор тура в кеше
|-
|aaData[80]
|
|(устарело)
|-
|aaData[80]
|
|(устарело)
|-
|aaData[81]
|
|Дата первого обнаружения тура в системе. (Количество минут)
|-
|aaData[82]
|
|(используется для сайта Слетать.ру)
|-
|aaData[83]
|
|(используется для сайта Слетать.ру)
|-
|aaData[84]
|
|(используется для сайта Слетать.ру)
|-
|aaData[85]
|
|(используется для сайта Слетать.ру)
|-
|aaData[86]
|
|Цена тура без скидок и наценок, задаваемых в личном кабинете sletat.ru
|-
|aaData[87]
|
|Пляжная линия
|-
|aaData[88]
|
|
|-
|aaData[89]
|
|Рейтинг отеля на основе данных от TripAdVisor.
|-
|aaData[90]
|
|Количество отзывов в отель от TripAdVisor.
|-
|aaData[91]
|
|Список возможных типов размещения для отеля.
|-
|aaData[92]
|
|Координата расположения отеля - широта
|-
|aaData[93]
|
|Координата расположения отеля - долгота
|-
|aaData[94]
|
|Телефон.
|-
|aaData[95]
|int
|Данное поле представляет собой массив id включенных в тур услуг
Услуги отдаваемые на этапе поиска:

* Insurance = 3, - Страховка
* Transfer = 7, Трансфер от и до аэропорта
* Excursion = 8, Экскурсии
* Visa = 11, Виза в страну
* NoGoGuarantee = 12, страховка от невыезда
* OperatorLiabilityInsurance = 17, - Страхование ответственности ТО
* GuideServices = 18, - Услуги гида
* FuelSurcharge = 20, - Топливный сбор

Чтобы получить услуги отдаваемые при актуализации (все те же что при поиске и плюс описанные ниже), используйте метод актуализации:

* TourInfo = 1, - Информация по туру
* HotelInfo = 2, - Информация по доп отелям в туре (если вдруг тур комбинированный)
* DptTransport = 4, - Информация о транспорте туда
* RtnTransport = 10, - Информация о транспорте обратно
* AdditionalService = 5, Доп услуги
* AdditionalMeal = 6, Доп питание
* Charge = 9, Доп комиссия
* Infant = 13, - Включен в стоимость ребенок до 2ух лет
* Comission = 14, - Комиссия от туроператора (агента за тур)
* MidTransport = 15, - Информация о промежуточном транспорте
* HtPlace = 16, - Тип размещения
* Meal = 19, - Питание
* Avia = 21 - Авиаперелёт
* Railway = 22 - Билеты Ж/Д
* Bus = 23 - Автобусный переезд
* Cruise = 24 - Морское путешествие
|-
|aaData[96]
|float
|Рейтинг популярности отеля
|}

Поля структуры hotelFacilitiesData (передаются, если параметр запроса showHotelFacilities = 1)

{|class="wikitable"
|Поле
|Описание
|-
|"facilities"
|Словарь услуг в отеле.
|-
|"groups"
|Словарь групп услуг.
|-
|"hotelFacilities"
|Массив структур, содержащих id отеля и массив услуг этого отеля c указанием группы, к которой принадлежит услуга.
|}

Поля структуры visa (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|visa[0]
|Int
|Размер сбора.
|-
|visa[1]
|Str
|Валюта поля x[0].
|}

Поля структуры oilTaxes (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|oilTaxes[0]
|Int
|Идентификатор туроператора.
|-
|oilTaxes[1]
|Str
|Дата начала действия топливного сбора.
|-
|oilTaxes[2]
|Str
|Дата окончания действия топливного сбора.
|-
|oilTaxes[3]
|Int
|Размер топливного сбора.
|-
|oilTaxes[4]
|Str
|Валюта поля oilTaxes[3].
|-
|oilTaxes[5]
|Str
|Наименование авиакомпании.
|-
|oilTaxes[6]
|Str
|Наименование принимающей стороны.
|-
|oilTaxes[7]
|Str
|Название курорта.
|-
|oilTaxes[8]
|Str
|Название аэропорта прибытия.
|-
|oilTaxes [9]
|Int
|Идентификатор курорта.
|-
|oilTaxes[10]
|Int
|Номер рейса.
|-
|oilTaxes[11]
|Int
|Идентификатор города отбытия
|-
|oilTaxes[12]
|Int
|Возраст туриста, от которого включается топливный сбор.
|-
|oilTaxes[13]
|Int
|Возраст туриста, до которого включается топливный сбор.
|}

Для получения результатов выдачи методом GetTours используется идентификатор запроса requestId.

==== GetLoadState — Статус обработки запроса ====
Метод GetLoadState возвращает статус обработки запроса для каждого туроператора.

{| class="standard sWarning"
| Внимание! Варианты взаимодействия методов GetTours и GetLoadState описаны в разделе «Логика работы с сервисом».
|}

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

https://module.sletat.ru/Main.svc/GetLoadState?requestId=574187440&userId=

Запрашивается состояние обработки поискового запроса с идентификатором 574187440.

Запрос имеет единственный параметр requestId * - идентификатор поискового запроса, полученный в ответе метода GetTours.

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

<source lang="xml">
{
"GetLoadStateResult":
{
"Data":
[
{
"Id":1919263563,
"Name":"Туроператор #1919263563",
"ErrorMessage":null,
"ExecutionTimeMs":15,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
},
...
{
"Id":1919263596,
"Name":"Туроператор #1919263596",
"ErrorMessage":null,
"ExecutionTimeMs":719,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Шифрованный идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Выводится, если поле IsError принимает значение “true”.
|-
|ExecutionTime Ms
|Int
|Время обработки запроса туроператором в миллисекундах.
|-
|IsCached
|Bool
|Использование кэша. Если данные получены из кэша, поле принимает значение “true”; в противном случае – “false”.
|-
|IsError
|Bool
|Ошибка в поиске. Если при обработке запроса была допущена ошибка, поле принимает значение “true”; в противном случае – “false”.
|-
|IsPersistentCacheUsed
|Bool
|
|-
|IsProcessed
|Bool
|Завершение поиска. Если туроператор завершил обработку запроса, поле принимает значение “true”; в противном случае – “false”.
|-
|IsSkipped
|Bool
|
|-
|IsTimeout
|Bool
|Таймаут. Если обработка запроса завершена по таймауту, поле принимает значение “true”; в противном случае – “false”.
|-
|RowsCount
|Int
|Количество результатов поиска.
|}

=== Методы работы с заказом ===
==== ActualizePrice — Актуализация цены ====
Метод ActualizePrice необходим для актуализации предложений туроператоров. Он проверяет наличие билетов и мест в отеле, топливных и визовых сборов, а также других обязательных доплат и, при наличии, прибавляет их к стоимости тура.

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

https://module.sletat.ru/Main.svc/ActualizePrice?sourceId=970&offerId=1467001328&currencyAlias=RUB&showcase=0&countryId=119&requestId=343658640&detailed=1

Запрашиваются актуальные данные по туру в Турцию с идентификатором 1467001328 от туроператора 970, найденному по запросу 343658640; Указывается параметр detailed=1, чтобы провести актуализацию. Результат возвращается в рублях.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Str
|Идентификатор ценового предложения (тура).
|-
|currencyAlias
|Int
|Валюта. Возможные значения: USD, EUR, RUB, UAH, BYN
|-
|showcase *
|Int
|Включение режима выдачи для горящих туров.
|-
|countryId
|Int
|Идентификатор направления.
|-
|requestId *
|Int
|Идентификатор поискового запроса.
|-
|userId
|
|-
|detailed
|int
|Флаг, который позволяет выполнить актуализацию.
|}

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

<source lang="xml">
{
"ActualizePriceResult": {
"ErrorCode": 0,
"ErrorMessage": null,
"ExecutionTimeMs": 13757,
"IsError": false,
"Data": {
"actualizationSessionId": "c0AxpC6AOU2ua9Jr2IHaFg==",
"buyOnlineAvailabilityStatus": 1,
"data": [
"TURKEY",
"Moscow",
"ISTANBUL",
"MOW-IST(4)_ПРОМО 7_Hotel commission Standard",
"01.06.2025",
"7",
"Raimond Hotel",
"343658640",
"3*",
"Standard With French Bed",
"08.06.2025",
"BB",
"True",
"0",
"1",
"1",
"0",
"0",
"860",
"87711",
"",
"EUR",
"2Взр.",
"RUB",
"970",
"Турплатформа",
"119",
"Турция",
"832",
"Москва",
"1365",
"Стамбул",
"120625",
"Raimond Hotel",
"402",
"3*",
"",
"Standard With French Bed",
"114",
"BB",
"13103",
"DBL",
null,
"/turkey/fatih/raimond_hotel/",
"https://hotels.sletat.ru/i/p/120625_0.jpg",
33,
"/book/Турплатформа/OTcwfDE0NjcwMDEzMjh8ODMyfDM0MzY1ODY0MHw%3d",
"3",
"7.2",
"Завтраки",
"двухместный номер",
"Отель Raimond находится в тихом районе, всего в 10 минутах ходьбы от Голубой мечети. К услугам гостей круглосуточная стойка регистрации и звукоизолированные номера с бесплатным Wi-Fi.\n\nЭлегантно оформленные номера отеля Raimond оснащены телевизором с плоским экраном, кондиционером, сейфом и мини-баром. В собственной ванной комнате предоставляются бесплатные туалетно-косметические принадлежности. В некоторых номерах есть балкон.\n\nВ ресторане отеля ежедневно сервируется завтрак \"шведский стол\". Поблизости работает множество ресторанов и кафе.\n\nДо магазинов Лалели и ресторанов Кумкапы можно дойти пешком.",
"1467001328",
"2",
"0",
"Wb7pVPm82TDPEjqWLoqGAQ==",
"A0E1378CCF687358A0D816750E6862E8",
"",
0,
"5",
false,
false,
false,
false,
"Turkey",
"Moscow",
"/touroperators/tourplatform2",
"49154"
],
"errorMessage": null,
"hotelPlaces": [
{
"description": "Cтандартный типовой номер в отеле",
"id": 13,
"isMain": true,
"name": "Стандартный номер"
}
],
"isBuyOnlineAvailability": true,
"isCompleted": true,
"isDetailedExists": true,
"isError": false,
"isFound": true,
"nextPossibleCommands": null,
"oilTaxes": [
[
0,
null,
null,
"Турплатформа",
null,
"17.03.2025",
"28.02.2026",
null,
null,
null,
null,
null,
null
]
],
"randomNumber": 83120,
"resourceData": [
{
"name": "AIRLINE",
"resourceId": 4020001,
"value": "Southwind"
},
...
],
"resources": [
{
"exclude": "",
"groupId": 2,
"id": 4020001,
"isChecked": true,
"isEnabled": true,
"isGeneratedInternally": false,
"linkGroupsId": 733282017,
"name": "2S 086 Southwind Airlines SVO 01.06.2025 12:35:00 - IST 01.06.2025 17:45:00 Econom",
"surcharge": 0,
"surchargeCurrencyId": 5,
"surchargeCurrencyIdOriginal": 3,
"surchargeOriginal": 0,
"type": 4
},
...
],
"rtbHash": "25843CB000E440B877E1D9713FE024A5",
"specialPromoOffers": [],
"visa": null,
"visaExtendedInfo": []
}
}
}
</source>

В ответ возвращается структура ActualizePriceResult.Data, состоящая из структур:
* data – массив данных о туре;
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе;
* resourceData;
* recources;
* visa – массив записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе;
* visaExtendedInfo – масссив расширенных записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе.

Кроме того, структура ActualizePriceResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|actualizationSessionId
|
|
|-
|errorMessage
|Str
|Текст ошибки. Выводится, если поле isError принимает значение “true”.
|-
|isCompleted
|
|
|-
|isError
|
|Сообщение об ошибке. Если в процессе обработки запроса произошла ошибка, поле принимает значение “true”, в противном случае – “false”.
|-
|isFound
|
|
|-
|nextPossibleCommands
|
|
|-
|randomNumber
|Int
|«Быстрый» номер тура в рамках запроса.
|-
|buyOnlineAvailabilityStatus
|Int
|Показывает статус доступности тура к покупке онлайн
|}

Описание статусов поля buyOnlineAvailabilityStatus:

{| class="wikitable"
|Значение
|Описание
|-
|1
|Доступна оплата без дополнительных условий.
|-
|2
|Оплата недоступна.
|-
|3
|Оператор не поддерживает онлайн оплату.
|-
|4
|Тур продан. Или нет перелётов (при этом ticketIncluded= true) или отеля (при этом hasTicket= true).
|-
|5
|Валюта тура отличная от RUB.
|-
|6
|До отправления меньше 24 ч.
|-
|7
|Тур не найден.
|}

Поля структуры data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Str
|Направление.
|-
|aaData[1]
|Str
|Город вылета.
|-
|aaData[2]
|Str
|Курорт.
|-
|aaData[3]
|Str
|Название программы.
|-
|aaData[4]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[5]
|Int
|Продолжительность тура, ночей.
|-
|aaData[6]
|Str
|Название отеля.
|-
|aaData[7]
|Str
|Не используется.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип номера.
|-
|aaData[10]
|Str
|Зарезервировано.
|-
|aaData[11]
|Str
|Тип питания.
|-
|aaData[12]
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, поле принимает значение “true”, в противном случае – “false”.
|-
|aaData[13]
|Bool
|Наличие мест в отеле. Если отель находится в стопе, поле принимает значение “true”, в противном случае – “false”.
|-
|aaData[14]
|Int
|Билеты эконом-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[15]
|Int
|Билеты эконом-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[16]
|Int
|Билеты бизнес-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[17]
|Int
|Билеты бизнес-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[18]
|Int
|Оригинальная цена (со скидкой и наценкой).
|-
|aaData[19]
|Int
|Цена в запрошенной валюте (со скидкой и наценкой).
|-
|aaData[20]
|Str
|Дополнительное описание тура.
|-
|aaData[21]
|Str
|Валюта полей aaData[18] и aaData[19].
|-
|aaData[22]
|Str
|Тип размещения.
|-
|aaData[23]
|Str
|Системное название валюты.
|-
|aaData[24]
|Int
|Идентификатор туроператора. Получение значения этого поля может быть ограничено лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[25]
|Str
|Наименование туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[26]
|Int
|Идентификатор направления. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[27]
|Str
|Направление. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[28]
|Int
|Идентификатор города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[29]
|Str
|Название города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[30]
|Int
|Идентификатор курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[31]
|Str
|Название курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[32]
|Int
|Идентификатор отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[33]
|Str
|Название отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[34]
|Int
|Идентификатор категории отеля.
|-
|aaData[35]
|Str
|Категория отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[36]
|
|Идентификатор типа номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[37]
|Str
|Тип номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[38]
|Int
|Идентификатор типа питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[39]
|Str
|Тип питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[40]
|Int
|Идентификатор типа размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[41]
|Str
|Тип размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[42]
|Str
|Ссылка на туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[43]
|Str
|Ссылка на сайт отеля.
|-
|aaData[44]
|Str
|Ссылка на первую фотографию отеля.
|-
|aaData[45]
|Int
|Количество доступных фотографий отеля.
|}

Данные о топливных сборах

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|x[0]
|Int
|Размер топливного сбора.
|-
|x[1]
|Str
|Валюта поля x[0].
|-
|x[2]
|Str
|Наименование авиакомпании.
|-
|x[3]
|Int
|Идентификатор туроператора.
|-
|x[4]
|Str
|Курорт.
|-
|x[5]
|Str
|Дата начала действия топливного сбора.
|-
|x[6]
|Str
|Дата окончания действия топливного сбора.
|-
|x[7]
|Str
|Наименование принимающей стороны.
|-
|x[8]
|Str
|Аэропорт прибытия
|-
|x[9]
|Int?
|Номер рейса.
|}

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

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

https://module.sletat.ru/Main.svc/SaveTourOrder?searchRequestId=575366173&offerId=12242442&sourceId=1922198339&user=%D0%98%D0%B2%D0%B0%D0%BD+%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%87+%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9&email=test%40mail.ru&phone=%2B71111111111&info=%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9+%D0%BA%D0%BE%D0%BC%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%80%D0%B8%D0%B9.+%D0%98%D0%B7%D0%B2%D0%B8%D0%BD%D0%B8%D1%82%D0%B5.&countryName=undefined&cityFromName=undefined&currencyAlias=RUB&userId=

Передаются данные о заказе тура #12242442 от туроператора #1922198339, найденного по запросу #575366173: ФИО, телефон, e-mail, комментарий к заказу, город вылета и направление, валюта цены тура (рубли).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|searchRequestId *
|Int
|Идентификатор поискового запроса.
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Int
|Идентификатор ценового предложения (тура).
|-
|user *
|Str
|Имя заказчика.
|-
|email *
|Str
|Электронная почта заказчика.
|-
|phone *
|Str
|Телефон заказчика.
|-
|info
|Str
|Комментарий заказчика.
|-
|countryName *
|Str
|Направление.
|-
|cityFromName *
|Str
|Город вылета.
|-
|currencyAlias *
|Str
|Валюта. Допустимые значения: USD, EUR, RUR, BYN.
|-
|userId
|
|
|}

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

<source lang="xml">
{
"SaveTourOrderResult":
{
"Data":0,
"ErrorMessage":null,
"ExecutionTimeMs":117,
"IsError":false
}
}
</source>

В ответ передаётся структура SaveTourOrderRequest, с пустым массивом Data и полями, возвращающими данными об ошибки (см. описание в разделе «Методы»).

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

2025-10-20T13:16:49Z

Kdadmin: /* GetRequestResult */

[[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-запроса:
<source lang="xml">
<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 - Туры на транспорте в виде ЖД дороги

524288 - Туры с прямыми перелёты
|-
|
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 & 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 & 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''' – структура, содержащая основную информацию о туре;

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

Пример:

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

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

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

Поля структуры ResourceId

{| 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"
|Параметр BAGGAGE_INCLUDED может иметь значение "true", но если параметр BAGGAGE_PLACES = 0 - то трактовать надо так, что багаж не включен.
|}

=== 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
|
|Идентификатор отеля
|}

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

2025-10-17T07:33:09Z

Kdadmin: /* GetTours — Список туров по заданным параметрам */

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

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

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

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

== Подключение к сервису ==
Все методы веб-сервиса располагаются по адресу:

https://module.sletat.ru/Main.svc

Вызов любого метода должен иметь следующий синтаксис:

https://module.sletat.ru/Main.svc/{ИмяМетода}?{параметр1}={значение1}&{параметр2}={значение2}...

Пример вызова:

[http://module.sletat.ru/Main.svc/GetHotels?countryId=40 https://module.sletat.ru/Main.svc/GetHotels?countryId=40]

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

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

Передавать все параметры при вызове не обязательно. Обязательные параметры отмечены звёздочкой (*).

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

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

* '''GetTours''' – создание поискового запроса;
* '''GetLoadState''' – получение данных о статусе загрузки туров для каждого туроператора;
* '''GetTours''' (с указанием параметра requestId и параметра updateResult со значением "1") – возвращает результаты поиска;

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

В ответе первого обращения к '''GetTours''' приходит идентификатор созданного поискового запроса, который в дальнейшем используется для отслеживания состояния поискового запроса методом '''GetLoadState''' и получения результатов поиска повторным обращением к методу '''GetTours '''с указанием requestId и параметра updateResult=1.

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

=== Получение полного набора туров ===
# Создаётся поисковый запрос методом '''GetTours'''. Сохраняется идентификатор запроса, полученный в ответе.
# Создаётся цикл для получения статуса поискового запроса. В цикле вызывается метод '''GetLoadState''' с использованием идентификатора запроса. В итерации цикла обязательно должна быть пауза (рекомендованное минимальное значение – 1,5 секунды). В результате вызова GetLoadState проверяется, все ли туроператоры обработали запрос (т.е. для всех туроператоров поле IsProcessed принимает значение "true"). На ос-нове проверки принимается решение о продолжении цикла или (если все туропера-торы обработали запрос) о переходе к методу получения туров.
# Снова вызывается метод GetTours, но уже с использованием полученного ранее идентификатора и параметра updateResult=1. Метод вернет все найденные туры в рамках поискового запроса.

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

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

{| class="standard sWarning"
|
Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

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

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

== Методы ==
В этом разделе описаны все методы поискового сервиса. В соответствии с логикой работы сервиса (см. соответствующий раздел) они разделены на три группы:

* Методы получения справочников. При помощи методов этой группы вы можете загрузить списки стран, курортов, городов вылета, отелей, туроператоров и т. д. Обращение к этим методам необходимо на этапе подготовки к формированию поискового запроса.
* Методы загрузки туров. Методы этой группы позволяют провести весь цикл работ с поисковым запросом – от формирования до получения поисковой выдачи.
* Методы работы с заказом. Эти методы позволяют актуализировать данные о туре, получив информацию о перелётах, размерах топливных сборов и других доплат, а также оформить заказ и передать его на сайт sletat.ru для последующего оповещения менеджеров или статистического анализа.

Запрос каждого метода может содержать технический параметр debug, запускающий режим отладки, если передано значение “1”. По умолчанию передаётся значение “0”. Для удобства чтения параметр исключён из примеров запросов.

Ответ каждого из методов содержит поле Data – массив данных, запрашиваемых методов, а также следующие технические поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Поле принимает значение “null”, если значение поля IsError = “false”.
|-
|ExecutionTimeMs
|Int
|Время обработки запроса в миллисекундах.
|-
|IsError
|Bool
|Сообщение об ошибке. Если при обработке запроса произошла ошибка, поле принимает значение “true”; в прот
|}

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

=== Методы получения справочников ===
Наиболее полный справочник доступен по ссылке:
https://module.sletat.ru/Dictionaries.xml

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

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

https://module.sletat.ru/Main.svc/GetDepartCities?

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

Пример ответа (для удобства чтения данные представлены только по трём городам):

<source lang="xml">
{
"GetDepartCitiesResult":
{
"Data":
[
{
"Id":832,
"Name":"Москва",
"Default":true,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
{
"Id":1264,
"Name":"Санкт-Петербург",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1327,
"Name":"Ялта",
"Default":false,
"DescriptionUrl":null,
"IsPopular":false,
"ParentId":null
}
],
...
}
}
</source>

В ответ возвращается структура GetDepartCitiesResult.Data – массив данных о городах вылета.

Поля структуры GetDepartCitiesResult.Data:
{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор города вылета.
|-
|Name
|Str
|Город вылета..
|-
|Default
|Bool
|
|-
|DescriptionUrl
|Str
|Ссылка на описание города.
|-
|IsPopular
|Bool
|Популярность города вылета. Если город вылета был признан популярным на основе статистики поисковых запросов, сделанных на сайте sletat.ru и сайтах партнёров, поле принимает значение “true”; в противном случае — “false”.
|-
|ParentId
|Int
|Идентификатор родительского города (см. поле ParentId в описании ответа метода GetCities). Поле может иметь значение “null”, если город вылета не имеет родительского города.
|}

==== GetAvailableFeatures — Список услуг отеля ====
Метод GetAvailableFeatures возвращает список доступных услуг отелей в выбранных курортах.

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

https://module.sletat.ru/Main.svc/GetAvailableFeatures?countryId=40&towns=372,1592,1642

Запрашиваются справочники списка услуг отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три типа услуг):

<source lang="xml">
{
"GetAvailableFeaturesResult":
{
"Data": [
{
"Filters": [
{
"Id": 3,
"IsAvailable": true,
"Name": "Песок"
},
{
"Id": 5,
"IsAvailable": true,
"Name": "Каменистый"
},
{
"Id": 6,
"IsAvailable": true,
"Name": "Бетонный"
},
{
"Id": 7,
"IsAvailable": true,
"Name": "Частный"
},
{
"Id": 4,
"IsAvailable": true,
"Name": "Галька"
}
],
"Id": 2,
"Name": "Тип пляжа"
},
{
"Filters": [
{
"Id": 8,
"IsAvailable": true,
"Name": "Частная"
},
{
"Id": 9,
"IsAvailable": true,
"Name": "Общественная"
}
],
"Id": 3,
"Name": "Парковка"
},
{
"Filters": [
{
"Id": 1,
"IsAvailable": true,
"Name": "Есть"
},
{
"Id": 2,
"IsAvailable": true,
"Name": "Бесплатный"
}
],
"Id": 1,
"Name": "Wi-Fi"
},
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

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

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

https://module.sletat.ru/Main.svc/GetCountries?townFromId=1264

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

Запрос имеет единственный параметр townFromId* - целочисленный идентификатор города вылета.

Пример ответа (для удобства чтения представлены только три направления):

<source lang="xml">
{
"GetCountriesResult":
{
"Data":
[
{
"Id":1,
"Name":"Абхазия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
{
"Id":2,
"Name":"Австралия",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
},
...
{
"Id":139,
"Name":"Япония",
"Alias":"NIL",
"HasTickets":true,
"HotelIsNotInStop":true,
"Rank":2,
"TicketsIncluded":false
}
],
...
}
}
</source>

В ответ возвращается структура GetCountriesResult.Data – массив данных о направлениях, доступных для указанного города вылета.

Поля структуры GetCountriesResult.Data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор направления.
|-
|Name
|Str
|Направление.
|-
|Alias
|Str
|Текстовый код направления.
|-
|Flags
|Int
|Указатель группы, в которую входит страна (Экзотическая страна, подходит для отдыха на море, является страной шенгенского соглашения).
|-
|HasTickets
|Bool
|Наличие билетов. Если билеты есть в наличии, параметр принимает значение “true”; в противном случае — “false”.
|-
|HotelIsNotInStop
|Bool
|Наличие мест в отеле. Если в отеле есть места, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsProVisa
|Bool
|Требуется ли в страну про-виза. Если в страну требуется про-виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|IsVisa
|Bool
|Требуется ли в страну виза. Если в страну требуется виза, параметр принимает значение “true”; в противном случае — “false”.
|-
|OriginalName
|Str
|Название страны на латинице.
|-
|Rank
|Int
|Ранг страны (0 — самый высокий).
|-
|TicketsIncluded
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, параметр принимает значение “true”; в противном случае — “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetCities?countryId=40

Запрашивается справочник курортов Египта.

Запрос имеет единственный параметр countryId * - целочисленный идентификатор направления.

Пример ответа (для удобства чтения представлены только три курорта):

<source lang="xml">
{
"GetCitiesResult":
{
"Data":
[
{
"Id":3769,
"Name":"Адабия",
"Default":false,
"DescriptionUrl":"",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":37,
"Name":"Александрия",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Александрия",
"IsPopular":false,
"ParentId":null
},
...
{
"Id":1662,
"Name":"Эль Гуна",
"Default":false,
"DescriptionUrl":"http:\/\/tonkosti.ru\/Эль-Гуна",
"IsPopular":true,
“ParentId”:null
}
],
…
}
}
</source>

В ответ возвращается структура GetCitiesResult.Data, имеющая следующие поля:

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

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

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

https://module.sletat.ru/Main.svc/GetHotels?countryId=40&towns=1642&stars=404&filter=&all=-1

Запрашивается справочник по 5-звёздочным отелям Шарм-эль-Шейха (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор направления.
|-
|towns
|Int[]
|Идентификаторы городов, разделённые запятыми.
|-
|stars
|Int[]
|Идентификаторы категорий отелей, разделённые запятыми.
|-
|filter
|Str
|Фильтрация по названию отеля.
|-
|all
|Int
|Количество отелей в выдаче. Возможные значения: “-1” – в выдачу попадают все отели; любое положительное целое число – точное количество отелей.
|}

Пример ответа (для удобства чтения представлены данные только по трём отелям)

<source lang="xml">
{
"GetHotelsResult":
{
"Data":
[{
"GetHotelsResult": {
"ErrorMessage": null,
"ExecutionTimeMs": 0,
"IsError": false,
"Data": [
{
"Id": 104202,
"Name": "Acalam Country Club",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 15,
"PopularityLevel": 0,
"Rate": 9.8,
"SearchCount": 53,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
},
{
"Id": 103114,
"Name": "Akua Resort Hotel",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 20,
"PopularityLevel": 0,
"Rate": 8.5,
"SearchCount": 181,
"StarId": 402,
"StarName": "3*",
"TownId": 6571
},
{
"Id": 104198,
"Name": "Al Mare",
"CommonRate": 0,
"IsInBonusProgram": false,
"PhotosCount": 11,
"PopularityLevel": 0,
"Rate": 0,
"SearchCount": 25,
"StarId": 400,
"StarName": "1*",
"TownId": 1099
}
],
...
"Count":94
}
}
</source>

В ответ возвращается структура GetHotelsResult, состоящая из структуры Data – массива данных об отелях, а также поля Count - общего количества отелей в возвращённом справочнике.

Поля структуры Data:

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

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

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

https://module.sletat.ru/Main.svc/GetHotelStars?countryId=40&towns=372,1592,1642

Запрашиваются справочники категорий отелей для Шарм-эль-Шейха, Хургады и Дахаба (Егиипет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|countryId *
|Int
|Идентификатор страны.
|-
|towns *
|Int[]
|Идентификаторы курортов, разделённые запятой.
|}

Пример ответа (для удобства чтения представлены только три категории):

<source lang="xml">
{
"GetHotelStarsResult":
{
"Data":
[
{
"Id":401,
"Name":"2*"
},
{
"Id":402,
"Name":"3*"
},
...
{
"Id":410,
"Name":"HV-1"
}
],
...
}
}
</source>

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор категории отеля.
|-
|Name
|Str
|Категория отеля.
|}

==== GetMeals — Типы питания ====
Метод GetMeals возвращает список типов питания.

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

https://module.sletat.ru/Main.svc/GetMeals?

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

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

<source lang="xml">
{
"GetMealsResult":
{
"Data":
[
{
"Id":115,
"Name":"AI"
},
{
"Id":114,
"Name":"BB"
},
...
{
"Id":116,
"Name":"UAI"
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор типа питания.
|-
|Name
|Str
|Тип питания.
|}

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

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

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

https://module.sletat.ru/Main.svc/GetTourOperators?townFromId=1264&countryId=40

Запрашивается справочник туроператоров, предлагающих туры из Санкт-Петербурга в Египет.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|townFromId *
|Int
|Идентификатор города вылета. См. параметр Enabled в описании ответа.
|-
|countryId *
|Int
|Идентификатор направления. См. параметр Enabled в описании ответа.
|-
|login
|Str
|Логин пользователя Слетать.ру
|-
|password
|Str
|Пароль пользователя Слетать.ру
|-
|userId
|Int
|Идентификатор пользователя. Используется в сервисах Слетать.ру для передачи параметров, установленных пользователем в личном кабинете.
|}

Пример ответа (для удобства чтения представлены данные только по трём туроператорам):

<source lang="xml">
{
"GetTourOperatorsResult":
{
"Data":
[
{
"Id":19,
"Name":"Anex",
"Enabled":true
},
{
"Id":7,
"Name":"Biblio Globus",
"Enabled":true
},
...
{
"Id":17,
"Name":"Южный крест",
"Enabled":false
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|Enabled
|Bool
|Работа по указанной паре townFromId-countryId. Если туропера-тор предлагает туры, поле принимает значение “true”; в против-ном случае – “false”.
|}

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

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

https://module.sletat.ru/Main.svc/GetTourDates?dptCityId=1264&countryId=40&resorts=372,1592,1642

Запрашиваются доступные даты туров из Санкт-Петербурга в Шарм-эль-Шейх, Хургаду и Дахаб (Египет).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|dptCityId *
|Int
|Идентификатор города вылета.
|-
|countryId *
|Int
|Идентификатор страны
|-
|resorts
|String
|Список идентификаторов курортов, разделённых запятой.
|-
|sources
|String
|Список идентификаторов туроператоро, разделенных запятой.
|-
|login
|String
|Логин пользователя Слетать.ру
|-
|password
|String
|Пароль пользователя Слетать.ру
|-
|target
|String
|Используется для внутренних сервисов Слетать.ру
|}

Пример ответа (для удобства чтения представлены только три даты):

<source lang="xml">
{
"GetTourDatesResult":
{
"Data":
{
"dates":
[
"13.05.2014",
"14.05.2014",
...
"15.05.2014"
]
}
...
}
}
</source>

В ответ возвращается структура GetTourDatesResult.Data, имеющая единственное поле dates – массив доступных дат вылета в строковом отображении.

==== GetSourseAssurances — Фингарантии операторов ====
Метод '''GetSourseAssurances''' возвращают массивы юрлиц по идентификатору туроператора в справочнике Слетать.ру

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|Number
|string
|Номер туроператора в реестре.
|-
|Name
|string
|Полное наименование туроператора
|-
|Site
|string
|Ссылка на сайт туроператора
|-
|NameShort
|string
|Сокращенное наименование
|-
|PhysicalAddress
|string
|Юридический адрес
|-
|PostAddress
|string
|Почтовый адрес
|}

SourceFinSecurityDocument[]

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

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

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|FinSecurityAmount
|int
|Размер финансового обеспечения
|-
|WayToFinSecurity
|string
|Тип документа
|-
|DocumentNumber
|string
|Номер документа в реестре
|-
|DocumentDate
|DateTime
|Дата размещения документа
|-
|DateOfFinSecurityFrom
|DateTime
|Дата начала действия документа
|-
|DateOfFinSecurityTo
|DateTime
|Дата окончания действия документа
|-
|OrgName
|string
|Название организации, предоставившей ТО финансовые гарантии
|-
|OrgAddress
|string
|Юридический адрес организации, предоставившей ТО финансовые гарантии
|-
|OrgPostAddress
|string
|Почтовый адрес организации, предоставившей ТО финансовые гарантии
|}

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

https://module.sletat.ru/Main.svc/GetSourseAssurances?sourceId=7

=== Методы загрузки туров ===
==== GetTours — Список туров по заданным параметрам ====
Метод GetTours используется для создания поискового запроса, а также – если в запросе передаётся параметр requestId и параметр updateResult=1 – для получения результатов поиска по запросу.

Обратите внимание: указание параметров requestId=***&updateResult=1 обязательно для получения результатов поиска. В некоторых случаях повторное обращение к методу GetTours без указания этих параметров также вернет результаты, но их корректность не гарантируется.

Пример запроса (для краткости оставлены только обязательные параметры):

[https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832&countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019&requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1 https://module.sletat.ru/Main.svc/GetTours?login=xxx&password=xxx&s_hasTickets=true&currencyAlias=RUB&s_ticketsIncluded=true&includeOilTaxesAndVisa=1&cityFromId=832 &countryId=119&s_adults=2&s_nightsMin=3&s_nightsMax=10&s_departFrom=19/09/2019&s_departTo=25/09/2019 &requestId=0&pageSize=10&pageNumber=1&updateResult=0&includeDescriptions=1&s_hotelIsNotInStop=true&showHotelFacilities=1]

Запрашиваются туры:
* из Москвы в Турцию;
* по всем отеля;
* на двоих;
* без детей;
* продолжительностью от 3 до 10 ночей;
* с интервалом дат вылета 19.09.19 – 25.09.19;
* с включённым перелётом, гарантированным наличием билетов и мест в отеле;
* на странице выдачи должно располагаться 10 результатов;
* описание отеля должно выводиться в ленте выдачи;
* дополнительно запрашиваются данные о визовых и топливных сборах;
* услуги предоставляемые в отеле;

Параметры запроса:

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

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

{| class="standard sWarning"
|Внимание! Из-за технических ограничений со стороны оператора «Натали Турс», он принимает в одном запросе не больше 5 идентификаторов отелей. При передаче в запросе более 5 идентификаторов отелей к оператору уходят только первые 5, из-за этого в результаты поиска по этому ТО могут попадать не самые дешевые туры.
|}
|-
|s_adults
|Int
|Количество туристов (взрослых). По умолчанию: 2.
|-
|s_kids
|Int
|Количество туристов (детей). По умолчанию: 0.
|-
|s_kids_ages
|Int[]
|Список возрастов детей, разделённых запятыми. Количество значению соответствует значению параметра s_kids. По умолчанию: не задан.
|-
|s_nightsMin
|Int
|Минимальная продолжительность тура, ночей. По умолчанию: 3.
|-
|s_nightsMax
|Int
|Максимальная продолжительность тура, ночей. По умолчанию: 15.
|-
|s_priceMin
|Int
|Минимальная цена. По умолчанию: не задан.
|-
|s_priceMax
|Int
|Максимальная цена. По умолчанию: не задан.
|-
|currencyAlias
|Str
|Валюта параметров s_priceMin и s_PriceMax. Допустимые значения: USD, EUR, RUR, UAH, BYN, KZT. По умолчанию: RUB.
|-
|s_departFrom
|Str
|Начальная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата.
|-
|s_departTo
|Str
|Конечная дата диапазона дат вылета в формате DD/MM/YYYY. По умолчанию: не текущая дата + 7 дней. Допустимый интервал между начальной и конечной датой диапазона — '''45 дней'''.
|-
|visibleOperators
|Str[]
|Список видимых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|hiddenOperators
|Str[]
|Список скрытых туроператоров, разделение запятой. По умолчанию: не задан. (Данный параметр не рекомендуется использовать при создании поискового запроса. Для отображения только выбранных туроператоров используйте параметры “filter” и “f_to_id”.)
|-
|calcFullPrice
|Bool
|Учитывать топливный сбор. Если в ответе нужно учитывать топливный сбор, параметр передаёт значение “1”; если допускаются цена без учёта топливного сбора – “0”. По умолчанию: “0”.
|-
|s_hotelIsNotInStop
|Str
|Наличие мест в отеле. Если в ответе нужны только отели с местами, параметр передаёт значение “true”; в противном случае – “false”. По умолчанию: “false”.
|-
|s_hasTickets
|Str
|Наличие билетов. Если в ответе нужны только туры с билетами, параметр передаёт значение “true”; если допускаются туры без билетов – “false”. По умолчанию: “false”.
|-
|s_ticketsIncluded
|Str
|Объём турпакета. Если в ответе нужны только туры с включённым перелётом, параметр передаёт значение “true”; если допускаются туры без перелёта – “false”. По умолчанию: “false”.
|-
|features
|Int[]
|Фильтрация данных ответа по услугам курорта. (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filter
|Int
|Фильтрация данных ответа по туроператорам. Возможные значения: “0” — выключено; “1” — включено. Если фильтр включён, используются идентификаторы из параметра f_to_id. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|filterToursForType
|Ulong
|filterToursForType - параметр фильтра, который позволяет вывести в ответ определённые туры. 
Например, если вы хотите, чтобы в ответе были только туры с Чартером необходимо передать filterToursForType = 65536. 
А если вы хотите чтобы в ответе были только туры с мгновенным бронированием необходимо передать filterToursForType = 2 
Если туры с Чартером (65536) и Мгновенное бронирование(2): filterToursForType 65538.
|-
|f_to_id
|Int[]
|Идентификаторы туроператоров, подлежащих фильтрации. По умолчанию: не задан. Параметр работает только при покупке расширенной версии сервиса (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по тел. 8(800)700-33-09 или по электронной почте support@sletat.ru).
|-
|fake
|Int
| Демо-выдача. По умолчанию: не задан.
|-
|extend
|Int
|Используется для сайта Слетать.ру
|-
|requestId
|Int
|Идентификатор запроса для получения результатов поиска. По умолчанию: не задан. Обязателен для получения результатов запроса.
|-
|pageSize
|Int
|Количество туров в ленте выдачи на одной странице. По умолчанию: не задан и выводит 20 туров.
|-
|pageNumber
|Int
|Номер страницы в ленте выдачи. По умолчанию: не задан.
|-
|updateResult
|Bool
|Получить свежие цены. Требует обязательной передачи параметра requestId. '''Требует значения "1"''' при повторном обращении к GetTours для получения результатов поиска.
|-
|includeDescriptions
|Bool
|Включить в выдачу описания отеля, типов размещения и питания. Если в ответе нужны описания, параметр передаёт значение “1”; если описания не нужны – “0”.
|-
|economOnly
|Bool
|Показывать туры с перелетом в экономическом классе. Варианты значений: 1 и 0. По умолчанию: не задан.
|-
|excludeToursForType
|Ulong
|excludeToursForType - параметр фильтра, который позволяет исключить из ответа типы туров.
Например, если из результатов поиска надо исключить Промо туры (16384) и туры на Регулярных рейсах (32768): excludeToursForType = 49152.
|-
|userId
|Int
|Используется для сайта Слетать.ру
|-
|includeOilTaxesAndVisa
|Bool
|Топливные и визовые сборы. Если данные нужны в ответе, параметр передаёт значение “true”; если не нужны – “false”. По умолчанию: не задан. Передавать как 1 или 0.
|-
|groupBy
|Str
|Группировка выдачи. Возможные значения:
* "so_checkin_price": Туры будут отсортированы по дате заезда (сначала ближайшие даты) и потом по цене
* "so_price": Туры будут отсортированы по цене
* "all_sortedHotels": Сортировка по умолчанию, туры будут сгруппированы по отелю и отсортированы по цене по возростанию
* "all_sortedHotelsDesc": Туры будут сгруппированы по отелю и отсортированы по цене по убыванию
* "sortedHotels": Туры будут отсортированы по отелю и полной цене (в случае ее недоступности будет использована простая цена) (FullPrice & Price)
* "hotel": Туры будут сгруппированы только по отелю (без сортировки)
* "hotelsPopularity": Туры будут сгруппированы по отелю и отсортированы по убыванию рейтинга
* "special_hotels": Туры для ТОП3
"": По умолчанию, будет проверено состояние поискового запроса если он в процессе то будут запрошены и возвращены результаты для ТОП3 отсортированные по цене, если нет, то будет возвращен пустой массив.
Если параметр не передан, используется сортировка по цене, а максимальное количество туров в выдаче ограничивается тысячей (см. также параметр '''PageSize''').
|-
|}

Пример ответа (для удобства чтения представлены данные в общем виде):

<source lang="xml">
{
"GetToursResult":
{
"Data":
{
"aaData":
[
...
[
"1792097464",
4,
"https://hotels.sletat.ru/?id=120282",
120282,
"",
1334,
"ANTALYA, SIDE TWINGS RESIDENCE HOME (3 ноч.)",
"Twings Residence Home",
"3*",
"Studio Apartment",
"RO",
"DBL",
"22.09.2019",
"25.09.2019",
3,
"30233 RUB",
2,
0,
"TEZ TOUR",
"Сиде",
[
"http://www.tez-tour.com/ru/spb/search.html"
],
"0",
"1",
"1",
"1",
"1",
"1",
"Вс.",
"25.09",
"",
119,
"Турция",
832,
"Москва",
"//static.sletat.ru/images/to/4.png",
"0",
"",
"",
"",
13103,
false,
117,
30233,
"RUB",
5753,
402,
0,
"https://sletat.ru/book/TEZ TOUR/NHwxNzkyMDk3NDY0fDgzMnw1OTIwMDY3MDJ8",
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
"",
"7",
"",
"2",
"-1",
0,
"SIDE TWINGS RESIDENCE HOME",
"3 *",
"Сиде",
"RO",
"2ADL",
"Studio Apartment",
402,
0,
"+j0faDzJV6UBHpT16oUO9A==",
"65536",
"",
"",
"",
"",
"",
"",
"",
"",
"",
"Y4I6oFV4RRG6pnjmHab8Pw==",
0,
null,
-1,
false,
"",
"",
30233,
0,
0,
null,
null,
[
17
],
36.7794571,
31.398035,
"",
[
7
],
0.00105993031
]
],
"cacheIsEmpty":false,
"countryCurrencyId":"3",
"hotelDetailedTypes": null,
"hotelFacilitiesData": {
"facilities": [
{
"id": 2,
"name": "Чистка обуви"
},
{
"id": 3,
"name": "Экскурсии"
},
{
"id": 6,
"name": "Частная"
},
{
"id": 8,
"name": "Глажка одежды"
},
{
"id": 9,
"name": "Пункт обмена валюты"
},
"groups": [
{
"id": 2,
"name": "Общие услуги"
},
{
"id": 3,
"name": "Парковка"
},
{
"id": 6,
"name": "Пляжная линия"
},
{
"id": 8,
"name": "Удобства в номерах"
},
{
"id": 9,
"name": "Специальные номера"
},
"hotelFacilities": [
{
"facilities": [
{
"facilityId": 16,
"groupId": 2,
"hit": null
},
{
"facilityId": 24,
"groupId": 8,
"hit": null
},
{
"facilityId": 26,
"groupId": 15,
"hit": null
},
{
"facilityId": 30,
"groupId": 12,
"hit": null
}
"hotelsCount":8,
"iTotalDisplayRecords":105,
"iTotalRecords":105,
"isInTheBasket":0,
"loadState": [
{
"Id": 51,
"Name": "Ambotis Holidays",
"ErrorMessage": null,
"ExecutionTimeMs": 2491,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 53086,
"MinFullPrice": 0,
"MinPrice": 46492,
"OnlineErrorMessage": null,
"RowsCount": 74
},
{
"Id": 171,
"Name": "Amigo S",
"ErrorMessage": null,
"ExecutionTimeMs": 4708,
"IsCached": false,
"IsError": false,
"IsPersistentCacheUsed": false,
"IsProcessed": true,
"IsSkipped": false,
"IsTimeout": false,
"MaxFullPrice": 0,
"MaxPrice": 50726,
"MinFullPrice": 0,
"MinPrice": 44120,
"OnlineErrorMessage": null,
"RowsCount": 50
}
],
"oilTaxes": [
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Аланья",
null,
34,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Анталья",
null,
72,
null,
832,
null,
null
],
[
"81",
"19.04.2019",
"30.04.2020",
35,
"EUR",
null,
null,
"Белек",
null,
149,
null,
832,
null,
null
]
},
...
}
}
</source>

В ответ возвращается структура GetToursResult.Data, состоящая из структур:
* aaData – массив записей о турах, каждый элемент которого является массивом данных о туре,
* LoadState (см. описание в «GetLoadState – Статус обработки запроса»);
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visa – массив записей о визовых сборах, применимых к выбранным турам, каждый элемент которого является массивом данных о визовом сборе (поле принимает значение “null”, если параметр запроса includeOilTaxesAndVisa равен “0”, или если визовые сборы полностью отсутствуют);
* visaRange, включающей в себя единственный параметр visaRange[1] – валюту визового сбора, а также массив записей о диапазоне визовых сборов, каждый элемент которого является массивом данных о минимальном и максимальном визовом сборе, включаемом в стоимость отдельным туроператором.

{| class="standard sWarning"
|Внимание! Несмотря на то, что метод GetTours возвращает данные о состоянии обработки поискового запроса туроператорами (структура LoadState), для получения этой информации в процессе поиска обращение к методу GetTours не допускается – необходимо использовать метод GetLoadState (см. «Логика работы сервиса», «GetLoadState – Статус обработки запроса»). За обращение к методу GetTours для отслеживания состояния поискового запроса Слетать.ру имеет право отозвать лицензию на использование шлюза без возмещения стоимости недооказанных услуг.
|}

Кроме того, структура GetToursResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|cacheIsEmpty
|bool
|Состояние кеша. Принимает значение '''true''', если кеш пуст
|-
|countryCurrencyId
|str
|Идентификатор валюты, используемой в стране
|-
|hotelsCount"
|int
|Количество отелей в выдаче
|-
|iTotalDisplayRecords
|int
|Количество туров в выдаче; Если >2500 возвращаем 2500;
|-
|iTotalRecords"
|int
|iTotalRecords идентично iTotalDisplayRecords
|-
|isInTheBasket
|int
|Технический параметр. Используется только на сайте sletat.ru
|-
|requestId
|Int
|Идентификатор поискового запроса.
|}

Поля структуры aaData:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Int
|Идентификатор цены.
|-
|aaData[1]
|Int
|Шифрованный идентификатор туроператора.
|-
|aaData[2]
|Str
|Ссылка на описание отеля.
|-
|aaData[3]
|Int
|Идентификатор отеля.
|-
|aaData[4]
|Str
|Ссылка на описание курорта.
|-
|aaData[5]
|Int
|Идентификатор курорта.
|-
|aaData[6]
|Str
|Название тура.
|-
|aaData[7]
|Str
|Название отеля.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип комнаты (не размещение).
|-
|aaData[10]
|Str
|Тип питания.
|-
|aaData[11]
|Str
|Тип размещения.
|-
|aaData[12]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[13]
|Str
|Дата прибытия в формате DD.MM.YYYY.
|-
|aaData[14]
|Int
|Продолжительность тура, ночей.
|-
|aaData[15]
|Str
|Стоимость тура с указанием валюты.
|-
|aaData[16]
|Int
|Количество туристов (взрослых).
|-
|aaData[17]
|Int
|Количество туристов (детей).
|-
|aaData[18]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[19]
|Str
|Название курорта.
|-
|aaData[20][0]
|Str
|Технический параметры, используемый сайтом sletat.ru.
|-
|aaData[21]
|Bool
|Наличие мест в отеле. Возможные значения: “0” — есть; “1” — нет, “2” — по запросу.
|-
|aaData[22]
|Bool
|Объём турпакета.
|-
|aaData[23]
|Int
|Наличие билетов эконом-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[24]
|Int
|Наличие билетов эконом-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[25]
|Int
|Наличие билетов бизнес-класса (туда). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[26]
|Int
|Наличие билетов бизнес-класса (обратно). Возможные значения: “0” — нет; “1” — есть, “2” — по запросу.
|-
|aaData[27]
|Str
|День начала тура. Используется только в текстовом представлении. Возможные значения: Пн. Вт. Ср. Чт. Пн. Сб. Вс.
|-
|aaData[28]
|Str
|Дата окончания тура. Используется только в текстовом представлении.
|-
|aaData[29]
|Str
|Ссылка на миниатюрную фотографию отеля.
|-
|aaData[30]
|Int
|Идентификатор направления.
|-
|aaData[31]
|Str
|Название страны.
|-
|aaData[32]
|Int
|Идентификатор города вылета.
|-
|aaData[33]
|Str
|Название города вылета.
|-
|aaData[34]
|Str
|Ссылка на логотип туроператора.
|-
|aaData[35]
|Float
|Рейтинг отеля от 0 до 10.
|-
|aaData[36]
|Str
|Описание типа питания (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[37]
|Str
|Описание типа размещения (выдаётся, если параметр запроса includeDescriptions = “true”).
|-
|aaData[38]
|Str
|Описание отеля (выдаётся если параметр запроса includeDescriptions = “true”).
|-
|aaData[39]
|Int
|Системный идентификатор типа размещения (поле может быть пустым, если данные не слинкованы).
|-
|aaData[40]
|Bool
|Флаг демо-режима. Если шлюз работает в демо-режиме, поле принимает значение “true”; в противном случае – “false”.
|-
|aaData[41]
|Int
|Системный идентификатор питания (поле может быть пустым, если данные не слинкованы).
|-
|aaData[42]
|Int
|Цена тура в виде числа (без прибавления к строке валюты).
|-
|aaData[43]
|Int
|Валюта полня aaData[42].
|-
|aaData[44]
|Int
|Системный идентификатор типа номера в отеле (поле может быть пустым, если данные не слинкованы).
|-
|aaData[45]
|Int
|Системный идентификатор категории отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[46]
|Int
|Количество фотографий отеля (поле может быть пустым, если данные не слинкованы).
|-
|aaData[47]
|Str
|Ссылка на личный кабинет туроператора.
|-
|aaData[48]
|Str
|Оригинальное название тура.
|-
|aaData[49]
|Str
|Оригинальное название категории.
|-
|aaData[50]
|Str
|Оригинальное название курорта.
|-
|aaData[51]
|Str
|Оригинальное название питания.
|-
|aaData[52]
|Str
|Оригинальное название размещения.
|-
|aaData[53]
|Str
|Оригинальное название типа номера.
|-
|aaData[54]
|Str
|Количество мест в отеле. Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество мест.
|-
|aaData[55]
|Int
|Количество билетов эконом-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[56]
|Int
|Количество билетов эконом-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[57]
|Int
|Количество билетов бизнес-класса (туда).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[58]
|Int
|Количество билетов бизнес-класса (обратно).
Возможные значения:
«-1» — нет данных;
целое число, меньшее или равное нулю — точное количество билетов;
пустое значение — билетов много.
|-
|aaData[59]
|Int
|Флаг тура с обязательствами; «0» – обычный тур; «1» – тур с обязательствами.
|-
|aaData[60]
|
|Наименование отеля
|-
|aaData[61]
|
|Описание категории отеля
|-
|aaData[62]
|
|Наименование тура
|-
|aaData[63]
|
|Тип питания
|-
|aaData[64]
|
|Тип размещения
|-
|aaData[65]
|
|Тип нормера в отеле
|-
|aaData[66]
|
|Идентификатор категории отеля
|-
|aaData[67]
|
|Тип цены
|-
|aaData[68]
|
|Хеш идентификатор тура в архиве
|-
|aaData[69]
|int
|Признак чартера и регулярного перелета. Поле представляет из себя целочисленное беззнаковое число (ulong). Для регулярного перелета - 32768, для чартерного - 65536.
Все возможные признаки на данный момент следующие:
* None = 0 - нет,
* Recommended = 1 - Рекомендованный тур,
* Instant = 2 - Тур с моментальным подтверждением,
* BestOfffer = 4 - Лучшее предложение,
* EarlyBook = 8 - Тур с ранним бронированием,
* LateBook = 16 - Тур с поздним бронированием,
* Discount = 32 - Тур со скидкой,
* VipOffer = 64 - VIP туры ,
* CreditAvailable = 128 - Доступно в кредит,
* Exclusive = 256 - Эксклюзивный тур,
* GoesWithGifts = 512 - Тур с подарками,
* IsCombined = 1024 - Комбинированный тур,
* ShopTour = 2048 - Шоп тур,
* ExcursionTour = 8192 - Экскурсионный тур,
* PROMO = 16384 - Тур с промо ценой,
* FlightRegular = 32768 - Тур с регулярным перелётом,
* FlightCharter = 65536 - Тур с чартерным перелётом,
* Bus = 131072 - Автобусный тур,
* Railway = 262144 - Ж/д тур,
* Target = 524288- Прямой перелёт
|-
|aaData[70]
|
|(устарело) — CreditMonths
|-
|aaData[71]
|
|(устарело) — CreditMonthlyPay
|-
|aaData[72]
|
|(устарело) — Описание тура
|-
|aaData[73]
|
|(устарело) — Скидка
|-
|aaData[74]
|
|(устарело) — Срок действия скидки
|-
|aaData[75]
|
|(устарело) — Описание скидки
|-
|aaData[76]
|
|(устарело) — ReceivingParty
|-
|aaData[77]
|
|(устарело) — GiftCaption
|-
|aaData[78]
|
|(устарело) — EarlyBookingValidTill
|-
|aaData[79]
|
|Хеш идентификатор тура в кеше
|-
|aaData[80]
|
|(устарело)
|-
|aaData[80]
|
|(устарело)
|-
|aaData[81]
|
|Дата первого обнаружения тура в системе. (Количество минут)
|-
|aaData[82]
|
|(используется для сайта Слетать.ру)
|-
|aaData[83]
|
|(используется для сайта Слетать.ру)
|-
|aaData[84]
|
|(используется для сайта Слетать.ру)
|-
|aaData[85]
|
|(используется для сайта Слетать.ру)
|-
|aaData[86]
|
|Цена тура без скидок и наценок, задаваемых в личном кабинете sletat.ru
|-
|aaData[87]
|
|Пляжная линия
|-
|aaData[88]
|
|
|-
|aaData[89]
|
|Рейтинг отеля на основе данных от TripAdVisor.
|-
|aaData[90]
|
|Количество отзывов в отель от TripAdVisor.
|-
|aaData[91]
|
|Список возможных типов размещения для отеля.
|-
|aaData[92]
|
|Координата расположения отеля - широта
|-
|aaData[93]
|
|Координата расположения отеля - долгота
|-
|aaData[94]
|
|Телефон.
|-
|aaData[95]
|int
|Данное поле представляет собой массив id включенных в тур услуг
Услуги отдаваемые на этапе поиска:

* Insurance = 3, - Страховка
* Transfer = 7, Трансфер от и до аэропорта
* Excursion = 8, Экскурсии
* Visa = 11, Виза в страну
* NoGoGuarantee = 12, страховка от невыезда
* OperatorLiabilityInsurance = 17, - Страхование ответственности ТО
* GuideServices = 18, - Услуги гида
* FuelSurcharge = 20, - Топливный сбор

Чтобы получить услуги отдаваемые при актуализации (все те же что при поиске и плюс описанные ниже), используйте метод актуализации:

* TourInfo = 1, - Информация по туру
* HotelInfo = 2, - Информация по доп отелям в туре (если вдруг тур комбинированный)
* DptTransport = 4, - Информация о транспорте туда
* RtnTransport = 10, - Информация о транспорте обратно
* AdditionalService = 5, Доп услуги
* AdditionalMeal = 6, Доп питание
* Charge = 9, Доп комиссия
* Infant = 13, - Включен в стоимость ребенок до 2ух лет
* Comission = 14, - Комиссия от туроператора (агента за тур)
* MidTransport = 15, - Информация о промежуточном транспорте
* HtPlace = 16, - Тип размещения
* Meal = 19, - Питание
* Avia = 21 - Авиаперелёт
* Railway = 22 - Билеты Ж/Д
* Bus = 23 - Автобусный переезд
* Cruise = 24 - Морское путешествие
|-
|aaData[96]
|float
|Рейтинг популярности отеля
|}

Поля структуры hotelFacilitiesData (передаются, если параметр запроса showHotelFacilities = 1)

{|class="wikitable"
|Поле
|Описание
|-
|"facilities"
|Словарь услуг в отеле.
|-
|"groups"
|Словарь групп услуг.
|-
|"hotelFacilities"
|Массив структур, содержащих id отеля и массив услуг этого отеля c указанием группы, к которой принадлежит услуга.
|}

Поля структуры visa (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|visa[0]
|Int
|Размер сбора.
|-
|visa[1]
|Str
|Валюта поля x[0].
|}

Поля структуры oilTaxes (передаются, если параметр запроса includeOilTaxesAndVisa = 1:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|oilTaxes[0]
|Int
|Идентификатор туроператора.
|-
|oilTaxes[1]
|Str
|Дата начала действия топливного сбора.
|-
|oilTaxes[2]
|Str
|Дата окончания действия топливного сбора.
|-
|oilTaxes[3]
|Int
|Размер топливного сбора.
|-
|oilTaxes[4]
|Str
|Валюта поля oilTaxes[3].
|-
|oilTaxes[5]
|Str
|Наименование авиакомпании.
|-
|oilTaxes[6]
|Str
|Наименование принимающей стороны.
|-
|oilTaxes[7]
|Str
|Название курорта.
|-
|oilTaxes[8]
|Str
|Название аэропорта прибытия.
|-
|oilTaxes [9]
|Int
|Идентификатор курорта.
|-
|oilTaxes[10]
|Int
|Номер рейса.
|-
|oilTaxes[11]
|Int
|Идентификатор города отбытия
|-
|oilTaxes[12]
|Int
|Возраст туриста, от которого включается топливный сбор.
|-
|oilTaxes[13]
|Int
|Возраст туриста, до которого включается топливный сбор.
|}

Для получения результатов выдачи методом GetTours используется идентификатор запроса requestId.

==== GetLoadState — Статус обработки запроса ====
Метод GetLoadState возвращает статус обработки запроса для каждого туроператора.

{| class="standard sWarning"
| Внимание! Варианты взаимодействия методов GetTours и GetLoadState описаны в разделе «Логика работы с сервисом».
|}

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

https://module.sletat.ru/Main.svc/GetLoadState?requestId=574187440&userId=

Запрашивается состояние обработки поискового запроса с идентификатором 574187440.

Запрос имеет единственный параметр requestId * - идентификатор поискового запроса, полученный в ответе метода GetTours.

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

<source lang="xml">
{
"GetLoadStateResult":
{
"Data":
[
{
"Id":1919263563,
"Name":"Туроператор #1919263563",
"ErrorMessage":null,
"ExecutionTimeMs":15,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
},
...
{
"Id":1919263596,
"Name":"Туроператор #1919263596",
"ErrorMessage":null,
"ExecutionTimeMs":719,
"IsCached":false,
"IsError":false,
"IsPersistentCacheUsed":false,
"IsProcessed":true,
"IsSkipped":false,
"IsTimeout":false,
"MaxPrice":0,
"MinPrice":0,
"RowsCount":0
}
],
...
}
}
</source>

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

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|Id
|Int
|Шифрованный идентификатор туроператора.
|-
|Name
|Str
|Наименование туроператора.
|-
|ErrorMessage
|Str
|Текст сообщения об ошибке. Выводится, если поле IsError принимает значение “true”.
|-
|ExecutionTime Ms
|Int
|Время обработки запроса туроператором в миллисекундах.
|-
|IsCached
|Bool
|Использование кэша. Если данные получены из кэша, поле принимает значение “true”; в противном случае – “false”.
|-
|IsError
|Bool
|Ошибка в поиске. Если при обработке запроса была допущена ошибка, поле принимает значение “true”; в противном случае – “false”.
|-
|IsPersistentCacheUsed
|Bool
|
|-
|IsProcessed
|Bool
|Завершение поиска. Если туроператор завершил обработку запроса, поле принимает значение “true”; в противном случае – “false”.
|-
|IsSkipped
|Bool
|
|-
|IsTimeout
|Bool
|Таймаут. Если обработка запроса завершена по таймауту, поле принимает значение “true”; в противном случае – “false”.
|-
|RowsCount
|Int
|Количество результатов поиска.
|}

=== Методы работы с заказом ===
==== ActualizePrice — Актуализация цены ====
Метод ActualizePrice необходим для актуализации предложений туроператоров. Он проверяет наличие билетов и мест в отеле, топливных и визовых сборов, а также других обязательных доплат и, при наличии, прибавляет их к стоимости тура.

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

https://module.sletat.ru/Main.svc/ActualizePrice?sourceId=970&offerId=1467001328&currencyAlias=RUB&showcase=0&countryId=119&requestId=343658640&detailed=1

Запрашиваются актуальные данные по туру в Турцию с идентификатором 1467001328 от туроператора 970, найденному по запросу 343658640; Указывается параметр detailed=1, чтобы провести актуализацию. Результат возвращается в рублях.

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Str
|Идентификатор ценового предложения (тура).
|-
|currencyAlias
|Int
|Валюта. Возможные значения: USD, EUR, RUB, UAH, BYN
|-
|showcase *
|Int
|Включение режима выдачи для горящих туров.
|-
|countryId
|Int
|Идентификатор направления.
|-
|requestId *
|Int
|Идентификатор поискового запроса.
|-
|userId
|
|-
|detailed
|int
|Флаг, который позволяет выполнить актуализацию.
|}

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

<source lang="xml">
{
"ActualizePriceResult": {
"ErrorCode": 0,
"ErrorMessage": null,
"ExecutionTimeMs": 13757,
"IsError": false,
"Data": {
"actualizationSessionId": "c0AxpC6AOU2ua9Jr2IHaFg==",
"buyOnlineAvailabilityStatus": 1,
"data": [
"TURKEY",
"Moscow",
"ISTANBUL",
"MOW-IST(4)_ПРОМО 7_Hotel commission Standard",
"01.06.2025",
"7",
"Raimond Hotel",
"343658640",
"3*",
"Standard With French Bed",
"08.06.2025",
"BB",
"True",
"0",
"1",
"1",
"0",
"0",
"860",
"87711",
"",
"EUR",
"2Взр.",
"RUB",
"970",
"Турплатформа",
"119",
"Турция",
"832",
"Москва",
"1365",
"Стамбул",
"120625",
"Raimond Hotel",
"402",
"3*",
"",
"Standard With French Bed",
"114",
"BB",
"13103",
"DBL",
null,
"/turkey/fatih/raimond_hotel/",
"https://hotels.sletat.ru/i/p/120625_0.jpg",
33,
"/book/Турплатформа/OTcwfDE0NjcwMDEzMjh8ODMyfDM0MzY1ODY0MHw%3d",
"3",
"7.2",
"Завтраки",
"двухместный номер",
"Отель Raimond находится в тихом районе, всего в 10 минутах ходьбы от Голубой мечети. К услугам гостей круглосуточная стойка регистрации и звукоизолированные номера с бесплатным Wi-Fi.\n\nЭлегантно оформленные номера отеля Raimond оснащены телевизором с плоским экраном, кондиционером, сейфом и мини-баром. В собственной ванной комнате предоставляются бесплатные туалетно-косметические принадлежности. В некоторых номерах есть балкон.\n\nВ ресторане отеля ежедневно сервируется завтрак \"шведский стол\". Поблизости работает множество ресторанов и кафе.\n\nДо магазинов Лалели и ресторанов Кумкапы можно дойти пешком.",
"1467001328",
"2",
"0",
"Wb7pVPm82TDPEjqWLoqGAQ==",
"A0E1378CCF687358A0D816750E6862E8",
"",
0,
"5",
false,
false,
false,
false,
"Turkey",
"Moscow",
"/touroperators/tourplatform2",
"49154"
],
"errorMessage": null,
"hotelPlaces": [
{
"description": "Cтандартный типовой номер в отеле",
"id": 13,
"isMain": true,
"name": "Стандартный номер"
}
],
"isBuyOnlineAvailability": true,
"isCompleted": true,
"isDetailedExists": true,
"isError": false,
"isFound": true,
"nextPossibleCommands": null,
"oilTaxes": [
[
0,
null,
null,
"Турплатформа",
null,
"17.03.2025",
"28.02.2026",
null,
null,
null,
null,
null,
null
]
],
"randomNumber": 83120,
"resourceData": [
{
"name": "AIRLINE",
"resourceId": 4020001,
"value": "Southwind"
},
...
],
"resources": [
{
"exclude": "",
"groupId": 2,
"id": 4020001,
"isChecked": true,
"isEnabled": true,
"isGeneratedInternally": false,
"linkGroupsId": 733282017,
"name": "2S 086 Southwind Airlines SVO 01.06.2025 12:35:00 - IST 01.06.2025 17:45:00 Econom",
"surcharge": 0,
"surchargeCurrencyId": 5,
"surchargeCurrencyIdOriginal": 3,
"surchargeOriginal": 0,
"type": 4
},
...
],
"rtbHash": "25843CB000E440B877E1D9713FE024A5",
"specialPromoOffers": [],
"visa": null,
"visaExtendedInfo": []
}
}
}
</source>

В ответ возвращается структура ActualizePriceResult.Data, состоящая из структур:
* data – массив данных о туре;
* oilTaxes – массив записей о топливных сборах, каждый элемент которого является массивом данных о топливном сборе;
* resourceData;
* recources;
* visa – массив записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе;
* visaExtendedInfo – масссив расширенных записей о визовых сборах, каждый элемент которого является массивом данных о визовом сборе.

Кроме того, структура ActualizePriceResult.Data содержит следующие поля:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|actualizationSessionId
|
|
|-
|errorMessage
|Str
|Текст ошибки. Выводится, если поле isError принимает значение “true”.
|-
|isCompleted
|
|
|-
|isError
|
|Сообщение об ошибке. Если в процессе обработки запроса произошла ошибка, поле принимает значение “true”, в противном случае – “false”.
|-
|isFound
|
|
|-
|nextPossibleCommands
|
|
|-
|randomNumber
|Int
|«Быстрый» номер тура в рамках запроса.
|-
|buyOnlineAvailabilityStatus
|Int
|Показывает статус доступности тура к покупке онлайн
|}

Описание статусов поля buyOnlineAvailabilityStatus:

{| class="wikitable"
|Значение
|Описание
|-
|1
|Доступна оплата без дополнительных условий.
|-
|2
|Оплата недоступна.
|-
|3
|Оператор не поддерживает онлайн оплату.
|-
|4
|Тур продан. Или нет перелётов (при этом ticketIncluded= true) или отеля (при этом hasTicket= true).
|-
|5
|Валюта тура отличная от RUB.
|-
|6
|До отправления меньше 24 ч.
|-
|7
|Тур не найден.
|}

Поля структуры data:

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|aaData[0]
|Str
|Направление.
|-
|aaData[1]
|Str
|Город вылета.
|-
|aaData[2]
|Str
|Курорт.
|-
|aaData[3]
|Str
|Название программы.
|-
|aaData[4]
|Str
|Дата вылета в формате DD.MM.YYYY.
|-
|aaData[5]
|Int
|Продолжительность тура, ночей.
|-
|aaData[6]
|Str
|Название отеля.
|-
|aaData[7]
|Str
|Не используется.
|-
|aaData[8]
|Str
|Категория отеля.
|-
|aaData[9]
|Str
|Тип номера.
|-
|aaData[10]
|Str
|Зарезервировано.
|-
|aaData[11]
|Str
|Тип питания.
|-
|aaData[12]
|Bool
|Объём турпакета. Если перелёт включён в стоимость тура, поле принимает значение “true”, в противном случае – “false”.
|-
|aaData[13]
|Bool
|Наличие мест в отеле. Если отель находится в стопе, поле принимает значение “true”, в противном случае – “false”.
|-
|aaData[14]
|Int
|Билеты эконом-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[15]
|Int
|Билеты эконом-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[16]
|Int
|Билеты бизнес-класса (туда). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[17]
|Int
|Билеты бизнес-класса (обратно). Возможные значения: “-1” – нет данных; целое число, меньшее или равное нулю – точное количество билетов.
|-
|aaData[18]
|Int
|Оригинальная цена (со скидкой и наценкой).
|-
|aaData[19]
|Int
|Цена в запрошенной валюте (со скидкой и наценкой).
|-
|aaData[20]
|Str
|Дополнительное описание тура.
|-
|aaData[21]
|Str
|Валюта полей aaData[18] и aaData[19].
|-
|aaData[22]
|Str
|Тип размещения.
|-
|aaData[23]
|Str
|Системное название валюты.
|-
|aaData[24]
|Int
|Идентификатор туроператора. Получение значения этого поля может быть ограничено лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[25]
|Str
|Наименование туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[26]
|Int
|Идентификатор направления. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[27]
|Str
|Направление. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[28]
|Int
|Идентификатор города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[29]
|Str
|Название города вылета. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[30]
|Int
|Идентификатор курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[31]
|Str
|Название курорта. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[32]
|Int
|Идентификатор отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[33]
|Str
|Название отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[34]
|Int
|Идентификатор категории отеля.
|-
|aaData[35]
|Str
|Категория отеля. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[36]
|
|Идентификатор типа номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[37]
|Str
|Тип номера. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[38]
|Int
|Идентификатор типа питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[39]
|Str
|Тип питания. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[40]
|Int
|Идентификатор типа размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[41]
|Str
|Тип размещения. Поле может быть пустым, если данные не слинкованы.
|-
|aaData[42]
|Str
|Ссылка на туроператора. Поле может быть пустым, если передача данных ограничена лицензией (по всем вопросам обращайтесь в Службу технической поддержки Слетать.ру по телефону 8(800)700-33-09 или по e-mail support@sletat.ru).
|-
|aaData[43]
|Str
|Ссылка на сайт отеля.
|-
|aaData[44]
|Str
|Ссылка на первую фотографию отеля.
|-
|aaData[45]
|Int
|Количество доступных фотографий отеля.
|}

Данные о топливных сборах

{| class="wikitable"
|Поле
|Тип
|Описание
|-
|x[0]
|Int
|Размер топливного сбора.
|-
|x[1]
|Str
|Валюта поля x[0].
|-
|x[2]
|Str
|Наименование авиакомпании.
|-
|x[3]
|Int
|Идентификатор туроператора.
|-
|x[4]
|Str
|Курорт.
|-
|x[5]
|Str
|Дата начала действия топливного сбора.
|-
|x[6]
|Str
|Дата окончания действия топливного сбора.
|-
|x[7]
|Str
|Наименование принимающей стороны.
|-
|x[8]
|Str
|Аэропорт прибытия
|-
|x[9]
|Int?
|Номер рейса.
|}

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

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

https://module.sletat.ru/Main.svc/SaveTourOrder?searchRequestId=575366173&offerId=12242442&sourceId=1922198339&user=%D0%98%D0%B2%D0%B0%D0%BD+%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2%D0%B8%D1%87+%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9&email=test%40mail.ru&phone=%2B71111111111&info=%D0%A2%D0%B5%D1%81%D1%82%D0%BE%D0%B2%D1%8B%D0%B9+%D0%BA%D0%BE%D0%BC%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%80%D0%B8%D0%B9.+%D0%98%D0%B7%D0%B2%D0%B8%D0%BD%D0%B8%D1%82%D0%B5.&countryName=undefined&cityFromName=undefined&currencyAlias=RUB&userId=

Передаются данные о заказе тура #12242442 от туроператора #1922198339, найденного по запросу #575366173: ФИО, телефон, e-mail, комментарий к заказу, город вылета и направление, валюта цены тура (рубли).

Параметры запроса:

{| class="wikitable"
|Параметр
|Тип
|Описание
|-
|searchRequestId *
|Int
|Идентификатор поискового запроса.
|-
|sourceId *
|Int
|Шифрованный идентификатор туроператора.
|-
|offerId *
|Int
|Идентификатор ценового предложения (тура).
|-
|user *
|Str
|Имя заказчика.
|-
|email *
|Str
|Электронная почта заказчика.
|-
|phone *
|Str
|Телефон заказчика.
|-
|info
|Str
|Комментарий заказчика.
|-
|countryName *
|Str
|Направление.
|-
|cityFromName *
|Str
|Город вылета.
|-
|currencyAlias *
|Str
|Валюта. Допустимые значения: USD, EUR, RUR, BYN.
|-
|userId
|
|
|}

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

<source lang="xml">
{
"SaveTourOrderResult":
{
"Data":0,
"ErrorMessage":null,
"ExecutionTimeMs":117,
"IsError":false
}
}
</source>

В ответ передаётся структура SaveTourOrderRequest, с пустым массивом Data и полями, возвращающими данными об ошибки (см. описание в разделе «Методы»).

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

2025-09-26T12:25:58Z

Kdadmin: /* Актуализация и загрузка информации о туре */

[[Category:Расширения и дополнения]]
== Актуализация и загрузка информации о туре ==

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

Сигнатура:
XmlActualPriceData ActualizePrice(Int32 sourceId, Int64 offerId, Int32 requestId, Int32[] selectedResources, String login, String password)

Параметры:
* requestId – идентификатор поискового запроса, выдается методом GetTours при создании
нового поискового запроса;
* offerId – идентификатор тура, выдаётся в методе GetTours для каждого тура;
* sourceId – идентификатор туроператора, выдаётся в методе GetTours для каждого тура;
* selectedResources – устарел.

* login – логин для авторизации в личном кабинете туроператора;
* password – пароль для авторизации в личном кабинете туроператора;
Если логин и пароль личного кабинета туроператора не передается в запросе, успешная актуализация информации по туру не гарантируется.
В ответ возвращается структура '''ActualizePriceResult''', которая состоит из следующих полей:
* TourInfo – структура описывает основную информацию о туре, формат описан ниже;
* RandomNumber – случайное четырехзначное число, по которому можно просмотреть информацию о туре в личном кабинете на сайте sletat.ru или в SletatRu Agent, используется для того, чтобы клиент мог точно сообщить менеджеру вашей компании о туре, который он нашёл;

* IsFound – поле принимает значение false, если тур не был найден в базе туроператора;
* IsError – принимает значение true, если при актуализации тура возникла ошибка;
* Resources – список услуг, входящих в тур, поле может быть пустым, если для туроператора
не реализована поддержка вывода подробной информации, формат списка услуг будет
описан ниже;
* ResourceData – список дополнительных произвольных данных к любой услуге из поля
Resources, формат будет описан ниже;

Описание структуры '''TourInfo''':

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
CountryName
|
String
|
Страна (данные от
туроператора).
|-
|
CityFromName
|
String
|
Город вылета (данные от
туроператора).
|-
|
ResortName
|
String
|
Курорт (данные от
туроператора).
|-
|
TourName
|
String
|
Название тура (данные от
туроператора).
|-
|
CheckIn
|
String
|
Дата вылета в формате
dd.MM.yyyy.
|-
|CheckOut
|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 или BYR).
|-
|
OriginalPrice
|
Int32
|
Оригинальная цена тура в исходной валюте (со скидкой и наценкой).
|-
|
OriginalPriceCurrency
|
String
|
Обозначение валюты (данные
от туроператора) для цены '''OriginalPrice'''.
|-
|
SourceId
|
Int32
|
Идентификатор туроператора. Поле заполняется
только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).
|-
|
SourceName
|
String
|
Название туроператора. Поле
заполняется только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).
|-
|
SourceSearchFormUrl
|
String
|
Ссылка на форму поиска
туроператора. Поле заполняется только для партнёров sletat.ru (по всем вопросам
обращайтесь в службу поддержки info@sletat.ru).
|-
|
SysCountryId
|
Int32
|
Идентификатор страны из
справочника стран.
|-
|
SysCountryName
|
String
|
Название страны из
справочника стран.
|-
|
SysCityFromId
|
Int32
|
Идентификатор города вылета
из справочника городов вылета.
|-
|
SysCityFromName
|
String
|
Название города вылета из
справочника городов вылета.
|-
|
SysResortId
|
Int32
|
Идентификатор курорта из справочника курортов
(либо из справочника '''GetCtities''' или '''GetGeoTree''', в зависимости от параметра '''useTree''' исходного поискового запроса), параметр может быть равен 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
|
Ссылка на описание / бронирование тура на сайте туроператора. Поле заполняется только для партнёров sletat.ru (по всем вопросам обращайтесь в службу поддержки info@sletat.ru).

В настоящий момент некоторые
туроператоры не имеют ссылок в сервисе Слетать.ру.
|-
|OriginalCurrencyId
|Int32
|Идентификатор валюты тура по данным туроператора. Возможные значения: 2 – USD, 3 – EUR, 5 – RUR.
|-
|Adults
|Int32
|Количество туристов (взрослых).
|-
|Kids
|Int32
|Количество туристов (детей).
|}

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

Структура '''Resources''' состоит из вложенных элементов '''Resource''', каждый из которых описывает одну услугу в туре полями:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Id
|
Int32
|
Идентификатор услуги
|-
| Type
| Int32
| Тип услуги, список возможных типов:
* 1 - тур;
* 2 - проживание;
* 3 - страховка;
* 4 - транспорт (туда);
* 5 - дополнительные сервисы;
* 6 - дополнительное питание;
* 7 - трансфер;
* 8 - экскурсии;
* 9 - различные сборы;
* 10 - транспорт (обратно);
* 11 - информация о визах;
* 12 - страховка от невыезда;
* 13 - возможность добавления младенца;
* 14 - информация о комиссии;
* 15 - доп. перелёт в комбинированном туре;
* 16 - выбор размещения в основном отеле;
* 18 - Услуги гида;
* 19 - Питание;
* 20 - Топливный сбор;
* 21 - Авиаперелёт.
|-
|
Name
|
String
|
Название услуги.
|-
|
IsChecked
|
Boolean
|
При значении true указывает,
что данная услуга входит в посчитанную цену.
|-
|
IsEnabled
|
Boolean
|
При значении true указывает, что данная услуга
может быть включена или исключена из стоимости тура, и стоимость может быть
пересчитана повторным вызовом данного метода с использованием параметра selectedResources.
|-
|
GroupId
|
Int32?
|
Идентификатор группы. Группы используются для указания на взаимоисключающие услуги, т.е. набор услуг, только одна из
которых может быть выбрана. Значение поля может быть NULL, в этом случае выбор
услуги никак не связан с другими услугами.
|-
|
Exclude
|
String
|
Список идентификаторов других ресурсов, пересчёт тура с которыми невозможен с использованием данного ресурса. С помощью данного поля, например, устанавливается список подходящих обратных перелётов для каждого перелёта в страну отдыха. Список разделён запятыми.
|}

Структура '''ResourceData''' может включать дополнительные описания для услуг из поля '''Resources'''. Каждый элемент состоит из полей:

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
Name
|
String
|
Название дополнительного поля с описанием.
|-
|
ResourceId
|
Int32
|
Идентификатор услуги из структуры '''Resources'''.
|-
|
Value
|
String
|
Содержание дополнительного поля с описанием.
|}

Ниже представлена таблица возможных значений поля '''Name''' для каждого типа услуг:

{| class="wikitable"
|-
|
Тип ресурса
|
Значение Name
|
Описание
|-
|
1 (тур)
|
COMMENT
|
Комментарий к туру.
|-
|
1 (тур)
|
DATEBEG
|
Дата начала тура.
|-
|
1 (тур)
|
DATEEND
|
Дата окончания тура.
|-
|
1 (тур)
|
PEOPLE_COUNT
|
Кол-во людей для заселения
(без учёта младенца, если есть)
|-
|
1 (тур)
|
BAGGAGE_INCLUDED
|
Указывает удалось ли получить информацию о багаже от туроператора
|-
|
1 (тур)
|
BAGGAGE_PLACES
|
Кол-во багажных мест
|-
|
1 (тур)
|
BAGGAGE_WEIGHT
|
Указывает допустимый вес багажа (кг)
|-
|
1 (тур)
|
BAGGAGE_SIZE
|
Допустимый размер багажа
|-
|
1 (тур)
|
LUGGAGE_INCLUDED
|
Указывает удалось ли получить информацию о ручной клади от туроператора
|-
|
1 (тур)
|
LUGGAGE_PLACES
|
Кол-во мест ручной клади
|-
|
1 (тур)
|
LUGGAGE_WEIGHT
|
Указывает допустимый вес ручной клади (кг)
|-
|
1 (тур)
|
LUGGAGE_SIZE
|
Допустимый размер ручной клади
|-
|
2
(проживание)
|
URL
|
Ссылка на описание отеля.
|-
|
2
(проживание)
|
RESORT
|
Курорт, в котором расположен
отель.
|-
|
2
(проживание)
|
HTPLACE
|
Размещение в отеле.
|-
|
2
(проживание)
|
ROOM
|
Тип номера.
|-
|
2
(проживание)
|
MEAL
|
Питание в отеле.
|-
|
2
(проживание)
|
CHECKIN
|
Дата заезда.
|-
|
2
(проживание)
|
CHECKOUT
|
Дата выезда.
|-
|
4, 10,
15 (перелёт)
|
FLIGHT
|
Номер рейса.
|-
|
4, 10,
15 (перелёт)
|
FLIGHT_IS_CONCRETE
|
Конкретизация авиаперелета (true - конкретизирован, false - не конкретизирован)
|-
|
4, 10,
15 (перелёт)
|
DATE
|
Дата перелёта.
|-
|
4, 10,
15 (перелёт)
|
START_TIME
|
Время начала перелёта.
|-
|
4, 10,
15 (перелёт)
|
END_TIME
|
Время окончания перелёта.
|-
|
4, 10,
15 (перелёт)
|
AIRPORT_FROM
|
Аэропорт вылета.
|-
|
4, 10,
15 (перелёт)
|
AIRPORT_TO
|
Аэропорт прилёта.
|-
|
4, 10,
15 (перелёт)
|
CLASS
|
Класс перелёта, возможны
значения ECONOM и BUSINESS.
|-
|
14
(комиссия)
|
COMISSION_BASE
|
Базовая комиссия агентства
(%).
|-
|
14
(комиссия)
|
COMISSION_EARLY_ORDER
|
Комиссия за раннее
бронирование (%).
|-
|
14
(комиссия)
|
COMISSION_BONUS
|
Бонус к комиссии (%).
|-
|
14
(комиссия)
|
COMISSION_SUM
|
Сумма комиссии в оригинальной валюте тура (для
туроператоров на основе СамоТур сумма комиссии появляется после пересчёта
цены тура).
|-
|
16
(размещение)
|
PEOPLE_COUNT
|
Кол-во людей в выбранном
размещении.
|-
|
16
(размещение)
|
IS_IN_STOP
|
Есть ли места, 2 –
запрос, 1 – стоп, 0 – есть места.
|-
|
16
(размещение)
|
PRICE
|
Цена размещения.
|-
|
16
(размещение)
|
CURRENCY_ID
|
Системный идентификатор
валюты (5 – рубли, 3 – евро, 2 – доллары).
|-
|
16
(размещение)
|
CURRENCY_NAME
|
Название валюты у
туроператора.
|}

Таблица '''ResourceData''' заполняется данными, если они предоставляются туроператором.

Пример реализации на PHP:

<source lang="php">

$searchParam = array(
"sourceId"=>"Зашифрованный идентификатор туроператора. Выдаётся каждому туру методом GetRequestResult.",
"offerId"=>"Идентификатор ценового предложения. Выдаётся каждому туру методом GetRequestResult.",
"requestId"=> 0,
"login"=> "логин от ЛК ТО",
"password"=>"пароль от ЛК ТО"
);

$soapClient = new SoapClient('https://module.sletat.ru/XmlGate.svc?singlewsdl');
$soapClient->__setSoapHeaders( new SoapHeader("urn:SletatRu:DataTypes:AuthData:v1", "AuthInfo", array(
"Login" => 'Логин в системе Слетать.ру',
"Password"=> 'Пароль в системе Слетать.ру'
)));
$result = $soapClient->ActualizePrice($searchParam);
</source>

Настройка почты

2025-05-22T09:00:38Z

Kdadmin: /* Настройка почтового клиента (The Bat!) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

[[File:olOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[File:hQZiZ3NBL-eeFMg-03GXu-86J0y-brB7OFGYh.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[File:IMUbrAxu6-F3yRn-fKWK7-p3YhB-dyxBMvKjY.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[File:GYBP8dJWo-eoEiY-NhRLK-cmgIf-RVRWvOKqq.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[File:tqlYc0MAL-7oiZh-WG7VV-LbJyX-NwB7pd2Oo.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[File:RRdQjSau6-e9tte-xU9MM-hhdH7-YKJKQWgmD.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[File:RHijF6HNN-hyzbZ-Vz2iU-xu7H6-99ClYaFJM.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[File:AUxbep5Qy-cITrV-5P2eQ-mH0bf-EaeNV8LCs.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:AUxbep5Qy-cITrV-5P2eQ-mH0bf-EaeNV8LCs.png

2025-05-22T09:00:31Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-22T09:00:03Z

Kdadmin: /* Настройка почтового клиента (The Bat!) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

[[File:olOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[File:hQZiZ3NBL-eeFMg-03GXu-86J0y-brB7OFGYh.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[File:IMUbrAxu6-F3yRn-fKWK7-p3YhB-dyxBMvKjY.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[File:GYBP8dJWo-eoEiY-NhRLK-cmgIf-RVRWvOKqq.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[File:tqlYc0MAL-7oiZh-WG7VV-LbJyX-NwB7pd2Oo.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[File:RRdQjSau6-e9tte-xU9MM-hhdH7-YKJKQWgmD.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[File:RHijF6HNN-hyzbZ-Vz2iU-xu7H6-99ClYaFJM.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:RHijF6HNN-hyzbZ-Vz2iU-xu7H6-99ClYaFJM.png

2025-05-22T08:59:55Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-22T08:57:06Z

Kdadmin: /* Настройка мобильного почтового клиента (Gmail) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

[[File:olOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[File:hQZiZ3NBL-eeFMg-03GXu-86J0y-brB7OFGYh.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[File:IMUbrAxu6-F3yRn-fKWK7-p3YhB-dyxBMvKjY.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[File:GYBP8dJWo-eoEiY-NhRLK-cmgIf-RVRWvOKqq.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[File:tqlYc0MAL-7oiZh-WG7VV-LbJyX-NwB7pd2Oo.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[File:RRdQjSau6-e9tte-xU9MM-hhdH7-YKJKQWgmD.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:RRdQjSau6-e9tte-xU9MM-hhdH7-YKJKQWgmD.png

2025-05-22T08:56:57Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-22T08:55:45Z

Kdadmin: /* Настройка мобильного почтового клиента (Gmail) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

[[File:olOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[File:hQZiZ3NBL-eeFMg-03GXu-86J0y-brB7OFGYh.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[File:IMUbrAxu6-F3yRn-fKWK7-p3YhB-dyxBMvKjY.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[File:GYBP8dJWo-eoEiY-NhRLK-cmgIf-RVRWvOKqq.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[File:tqlYc0MAL-7oiZh-WG7VV-LbJyX-NwB7pd2Oo.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:TqlYc0MAL-7oiZh-WG7VV-LbJyX-NwB7pd2Oo.png

2025-05-22T08:55:37Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-22T08:54:39Z

Kdadmin: /* Настройка почтового клиента (Apple Mail) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

[[File:olOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[File:hQZiZ3NBL-eeFMg-03GXu-86J0y-brB7OFGYh.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[File:IMUbrAxu6-F3yRn-fKWK7-p3YhB-dyxBMvKjY.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[File:GYBP8dJWo-eoEiY-NhRLK-cmgIf-RVRWvOKqq.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:GYBP8dJWo-eoEiY-NhRLK-cmgIf-RVRWvOKqq.png

2025-05-22T08:54:31Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-22T08:53:05Z

Kdadmin: /* Настройка почтового клиента (Apple Mail) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

[[File:olOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[File:hQZiZ3NBL-eeFMg-03GXu-86J0y-brB7OFGYh.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[File:IMUbrAxu6-F3yRn-fKWK7-p3YhB-dyxBMvKjY.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:IMUbrAxu6-F3yRn-fKWK7-p3YhB-dyxBMvKjY.png

2025-05-22T08:52:53Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-22T08:52:06Z

Kdadmin: /* Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

[[File:olOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[File:hQZiZ3NBL-eeFMg-03GXu-86J0y-brB7OFGYh.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:HQZiZ3NBL-eeFMg-03GXu-86J0y-brB7OFGYh.png

2025-05-22T08:51:53Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-22T08:47:51Z

Kdadmin: /* Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

[[File:olOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[Файл:settingsishod.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:OlOIRpmA6-Gub7z-o79WM-I7Ww0-K0sTEMuMs.png

2025-05-22T08:47:38Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-22T08:46:38Z

Kdadmin: /* Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[Файл:Настройка почты Outlook5.png|frameless|594x594px]]

[[File:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png|frameless|594x594px]]

# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[Файл:settingsishod.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Файл:Jb5rPCFJ3-sEkLb-OZD1Q-WHNCL-7EREwr1Cj.png

2025-05-22T08:46:20Z

Kdadmin: MsUpload

MsUpload

Настройка почты

2025-05-21T14:51:49Z

Kdadmin: /* Настройка почтового клиента (The Bat!) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[Файл:Настройка почты Outlook5.png|frameless|594x594px]]

[[Файл:Настройка почты Outlook4.png|frameless|598x598px]]
# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[Файл:settingsishod.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - memail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - memail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Настройка почты

2025-05-21T14:51:29Z

Kdadmin: /* Настройка мобильного почтового клиента (Gmail) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[Файл:Настройка почты Outlook5.png|frameless|594x594px]]

[[Файл:Настройка почты Outlook4.png|frameless|598x598px]]
# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[Файл:settingsishod.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — memail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — memail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - mymail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - mymail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Настройка почты

2025-05-21T14:51:05Z

Kdadmin: /* Настройка почтового клиента (Apple Mail) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[Файл:Настройка почты Outlook5.png|frameless|594x594px]]

[[Файл:Настройка почты Outlook4.png|frameless|598x598px]]
# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[Файл:settingsishod.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — memail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — mymail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — mymail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - mymail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - mymail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Настройка почты

2025-05-21T14:50:24Z

Kdadmin: /* Настройка почты. */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты memail.sletat.ru

Введите сервер исходящей почты memail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[Файл:Настройка почты Outlook5.png|frameless|594x594px]]

[[Файл:Настройка почты Outlook4.png|frameless|598x598px]]
# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[Файл:settingsishod.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — mymail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — mymail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — mymail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - mymail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - mymail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Настройка почты

2025-05-21T14:49:52Z

Kdadmin: /* Настройка почтового клиента (Apple Mail) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — mymail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — mymail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты mymail.sletat.ru

Введите сервер исходящей почты mymail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[Файл:Настройка почты Outlook5.png|frameless|594x594px]]

[[Файл:Настройка почты Outlook4.png|frameless|598x598px]]
# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[Файл:settingsishod.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — memail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — mymail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — mymail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — mymail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - mymail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - mymail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

Настройка почты

2025-05-21T14:47:55Z

Kdadmin: /* Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP */

== Настройка почты. ==
Почта доступна для использования в сторонних программных продуктах по протоколам imap/smtp.
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — mymail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

#; Исходящая почта
#:* '''Имя сервера''' — mymail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — логин/пароль от почты(предоставляется сотрудниками Слетать.ру)

=== Настройка почтового клиента (Outlook) по протоколу IMAP: НА ДАННЫЙ МОМЕНТ НЕ ДОСТУПНА ===
# Запустите приложение;
# Вызовите меню действий и нажмите «Добавить учетную запись»;

[[Файл:Настройка почты Outlook.png|frameless|588x588px]]
# Введите ваше имя, имя почтового ящика и пароль, выберете ручную настройку и нажмите "Далее".

[[Файл:Настройка почты Outlook2.png|frameless|586x586px]]
# Выберете подключение по IMAP

[[Файл:Настройка почты Outlook3.png|frameless|587x587px]]
# Введите ваши данные

Введите сервер входящей почты mymail.sletat.ru

Введите сервер исходящей почты mymail.sletat.ru

Выберете "Другие настройки"-"Сервер исходящей почты" и заполните поля на проверку подлинности.

Выберете "Другие настройки"-"Дополнительно" и заполните порты подключения: IMAP - 993(SSL), SMTP - 587(TSL).

[[Файл:Настройка почты Outlook5.png|frameless|594x594px]]

[[Файл:Настройка почты Outlook4.png|frameless|598x598px]]
# Нажимаем "Далее". Настройка почты завершена.

[[Файл:Настройка почты Outlook6.png|frameless|546x546px]]

=== Настройка почтового клиента (Mozilla Thunderbird) по протоколу IMAP ===
# Запустите программу и нажмите в окне приветствия кнопку '''Пропустить это и использовать мою существующую почту'''.
# В окне '''Настройка учётной записи почты''' укажите следующие параметры учетной записи:
#* '''Ваше имя''' — имя пользователя (например, «Джеймс Кирк»);
#* '''Адрес эл. почты''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Mozilla Thunderbird.png|frameless|403x403px]]
Нажмите кнопку '''Продолжить'''.
# Нажмите кнопку '''Настройка вручную''' и укажите следующие параметры серверов электронной почты:
#; Входящая почта
#:* '''Протокол''' — IMAP;
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 993;
#:* '''SSL''' — SSL/TLS;
#:* '''Аутентификация''' — Обычный пароль.

#; Исходящая почта
#:* '''Имя сервера''' — memail.sletat.ru
#:* '''Порт''' — 587;
#:* '''SSL''' — STARTTLS;
#:* '''Аутентификация''' — Обычный пароль.
Также укажите имя пользователя — ваш логин.

'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.
[[Файл:settingsishod.png|frameless|533x533px]]
# Нажмите кнопку '''Перетестировать''', чтобы проверить корректность введенных параметров. Если проверка прошла успешно, нажмите кнопку '''Готово'''.
# Синхронизируйте созданную учетную запись с сервером, чтобы получить список папок.
# Нажмите на название учетной записи правой кнопкой мыши и выберите пункт '''Параметры'''

[[Файл:Настройка почты Mozilla Thunderbird3.png|frameless|344x344px]]
# Перейдите в раздел '''Параметры сервера''' и установите в пункте '''При удалении сообщения '''значение '''Переместить его в папку Удаленные.'''

[[Файл:Настройка почты Mozilla Thunderbird4.png|frameless|507x507px]]
# Перейдите в раздел '''Копии и папки''' и установите для всех папок значение с именем вашего почтового ящика.Нажмите кнопку OK, чтобы применить изменения, и перезапустите программу.
# Нажмите кнопку '''OK''', чтобы применить изменения, и перезапустите программу.

=== Настройка почтового клиента (Apple Mail) по протоколу IMAP===
# Запустите программу и откройте меню Mail → Добавить учетную запись, чтобы открыть мастер создания учетной записи.

[[Файл:Настройка почты Apple Mail.png|frameless]]

''Примечание.'' Мастер создания учетной записи открывается автоматически при первом запуске программы.
# Выберите пункт Д'''обавить другую учетную запись Mail''' и нажмите кнопку '''Продолжить'''.
# В окне '''Добавление учетной записи Mail''' укажите следующие параметры учетной записи:
#* '''Полное имя''' — имя пользователя (например, «Коммандер Спок»);
#* '''Адрес e-mail''' — ваш почтовый адрес ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
[[Файл:Настройка почты Apple Mail2.png|frameless|463x463px]]
Нажмите кнопку '''Создать''' — программа проверит корректность введенных данных.

Если программа не может определить параметры сервера, вы увидите сообщение '''Учетная запись должна быть настроена вручную'''

3.1 Нажмите кнопку Дальше.

[[Файл:Настройка почты Apple Mail3.0.png|frameless|454x454px]]

3.2

В окне '''Свойства сервера входящей почты''' укажите следующие параметры учетной записи:
#* '''Тип учетной записи''' — IMAP;
#* '''Сервер почты''' — mymail.sletat.ru;
#* '''Имя пользователя''' — ваш логин ;
#* '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
'''''Внимание.''''' Укажите в этом поле полный адрес почтового ящика.

[[Файл:Настройка почты Apple Mail3.1.png|frameless|443x443px]]

Нажмите кнопку '''Дальше'''.

3.3 Опц.) Включите опцию '''Использовать SSL''' и введите в поле '''Порт''' значение 993.

[[Файл:Настройка почты Apple Mail3.2.png|frameless|444x444px]]

3.4 В окне '''Свойства сервера исходящей почты''' укажите следующие параметры учетной записи:
#** '''Сервер исходящей почты''' — mymail.sletat.ru;
#** '''Имя пользователя''' — ваш логин ;
#** '''Пароль''' — ваш пароль (или пароль приложения, если вы включили двухфакторную аутентификацию).
Нажмите кнопку '''Создать'''.
# Откройте меню '''Mail → Настройки → Свойства учетной записи'''. Выберите в разделе '''Сервер исход. почты (SMTP)''' пункт '''Ред. список SMTP-серверов.'''

[[Файл:Настройка почты Apple Mail3.png|frameless|481x481px]]
# Перейдите на вкладку Дополнения. Включите опцию Использовать SSL и в поле Использовать произвольный порт введите значение 587.

[[Файл:Настройка почты Apple Mail4.png|frameless|480x480px]]

Нажмите кнопку '''ОК'''
# Перейдите на вкладку '''Дополнения'''. Включите опцию '''Использовать SSL''' и введите в поле значение 993.

Также включите опцию '''Учесть при автоматической проверке новых сообщений'''.

[[Файл:Настройка почты Apple Mail5.png|frameless|480x480px]]

:
:

=== Настройка мобильного почтового клиента (Gmail) по протоколу IMAP ===

1. Запустите программу и войдите в свою учетную запись. Перейдите в пункт "Настройки".

[[Файл:selectsettings.png|frameless|480x480px]]

2. Выберите пункт "Добавить аккаунт"

[[Файл:addaccount.png|frameless|480x480px]]

3. Выберите пункт "Другое"

[[Файл:selectother.png|frameless|480x480px]]

4. Введите полный адрес почтового ящика и нажмите на пункт "НАСТРОИТЬ ВРУЧНУЮ"

[[Файл:selectbyhand.png|frameless|480x480px]]

5. Выберите пункт "Личный (IMAP)"

[[Файл:selectprivate.png|frameless|480x480px]]

6. Введите пароль от почты.

[[Файл:fillpassword.png|frameless|480x480px]]

7. Введите в поле Сервер — mymail.sletat.ru

[[Файл:addmymailsletat.png|frameless|480x480px]]

8. Введите в поле Сервер SMTP — mymail.sletat.ru

[[Файл:addservmailsletat.png|frameless|480x480px]]

9. Установить параметры и нажмите "Далее"

[[Файл:selectparam.png|frameless|480x480px]]

10. В поле "Название" введите полный адрес почтового ящика.

[[Файл:naming.png|frameless|480x480px]]

=== Настройка почтового клиента (The Bat!) по протоколу IMAP ===
1. Запустите приложение.

2. Нажмите на пункт "Ящик" и выберите пункт "Новый почтовый ящик...".

[[Файл:fikjAFCLo-Vh4jI-vRom3-K1GKD-Ep5u08miI.png|frameless|480x480px]]

3. В открывшемся окне введите ФИО, адрес почтового ящика и пароль от него. Выберите протокол IMAP или POP.

[[Файл:ecYoKUhQj-6F34X-Gj89F-OfjeF-yyrPEcMKs.png|frameless|480x480px]]

4. В открывшемся окне "Входящая почта" укажите следующее данные

1) Выберите протокол - IMAP - Internet Mail Access Protocol v4;

2) Адрес сервера - mymail.sletat.ru;

3) Соединение - Безопасное на спец. порт (TLS);

4) Порт - 993;

5) Имя пользователя: адрес вашей почты;

6) Пароль: пароль от вашей почты.

[[Файл:lZ4pGv4Lz-91Usk-A0Ynw-a7V3p-FGdtip5bK.png|frameless|480x480px]]

5. В открывшемся окне "Исходящая почта" укажите следующее данные

1) Адрес сервера исходящей почты (SMTP) - mymail.sletat.ru;

2) Соединение - Безопасное на спец. порт (TLS);

3) Порт - 465;

4) Поставьте галочку в чек-боксе "Мой сервер SMTP требует аутентификации".

[[Файл:ftpYgd8hz-PYiRo-Tzv6r-oPm2Y-3eBAithUz.png|frameless|480x480px]]

6. В открывшемся окне введите ваше имя и имя ящика.

[[Файл:cV27u6QjB-6kSho-KLEOQ-Fqiqc-RoB3DUmQ9.png||frameless|480x480px]]

7. Нажмите на кнопку "Готово". Настройка почты завершена.

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

2025-04-30T08:02:50Z

Kdadmin: /* CreateClaim */

[[Category:Расширения и дополнения]]
== Описание сервиса ==
Сервис для работы с online-заявками является стандартным веб-сервисом, который предоставляет WSDL документ с описанием всех методов и типов данных. Текущая версия сервиса работает только по протоколу HTTPS. Для большей совместимости с различными клиентами сервис основан на SOAP версии 1.1.
Взаимодействие с сервисом возможно одним из двух способов:
* Как с обычным веб-сервисом посредством SOAP запросов, WSDL доступен.
* Как с сервисом WCF (Windows Communication Foundation) - самый простой способ, если клиент под .NET Framework 3.5 или выше.
Логика обработки запросов не зависит от способа работы с сервисом.
При передаче строк и XML пакетов используется кодировка UTF-8.
Сервис не требует сессий при работе с ним, и все методы не зависят друг от друга с точки зрения очередности вызова. Таким образом, очередность вызова методов диктуется реализуемым алгоритмом для работы с сервисом.
Сервис требует авторизации для работы с ним, используются логин и пароль от личного кабинета SLETAT.RU.

=== Краткое описание возможностей ===

С помощью методов данного сервиса вы можете:
* Создать online-заявку на приобретение тура, при этом происходят E-Mail и СМС оповещения как для клиента-покупателя, так и для менеджера агентства;
* Получать информацию о ранее созданной заявке, при этом вы получаете возможность отправить клиента-покупателя на страницу выбранного платежного провайдера для оплаты заказа. Текущий платежный провайдер настраивается в личном кабинете SLETAT.RU.

== Подключение к сервису ==

Для начала работы с сервисом вам нужно зарегистрироваться на сайте https://www.sletat.ru и обратиться в службу поддержки SLETAT.RU (info@sletat.ru) для выдачи тестовой лицензии, при этом сообщив свой логин. После того, как лицензия будет выдана, можно начинать работать с API данного сервиса.
Для работы с сервисом вам нужно использовать WSDL документ, который расположен по адресу:

https://claims.sletat.ru/xmlgate.svc?singlewsdl

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

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

=== Старый клиент на .NET 1.0 - 2.0 ===

Добавьте в проект ссылку на WSDL документ используя Web Reference. После того, как ссылка была добавлена, ваш проект готов к работе с сервисом.
Ниже приведен пример вызова метода для создания online-заявки на приобретение тура по заданным RequestId, OfferId, SourceID:

<source lang="csharp">

using System;
using System.Collections.Generic;
using ClaimsServiceClient.ru.sletat.claims;

namespace ClaimsServiceClient
{
class Program
{
static void Main(string[] args)
{
// authentication info
AuthData authTicket = new AuthData();
authTicket.Login = "<your login>";
authTicket.Password = "<type password>";

// xml gate client and authentication ticket
XMLGate client = new XMLGate();
client.AuthInfo = authTicket;

// request definition
CreateClaimRequest request = new CreateClaimRequest
{
OfferIdSpecified = true,
RequestIdSpecified = true,
SourceIdSpecified = true,

OfferId = 1725432283,
RequestId = 61455627,
SourceId = 5,

Comments = "There are some comments",
Customer = new Customer
{
Address = "СПБ",
Email = "<........>@gmail.com",
FullName = "Смирнов Андрей Валерьевич",
Passport = "1122 5500",
Phone = "+7(921)<...-..-..>"
},

InitialURL = "https://www.google.com",
Tourists = new List<Tourist>
{
new Tourist
{
BirthDate = DateTime.Now,
BirthDateSpecified = true,

Citizenship = "Россия",
City = "СПБ",
Country = "Россия",

DateOfIssue = DateTime.Now,
DateOfIssueSpecified = true,

Email = "<........>@gmail.com",
Expires = DateTime.Now,
ExpiresSpecified = true,

FirstName = "Andrey",
Gender = Gender.Male,
PassportNumber = "11",
PassportSeries = "22",
Patronymic = "V",
Phone = "+7(921)<...-..-..>",
Surname = "Smirnov",
Title = Title.MR

}
}.ToArray()
};

// attempt to create online claim
var response = client.CreateClaim(request);

// futher we can analise the request from xml gate
if (response.OperationStatus)
{
// continue
}
}
}
}

</source>

Не забудьте указать логин и пароль вашей учетной записи на сайте SLETAT.RU.

Обратите также внимание на то, что требуется указывать поля _Specified для типов данных DateTime и int.

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

<source lang="csharp">

static void Main(string[] args)
{

// данные для авторизации на сервисе
AuthData authTicket = new AuthData();
authTicket.Login = "<type your login here>";
authTicket.Password = "<and password>";

// экземпляр клиента для обращения к XMLGate сервису для работы с online-заявками
using (XMLClaimsGateClient client = new XMLClaimsGateClient())
{
CreateClaimRequest request = new CreateClaimRequest
{
OfferId = 1,
RequestId = 2,
SourceId = 3,

Comments = "There are some comments",
Customer = new Customer
{
Address = "СПБ",
FullName = "Смирнов Андрей Валерьевич",
Passport = "1122 5500",

Email = "<email заказчика, на который будут приходить оповещения>",
Phone = "+7(921)...-..-.. <телефон заказчика, на который будут приходить
оповещения>"
},

InitialURL = "https://www.google.com",
Tourists = new List<Tourist>
{
new Tourist
{
BirthDate = DateTime.Now,

Citizenship = "Россия",
City = "СПБ",
Country = "Россия",

DateOfIssue = DateTime.Now,
Expires = DateTime.Now,

Title = Title.MR,
FirstName = "Andrey",
Patronymic = "V",
Surname = "Smirnov",

Gender = Gender.Male,

PassportNumber = "11",
PassportSeries = "22",

Email = "<email туриста>",
Phone = "<телефон туриста>"
}
}.ToArray()
};

var response = client.CreateClaim(authTicket, request);
}
}

</source>

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

== Версионность ==

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

'''WSDL''' — автоматически формируемый документ описывающий все контракты веб-сервиса, описывает их методы и используемые типы данных. Каждый контракт веб-сервиса имеет уникальное имя используемое для его идентификации. Эти имена также используются для указания версии, например, в виде даты публикации, или любым иным образом.
Текущая версия сервиса состоит из одного контракта, который использует имя:

urn:SletatRu:XMLClaimsGate:v1

Используется URN (Uniform Resource Name) для обозначения имени контракта и его версии. Все разрабатываемые сервисы имеют префикс SletatRu, после которого указывается название контракта, последним указывается его версия.

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

urn:SletatRu:XMLClaimsGate:v1

Используется URN (Uniform Resource Name) для обозначения имени контракта и его версии. Все разрабатываемые сервисы имеют префикс SletatRu, после которого указывается название контракта, последним указывается его версия.

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

urn:SletatRu:XMLClaimsGate:v2

Чтобы использовать новую версию контракта, клиенту необходимо указать нужную версию в SOAP конверте:

<source lang="xml">

<soap:Envelope>
<soap:Body>
<CreateClaim xmlns=" urn:SletatRu:XMLClaimsGate:v1">
…
</CreateClaim>
</soap:Body>
</soap:Envelope>

</source>

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

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

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

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

== Логика работы с сервисом ==
Используя сервис по работе с online-заявками, вам доступны следующие операции:

'''CreateClaim''' — используется для создания заявки на приобретение тура. Данная операция полностью аналогична ручному вводу данных о заказчике тура и списке туристов в форме ввода для регистрации заявки в результатах выдачи поискового модуля на сайте клиента;
После регистрации заявки она становится доступной для просмотра и редактирования в личном кабинете менеджера агентства по адресу:
https://sletat.ru/workspace/agencyorders.aspx

В качестве ответа от данной операции приходит флаг успешности операции, сообщение об ошибке в случае неуспешности попытки, и идентификатор '''ClaimIdentity''', который потом можно использовать для получения данных по данной заявке.
В вызове данной операции вы можете указать запрос на проведение актуализации тура ('''Actualize''').
В таком случае в дальнейшем вам необходимо учитывать состояние актуализации для выполнения последующих операций. Важно понимать, что сама актуализация может занимать некоторое время и выполняется асинхронно. Текущее состояние актуализации можно увидеть в результатах операций GetClaimInfo или GetActualization.
После успешного завершения актуализации стоимость тура будет изменена на новое полученное значение.

'''UpdateClaimToWasSentState''' — Переводит заказ в состояние «Отправлен на оплату». С указанной даты ссылка на оплату будет действительна в течение 48 часов (значение может быть изменено в настройках вашего аккаунта в разделе «Ограничения по платежам»:
https://sletat.ru/workspace/billingsettings.aspx?tab=restrictions).
Данную операцию необходимо использовать первой, если вы хотите, чтобы ссылка на оплату '''RedirectToPaymentPageURL''' из запроса '''GetClaimInfo''' была действительной.

ВАЖНО: использование данной операции оправдано, если только вы используете схему с предварительной обработкой тура менеджером. В случае прямой схемы оплаты тура данный шаг в обработке онлайн-заказа необязателен.

'''UpdateClaimToWasViewedState''' — Переводит заказ в состояние «Просмотрен (заказчиком)».
Данную операцию необходимо использовать как следующий шаг после создания заказа (СreateClaim) и регистрации даты выставленного к оплате счета ('''UpdateClaimToWasSentState''').

ВАЖНО: использование данной операции оправдано, если только вы используете схему с предварительной обработкой тура менеджером. В случае прямой схемы оплаты тура данный шаг в обработке онлайн-заказа необязателен.

Такой заказ в списке заказов будет выглядеть так:

'''GetClaimInfo''' — возвращает все необходимую информацию по ранее созданной заявке. Вместе с результатами данной операции вы также получаете специальным образом сформированный URL ('''RedirectToPaymentURL'''), который можно использовать для последующего редиректа покупателя на страницу оплаты того платежного провайдера, который был ранее выбран и настроен в личном кабинете: https://sletat.ru/workspace/billingsettings.aspx.
Обратите также внимание на поле '''PaymentIsAvailable'''. В случае, если данное поле имеет значение false, попытка пройти на страницу оплаты для совершения платежа закончится неудачей (см. также замечания относительно актуализации тура).

Для совершения платежа ранее созданный заказ должен быть сначала переведен в состояние «В оплату» с указанием даты фиксации выставленного к оплате счета, а затем должен быть переведен в состояние «Просмотрен (заказчиком)»

ВАЖНО: использование данных операций оправдано, если только вы используете схему с предварительной обработкой тура менеджером. В случае прямой схемы оплаты тура данный шаг в обработке онлайн-заказа необязательны.

Обращайте ваше внимание также на срок актуальности выставляемой к оплате ссылки ('''PayableUntil''').

'''GetActualization''' — возвращает текущее состояние актуализации тура, если она была ранее запрошена в методе '''CreateClaim''' ('''Actualize''').

Фактом завершения актуализации будет являться получение свойства '''CurrentState''' в структуре '''Actualization''', равного состояниям:

Completed, Failed, IncorrectCurrency, AuthenticationProblem, HotelIsInStop, DepartureIsInStop, ReturnIsInStop. (См. описание статусов далее)

'''GetPayments''' — возвращает список доплат в разрезе указанного через ClaimIdentity онлайн-заказа. Дополнительно выставляемые счета на доплаты формируются в личном кабинете SLETAT.RU.

== Методы ==

В данном разделе описаны все методы сервиса для работы с online-заявками на приобретение туров. К методам приведены примеры запросов и ответов в SOAP.
Все методы требуют авторизации, информация для авторизации (логин и пароль) передаётся в заголовке SOAP - AuthInfo:

<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>
<CreateClaim xmlns="urn:SletatRu:Contracts:XMLClaimsGate:v1" />
</soap:Body>
</soap:Envelope>

</source>

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

=== CreateClaim ===
Метод используется для регистрации online-заявки, которая становится доступной для последующей ее обработки менеджером агентства в личном кабинете на SLETAT.RU.
В новой версии в запросе можно указать необходимость провести актуализацию тура, что позволит получить актуальную стоимость тура на момент заказа со стороны туроператора.

'''Сигнатура:'''

CreateClaimResponse CreateClaim(CreateClaimRequest request)

Параметры:

'''CreateClaimRequest''' — параметр данного типа описывает всю структуру online-заявки и содержит следующие важные поля:

Tourist[] '''Tourists''' — список туристов.
Каждая запись представляет собой описание туриста, на которого оформляется тур, и может содержать следующие свойства:

{| class="wikitable"
|Title
|string
|Обращение. Возможные варианты: Unknown (не указано), MR (г-н), MRS (г-жа), INF (инфант), CHD (ребенок).
|-
|Gender
|byte
|Пол (при параметре Title со значениями INF и CHD). Возможные варианты: Unknown (не указано), Male (муж.), Female (жен.).
|-
|FirstName
|string
|Имя
|-
|Surname
|string
|Фамилия
|-
|Patronymic
|string
|Отчество
|-
|BirthDate
|datetime
|Дата рождения
|-
|Age
|byte
|Возраст, можно не указывать
|-
|Phone
|string
|Номер телефона
|-
|Email
|string
|Email
|-
|Country
|string
|Страна
|-
|City
|string
|Город проживания
|-
|PassportSeries
|string
|Серия паспорта
|-
|PassportNumber
|string
|Номер паспорта
|-
|DateOfIssue
|datetime
|Дата выдачи паспорта
|-
|IssuedBy
|string
|Кем выдан паспорт
|-
|Expires
|datetime
|Срок окончания действия паспорта
|-
|Citizenship
|string
|Гражданство
|}

'''Customer''' — Заказчик тура, именно на данного человека и его контактные данные будут отсылаться СМС оповещения и email

{| class="wikitable"
|FullName
|string
|ФИО заказчика
|-
|Phone
|string
|Телефон заказчика, именно этот телефон будет использоваться для СМС-оповещения и для связи со стороны турагентства
|-
|Email
|string
|Email заказчика, именно этот адрес будет использоваться для отправки Email-оповещений заказчику обо всех важных операциях над заявкой
|-
|Address
|string
|Адрес заказчика, одной строкой
|-
|Passport
|string
|Паспорт заказчика, одной строкой Серия-Номер
|-
|IssuedBy
|string
|Паспорт заказчика, поле «Кем выдан, когда» - 128 символов
|}

Для передачи вариантов перелета используются следующие поля:

AviaFlights - список выбранных авиаперелетов.

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
FlightType
|
byte
|
тип перелета: туда, обратно, внутренний перелет (при наличии пересадок) 
0 - вылет в страну отдыха, 1 - прибытие обратно, 2 - промежуточный рейс, пересадка
|-
|
DepartureCity
|
String
|
Город отправления
|-
|
ArrivalCity
|
string
|
Город прибытия
|-
|
AviaCompany
|
string
|
Авиакомпания
|-
|
Flight
|
string
|
Рейс
|-
|
DepartureDate
|
string
|
Дата отправления
|-
|
ArrivalDate
|
string
|
Дата прибытия
|-
|
ArrivalTime
|
string
|
Время прибытия (местное)
|-
|
DepartureAirport
|
string
|
Аэропорт отправления
|-
|
ArrivalAirport
|
string
|
Аэропорт прибытия
|-
|
Duration
|
int?
|
Длительность перелета в минутах
|-
|
Board
|
string
|
Борт
|-
|
AviaCompanyIataCode
|
string
|
Авиакомпания
|-
|
DepartureAirportIataCode
|
string
|
Код аэропорта отправления
|-
|
ArrivalAirportIataCode
|
string
|
Код аэропорта прибытия
|-
|
ResourceId
|
long?
|
Идентификатор перелета из актуализации
|}

ResourceId можно получить с помощью метода ActualizePrice.

{| class="wikitable"
|-
|
Название поля
|
Тип
|
Описание
|-
|
AviaFlightsPackageId
|
long?
|
Идентификатор группы перелетов.
|-
|
AviaFlightsSurcharge
|
int?
|
Сумма доплат за выбранные перелеты.
|-
|
AviaFlightsSurchargeCurrencyId
|
byte?
|
Валюта доплаты за авиаперелеты.
|}

Следующие поля описывают запрашиваемый тур:

{| class="wikitable"
|int
|SourceId
|Идентификатор туроператора в системе SLETAT.RU, может быть получен со стороны поискового сервиса
|-
|long
|OfferId
|Идентификатор предложения туроператора в системе SLETAT.RU, может быть получен со стороны поискового сервиса
|-
|int
|RequestId
|Идентификатор поискового запроса в системе SLETAT.RU, может быть получен со стороны поискового сервиса
|}

Следующие поля влияют на процесс обработки заказа в целом:

string '''InitialURL''' — данный параметр является адресом страницы, на которую будет произведен возврата после завершения процесса оплаты;

'''WorkflowType''' — данный параметр определяет тип обработки заказа.
На текущий момент существует две схемы:
* схема с предварительной обработкой заказа менеджером турагентства в личном кабинете SLETAT.RU,
* схема с прямой оплатой заказа сразу же на момент оформления заказа на сайте турагентства.

В зависимости от выбранной схемы данный параметр может принимать следующие значения:

Вариант с предварительной обработкой менеджером турагентства
'''Preprocessing = 0'''

Вариант с прямым переходом к холдированию денежных средств сразу же после заполнения заявки '''TwoStepsHolding = 1'''

bool '''Actualize''' — Данный признак позволяет указать, стоит проводить актуализацию стоимости тура или нет.

Важно понимать, что сама актуализация может занимать некоторое время и выполняется асинхронно. Текущее состояние актуализации можно увидеть в результате операции GetClaimInfo или GetActualization.
После успешного завершения актуализации стоимость тура будет изменена на новое полученное значение.
Также в случае успешно проведенной актуализации в онлайн-заказе будут сформированы записи об авиаперелетах.

Обратите внимание:
Если вы запросили проведение актуализации и сразу же пытаетесь отправить клиента для последующего редиректа на платежную страницу (не дождавшись завершения актуализации стоимости тура), то клиент уйдет на оплату, возможно, неактуальной стоимости тура.

Фактом завершения актуализации будет являться получение свойства CurrentState в структуре Actualization в ответе на запрос GetClaim,
равного состояниям: Completed, Failed, IncorrectCurrency, AuthenticationProblem, HotelIsInStop, DepartureIsInStop, ReturnIsInStop. (См. описание статусов далее)

В случае проведения актуализации окончательная стоимость Price тура будет равна:

Price = Стоимость тура от туроператора – Скидка, указанная в запросе

В случае создания заявки без актуализации окончательная стоимость тура Price будет равна:

Price = Стоимость тура из результатов поиска + Наценка турагентства на заданное направление (туроператор, страна) – Скидка, указанная в запросе

int '''DiscountAmount''' — Сумма скидки в рублях, применяемая к стоимости тура.

int '''PriceFromCustomer''' — Произвольная стоимость тура.

Скидка также применяется после актуализации стоимости тура у туроператора.

int '''DiscountPercentage''' — Сумма скидки в процентах, применяемая к стоимости тура.

Указывается в виде целочисленного значения от 0 до 100. Скидка также применяется после актуализации стоимости тура у туроператора. В случае, если указываются оба значения – DiscountAmount и DiscountPercentage – предпочтение отдается значению DiscountAmount (т.е. значение в процентах не используется).

'''Ответ:'''

'''CreateClaimResponse''' содержит флаг успешности операции CreateClaim, а также важный параметр ClaimIdentity, который можно использовать для последующих операций GetClaimInfo запроса данных по созданной заявке, обновления дат просмотра заказа и фиксации начала действия выставленного к оплате счета (актуальности ссылки для перехода к платежной странице) UpdateClaimToWasViewedState и UpdateClaimToWasSentState.

{| class="wikitable"
|OperationStatus
|bool
|Признак успешности операции
|-
|ServiceMessage
|string
|Описание результата операции
|-
|OrderIdentity
|string
|Сквозной номер заказа в рамках работы турагентства
|-
|ClaimIdentity
|string
|Идентификатор заявки в случае успешной операции
|}

SOAP запрос/пример:

<source lang="xml">

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SletatRu:XMLClaimsGate:v1" xmlns:urn1="urn:SletatRu:DataTypes:AuthData:v1" xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:b="urn:SletatRu:Contracts:ClaimsGate:DataTypes:XML:v1">
<x:Header>
<urn1:AuthInfo>
<urn1:Login>****</urn1:Login>
<urn1:Password>****</urn1:Password>
</urn1:AuthInfo>
</x:Header>
<x:Body>
<urn:CreateClaim>
<urn:request>
<a:Comments>There are some comments</a:Comments>
<a:Customer>
<a:Address>СПБ</a:Address>
<a:Email>guid.empty@gmail.com</a:Email>
<a:FullName>Смирнов Андрей Валерьевич</a:FullName>
<a:Passport>1122 5500</a:Passport>
<a:Phone>+7(921)354-33-47</a:Phone>
</a:Customer>
<a:InitialURL>https://www.google.com</a:InitialURL>
<a:OfferId>1836114757</a:OfferId>
<a:RequestId>2050697646</a:RequestId>
<a:SourceId>7</a:SourceId>
<a:Actualize>true</a:Actualize>
<a:DiscountAmount>500</a:DiscountAmount>
<a:DiscountPercentage>0</a:DiscountPercentage>
<b:Tourists>
<b:Tourist>
<b:BirthDate>2012-12-20T13:49:38.314034+04:00</b:BirthDate>
<b:Citizenship>Россия</b:Citizenship>
<b:City>СПБ</b:City>
<b:Country>Россия</b:Country>
<b:DateOfIssue>2012-12-20T13:49:38.315034+04:00</b:DateOfIssue>
<b:Email>guid.empty@gmail.com</b:Email>
<b:Expires>2012-12-20T13:49:38.315034+04:00</b:Expires>
<b:FirstName>Andrey</b:FirstName>
<b:PassportNumber>11</b:PassportNumber>
<b:PassportSeries>22</b:PassportSeries>
<b:Patronymic>V</b:Patronymic>
<b:Phone>+7(921)354-33-47</b:Phone>
<b:Surname>Smirnov</b:Surname>
</b:Tourist>
</b:Tourists>
</urn:request>
</urn:CreateClaim>
</x:Body>
</x:Envelope>

</source>

SOAP ответ/пример:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<CreateClaimResponse xmlns="urn:SletatRu:XMLClaimsGate:v1">
<CreateClaimResult xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:XML:v1" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<OperationStatus xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">true</OperationStatus>
<OrderIdentity xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">53</OrderIdentity>
<a:ClaimIdentity>20ad89d22d31c9a5cc5a50bc9f367407</a:ClaimIdentity>
<a:ServiceMessage i:nil="true"></a:ServiceMessage>
</CreateClaimResult>
</CreateClaimResponse>
</s:Body>
</s:Envelope>

</source>

==== CreateClaim – пример запроса на PHP ====

<source lang="php">

<?php
$searchParam = array(
'request' => array(
'WorkflowType' => 'TwoStepsHolding',
'Comments'=>'There are some comments',
'Customer'=> (object) array (
'Address'=>'СПБ',
'Email'=>'XXXXXXXXXXXXX@gmail.com',
'FullName'=>'Смирнов Андрей Валерьевич',
'Passport'=>'1122 5500',
'Phone'=>'+7(921)354-XX-XX'
),
'InitialURL'=>'https://www.google.com',
'OfferId'=>'1697033825',
'RequestId'=>'459295992',
'SourceId'=>'133',
'Actualize'=>true,
'DiscountAmount'=>'500',
'DiscountPercentage'=>'0',
'Tourists'=> array(
'Tourist' => array(
(object) array(
'BirthDate'=>'2012-12-20',
'Citizenship'=>'Россия',
'City'=>'СПБ',
'Country'=>'Россия',
'DateOfIssue'=>'2012-12-20T13:49:38.315034+04:00',
'Email'=>'XXXXXXXXXXXXXXX@gmail.com',
'Expires'=>'2012-12-20T13:49:38.315034+04:00',
'FirstName'=>'Andrey',
'PassportNumber'=>'11',
'PassportSeries'=>'22',
'Patronymic'=>'V',
'Phone'=>'+7(921)354-XX-XX',
'Surname'=>'Smirnov'
),
(object) array(
'BirthDate'=>'2012-12-20',
'Citizenship'=>'Россия',
'City'=>'СПБ',
'Country'=>'Россия',
'DateOfIssue'=>'2012-12-20',
'Email'=>XXXXXXXXXXXXXXXXX@gmail.com',
'Expires'=>'2012-12-20',
'FirstName'=>'Andrey',
'PassportNumber'=>'11',
'PassportSeries'=>'22',
'Patronymic'=>'V',
'Phone'=>'+7(921)354-XX-XX',
'Surname'=>'Smirnov'
),
)
)
)
);

$soapClient = new SoapClient('https://claims.sletat.ru/xmlgate.svc?wsdl');

$soapClient->__setSoapHeaders(new SoapHeader("urn:SletatRu:DataTypes:AuthData:v1", "AuthInfo", array(
"Login" => '<Логин от вашего аккаунта на SLETAT.RU>',
"Password"=> 'Пароль от вашего аккаунта на SLETAT.RU '
)));

$result = $soapClient->CreateClaim($searchParam);

echo '<pre>';
print_r($result);
echo '</pre>';

</source>

=== UpdateClaimToWasSentState ===

Метод используется для перевода заказа в состояние - "Отправлен на оплату". С указанной даты ссылка на оплату будет действительна в течении 48 часов (значение может быть изменено в настройках вашего аккаунта в разделе «Ограничения по платежам»:

https://sletat.ru/workspace/billingsettings.aspx?tab=restrictions).

Данную операцию необходимо использовать первой, если вы хотите, чтобы ссылка на оплату RedirectToPaymentPageURL из запроса GetClaimInfo была действительной.

Сигнатура:

BaseOperationResponse UpdateClaimToWasSentState(BaseUpdateClaimToWasSentStateRequest request)

Параметры:

BaseUpdateClaimToWasSentStateRequest – параметр данного типа содержит следующие поля:
string ClaimIdentity – Идентификатор заявки в случае успешной предыдущей операции CreateClaim
DateTime WasSentDate – Дата фиксации выставленного к оплате счета. Именно от этой даты будет анализироваться актуальность ссылки для перехода к платедной странице процессингового центра/
банка для совершения платежа.

Ответ:

В ответ от операции UpdateClaimToWasSentState вы получаете объект BaseOperationResponse, который содержит список следующих свойств:

{| class="wikitable"
|OperationStatus
|bool
|Флаг успешности операции
|-
|ServiceMessage
|string
|Ответ-сообщение от сервиса
|}

SOAP запрос/пример:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<UpdateClaimToWasSentState xmlns="urn:SletatRu:XMLClaimsGate:v1">
<request xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:ClaimIdentity>3f47cd1883de3722ddf4d42c41fc4be6</a:ClaimIdentity>
<a:WasSentDate>2013-04-30T00:42:12.7462574+04:00</a:WasSentDate>
</request>
</UpdateClaimToWasSentState>
</s:Body>
</s:Envelope>

</source>

SOAP ответ/пример:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<UpdateClaimToWasSentStateResponse xmlns="urn:SletatRu:XMLClaimsGate:v1">
<UpdateClaimToWasSentStateResult xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:OperationStatus>true</a:OperationStatus>
<a:ServiceMessage>HasBeenSentDate property has been updated successfully</a:ServiceMessage>
</UpdateClaimToWasSentStateResult>
</UpdateClaimToWasSentStateResponse>
</s:Body>
</s:Envelope>

</source>

=== UpdateClaimToWasViewedState ===

Переводит заказ в состояние - "Просмотрен (заказчиком)". Данную операцию необходимо использовать как следующий шаг после создания заказа (СreateClaim) и регистрации даты выставленного к оплате счета (UpdateClaimToWasSentState).
Сигнатура:

BaseOperationResponse UpdateClaimToWasViewedState(BaseUpdateClaimToWasViewedStateRequest request)

Параметры:
BaseUpdateClaimToWasViewedStateRequest – параметр данного типа содержит следующие поля:

{| class="wikitable"
|OperationStatus
|bool
|Флаг успешности операции
|-
|ServiceMessage
|string
|Ответ-сообщение от сервиса
|}

Ответ:

В ответ от операции UpdateClaimToWasViewedState вы получаете объект BaseOperationResponse, который содержит список следующих свойств:

bool OperationStatus Флаг успешности операции
string ServiceMessage Ответ-сообщение от сервиса

SOAP запрос/пример:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<UpdateClaimToWasViewedState xmlns="urn:SletatRu:XMLClaimsGate:v1">
<request xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:ClaimIdentity>3f47cd1883de3722ddf4d42c41fc4be6</a:ClaimIdentity>
<a:WasViewedDate>2013-04-30T01:42:15.4604126+04:00</a:WasViewedDate>
</request>
</UpdateClaimToWasViewedState>
</s:Body>
</s:Envelope>

</source>

SOAP ответ/пример:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<UpdateClaimToWasViewedStateResponse xmlns="urn:SletatRu:XMLClaimsGate:v1">
<UpdateClaimToWasViewedStateResult xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:OperationStatus>true</a:OperationStatus>
<a:ServiceMessage>HasBeenViewedDate property has been updated</a:ServiceMessage>
</UpdateClaimToWasViewedStateResult>
</UpdateClaimToWasViewedStateResponse>
</s:Body>
</s:Envelope>

</source>

=== GetClaimInfo ===

Метод используется для получения информации о ранее созданной заявке на приобретение тура, при этом проиcходит возврат актуальной информации о данной заявке после обработки ее менеджером агентства в личном кабинете на сайте SLETAT.RU.
В случае указания признака актуализации в операции CreateClaim в ответе будет присутствовать информация о текущем состоянии актуализации стоимости тура (см. ниже описание).
Сигнатура:
GetClaimResponse GetClaimInfo(GetClaimRequest request)

Параметры:
GetClaimRequest – параметр данного типа содержит единственный параметр:
string ClaimIdentity – Идентификатор заявки в случае успешной предыдущей операции
CreateClaim
Ответ:
В ответ от операции GetClaimInfo вы получаете объект GetClaimResponse, который содержит список следующих свойств:

{| class="wikitable"
|Number
|string
|Сквозной номер заказа (в рамках нумерации текущего агентства)
|-
|OperationStatus
|bool
|Флаг успешности операции
|-
|ServiceMessage
|string
|Ответ сообщение от сервиса
|-
|PaymentIsAvailable
|bool
|Признак доступности операции оплаты по данной заявке
|-
|RedirectToPaymentURL
|string
|Страница перехода на платежную систему
|-
|PayableUntil
|datetime
|Крайний срок оплаты выставленного счета
|-
|IsAdditionalPayment
|bool
|Признак дополнительно выставленной доплаты
|-
|AdditionalPayment
|bool
|В случае, если вы запросили информацию по дополнительно выставленному счету (доплаты), данный блок будет содержать описание доплаты. В случае IsAdditionalPayment == true в этом блоке будут аналогичные поля PaymentIsAvailable и RedirectToPaymentURL, которые вы должны использовать для выполнения редиректа покупателя на платежную страницу.
|}

{| class="wikitable"
|TourDefinition
|Определение тура
|-
|TouristsDefinition
|Определение списка туристов
|-
|ResidencesDefinition
|Проживание
|-
|AviaFlightsDefinition
|Определяет блок авиа- перелетов в определении тура
|-
|TransfersDefinition
|Определяет блок трансферов в определении тура
|-
|OptionsDefinition
|Определяет блок доп.услуг в определении
|-
|VISAsDefinition
|Определяет блок для оформления списка необходимых виз
|-
|InsurancesDefinition
|Определяет блок для оформления всех необходимых страховок в рамках определения тура
|}

{| class="wikitable"
| Status
| Статус заказа
|-
|Unknown = 0
|Данная заявка все еще не обработана менеджером агентства
|-
|AwaitingConfirmation = 1
|Заказ находится в ожидании подтверждения и начала оплаты; На данном этапе счет просто отправлен покупателю, но это не означает, что он просмотрен
|-
|PaymentPending = 2
|Клиент увидел свой предзаказ, находится на странице просмотра заказа, возможно начало оплаты; По сути, счет получен покупателем;
|-
|AwaitingHold = 3
|Клиент начал оплату, но результатов с платежной системы еще нет
|-
|AwaitingHoldVerification = 4
|Операция завершена, ждем результатов проверки ответа от платежной системы
|-
|HoldFailed = 5
|Проверка ответа от платежной системы дала отрицательный результат
|-
|Holded = 6
|Операция по оплате завершена
|-
|BookingRequest = 7
|Тур находится на этапе бронирования у туроператора
|-
|ConfirmedByTourOperator = 8
|Тур подтвержден
|-
|Canceled = 9
|Заказ отменен, если денежные средства были сняты, ждем операции Refund
|-
|AwaitingAccept = 10
|Заказ находится в ожидании снятия денег со счета клиента
|-
|Accepted = 11
|Деньги со счета клиента сняты
|-
|AcceptFailed = 12
|Операция по снятию денег со счета клиента закончилась неудачей
|-
|AwaitingRefund = 13
|Заказ был прекращен по какой- то причине, находимся в ожидании Refund
|-
|RefundFailed = 14
|Операция по возврату денежных средств клиенту закончилась неудачей
|-
|Refunded = 15
|Денежные средства возвращены клиенту
|-
|Completed = 16
|Заказ полностью выполнен; Документы выданы, на данном этапе работа с заказом закончена, никаких операций над ним больше не производится.
|}

{| class="wikitable"
|Actualization
| Текущее состояние актуализации
|-
|CurrentState
|Текущее состояние процесса актуализации, может принимать следующие значения:
|-
|Unknown = 0
|Состояние не определено
|-
|NotRequired = 1
|Актуализация не требуется
|-
|Required = 2
|Актуализация требуется
|-
|InProgress = 3
|Выполняется запрос туроператору, требуется завершение актуализации.
ВАЖНО:
Получив данное значение, вы понимаете, что сам процесс актуализации еще не завершен, и окончательная стоимость тура еще не получена от туроператора.
В этом состоянии попытка оплатить такой заказ будет прервана до момента завершения актуализации.
|-
|Completed = 4
|Актуализация успешно завершена
ВАЖНО:
Получив такой статус, вы можете быть уверены, что клиент уйдет на оплату актуальной стоимости тура, полученной от туроператора на момент создания заявки.
|-
|Failed = 5
|Актуализация не выполнена по какой-то причине, дополнительную информацию можно получить в сообщении ServiceMessage
ВАЖНО:
В поисковых модулях SLETAT.RU разрешается оплата такого тура, по которому актуализация стоимости тура не прошла по какой-либо причине.
|-
|IncorrectCurrency = 6
|Актуализация завершена успешно, но стоимость получена в валюте, отличной от RUB;
Данный статус говорит о том, что стоимость тура осталась без изменений (первоначальное значение из результатов поиска)
|-
|HotelIsInStop = 7
|Актуализация завершена успешно; Отель в стопе
ВАЖНО:
В поисковых модулях SLETAT.RU запрещается оплата такого тура, по которому получены «стопы».
|-
|DepartureIsInStop = 8
|Актуализация завершена успешно; Билеты на отправление в стопе
ВАЖНО:
В поисковых модулях SLETAT.RU запрещается оплата такого тура, по которому получены «стопы».
|-
|ReturnIsInStop = 9
|Актуализация завершена успешно; Билеты на возвращение в стопе
ВАЖНО:
В поисковых модулях SLETAT.RU запрещается оплата такого тура, по которому получены «стопы».
|-
|AuthenticationProblem = 10
|Актуализация не проводилась, проблемы с аутентификацией
ВАЖНО:
Такая ситуация может произойти только в том случае, если во внутренних процессах актуализации возникала проблема с аутентификацией доступа на сайт туроператора.
|}

{| class="wikitable"
|int Price
|В случае успешного выполнения данное поле будет содержать стоимость тура, полученную от туроператора
|-
|Currency
|В случае успешного выполнения данное поле будет тип валюты, в которой получена стоимость тура от туроператора. В процессе актуализации делается попытка получить стоимость тура в RUB, но не всегда возможно получить стоимость в этой валюте. В случае, если получили стоимость в валюте, отличной от RUB, текущее состояние актуализации будет IncorrectCurrency. Данное поле может содержать следующие значения:
RUB, USD, EUR
|}

Перелеты:

{| class="wikitable"
|DepartureFlight
|Дополнительно в процессе актуализации мы можем получить информацию об авиаперелете вылета
|-
|ReturnFlight
|Дополнительно в процессе актуализации мы можем получить информацию об авиаперелете вылета
|}

Перелеты могут содержать следующие поля:

{| class="wikitable"
|Name
|string
|Название рейса в произвольном виде
|-
|Flight
|string
|Номер рейса
|-
|DepartureAirport
|string
|Название аэропорта вылета
|-
|DestinationAirport
|string
|Название аэропорта прилета
|-
|Date
|string
|Дата вылета в формате YYYY-MM-DD
|-
|StartTime
|string
|Время вылета в формате HH:ss
|-
|EndTime
|string
|Время прилета в формате HH:ss
|}

SOAP запрос/пример:

<source lang="xml">

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SletatRu:XMLClaimsGate:v1" xmlns:urn1="urn:SletatRu:DataTypes:AuthData:v1" xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<x:Header>
<urn1:AuthInfo>
<urn1:Login>****</urn1:Login>
<urn1:Password>****</urn1:Password>
</urn1:AuthInfo>
</x:Header>
<x:Body>
<urn:GetClaimInfo>
<urn:request>
<a:ClaimIdentity>563392c831156d3f52f06d40816e49fd</a:ClaimIdentity>
</urn:request>
</urn:GetClaimInfo>
</x:Body>
</x:Envelope>

</source>

SOAP ответ/пример:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetClaimInfoResponse xmlns="urn:SletatRu:XMLClaimsGate:v1">
<GetClaimInfoResult xmlns:d4p1="urn:SletatRu:Contracts:ClaimsGate:DataTypes:XML:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Number xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">53</Number>
<OperationStatus xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">true</OperationStatus>
<PaymentIsAvailable xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">true</PaymentIsAvailable>
<RedirectToPaymentURL xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">https://globaltps.ru/beginholdinghandler.ashx?claimid=20ad89d22d31c9a5cc5a50bc9f367407</RedirectToPaymentURL>
<ServiceMessage i:nil="true" xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"></ServiceMessage>
<Status xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">Unknown</Status>
<Tour xmlns="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">
<Amount>6384.0000</Amount>
<AviaFlightsDefinition xmlns:d6p1="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<d6p1:AviaFlights></d6p1:AviaFlights>
<d6p1:BusinessClassPaymentCurrency>RUB</d6p1:BusinessClassPaymentCurrency>
<d6p1:BusinessClassSummaryPayment>0</d6p1:BusinessClassSummaryPayment>
<d6p1:Currency>RUB</d6p1:Currency>
<d6p1:SummaryPrice>0</d6p1:SummaryPrice>
<d6p1:TransportFeeCurrency>RUB</d6p1:TransportFeeCurrency>
<d6p1:TransportSummaryFee>0</d6p1:TransportSummaryFee>
</AviaFlightsDefinition>
<Comments>There are some comments</Comments>
<Currency>RUB</Currency>
<InsurancesDefinition xmlns:d6p1="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<d6p1:Currency>RUB</d6p1:Currency>
<d6p1:Insurances></d6p1:Insurances>
<d6p1:SummaryPrice>0</d6p1:SummaryPrice>
</InsurancesDefinition>
<OptionsDefinition xmlns:d6p1="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<d6p1:Currency>RUB</d6p1:Currency>
<d6p1:Options></d6p1:Options>
<d6p1:SummaryPrice>0</d6p1:SummaryPrice>
</OptionsDefinition>

<ResidencesDefinition xmlns:d6p1="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<d6p1:Residences>
<d6p1:Residence>
<d6p1:CheckIn>2012-12-23T00:00:00</d6p1:CheckIn>
<d6p1:CheckOut>2012-12-30T00:00:00</d6p1:CheckOut>
<d6p1:Comments i:nil="true"></d6p1:Comments>
<d6p1:CountryName>Египет</d6p1:CountryName>
<d6p1:Hotel>AL DIWAN (L)</d6p1:Hotel>
<d6p1:HotelStars>3*</d6p1:HotelStars>
<d6p1:HtPlaceName>SGL</d6p1:HtPlaceName>
<d6p1:Identity xmlns:d9p1="http://www.w3.org/2001/XMLSchema" i:type="d9p1:int">709</d6p1:Identity>
<d6p1:MealName>HB</d6p1:MealName>
<d6p1:Resort>Sharks Bay</d6p1:Resort>
<d6p1:RoomName>STANDARD ROOM</d6p1:RoomName>
</d6p1:Residence>
</d6p1:Residences>
</ResidencesDefinition>
<TourDefinition xmlns:d6p1="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<d6p1:CheckIn>2012-12-23T00:00:00</d6p1:CheckIn>
<d6p1:CheckOut>2012-12-30T00:00:00</d6p1:CheckOut>
<d6p1:CountryID>40</d6p1:CountryID>
<d6p1:CountryName>Египет</d6p1:CountryName>
<d6p1:Currency>RUB</d6p1:Currency>
<d6p1:DepartureCity>СПб</d6p1:DepartureCity>
<d6p1:Identity xmlns:d7p1="http://www.w3.org/2001/XMLSchema" i:type="d7p1:int">0</d6p1:Identity>
<d6p1:Nights>7</d6p1:Nights>
<d6p1:Price>6384</d6p1:Price>
<d6p1:Resort>Sharks Bay</d6p1:Resort>
<d6p1:SourceID>5</d6p1:SourceID>
<d6p1:SourceName>Верса</d6p1:SourceName>
<d6p1:TourName>Шарм 2012-2013</d6p1:TourName>
</TourDefinition>
<TouristsDefinition xmlns:d6p1="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<d6p1:Tourists>
<d6p1:Tourist>
<d6p1:Age>0</d6p1:Age>
<d6p1:BirthDate>2012-12-20T09:49:38.313</d6p1:BirthDate>
<d6p1:Citizenship>Россия</d6p1:Citizenship>
<d6p1:City>СПБ</d6p1:City>
<d6p1:Country>Россия</d6p1:Country>
<d6p1:DateOfIssue>2012-12-20T09:49:38.317</d6p1:DateOfIssue>
<d6p1:Email>guid.empty@gmail.com</d6p1:Email>
<d6p1:Expires>2012-12-20T09:49:38.317</d6p1:Expires>
<d6p1:FirstName>Andrey</d6p1:FirstName>
<d6p1:Gender>Unknown</d6p1:Gender>
<d6p1:ID>1095</d6p1:ID>
<d6p1:IsPrimaryContact>false</d6p1:IsPrimaryContact>
<d6p1:PassportNumber>11</d6p1:PassportNumber>
<d6p1:PassportSeries>22</d6p1:PassportSeries>
<d6p1:Patronymic i:nil="true"></d6p1:Patronymic>
<d6p1:Phone>+7(921)354-33-47</d6p1:Phone>
<d6p1:Surname>Smirnov</d6p1:Surname>
<d6p1:Title>Unknown</d6p1:Title>
<d6p1:TourClaimID>786</d6p1:TourClaimID>
</d6p1:Tourist>
</d6p1:Tourists>
</TouristsDefinition>
<TransfersDefinition xmlns:d6p1="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<d6p1:Currency>RUB</d6p1:Currency>
<d6p1:SummaryPrice>0</d6p1:SummaryPrice>
<d6p1:Transfers></d6p1:Transfers>
</TransfersDefinition>
<VISAsDefinition xmlns:d6p1="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<d6p1:Currency>RUB</d6p1:Currency>
<d6p1:SummaryPrice>0</d6p1:SummaryPrice>
<d6p1:VISAs></d6p1:VISAs>
</VISAsDefinition>
</Tour>

<Actualization xmlns:b="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<Currency>RUB</Currency>
<CurrentState>Completed</CurrentState>
<DepartureFlight>
<Date i:nil="true"/>
<DepartureAirport i:nil="true"/>
<DestinationAirport i:nil="true"/>
<EndTime i:nil="true"/>
<Flight>UN9651 17:55</Flight>
<Name>UN9651 17:55</Name>
<StartTime i:nil="true"/>
</DepartureFlight>
<OperationStatus>Successful</OperationStatus>
<Price>36355</Price>
<ReturnFlight>
<Date i:nil="true"/>
<DepartureAirport i:nil="true"/>
<DestinationAirport i:nil="true"/>
<EndTime i:nil="true"/>
<Flight>UN9652 21:20</Flight>
<Name>UN9652 21:20</Name>
<StartTime i:nil="true"/>
</ReturnFlight>
<ServiceMessage>Актуализация проведена успешно</ServiceMessage>
</Actualization>
</GetClaimInfoResult>
</GetClaimInfoResponse>
</s:Body>
</s:Envelope>

</source>

=== GetClaimInfo – пример запроса на PHP ===

Ниже приводится пример запроса на PHP. Обратите внимание на указания XML namespace в сигнатуре формирования soap-заголовка запроса.

<source lang="php">

<?php

$getClaimInfoParam = array(
'request' => array(
'ClaimIdentity' => '5aabf3ea346baea36839409c14140c88'
)
);

$soapClient = new SoapClient('https://claims.sletat.ru/xmlgate.svc?wsdl');

$soapClient->__setSoapHeaders(
new SoapHeader("urn:SletatRu:DataTypes:AuthData:v1", "AuthInfo",
array(
"Login" => '<Логин от вашего аккаунта на SLETAT.RU>',
"Password"=> 'Пароль от вашего аккаунта на SLETAT.RU ',
)));

$result = $soapClient->getClaimInfo($getClaimInfoParam);

</source>

=== GetActualization ===

Метод используется для получения текущего состояния актуализации тура. Запрос на проведение актуализации указывается в методе CreateClaim указанием свойства Actualize.
Сигнатура:
BaseGetActualizationResponse GetActualization(BaseGetActualizationRequest request)

Параметры:
BaseGetActualizationRequest – параметр данного типа содержит единственный параметр:
string ClaimIdentity – Идентификатор заявки в случае успешной предыдущей операции
CreateClaim
Ответ:
В ответ от операции GetActualization вы получаете объект BaseGetActualizationResponse, который содержит следующие свойства:

{| class="wikitable"
|Actualization
|
| Текущее состояние актуализации
|-
|CurrentState
|
|Текущее состояние процесса актуализации, может принимать следущие значения:
|-
|Unknown = 0
|
|Состояние не определено
|-
|NotRequired = 1
|
|Актуализация не требуется
|-
|Required = 2
|
|Актуализация требуется
|-
|InProgress = 3
|
|Выполняется запрос туроператору, требуется завершение актуализации.
|-
|Completed = 4
|
|Актуализация успешно завершена
|-
|Failed = 5
|
|Актуализация не выполнена по какой-то причине, дополнительную информацию можно получить в сообщении ServiceMessage
|-
|IncorrectCurrency = 6
|
|Актуализация завершена успешно, но стоимость получена в валюте, отличной от RUB;
Данный статус говорит о том, что стоимость тура осталась без изменений (первоначальное значение из результатов поиска)
|-
|HotelIsInStop = 7
|
|Актуализация завершена успешно; Отель в стопе
|-
|DepartureIsInStop = 8
|
|Актуализация завершена успешно; Билеты на отправление в стопе
|-
|ReturnIsInStop = 9
|
|Актуализация завершена успешно; Билеты на возвращение в стопе
|-
|AuthenticationProblem = 10
|
|Актуализация не проводилась, проблемы с аутенфикацие
|-
|Price
|int
|В случае успешно проведенной актуализации данное поле будет содержать актуальную стоимость тура
|-
|Currency
|string
|В случае успешно проведенной актуализации данное поле будет содержать актуальную валюту стоимости тура
|-
|DepartureFlight
|string
|Блок информации о перелете вылета
|-
|ReturnFlight
|string
|Блок информации об обратном перелете
|}

SOAP запрос/пример:
<source lang="xml">

<x:Envelope xmlns:x="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:SletatRu:XMLClaimsGate:v1" xmlns:urn1="urn:SletatRu:DataTypes:AuthData:v1" xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1">
<x:Header>
<urn1:AuthInfo>
<urn1:Login>****</urn1:Login>
<urn1:Password>****</urn1:Password>
</urn1:AuthInfo>
</x:Header>
<x:Body>
<urn:GetActualization>
<urn:request>
<a:ClaimIdentity>563392c831156d3f52f06d40816e49fd</a:ClaimIdentity>
</urn:request>
</urn:GetActualization>
</x:Body>
</x:Envelope>

</source>

SOAP ответ/пример:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Body>
<GetActualizationResponse xmlns="urn:SletatRu:XMLClaimsGate:v1">
<GetActualizationResult xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:OperationStatus>true</a:OperationStatus>
<a:ServiceMessage i:nil="true"/>
<a:Actualization xmlns:b="urn:SletatRu:Contracts:BillingServer:DataTypes:v1">
<b:Currency>RUB</b:Currency>
<b:CurrentState>Completed</b:CurrentState>
<b:DepartureFlight>
<b:Date>12.04.2014</b:Date>
<b:DepartureAirport>VKO-B</b:DepartureAirport>
<b:DestinationAirport>BANGKOK (BKK)</b:DestinationAirport>
<b:EndTime>12:15</b:EndTime>
<b:Flight>I4 9555</b:Flight>
<b:Name>VKO-B –› BANGKOK (BKK) ~ 12.04.2014 23:50 ~ I4 9555 ~
Economy</b:Name>
<b:StartTime>23:50</b:StartTime>
</b:DepartureFlight>
<b:OperationStatus>Successful</b:OperationStatus>
<b:Price>52140</b:Price>
<b:ReturnFlight>
<b:Date>20.04.2014</b:Date>
<b:DepartureAirport>BANGKOK (BKK)</b:DepartureAirport>
<b:DestinationAirport>VKO-B</b:DestinationAirport>
<b:EndTime>22:45</b:EndTime>
<b:Flight>I4 9556</b:Flight>
<b:Name>BANGKOK (BKK) –› VKO-B ~ 20.04.2014 15:00 ~ I4 9556 ~
Economy</b:Name>
<b:StartTime>15:00</b:StartTime>
</b:ReturnFlight>
<b:ServiceMessage>Актуализация проведена успешно</b:ServiceMessage>
</a:Actualization>
</GetActualizationResult>
</GetActualizationResponse>
</s:Body>
</s:Envelope>

</source>

=== GetPayments ===

Метод используется для получения списка доплат в разрезе указанного через ClaimIdentity онлайн-заказа. Дополнительно выставляемые счета на доплаты формируются в личном кабинете SLETAT.RU.
Сигнатура:
public BaseGetPaymentsResponse GetPayments(BaseGetPaymentsRequest request)

Параметры:
BaseGetPaymentsRequest – параметр данного типа содержит единственный параметр:
string ClaimIdentity – Идентификатор заявки в случае успешной предыдущей операции
CreateClaim
Ответ:
В ответ от операции GetPayments вы получаете объект BaseGetPaymentsResponse, который содержит следующие свойства:

{| class="wikitable"
|AdditionalPayments
| Список блоков с описанием дополнительно выставленных счетов на оплату
|-
|ClaimIdentity
|Идентификатор доплаты, который можно использовать в методе GetClaimInfo
|-
|RedirectToPaymentPageURL
|URL для перехода к платежной странице на оплату выставленного счета
|-
|Number
|Сквозной номер доплаты в рамках заказа
|-
|Status
|Статус доплаты, описывает состояния, аналогичные состоянию по заказу в целом
|-
|Description
|Описание доплаты
|-
|Amount
|Сумма доплаты
|-
|Currency
|Валюта доплаты
|-
|PaymentIsAvailable
|Признак допустимости проведения оплаты по выставленному счету
|-
|PayableUntil
|Срок действия выставленной доплаты
|}

SOAP запрос/пример:
<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetPayments xmlns="urn:SletatRu:XMLClaimsGate:v1">
<request xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:ClaimIdentity><Claim Identity></a:ClaimIdentity>
</request>
</GetPayments>
</s:Body>
</s:Envelope>

</source>

SOAP ответ/пример:

<source lang="xml">

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetPaymentsResponse xmlns="urn:SletatRu:XMLClaimsGate:v1">
<GetPaymentsResult xmlns:a="urn:SletatRu:Contracts:ClaimsGate:DataTypes:v1"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:OperationStatus>true</a:OperationStatus>
<a:ServiceMessage i:nil="true"/>
<a:AdditionalPayments>
<a:BaseAdditionalPaymentInfo>
<a:Amount>5400.0000</a:Amount>
<a:ClaimIdentity>a3466de39b8eb021099e47d8e00aaf61</a:ClaimIdentity>
<a:Currency>RUB</a:Currency>
<a:Description>Топливный сбор</a:Description>
<a:Number>1</a:Number>
<a:PayableUntil>04.04.2014 11:30</a:PayableUntil>
<a:PaymentIsAvailable>false</a:PaymentIsAvailable>
<a:RedirectToPaymentPageURL>https://www.billingserver.com/beginholdinghandler.ashx?claimid=a3466de39b8eb021099e47d8e00aaf61</a:RedirectToPaymentPageURL>
<a:Status>AwaitingConfirmation</a:Status>
</a:BaseAdditionalPaymentInfo>

<a:BaseAdditionalPaymentInfo>
<a:Amount>2000.0000</a:Amount>
<a:ClaimIdentity>c2e744d78d6b7cf925e00ea54ba59f01</a:ClaimIdentity>
<a:Currency>RUB</a:Currency>
<a:Description>Оформление визы</a:Description>
<a:Number>5</a:Number>
<a:PayableUntil>05.04.2014 14:46</a:PayableUntil>
<a:PaymentIsAvailable>false</a:PaymentIsAvailable>
<a:RedirectToPaymentPageURL>https://www.billingserver.com/beginholdinghandler.ashx?claimid=c2e744d78d6b7cf925e00ea54ba59f01</a:RedirectToPaymentPageURL>
<a:Status>Accepted</a:Status>
</a:BaseAdditionalPaymentInfo>
</a:AdditionalPayments>
</GetPaymentsResult>
</GetPaymentsResponse>
</s:Body>
</s:Envelope>

</source>