@@ Строка 12: / Строка 12: @@
 Для работы с web-сервисом необходимо на отдающей стороне установить [[Мастер-Тур(15):Установка#Установка службы поиска|службу поиска]].<br />
 После установки web-сервис будет доступен по адресу ''<nowiki>http://значение настройки "serviceAddress" в TourSearchOwin/"название метода"</nowiki>'' (пример: ''http://localhost:9000/TourSearchOwin/Settings'')
+==Swagger==
+Работу методов можно проверить с помощью Swagger по пути: ''http://localhost:9000/TourSearchOwin/SwaggerUI''
 ==Список методов==
@@ Строка 17: / Строка 20: @@
 Последовательность вызова методов сервиса<br />
 [[Файл:mb_273.png|1000px|Последовательность вызова методов сервиса]]
+===Информация о состоянии службы поиска (statusCache)===
+Метод выводит информацию о состоянии службы поиска при ее загрузке.
+* Формат запроса:
+** GET .../TourSearchOwin/statusCache?
+* Принимаемые параметры:
+** нет принимаемых параметров
+* Возвращаемый результат:
+** '''Initialized''' – информация о том, загружена ли служба или нет ('''false''' – инициализация кешей не завершена, '''true''' – инициализация кешей завершена)
+** '''Status''' – состояние службы. Возможные значения: ''Запущена инициализация кэшей'', ''Инициализация кэшей завершена''
+** '''CacheName''' – информация о том, какой именно кеш сейчас считается (название)
+** '''Iteration''' – порядковый номер считаемого справочника кеша
+** '''CacheCount''' – общее количество кешей
+** '''ProcessMessage''' – детализация. Информацию можно разделить на 3 блока:
+*** Загрузка всех справочных данных, кроме расчета маршрутов и актуальных фильтров. В этом случае сообщение будет ''Загрузка кэшей из БД''
+*** Расчет маршрутов. ''CacheName'' – ''HotelScheme'', сообщение будет ''tours load: 956 / 1234''
+*** Расчет актуальных фильтров. ''CacheName'' – ''ActualFilters'', сообщение будет ''Actual filter processed: 783012 / 3865687"''
+<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+<div class="mw-collapsible-content">
+<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+Вызов метода Settings
+<syntaxhighlight lang="java" enclose="div">
+GET http://localhost:9000/TourSearchOwin/statusCache
+</syntaxhighlight>
+Возвращаемый результат метода statusCache (в формате JSON)
+<syntaxhighlight lang="java" enclose="div">
+{
+    "Initialized": false,
+    "Status": "Запущена инициализация кэшей",
+    "CacheName": "ToursSearchView",
+    "Iteration": 10,
+    "CacheCount": 112,
+    "ProcessMessage": "Загрузка кэшей из БД"
+}
+{
+    "Initialized": false,
+    "Status": "Запущена инициализация кэшей",
+    "CacheName": "HotelScheme",
+    "Iteration": 109,
+    "CacheCount": 112,
+    "ProcessMessage": "tours load: 956 / 1234"
+}
+{
+    "Initialized": false,
+    "Status": "Запущена инициализация кэшей",
+    "CacheName": "ActualFilters",
+    "Iteration": 112,
+    "CacheCount": 112,
+    "ProcessMessage": "Actual filter processed: 783012 / 3865687"
+}
+{
+    "Initialized": true,
+    "Status": "Инициализация кэшей завершена",
+    "CacheName": null,
+    "Iteration": 0,
+    "CacheCount": 0,
+    "ProcessMessage": null
+}
+</syntaxhighlight>
+</TD></TR></TABLE>
+</div></div><br />
 ===Авторизация (Token)===
@@ Строка 105: / Строка 170: @@
 *** ''<add key="enableActualFilters" value="true" />'' - CacheReady: true = CacheReadyMessage: "Кеш инициализирован"; CacheReady: false = CacheReadyMessage: "Кеш еще не инициализирован"
 *** ''<add key="enableActualFilters" value="false" />'' - Служба актуальных фильтров недоступна (выключена, неверно указана ссылка на нее и т.п.) CacheReadyMessage: "Служба актуальных фильтров недоступна"; Служба актуальных фильтров доступна но не готова - CacheReadyMessage: "Кеш службы актуальных фильтров не инициализирован"; Служба актуальных фильтров готова, а основная служба не готова - CacheReadyMessage: "Кеш ещё не инициализирован"; Служба актуальных фильтров готова, и основная служба готова - CacheReadyMessage: "Кеш ещё инициализирован".
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
+** '''FullPaymentPeriod''' – полная оплата с даты бронирования (может быть null)
+** '''FullPaymentCheckin''' – полная оплата до даты заезда (может быть null)
+** '''PrePaymentPeriod''' – предоплата с даты бронирования (может быть null)
+** '''PrePaymentCheckin''' – предоплата до даты заезда (может быть null)
+** '''PrePaymentCu"''' – значение предоплаты в y.e. (может быть null)
+** '''PrePaymentPercent''' – значение предоплаты в процентах (может быть null)
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 <div class="mw-collapsible-content">
@@ Строка 182: / Строка 253: @@
     "ShowHotelImagesInSearch": true
     "CacheReadyMessage":	"Кеш инициализирован"
+    "nodeId": 2147483647,
+    "FullPaymentPeriod": null,
+    "FullPaymentCheckin": 5,
+    "PrePaymentPeriod": null,
+    "PrePaymentCheckin": 10,
+    "PrePaymentPercent": 50.0,
+    "PrePaymentCu": null
 }
 </syntaxhighlight>
 </TD></TR></TABLE>
 </div></div><br />
 ===Выгрузка списка валют в онлайне (Currency)===
@@ Строка 257: / Строка 334: @@
 ** GET .../TourSearchOwin/CurrencyRates
 * Принимаемые параметры:
-** нет принимаемых параметров
+** '''dateFrom''' – начальная дата, от которой вывести список курсов валют, в формате DD.MM.YYYY, необязательный параметр (если не указан, берется за текущий день)
+** '''dateTo''' – конечная дата, до которой вывести список курсов валют, в формате DD.MM.YYYY, необязательный параметр (если не указан, берется за текущий день)
+** '''otherBaseCurrencyId''' – идентификатор любой валюты, эмулирующей работу национальной валюты, необязательный параметр. Если заполнен, то в результатах выдачи параметр ''baseCurrencyId'' будет заменяться на валюту из параметра ''otherBaseCurrencyId'' (обрабатывается с релиза 15.9).
 * Возвращаемый результат:
 ** '''baseCurrencyId''' – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке ''basketCurrency'' в конфигурационном файле (обрабатывается с релиза 15.6)
 ** '''currencyId''' – идентификатор валюты, курс которой приводится
 ** '''rate''' – курс валюты (отношение '''currencyId''' к '''baseCurrencyId''')
+** '''date''' – дата, на которую был зарегистрирован выводимый курс валюты
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
@@ Строка 268: / Строка 349: @@
 Вызов метода CurrencyRates
 <syntaxhighlight lang="java" enclose="div">
-http://localhost:9000/TourSearchOwin/CurrencyRates
+http://localhost:9000/TourSearchOwin/CurrencyRates?dateFrom=18.09.2024&dateTo=19.09.2024
 </syntaxhighlight>
 Возвращаемый результат метода CurrencyRates (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
-{
+[
-   "version": "1.08",
+    {
-   "currencyRates":    [
+        "BaseCurrencyId": 14,
-            {
+        "CurrencyId": 1,
-         "baseCurrencyId": 2,
+        "Rate": 91.429200,
-         "currencyId": 1,
+        "Date": "18.09.2024"
-         "rate": 65.256054
+    },
-      },
+    {
-            {
+        "BaseCurrencyId": 14,
-         "baseCurrencyId": 2,
+        "CurrencyId": 2,
-         "currencyId": 3,
+        "Rate": 101.505700,
-         "rate": 71.168955
+        "Date": "18.09.2024"
-      }
+    },
-   ]
+    {
-}
+        "BaseCurrencyId": 14,
+        "CurrencyId": 1,
+        "Rate": 91.671200,
+        "Date": "19.09.2024"
+    },
+    {
+        "BaseCurrencyId": 14,
+        "CurrencyId": 2,
+        "Rate": 102.039000,
+        "Date": "19.09.2024"
+    }
+]
 </syntaxhighlight>
@@ Строка 508: / Строка 600: @@
 ** '''Name''' – название страны
 ** '''Key''' – идентификатор страны
-** '''DestinationType''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+** '''DestinationType''' – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
 ** '''IsExist''' – не используется
 ** '''Data''' – массив данных для контекстного поиска
@@ Строка 690: / Строка 782: @@
 ** '''departureCityKeys *''' – идентификатор города(ов) отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
 ** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 ** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 ** '''terms''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
@@ Строка 696: / Строка 788: @@
 ** '''Key''' – идентификатор типа тура
 ** '''Name''' – название типа тура
-** '''ParentId''' – идентификатор группы, к которой относится данный типа тура (если тип тура не относится к группе, то возвращается ''null'')
+** '''ParentId''' – идентификатор группы, к которой относится данный тип тура (если тип тура не относится к группе, то возвращается ''null'')
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
@@ Строка 736: / Строка 828: @@
 ** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 ** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 ** '''tourTypes *''' – идентификатор типа тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
 * Возвращаемый результат:
@@ Строка 772: / Строка 864: @@
 ** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны
 ** '''Key *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
-** '''Type *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 ** '''tourDate *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
 ** '''tourTypes *''' – идентификатор типа(ов) тура (полученный из метода ''.../TourSearchOwin/ActualizeTourType?''), по умолчанию передается ''-1'', то есть все типы тура в рамках данной страны
@@ Строка 812: / Строка 904: @@
 ** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false)
 ** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
-** '''DestinationType *''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 ** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 ** '''AdultCount *''' – количество взрослых
@@ Строка 824: / Строка 916: @@
 ** '''Groups''' – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
 ** '''HotelScheme''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры:
-*** '''TemplateId''' – идентификатор шаблона услуги,
+*** '''TemplateId''' – идентификатор шаблона услуги (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Key->TemplateId),
-*** '''DurationInNight''' – продолжительность отеля в ночах,
+*** '''DurationInNight''' – продолжительность отеля в ночах (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->DurationInNight),
-*** '''Code''' – ключ отеля,
+*** '''Code''' – ключ отеля (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->Code),
-*** '''PacketKey''' – ключ пакета,
+*** '''PacketKey''' – ключ пакета (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->PacketId),
-*** '''PartnerKey''' – ключ партнера
+*** '''PartnerKey''' – ключ партнера (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->PartnerId),
-*** '''GDSProviderId''' – ключ провайдера из внешней системы
+*** '''GDSProviderId''' – ключ провайдера из внешней системы (этот параметр можно взять из контроллера Tour->Result->MinCostServicesComposition->Value->GDSProviderId),
-*** '''TotalTourDuration''' – общая продолжительность тура в днях
+*** '''TotalTourDuration''' – общая продолжительность тура в днях (этот параметр можно взять из контроллера Tour->Result->Duration)
 ** '''BusTransferPointKeys''' – данный признак проставляется в ''true'' в том случае, когда происходит запрос вариантов проживания (кнопка ''Варианты'') в автобусных переездах
 ** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
@@ Строка 865: / Строка 957: @@
 ** '''IsGroupingTourAlreadyMerge''' – определяет слияние данных турпрограмм от локальной системы с данными от внешней системы при использовании группировки. Примеры использования. ''IsGroupingTourAlreadyMerge=false'' – полученные данные от локальной системы не объединены с данными от внешней системы. На клиенте осуществляется объединение данных турпрограмм с последующей сортировкой по минимальной цене. ''IsGroupingTourAlreadyMerge=true'' – полученные данные от локальной системы уже объединены с данными от внешней системы. На клиенте осуществляется только сортировка по минимальной цене. Обрабатывается начиная с релиза 15.4.
 ** '''SearchId''' – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
@@ Строка 877: / Строка 970: @@
 *** '''TourUrl''' – ссылка на программу тура
 *** '''BookingConditions''' – условия бронирования программы туров
+*** '''DefaultManagers''' – список выбранных менеджеров в туре
+*** '''Manager''' – ключ менеджера по умолчанию в туре
+*** '''Branches''' – список ключей филиалов бронирования
+*** '''DetermineTheBranchOnCity''' – признак, определять филиал в зависимости от города начала поездки
+*** '''IndividualFlightSelection''' – признак, включены ли индивидуальные настройки подбора перелетов
+*** '''RestrictionDateArrival''' – признак, ограничение даты прилета по базовому рейсу в индивидуальных настройках подбора перелетов
+*** '''PriceUpdateForView''' – признак обновления цен в индивидуальных настройках подбора перелетов (true – включен, false – выключен)
+*** '''SelectFlightAutomatically''' – признак выбирать рейс автоматически, если не выбран пользователем в индивидуальных настройках подбора перелетов
+*** '''BaggageSearchOtherFares''' – признак поиска багажа в других тарифах в индивидуальных настройках подбора перелетов
+*** '''Luggage''' – значение багажа в блоке настроек, влияющих на формирование запроса в индивидуальных настройках подбора перелетов (all – все, withLuggage – багаж и ручная кладь, withoutLuggage – без багажа)
+*** '''LuggageForView''' – значение багажа в блоке настроек, влияющих на отображение информации в индивидуальных настройках подбора перелетов (all – все, withLuggage – багаж и ручная кладь, withoutLuggage – без багажа)
+*** '''LuggageForPrice''' – значение багажа в блоке фильтров для обновления цен в индивидуальных настройках подбора перелетов (all – все, withLuggage – багаж и ручная кладь, withoutLuggage – без багажа)
+*** '''FlightClass''' – класс перелета в индивидуальных настройках подбора перелетов (economy – Эконом, premiumEconomy 2 Премиум-эконом, business – Бизнес, first – Первый)
+*** '''Directs''' – значение пересадок в блоке настроек, влияющих на формирование запроса в индивидуальных настройках подбора перелетов (all – все, onlyDirectFlights – только прямые рейсы)
+*** '''DirectsForView''' – значение пересадок в блоке влияющих на отображение информации в индивидуальных настройках подбора перелетов (all – все, без пересадок – withoutDirect, с 1 пересадкой – oneDirect, с 2 пересадками и более – twoOrMoreDirect)
+*** '''DirectsForPrice''' – значение пересадок в блоке фильтров для обновления цен в индивидуальных настройках подбора перелетов (all – все, без пересадок – withoutDirect, с 1 пересадкой – oneDirect, с 2 пересадками и более – twoOrMoreDirect)
+*** '''DepartureTimeLimit''' – ограничение времени вылета: «Вылет не позже» в формате hh:mm
+*** '''SortingForView''' – сортировка в индивидуальных настройках подбора перелетов (cheap – сначала дешевые, fast – сначала быстрые, optimal – оптимальные)
 *** '''StartDate''' – дата начала тура
+*** '''MaxConnectionTime''' – длительность пересадок в индивидуальных настройках подбора перелетов в формате hh:mm
+*** '''FullPaymentPeriod''' – полная оплата с даты бронирования (может быть null)
+*** '''FullPaymentCheckin''' – полная оплата до даты заезда (может быть null)
+*** '''PrePaymentPeriod''' – предоплата с даты бронирования (может быть null)
+*** '''PrePaymentCheckin''' – предоплата до даты заезда (может быть null)
+*** '''PrePaymentCu"''' – значение предоплаты в y.e. (может быть null)
+*** '''PrePaymentPercent''' – значение предоплаты в процентах (может быть null)
 *** '''Duration''' – продолжительность тура (в днях)
 *** '''DurationInNight''' – продолжительность проживания (в ночах)
 *** '''Types''' – идентификатор типа туров
-*** '''Cost''' – цена тура
+*** '''Price''' –  цена тура с учетом скидки в валюте поиска
+*** '''Cost''' – цена тура в валюте поиска
 *** '''Rate''' – код валюты тура
+*** '''Penalties''' – внутреннее поле, не используется
 *** '''CityDepature''' – город отправления
 **** '''Key''' – идентификатор города отправления
@@ Строка 956: / Строка 1076: @@
 ***** '''Key''' – ключ города
 ***** '''Value''' – название города
-**** '''Country''' – ключ страны
+**** '''Country''' – объект страна
+***** '''Key''' – ключ страны
+***** '''Value''' – название страны
 **** '''Code''' – объект код услуги
 ***** '''Key''' – ключ услуги
@@ Строка 1062: / Строка 1184: @@
 ***** '''enabled''' – флаг включен/выключен
 *** '''RouteSubVariants''' – подварианты услуг (используется в основном поиске)
+*** '''Routes''' – количество маршрутов для данного варианта поиска (к примеру, если будет несколько вариантов
+*** '''IsRemoteHotels''' – признак, есть ли внешние отели в данном варианте
+*** '''IsTourImages''' – признак, есть ли картинки тура
+*** '''MaskKeys''' – маска фильтра категории номеров
 ** '''SecondaryFiltersResult''' – результаты доп. фильтров
 *** '''TourTypes''' – типы тура
@@ Строка 1139: / Строка 1265: @@
 **** '''HotelTypes''' – признаки отелей в дополнительных фильтрах
 ***** '''''' –
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
@@ Строка 1166: / Строка 1293: @@
           "TourUrl": "www.megatec.ru",
           "BookingConditions": "<p>Условия бронирования тура.<\/p>",
+         "DefaultManagers": [],
+         "Manager": 169,
+         "Branches": [],
+         "DetermineTheBranchOnCity": false,
+         "IndividualFlightSelection": true,
+         "RestrictionDateArrival": false,
+         "PriceUpdateForView": false,
+         "SelectFlightAutomatically": false,
+         "BaggageSearchOtherFares": false,
+         "Luggage": "withoutLuggage",
+         "LuggageForView": "all",
+         "LuggageForPrice": "all",
+         "FlightClass": "economy",
+         "Directs": "all",
+         "DirectsForView": "all",
+         "DirectsForPrice": "all",
+         "DepartureTimeLimit": "",
+         "SortingForView": "cheap",
           "StartDate": "2018-02-25T00:00:00",
+         "MaxConnectionTime": 0
+         "FullPaymentPeriod": 5,
+         "FullPaymentCheckin": null,
+         "PrePaymentPeriod": null,
+         "PrePaymentCheckin": 5,
+         "PrePaymentCu": null,
+         "PrePaymentPercent": 10.0,
           "Duration": 4,
           "DurationInNight": 3,
           "Types": [2],
+         "Price": 260,
           "Cost": 260,
+         "Penalties": null,
           "Rate": "EU",
           "CityDepature":          {
@@ Строка 1301: / Строка 1455: @@
                       "Value": "Завтрак"
                    },
+                  "AbsolutePenalties": null,
                    "Cost": 19.47,
                    "QuotaStatus":                   {
@@ Строка 1417: / Строка 1572: @@
                 "ServiceName": "страховка",
                 "City": null,
-                "Country": 6245,
+                "Country":                {
+                  "Key": 90,
+                  "Value": "Австрия"
+               },
                 "Code":                {
                    "Key": 297,
@@ Строка 1470: / Строка 1628: @@
                    "Value": "Санто-Доминго"
                 },
-                "Country": 6245,
+                "Country":                {
+                  "Key": 90,
+                  "Value": "Австрия"
+               },
                 "Code":                {
                    "Key": 743,
@@ Строка 1605: / Строка 1766: @@
              }
           },
-          "RouteSubVariants": []
+          "RouteSubVariants": [],
+         "Routes": 1,
+         "IsRemoteHotels": false,
+         "IsTourImages": false,
+         "MaskKeys": null
        }
     ],
@@ Строка 2122: / Строка 2287: @@
 </TD></TR></TABLE>
 </div></div><br />
+* Детализация параметра serviceDescriptions из url:
+** '''TemplateId''' – идентификатор шаблона услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Key->TemplateId)
+** '''PatternId''' – идентификатор паттерна услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Key->PatternId)
+** '''SettingId''' – идентификатор услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Key->SettingId)
+** '''ServiceType''' – тип услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->ServiceType)
+** '''Code''' – код услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->Code)
+** '''SubCode1''' – доп. описание 1 услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->SubCode1)
+** '''SubCode2''' – доп. описание 2 услуги (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->SubCode2)
+** '''CountryId''' – ключ страны (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->CountryId)
+** '''CityId''' – ключ города (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->CityId)
+** '''PacketId''' – ключ пакета (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->PacketId)
+** '''PartnerId''' – ключ партнера (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->PartnerId)
+** '''Day''' – день предоставления (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->Day)
+** '''DurationInNight''' – продолжительность в ночах (этот параметр можно взять из контроллера Tour->Result->RouteSubVariants->CostServicesComposition->Value->DurationInNight)
+Пример: serviceDescriptions=1_0_0_3_107274_1400134_1526_460_1_1830_14752_1_8
 ===Выгрузка транспортного плана (TransportPlan) до релиза 15.7 включительно===
@@ Строка 2559: / Строка 2741: @@
 * Принимаемые параметры ( '''*''' – обязательный):
 ** '''DepartureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
-** '''DestinationType *''' – тип результата (параметр не изменяемый, когда результат возвращается в JSON, то значение будет = 1, когда результат возвращается в xml, то значение будет = country). Зависит от программы, которая возвращает результат.
+** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 ** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 ** '''Dates *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
@@ Строка 2569: / Строка 2751: @@
 ** '''AviaQuota *''' – информация о квотах на авиаперелет (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
 ** '''BusTransferQuota''' – информация о квотах на автобусный переезд (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все")
-** '''HotelScheme *''' – объект схемы отеля
+** '''HotelScheme *''' – объект схемы отеля (при работе с авиабукингом передается конструкция такого вида ''HotelScheme=[{"TemplateId":"}]'')
 *** '''TemplateId''' – идентификатор шаблона услуги
 *** '''DurationInNight''' – продолжительность отеля в ночах
@@ Строка 2581: / Строка 2763: @@
 ** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false).
 ** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
-** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
+** '''TourKey''' – ключ программы тура
-** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
+** '''TourDuration''' – продолжительность тура в днях
 ** '''RemoteHotelMode''' – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 * Возвращаемый результат:
@@ Строка 2595: / Строка 2778: @@
 *** '''TourUrl''' – ссылка на программу тура
 *** '''BookingConditions''' – условия бронирования программы туров
+*** '''DefaultManagers''' – список выбранных менеджеров в туре
+*** '''Manager''' – ключ менеджера по умолчанию в туре
+*** '''Branches''' – список ключей филиалов бронирования
+*** '''DetermineTheBranchOnCity''' – признак, определять филиал в зависимости от города начала поездки
+*** '''IndividualFlightSelection''' – признак, включены ли индивидуальные настройки подбора перелетов
+*** '''RestrictionDateArrival''' – признак, ограничение даты прилета по базовому рейсу в индивидуальных настройках подбора перелетов
+*** '''PriceUpdateForView''' – признак обновления цен в индивидуальных настройках подбора перелетов (true – включен, false – выключен)
+*** '''SelectFlightAutomatically''' – признак выбирать рейс автоматически, если не выбран пользователем в индивидуальных настройках подбора перелетов
+*** '''BaggageSearchOtherFares''' – признак поиска багажа в других тарифах в индивидуальных настройках подбора перелетов
+*** '''Luggage''' – значение багажа в блоке настроек, влияющих на формирование запроса в индивидуальных настройках подбора перелетов (all – все, withLuggage – багаж и ручная кладь, withoutLuggage – без багажа)
+*** '''LuggageForView''' – значение багажа в блоке настроек, влияющих на отображение информации в индивидуальных настройках подбора перелетов (all – все, withLuggage – багаж и ручная кладь, withoutLuggage – без багажа)
+*** '''LuggageForPrice''' – значение багажа в блоке фильтров для обновления цен в индивидуальных настройках подбора перелетов (all – все, withLuggage – багаж и ручная кладь, withoutLuggage – без багажа)
+*** '''FlightClass''' – класс перелета в индивидуальных настройках подбора перелетов (economy – Эконом, premiumEconomy 2 Премиум-эконом, business – Бизнес, first – Первый)
+*** '''Directs''' – значение пересадок в блоке настроек, влияющих на формирование запроса в индивидуальных настройках подбора перелетов (all – все, onlyDirectFlights – только прямые рейсы)
+*** '''DirectsForView''' – значение пересадок в блоке влияющих на отображение информации в индивидуальных настройках подбора перелетов (all – все, без пересадок – withoutDirect, с 1 пересадкой – oneDirect, с 2 пересадками и более – twoOrMoreDirect)
+*** '''DirectsForPrice''' – значение пересадок в блоке фильтров для обновления цен в индивидуальных настройках подбора перелетов (all – все, без пересадок – withoutDirect, с 1 пересадкой – oneDirect, с 2 пересадками и более – twoOrMoreDirect)
+*** '''DepartureTimeLimit''' – ограничение времени вылета: «Вылет не позже» в формате hh:mm
+*** '''SortingForView''' – сортировка в индивидуальных настройках подбора перелетов (cheap – сначала дешевые, fast – сначала быстрые, optimal – оптимальные)
+*** '''StartDate''' – дата начала тура
+*** '''MaxConnectionTime''' – длительность пересадок в индивидуальных настройках подбора перелетов в формате hh:mm
+*** '''FullPaymentPeriod''' – полная оплата с даты бронирования (может быть null)
+*** '''FullPaymentCheckin''' – полная оплата до даты заезда (может быть null)
+*** '''PrePaymentPeriod''' – предоплата с даты бронирования (может быть null)
+*** '''PrePaymentCheckin''' – предоплата до даты заезда (может быть null)
+*** '''PrePaymentCu"''' – значение предоплаты в y.e. (может быть null)
+*** '''PrePaymentPercent''' – значение предоплаты в процентах (может быть null)
+*** '''Duration''' – продолжительность тура (в днях)
+*** '''DurationInNight''' – продолжительность проживания (в ночах)
+*** '''Types''' – идентификатор типа туров
+*** '''Price''' –  цена тура с учетом скидки в валюте поиска
+*** '''Cost''' – цена тура в валюте поиска
+*** '''Rate''' – код валюты тура
+*** '''Penalties''' – внутреннее поле, не используется
 *** '''StartDate''' – дата начала тура
 *** '''Duration''' – продолжительность тура (в днях)
@@ Строка 2674: / Строка 2890: @@
 ***** '''Key''' – ключ города
 ***** '''Value''' – название города
-**** '''Country''' – ключ страны
+**** '''Country''' – объект страна
+***** '''Key''' – ключ страны
+***** '''Value''' – название страны
 **** '''Code''' – объект код услуги
 ***** '''Key''' – ключ услуги
@@ Строка 2781: / Строка 2999: @@
 *** '''RouteSubVariants''' – подварианты услуг (используется в основном поиске)
 ** '''SecondaryFiltersResult''' – доп. фильтры (не используется при вызове из корзины)
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
@@ Строка 2808: / Строка 3027: @@
           "TourUrl": "www.megatec.ru",
           "BookingConditions": "Условия бронирования тура",
-          "StartDate": "2018-03-31T00:00:00",
+         "DefaultManagers": [],
-          "Duration": 8,
+         "Manager": 169,
-          "DurationInNight": 7,
+         "Branches": [],
-          "Types": [2],
+         "DetermineTheBranchOnCity": false,
-          "Cost": 122,
+         "IndividualFlightSelection": true,
+         "RestrictionDateArrival": false,
+         "PriceUpdateForView": false,
+         "SelectFlightAutomatically": false,
+         "BaggageSearchOtherFares": false,
+         "Luggage": "withoutLuggage",
+         "LuggageForView": "all",
+         "LuggageForPrice": "all",
+         "FlightClass": "economy",
+         "Directs": "all",
+         "DirectsForView": "all",
+         "DirectsForPrice": "all",
+         "DepartureTimeLimit": "",
+         "SortingForView": "cheap",
+          "StartDate": "2018-02-25T00:00:00",
+         "MaxConnectionTime": 0
+         "FullPaymentPeriod": 5,
+         "FullPaymentCheckin": null,
+         "PrePaymentPeriod": null,
+         "PrePaymentCheckin": 5,
+         "PrePaymentCu": null,
+         "PrePaymentPercent": 10.0,
+          "Duration": 4,
+          "DurationInNight": 3,
+          "Types": [2],
+         "Price": 260,
+          "Cost": 260,
+         "Penalties": null,
           "Rate": "EU",
           "CityDepature":          {
@@ Строка 3244: / Строка 3490: @@
 * Принимаемые параметры ( '''*''' – обязательный):
 ** '''countryId *''' – ключ страны, для которой будут выгружаться настройки
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 * Возвращаемый результат:
 ** '''TouristFieldsSettings''' – массив полей с информацией о туристах (из админки Мастер-Web)
@@ Строка 3283: / Строка 3531: @@
 ** '''ChildAgeSetting''' – максимальный возраст ребенка, когда он считается ребенком (лет)
 ** '''InfantAgeSetting''' – максимальный возраст младенца (месяцев)
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
@@ Строка 3574: / Строка 3823: @@
 Метод производит выгрузку услуг доплат к авиаперелетам.
 * Формат запроса:
-** POST .../TourSearchOwin/GetFlightsAdditionalServices?
+** POST .../TourSearchOwin/GetFlightsAdditionalServices?nodeId=2147483647
+, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 * Принимаемые параметры headers ( '''*''' – обязательный):
@@ Строка 3650: / Строка 3900: @@
 *** '''ServiceName''' – название услуги
 *** '''City''' – объект город
-*** '''Country''' – ключ страны
+*** '''Country''' – объект страна
+**** '''Key''' – ключ страны
+**** '''Value''' – название страны
 *** '''Code''' – объект код услуги
 **** '''Key''' – ключ услуги
@@ Строка 3699: / Строка 3951: @@
 Вызов метода GetHotelsAdditionalServices
 <syntaxhighlight lang="java" enclose="div">
-POST http://localhost:9000/TourSearchOwin/GetHotelsAdditionalServices? HTTP/1.1
+POST http://localhost:9000/TourSearchOwin/GetFlightsAdditionalServices?nodeId=2147483647 HTTP/1.1
 Content-Type: application/json
 {
@@ Строка 3840: / Строка 4092: @@
 }
 </syntaxhighlight>
-Возвращаемый результат метода GetHotelsAdditionalServices (в формате JSON)
+Возвращаемый результат метода GetFlightsAdditionalServices (в формате JSON)
 <syntaxhighlight lang="java" enclose="div">
 [{
 	"ServiceName": "Доплаты к авиаперелетам",
 	"City": null,
-	"Country": 90,
+        "Country":                {
+                  "Key": 90,
+                  "Value": "Австрия"
+				},
 	"Code": {
 		"Key": 357,
@@ Строка 3902: / Строка 4157: @@
 Метод производит выгрузку услуг доплат к отелям.
 * Формат запроса:
-** POST .../TourSearchOwin/GetHotelsAdditionalServices?
+** POST .../TourSearchOwin/GetHotelsAdditionalServices?nodeId=2147483647
+, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 * Принимаемые параметры headers ( '''*''' – обязательный):
@@ Строка 4050: / Строка 4306: @@
 Вызов метода GetHotelsAdditionalServices
 <syntaxhighlight lang="java" enclose="div">
-POST http://localhost:9000/TourSearchOwin/GetHotelsAdditionalServices? HTTP/1.1
+POST http://localhost:9000/TourSearchOwin/GetHotelsAdditionalServices?nodeId=2147483647 HTTP/1.1
 Content-Type: application/json
@@ Строка 4186: / Строка 4442: @@
 		"ServiceName": "Доплаты к отелям",
 		"City": null,
-		"Country": 90,
+                "Country":                {
+                  "Key": 90,
+                  "Value": "Австрия"
+				},
 		"Code": {
 			"Key": 364,
@@ Строка 4244: / Строка 4503: @@
 Метод производит расчет услуг с индивидуальным выбором у туристов.
 * Формат запроса:
-** POST .../TourSearchOwin/CalculateIndividualServiceCosts?
+** POST .../TourSearchOwin/CalculateIndividualServiceCosts?nodeId=2147483647
+, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 * Принимаемые параметры headers ( '''*''' – обязательный):
@@ Строка 4306: / Строка 4566: @@
 **** '''Brutto''' – брутто
 **** '''Discount''' – скидка
+** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
@@ Строка 4312: / Строка 4573: @@
 Вызов метода CalculateIndividualServiceCosts
 <syntaxhighlight lang="java" enclose="div">
-POST http://localhost:9000/TourSearchOwin/CalculateIndividualServiceCosts? HTTP/1.1
+POST http://localhost:9000/TourSearchOwin/CalculateIndividualServiceCosts?nodeId=2147483647 HTTP/1.1
 Content-Type: application/json
@@ Строка 6265: / Строка 6526: @@
 Метод производит расчет стоимости путевки.
 * Формат запроса:
-** POST .../TourSearchOwin/CalculateReservation?
+** POST .../TourSearchOwin/CalculateReservation?nodeId=2147483647
+, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 * Принимаемые параметры headers ( '''*''' – обязательный):
@@ Строка 6271: / Строка 6533: @@
 * Принимаемые параметры POST запроса:
-** '''TourProgramId''' – ключ турпрограммы
+** '''TourProgramId *''' – ключ турпрограммы
-** '''BeginDate''' – дата начала тура
+** '''BeginDate *''' – дата начала тура
-** '''Duration''' – продолжительность тура
+** '''Duration *''' – продолжительность тура
-** '''Currency''' – код валюты
+** '''Currency *''' – код валюты
-** '''initialPrice''' – объект изначальная цена
+** '''initialPrice *''' – объект изначальная цена
-*** '''price''' – цена
+*** '''price *''' – цена
-*** '''currency''' – код валюты
+*** '''currency *''' – код валюты
-** '''Services''' – массив услуг
+** '''Services *''' – массив услуг
-*** '''Service''' – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
+*** '''Service *''' – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
-**** '''ServiceType''' – тип услуги (поле ''sv_key'' из таблицы ''service'')
+**** '''ServiceType *''' – тип услуги (поле ''sv_key'' из таблицы ''service'')
-**** '''Code''' – код услуги
+**** '''Code *''' – код услуги
-**** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
+**** '''SubCode1 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
-**** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
+**** '''SubCode2 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
-**** '''Packet''' – ключ пакета услуги
+**** '''Packet *''' – ключ пакета услуги
-**** '''Partner''' – ключ партнера услуги
+**** '''Partner *''' – ключ партнера услуги
-**** '''Day''' – день предоставления услуги
+**** '''Day *''' – день предоставления услуги
-**** '''DurationInNight''' – продолжительность услуги в ночах
+**** '''DurationInNight *''' – продолжительность услуги в ночах
-**** '''City''' – ключ города
+**** '''City *''' – ключ города
-**** '''Country''' – страна услуги
+**** '''Country *''' – страна услуги
-**** '''Attributes''' – битовая маска атрибутов услуг (Значение по умолчанию 0. Дальше в зависимости от признака услуги, может принимать значениz:
+**** '''Attributes *''' – битовая маска атрибутов услуг (Значение по умолчанию 0. Дальше в зависимости от признака услуги, может принимать значениz:
 None              = 0,если услуга удаляемая, эта настройка находится в программе туров,</br>
 Delete            = 1,</br>
@@ Строка 6317: / Строка 6579: @@
 SubCode2Edit      = 65536,</br>
 GDSService        = 131072, от внешней системы)</br>
-**** '''IsRemovable''' – (не обрабатывается)
+**** ''' *IsRemovable''' – (не обрабатывается)
-**** '''Type''' – тип услуги в путевке. Может принимать значения:
+**** ''' *Type''' – тип услуги в путевке. Может принимать значения:
-None – не установлено,</br>
+None (0) – не установлено,</br>
-Base – базовая услуга. Основные услуги в корзине, проживание, перелет.</br>
+Base (1) – базовая услуга. Основные услуги в корзине, проживание, перелет.</br>
-Optional – Дополнительная услуга,</br>
+Optional (2) – Дополнительная услуга,</br>
-NYDinner – Новогодний ужин,</br>
+NYDinner (4) – Новогодний ужин,</br>
-FlightAdditionalPayment – Доплата на перелет,</br>
+FlightAdditionalPayment (8) – Доплата на перелет,</br>
-TourWebDifference – Разница в СПО,</br>
+TourWebDifference (16) – Разница в СПО,</br>
-AddedByCalculator – Добавленная при рассчете путевки,</br>
+AddedByCalculator (32) – Добавленная при рассчете путевки,</br>
-AddedByReservationBuilder – добавленная услуга при формировании состава путевки,</br>
+AddedByReservationBuilder (64) – добавленная услуга при формировании состава путевки,</br>
-BaseChanged – базовая измененная услуга,</br>
+BaseChanged (128) – базовая измененная услуга,</br>
-HotelAdditionalPayment – доплата на отель</br>
+HotelAdditionalPayment (256) – доплата на отель</br>
-**** '''IsHooded''' – признак скрытая услуга
+**** '''IsHooded *''' – признак скрытая услуга
-**** '''IsNotCalculated''' – признак не рассчитываемая услуга
+**** '''IsNotCalculated *''' – признак не рассчитываемая услуга
-**** '''BeginDateTimeString''' – дата и время начала услуги
+**** '''BeginDateTimeString *''' – дата и время начала услуги
-**** '''EndDateTimeString''' – дата и время окончания услуги
+**** '''EndDateTimeString *''' – дата и время окончания услуги
-**** '''TemplateId''' – gорядок расположения шаблона услуги в внутри самой услуги в программе тура
+**** '''TemplateId *''' – порядок расположения шаблона услуги в внутри самой услуги в программе тура
 [[Файл: Ea_491.png|600px|индекс шаблона услуги]]</br>
-**** '''Cost''' – цена услуги
+**** '''Cost *''' – цена услуги
-**** '''ByPax''' – цена за человека
+**** '''ByPax *''' – цена за человека
-**** '''QuotaStatus''' – объект статус квотирования
+**** '''QuotaStatus *''' – объ�

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