Мастер-Тур(15):API для разработки онлайн поиска и бронирования — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Выгрузка актуальных типов туров (ActualizeTourType))
Строка 521: Строка 521:
 
** '''Name''' – название страны
 
** '''Name''' – название страны
 
** '''Key''' – идентификатор страны
 
** '''Key''' – идентификатор страны
** '''DestinationType''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+
** '''DestinationType''' – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
 
** '''IsExist''' – не используется
 
** '''IsExist''' – не используется
 
** '''Data''' – массив данных для контекстного поиска
 
** '''Data''' – массив данных для контекстного поиска
Строка 703: Строка 703:
 
** '''departureCityKeys *''' – идентификатор города(ов) отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
 
** '''departureCityKeys *''' – идентификатор города(ов) отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''terms''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
** '''terms''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
Строка 749: Строка 749:
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''tourTypes *''' – идентификатор типа тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
 
** '''tourTypes *''' – идентификатор типа тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
 
* Возвращаемый результат:
 
* Возвращаемый результат:
Строка 785: Строка 785:
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''tourDate *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 
** '''tourDate *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 
** '''tourTypes *''' – идентификатор типа(ов) тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
 
** '''tourTypes *''' – идентификатор типа(ов) тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
Строка 825: Строка 825:
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false)
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false)
 
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
 
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
** '''DestinationType *''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''AdultCount *''' – количество взрослых
 
** '''AdultCount *''' – количество взрослых
Строка 2580: Строка 2580:
 
* Принимаемые параметры ( '''*''' – обязательный):
 
* Принимаемые параметры ( '''*''' – обязательный):
 
** '''DepartureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
 
** '''DepartureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
** '''DestinationType *''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''Dates *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 
** '''Dates *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
Строка 10 288: Строка 10 288:
 
** '''Name''' – название
 
** '''Name''' – название
 
** '''Key''' – ключ страны
 
** '''Key''' – ключ страны
** '''DestinationType''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''DestinationType''' – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
 
** '''IsExist''' – информация о том, есть ли в этой стране актуальные программы туров (true/false)
 
** '''IsExist''' – информация о том, есть ли в этой стране актуальные программы туров (true/false)
  
Строка 10 332: Строка 10 332:
 
** '''departureCity *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']])
 
** '''departureCity *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']])
 
** '''destination *''' – ключ страны (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']])
 
** '''destination *''' – ключ страны (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']])
** '''destinationType *''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+
** '''destinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
** '''term *''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
** '''individualTitle ''' – перевод для программы тура с ключом 0 (Индивидуально)
 
** '''individualTitle ''' – перевод для программы тура с ключом 0 (Индивидуально)
Строка 10 419: Строка 10 419:
 
** '''isFromBasket *''' – всегда false
 
** '''isFromBasket *''' – всегда false
 
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
 
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
** '''DestinationType *''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''DestinationKey *''' – идентификатор страны прибытия (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']])
 
** '''DestinationKey *''' – идентификатор страны прибытия (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']])
 
** '''AdultCount *''' – количество взрослых
 
** '''AdultCount *''' – количество взрослых
Строка 11 718: Строка 11 718:
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false).
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false).
 
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
 
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
** '''DestinationType *''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''AdultCount *''' – количество взрослых
 
** '''AdultCount *''' – количество взрослых

Версия 16:47, 5 марта 2025

Версия статьи от 5-03-2025.

Поддерживаемые версии ПК «Мастер-Тур»:
Начиная с 15 версии


Содержание

 [убрать

Введение

Данный web-сервис служит для разработки собственного сайта туроператору на основе API.

Установка

Для работы с web-сервисом необходимо на отдающей стороне установить службу поиска.
После установки web-сервис будет доступен по адресу http://значение настройки "serviceAddress" в TourSearchOwin/"название метода" (пример: http://localhost:9000/TourSearchOwin/Settings)

Список методов

Последовательность вызова методов сервиса
Последовательность вызова методов сервиса

Авторизация (Token)

Метод производит получение авторизационного токена (описание стандарта).

  • Формат запроса:
    • POST .../TourSearchOwin/Token?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/x-www-form-urlencoded
  • Принимаемые параметры POST запроса ( * – обязательный):
    • grant_type * – текст password
    • username * – логин представителя партнера или частного лица
    • password * – пароль представителя партнера или частного лица
  • Возвращаемый результат:
    • access_token – токен
    • token_type – тип токена
    • expires_in – код
    • userKey – ключ пользователя
    • userType – тип пользователя (0 – представитель партнера, 1 – частное лицо)
    • .issued – дата получения
    • .expires – дата действия до
развернутьПример


Выгрузка настроек службы поиска (Settings)

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

  • Формат запроса:
    • GET .../TourSearchOwin/Settings?
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • ChildAgesSetting – регулируется настройкой максимальный возраст ребенка (массив возрастов, при которых турист будет считаться ребенком
    • DurationSetting – регулируется настройкой максимальная продолжительность тура (массив продолжительностей, доступных в фильтрах для поиска)
    • RoundServiceSetting – признак округления цены (количество знаков после запятой)
    • CacheReady – статус готовности службы поиска к работе (true/false)
    • EnableFiterTree – устаревшая настройка, будет убрана (по умолчанию всегда false)
    • EnableActualFilters – включены ли актуальные фильтры (true/false)
    • CorrectLicense – проверка лицензии (true/false)
    • CorrectLicenseMessage – сообщение, если проверка лицензии не прошла
    • IsCorrectUser – проверка наличия пользователя в таблице Userlist, под которым запущена служба поиска (true/false)
    • IsShowCitizenAuthTourist – настройка запрашивать гражданство при регистрации частного лица (true/false)
    • IsShowFewCountPlaces – настройка отображения числового значения оставшихся мест, когда достигнуто значение «Мало» (true/false)
    • IsShowBusTransferPlaces – использовать фильтр наличие мест на автобусный переезд в поиске (true/false)
    • UseBusSeatChecks – план рассадки автобусного переезда (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
    • UseTransferSeatChecks – план рассадки трансфера (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
    • IsShowFiltersByCity – отображать фильтр по городам на главной странице поиска (true/false)
    • CheckRealCourses – включена ли проверка курсов реальных валют при поиске (true/false)
    • CommonImagesFolderPath – путь к папке для хранения изображений
    • UseApplyFiltersButton – отображать кнопку «Применить фильтры» (true/false)
    • AutoSearchFiltersTimeout – задержка между выбором дополнительных фильтров и выводом результатов (в секундах)
    • UseFastSearchAlgoritm – использовать быстрый алгоритм поиска (true/false)
    • MaxSearchDatesCountClient – максимальное количество дат, которое будет обрабатываться в клиенте поиска
    • MaxDurationsCountClient – максимальное количество продолжительностей, которое будет обрабатываться в клиенте поиска
    • UseHotelCategoryGlobalCodeInDopFilter – использовать глобальные коды категорий отелей в поиске
    • UsePansionGlobalCodeInDopFilter – использовать глобальные коды питаний в поиске
    • CheckTouristDataInBasket – проверять корректность данных туристов
    • SimpleRegistration – упрощенная регистрация частного лица
    • ShowHotelImagesInSearch – показывать описание и изображения отелей в поиске
    • CacheReadyMessage – сообщение о готовности службы поиска или службы расчета актуальных фильтров. Варианты возвращаемых значений:
      • <add key="enableActualFilters" value="true" /> - CacheReady: true = CacheReadyMessage: "Кеш инициализирован"; CacheReady: false = CacheReadyMessage: "Кеш еще не инициализирован"
      • <add key="enableActualFilters" value="false" /> - Служба актуальных фильтров недоступна (выключена, неверно указана ссылка на нее и т.п.) CacheReadyMessage: "Служба актуальных фильтров недоступна"; Служба актуальных фильтров доступна но не готова - CacheReadyMessage: "Кеш службы актуальных фильтров не инициализирован"; Служба актуальных фильтров готова, а основная служба не готова - CacheReadyMessage: "Кеш ещё не инициализирован"; Служба актуальных фильтров готова, и основная служба готова - CacheReadyMessage: "Кеш ещё инициализирован".
развернутьПример



Выгрузка списка валют в онлайне (Currency)

Метод возвращает список используемых валют.

  • Формат запроса:
    • GET .../TourSearchOwin/Currency
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • Code – код валюты
    • Name – наименование валюты
    • IsMain – признак валюты «Главная»
    • IsNational – признак валюты «Национальная»
    • IsoCode – ISO код валюты
    • IsShowInSearch – признак показывать ли валюту в поиске
    • Symbol – символ валюты (обрабатывается с 15.7)
    • Key – идентификатор валюты


развернутьПример



Выгрузка курсов валют (CurrencyRates) начиная с 15.7

Полный аналог метода Выгрузка курсов валют (GetCurrencyRates)
Метод возвращает список курсов валют, актуальных на дату запроса. Курсы отображаются только для тех валют, которые отмечены в справочнике признаком Отображать в онлайне

  • Формат запроса:
    • GET .../TourSearchOwin/CurrencyRates
  • Принимаемые параметры:
    • dateFrom – начальная дата, от которой вывести список курсов валют, в формате DD.MM.YYYY, не обязательный параметр
    • dateTo – конечная дата, до которой вывести список курсов валют, в формате DD.MM.YYYY, не обязательный параметр
  • Возвращаемый результат:
    • baseCurrencyId – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке basketCurrency в конфигурационном файле (обрабатывается с релиза 15.6)
    • currencyId – идентификатор валюты, курс которой приводится
    • rate – курс валюты (отношение currencyId к baseCurrencyId)
    • date – дата, на которую был зарегистрирован выводимый курс валюты
развернутьПример


Выгрузка списка всех валют (getAllCurrencies)

Метод возвращает список всех валют.

  • Формат запроса:
    • GET .../TourSearchOwin/AllCurencies/getAllCurrencies
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • Code – код валюты
    • Name – наименование валюты
    • IsMain – признак валюты «Главная»
    • IsNational – признак валюты «Национальная»
    • IsoCode – ISO код валюты
    • IsShowInSearch – признак показывать ли валюту в поиске
    • Symbol – символ валюты (обрабатывается с 15.7)
    • Key – идентификатор валюты
развернутьПример



Получение сконвертированных цен (convertFilterPrice)

Метод возвращает сконвертированные цен для допфильтра Цена (используется в canary)

  • Формат запроса:
    • GET .../TourSearchOwin/AllCurencies/convertFilterPrice
  • Принимаемые параметры ( * – обязательный):
    • SourceRateKey * – ключ исходной валюты конвертации
    • TargetRateKey * – ключ валюты, в которую будет произведена конвертация
    • MinPrice * – значение минимальной цены, которое будет участвовать в конвертации
    • MaxPrice * – значение максимальной цены, которое будет участвовать в конвертации
  • Возвращаемый результат:
    • m_Item1 – сконвертированная минимальная цена
    • m_Item12 – сконвертированная максимальная цена
развернутьПример


Выгрузка квотируемых услуг системы (QuotedServices)

Метод производит выгрузку услуг с признаком «Квотируемая»

  • Формат запроса:
    • GET .../TourSearchOwin/QuotedServices
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • Key – идентификатор услуги
    • Code – код услуги
    • Name – наименование услуги (русский)
    • NameLat – наименование услуги (английский)
    • IsDuration – наличие продолжительности у услуги
    • IsCity – наличие города у услуги
    • IsSubCode1 – признак наличия SubCode1 у услуги
    • IsSubCode2 – признак наличия SubCode2 у услуги
    • Quoted – признак квотируемости услуги
    • CheckGeoPoint – наличие геоточек у услуги
    • IsRoute – признак маршрутной услуги
    • IsPartnerBasedOn – признак сопоставления партнера услуги в зависимости от отеля
    • Control – идентификатор статуса услуги
развернутьПример


Выгрузка актуальных городов отправления (departureCities)

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

  • Формат запроса:
    • GET .../TourSearchOwin/departureCities?
  • Принимаемые параметры:
    • нет принимаемых параметров
  • Возвращаемый результат:
    • Key – идентификатор города
    • Name – название города
развернутьПример


Выгрузка актуальных стран (Destination)

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

  • Формат запроса:
    • GET .../TourSearchOwin/Destination?
  • Принимаемые параметры ( * – обязательный):
    • departureCities * – идентификатор города(ов) отправления (из контроллера .../TourSearchOwin/departureCities?)
    • type – настройка easySearchFilter (0/не указано - настройка выключена, 1 - настройка включена)
    • term – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Name – название страны
    • Key – идентификатор страны
    • DestinationType – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
    • IsExist – не используется
    • Data – массив данных для контекстного поиска
      • CityKey – код города
      • CityName – Название
      • HotelKey – код отеля
      • HotelName – название отеля
      • ResortKey – код курорта
      • ResortName – название курорта


развернутьПример


Выгрузка актуальных городов (ActualizeCities)

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

  • Формат запроса:
    • GET .../TourSearchOwin/ActualizeCities?
  • Принимаемые параметры ( * – обязательный):
    • cityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • term – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Key – идентификатор города
    • Name – название города
развернутьПример


Выгрузка актуальных типов туров (ActualizeTourType)

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

  • Формат запроса:
    • GET .../TourSearchOwin/ActualizeTourType?
  • Принимаемые параметры ( * – обязательный):
    • departureCityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
    • terms – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Key – идентификатор типа тура
    • Name – название типа тура
    • ParentId – идентификатор группы, к которой относится данный тип тура (если тип тура не относится к группе, то возвращается null)
развернутьПример


Выгрузка актуальных дат заездов (TourDate)

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

  • Формат запроса:
    • GET .../TourSearchOwin/TourDate?
  • Принимаемые параметры ( * – обязательный):
    • departureCity * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
    • Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • tourTypes * – идентификатор типа тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны
  • Возвращаемый результат:
    • массив дат
развернутьПример


Выгрузка актуальных продолжительностей (Duration)

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

  • Формат запроса:
    • GET .../TourSearchOwin/Duration?
  • Принимаемые параметры ( * – обязательный):
    • departureCity * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
    • Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • tourDate * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • tourTypes * – идентификатор типа(ов) тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны
  • Возвращаемый результат:
    • массив продолжительностей (в днях)
развернутьПример


Поиск туров (Tour)

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

  • Формат запроса:
    • GET .../TourSearchOwin/Tour?
  • Принимаемые параметры ( * – обязательный):
    • DepartureCityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
    • PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
    • isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false)
    • isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
    • DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • AdultCount * – количество взрослых
    • ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • CurrencyName * – код валюты
    • AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • MinPrice * – минимальная цена (по умолчанию не задана, передается NaN)
    • MaxPrice – максимальная цена (по умолчанию не передается)
    • Groups – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
    • HotelScheme – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры:
      • TemplateId – идентификатор шаблона услуги,
      • DurationInNight – продолжительность отеля в ночах,
      • Code – ключ отеля,
      • PacketKey – ключ пакета,
      • PartnerKey – ключ партнера
      • GDSProviderId – ключ провайдера из внешней системы
      • TotalTourDuration – общая продолжительность тура в днях
    • BusTransferPointKeys – данный признак проставляется в true в том случае, когда происходит запрос вариантов проживания (кнопка Варианты) в автобусных переездах
    • TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
    • TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
    • TourType – идентификатор типа(ов) тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны. Возможна множественная передача параметров.
    • Tour – ключ программы тура (дополнительный фильтр)
    • Duration – продолжительность тура (дополнительный фильтр)
    • DateTour – дата тура (дополнительный фильтр)
    • HotelResort – ключ курорта отеля (дополнительный фильтр)
    • HotelCity – ключ города отеля (дополнительный фильтр)
    • HotelType – ключ признака отеля (дополнительный фильтр)
    • HotelStars – ключ категории отеля (дополнительный фильтр)
    • Hotel – ключ отеля (дополнительный фильтр)
    • Pansions – ключ питания (дополнительный фильтр)
    • Airline – ключ авиакомпании (дополнительный фильтр)
    • AirportDeparture – ключ аэропорта вылета (дополнительный фильтр)
    • AirportArrival – ключ аэропорта прилета (дополнительный фильтр)
    • CityIds – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны. Возможна множественная передача параметров.
    • TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
    • TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
    • TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
    • TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
    • ArrivalFlightNoTransfer – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
    • DepartureFlightNoTransfer – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
    • DepartureFlightNumberTransfer – наличие пересадок в прямом направлении (1 – одна пересадка, 2 – две пересадки и более, 3 – одна пересадка совместно с двумя пересадками и более). Обрабатывается начиная с релиза 15.3.
    • ArrivalFlightNumberTransfer – наличие пересадок в обратном направлении (1 – одна пересадка, 2 – две пересадки и более, 3 – одна пересадка совместно с двумя пересадками и более). Обрабатывается начиная с релиза 15.3.
    • Tariff – ключ класса авиаперелета (дополнительный фильтр)
    • CombineAirlines — разрешить комбинировать авиаперелеты (дополнительный фильтр). Параметр применяется только при наличии параметра airline. Обрабатывается начиная с релиза 15.3.
    • CombineTariffs — разрешить комбинировать классы перелета (дополнительный фильтр). Параметр применяется только при наличии параметра tariff. Обрабатывается начиная с релиза 15.3.
    • FlightCityDeparture – ключ город вылета в параметрах авиаперелета (дополнительный фильтр)
    • CityDeparture – ключ города начала поездки (дополнительный фильтр)
    • RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
    • GroupGuid – используется для получения турпрограмм по уникальному ключу из кэша при использовании группировки. Примеры использования. GroupGuid=00000000-0000-0000-0000-000000000000 – при первом запросе от локальной системы. GroupGuid=936DA01F-9ABD-4d9d-80C7-02AF85C822A8 (уникальный ключ) – передается на клиент от первого запроса из внешней системы. С данным уникальным ключом осуществляется второй запрос от внешней системы. Далее происходит получение значений по данному уникальному ключу. Обрабатывается начиная с релиза 15.4.
    • IsGroupingTourAlreadyMerge – определяет слияние данных турпрограмм от локальной системы с данными от внешней системы при использовании группировки. Примеры использования. IsGroupingTourAlreadyMerge=false – полученные данные от локальной системы не объединены с данными от внешней системы. На клиенте осуществляется объединение данных турпрограмм с последующей сортировкой по минимальной цене. IsGroupingTourAlreadyMerge=true – полученные данные от локальной системы уже объединены с данными от внешней системы. На клиенте осуществляется только сортировка по минимальной цене. Обрабатывается начиная с релиза 15.4.
    • SearchId – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.


  • Возвращаемый результат:
    • CheckMessages – сообщения для логики проверки тура (не используется)
    • Message – сообщение об ошибке
      • Key – код ошибки
      • Value – сообщение об ошибке
    • Result – результаты поиска
      • Key – идентификатов программы тура
      • Name – название программы тура
      • TourUrl – ссылка на программу тура
      • BookingConditions – условия бронирования программы туров
      • StartDate – дата начала тура
      • Duration – продолжительность тура (в днях)
      • DurationInNight – продолжительность проживания (в ночах)
      • Types – идентификатор типа туров
      • Cost – цена тура
      • Rate – код валюты тура
      • CityDepature – город отправления
        • Key – идентификатор города отправления
        • Value – название города отправления
      • CountryId – всегда возвращается ключ 0
      • Services – услуги в туре
        • DepartureCity – город отправления
          • Key – идентификатор
          • Value – название
        • DepartureCountry – страна отправления
          • Key – идентификатор
          • Value – название
        • ArrivalCity – город прибытия
          • Key – идентификатор
          • Value – название
        • ArrivalCountry – страна прибытия
          • Key – идентификатор
          • Value – название
        • DepartureAirport – аэропорт отправления
          • Key – идентификатор
          • Value – название
        • ArrivalAirport – аэропорт прибытия
          • Key – идентификатор
          • Value – название
        • Airline – авиакомпания
          • Key – идентификатор
          • Value – название
        • Aircraft – воздушное судно
          • Key – идентификатор
          • Value – название
        • Flight – рейс
          • Key – идентификатор
          • Value – название
        • DepartureTime – время вылета
        • ArrivalTime – время прилета
        • EndDateTime – дата и время прилета
        • FlightDetails – информация об авиаперелете
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – название тарифа
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – название
        • FlightSetting – внутренняя информация о перелете из программы туров
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор перелета (внутренняя информация из программы туров)
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
      • NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
        • ServiceName – название типа услуги
        • City – объект город
          • Key – ключ города
          • Value – название города
        • Country – объект страна
          • Key – ключ страны
          • Value – название страны
        • Code – объект код услуги
          • Key – ключ услуги
          • Value – название услуги
        • ByScheduler – флаг услуга по расписанию или нет
        • Details – объект детализация услуги
          • SubCode1 – объект доп. описание 1
            • Key – ключ доп. описания 1
            • Value – название доп. описания 1
          • SubCode2 – объект доп. описание 2
            • Key – ключ доп. описания 2
            • Value – название доп. описания 2
          • Date – дата услуги
          • IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
          • Cost – цена
          • QuotaStatus – объект информация по квотам
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – идентификатор партнера
          • ByPax – признак цены за человека
          • Partner – объект партнер (не заполняется)
            • Key – ключ (не заполняется)
            • Value – название (не заполняется)
        • ParentId – идентификатор родительской услуги (для вложенных услуг)
        • PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
        • Id – идентификатор услуги
        • SvKey – ключ типа услуги
        • IsSubCode1 – наличие доп. описания 1
        • IsSubCode2 – наличие доп. описания 2
        • IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – скрытая ли услуга
        • IsDeleted – удаляемая ли услуга
        • IsNotCalculate – не рассчитываемая ли услуга
        • PacketId – пакет услуги
        • Index – индекс услуги
      • MinCostServicesComposition – массив состав услуг минимальной цены
        • Key – ключ
          • TemplateId – идентификатор шаблона
          • PatternId – идентификатор вкладки
          • SettingId – идентификатор услуги
        • Value – значение
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • CountryId – страна услуги
          • CityId – город услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
        • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
          • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
          • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
            • SpecialKey – ключ акции
            • SpecialName – название акции
            • SpecialType – тип акции
            • NewPrice – цена после применения акции
            • OldPrice – цена до применения акции
            • ShowOnline – нужно ли показывать акцию в поиске
            • UntilDate – акция действует при совершении покупки до указанной даты
            • Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
              • NightsFrom (для типа PayStay) – ночей от
              • NightsTo (для типа PayStay) – ночей до
              • NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
              • OperationType (для типа PayStay) – тип действия
              • SpecialNightType (для типа PayStay) – тип бесплатной ночи
              • DurationFrom (для типа KickBack) – ночей от
              • DurationTo (для типа KickBack) – ночей до
              • Value (для типа KickBack) – значение продолжительности, равное заданному периоду
              • OperationType (для типа KickBack) – тип действия
              • NightsFrom (для типа EarlyBird) – ночей от
              • NightsTo (для типа EarlyBird) – ночей до
              • Discount (для типа EarlyBird) – размер скидки
              • OperationType (для типа EarlyBird) – тип действия
        • COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
        • SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
      • FlightWeight
      • LinkingFlightsRules – объект правил связывания
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
      • RouteSubVariants – подварианты услуг (используется в основном поиске)
    • SecondaryFiltersResult – результаты доп. фильтров
      • TourTypes – типы тура
        • Id – ключ типа тура
        • Name – название типа тура
        • ParentId – родительский элемент типа тура (если есть)
        • Type – тип справочника (используется для внутренних целей)
      • TourPrograms – информация по каждой турпрограмме
        • Key – ключ турпрограммы
        • Name – название турпрограммы
        • TourUrl – ссылка на тур
        • BookingConditions – условия бронирования
        • IsLandOnly – признак только наземное обслуживание
        • IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
        • IsHotelTemplates – есть ли вообще отели в данной турпрограмме
        • IsRouteServices – есть ли маршрутные услуги
        • MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
        • Rate – валюта тура
        • DateStart – нижняя граница дат заезда по программе тура
        • DateEnd – верхняя граница дат заеда по программе тура
        • Status – статус турпрограммы
          • Key – ключ
          • Value – значение
        • Templates – шаблоны услуг
          • $id – шаблон 1
          • $id – шаблон 2
        • Types – типы тура
          • Id – ключ типа тура
          • Name – название типа тура
          • ParentId – родительский элемент типа тура (если есть)
          • Type – тип справочника (используется для внутренних целей)
        • LinkingFlightsRules – правила связывания перелетов
          • notCombineDifferentAirlineRule
            • airlines
            • flightSettings
            • enabled
          • checkPlusMinus1CharterRule
            • FlightSettingPairs
            • enabled
          • notCombineDifferentTariffGroupRule
            • FlightSettings
            • enabled
          • notCombineDifferentPartnerRule
            • FlightSettings
            • enabled
          • departureCityEqualsArrivalCityRule
            • FlightSettingPairs
            • enabled
          • combineOnlySpecificChartersRule
            • settings
            • enabled
        • Type – тип справочника (используется для внутренних целей)
      • TourDurations – продолжительность тура
      • TourDates – список дат заездов в турпрограмме
        • HotelCities – город в дополнительных фильтрах
          • '
        • HotelResorts – курорты в дополнительных фильтрах
          • '
        • HotelCategories – категории отеля в дополнительных фильтрах
          • '
        • Hotels – отели в дополнительных фильтрах
          • '
        • Pansions – питания в дополнительных фильтрах
          • '
        • Airlines – авиакомпании в дополнительных фильтрах
          • '
        • FlightTariffs – класс перелета в дополнительных фильтрах
          • '
        • DepartureCities – города вылета в дополнительных фильтрах
          • '
        • DepartureAirports – аэропорты вылета в дополнительных фильтрах
          • '
        • ArrivalCities – города прибытия в дополнительных фильтрах
          • '
        • ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
          • '
        • HotelTypes – признаки отелей в дополнительных фильтрах
          • '
развернутьПример


Выгрузка транспортного плана (TransportPlan) до релиза 15.7 включительно

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

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • code – код услуги
    • dateBegin – дата услуги
    • serviceType – тип услуги
    • transportKey – ключ справочника транспорт
  • Возвращаемый результат:
    • TransportKey – ключ справочника транспорт
    • Title – описание
    • AreasCount – количество уровней
    • RowsCount – количество рядов
    • ColumnsCount – количество мест в ряду
    • BusySeats – не используется
    • Cells – массив описаний всех мест
      • Row – ряд
      • Column – место в ряду
      • Area – уровень места
      • Type – тип (None = 0, Seat = 1, Block = 4, Busy = 5)
      • Name – название/номер
    • UserSeats – не используется
    • BlockSeat – не используется
развернутьПример


Выгрузка транспортного плана (TransportPlan) начиная с релиза 15.8

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

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • code – код услуги
    • dateBegin – дата услуги
    • serviceType – тип услуги
    • transportKey – ключ справочника транспорт
  • Возвращаемый результат:
    • VehiclePlans – массив параметров зон плана
      • Key – ключ зоны
      • TransportKey – ключ из справочника транспорт
      • Row – количество рядов
      • AreaNumber – номер уровня
      • Name – название уровня
      • PlanOrientation – ориентация плана (false - горизонтальная, true - вертикальная)
      • Column – количество столбцов
      • IsAirCraft – является ли планом самолета (false - нет, true - является)
      • Type – не используется
    • Seats – массив параметров посадочного места
      • Key – ключ места
      • SeatType – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
      • Index – индекс места
      • Number – название ячейки с местом
      • Type – тип "место"
      • VPKey – ключ зоны
      • Border – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
развернутьПример


Получение дат заезда по турпрограмме

Работает начиная с релиза 15.8.

Метод возвращает даты заезда по ключу турпрограммы.

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • tourProgramKey * – ключ турпрограммы
  • Возвращаемый результат:
    • Массив дат заезда по туру
развернутьПример


Получение плана транспортного средства (TransportPlan) по ключу турпрограммы и дате услуги

Работает начиная с релиза 15.8.

Метод возвращает даты заезда по ключу турпрограммы и дате услуги.

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • tourProgramKey * – ключ турпрограммы
    • dateBegin * – дата услуги
    • serviceType * – тип услуги
  • Возвращаемый результат:
  • plan – массив данных план
    • VehiclePlans – массив параметров зон плана
      • Key – ключ зоны
      • TransportKey – ключ из справочника транспорт
      • Row – количество рядов
      • AreaNumber – номер уровня
      • Name – название уровня
      • PlanOrientation – ориентация плана (false - горизонтальная, true - вертикальная)
      • Column – количество столбцов
      • IsAirCraft – является ли планом самолета (false - нет, true - является)
      • Dates – не используется
      • Type – не используется
    • Seats – массив параметров посадочного места
      • Key – ключ места
      • SeatType – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
      • Index – индекс места
      • Number – название ячейки с местом
      • Type – тип "место"
      • VPKey – ключ зоны
      • Border – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
  • routeCity – направление автобусного переезда
развернутьПример


Выгрузка первоначального варианта в корзину для бронирования (Tour)

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

  • Формат запроса:
    • GET .../TourSearchOwin/Tour?
  • Принимаемые параметры ( * – обязательный):
    • DepartureCityKeys * – идентификатор города отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • AdultCount * – количество взрослых
    • ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • CurrencyName * – код валюты
    • HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelScheme * – объект схемы отеля
      • TemplateId – идентификатор шаблона услуги
      • DurationInNight – продолжительность отеля в ночах
      • Code – ключ отеля
      • PacketKey – ключ пакета
      • PartnerKey – ключ партнера
      • GDSProviderId – ключ провайдера из внешней системы
      • TotalTourDuration – общая продолжительность тура в днях, обрабатывается начиная с релиза 15.6, обязательный параметр. Изменения связаны с возможностью работы поиска в ночах проживания в отеле, для перехода в корзину необходимо знать общую продолжительность тура. Взять значение для параметра TotalTourDuration для HotelScheme можно из свойства Duration, пришедшего для данной цены в ответе метода поиск туров (Tour)
    • PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
    • PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
    • isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false).
    • isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
    • TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
    • TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
    • RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
  • Возвращаемый результат:
    • CheckMessages – сообщения для логики проверки тура (не используется)
    • Message – сообщение об ошибке
      • Key – код ошибки
      • Value – сообщение об ошибке
    • Result – результаты поиска
      • Key – идентификатор программы тура
      • Name – название программы тура
      • TourUrl – ссылка на программу тура
      • BookingConditions – условия бронирования программы туров
      • StartDate – дата начала тура
      • Duration – продолжительность тура (в днях)
      • DurationInNight – продолжительность проживания (в ночах)
      • Types – идентификатор типа туров
      • Cost – цена тура
      • Rate – код валюты тура
      • CityDepature – город отправления
        • Key – идентификатор города отправления
        • Value – название города отправления
      • CountryId – всегда возвращается ключ 0
      • Services – услуги в туре
        • DepartureCity – город отправления
          • Key – идентификатор
          • Value – название
        • DepartureCountry – страна отправления
          • Key – идентификатор
          • Value – название
        • ArrivalCity – город прибытия
          • Key – идентификатор
          • Value – название
        • ArrivalCountry – страна прибытия
          • Key – идентификатор
          • Value – название
        • DepartureAirport – аэропорт отправления
          • Key – идентификатор
          • Value – название
        • ArrivalAirport – аэропорт прибытия
          • Key – идентификатор
          • Value – название
        • Airline – авиакомпания
          • Key – идентификатор
          • Value – название
        • Aircraft – воздушное судно
          • Key – идентификатор
          • Value – название
        • Flight – рейс
          • Key – идентификатор
          • Value – название
        • DepartureTime – время вылета
        • ArrivalTime – время прилета
        • EndDateTime – дата и время прилета
        • FlightDetails – информация об авиаперелете
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – название тарифа
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – название
        • FlightSetting – внутренняя информация о перелете из программы туров
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор перелета (внутренняя информация из программы туров)
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
      • NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
        • ServiceName – название типа услуги
        • City – объект город
          • Key – ключ города
          • Value – название города
        • Country – объект страна
          • Key – ключ страны
          • Value – название страны
        • Code – объект код услуги
          • Key – ключ услуги
          • Value – название услуги
        • ByScheduler – флаг услуга по расписанию или нет
        • Details – объект детализация услуги
          • SubCode1 – объект доп. описание 1
            • Key – ключ доп. описания 1
            • Value – название доп. описания 1
          • SubCode2 – объект доп. описание 2
            • Key – ключ доп. описания 2
            • Value – название доп. описания 2
          • Date – дата услуги
          • IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
          • Cost – цена
          • QuotaStatus – объект информация по квотам
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – идентификатор партнера
          • ByPax – признак цены за человека
          • Partner – объект партнер (не заполняется)
            • Key – ключ (не заполняется)
            • Value – название (не заполняется)
        • ParentId – идентификатор родительской услуги (для вложенных услуг)
        • PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
        • Id – идентификатор услуги
        • SvKey – ключ типа услуги
        • IsSubCode1 – наличие доп. описания 1
        • IsSubCode2 – наличие доп. описания 2
        • IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – скрытая ли услуга
        • IsDeleted – удаляемая ли услуга
        • IsNotCalculate – не рассчитываемая ли услуга
        • PacketId – пакет услуги
        • Index – индекс услуги
      • MinCostServicesComposition – массив состав услуг минимальной цены
        • Key – ключ
          • TemplateId – идентификатор шаблона
          • PatternId – идентификатор вкладки
          • SettingId – идентификатор услуги
        • Value – значение
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • CountryId – страна услуги
          • CityId – город услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
        • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
          • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
          • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
            • SpecialKey – ключ акции
            • SpecialName – название акции
            • SpecialType – тип акции
            • NewPrice – цена после применения акции
            • OldPrice – цена до применения акции
            • ShowOnline – нужно ли показывать акцию в поиске
            • UntilDate – акция действует при совершении покупки до указанной даты
            • Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
              • NightsFrom (для типа PayStay) – ночей от
              • NightsTo (для типа PayStay) – ночей до
              • NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
              • OperationType (для типа PayStay) – тип действия
              • SpecialNightType (для типа PayStay) – тип бесплатной ночи
              • DurationFrom (для типа KickBack) – ночей от
              • DurationTo (для типа KickBack) – ночей до
              • Value (для типа KickBack) – значение продолжительности, равное заданному периоду
              • OperationType (для типа KickBack) – тип действия
              • NightsFrom (для типа EarlyBird) – ночей от
              • NightsTo (для типа EarlyBird) – ночей до
              • Discount (для типа EarlyBird) – размер скидки
              • OperationType (для типа EarlyBird) – тип действия
        • COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
        • SpecialsBySubCode - список применённых акций по SubCode1 и SubCode2
      • FlightWeight
      • LinkingFlightsRules – объект правил связывания
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
      • RouteSubVariants – подварианты услуг (используется в основном поиске)
    • SecondaryFiltersResult – доп. фильтры (не используется при вызове из корзины)


развернутьПример


Выгрузка настройки отображения полей по туристам (TouristDataSettings)

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

  • Формат запроса:
    • GET .../TourSearchOwin/TouristDataSettings?
  • Принимаемые параметры ( * – обязательный):
    • countryId * – ключ страны, для которой будут выгружаться настройки
  • Возвращаемый результат:
    • TouristFieldsSettings – массив полей с информацией о туристах (из админки Мастер-Web)
      • lastname – объект фамилия туриста (лат)
        • Index – порядковый индекс элемента
        • Code – код поля
        • ApiCode – имя поля, которое будет использоваться при бронировании (например при вызове метода CreateReservation)
        • HeaderText – название поля
        • IsEdit – признак редактируемости поля
        • IsRequired – признак обязательности заполнения поля
        • IsVisible – видимость поля (видимое)
        • IsDisabled – служебный внутренний параметр. При работе с API не используется
        • Translit – настройки транслитерации (0 – нет, 1 – транслитерация, 2 – латиница)
        • LetterCase – настройки регистра (0 – по умолчанию, 1 – с заглавной, 2 – большие, 3 – маленькие)
      • patronymic – объект отчество туриста (лат)
      • sex – объект пол туриста
      • firstname – объект имя туриста (лат)
      • passportbywhom – объект кем выдан заграничный паспорт
      • birthplace – объект место рождения
      • birthdate – объект дата рождения
      • patronymicrus – объект отчество (рус)
      • lastnamerus – объект фамилия туриста (рус)
      • citizenid – объект ID туриста
      • passport – объект серия и номер заграничного паспорта
      • passportrus – объект серия и номер национального паспорт а
      • ismain – объект признак главного туриста
      • passportdate – объект дата выдачи заграничного паспорта
      • firstnamerus – объект имя туриста (рус)
      • passportbywhomrus – объект кем выдан национальный паспорт
      • citizenship – объект гражданство
      • passportdaterus – объект дата выдачи национального паспорта
      • phone – объект телефон
      • number – объект порядковый номер
      • passportdateend – объект дата окончания заграничного паспорта
      • email – объект e-mail туриста
    • PassportDurationOfExpiry – объект минимальный срок действия загранпаспорта туриста
      • StartPoint – точка отсчета
      • Duration – минимальная продолжительность
    • ChildAgeSetting – максимальный возраст ребенка, когда он считается ребенком (лет)
    • InfantAgeSetting – максимальный возраст младенца (месяцев)
развернутьПример


Выгрузка услуг доплат к авиаперелетам (GetFlightsAdditionalServices)

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

  • Формат запроса:
    • POST .../TourSearchOwin/GetFlightsAdditionalServices?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • TourProgramId – ключ турпрограммы
    • BeginDate – дата начала тура
    • Duration – продолжительность тура
    • Currency – код валюты
    • Services – массив услуг авиаперелетов для получения доплат
      • Service – объект услуга авиаперелет
        • ServiceType – тип услуги
        • Code – код услуги
        • SubCode1доп. описание 1 услуги
        • SubCode2доп. описание 2 услуги
        • Packet – ключ пакета услуги
        • Partner – ключ партнера услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • City – ключ города
        • Country – страна услуги
        • Attributes – битовая маска атрибутов услуг
        • IsRemovable – (не обрабатывается)
        • Type – тип услуги в путевке (базовая дополнительная)
        • IsHooded – признак скрытая услуга
        • IsNotCalculated – признак не рассчитываемая услуга
        • BeginDateTimeString – дата и время начала услуги
        • EndDateTimeString – дата и время окончания услуги
        • TemplateId – шаблон услуги
        • Cost – цена услуги
        • ByPax – цена за человека
        • QuotaStatus – объект статус квотирования
          • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index – индекс услуги
        • IsRoute – признак маршрутная услуга
        • ServiceTemplateIndex – индекс шаблона услуги
      • TouristNumbersList – массив туристов, привязанных к услуге
    • Tourists – массив туристов
      • IsMain – главный турист
      • Number – порядковый номер туриста
      • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex – пол (0 – мужской, 1 – женский)
      • FirstName – имя (лат)
      • LastName – фамилия (лат)
      • Patronymic – отчество (лат)
      • FirstNameRus – имя (рус)
      • LastNameRus – фамилия (рус)
      • PatronymicRus – отчество (рус)
      • InternationalPassportSeries – серия загранпаспорта
      • InternationalPassportNumber – номер загранпаспорта
      • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
      • internationalPassportByWhom – кем выдан загранпаспорт
      • PassportSeries – серия паспорта
      • PassportNumber – номер паспорта
      • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
      • PassportByWhom – кем выдан паспорт
      • Citizenship – название страны
      • Phone – телефон
      • Email – e-mail
      • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace – место рождения
      • CitizenID – гражданство
      • Age – количество полных лет на момент окончания тура
  • Возвращаемый результат:
    • Массив – массив объектов доплат к авиаперелетам
      • ServiceName – название услуги
      • City – объект город
      • Country – объект страна
        • Key – ключ страны
        • Value – название страны
      • Code – объект код услуги
        • Key – ключ услуги
        • Value – название услуги
      • ByScheduler – признак по расписанию
      • Details - объект детализация
        • SubCode1 – объект доп. описание 1
          • Key – ключ
          • Value – название
        • SubCode2 – объект доп. описание 2
          • Key – ключ
          • Value – название
        • Date – дата услуги
        • IsShowTransportPlan – признак показать транспортный план (для автобусов)
        • Cost – цена
        • QuotaStatus – объект статус квотирования
          • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • PartnerId – ключ партнера
        • ByPax – признак за человека
        • Partner – объект партнер (не заполняется)
          • Key – ключ (не заполняется)
          • Value – название (не заполняется)
      • ParentId – ключ родительской услуги
      • PartnerBasedOnServiceTemplateId – шаблон услуги для подбора поставщика
      • ShowOrder – порядок при печати (сортировка) по услуге
      • ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
      • ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
      • Id – идентификатор услуги
      • SvKey – тип услуги
      • IsSubCode1 – признак наличия доп. описания 1
      • IsSubCode2 – признак наличия доп. описания 2
      • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
      • Day – день предоставления услуги
      • DurationInNight – продолжительность услуги в ночах
      • BeginDateTime – дата начала услуги
      • EndDateTime – дата окончания
      • IsHooded – признак скрытая
      • IsDeleted – признак удаляемая
      • IsNotCalculate – признак не рассчитываемая
      • PacketId – ключ пакета
      • Index – индекс шаблона услуги
развернутьПример


Выгрузка услуг доплат к отелям (GetHotelsAdditionalServices)

Метод производит выгрузку услуг доплат к отелям.

  • Формат запроса:
    • POST .../TourSearchOwin/GetHotelsAdditionalServices?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • TourProgramId – ключ турпрограммы
    • BeginDate – дата начала тура
    • Duration – продолжительность тура
    • Currency – код валюты
    • Services – массив услуг отелей для получения доплат
      • Service – объект услуга отель
        • ServiceType – тип услуги
        • Code – код услуги
        • SubCode1доп. описание 1 услуги
        • SubCode2доп. описание 2 услуги
        • Packet – ключ пакета услуги
        • Partner – ключ партнера услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • City – ключ города
        • Country – страна услуги
        • Attributes – битовая маска атрибутов услуг
        • IsRemovable – (не обрабатывается)
        • Type – тип услуги в путевке (базовая дополнительная)
        • IsHooded – признак скрытая услуга
        • IsNotCalculated – признак не рассчитываемая услуга
        • BeginDateTimeString – дата и время начала услуги (YYYY-MM-DDThh:mm:ss)
        • EndDateTimeString – дата и время окончания услуги (YYYY-MM-DDThh:mm:ss)
        • TemplateId – шаблон услуги
        • Cost – цена услуги
        • ByPax – цена за человека
        • QuotaStatus – объект статус квотирования
          • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index – индекс услуги
        • IsRoute – признак маршрутная услуга
        • ServiceTemplateIndex – индекс шаблона услуги
        • RemoteId – (в доплатах не используется)
      • TouristNumbersList – массив туристов, привязанных к услуге
    • Tourists – массив туристов
      • IsMain – главный турист
      • Number – порядковый номер туриста
      • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex – пол (0 – мужской, 1 – женский)
      • FirstName – имя (лат)
      • LastName – фамилия (лат)
      • Patronymic – отчество (лат)
      • FirstNameRus – имя (рус)
      • LastNameRus – фамилия (рус)
      • PatronymicRus – отчество (рус)
      • InternationalPassportSeries – серия загранпаспорта
      • InternationalPassportNumber – номер загранпаспорта
      • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
      • internationalPassportByWhom – кем выдан загранпаспорт
      • PassportSeries – серия паспорта
      • PassportNumber – номер паспорта
      • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
      • PassportByWhom – кем выдан паспорт
      • Citizenship – название страны
      • Phone – телефон
      • Email – e-mail
      • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace – место рождения
      • CitizenID – гражданство
      • Age – количество полных лет на момент окончания тура
  • Возвращаемый результат:
    • Массив – массив объектов связок Возраст-Отель-Доп. услуги
      • Age – возраст туриста
      • Hotel – объект отель
        • ServiceType – тип услуги
        • Code – код услуги
        • SubCode1доп. описание 1
        • SubCode2доп. описание 2
        • PacketId – ключ пакета
        • PartnerId – ключ партнера
        • Day – день предоставления услуги
        • BeginTime – время начала услуги
        • EndTime – время окончания услуги
        • DurationInNight – продолжительность услуги в ночах
        • Attributes – маска атрибутов услуги
        • CountryId – ключ страны услуги
        • CityId – ключ города
        • Type – тип услуги в путевке
        • ShowOrder – порядок при печати (сортировка) по услуге
        • ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
        • ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
        • IsCommission – признак, комиссионная ли услуга
        • BaseFlightsParams – параметр не обрабатывается
      • AdditionalServices – массив доплат
      • ServiceName – название услуги
      • City – объект город
      • Country – ключ страны
      • Code – объект код услуги
        • Key – ключ услуги
        • Value – название услуги
      • ByScheduler – признак по расписанию
      • Details - объект детализация
        • SubCode1 – объект доп. описание 1
          • Key – ключ
          • Value – название
        • SubCode2 – объект доп. описание 2
          • Key – ключ
          • Value – название
        • Date – дата услуги
        • IsShowTransportPlan – признак показать транспортный план (для автобусов)
        • Cost – цена
        • QuotaStatus – объект статус квотирования
          • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • PartnerId – ключ партнера
        • ByPax – признак за человека
        • Partner – объект партнер (не заполняется)
          • Key – ключ (не заполняется)
          • Value – название (не заполняется)
      • ParentId – ключ родительской услуги
      • PartnerBasedOnServiceTemplateId – шаблон услуги для подбора поставщика
      • ShowOrder – порядок при печати (сортировка) по услуге
      • ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
      • ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
      • Id – идентификатор услуги
      • SvKey – тип услуги
      • IsSubCode1 – признак наличия доп. описания 1
      • IsSubCode2 – признак наличия доп. описания 2
      • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
      • Day – день предоставления услуги
      • DurationInNight – продолжительность услуги в ночах
      • BeginDateTime – дата начала услуги
      • EndDateTime – дата окончания
      • IsHooded – признак скрытая
      • IsDeleted – признак удаляемая
      • IsNotCalculate – признак не рассчитываемая
      • PacketId – ключ пакета
      • Index – индекс шаблона услуги
развернутьПример


Расчет индивидуальных услуг (CalculateIndividualServiceCosts)

Метод производит расчет услуг с индивидуальным выбором у туристов.

  • Формат запроса:
    • POST .../TourSearchOwin/CalculateIndividualServiceCosts?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • TourProgramId – ключ тура
    • TourDate – дата тура
    • TourDuration – продолжительность тура
    • Currency – код валюты
    • Services – массив индивидуальных услуг
      • ServiceType – тип услуги
      • Code – код услуги
      • SubCode1доп. описание 1
      • SubCode2доп. описание 2
      • Packet – ключ пакета
      • Partner – ключ партнера
      • Day – день предоставления услуги
      • DurationInNight – продолжительность услуги в ночах
      • City – объект город
      • Country – страна услуги
      • Attributes – маска атрибутов услуги
      • Type – тип услуги
      • IsHooded – признак скрытая
      • IsNotCalculated – признак не рассчитываемая
      • BeginDateTimeString – дата начала услуги в строке
      • EndDateTimeString – дата начала услуги в строке
      • TemplateId – номер шаблона услуги
      • Cost – цена услуги
      • ByPax – цена за человека
      • QuotaStatus – объект статус квотирования
        • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
        • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
        • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
      • Index – индекс услуги
      • IsRoute – признак маршрутная услуга
      • ServiceTemplateIndex – индекс шаблона услуги
      • RemoteId – (не используется)
    • Ages – массив возрастов туристов
  • Возвращаемый результат:
    • Массив – массив связок Возраст-Услуга-Цена
      • Age – возраст
      • Service – объект услуга
        • ServiceType – тип услуги
        • Code – код услуги
        • SubCode1доп. описание 1
        • SubCode2доп. описание 2
        • PacketId – ключ пакета услуги
        • PartnerId – ключ партнера
        • Day – день предоставления услуги
        • BeginTime – время начала услуги
        • EndTime – время окончания услуги
        • DurationInNight – продолжительность услуги в ночах
        • Attributes – маска атрибутов услуги
        • CountryId – ключ страны
        • CityId – ключ города
        • Type – тип услуги
        • ShowOrder – порядковый номер
      • SimpleServiceCost – объект цена
        • Brutto – брутто
        • Discount – скидка
развернутьПример


Поиск рейсов из внешней системы (GetGDSFlights)

Метод производит поиск рейсов из внешней системы.

  • Формат запроса:
    • POST .../TourSearchOwin/GetGDSFlights?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):

Внимание! Если в туре используется перелет из GDS, то в параметр flightSettings передается ответ из секции flightGDSRequest метода API ActualizeTour. Далее для получения цены выполняем методы RebuidFlights и CalculateReservation.

    • flightSettings – информация о шаблоне услуги авиаперелета
      • templateId – идентификатор шаблона услуги
      • patternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
      • serviceId – идентификатор класса услуги (внутренняя информация из программы туров)
    • service – информация об услуге авиаперелета
      • ServiceType – тип услуги
      • Code – ключ услуги
      • SubCode1доп. описание 1
      • SubCode2доп. описание 2
      • CountryId – страна услуги
      • CityId – город услуги
      • PacketId – пакет услуги
      • PartnerId – партнер услуги
      • Day – день предоставления услуги
      • DurationInNight – продолжительность услуги в ночах
    • price – стоимость перелета
    • quotaInfo – объект информация по квотам
      • status – статус по квотам (есть места / нет мест / под запрос)
      • freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
      • isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
    • flightDateTimeLimitationInterval
      • startLimitation – начало тайм-лимита
      • finishLimitation – объект тайм-лимита
        • dateTimeString – дата окончания тайм-лимита
        • serviceType – тип услуги
        • serviceCode – код услуги
    • flightSourceMode – тип перелета (1 – локальный, 2 – из внешний системы)
    • passengers – информация о пассажирах
      • IsMain – главный турист
      • Number – порядковый номер туриста
      • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex – пол (0 – мужской, 1 – женский)
      • FirstName – имя (лат)
      • LastName – фамилия (лат)
      • Patronymic – отчество (лат)
      • FirstNameRus – имя (рус)
      • LastNameRus – фамилия (рус)
      • PatronymicRus – отчество (рус)
      • InternationalPassportSeries – серия загранпаспорта
      • InternationalPassportNumber – номер загранпаспорта
      • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
      • internationalPassportByWhom – кем выдан загранпаспорт
      • PassportSeries – серия паспорта
      • PassportNumber – номер паспорта
      • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
      • PassportByWhom – кем выдан паспорт
      • Citizenship – название страны
      • Phone – телефон
      • Email – e-mail
      • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace – место рождения
      • CitizenID – гражданство
      • Age – количество полных лет на момент окончания тура
    • tourDate – дата тура
    • tourCurrency – валюта тура
    • tourId – ключ программы тура
    • filterTariff – информация о тарифах
    • filterDeptime – информация о времени вылета
    • isCommission – признак комиссионной цены
    • baseFlightsParams – параметра авиаперелета
      • CityArrival – город прибытия
      • FlightCode – код авиаперелета
      • TariffKey – ключ тарифа
      • PartnerId – ключ партнера
    • isUpdated – информация об обновлении перелета
    • key – ключ запроса
    • tourDurationByDays – продолжительность перелета
    • langueCode – локализация
  • Возвращаемый результат:
    • validationResult – информация о валидации
      • Errors – ошибки
      • Warnings – предупреждения
      • States – статус
      • IsValid – информация о результате
    • flightsStartEndPointPatterns – информация о начале и окончании перелета
      • fromPoint – информация о перелете отправления
        • country – страна вылета
          • id – ключ
          • description – описание
          • code – код
        • city – город вылета
          • id – ключ
          • description – описание
          • code – код
        • airport – аэропорт вылета
          • id – ключ
          • description – описание
          • code – код
      • toPoint – информация о перелете прибытия
        • country – страна прилета
          • id – ключ
          • description – описание
          • code – код
        • city – город прилета
          • id – ключ
          • description – описание
          • code – код
        • airport – аэропорт прилета
          • id – ключ
          • description – описание
          • code – код
    • passengersAgeInfos – информация о возрасте пассажиров
      • ageType – тип пассажира
      • count – количество человек
    • flightsSequencies – информация о перелете
      • flights – массив данных о перелете из внешнего поставщика
        • – ...
      • deltaPrice – разница в цене
        • amount – стоимость
        • currency – валюта
      • timeForward – время вперед
      • timeBackward – время обратно
      • hasTariffFamily – имеется ли семейство тарифов
      • rating – рейтинг
    • airTravelAdapterFilterValues – дополнительная информация
      • LuggageFilterValue – багаж
      • ClassAirTravelFilterValue – класс перелета
      • ConnectionsFilterValue – пересадки
      • SortFilterValue – сортировка
      • AutomaticFlightSelection – подбор перелета
    • tariff – тариф
    • minFlightTimeForward – минимальное время в пути туда
    • maxFlightTimeForward – максимальное время в пути туда
    • minFlightTimeBackward – минимальное время в пути обратно
    • maxFlightTimeBackward – максимальное время в пути обратно
развернутьПример


Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)

Внимание! Если в туре используется перелет из GDS, то перед этим методом вызывается GetGDSFlights в принимаемые параметры которого передается ответ из секции flightGDSRequest метода API ActualizeTour. Далее текущий метод RebuidFlights и далее CalculateReservation.
Метод возвращает информацию по выбранному перелету от внешнего поставщика.

  • Формат запроса:
    • POST .../TourSearchOwin/RebuildFlights
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • flights – перелеты
      • direction
      • commonPrice – общая стоимость перелета
      • remotePriceSource – данные расчета локального перелета
        • providerId – ID внешнего поставщика
        • flightId – идентификатор внешнего перелета
      • localPriceSource – данные расчета локального перелета
        • packetId – ключ пакета
        • partnerId – идентификатор партнера
      • flightsSequenceSettings – описание параметров последовательности перелетов для которых действуют замены
        • templateId – идентификатор шаблона услуги
        • patternId – идентификатор паттерна услуги
        • serviceId – идентификатор класса услуги
      • segments – сегменты авиаперелета
        • segmentNumber – номер сегмента
        • depratureCity – город отправления
          • gdsItem – справочная информация внешней системы
            • serviceId – идентификатор системы
            • languageId – идентификатор языка
            • id – идентификатор в системе внешнего поставщика
            • code – код в системе внешнего поставщика
            • name – имя в системе внешнего поставщика
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование города и страны
          • mtItem – справочная информации локальной системы
            • id – идентификатор в локальной системе
            • code – код в локальной системе
            • name – имя в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование страны и города
          • mapping – связка
            • id – Id маппинга
            • providerId – Id провайдера
            • dictionaryId – Id справочника
            • providerDictionaryItemId – Id справочника внешнего поставщика
            • providerDictionaryItemName – обозначение справочника внешнего поставщика
            • mtDictionaryItemId – Id справочника МТ
            • mtDictionaryItemName – обозначение справочника MT
        • arrivalCity – город прибытия
          • gdsItem – справочная информация внешней системы
            • serviceId – идентификатор системы
            • languageId – идентификатор языка
            • id – идентификатор в системе внешнего поставщика
            • code – код в системе внешнего поставщика
            • name – имя в системе внешнего поставщика
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование города и страны
          • mtItem – справочная информации локальной системы
            • id – идентификатор в локальной системе
            • code – код в локальной системе
            • name – имя в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование страны и города
          • mapping – связка
            • id – Id маппинга
            • providerId – Id провайдера
            • dictionaryId – Id справочника
            • providerDictionaryItemId – Id справочника внешнего поставщика
            • providerDictionaryItemName – обозначение справочника внешнего поставщика
            • mtDictionaryItemId – Id справочника МТ
            • mtDictionaryItemName – обозначение справочника MT
        • departureAirport – аэропорт вылета
        • arrivalAirport – аэропорт прилета
          • gdsItem –справочная информация внешней системы
            • serviceId – идентификатор системы
            • languageId – идентификатор языка
            • id – идентификатор аэропорта вылета
            • code – код аэропорта вылета
            • name – наименование аэропорта
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование аэропорта города страны
          • mtItem – справочная информации из локальной системы
            • id – идентификатор аэропорта в локальной системе
            • code – код аэропорта в локальной системе
            • name – имя аэропорта в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
              • dictionaryId – идентификатор справочника
              • itemId
            • columnValues – наименование страны и города
          • mapping – связка
            • id – Id маппинга аэропорта
            • providerId – Id провайдера аэропорта
            • dictionaryId – Id справочника аэропорта
            • providerDictionaryItemId – Id справочника аэропорта внешнего поставщика
            • providerDictionaryItemName – обозначение справочника аэропорта внешнего поставщика
            • mtDictionaryItemId – Id справочника аэропорта МТ
            • mtDictionaryItemName – обозначение справочника аэропорта MT
        • airline – авиакомпания
          • gdsItem – справочная информация внешней системы
            • serviceId – идентификатор авиакомпании внешней системы
            • languageId – идентификатор языка
            • id – идентификатор авиакомпании
            • code – код авиакомпании
            • name – наименование авиакомпании
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование авиакомпании
          • mtItem – справочная информация из локальной системы
            • id – идентификатор авиакомпании в локальной системе
            • code – код авиакомпании в локальной системе
            • name – наименование авиакомпании в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование авиакомпании
          • mapping – связка
            • id – Id маппинга авиакомпании
            • providerId – Id провайдера авиакомпании
            • dictionaryId – Id справочника авиакомпании
            • providerDictionaryItemId – Id справочника авиакомпании внешнего поставщика
            • providerDictionaryItemName – обозначение справочника авиакомпании внешнего поставщика
            • mtDictionaryItemId – Id справочника авиакомпании МТ
            • mtDictionaryItemName – обозначение справочника авиакомпании MT
        • aircraft – воздушное судно
          • gdsItem – справочная информация внешней системы
            • serviceId – идентификатор воздушного судна внешней системы
            • languageId – идентификатор языка
            • id – идентификатор воздушного судна
            • code – код воздушного судна
            • name – наименование воздушного судна
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование воздушного судна
          • mtItem – справочная информация из локальной системы
            • id – идентификатор воздушного судна в локальной системе
            • code – код воздушного судна в локальной системе
            • name – наименование воздушного судна в локальной системе
            • automaticallyMappingValue – выражение используемое для автоматического маппинга
            • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование воздушного судна
          • mapping – связка
            • id – Id маппинга воздушного судна
            • providerId – Id провайдера воздушного судна
            • dictionaryId – Id справочника воздушного судна
            • providerDictionaryItemId – Id справочника воздушного судна внешнего поставщика
            • providerDictionaryItemName – обозначение справочника воздушного судна внешнего поставщика
            • mtDictionaryItemId – Id справочника воздушного судна МТ
            • mtDictionaryItemName – обозначение справочника воздушного судна MT
        • tariff – тариф
          • gdsItem – справочная информация внешней системы
            • id – идентификатор тарифа
            • code – код тарифа
            • name – наименование тарифа
              • automaticallyMappingValue – выражение используемое для автоматического маппинга
              • requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
            • displayedValue – значение поля справочника который используется для отображения
            • dependencies – список зависимых сущностей
            • columnValues – наименование тарифа
          • mtItem – справочная информация из локальной системы
          • mapping – связка
        • flightNumber – номер перелета
        • baggageRestriction – ограничение провоза багажа
        • caryyOncarry – ограничение ручной клади
        • departureDate – дата вылета
        • arrivalDate – дата прилета
        • quotaInfo – объект информация по квотам
          • status – статус по квотам (есть места / нет мест / под запрос)
          • freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
    • tourDate – дата тура
  • Возвращаемый результат:
    • flights – информация о рейсах
      • remoteFlightId – идентификатор внешнего перелета
      • flightsSettings – внутренняя информация о перелете
        • templateId – идентификатор шаблона услуги
        • patternId – идентификатор паттерна услуги
        • serviceId – идентификатор класса услуги
      • flightsPlains – планы полетов
        • DepartureCity – город вылета
          • Key – ключ города
          • Value – наименование города
        • DepartureCountry – страна вылета
          • Key – ключ страны
          • Value – наименование страны
        • ArrivalCity – город прибытия
          • Key – ключ города
          • Value – наименование города
        • ArrivalCountry – страна прибытия
          • Key – ключ страны
          • Value – наименование страны
        • DepartureAirport – аэропорт вылета
          • Key – ключ аэропорта
          • Value – наименование аэропорта
        • ArrivalAirport – аэропорт прилета
          • Key – ключ аэропорта
          • Value – наименование аэропорта
        • Airline – авиакомпания
          • Id – идентификатор авиакомпании
          • "Value – наименование авиакомпании
          • "Key – ключ авиакомпании
        • Aircraft – воздушное судно
          • Key – ключ воздушного судна
          • Value – наименование воздушного судна
        • Flight – рейс
          • Key – ключ рейса
          • Value – наименование рейса
        • DepartureTime – время отправления
        • ArrivalTime – время прибытия
        • TotalTimeOfFlight – полное время перелета
        • FlightDetails – детали авиаперелета
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – наименование тарифа
          • IsCommission – признак, комиссионная ли услуга
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – наименование
        • FlightSetting – информация о шаблоне услуги авиаперелета
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор внешнего перелета
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
развернутьПример


Получение семейств тарифов авиаперелетов из внешней системы (GetGDSFlightFareFamilies)

Метод получает семейства тарифов для авиаперелетов из внешней системы.

  • Формат запроса:
    • POST .../TourSearchOwin/GetGDSFlightFareFamilies?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • flightId – ID внешнего перелета
    • providerId – ID внешнего провайдера
    • languageCode – код локализации
    • passengers – информация о пассажирах
      • IsMain – главный турист
      • Number – порядковый номер туриста
      • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex – пол (0 – мужской, 1 – женский)
      • FirstName – имя (лат)
      • LastName – фамилия (лат)
      • Patronymic – отчество (лат)
      • FirstNameRus – имя (рус)
      • LastNameRus – фамилия (рус)
      • PatronymicRus – отчество (рус)
      • InternationalPassportSeries – серия загранпаспорта
      • InternationalPassportNumber – номер загранпаспорта
      • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
      • internationalPassportByWhom – кем выдан загранпаспорт
      • PassportSeries – серия паспорта
      • PassportNumber – номер паспорта
      • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
      • PassportByWhom – кем выдан паспорт
      • Citizenship – название страны
      • Phone – телефон
      • Email – e-mail
      • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace – место рождения
      • CitizenID – гражданство
      • Age – количество полных лет на момент окончания тура
    • currency – валюта
    • price – стоимость
    • param – параметры перелета
      • flightsSource – параметры перелета
        • flightSettings – информация о шаблоне услуги авиаперелета
          • templateId – идентификатор шаблона услуги
          • patternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • serviceId – идентификатор класса услуги (внутренняя информация из программы туров)
        • service – информация об услуге авиаперелета
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • CountryId – страна услуги
          • CityId – город услуги
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
        • price – стоимость перелета
        • quotaInfo – объект информация по квотам
          • status – статус по квотам (есть места / нет мест / под запрос)
          • freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • flightDateTimeLimitationInterval
          • startLimitation – начало тайм-лимита
          • finishLimitation – объект тайм-лимита
            • dateTimeString – дата окончания тайм-лимита
            • serviceType – тип услуги
            • serviceCode – код услуги
        • flightSourceMode – тип перелета (1 – локальный, 2 – из внешний системы)
      • passengers – информация о пассажирах
        • IsMain – главный турист
        • Number – порядковый номер туриста
        • AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
        • MaleFemaleSex – пол (0 – мужской, 1 – женский)
        • FirstName – имя (лат)
        • LastName – фамилия (лат)
        • Patronymic – отчество (лат)
        • FirstNameRus – имя (рус)
        • LastNameRus – фамилия (рус)
        • PatronymicRus – отчество (рус)
        • InternationalPassportSeries – серия загранпаспорта
        • InternationalPassportNumber – номер загранпаспорта
        • InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
        • InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
        • InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
        • InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
        • internationalPassportByWhom – кем выдан загранпаспорт
        • PassportSeries – серия паспорта
        • PassportNumber – номер паспорта
        • PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
        • PassportDateOfIssueString – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
        • PassportByWhom – кем выдан паспорт
        • Citizenship – название страны
        • Phone – телефон
        • Email – e-mail
        • BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
        • BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
        • BirthPlace – место рождения
        • CitizenID – гражданство
        • Age – количество полных лет на момент окончания тура
      • tourDate – дата тура
      • tourCurrency – валюта тура
      • tourId – ключ программы тура
      • filterTariff – информация о тарифах
      • filterDeptime – информация о времени вылета
      • isCommission – признак комиссионной цены
      • baseFlightsParams – параметра авиаперелета
        • CityArrival – город прибытия
        • FlightCode – код авиаперелета
        • TariffKey – ключ тарифа
        • PartnerId – ключ партнера
      • isUpdated – информация об обновлении перелета
      • key – ключ запроса
      • tourDurationByDays – продолжительность перелета
      • langueCode – локализация
  • Возвращаемый результат:
    • validationResult – информация о валидации
      • Errors – ошибки
      • Warnings – предупреждения
      • States – статус
      • IsValid – информация о результате
    • tariffSequencies – информация тарифах
      • flightId – идентификатор перелета
      • universalParametrsSequence – параметры тарифов
        • universalParametrs – массив параметров
          • code – описание параметра тарифа
          • priority – приоритет показа
          • needToPay – нужна ли доплата
          • shortDescriptions – краткое описание
            • code – код
            • value – значение
      • price – стоимость
      • deltaPrice – разница в цене
      • timeLimit – тайм-лимит
      • segments – сегменты
      • depAirportCode – код аэропорта отправления
      • depCityCode – код города отправления
      • arrAirportCode – код аэропорта прибытия
      • arrCityCode – код города прибытия


развернутьПример


Загрузка филиалов (Branches) начиная с релиза 15.3

Метод производит выгрузку филиалов бронирования.

  • Формат запроса:
    • GET .../TourSearchOwin/Branches?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • ids – массив ключей филиалов
    • cityKey – фильтр по городу филиала (если 0 или не задан, то выбираются все филиалы)
  • Возвращаемый результат:
    • Key – ключ филиала (ключ партнера)
    • Value – название филиала (название партнера)
развернутьПример



Загрузка ведущих менеджеров (Users) начиная с релиза 15.3

Метод производит выгрузку ведущих менеджеров.

  • Формат запроса:
    • GET .../TourSearchOwin/Users?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • ids – массив ключей ведущих менеджеров
    • branchKey – ключ филиала бронирования, к которому они привязаны
  • Возвращаемый результат:
    • Key – ключ ведущего менеджера
    • Value – полное имя ведущего менеджера
развернутьПример



Расчет путевки (CalculateReservation)

Метод производит расчет стоимости путевки.

  • Формат запроса:
    • POST .../TourSearchOwin/CalculateReservation?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса:
    • TourProgramId * – ключ турпрограммы
    • BeginDate * – дата начала тура
    • Duration * – продолжительность тура
    • Currency * – код валюты
    • initialPrice * – объект изначальная цена
      • price * – цена
      • currency * – код валюты
    • Services * – массив услуг
      • Service * – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
        • ServiceType * – тип услуги (поле sv_key из таблицы service)
        • Code * – код услуги
        • SubCode1 *доп. описание 1 услуги
        • SubCode2 *доп. описание 2 услуги
        • Packet * – ключ пакета услуги
        • Partner * – ключ партнера услуги
        • Day * – день предоставления услуги
        • DurationInNight * – продолжительность услуги в ночах
        • City * – ключ города
        • Country * – страна услуги
        • Attributes * – битовая маска атрибутов услуг (Значение по умолчанию 0. Дальше в зависимости от признака услуги, может принимать значениz:

None = 0,если услуга удаляемая, эта настройка находится в программе туров,
Delete = 1,
CodeEdit = 2,
SubCode1Edit = 4,
CityEdit = 8,
PartnerEdit = 16,
BadCheck = 32,
Invisible = 64, отображаемая
DurationEdit = 128,
FullEdit = Delete | CodeEdit | SubCode1Edit | SubCode2Edit | CityEdit | PartnerEdit | DurationEdit,
Host = 256,
HostChangeCode2 = Host | 512,
HostChangeCode1 = Host | 1024,
HostChangeCode = Host | 2048,
HostChangePartner = Host | 4096,
HostChangePacket = Host | 8192,
Depended = 16384,
DependedCode2 = Depended | 512,
DependedCode1 = Depended | 1024,
DependedCode = Depended | 2048,
DependedCity = Depended | 4096,
DependedCountry = Depended | 8192,
FullDepended = Depended | DependedCode2 | DependedCode1 | DependedCode | DependedCity | DependedCountry,
NotCalculate = 32768,не рассчитываемая,
SubCode2Edit = 65536,
GDSService = 131072, от внешней системы)

        • *IsRemovable – (не обрабатывается)
        • *Type – тип услуги в путевке. Может принимать значения:

None (0) – не установлено,
Base (1) – базовая услуга. Основные услуги в корзине, проживание, перелет.
Optional (2) – Дополнительная услуга,
NYDinner (4) – Новогодний ужин,
FlightAdditionalPayment (8) – Доплата на перелет,
TourWebDifference (16) – Разница в СПО,
AddedByCalculator (32) – Добавленная при рассчете путевки,
AddedByReservationBuilder (64) – добавленная услуга при формировании состава путевки,
BaseChanged (128) – базовая измененная услуга,
HotelAdditionalPayment (256) – доплата на отель

        • IsHooded * – признак скрытая услуга
        • IsNotCalculated * – признак не рассчитываемая услуга
        • BeginDateTimeString * – дата и время начала услуги
        • EndDateTimeString * – дата и время окончания услуги
        • TemplateId * – порядок расположения шаблона услуги в внутри самой услуги в программе тура

индекс шаблона услуги

        • Cost * – цена услуги
        • ByPax * – цена за человека
        • QuotaStatus * – объект статус квотирования
          • PlacesStatus * – статус по квотам (есть места / нет мест / под запрос)
          • FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index * – индекс услуги
        • IsRoute * – признак маршрутная услуга (Перелет, автобусный переезд, жд переезд, трансфер, экскурсия)
        • ServiceTemplateIndex * – индекс шаблона услуги (Порядок расположения услуги в программе тура. Не отображается в программе туров,это просто порядковый номер услуги в путевке)

индекс шаблона услуги

        • RemoteId * – информация об услуге во внешней системе
        • IsCommission * – признак, комиссионная ли услуга
        • BaseFlightsParams * – параметры рассчитанных авиаперелетов Обязательный параметр, если в путевке есть услуга авиаперелета
          • CityArrival * – ключ города прибытия прямого перелета
          • FlightCode * – ключ прямого авиаперелета
          • TariffKey * – ключ тарифа прямого авиаперелета
          • PartnerId * – ключ партнера прямого авиаперелета
          • CityArrival * – ключ города прибытия обратного перелета
          • FlightCode * – ключ обратного авиаперелета
          • TariffKey * – ключ тарифа обратного авиаперелета
          • PartnerId * – ключ партнера обратного авиаперелета
      • TouristNumbersList * – массив туристов, привязанных к услуге
    • Tourists * – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу TouristDataSettings по определенной стране. В каждом объекте есть поле IsRequired, которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
      • IsMain * – главный турист
      • Number * – порядковый номер туриста
      • AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex * – пол (0 – мужской, 1 – женский)
      • FirstName * – имя (лат)
      • LastName * – фамилия (лат)
      • Patronymic * – отчество (лат)
      • FirstNameRus * – имя (рус)
      • LastNameRus * – фамилия (рус)
      • PatronymicRus * – отчество (рус)
      • InternationalPassportSeries * – серия загранпаспорта
      • InternationalPassportNumber * – номер загранпаспорта
      • InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
      • internationalPassportByWhom * – кем выдан загранпаспорт
      • PassportSeries * – серия паспорта
      • PassportNumber * – номер паспорта
      • PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString * – дата выдачи паспорта строковом формате (DD.MM.YYYY)
      • PassportByWhom * – кем выдан паспорт
      • Citizenship * – название страны
      • Phone * – телефон
      • Email * – e-mail
      • BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace * – место рождения
      • CitizenID * – гражданство
      • Age * – количество полных лет на момент окончания тура
    • Day * – день (перевод) Может быть с пустым значением
    • Day2 * – дня (перевод) Может быть с пустым значением
    • Days * – дней (перевод) Может быть с пустым значением
    • Night * – ночь (перевод) Может быть с пустым значением
    • Night2 * – ночи (перевод) Может быть с пустым значением
    • Nights * – ночей (перевод) Может быть с пустым значением
    • adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги (перевод) Может быть с пустым значением
    • at * – на (перевод) Может быть с пустым значением
    • incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) Может быть с пустым значением
  • Возвращаемый результат:
    • IsValid – признак валидности путевки
    • ErrorMessage – сообщение об ошибке, если есть
    • CalculatedReservation – объект рассчитанной путевки
      • TourKey – ключ тура
      • BeginDate – дата начала тура
      • Duration – продолжительность путевки в днях
      • Currency – код валюты тура
      • CalculatedServicesPrice – сумма обязательных услуг, входящих в состав тура
      • ChangedPrice – сумма, на которую изменилась итоговая стоимость TotalPrice в результате добавления обязательных и дополнительных услуг
      • Price – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в валюте тура)
      • TotalPrice – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в валюте тура)
      • IsDiscountIsPercent – признак, в процентах ли дается партнерская комиссия или в y.e.
      • NationalChangedPrice – сумма, на которую изменилась итоговая стоимость TotalPrice в результате добавления обязательных и дополнительных услуг (в национальной валюте)
      • NationalTotalDiscount – партнерская комиссия агентству (в национальной валюте)
      • NationalTotalPrice – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в национальной валюте)
      • NatinoalCalculatedServicesPrice – сумма обязательных услуг, входящих в состав тура (в национальной валюте)
      • NationalPrice – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в национальной валюте)
      • Discount – партнерская комиссия агентству (в процентах или y.e.)
      • TotalDiscount – партнерская комиссия агентству (в валюте тура)
      • ServiceTourists – массив услуг, входящих в тур
        • ServiceType – тип услуги
        • Day – день предоставления
        • DurationInNight – продолжительность в ночах
        • Time – время начала услуги
        • Name – полное описание услуги
        • TouristCount – количество туристов на услуге
        • Attributes – битовая маска атрибутов
        • Type – тип услуги (основная/дополнительная)
        • Brutto – цена брутто
        • NationalBrutto – цена брутто в национальной валюте
        • TotalBrutto – итоговое брутто
    • TourName – название тура
    • BookingConditions – разметка условия бронирования
    • EndDate – дата окончания тура
    • DurationInNights – продолжительность тура в ночах
    • NationalCurrency – код национальной валюты
развернутьПример


Бронирование путевки (CreateReservation)

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

  • Формат запроса:
    • PUT .../TourSearchOwin/CreateReservation/1?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
    • Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
  • Принимаемые параметры PUT запроса:
    • TourProgramId * – ключ турпрограммы
    • BeginDate * – дата начала тура (YYYY-MM-DDThh:mm:ss)
    • Duration * – продолжительность тура
    • Currency * – код валюты
    • Services * – массив услуг
      • Service * – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
        • ServiceType * – тип услуги (поле sv_key из таблицы service)
        • Code * – код услуги
        • SubCode1 *доп. описание 1 услуги
        • SubCode2 *доп. описание 2 услуги
        • Packet * – ключ пакета услуги
        • Partner * – ключ партнера услуги
        • Day * – день предоставления услуги
        • DurationInNight * – продолжительность услуги в ночах
        • City * – ключ города
        • Country * – страна услуги
        • Attributes * – битовая маска атрибутов услуг
        • IsRemovable * – (не обрабатывается)
        • Type * – тип услуги в путевке (базовая дополнительная)
        • IsHooded * – признак скрытая услуга
        • IsNotCalculated * – признак не рассчитываемая услуга
        • BeginDateTimeString * – дата и время начала услуги
        • EndDateTimeString * – дата и время окончания услуги
        • TemplateId * – шаблон услуги
        • Cost * – цена услуги
        • ByPax * – цена за человека
        • QuotaStatus * – объект статус квотирования
          • PlacesStatus * – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index * – индекс услуги
        • IsRoute * – признак маршрутная услуга
        • ServiceTemplateIndex * – индекс шаблона услуги
        • RemoteId * – информация об услуге во внешний системе
        • IsCommission * – признак, комиссионная ли услуга
        • BaseFlightsParams * – параметры рассчитанных авиаперелетов Обязательный параметр, если в путевке есть услуга авиаперелета
          • CityArrival * – ключ города прибытия прямого перелета
          • FlightCode * – ключ прямого авиаперелета
          • TariffKey * – ключ тарифа прямого авиаперелета
          • PartnerId * – ключ партнера прямого авиаперелета
          • CityArrival * – ключ города прибытия обратного перелета
          • FlightCode * – ключ обратного авиаперелета
          • TariffKey * – ключ тарифа обратного авиаперелета
          • PartnerId * – ключ партнера обратного авиаперелета
      • TouristNumbersList * – массив туристов, привязанных к услуге
    • Tourists * – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу TouristDataSettings по определенной стране. В каждом объекте есть поле IsRequired, которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
      • IsMain * – главный турист
      • Number * – порядковый номер туриста
      • AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex * – пол (0 – мужской, 1 – женский)
      • FirstName * – имя (лат)
      • LastName * – фамилия (лат)
      • Patronymic * – отчество (лат)
      • FirstNameRus * – имя (рус)
      • LastNameRus * – фамилия (рус)
      • PatronymicRus * – отчество (рус)
      • InternationalPassportSeries * – серия загранпаспорта
      • InternationalPassportNumber * – номер загранпаспорта
      • InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
      • internationalPassportByWhom * – кем выдан загранпаспорт
      • PassportSeries * – серия паспорта
      • PassportNumber * – номер паспорта
      • PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString * – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
      • PassportByWhom * – кем выдан паспорт
      • Citizenship * – название страны
      • Phone * – телефон
      • Email * – e-mail
      • BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace * – место рождения
      • CitizenID * – ID туриста (задается в карточке постоянного клиента)
      • Age * – количество полных лет на момент окончания тура
    • BranchId * – ключ филиала бронирования (начиная с релиза 15.3). Если не передан, то филиал бронирования берется из менеджера по умолчанию либо из пользователя, создавшего тур. Может быть с пустым значением
    • OwnerId * – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура. Может быть с пустым значением
    • Day * – день (перевод) Может быть с пустым значением
    • Day2 * – дня (перевод) Может быть с пустым значением
    • Days * – дней (перевод) Может быть с пустым значением
    • Night * – ночь (перевод) Может быть с пустым значением
    • Night2 * – ночи (перевод) Может быть с пустым значением
    • Nights * – ночей (перевод) Может быть с пустым значением
    • adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги (перевод) Может быть с пустым значением
    • incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) Может быть с пустым значением
    • OrderInfoUrl – Адрес окна путевки в личном кабинете
    • DogovorComment – Комментарий к путевке (сохраняется как сообщения в истории путевки) Может быть с пустым значением


  • Возвращаемый результат:
    • Reservation – объект путевки
      • $id – внутренний идентификатор для установки связей между сущностями,
      • Code – код путевки
      • TurDate – дата заезда
      • TRKey – ключ тура
      • CNKey – ключ страны
      • CTKey – ключ города
      • NMen – количество туристов по путевке
      • Price – стоимость путевки за вычетом скидки (комиссии)
      • Payed – оплаченная сумма по путевке
      • NDay – продолжительность тура в днях
      • MainMan – ФИО лица, заключившего договор
      • MainManPhone – номер телефона лица, заключившего договор
      • MainManAddress – адрес лица, заключившего договор
      • MainManPassport – паспортные данные лица, заключившего договор
      • PartnerKey – ключ партнера, оформившего договор
      • Operator – ФИО создателя договора
      • Discount – величина скидки на одного человека
      • DiscountSum – абсолютная величина скидки
      • SORCode – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
      • CrDate – дата и время создания путевки
      • Rate – код валюты путевки
      • Advertise – ключ источника рекламы
      • Locked – блокировка путевки: 1 – если заблокирована
      • CauseDisc – ключ основания для скидки
      • PPaymentDate – максимальная дата внесения предоплаты
      • PaymentDate – максимальная дата полной оплаты
      • Procent – информация о предоплате: 1 – предоплата в %; 0 – предоплата в у.е.
      • TurDateBfrAnnul – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
      • ARKey – ключ причины аннуляции путевки
      • Key – ключ договора
      • CodePartner – значение ключевого поля из таблицы партнеров
      • FilialKey – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
      • IsOutDoc – статус выдачи документов
      • Notes – сообщение поставщику
      • DiscSumBfrAnn – числовое значение скидки перед аннуляцией путевки
      • PriceBfrAnn – стоимость путевки перед ее аннуляцией
      • RazmerP – размер предоплаты
      • LeadDepartment – ключ отдела, ведущего данный тур
      • MainManEmail – адрес е-mail из данных лица, заключившего договор
      • MainManComment – примечание из данных лица, заключившего договор
      • DupUserKey – ключ представителя партнера, которым был оформлен договор
      • BTKey – ключ системы бронирования, из которой был оформлен договор
      • ConfirmedDate – дата подтверждения путевки покупателю
      • PrtDogKey – договор партнера, по которому оформлена путевка
      • CTDepartureKey – ключ города начала поездки
      • PDTType – тип договора, по которому оформлена путевка
      • NationalCurrencyPrice – стоимость путевки в национальной валюте
      • NationalCurrencyDiscountSum – значение скидки в национальной валюте
      • NationalCurrencyPayed – сумма платежей по путевке, зафиксированная в национальной валюте
      • CurrencyKey – ключ национальной валюты путевки
      • CurrencyRate – курс национальной валюты путевки
      • ClientKey – ключ частника, которым был оформлен договор
      • Partner – информация о партнере покупателе, привязанным к путевке
        • $id – внутренний идентификатор для установки связей между сущностями
        • Key – ключ партнера покумателя
        • FullName – полное имя партнера
        • Name – имя партнера
      • Services – коллекция услуг в данной путевке
        • $id – внутренний идентификатор для установки связей между сущностями
        • DGCod – номер путевки
        • TurDate – дата начала тура
        • Key – ключ услуги
        • PaketKey – ключ пакета
        • TRKey – клют тура
        • SVKey – ключ типа услуги
        • Name – наименование услуги
        • Day – порядковый номер дня тура, в который предоставляется услуга
        • Code – ключ кода услуги
        • SubCode1 – ключ доп.описания 1 услуги
        • SubCode2 – ключ доп.описания 2 услуги
        • Men – количество человек, пользующихся услугой по путевке
        • Days – количество дней услуги
        • CNKey – ключ страны услуги
        • CTKey – ключ города услуги
        • PartnerKey – ключ партнера, предоставляющего услугу
        • Brutto – стоимость услуги брутто
        • Wait – признак услуги Снимать квоту при бронировании
        • Warning – неиспользуемое поле
        • TimeBeg – поле используется для сортировки услуг в путевке
        • Control – ключ статуса услуги (ссылка на таблицу Controls),
        • Attribute – атрибут услуги
        • DateBeg – дата начала действия услуги
        • DateEnd – дата окончания действия услуги
        • Discount – размер скидки по услуге
        • Comment – комментарий к услуге
        • DGKey – ключ договора,
        • Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
        • NameLat – наименование услуги (латинский)
        • Long – продолжительность тура в днях
        • TRFId – ключ тарифа
        • CreateDate – дата создания услуги в путевке
        • CalculatePriceDate – дата расчета цены
        • ShowOrder – порядок при сортировке
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • Turists – коллекция туристов в данной путевке
        • $id – внутренний идентификатор для установки связей между сущностями
        • DGCod – номер путевки, к которому привязан турист
        • Key – ключ туриста
        • TurDate – дата начала тура
        • NameRus – фамилия туриста (русское)
        • NameLat – фамилия туриста (латинское)
        • ShortName – имя и отчество туриста в формате И.О.
        • Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
        • FNameRus – имя туриста (русское)
        • FNameLat – имя туриста (латинское)
        • SNameRus – отчество туриста (русское)
        • SNameLat – отчество туриста (латинское)
        • BirthDay – дата рождения туриста
        • BirthCountry – страна рождения туриста
        • BirthCity – город рождения туриста
        • Citizen – гражданство туриста
        • PostIndex – почтовый индекс
        • PostCity – адрес проживания туриста (город)
        • PostStreet – адрес проживания туриста (улица)
        • PostBild – адрес проживания туриста (номер дома)
        • PostFlat – адрес проживания туриста (номер квартиры)
        • Phone – номер телефона туриста
        • PhoneCode – код телефона туриста
        • PasportType – серия заграничного паспорта
        • PasportNum – номер заграничного паспорта
        • PasportDate – дата выдачи заграничного паспорта
        • PasportDateEnd – дата окончания срока действия заграничного паспорта
        • PasportByWhom – кем выдан заграничный паспорт
        • Place – место рождения
        • IsAnketa – выдавалась ли анкета
        • PaspRuser – серия общегражданского паспорта
        • PaspRuNum – номер общегражданского паспорта
        • PaspRuDate – дата выдачи общегражданского паспорта
        • PaspRuByWhom – кем выдан общегражданский паспорт
        • ClientId – ключ в таблице клиентов
        • IsMain – признак главного туриста по путевке
        • DGKey – ключ кутевки
        • RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
        • Email – е-mail туриста
        • EnableSmsNotifications – согласен получать уведомления по СМС
        • CitizenId – идентификатор туриста
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • TuristServices – коллекция связей туриста с услугой
        • $id – внутренний идентификатор для установки связей между сущностями
        • TUKey – ключ туриста
        • DLKey – ключ услуги
        • NumDoc – номер документа (авиабилета)
        • NumRoom – номер комнаты (каюты)
        • Seat – номер места (в номере отеля, каюты) или место в транспорте
        • Area – зона (палуба) в отеле, круизе
        • DocDate – дата документа (авиабелета)
        • Key – первичный ключ связки
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • DogovorMessages – сообщение по путевке покупателю
        • id – внутренний идентификатор для установки связей между сущностями
        • Date – дата создание сообщения
        • Text – текст сообщения
        • Remark – код сообщения
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
    • ValidationResultSummary – объект статус результата бронирования
      • ValidationResult – объект с ошибками и флагом валидности путевки
        • Errors – массив ошибок бронирования
        • IsValid – признак валидности бронирования
      • ValidationResultAttributes – атрибут результата бронирования
развернутьПример запроса


развернутьПример ответа


Бронирование путевки с упрощенными входными параметрами (CreateReservationExternalSystem)

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

  • Формат запроса:
    • PUT .../TourSearchOwin/CreateReservationExternalSystem/1?
  • Принимаемые параметры headers (* – обязательный):
    • Content-Type * – application/json
    • Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
  • Принимаемые параметры PUT запроса:
    • BeginDate * – дата начала тура (YYYY-MM-DDThh:mm)
    • Duration * – продолжительность тура в днях
    • Currency * – код валюты
    • TourProgramId – идентификатор турпрограммы (необязательный, по умолчанию 0)
    • Services * – массив услуг, в данном случае будет содержать только услугу отель
      • Code * – идентификатор отеля во внешней системе, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
      • Cost * – стоимость проживания за весь период
      • Packet * – идентификатор пакета, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
      • SubCode1 * – идентификатор типа номера, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
    • Tourists * – массив туристов
      • FirstName * – имя туриста
      • LastName * – фамилия туриста
      • Patronymic * – отчество туриста
      • MaleFemaleSex * – пол (0 – мужской, 1 – женский)
      • AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • Age * – количество полных лет на момент окончания тура
      • Phone * – телефон (обязателен для первого туриста)
      • Email * – e-mail (обязателен для первого туриста)
    • DogovorComment * – комментарий к путевке (ограничение 254 символа, при превышении разбивается на части)
Am 063.png


1. В случае, если в теле запроса указываются ID несинхронизированных отелей, пакета, типа номера, то создаются фиктивные данные, которые необходимо изменить в услуге экрана Путевка (пример: Отель – ApiHotel, пакет – ApiPacket, тип номера – ApiRoom(ApiRoomCategory),ApiAccmdmen)
2. Тип питания всегда будет создаваться фиктивный и его необходимо изменить в услуге экрана Путевка (пример: Тип питания – ApiPansion)


  • Возвращаемый результат:
    • Reservation – объект путевки
      • $id – внутренний идентификатор для установки связей между сущностями,
      • Code – код путевки
      • TurDate – дата начала тура
      • TRKey – идентификатор тура
      • CNKey – идентификатор страны
      • CTKey – идентификатор города
      • NMen – количество туристов
      • Price – стоимость путевки
      • Payed – оплаченная сумма
      • NDay – продолжительность тура в днях
      • MainMan – контактное лицо
      • MainManPhone – телефон контактного лица
      • MainManAddress – адрес лица, заключившего договор
      • MainManPassport – паспортные данные контактного лица
      • PartnerKey – идентификатор партнера
      • Operator – оператор, оформивший путевку
      • Discount – размер скидки
      • DiscountSum – сумма скидки
      • SORCode – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
      • CrDate – дата создания путевки
      • Rate – код валюты путевки
      • Advertise – идентификатор рекламного источника
      • Locked – статус блокировки путевки
      • CauseDisc – код основания скидки
      • PPaymentDate – дата предоплаты
      • PaymentDate – максимальная дата полной оплаты
      • Procent – предоплата в %
      • TurDateBfrAnnul – дата начала тура до аннуляции
      • ARKey – идентификатор причины аннуляции
      • Key – идентификатор договора
      • CodePartner – идентификатор партнера
      • FilialKey – идентификатор филиала
      • IsOutDoc – статус выдачи документов
      • Notes – примечания
      • DiscSumBfrAnn – сумма скидки перед аннуляцией
      • PriceBfrAnn – цена путевки перед аннуляцией
      • RazmerP – размер предоплаты
      • LeadDepartment – идентификатор ведущего отдела
      • MainManEmail – e-mail контактного лица
      • MainManComment – комментарий контактного лица
      • DupUserKey – идентификатор представителя агента
      • BTKey – идентификатор системы бронирования
      • ConfirmedDate – дата подтверждения путевки
      • PrtDogKey – идентификатор договора партнера
      • CTDepartureKey – идентификатор города отправления
      • PDTType – тип договора путевки
      • NationalCurrencyPrice – цена в национальной валюте
      • NationalCurrencyDiscountSum – сумма скидки в национальной валюте
      • NationalCurrencyPayed – оплаченная сумма в национальной валюте
      • CurrencyKey – идентификатор валюты
      • CurrencyRate – курс валюты
      • ClientKey – идентификатор клиента
      • AgencyPrice – цена для агентства
      • Partner – информация о партнере
        • $id – идентификатор записи
        • Key – идентификатор партнера
        • FullName – полное название партнера
        • Name – краткое название партнера
      • Services – список услуг
        • $id – внутренний идентификатор для установки связей между сущностями
        • DGCod – номер путевки
        • TurDate – дата начала тура
        • Key – ключ услуги
        • PaketKey – ключ пакета
        • TRKey – клют тура
        • SVKey – ключ типа услуги
        • Name – наименование услуги
        • Day – порядковый номер дня тура, в который предоставляется услуга
        • Code – ключ кода услуги
        • SubCode1 – ключ доп.описания 1 услуги
        • SubCode2 – ключ доп.описания 2 услуги
        • Men – количество человек, пользующихся услугой по путевке
        • Days – количество дней услуги
        • CNKey – ключ страны услуги
        • CTKey – ключ города услуги
        • PartnerKey – ключ партнера, предоставляющего услугу
        • Brutto – стоимость услуги брутто
        • Wait – признак услуги Снимать квоту при бронировании
        • Warning – неиспользуемое поле
        • TimeBeg – поле используется для сортировки услуг в путевке
        • Control – ключ статуса услуги (ссылка на таблицу Controls),
        • Attribute – атрибут услуги
        • DateBeg – дата начала действия услуги
        • DateEnd – дата окончания действия услуги
        • Discount – размер скидки по услуге
        • Comment – комментарий к услуге
        • DGKey – ключ договора,
        • Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
        • NameLat – наименование услуги (латинский)
        • Long – продолжительность тура в днях
        • TRFId – ключ тарифа
        • CreateDate – дата создания услуги в путевке
        • CalculatePriceDate – дата расчета цены
        • ShowOrder – порядок при сортировке
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • Turists – список туристов
        • $id – внутренний идентификатор для установки связей между сущностями
        • DGCod – номер путевки, к которому привязан турист
        • Key – ключ туриста
        • TurDate – дата начала тура
        • NameRus – фамилия туриста (русское)
        • NameLat – фамилия туриста (латинское)
        • ShortName – имя и отчество туриста в формате И.О.
        • Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
        • FNameRus – имя туриста (русское)
        • FNameLat – имя туриста (латинское)
        • SNameRus – отчество туриста (русское)
        • SNameLat – отчество туриста (латинское)
        • BirthDay – дата рождения туриста
        • BirthCountry – страна рождения туриста
        • BirthCity – город рождения туриста
        • Citizen – гражданство туриста
        • PostIndex – почтовый индекс
        • PostCity – адрес проживания туриста (город)
        • PostStreet – адрес проживания туриста (улица)
        • PostBild – адрес проживания туриста (номер дома)
        • PostFlat – адрес проживания туриста (номер квартиры)
        • Phone – номер телефона туриста
        • PhoneCode – код телефона туриста
        • PasportType – серия заграничного паспорта
        • PasportNum – номер заграничного паспорта
        • PasportDate – дата выдачи заграничного паспорта
        • PasportDateEnd – дата окончания срока действия заграничного паспорта
        • PasportByWhom – кем выдан заграничный паспорт
        • Place – место рождения
        • IsAnketa – выдавалась ли анкета
        • PaspRuser – серия общегражданского паспорта
        • PaspRuNum – номер общегражданского паспорта
        • PaspRuDate – дата выдачи общегражданского паспорта
        • PaspRuByWhom – кем выдан общегражданский паспорт
        • ClientId – ключ в таблице клиентов
        • IsMain – признак главного туриста по путевке
        • DGKey – ключ кутевки
        • RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
        • Email – е-mail туриста
        • EnableSmsNotifications – согласен получать уведомления по СМС
        • CitizenId – идентификатор туриста
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • TuristServices – коллекция связей туриста с услугой
        • $id – внутренний идентификатор для установки связей между сущностями
        • TUKey – ключ туриста
        • DLKey – ключ услуги
        • NumDoc – номер документа (авиабилета)
        • NumRoom – номер комнаты (каюты)
        • Seat – номер места (в номере отеля, каюты) или место в транспорте
        • Area – зона (палуба) в отеле, круизе
        • DocDate – дата документа (авиабелета)
        • Key – первичный ключ связки
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
      • DogovorMessages – сообщение по путевке покупателю
        • id – внутренний идентификатор для установки связей между сущностями
        • Date – дата создание сообщения
        • Text – текст сообщения
        • Remark – код сообщения
        • Connections – коллекция связей с сущностями через внутренний идентификатор $id
          • $ref – связь с внутренним идентификатором $id
    • ValidationResultSummary – объект статус результата бронирования
      • ValidationResult – объект с ошибками и флагом валидности путевки
        • Errors – массив ошибок бронирования
        • IsValid – признак валидности бронирования
      • ValidationResultAttributes – атрибут результата бронирования


развернутьПример запроса



развернутьПример ответа


Выгрузка информации о путевке (GetReservation)

Метод выводит информацию о бронированной путевке.

  • Формат запроса:
    • GET .../TourSearchOwin/GetReservation?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
    • Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
  • Принимаемые параметры GET запроса ( * – обязательный):
    • dgCode * – номер путевки:
  • Возвращаемый результат:
    • $id – внутренний идентификатор для установки связей между сущностями,
    • Code – код путевки
    • TurDate – дата заезда
    • TRKey – ключ тура
    • CNKey – ключ страны
    • CTKey – ключ города
    • NMen – количество туристов по путевке
    • Price – стоимость путевки за вычетом скидки (комиссии)
    • Payed – оплаченная сумма по путевке
    • NDay – продолжительность тура в днях
    • MainMan – ФИО лица, заключившего договор
    • MainManPhone – номер телефона лица, заключившего договор
    • MainManAddress – адрес лица, заключившего договор
    • MainManPassport – паспортные данные лица, заключившего договор
    • PartnerKey – ключ партнера, оформившего договор
    • Operator – ФИО создателя договора
    • Discount – величина скидки на одного человека
    • DiscountSum – абсолютная величина скидки
    • SORCode – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
    • CrDate – дата и время создания путевки
    • Rate – код валюты путевки
    • Advertise – ключ источника рекламы
    • Locked – блокировка путевки: 1 – если заблокирована
    • CauseDisc – ключ основания для скидки
    • PPaymentDate – максимальная дата внесения предоплаты
    • PaymentDate – максимальная дата полной оплаты
    • Procent – информация о предоплате: 1 – предоплата в %; 0 – предоплата в у.е.
    • TurDateBfrAnnul – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
    • ARKey – ключ причины аннуляции путевки
    • Key – ключ договора
    • CodePartner – значение ключевого поля из таблицы партнеров
    • FilialKey – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
    • IsOutDoc – статус выдачи документов
    • Notes – сообщение поставщику
    • DiscSumBfrAnn – числовое значение скидки перед аннуляцией путевки
    • PriceBfrAnn – стоимость путевки перед ее аннуляцией
    • RazmerP – размер предоплаты
    • LeadDepartment – ключ отдела, ведущего данный тур
    • MainManEmail – адрес е-mail из данных лица, заключившего договор
    • MainManComment – примечание из данных лица, заключившего договор
    • DupUserKey – ключ представителя партнера, которым был оформлен договор
    • BTKey – ключ системы бронирования, из которой был оформлен договор
    • ConfirmedDate – дата подтверждения путевки покупателю
    • PrtDogKey – договор партнера, по которому оформлена путевка
    • CTDepartureKey – ключ города начала поездки
    • PDTType – тип договора, по которому оформлена путевка
    • NationalCurrencyPrice – стоимость путевки в национальной валюте
    • NationalCurrencyDiscountSum – значение скидки в национальной валюте
    • NationalCurrencyPayed – сумма платежей по путевке, зафиксированная в национальной валюте
    • CurrencyKey – ключ национальной валюты путевки
    • CurrencyRate – курс национальной валюты путевки
    • ClientKey – ключ частника, которым был оформлен договор
    • Partner – информация о партнере покупателе, привязанным к путевке
      • $id – внутренний идентификатор для установки связей между сущностями
      • Key – ключ партнера покумателя
      • FullName – полное имя партнера
      • Name – имя партнера
    • Services – коллекция услуг в данной путевке
      • $id – внутренний идентификатор для установки связей между сущностями
      • DGCod – номер путевки
      • TurDate – дата начала тура
      • Key – ключ услуги
      • PaketKey – ключ пакета
      • TRKey – клют тура
      • SVKey – ключ типа услуги
      • Name – наименование услуги
      • Day – порядковый номер дня тура, в который предоставляется услуга
      • Code – ключ кода услуги
      • SubCode1 – ключ доп.описания 1 услуги
      • SubCode2 – ключ доп.описания 2 услуги
      • Men – количество человек, пользующихся услугой по путевке
      • Days – количество дней услуги
      • CNKey – ключ страны услуги
      • CTKey – ключ города услуги
      • PartnerKey – ключ партнера, предоставляющего услугу
      • Brutto – стоимость услуги брутто
      • Wait – признак услуги Снимать квоту при бронировании
      • Warning – неиспользуемое поле
      • TimeBeg – поле используется для сортировки услуг в путевке
      • Control – ключ статуса услуги (ссылка на таблицу Controls),
      • Attribute – атрибут услуги
      • DateBeg – дата начала действия услуги
      • DateEnd – дата окончания действия услуги
      • Discount – размер скидки по услуге
      • Comment – комментарий к услуге
      • DGKey – ключ договора,
      • Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
      • NameLat – наименование услуги (латинский)
      • Long – продолжительность тура в днях
      • TRFId – ключ тарифа
      • CreateDate – дата создания услуги в путевке
      • CalculatePriceDate – дата расчета цены
      • ShowOrder – порядок при сортировке
      • Connections – коллекция связей с сущностями через внутренний идентификатор $id
        • $ref – связь с внутренним идентификатором $id
    • Turists – коллекция туристов в данной путевке
      • $id – внутренний идентификатор для установки связей между сущностями
      • DGCod – номер путевки, к которому привязан турист
      • Key – ключ туриста
      • TurDate – дата начала тура
      • NameRus – фамилия туриста (русское)
      • NameLat – фамилия туриста (латинское)
      • ShortName – имя и отчество туриста в формате И.О.
      • Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
      • FNameRus – имя туриста (русское)
      • FNameLat – имя туриста (латинское)
      • SNameRus – отчество туриста (русское)
      • SNameLat – отчество туриста (латинское)
      • BirthDay – дата рождения туриста
      • BirthCountry – страна рождения туриста
      • BirthCity – город рождения туриста
      • Citizen – гражданство туриста
      • PostIndex – почтовый индекс
      • PostCity – адрес проживания туриста (город)
      • PostStreet – адрес проживания туриста (улица)
      • PostBild – адрес проживания туриста (номер дома)
      • PostFlat – адрес проживания туриста (номер квартиры)
      • Phone – номер телефона туриста
      • PhoneCode – код телефона туриста
      • PasportType – серия заграничного паспорта
      • PasportNum – номер заграничного паспорта
      • PasportDate – дата выдачи заграничного паспорта
      • PasportDateEnd – дата окончания срока действия заграничного паспорта
      • PasportByWhom – кем выдан заграничный паспорт
      • Place – место рождения
      • IsAnketa – выдавалась ли анкета
      • PaspRuser – серия общегражданского паспорта
      • PaspRuNum – номер общегражданского паспорта
      • PaspRuDate – дата выдачи общегражданского паспорта
      • PaspRuByWhom – кем выдан общегражданский паспорт
      • ClientId – ключ в таблице клиентов
      • IsMain – признак главного туриста по путевке
      • DGKey – ключ кутевки
      • RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
      • Email – е-mail туриста
      • EnableSmsNotifications – согласен получать уведомления по СМС
      • CitizenId – идентификатор туриста
      • Connections – коллекция связей с сущностями через внутренний идентификатор $id
        • $ref – связь с внутренним идентификатором $id
    • TuristServices – коллекция связей туриста с услугой
      • $id – внутренний идентификатор для установки связей между сущностями
      • TUKey – ключ туриста
      • DLKey – ключ услуги
      • NumDoc – номер документа (авиабилета)
      • NumRoom – номер комнаты (каюты)
      • Seat – номер места (в номере отеля, каюты) или место в транспорте
      • Area – зона (палуба) в отеле, круизе
      • DocDate – дата документа (авиабелета)
      • Key – первичный ключ связки
      • Connections – коллекция связей с сущностями через внутренний идентификатор $id
        • $ref – связь с внутренним идентификатором $id
    • DogovorMessages – сообщение по путевке покупателю
      • id – внутренний идентификатор для установки связей между сущностями
      • Date – дата создание сообщения
      • Text – текст сообщения
      • Remark – код сообщения
      • Connections – коллекция связей с сущностями через внутренний идентификатор $id
        • $ref – связь с внутренним идентификатором $id
развернутьПример


Выгрузка информации о ценовых блоках (CostOfferDescriptions)

Метод принимает на вход ключи ценовых блоков и возвращает, прикреплённое к ним описание.

  • Формат запроса:
    • GET .../TourSearchOwin/CostOfferDescriptions?
  • Принимаемые параметры ( * – обязательный):
    • COKeysString * – ключи ценовых блоков через запятую
  • Возвращаемый результат:
    • CostOfferImageInfo – коллекция объектов из двух полей:
      • IdCostOffer – ключ ценового блока
      • InfoText – описание ценового блока
развернутьПример



Получение капчи (GetCaptcha)

Метод возвращает капчу (используется при регистрации частного лица).

  • Формат запроса:
    • GET .../TourSearchOwin/GetCaptcha?
  • Принимаемые параметры ( * – обязательный):
    • sessionId * – Id сессии
  • Возвращаемый результат:
    • FileContents – файл капчи в бинарном виде
    • ContentType – расширение файла (image/jpeg)
    • FileDownloadName – имя файла
развернутьПример


Проверка капчи (CheckCaptcha)

Метод проверяет введенную капчу (используется при регистрации частного лица).

  • Формат запроса:
    • GET .../TourSearchOwin/CheckCaptcha?
  • Принимаемые параметры ( * – обязательный):
    • captchaText * – текст капчи
    • sessionId * – Id сессии
  • Возвращаемый результат:
    • true/false – результат проверки (false – капча или Id сессии неверные, true – капча верна)
развернутьПример


Проверка e-mail (CheckMail)

Метод проверяет e-mail при регистрации частного лица на существование такого же e-mail в базе данных.

  • Формат запроса:
    • GET .../TourSearchOwin/CheckMail?
  • Принимаемые параметры ( * – обязательный):
    • mail * – e-mail пользователя
  • Возвращаемый результат:
    • true/false – результат проверки (false – пользователь с таким e-mail уже существует, true – пользователь с таким e-mail нет в базе данных)
развернутьПример


Проверка туриста (checkTourist)

Метод служит для получения информации о путевке по номеру путевки и номеру паспорта туриста.

  • Формат запроса:
    • GET .../TourSearchOwin/checkTourist?
  • Принимаемые параметры ( * – обязательный):
    • dogovorNumber * – номер путевки.
    • passport * – номер паспорта туриста (заграничного или общегражданского).
  • Возвращаемый результат:
    • isDogovortrue, если путевка найдена по номеру путевки, false, если не найдена.
    • isAnnulatedtrue, если путевка аннулирована, false, если не аннулирована.
    • dogovorStatus – статус путевки
    • isPaytrue, если путевка полностью оплачена, false, если не оплачена или оплачена частично.
    • dogovorDateBegin – дата начала заезда.
    • dogovorDateEnd – дата окончания заезда.
    • dogovorDateCreate – дата создания путевки.
    • isTouristDogovorCreatetrue, если турист (по номеру паспорта) является главным туристом в путевке.
    • services – набор услуг в путевке.
      • svKey – код класса услуги.
      • code – код услуги.
      • subCode1 – код доп. описания 1 услуги.
      • subCode2 – код доп. описания 2 услуги.
      • name – название услуги.
    • touristInfo – информация о главном туристе.
      • lastname – фамилия туриста (рус).
      • firstname – имя туриста (рус).
      • surname – отчество туриста.
      • address – адрес (индекс, город, улица, дом, квартира).
      • postcode – индекс.
      • city – город.
      • street – улица.
      • home – дом.
      • roomNumber – квартира.
развернутьПример


Список значений параметра гражданства (Citizenships)

Метод служит для получения списка значений параметра гражданства.

  • Формат запроса:
    • GET .../TourSearchOwin/Citizenships?
  • Принимаемые параметры ( * – обязательный):
    • pageSize * – размер выдачи
    • pageNumber * – порядковый номер страницы выдачи
    • term * – подстрочный фильтр для отбора (пустой по умолчанию)
  • Возвращаемый результат:
    • Key – ключ страны
    • Name – название гражданства
развернутьПример


Выгрузка постоянного клиента (Client)

Метод выгружает постоянного клиента при авторизации частного лица.

  • Формат запроса:
    • GET .../TourSearchOwin/Client?
  • Принимаемые параметры ( * – обязательный):
    • clientId * – Id постоянного клиента
  • Возвращаемый результат:
    • $id – внутренний порядковый идентификатор
    • CL_KEY – ключ справочника постоянные клиенты
    • CL_OPERUPDATE – ключ менеджера, который последний обновил постоянного клиента
    • CL_OPERUPDATE – дата обновления постоянного клиента
    • CL_PFKEY – внутренний ключ
    • CL_NAMERUS – имя (на русском)
    • CL_NAMELAT – имя (на латинице)
    • CL_SHORTNAME – инициалы
    • CL_SEX – пол
    • CL_FNAMERUS – фамилия (на русском)
    • CL_FNAMELAT – фамилия (на латинице)
    • CL_SNAMERUS – отчество (на русском)
    • CL_SNAMELAT – отчество (на латинице)
    • CL_BIRTHDAY – дата рождения
    • CL_BIRTHCOUNTRY – страна рождения
    • CL_BIRTHCITY – место рождения (город)
    • CL_CITIZEN – гражданство
    • CL_ADDRESS – полный адрес
    • CL_POSTINDEX – почтовый индекс
    • CL_POSTCITY – город
    • CL_POSTSTREET – улица
    • CL_POSTBILD – дом
    • CL_POSTFLAT – квартира
    • CL_PHONE – телефон
    • CL_PASPORTSER – серия загранпаспорта
    • CL_PASPORTNUM – номер загранпаспорта
    • CL_PASPORTDATE – дата выдачи загранпаспорта
    • CL_PASPORTDATEEND – срок действия загранпаспорта
    • CL_PASPORTBYWHOM – кем выдан загранпаспорт
    • CL_PASPRUSER – серия общегражданского паспорта
    • CL_PASPRUNUM – номер общегражданского паспорта
    • CL_PASPRUDATE – дата выдачи общегражданского паспорта
    • CL_PASPRUBYWHOM – кем выдан общегражданский паспорт
    • CL_ISMARK – профессия
    • CL_TYPE – примечания
    • CL_IMPRESSNOTE – общие впечатления
    • CL_NOTE – особые отметки
    • CL_REMARK – примечания
    • CL_IMPRESSKEY – ключ выбранного впечатления
    • CL_TITLE1 – служебные отметки, заголовок 1
    • CL_TITLE2 – служебные отметки, заголовок 2
    • CL_TITLE3 – служебные отметки, заголовок 3
    • CL_TITLE4 – служебные отметки, заголовок 4
    • CL_FUTURE – пожелания
    • CL_LASTSTAT – информация о статистике
    • CL_SUMMA – сумма по клиенту
    • CL_NMENWITH – число спутников
    • CL_SUMDOGOVOR – сумма по путевкам
    • CL_NTRIP – число поездок
    • ROWID – внутренний идентификатор
    • cl_fax – факс
    • cl_mail: – e-mail
    • CL_MINCOST – минимальная стоимость поездки
    • CL_MAXCOST – максимальная стоимость поездки
    • CL_RealSex – пол
    • CL_EnableSmsNotifications – признак согласен получать sms-уведомление
    • CL_CHECKED – оповещения
    • CL_Creator – создатель постоянного клиента
    • CL_CreateDate – дата создания постоянного клиента
    • CL_Login – логин
    • CL_Password – пароль
    • CL_IsOnlineUser – является ли постоянный клиент онлайн пользователем
    • CL_CitizenID – ID гражданства
    • CARDS – информация о дисконтной карте
развернутьПример


Выгрузка описаний ценовых блоков (CostOfferDescriptions)

Метод выгружает описания ценовых блоков.

  • Формат запроса:
    • GET .../TourSearchOwin/CostOfferDescriptions?
  • Принимаемые параметры ( * – обязательный):
    • COKeysString * – ключи ценовых блоков
  • Возвращаемый результат:
    • IdCostOffer – Id ценового блока
    • InfoText – описание ценового блока
развернутьПример


Выгрузка описания по стране (CountryInfo)

Метод выгружает описание по стране.

  • Формат запроса:
    • GET .../TourSearchOwin/CountryInfo?
  • Принимаемые параметры ( * – обязательный):
    • countryKey * – ключ страны
  • Возвращаемый результат:
    • информация по выбранной стране
развернутьПример


Выгрузка картинки по отелю (HotelImages)

Метод выгружает картинку по отелю.

  • Формат запроса:
    • GET .../TourSearchOwin/HotelImages?
  • Принимаемые параметры ( * – обязательный):
    • hotelKeys * – ключ отеля (можно передать несколько ключей отеля, каждый раз указывая параметр hotelKeys), в этом случае возвращается информация о главном фото отеля
  • либо
    • hotelKey * – либо ключ отеля, в этом случае возвращается полная информация о всех фотографиях в отеле
  • Возвращаемый результат (если передан hotelKeys):
    • Name – название файла
    • HotelKey – ключ отеля
    • InfoExists – есть ли информация
    • ImagesCount – общее количество картинок по отелю
  • либо (если передан hotelKey)
    • Images – объект картинок
      • Key – ключ картинки
      • Description – описание картинки
      • Priority – приоритет
      • Name – название файла
      • HotelKey – ключ отеля
      • InfoExists – есть ли информация
    • Country – страна отеля
    • City – город отеля
    • Name – название отеля
    • HotelCategoryName – категория отеля
    • Address – адрес отеля
    • Phone – телефон
    • Email – e-mail
    • Http – адрес сайта
    • Description – описание отеля
    • InfrastructureHotel – инфраструктура отеля
    • RecreationSport – развлечения и спорт
    • Beach – информация о пляже
    • Healing – лечение
    • Excursion – экскурсии
    • AdditionalService – дополнительные услуги
    • ForChildren – для детей
    • AddCost – доплаты
    • CheckoutTimeFrom – заезд в отель
    • CheckoutTimeTo – выезд из отеля
    • Latitude – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
    • Longitude – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
развернутьПример краткой информации отеля


развернутьПример детальной информации отеля


Отображение картинки в браузере (GetImage)

Данный метод реализован не на API, а внутри самого приложения (Canary или TourSearchClient) и отображает картинку, полученную в методе HotelImages.

  • Принимаемые параметры ( * – обязательный):
    • code * – ключ отеля
    • type * – размер картинки (возможные значения: small1, small160x90, medium, big)
    • name * – название файла (берется из метода HotelImages)
    • imageType * – тип картинки (возможные значения: hotels, tours)
  • Возвращаемый результат:
    • изображение картинки отеля
развернутьПример картинки отеля


Выгрузка картинки по туру (TourImages)

Метод выгружает картинки по туру.

  • Формат запроса:
    • GET .../TourSearchOwin/TourImages?
  • Принимаемые параметры ( * – обязательный):
    • tourKeys * – ключ тура (можно передать несколько ключей тура, каждый раз указывая параметр tourKeys)
  • Возвращаемый результат:
    • Images – объект картинок
      • Key – ключ картинки
      • Description – описание картинки
      • Priority – приоритет
      • Name – название файла
      • TourKey – ключ тура
развернутьПример


Отображение картинки в браузере (GetImage)

Данный метод реализован не на API, а внутри самого приложения (Canary или TourSearchClient) и отображает картинку, полученную в методе TourImages.

  • Принимаемые параметры ( * – обязательный):
    • code * – ключ тура
    • type * – размер картинки (возможные значения: small1, small160x90, medium, big)
    • name * – название файла (берется из метода TourImages)
    • imageType * – тип картинки (возможные значения: hotels, tours)
  • Возвращаемый результат:
    • изображение картинки отеля
развернутьПример картинки отеля


Регистрация частного лица (PersonalRegistration)

Метод производит регистрацию частного лица.

  • Формат запроса:
    • GET .../TourSearchOwin/PersonalRegistration?
  • Принимаемые параметры ( * – обязательный):
    • name * – имя
    • surname * – фамилия
    • phone * – телефон
    • login * – e-mail (он же является логином). Предварительно нужно вызывать метод проверки e-mail CheckMail
    • password * – пароль (при упрощенной регистрации пароль не передается, а формируется системой автоматически)
    • citizen * – гражданство (возможна передача пустого значения)
    • country * – страна (возможна передача пустого значения)
    • city * – город (возможна передача пустого значения)
    • address * – адрес (возможна передача пустого значения)
    • comment * – комментарий (возможна передача пустого значения)
    • captchaText * – текст капчи. Предварительно нужно вызывать метод получения капчи GetCaptcha. Полученный FileContents преобразовать с помощью json в картинку, текст из которой вставить как значение captchaText.
    • sessionId * – Id сессии (возможна передача произвольного значения)
  • Возвращаемый результат:
    • SxotpFhg – сформированный (при упрощенной регистрации) или заданный пользователем пароль
развернутьПример


Выгрузка плана рассадки (TransportPlan)

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

  • Формат запроса:
    • GET .../TourSearchOwin/TransportPlan?
  • Принимаемые параметры ( * – обязательный):
    • code * – код услуги
    • dateBegin * – дата начала услуги
    • serviceType * – класс услуги
    • transportKey * – ключ транспорта
  • Возвращаемый результат:
    • TransportKey – ключ транспорта
    • Title – название
    • AreasCount – количество зон (уровней)
    • RowsCount – количество рядов
    • ColumnsCount – количество колонок
    • BusySeats – информация о занятых местах
    • Cells – блок не заполняется
      • Row – ряд
      • Column – колонка
      • Area – уровень
      • Type – тип места (1 - свободно, 5 - занято)
      • Name – номер места
    • UserSeats – блок не заполняется
    • BlockSeat – блок не заполняется
развернутьПример


Выгрузка списка всех стран (Countries)

Метод производит выгрузку всех стран (используется для регистрации частного лица).

  • Формат запроса:
    • GET .../TourSearchOwin/Countries?
  • Принимаемые параметры ( * – обязательный):
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Key – ключ страны
    • Name – название
развернутьПример



Выгрузка списка всех городов (Cities)

Метод производит выгрузку всех городов (используется для регистрации частного лица).

  • Формат запроса:
    • GET .../TourSearchOwin/Cities?
  • Принимаемые параметры ( * – обязательный):
    • countryKey * – ключ страны, по которой выгружать города (при значении -1 выгружаются все города)
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Key – ключ города
    • Name – название
развернутьПример



Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)

Метод производит выгрузку городов отправления в оформлении клиентов.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClientsDepartureCities?
  • Принимаемые параметры ( * – обязательный):
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
    • withoutFlight – перевод для ключа -1 (Без перелета)
  • Возвращаемый результат:
    • Key – ключ города
    • Name – название
    • IsExist – информация о том, есть ли в этом городе отправления актуальные программы туров (true/false)
развернутьПример



Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)

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

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClientsDestination?
  • Принимаемые параметры ( * – обязательный):
    • departureCity * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
  • Возвращаемый результат:
    • Name – название
    • Key – ключ страны
    • DestinationType – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
    • IsExist – информация о том, есть ли в этой стране актуальные программы туров (true/false)
развернутьПример



Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)

Метод производит выгрузку турпрограмм в оформлении клиентов.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClientsTourPrograms?
  • Принимаемые параметры ( * – обязательный):
    • departureCity * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
    • destination * – ключ страны (из контроллера .../TourSearchOwin/RegistrationClientsDestination?)
    • destinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
    • individualTitle – перевод для программы тура с ключом 0 (Индивидуально)
  • Возвращаемый результат:
    • Key – ключ программы туров
    • Name – название программы туров
    • Rate – валюта тура
развернутьПример



Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)

Метод производит выгрузку дат заезда в оформлении клиентов.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClientsTourDate?
  • Принимаемые параметры ( * – обязательный):
    • tourKey * – ключ программы тура
  • Возвращаемый результат:
    • массив дат
развернутьПример


Поиск туров в оформлении клиентов (Search)

Метод возвращает наиболее дешевое предложения по определенному туру.

  • Формат запроса:
    • GET .../TourSearchOwin/RegistrationClient/Search?
  • Принимаемые параметры ( * – обязательный):
    • DepartureCityKeys * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
    • Dates * – дата заезда (из контроллера .../TourSearchOwin/RegistrationClientsTourDate?)
    • Durations * – продолжительность
    • PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
    • PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
    • isFromBasket * – всегда false
    • isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
    • DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • DestinationKey * – идентификатор страны прибытия (из контроллера .../TourSearchOwin/RegistrationClientsDestination?)
    • AdultCount * – количество взрослых
    • ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • IsRegistrationClients – по умолчанию всегда приходит false
    • CurrencyName * – код валюты
    • AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelScheme – пустой по умолчанию
    • TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
    • TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
    • TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
    • TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
    • ArrivalFlightNoTransfer – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
    • DepartureFlightNoTransfer – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
    • TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
    • Tour – ключ программы тура
  • Возвращаемый результат:
    • CheckMessages – сообщения для логики проверки тура (не используется)
    • Message – сообщение об ошибке
      • Key – код ошибки
      • Value – сообщение об ошибке
    • Result – результаты поиска
      • Key – идентификатов программы тура
      • Name – название программы тура
      • TourUrl – ссылка на программу тура
      • BookingConditions – условия бронирования программы туров
      • StartDate – дата начала тура
      • Duration – продолжительность тура (в днях)
      • DurationInNight – продолжительность проживания (в ночах)
      • Types – идентификатор типа туров
      • Cost – цена тура
      • Rate – код валюты тура
      • CityDepature – город отправления
        • Key – идентификатор города отправления
        • Value – название города отправления
      • CountryId – всегда возвращается ключ 0
      • Services – услуги в туре
        • DepartureCity – город отправления
          • Key – идентификатор
          • Value – название
        • DepartureCountry – страна отправления
          • Key – идентификатор
          • Value – название
        • ArrivalCity – город прибытия
          • Key – идентификатор
          • Value – название
        • ArrivalCountry – страна прибытия
          • Key – идентификатор
          • Value – название
        • DepartureAirport – аэропорт отправления
          • Key – идентификатор
          • Value – название
        • ArrivalAirport – аэропорт прибытия
          • Key – идентификатор
          • Value – название
        • Airline – авиакомпания
          • Key – идентификатор
          • Value – название
        • Aircraft – воздушное судно
          • Key – идентификатор
          • Value – название
        • Flight – рейс
          • Key – идентификатор
          • Value – название
        • DepartureTime – время вылета
        • ArrivalTime – время прилета
        • EndDateTime – дата и время прилета
        • FlightDetails – информация об авиаперелете
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – название тарифа
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – название
        • FlightSetting – внутренняя информация о перелете из программы туров
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор перелета (внутренняя информация из программы туров)
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
      • NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
        • ServiceName – название типа услуги
        • City – объект город
          • Key – ключ города
          • Value – название города
        • Country – объект страна
          • Key – ключ страны
          • Value – название страны
        • Code – объект код услуги
          • Key – ключ услуги
          • Value – название услуги
        • ByScheduler – флаг услуга по расписанию или нет
        • Details – объект детализация услуги
          • SubCode1 – объект доп. описание 1
            • Key – ключ доп. описания 1
            • Value – название доп. описания 1
          • SubCode2 – объект доп. описание 2
            • Key – ключ доп. описания 2
            • Value – название доп. описания 2
          • Date – дата услуги
          • IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
          • Cost – цена
          • QuotaStatus – объект информация по квотам
            • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – идентификатор партнера
          • ByPax – признак цены за человека
          • Partner – объект партнер (не заполняется)
            • Key – ключ (не заполняется)
            • Value – название (не заполняется)
        • ParentId – идентификатор родительской услуги (для вложенных услуг)
        • PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
        • Id – идентификатор услуги
        • SvKey – ключ типа услуги
        • IsSubCode1 – наличие доп. описания 1
        • IsSubCode2 – наличие доп. описания 2
        • IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – скрытая ли услуга
        • IsDeleted – удаляемая ли услуга
        • IsNotCalculate – не рассчитываемая ли услуга
        • PacketId – пакет услуги
        • Index – индекс услуги
      • MinCostServicesComposition – массив состав услуг минимальной цены
        • Key – ключ
          • TemplateId – идентификатор шаблона
          • PatternId – идентификатор вкладки
          • SettingId – идентификатор услуги
        • Value – значение
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • CountryId – страна услуги
          • CityId – город услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
        • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
          • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
          • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
            • SpecialKey – ключ акции
            • SpecialName – название акции
            • SpecialType – тип акции
            • NewPrice – цена после применения акции
            • OldPrice – цена до применения акции
            • ShowOnline – нужно ли показывать акцию в поиске
            • UntilDate – акция действует при совершении покупки до указанной даты
            • Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
              • NightsFrom (для типа PayStay) – ночей от
              • NightsTo (для типа PayStay) – ночей до
              • NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
              • OperationType (для типа PayStay) – тип действия
              • SpecialNightType (для типа PayStay) – тип бесплатной ночи
              • DurationFrom (для типа KickBack) – ночей от
              • DurationTo (для типа KickBack) – ночей до
              • Value (для типа KickBack) – значение продолжительности, равное заданному периоду
              • OperationType (для типа KickBack) – тип действия
              • NightsFrom (для типа EarlyBird) – ночей от
              • NightsTo (для типа EarlyBird) – ночей до
              • Discount (для типа EarlyBird) – размер скидки
              • OperationType (для типа EarlyBird) – тип действия
        • COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
        • SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
      • FlightWeight
      • LinkingFlightsRules – объект правил связывания
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
      • RouteSubVariants – подварианты услуг (используется в основном поиске)
    • SecondaryFiltersResult – результаты доп. фильтров
      • TourTypes – типы тура
        • Id – ключ типа тура
        • Name – название типа тура
        • ParentId – родительский элемент типа тура (если есть)
        • Type – тип справочника (используется для внутренних целей)
      • TourPrograms – информация по каждой турпрограмме
        • Key – ключ турпрограммы
        • Name – название турпрограммы
        • TourUrl – ссылка на тур
        • BookingConditions – условия бронирования
        • IsLandOnly – признак только наземное обслуживание
        • IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
        • IsHotelTemplates – есть ли вообще отели в данной турпрограмме
        • IsRouteServices – есть ли маршрутные услуги
        • MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
        • Rate – валюта тура
        • DateStart – нижняя граница дат заезда по программе тура
        • DateEnd – верхняя граница дат заеда по программе тура
        • Status – статус турпрограммы
          • Key – ключ
          • Value – значение
        • Templates – шаблоны услуг
          • $id – шаблон 1
          • $id – шаблон 2
        • Types – типы тура
          • Id – ключ типа тура
          • Name – название типа тура
          • ParentId – родительский элемент типа тура (если есть)
          • Type – тип справочника (используется для внутренних целей)
        • LinkingFlightsRules – правила связывания перелетов
          • notCombineDifferentAirlineRule
            • airlines
            • flightSettings
            • enabled
          • checkPlusMinus1CharterRule
            • FlightSettingPairs
            • enabled
          • notCombineDifferentTariffGroupRule
            • FlightSettings
            • enabled
          • notCombineDifferentPartnerRule
            • FlightSettings
            • enabled
          • departureCityEqualsArrivalCityRule
            • FlightSettingPairs
            • enabled
          • combineOnlySpecificChartersRule
            • settings
            • enabled
        • Type – тип справочника (используется для внутренних целей)
      • TourDurations – продолжительность тура
      • TourDates – список дат заездов в турпрограмме
        • HotelCities – город в дополнительных фильтрах
          • '
        • HotelResorts – курорты в дополнительных фильтрах
          • '
        • HotelCategories – категории отеля в дополнительных фильтрах
          • '
        • Hotels – отели в дополнительных фильтрах
          • '
        • Pansions – питания в дополнительных фильтрах
          • '
        • Airlines – авиакомпании в дополнительных фильтрах
          • '
        • FlightTariffs – класс перелета в дополнительных фильтрах
          • '
        • DepartureCities – города вылета в дополнительных фильтрах
          • '
        • DepartureAirports – аэропорты вылета в дополнительных фильтрах
          • '
        • ArrivalCities – города прибытия в дополнительных фильтрах
          • '
        • ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
          • '
        • HotelTypes – признаки отелей в дополнительных фильтрах
          • '
развернутьПример



Поиск туров онлайн (TourForWeb)

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

  • Обычный формат запроса GET:
    • GET .../TourSearchOwin/TourForWeb/search/simple?
  • Принимаемые параметры ( * – обязательный):
    • DepartureCityKeys * – идентификатор города отправления (полученный из метода .../TourSearchOwin/departureCities?)
    • Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
    • PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
    • PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
    • HotelScheme * – объект схемы отеля
    • TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
    • TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
    • ShowToursWithoutHotels – показывать ли туры без проживания
    • isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false).
    • isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
    • DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
    • DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
    • AdultCount * – количество взрослых
    • CurrencyName * – код валюты
    • AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
    • TourType – тип тура
    • CityIds – идентификатор города
    • TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
    • TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
    • TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
    • TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
    • SearchId – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.
    • MatrixAlgoritm – используется ли дополнительный фильтр «Таблица цен»
    • SearchMaxPriceAlgoritm
    • wrongLicenseFileUpperTitle – проверка файла лицензии
    • RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
  • Возвращаемый результат:
    • Result – результаты поиска
      • Key – идентификатор программы тура
      • Name – название программы тура
      • TourUrl – ссылка на программу тура
      • BookingConditions – условия бронирования программы туров
      • DefaultManagers – менеджер по-умолчанию
      • Manager – обозначение менеджера
      • Branches – филиал
      • DetermineTheBranchOnCity – признак определения филиала в зависимости от города начала поездки
      • StartDate – дата начала тура
      • Duration – продолжительность тура (в днях)
      • DurationInNight – продолжительность проживания (в ночах)
      • Types – идентификатор типа туров
      • Cost – цена тура
      • Rate – код валюты тура
      • CityDepature – город отправления
        • Key – идентификатор города отправления
        • Value – название города отправления
      • CountryId – всегда возвращается ключ 0
      • Services – услуги в туре
        • DepartureCity – город отправления
          • Key – идентификатор
          • Value – название
        • DepartureCountry – страна отправления
          • Key – идентификатор
          • Value – название
        • ArrivalCity – город прибытия
          • Key – идентификатор
          • Value – название
        • ArrivalCountry – страна прибытия
          • Key – идентификатор
          • Value – название
        • DepartureAirport – аэропорт отправления
          • Key – идентификатор
          • Value – название
        • ArrivalAirport – аэропорт прибытия
          • Key – идентификатор
          • Value – название
        • Airline – авиакомпания
          • Key – идентификатор
          • Value – название
        • Aircraft – воздушное судно
          • Key – идентификатор
          • Value – название
        • Flight – рейс
          • Key – идентификатор
          • Value – название
        • DepartureTime – время вылета
        • ArrivalTime – время прилета
        • TotalTimeOfFlight – полное время перелета
        • FlightDetails – детали авиаперелета
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – наименование тарифа
          • IsCommission – признак, комиссионная ли услуга
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – наименование
        • FlightSetting – информация о шаблоне услуги авиаперелета
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор внешнего перелета
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
        • DepartureCity – город отправления
          • Key – ключ города
          • Value – наименование города
        • DepartureCountry – страна отправления
          • Key – ключ страны
          • Value – наименование страны
        • ArrivalCity – город прибытия
          • Key – ключ города
          • Value – наименование города
        • ArrivalCountry – страна прибытия
          • Key – ключ страны
          • Value – наименование страны
        • DepartureAirport – аэропорт прилета
          • Key – ключ аэропорта
          • Value – наименование аэропорта
        • ArrivalAirport – аэропорт прилета
          • Key – ключ аэропорта
          • Value – наименование аэропорта
        • Airline – наименование авиакомпании
          • Id – идентификатор авиакомпании
          • Value – наименование авиакомпании
          • Key – ключ авиакомпании
        • Aircraft – воздушное судно
          • Key – ключ воздушного судна
          • Value – наименование воздушного судна
        • Flight – перелет
          • Key – ключ перелета
          • Value – наименование авиаперелета
        • DepartureTime – время отправления
        • ArrivalTime – время прилета
        • TotalTimeOfFlight – полное время перелета
        • FlightDetails – информация об авиаперелете
          • Tariff – информация о тарифе перелета
            • Key – идентификатор
            • Code – код тарифа
            • Name – название тарифа
          • IsCommission – признак, комиссионная ли услуга
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – наименование
        • FlightSetting – внутренняя информация о перелете из программы туров
          • ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
          • PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
          • FlightId – идентификатор перелета (внутренняя информация из программы туров)
        • FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
          • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
        • Hotel – отель
          • Key – ключ отеля
          • Value – наименование отеля
        • City – город
          • Key – ключ города
          • Value – наименование города
        • Stars – категория отеля
          • Key – ключ категории отеля
          • Value – наименование категории отеля
        • StarsGlobalCode – глобальный код категории отеля
          • Key – глобальный ключ категории отеля
          • Value – наименование категории отеля
        • Resort – курорт
          • Key – ключ курорта
          • Value – наименование курорта
        • ImageURL – ссылка на лого отеля
        • Http – ссылка на сайт отеля
        • Description – описание
        • Latitude – GPS координаты: географическая широта
        • Longitude – GPS координаты: географическая долгота
        • Country – страна
          • Key – ключ страны
          • Value – наименование страны
        • HotelDetails – массив данных отель
          • HotelRoom – категория номера
          • Room – номер
            • Key – ключ номера
            • Value – наименование номера
          • RoomCategory – тип номера
            • Key – ключ типа номера
            • Value – наименование типа номера
          • AccomodationType – тип размещения
            • Key – ключ типа размещения
            • Value – наименование типа размещения
            • AdultCount – количество взрослых
            • ChildCount – количество детей
          • Pansion – тип питания
            • Key – ключ типа питания
            • Value – наименование типа питания
          • PansionGlobalCode – глобальный код типа питания
            • Key – ключ типа питания
            • Value – наименование типа питания
          • RemoteId – не используется
          • Cost – разница в стоимости с самым дешевым вариантом
          • QuotaStatus – информация о квоте
            • PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
            • FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
            • IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
          • PartnerId – ключ партнера
          • ByPax – цена за человека (true/false)
          • Partner – информация о партнере
            • Key – идентификатор
            • Value – название
        • HotelTypes – признаки отелей в дополнительных фильтрах
          • Key – ключ
          • Value – значение
        • RemoteId – не используется
        • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
          • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
          • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
        • Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
        • SvKey – ключ типа услуги
        • IsSubCode1 – признак наличия доп. описания 1
        • IsSubCode2 – признак наличия доп. описания 2
        • IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
        • Day – день предоставления услуги
        • DurationInNight – продолжительность услуги в ночах
        • BeginDateTime – дата предоставления услуги
        • EndDateTime – дата окончания услуги
        • IsHooded – признак скрытая услуга
        • IsDeleted – признак удаляемая услуга
        • IsNotCalculate – признак не рассчитываемая услуга
        • PacketId – ключ пакета
        • Index – порядковый номер услуги
      • NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
      • MinCostServicesComposition – массив состав услуг минимальной цены
        • Key – ключ
          • TemplateId – идентификатор шаблона
          • PatternId – идентификатор вкладки
          • SettingId – идентификатор услуги
        • Value – значение
          • ServiceType – тип услуги
          • Code – ключ услуги
          • SubCode1доп. описание 1
          • SubCode2доп. описание 2
          • PacketId – пакет услуги
          • PartnerId – партнер услуги
          • CountryId – страна услуги
          • CityId – город услуги
          • Day – день предоставления услуги
          • DurationInNight – продолжительность услуги в ночах
          • GDSProviderId – ключ провайдера из внешней системы
          • COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
            • AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
            • AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
          • COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
          • SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
      • FlightWeight – общий вес перелетов маршрута
      • LinkingFlightsRules – объект правил связывания
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
      • RouteSubVariants – подварианты услуг (используется в основном поиске)
      • Routes – массив возможных маршрутов в данной программе туров
      • IsRemoteHotels – удаленные отели
    • SecondaryFiltersResult – результаты доп. фильтров
      • TourTypes – типы тура
        • Id – ключ типа тура
        • Name – название типа тура
        • ParentId – родительский элемент типа тура (если есть)
        • Type – тип справочника (используется для внутренних целей)
      • TourPrograms – информация по каждой турпрограмме
        • Key – ключ турпрограммы
        • Name – название турпрограммы
        • TourUrl – ссылка на тур
        • BookingConditions – условия бронирования
      • DefaultManagers – менеджер по-умолчанию
      • Manager – обозначение менеджера
      • Branches – филиал
      • DetermineTheBranchOnCity – признак определения филиала в зависимости от города начала поездки
        • IsLandOnly – признак только наземное обслуживание
        • IsApplyMarginAddCostToRemoteService
        • IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
        • IsHotelTemplates – есть ли вообще отели в данной турпрограмме
        • IsRouteServices – есть ли маршрутные услуги
        • IsAviaBooking
        • MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
        • Rate – валюта тура
        • RateId – идентификатор валюты тура
        • DateStart – нижняя граница дат заезда по программе тура
        • DateEnd – верхняя граница дат заезда по программе тура
        • DateList – список дат заездов
        • UpdateDate – дата обновления
        • Status – статус турпрограммы
          • Key – ключ
          • Value – значение
        • Templates – шаблоны услуг
          • $id – шаблон 1
          • $id – шаблон 2
        • Types – типы тура
          • Id – ключ типа тура
          • Name – название типа тура
          • ParentId – родительский элемент типа тура (если есть)
          • Type – тип справочника (используется для внутренних целей)
        • LinkingFlightsRules – правила связывания перелетов
        • notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
          • airlines – авиакомпании
          • flightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
          • FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
          • enabled – флаг включен/выключен
        • notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
          • FlightSettings – массив ключей ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
          • FlightSettingPairs – чартеры, для которых это будет выполняться
          • enabled – флаг включен/выключен
        • combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
          • settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
          • enabled – флаг включен/выключен
        • IsMultiHotel
        • Type – тип справочника (используется для внутренних целей)
      • TourDurations – продолжительность тура
      • TourDates – список дат заездов в турпрограмме
        • HotelCities – город в дополнительных фильтрах
          • key – ключ города
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName – наименование поля ИНН
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
          • name – наименование города
          • Code – код города
          • Web
          • RSKey
          • WebImage
          • IsDeparture
          • Key – ключ города
          • Type – тип (город)
        • HotelResorts – курорты в дополнительных фильтрах
          • CountryKey – ключ
          • Name – наименование
          • NameLat – наименование латиницей
          • Key – ключ
          • Type – тип (курорт)
        • HotelCategories – категории отеля в дополнительных фильтрах
          • Name – наименование категории
          • PrintNumber – номер для печати
          • GlobalCode – глобальный код
          • Key – ключ
          • Type – тип (категория отеоля)
        • Hotels – отели в дополнительных фильтрах
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
        • Сity – город
          • key – ключ города
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
          • name – наименование города
          • Code – код города
          • Web
          • RSKey
          • WebImage
          • IsDeparture
          • Key – ключ города
          • Type – тип (город)
        • Resort – курорт
          • ResortKey – ключ курорта
          • Name – наименование
          • Category – категория
            • Name – наименование категории
            • PrintNumber – ключ для печати
            • GlobalCode – глобальный код
            • Key – ключ
            • Type – тип (категория отеля)
          • CategoryKey – ключ категории
          • TimeFrom – время с
          • TimeTo – время по
          • HTTP": сайт
          • Stars – категория
          • TimeIsEmpty – вышло ли время
          • NameLat – наименование латиницей
          • Address – адрес
          • IsCruise – имеется круиз
          • Phone – телефон
          • Email – E-mail
          • Fax – факс
          • Code – код
          • Site – сайт
          • Descript – описание
          • PayHourNote – час оплаты
          • EarlyCheckInSurcharge – доплаты за ранний заезд
          • LateCheckOutSurcharge – доплата за поздний выезд
          • Latitude – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
          • Longitude – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
          • DescExcur
          • DescSport
          • DescHealth
          • DescService
          • Key – ключ
          • Type – тип (отель)
        • Pansions – питание
          • Code – код питания
          • Name – наименование питания
          • NameLat – наименование питания латиницей
          • GlobalCode – глобальный код
          • Key – ключ
          • Type – тип (питание)
        • Airlines – авиакомпании в дополнительных фильтрах
          • Key – ключ авиакомпании
          • Code – код авиакомпании
          • ICAO – код ИКАО
          • Name – наименование авиакомпании
          • NameLat – наименование авиакомпании латиницей
          • Type – тип (авиакомпания)
        • FlightTariffs – класс перелета в дополнительных фильтрах
          • Key – ключ
          • Code – код
          • Name – наименование
          • NameLat – наименование латиницей
          • Group – группа
          • Type – тип (авиаперелет)
        • DepartureCities – города вылета в дополнительных фильтрах
          • key – ключ города
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
          • name – наименование города
          • Code – код города
          • Web
          • RSKey
          • WebImage
          • IsDeparture
          • Key – ключ города
          • Type – тип (город)
        • DepartureAirports – аэропорты вылета в дополнительных фильтрах
          • Key – ключ
          • Code – код аэропорта
          • Name – наименование аэропорта
          • NameLat – наименование аэропорта латиницей
          • CityKey – ключ города
          • CountryKey – ключ страны
          • Letter – присвоенный символд
          • Site – сайт
          • Type – тип (аэропорт)
        • ArrivalCities – города прибытия в дополнительных фильтрах
          • key – ключ города
          • Country – страна
            • key – ключ страны
            • name – наименование страны
            • Code – код страны
            • DigitCode – цифровой код
            • Alpha2Code
            • Alpha3Code
            • CitizenName – наименование страны
            • CitizenNameLat – наименование страны латиницей
            • PassportMinDurCheckFrom
            • CheckINN – проверка ИНН
            • PassportMinDur
            • INNName
            • Web
            • WebImage – логотип страны
            • WebHTTP – сайт
            • AnkLang
            • Key – ключ страны
            • Type – тип (страна)
          • name – наименование города
          • Code – код города
          • Web
          • RSKey
          • WebImage
          • IsDeparture
          • Key – ключ города
          • Type – тип (город)
        • ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
          • Key – ключ аэропорта
          • Code – код аэропорта
          • Name – наименование аэропорта
          • NameLat – наименование аэропорта латиницей
          • CityKey – ключ города
          • CountryKey – ключ страны
          • Letter – буква аэропорта
          • Site – сайт
          • Type – тип (аэропорт)
        • HotelTypes – признаки отелей в дополнительных фильтрах
          • key – ключ
          • name – обозначение
          • Type – тип (отель)
        • ComplexHotelIds
        • Message – сообщение
          • Key – ключ
          • Value – значение
развернутьПример


  • Формат запроса GET с таблицей цен:
    • GET .../TourSearchOwin/TourForWeb/search/matrix?
  • Принимаемые параметры ( * – обязательный):

Аналогичны стандартному запросу (simple)

  • Возвращаемый результат:
    • CellsForMatrix – ячейки таблицы
      • Key – ключ
      • StartDate – дата начала
      • Duration – продолжительность
      • DurationInNight – количество ночей
      • Cost – цена
    • CitiesWithMinimalCosts – города с минимальной ценой
      • DepartureCityKey – ключ города отправления
      • ArrivalCityKey – ключ города прибытия
      • DepartureCityName – наименование города отправления
      • ArrivalCityName – наименование города прибытия
      • RouteMinimalPrice – минимальная цена маршрута
    • TourMinimalAndMaximalCost – минимальная и максимальная цены тура
      • MinimalPrice – минимальная цена
      • MaximalPrice – максимальная цена
развернутьПример


  • Формат запроса GET с минимальной и максимальной ценой:
    • GET .../TourSearchOwin/TourForWeb/search/minMaxPrices?
  • Принимаемые параметры ( * – обязательный):

Аналогичны стандартному запросу (simple)

  • Возвращаемый результат:
    • MinimalPrice – минимальная цена
    • MaximalPrice – максимальная цена
развернутьПример


Проверка дублирующих туристов (CheckDoubleDogovor)

Метод проверяет есть ли дублирующие туристы в существующих путевках. Проверка на дублирование регулируется настройкой Предупреждать при дублировании туристов.

  • Формат запроса POST:
    • POST .../TourSearchOwin/CheckDoubleDogovor
  • Принимаемые параметры ( * – обязательный):
    • TourProgramId * – ключ турпрограммы
    • BeginDate * – дата начала тура
    • Duration * – продолжительность тура
    • Currency * – код валюты
    • Services * – массив услуг авиаперелетов для получения доплат
      • Service * – объект услуга авиаперелет
        • ServiceType * – тип услуги
        • Code * – код услуги
        • SubCode1 *доп. описание 1 услуги
        • SubCode2 *доп. описание 2 услуги
        • Packet * – ключ пакета услуги
        • Partner * – ключ партнера услуги
        • Day * – день предоставления услуги
        • DurationInNight * – продолжительность услуги в ночах
        • City * – ключ города
        • Country * – страна услуги
        • Attributes * – битовая маска атрибутов услуг
        • IsRemovable * – (не обрабатывается)
        • Type * – тип услуги в путевке (базовая дополнительная)
        • IsHooded * – признак скрытая услуга
        • IsNotCalculated * – признак не рассчитываемая услуга
        • BeginDateTimeString * – дата и время начала услуги
        • EndDateTimeString * – дата и время окончания услуги
        • TemplateId * – шаблон услуги
        • Cost * – цена услуги
        • ByPax * – цена за человека
        • QuotaStatus * – объект статус квотирования
          • PlacesStatus * – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
          • FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
          • IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
        • Index * – индекс услуги
        • IsRoute * – признак маршрутная услуга
        • ServiceTemplateIndex * – индекс шаблона услуги
        • RemoteId * – информация об услуге во внешней системе
        • IsCommission * – признак, комиссионная ли услуга
        • BaseFlightsParams * – параметры рассчитанных авиаперелетов
          • CityArrival * – ключ города прибытия прямого перелета
          • FlightCode * – ключ прямого авиаперелета
          • TariffKey * – ключ тарифа прямого авиаперелета
          • PartnerId * – ключ партнера прямого авиаперелета
      • TouristNumbersList * – массив туристов, привязанных к услуге
    • Tourists * – массив туристов
      • IsMain * – главный турист
      • Number * – порядковый номер туриста
      • AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
      • MaleFemaleSex * – пол (0 – мужской, 1 – женский)
      • FirstName * – имя (лат)
      • LastName * – фамилия (лат)
      • Patronymic * – отчество (лат)
      • FirstNameRus * – имя (рус)
      • LastNameRus * – фамилия (рус)
      • PatronymicRus * – отчество (рус)
      • InternationalPassportSeries * – серия загранпаспорта
      • InternationalPassportNumber * – номер загранпаспорта
      • InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
      • InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
      • InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
      • internationalPassportByWhom * – кем выдан загранпаспорт
      • PassportSeries * – серия паспорта
      • PassportNumber * – номер паспорта
      • PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
      • PassportDateOfIssueString * – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
      • PassportByWhom * – кем выдан паспорт
      • Citizenship * – название страны
      • Phone * – телефон
      • Email * – e-mail
      • BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
      • BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
      • BirthPlace * – место рождения
      • CitizenID * – ID туриста (задается в карточке постоянного клиента)
      • Age * – количество полных лет на момент окончания тура
    • TechnicalProblemsDuringUpdateFlights * – технические проблемы при обновлении рейсов
    • TimeLimit * – лимит времени
    • CountryKey * – ключ страны
    • OwnerId * – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура.
    • Day * – день Может быть с пустым значением
    • Day2 * – дня Может быть с пустым значением
    • Days * – дней Может быть с пустым значением
    • Night * – ночь Может быть с пустым значением
    • Night2 * – ночи Может быть с пустым значением
    • Nights * – ночей Может быть с пустым значением
    • adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги Может быть с пустым значением
    • at * – на (перевод) Может быть с пустым значением
    • incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) Может быть с пустым значением
  • Возвращаемый результат:
    • Errors – описание ошибки
    • Warnings – предупреждение
    • States – статус
    • IsValid – результат проверки подключения (true/false)
развернутьПример


Дополнительные методы

Выгрузка измененных турпрограмм (TourProgram) начиная с релиза 15.3

Метод производит выгрузку измененных турпрограмм, в которых были сделаны изменения с указанной даты и времени и повлияли на маршруты в турпрограмме. К таким изменениям относятся изменения страны и города начала поездки, страны и города по туру, типа тура. Изменения цен по услугам не приводят к обновлению турпрограмме, такие турпрограммы в ответе не будут указаны. Турпрограммы, по которым статус Доступен для продажи сменился на другой за период, указанный в запросе, в ответе тоже не будут указаны.

  • Формат запроса:
    • GET .../TourSearchOwin/TourProgram?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • fromDateTime – дата (в формате dd.MM.yyyy HH:mm:ss), начиная с которой будут выгружаться изменения,
  • Возвращаемый результат:
    • Key – ключ программы туров
    • Name – название программы туров
    • UpdateDate – дата последнего изменения программы туров (или связанных с ней компонентов)
    • routes – массив возможных маршрутов в данной программе туров
      • departureCountryKey – страна начала поездки (для каждой страны начала поездки в одной программе тура будет отдельный маршрут)
      • departureCityKey – город начала поездки (для каждого города начала поездки в одной программе тура будет отдельный маршрут)
      • destinationCountryKeys – страны по туру (если в туре несколько услуг класса отель и они в разных странах, то будут возвращаться все страны отелей)
      • destinationCityKeys – города по туру (если в туре отели в нескольких городах, то будут возвращаться все города отелей)
      • tourTypeKeys – типы туров для данной программы туров
развернутьПример


Проверка построения маршрутов турпрограммы (CheckTourProgram)

Метод производит построение маршрутов турпрограмм (вызывается из проверки тура). Метод проверяет маршруты по турпрограммам с любым статусом (не только по статусу Доступен для подажи).

  • Формат запроса:
    • GET .../TourSearchOwin/CheckTourProgram?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • tourKey – ключ турпрограммы
  • Возвращаемый результат:
    • Message – сообщение Начинаем строить маршрут.
    • Message – сообщение Маршрутов по данной программе тура построилось – количество
    • Message – сообщение Построено каркасов маршрутов (без конкретных отелей) – количество
развернутьПример


Получение разметки формы для новой формы быстрого поиска (GetJavascriptFile)

Метод получает разметку формы для новой формы быстрого поиска.

  • Формат запроса:
    • GET .../TourSearchOwin/GetJavascriptFile/Get?
  • Принимаемые параметры GET запроса ( * – обязательный):
    • name – имя файла
  • Возвращаемый результат:
    • полученный файл
развернутьПример


Проверка подключения к внешним системам (GDSCheckConnection)

Метод производит проверку подключения к внешней системе.

  • Формат запроса:
    • POST .../TourSearchOwin/GDSCheckConnection?
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • adapterTypeName – адаптер
    • id – ключ адаптера
    • apiAddress – api-адрес
    • settings – набор настроек (у каждого адаптера индивидуальный)
      • Key – _Login
      • Value – логин
      • Key – _Password
      • Value – пароль
      • Key – _UserID
      • Value – ID пользователя
    • licenseDateExpiry – дата окончания лицензии
  • Возвращаемый результат:
    • Errors – описание ошибки
    • Warnings – предупреждение
    • States – статус
    • IsValid – результат проверки подключения (true/false)
развернутьПример


Подтверждения оплаты полиса в ЕВРОИНС

Для подтверждения оплаты метод будет обращаться к внешним службам для подтверждения платежа.
Страховая компания ЕВРОИНС

  • Формат запроса:
    • POST .../TourSearchOwin/EuroinsConfirmPay
  • Принимаемые параметры headers ( * – обязательный):
    • Content-Type * – application/json
  • Принимаемые параметры POST запроса ( * – обязательный):
    • policyId * – ID полиса
    • code * – код партнера
  • Возвращаемый результат:
    • success: true – подтверждено (код 200)
    • error – описание ошибки (код 400)
развернутьПример


Приложения

Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)

Параметры ServiceType – это ключ типа услуги, Сode – ключ услуги, SubCode1 и SubCode2, возвращаемые при API-запросах – это параметры дополнительных описаний двух типов, индивидуальных для каждой услуги.

Ключ типа услуги (ServiceType) Наименование типа услуги Ключ услуги (Code) Доп. описание 1 (SubCode1) Таблица БД со значениями SubCode1 Доп. описание 2 (SubCode2) Таблица БД со значениями SubCode2
1 Авиаперелет индивидуальный ключ услуги Тариф AirService отсутствует отсутствует
2 Трансфер индивидуальный ключ услуги Вид транспорта Transport отсутствует отсутствует
3 Отель/Круиз индивидуальный ключ услуги Вид проживания (Тип номера + Категория номера + Тип размещения) HotelRooms (Rooms + RoomCategory + Accmdmentype) Тип питания Pansion
4 Экскурсия индивидуальный ключ услуги Вид транспорта Transport отсутствует отсутствует
5 Виза индивидуальный ключ услуги отсутствует отсутствует отсутствует отсутствует
6 Страховка индивидуальный ключ услуги Доп. описание 1 AddDescript1 Доп. описание 2 AddDescript2
8 Доп услуга в отеле/круизе индивидуальный ключ услуги Вид проживания (Тип номера + Категория номера + Тип размещения) HotelRooms (Rooms + RoomCategory + Accmdmentype) Доп. описание 2 AddDescript2
14 Автобусный переезд индивидуальный ключ услуги Место посадки BusTransferPoints Вид транспорта Transport
99 Любая пользовательская услуга индивидуальный ключ услуги Доп. описание 1 AddDescript1 Доп. описание 2 AddDescript2