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

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(→‎Выгрузка списка всех городов (Cities))
(→‎Установка)
 
(не показано 165 промежуточных версий 8 участников)
Строка 12: Строка 12:
 
Для работы с web-сервисом необходимо на отдающей стороне установить [[Мастер-Тур(15):Установка#Установка службы поиска|службу поиска]].<br />
 
Для работы с web-сервисом необходимо на отдающей стороне установить [[Мастер-Тур(15):Установка#Установка службы поиска|службу поиска]].<br />
 
После установки web-сервис будет доступен по адресу ''<nowiki>http://значение настройки "serviceAddress" в TourSearchOwin/"название метода"</nowiki>'' (пример: ''http://localhost:9000/TourSearchOwin/Settings'')
 
После установки web-сервис будет доступен по адресу ''<nowiki>http://значение настройки "serviceAddress" в TourSearchOwin/"название метода"</nowiki>'' (пример: ''http://localhost:9000/TourSearchOwin/Settings'')
 +
 +
==Swagger==
 +
Работу методов можно проверить с помощью Swagger по пути: ''http://localhost:9000/TourSearchOwin/SwaggerUI''
  
 
==Список методов==
 
==Список методов==
Строка 17: Строка 20:
 
Последовательность вызова методов сервиса<br />
 
Последовательность вызова методов сервиса<br />
 
[[Файл:mb_273.png|1000px|Последовательность вызова методов сервиса]]
 
[[Файл: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)===
 
===Авторизация (Token)===
Строка 75: Строка 140:
 
** нет принимаемых параметров
 
** нет принимаемых параметров
 
* Возвращаемый результат:
 
* Возвращаемый результат:
−
** '''ChildAgesSetting''' – регулируется настройкой [[Мастер-Тур(15):Программа туров. Панель администрирования#Общие настройки|максимальный возраст ребенка]] (массив возрастов, при которых турист будет считаться ребенком
+
** '''ChildAgesSetting''' – регулируется настройкой [[Мастер-Тур(15):Программа туров. Настройки|максимальный возраст ребенка]] (массив возрастов, при которых турист будет считаться ребенком
−
** '''DurationSetting''' – регулируется настройкой [[Мастер-Тур(15):Программа туров. Панель администрирования#Общие настройки|максимальная продолжительность тура]] (массив продолжительностей, доступных в фильтрах для поиска)
+
** '''DurationSetting''' – регулируется настройкой [[Мастер-Тур(15):Программа туров. Настройки|максимальная продолжительность тура]] (массив продолжительностей, доступных в фильтрах для поиска)
 
** '''RoundServiceSetting''' – признак округления цены (количество знаков после запятой)
 
** '''RoundServiceSetting''' – признак округления цены (количество знаков после запятой)
 
** '''CacheReady''' – статус готовности службы поиска к работе (true/false)
 
** '''CacheReady''' – статус готовности службы поиска к работе (true/false)
Строка 105: Строка 170:
 
*** ''<add key="enableActualFilters" value="true" />'' - CacheReady: true = CacheReadyMessage: "Кеш инициализирован"; CacheReady: false = CacheReadyMessage: "Кеш еще не инициализирован"
 
*** ''<add key="enableActualFilters" value="true" />'' - CacheReady: true = CacheReadyMessage: "Кеш инициализирован"; CacheReady: false = CacheReadyMessage: "Кеш еще не инициализирован"
 
*** ''<add key="enableActualFilters" value="false" />'' - Служба актуальных фильтров недоступна (выключена, неверно указана ссылка на нее и т.п.) CacheReadyMessage: "Служба актуальных фильтров недоступна"; Служба актуальных фильтров доступна но не готова - CacheReadyMessage: "Кеш службы актуальных фильтров не инициализирован"; Служба актуальных фильтров готова, а основная служба не готова - CacheReadyMessage: "Кеш ещё не инициализирован"; Служба актуальных фильтров готова, и основная служба готова - 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="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
Строка 182: Строка 253:
 
   "ShowHotelImagesInSearch": true
 
   "ShowHotelImagesInSearch": true
 
   "CacheReadyMessage": "Кеш инициализирован"
 
   "CacheReadyMessage": "Кеш инициализирован"
 +
    "nodeId": 2147483647,
 +
    "FullPaymentPeriod": null,
 +
    "FullPaymentCheckin": 5,
 +
    "PrePaymentPeriod": null,
 +
    "PrePaymentCheckin": 10,
 +
    "PrePaymentPercent": 50.0,
 +
    "PrePaymentCu": null
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 187: Строка 265:
 
</div></div><br />
 
</div></div><br />
  
−
===Выгрузка списка всех валют (getAllCurrencies)===
+
===Выгрузка списка валют в онлайне (Currency)===
−
Метод возвращает список всех валют.
+
Метод возвращает список используемых валют.
 
* Формат запроса:
 
* Формат запроса:
−
** GET .../TourSearchOwin/AllCurencies/getAllCurrencies
+
** GET .../TourSearchOwin/Currency
 
* Принимаемые параметры:
 
* Принимаемые параметры:
 
** нет принимаемых параметров
 
** нет принимаемых параметров
Строка 207: Строка 285:
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
Вызов метода getAllCurrencies
+
Вызов метода Currency
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
−
GET http://localhost:9000/TourSearchOwin/AllCurencies/getAllCurrencies
+
GET http://localhost:9000/TourSearchOwin/Currency
 
</syntaxhighlight>
 
</syntaxhighlight>
−
Возвращаемый результат метода getAllCurrencies (в формате JSON)
+
Возвращаемый результат метода Currency (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
[
 
[
Строка 243: Строка 321:
 
       "Symbol": "$",
 
       "Symbol": "$",
 
       "Key": 1
 
       "Key": 1
−
  },
 
−
  {
 
−
      "Code": "гр",
 
−
      "Name": "Гривна",
 
−
      "IsMain": false,
 
−
      "IsNational": false,
 
−
      "IsoCode": "UAH",
 
−
      "IsShowInSearch": true,
 
−
      "Symbol": "₴",
 
−
      "Key": 6
 
 
   }
 
   }
 
]
 
]
Строка 260: Строка 328:
  
  
−
===Выгрузка списка валют в онлайне (Currency)===
+
===Выгрузка курсов валют (CurrencyRates) начиная с 15.7===
−
Метод возвращает список используемых валют.
+
Полный аналог метода [[Мастер-Тур(15):API для отдачи цен в поисковые системы#Выгрузка курсов валют (GetCurrencyRates)|Выгрузка курсов валют (GetCurrencyRates)]]<br />
 +
Метод возвращает список курсов валют, актуальных на дату запроса. Курсы отображаются только для тех валют, которые отмечены в справочнике признаком ''Отображать в онлайне''
 
* Формат запроса:
 
* Формат запроса:
−
** GET .../TourSearchOwin/Currency
+
** GET .../TourSearchOwin/CurrencyRates
 
* Принимаемые параметры:
 
* Принимаемые параметры:
−
** нет принимаемых параметров
+
** '''dateFrom''' – начальная дата, от которой вывести список курсов валют, в формате DD.MM.YYYY, необязательный параметр (если не указан, берется за текущий день)
 +
** '''dateTo''' – конечная дата, до которой вывести список курсов валют, в формате DD.MM.YYYY, необязательный параметр (если не указан, берется за текущий день)
 +
** '''otherBaseCurrencyId''' – идентификатор любой валюты, эмулирующей работу национальной валюты, необязательный параметр. Если заполнен, то в результатах выдачи параметр ''baseCurrencyId'' будет заменяться на валюту из параметра ''otherBaseCurrencyId'' (обрабатывается с релиза 15.9).
 +
 
 
* Возвращаемый результат:
 
* Возвращаемый результат:
−
** '''Code''' – код валюты
+
** '''baseCurrencyId''' – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке ''basketCurrency'' в конфигурационном файле (обрабатывается с релиза 15.6)
−
** '''Name''' – наименование валюты
+
** '''currencyId''' – идентификатор валюты, курс которой приводится
−
** '''IsMain''' – признак валюты «Главная»
+
** '''rate''' – курс валюты (отношение '''currencyId''' к '''baseCurrencyId''')
−
** '''IsNational''' – признак валюты «Национальная»
+
** '''date''' – дата, на которую был зарегистрирован выводимый курс валюты
−
** '''IsoCode''' – ISO код валюты
 
−
** '''IsShowInSearch''' – признак показывать ли валюту в поиске
 
−
** '''Symbol''' – символ валюты (обрабатывается с 15.7)
 
−
** '''Key''' – идентификатор валюты
 
  
 +
<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>
 +
Вызов метода CurrencyRates
 +
<syntaxhighlight lang="java" enclose="div">
 +
http://localhost:9000/TourSearchOwin/CurrencyRates?dateFrom=18.09.2024&dateTo=19.09.2024
 +
</syntaxhighlight>
 +
Возвращаемый результат метода CurrencyRates (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
[
 +
    {
 +
        "BaseCurrencyId": 14,
 +
        "CurrencyId": 1,
 +
        "Rate": 91.429200,
 +
        "Date": "18.09.2024"
 +
    },
 +
    {
 +
        "BaseCurrencyId": 14,
 +
        "CurrencyId": 2,
 +
        "Rate": 101.505700,
 +
        "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>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 +
===Выгрузка списка всех валют (getAllCurrencies)===
 +
Метод возвращает список всех валют.
 +
* Формат запроса:
 +
** GET .../TourSearchOwin/AllCurencies/getAllCurrencies
 +
* Принимаемые параметры:
 +
** нет принимаемых параметров
 +
* Возвращаемый результат:
 +
** '''Code''' – код валюты
 +
** '''Name''' – наименование валюты
 +
** '''IsMain''' – признак валюты «Главная»
 +
** '''IsNational''' – признак валюты «Национальная»
 +
** '''IsoCode''' – ISO код валюты
 +
** '''IsShowInSearch''' – признак показывать ли валюту в поиске
 +
** '''Symbol''' – символ валюты (обрабатывается с 15.7)
 +
** '''Key''' – идентификатор валюты
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
Вызов метода Currency
+
Вызов метода getAllCurrencies
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
−
GET http://localhost:9000/TourSearchOwin/Currency
+
GET http://localhost:9000/TourSearchOwin/AllCurencies/getAllCurrencies
 
</syntaxhighlight>
 
</syntaxhighlight>
−
Возвращаемый результат метода Currency (в формате JSON)
+
Возвращаемый результат метода getAllCurrencies (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
[
 
[
Строка 316: Строка 439:
 
       "Symbol": "$",
 
       "Symbol": "$",
 
       "Key": 1
 
       "Key": 1
 +
  },
 +
  {
 +
      "Code": "гр",
 +
      "Name": "Гривна",
 +
      "IsMain": false,
 +
      "IsNational": false,
 +
      "IsoCode": "UAH",
 +
      "IsShowInSearch": true,
 +
      "Symbol": "₴",
 +
      "Key": 6
 
   }
 
   }
 
]
 
]
Строка 322: Строка 455:
 
</div></div><br />
 
</div></div><br />
  
−
===Выгрузка квотируемых услуг системы (QuotedServices)===
+
 
−
Метод производит выгрузку услуг с признаком «Квотируемая»
+
===Получение сконвертированных цен (convertFilterPrice)===
 +
Метод возвращает сконвертированные цен для допфильтра ''Цена'' (используется в canary)
 
* Формат запроса:
 
* Формат запроса:
−
** GET .../TourSearchOwin/QuotedServices
+
** GET .../TourSearchOwin/AllCurencies/convertFilterPrice
−
* Принимаемые параметры:
+
* Принимаемые параметры ( '''*''' – обязательный):
−
** нет принимаемых параметров
+
** '''SourceRateKey *''' – ключ исходной валюты конвертации
 +
** '''TargetRateKey *''' – ключ валюты, в которую будет произведена конвертация
 +
** '''MinPrice *''' – значение минимальной цены, которое будет участвовать в конвертации
 +
** '''MaxPrice *''' – значение максимальной цены, которое будет участвовать в конвертации
 
* Возвращаемый результат:
 
* Возвращаемый результат:
−
** '''Key''' – идентификатор услуги
+
** '''m_Item1''' – сконвертированная минимальная цена
 +
** '''m_Item12''' – сконвертированная максимальная цена
 +
 
 +
<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>
 +
Вызов метода convertFilterPrice
 +
<syntaxhighlight lang="java" enclose="div">
 +
GET http://localhost:9000/TourSearchOwin/AllCurencies/convertFilterPrice?SourceRateKey=2&TargetRateKey=1&MinPrice=10&MaxPrice=200
 +
</syntaxhighlight>
 +
Возвращаемый результат метода convertFilterPrice (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
    "m_Item1": 12.035142616440004814057046576,
 +
    "m_Item2": 240.70285232880009628114093152
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
===Выгрузка квотируемых услуг системы (QuotedServices)===
 +
Метод производит выгрузку услуг с признаком «Квотируемая»
 +
* Формат запроса:
 +
** GET .../TourSearchOwin/QuotedServices
 +
* Принимаемые параметры:
 +
** нет принимаемых параметров
 +
* Возвращаемый результат:
 +
** '''Key''' – идентификатор услуги
 
** '''Code''' – код услуги
 
** '''Code''' – код услуги
 
** '''Name''' – наименование услуги (русский)
 
** '''Name''' – наименование услуги (русский)
Строка 430: Строка 594:
 
** GET .../TourSearchOwin/Destination?
 
** GET .../TourSearchOwin/Destination?
 
* Принимаемые параметры ( '''*''' – обязательный):
 
* Принимаемые параметры ( '''*''' – обязательный):
−
** '''departureCities *''' – идентификатор города(ов) отправления (из контроллера [[#Выгрузка городов отправления (departureCities)|''.../TourSearchOwin/departureCities?'']])
+
** '''departureCities *''' – идентификатор города(ов) отправления (из контроллера [[#Выгрузка актуальных городов отправления (departureCities)|''.../TourSearchOwin/departureCities?'']])
 +
** '''type''' – настройка easySearchFilter (0/не указано - настройка выключена, 1 - настройка включена)
 
** '''term''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
** '''term''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
 
* Возвращаемый результат:
 
* Возвращаемый результат:
 
** '''Name''' – название страны
 
** '''Name''' – название страны
 
** '''Key''' – идентификатор страны
 
** '''Key''' – идентификатор страны
−
** '''DestinationType''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''DestinationType''' – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
 +
** '''IsExist''' – не используется
 +
** '''Data''' – массив данных для контекстного поиска
 +
*** '''CityKey''' – код города
 +
*** '''CityName''' – Название
 +
*** '''HotelKey''' – код отеля
 +
*** '''HotelName''' – название отеля
 +
*** '''ResortKey''' – код курорта
 +
*** '''ResortName''' – название курорта
 +
 
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 442: Строка 616:
 
Вызов метода Destination
 
Вызов метода Destination
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 +
 
GET http://localhost:9000/TourSearchOwin/Destination?departureCities=1
 
GET http://localhost:9000/TourSearchOwin/Destination?departureCities=1
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 448: Строка 623:
 
[
 
[
 
       {
 
       {
−
       "Name": "Болгария",
+
       "Data": null,
−
       "Key": 359,
+
      "DestinationType": 1,
−
       "DestinationType": 1
+
      "IsExist": false,
 +
       "Key": 90,
 +
       "Name": "Австрия"
 +
   
 +
   
 
   },
 
   },
 
       {
 
       {
−
       "Name": "Индия",
+
       "Data": null,
−
       "Key": 26,
+
      "DestinationType": 1,
−
       "DestinationType": 1
+
      "IsExist": false,
 +
       "Key": 53,
 +
       "Name": "Тайланд"
 +
     
 +
     
 
   },
 
   },
 
       {
 
       {
−
       "Name": "Финляндия",
+
       "Data": null,
−
       "Key": 64,
+
      "DestinationType": 1,
−
       "DestinationType": 1
+
      "IsExist": false,
 +
       "Key": 460,
 +
       "Name": "Россия"
 +
     
 +
     
 
   }
 
   }
 +
]
 +
GET http://localhost:9000/TourSearchOwin/Destination?departureCities=1&type=1
 +
</syntaxhighlight>
 +
Возвращаемый результат метода Destination (в формате JSON) с включенной настройкой easySearchFilter
 +
<syntaxhighlight lang="java" enclose="div">
 +
[
 +
{
 +
  "Name": "Австрия",
 +
  "Key": 90,
 +
  "DestinationType": 1,
 +
  "IsExist": false,
 +
  "Data":
 +
        [
 +
        {
 +
          "CityKey": 35,
 +
          "CityName": "Вена",
 +
          "HotelKey": 178,
 +
          "HotelName": "Ananas, 5+++*",
 +
          "ResortKey": 232,
 +
          "ResortName": "Малина"
 +
        },
 +
        {
 +
          "CityKey": 35,
 +
          "CityName": "Вена",
 +
          "HotelKey": 20748,
 +
          "HotelName": "Dev, 1-4*Boutique",
 +
          "ResortKey": 0,
 +
          "ResortName": ""
 +
        },
 +
      ],
 +
}
 +
{
 +
  "Name": "Тайланд",
 +
  "Key": 53,
 +
  "DestinationType": 1,
 +
  "IsExist": false,
 +
  "Data":
 +
        [
 +
          {
 +
            "CityKey": 415,
 +
            "CityName": "Пхукет",
 +
            "HotelKey": 5263,
 +
            "HotelName": "7Q Hotel, HV",
 +
            "ResortKey": 123,
 +
            "ResortName": "Пхукет"
 +
          }
 +
        ],
 +
},
 +
{
 +
  "Name": "Россия",
 +
  "Key": 460,
 +
  "DestinationType": 1,
 +
  "IsExist": false,
 +
  "Data":
 +
        [
 +
          {
 +
            "CityKey": 295,
 +
            "CityName": "Санкт-Петербург",
 +
            "HotelKey": 20365,
 +
            "HotelName": "Бристоль, 3*",
 +
            "ResortKey": 0,
 +
            "ResortName": ""
 +
          }
 +
        ],
 +
},
 +
{
 +
  "Name": "ОАЭ",
 +
  "Key": 2,
 +
  "DestinationType": 1,
 +
  "IsExist": false,
 +
  "Data":
 +
        [
 +
          {
 +
          "CityKey": 12,
 +
          "CityName": "ДУБАЙ",
 +
          "HotelKey": 1257,
 +
          "HotelName": "Avari, APTH3",
 +
          "ResortKey": 0,
 +
          "ResortName": ""
 +
          },
 +
      ],
 +
}
 
]
 
]
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 513: Строка 782:
 
** '''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''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
Строка 519: Строка 788:
 
** '''Key''' – идентификатор типа тура
 
** '''Key''' – идентификатор типа тура
 
** '''Name''' – название типа тура
 
** '''Name''' – название типа тура
−
** '''ParentId''' – идентификатор группы, к которой относится данный типа тура (если тип тура не относится к группе, то возвращается ''null'')
+
** '''ParentId''' – идентификатор группы, к которой относится данный тип тура (если тип тура не относится к группе, то возвращается ''null'')
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 559: Строка 828:
 
** '''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'', то есть все типы тура в рамках данной страны
 
* Возвращаемый результат:
 
* Возвращаемый результат:
Строка 595: Строка 864:
 
** '''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'', то есть все типы тура в рамках данной страны
Строка 634: Строка 903:
 
** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
 
** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20)
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false)
 
** '''isFromBasket *''' – происходит ли обращение из корзины или из поиска туров (true/false)
−
** '''isFillSecondaryFilters *''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true)
+
** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
−
** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''DestinationType *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
 
** '''AdultCount *''' – количество взрослых
 
** '''AdultCount *''' – количество взрослых
Строка 647: Строка 916:
 
** '''Groups''' – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
 
** '''Groups''' – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
 
** '''HotelScheme''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры:  
 
** '''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'' в том случае, когда происходит запрос вариантов проживания (кнопка ''Варианты'') в автобусных переездах
 
** '''BusTransferPointKeys''' – данный признак проставляется в ''true'' в том случае, когда происходит запрос вариантов проживания (кнопка ''Варианты'') в автобусных переездах
 
** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
 
** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
Строка 684: Строка 953:
 
** '''FlightCityDeparture''' – ключ город вылета в параметрах авиаперелета (дополнительный фильтр)
 
** '''FlightCityDeparture''' – ключ город вылета в параметрах авиаперелета (дополнительный фильтр)
 
** '''CityDeparture''' – ключ города начала поездки (дополнительный фильтр)
 
** '''CityDeparture''' – ключ города начала поездки (дополнительный фильтр)
−
** '''RemoteHotelMode''' – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Обрабатывается начиная с релиза 15.4.
+
** '''RemoteHotelMode''' – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
−
** '''GroupGuid''' – используется для получения турпрограмм по уникальному ключу из кэша при использовании группировки. Примеры использования. ''GroupGuid=00000000-0000-0000-0000-000000000000'' – при первом запросе от локальной системы. ''GroupGuid=936DA01F-9ABD-4d9d-80C7-02AF85C822A8'' (уникальный ключ) – передается на клиент от первого запроса из внешней системы. С данным уникальным ключом осуществляется второй запрос от удаленной внешней системы. Далее происходит получение значений по данному уникальному ключу. Обрабатывается начиная с релиза 15.4.
+
** '''GroupGuid''' – используется для получения турпрограмм по уникальному ключу из кэша при использовании группировки. Примеры использования. ''GroupGuid=00000000-0000-0000-0000-000000000000'' – при первом запросе от локальной системы. ''GroupGuid=936DA01F-9ABD-4d9d-80C7-02AF85C822A8'' (уникальный ключ) – передается на клиент от первого запроса из внешней системы. С данным уникальным ключом осуществляется второй запрос от внешней системы. Далее происходит получение значений по данному уникальному ключу. Обрабатывается начиная с релиза 15.4.
−
** '''IsGroupingTourAlreadyMerge''' – определяет слияние данных турпрограмм от локальной системы с данными от внешней системы при использовании группировки. Примеры использования. ''IsGroupingTourAlreadyMerge=false'' – полученные данные от локальной системы не объединены с данными от внешней удаленной системы. На клиенте осуществляется объединение данных турпрограмм с последующей сортировкой по минимальной цене. ''IsGroupingTourAlreadyMerge=true'' – полученные данные от локальной системы уже объединены с данными от внешней удаленной системы. На клиенте осуществляется только сортировка по минимальной цене. Обрабатывается начиная с релиза 15.4.
+
** '''IsGroupingTourAlreadyMerge''' – определяет слияние данных турпрограмм от локальной системы с данными от внешней системы при использовании группировки. Примеры использования. ''IsGroupingTourAlreadyMerge=false'' – полученные данные от локальной системы не объединены с данными от внешней системы. На клиенте осуществляется объединение данных турпрограмм с последующей сортировкой по минимальной цене. ''IsGroupingTourAlreadyMerge=true'' – полученные данные от локальной системы уже объединены с данными от внешней системы. На клиенте осуществляется только сортировка по минимальной цене. Обрабатывается начиная с релиза 15.4.
 
** '''SearchId''' – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.
 
** '''SearchId''' – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.
 +
** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 
   
 
   
  
Строка 700: Строка 970:
 
*** '''TourUrl''' – ссылка на программу тура
 
*** '''TourUrl''' – ссылка на программу тура
 
*** '''BookingConditions''' – условия бронирования программы туров
 
*** '''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''' – дата начала тура
 
*** '''StartDate''' – дата начала тура
 +
*** '''MaxConnectionTime''' – длительность пересадок в индивидуальных настройках подбора перелетов в формате hh:mm
 +
*** '''FullPaymentPeriod''' – полная оплата с даты бронирования (может быть null)
 +
*** '''FullPaymentCheckin''' – полная оплата до даты заезда (может быть null)
 +
*** '''PrePaymentPeriod''' – предоплата с даты бронирования (может быть null)
 +
*** '''PrePaymentCheckin''' – предоплата до даты заезда (может быть null)
 +
*** '''PrePaymentCu"''' – значение предоплаты в y.e. (может быть null)
 +
*** '''PrePaymentPercent''' – значение предоплаты в процентах (может быть null)
 
*** '''Duration''' – продолжительность тура (в днях)
 
*** '''Duration''' – продолжительность тура (в днях)
 
*** '''DurationInNight''' – продолжительность проживания (в ночах)
 
*** '''DurationInNight''' – продолжительность проживания (в ночах)
 
*** '''Types''' – идентификатор типа туров
 
*** '''Types''' – идентификатор типа туров
−
*** '''Cost''' – цена тура
+
*** '''Price''' –  цена тура с учетом скидки в валюте поиска
 +
*** '''Cost''' – цена тура в валюте поиска
 
*** '''Rate''' – код валюты тура
 
*** '''Rate''' – код валюты тура
 +
*** '''Penalties''' – внутреннее поле, не используется
 
*** '''CityDepature''' – город отправления
 
*** '''CityDepature''' – город отправления
 
**** '''Key''' – идентификатор города отправления
 
**** '''Key''' – идентификатор города отправления
Строка 748: Строка 1045:
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
 
***** '''QuotaStatus''' – информация о квоте
 
***** '''QuotaStatus''' – информация о квоте
−
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 760: Строка 1057:
 
***** '''PatternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров)
 
***** '''PatternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров)
 
***** '''FlightId''' – идентификатор перелета (внутренняя информация из программы туров)
 
***** '''FlightId''' – идентификатор перелета (внутренняя информация из программы туров)
−
**** '''FlightSourceMode''' – локальный или удаленный перелет (внутренняя информация из программы туров)
+
**** '''FlightSourceMode''' – локальный или внешний перелет (внутренняя информация из программы туров)
 
**** '''Id''' – идентификатор базового шаблона услуги (внутренняя информация из программы туров)  
 
**** '''Id''' – идентификатор базового шаблона услуги (внутренняя информация из программы туров)  
 
**** '''SvKey''' – ключ типа услуги
 
**** '''SvKey''' – ключ типа услуги
Строка 779: Строка 1076:
 
***** '''Key''' – ключ города
 
***** '''Key''' – ключ города
 
***** '''Value''' – название города
 
***** '''Value''' – название города
−
**** '''Country''' – ключ страны
+
**** '''Country''' – объект страна
 +
***** '''Key''' – ключ страны
 +
***** '''Value''' – название страны
 
**** '''Code''' – объект код услуги
 
**** '''Code''' – объект код услуги
 
***** '''Key''' – ключ услуги
 
***** '''Key''' – ключ услуги
Строка 795: Строка 1094:
 
***** '''Cost''' – цена
 
***** '''Cost''' – цена
 
***** '''QuotaStatus''' – объект информация по квотам
 
***** '''QuotaStatus''' – объект информация по квотам
−
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 885: Строка 1184:
 
***** '''enabled''' – флаг включен/выключен
 
***** '''enabled''' – флаг включен/выключен
 
*** '''RouteSubVariants''' – подварианты услуг (используется в основном поиске)
 
*** '''RouteSubVariants''' – подварианты услуг (используется в основном поиске)
 +
*** '''Routes''' – количество маршрутов для данного варианта поиска (к примеру, если будет несколько вариантов
 +
*** '''IsRemoteHotels''' – признак, есть ли внешние отели в данном варианте
 +
*** '''IsTourImages''' – признак, есть ли картинки тура
 +
*** '''MaskKeys''' – маска фильтра категории номеров
 
** '''SecondaryFiltersResult''' – результаты доп. фильтров
 
** '''SecondaryFiltersResult''' – результаты доп. фильтров
 
*** '''TourTypes''' – типы тура
 
*** '''TourTypes''' – типы тура
Строка 935: Строка 1238:
 
****** '''settings''' –
 
****** '''settings''' –
 
****** '''enabled''' –
 
****** '''enabled''' –
−
**** '''XmlSettings''' – строка xml для актуальных фильтров
 
 
**** '''Type''' – тип справочника (используется для внутренних целей)
 
**** '''Type''' – тип справочника (используется для внутренних целей)
 
*** '''TourDurations''' – продолжительность тура
 
*** '''TourDurations''' – продолжительность тура
Строка 963: Строка 1265:
 
**** '''HotelTypes''' – признаки отелей в дополнительных фильтрах  
 
**** '''HotelTypes''' – признаки отелей в дополнительных фильтрах  
 
***** '''''' –  
 
***** '''''' –  
 +
** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 990: Строка 1293:
 
         "TourUrl": "www.megatec.ru",
 
         "TourUrl": "www.megatec.ru",
 
         "BookingConditions": "<p>Условия бронирования тура.<\/p>",
 
         "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",
 
         "StartDate": "2018-02-25T00:00:00",
 +
        "MaxConnectionTime": 0
 +
        "FullPaymentPeriod": 5,
 +
        "FullPaymentCheckin": null,
 +
        "PrePaymentPeriod": null,
 +
        "PrePaymentCheckin": 5,
 +
        "PrePaymentCu": null,
 +
        "PrePaymentPercent": 10.0,
 
         "Duration": 4,
 
         "Duration": 4,
 
         "DurationInNight": 3,
 
         "DurationInNight": 3,
 
         "Types": [2],
 
         "Types": [2],
 +
        "Price": 260,
 
         "Cost": 260,
 
         "Cost": 260,
 +
        "Penalties": null,
 
         "Rate": "EU",
 
         "Rate": "EU",
 
         "CityDepature":          {
 
         "CityDepature":          {
Строка 1125: Строка 1455:
 
                     "Value": "Завтрак"
 
                     "Value": "Завтрак"
 
                   },
 
                   },
 +
                  "AbsolutePenalties": null,
 
                   "Cost": 19.47,
 
                   "Cost": 19.47,
 
                   "QuotaStatus":                  {
 
                   "QuotaStatus":                  {
Строка 1241: Строка 1572:
 
               "ServiceName": "страховка",
 
               "ServiceName": "страховка",
 
               "City": null,
 
               "City": null,
−
               "Country": 6245,
+
               "Country":               {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
              },
 
               "Code":                {
 
               "Code":                {
 
                   "Key": 297,
 
                   "Key": 297,
Строка 1294: Строка 1628:
 
                   "Value": "Санто-Доминго"
 
                   "Value": "Санто-Доминго"
 
               },
 
               },
−
               "Country": 6245,
+
               "Country":               {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
              },
 
               "Code":                {
 
               "Code":                {
 
                   "Key": 743,
 
                   "Key": 743,
Строка 1429: Строка 1766:
 
             }
 
             }
 
         },
 
         },
−
         "RouteSubVariants": []
+
         "RouteSubVariants": [],
 +
        "Routes": 1,
 +
        "IsRemoteHotels": false,
 +
        "IsTourImages": false,
 +
        "MaskKeys": null
 
       }
 
       }
 
   ],
 
   ],
Строка 1497: Строка 1838:
 
               }
 
               }
 
             },
 
             },
−
            "XmlSettings": "информация о туре в формате xml",
 
 
             "Type": "TourProgram"
 
             "Type": "TourProgram"
 
         }
 
         }
Строка 1948: Строка 2288:
 
</div></div><br />
 
</div></div><br />
  
−
===Выгрузка транспортного плана (TransportPlan)===
+
* Детализация параметра 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 включительно===
 
Метод производит выгрузку транспортного плана.
 
Метод производит выгрузку транспортного плана.
 
* Формат запроса:
 
* Формат запроса:
Строка 2036: Строка 2393:
 
</div></div><br />
 
</div></div><br />
  
−
===Выгрузка первоначального варианта в корзину для бронирования (Tour)===
+
===Выгрузка транспортного плана (TransportPlan) начиная с релиза 15.8===
−
Метод поиска, который возвращает варианты только по данной турпрограмме и схеме отеля.
+
Метод производит выгрузку транспортного плана.
 
* Формат запроса:
 
* Формат запроса:
−
** GET .../TourSearchOwin/Tour?
+
** GET .../TourSearchOwin/TransportPlan?
 
* Принимаемые параметры ( '''*''' – обязательный):
 
* Принимаемые параметры ( '''*''' – обязательный):
−
** '''DepartureCityKeys *''' – идентификатор города отправления (полученный из метода ''.../TourSearchOwin/departureCities?'')
+
** '''code''' – код услуги
−
** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country)
+
** '''dateBegin''' – дата услуги
−
** '''DestinationKey *''' – идентификатор страны прибытия (полученный из метода ''.../TourSearchOwin/Destination?'')
+
** '''serviceType''' – тип услуги
−
** '''Dates *''' – массив дат заезда (полученные из метода ''.../TourSearchOwin/TourDate?''). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
+
** '''transportKey''' – ключ справочника транспорт
−
** '''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/false)
 
−
** '''TourKey''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
 
−
** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
 
−
** '''RemoteHotelMode''' – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Обрабатывается начиная с релиза 15.4.
 
  
 
* Возвращаемый результат:
 
* Возвращаемый результат:
−
** '''CheckMessages''' – сообщения для логики проверки тура (не используется)
+
** '''VehiclePlans''' – массив параметров зон плана
−
** '''Message''' – сообщение об ошибке
+
*** '''Key''' – ключ зоны
−
*** '''Key''' – код ошибки
+
*** '''TransportKey''' – ключ из справочника транспорт
−
*** '''Value''' – сообщение об ошибке
+
*** '''Row''' – количество рядов
−
** '''Result''' – результаты поиска
+
*** '''AreaNumber''' – номер уровня
−
*** '''Key''' – идентификатор программы тура
+
*** '''Name''' – название уровня
−
*** '''Name''' – название программы тура
+
*** '''PlanOrientation''' – ориентация плана (''false'' - горизонтальная, ''true'' - вертикальная)
−
*** '''TourUrl''' – ссылка на программу тура
+
*** '''Column''' – количество столбцов
−
*** '''BookingConditions''' – условия бронирования программы туров
+
*** '''IsAirCraft''' – является ли планом самолета (''false'' - нет, ''true'' - является)
−
*** '''StartDate''' – дата начала тура
+
*** '''Type''' – не используется
−
*** '''Duration''' – продолжительность тура (в днях)
+
** '''Seats''' – массив параметров посадочного места
−
*** '''DurationInNight''' – продолжительность проживания (в ночах)
+
*** '''Key''' – ключ места
−
*** '''Types''' – идентификатор типа туров
+
*** '''SeatType''' – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
−
*** '''Cost''' – цена тура
+
*** '''Index''' – индекс места
−
*** '''Rate''' – код валюты тура
+
*** '''Number''' – название ячейки с местом
−
*** '''CityDepature''' – город отправления
+
*** '''Type''' – тип "место"
−
**** '''Key''' – идентификатор города отправления
+
*** '''VPKey''' – ключ зоны
−
**** '''Value''' – название города отправления
+
*** '''Border''' – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
−
*** '''CountryId''' – всегда возвращается ключ 0
+
 
−
*** '''Services''' – услуги в туре
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
−
**** '''DepartureCity''' – город отправления
+
<div class="mw-collapsible-content">
−
***** '''Key''' – идентификатор
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
***** '''Value''' – название
+
Вызов метода TransportPlan
−
**** '''DepartureCountry''' – страна отправления
+
<syntaxhighlight lang="java" enclose="div">
−
***** '''Key''' – идентификатор
+
GET http://localhost:9000/TourSearchOwin/TransportPlan?code=1776&dateBegin=28.03.2022&serviceType=14&transportKey=35
−
***** '''Value''' – название
+
</syntaxhighlight>
−
**** '''ArrivalCity''' – город прибытия
+
Возвращаемый результат метода TransportPlan (в формате JSON)
−
***** '''Key''' – идентификатор
+
<syntaxhighlight lang="java" enclose="div">
−
***** '''Value''' – название
+
{
−
**** '''ArrivalCountry''' – страна прибытия
+
"VehiclePlans":
−
***** '''Key''' – идентификатор
+
[
−
***** '''Value''' – название
+
  {
−
**** '''DepartureAirport''' – аэропорт отправления
+
    "Key": 291,
−
***** '''Key''' – идентификатор
+
    "TransportKey": 35,
−
***** '''Value''' – название
+
    "Row": 2,
−
**** '''ArrivalAirport''' – аэропорт прибытия
+
    "AreaNumber": 1,
−
***** '''Key''' – идентификатор
+
    "Name": "Зона 1",
−
***** '''Value''' – название
+
    "PlanOrientation": false,
−
**** '''Airline''' – авиакомпания
+
    "Column": 3,
−
***** '''Key''' – идентификатор
+
    "IsAirCraft": false,
−
***** '''Value''' – название
+
    "Type": "VehiclePlans"
−
**** '''Aircraft''' – воздушное судно
+
  },
−
***** '''Key''' – идентификатор
+
  {
−
***** '''Value''' – название
+
    "Key": 292,
−
**** '''Flight''' – рейс
+
    "TransportKey": 35,
−
***** '''Key''' – идентификатор
+
    "Row": 3,
−
***** '''Value''' – название
+
    "AreaNumber": 2,
−
**** '''DepartureTime''' – время вылета
+
    "Name": "Зона 2",
−
**** '''ArrivalTime''' – время прилета
+
    "PlanOrientation": true,
−
**** '''EndDateTime''' – дата и время прилета
+
    "Column": 2,
−
**** '''FlightDetails''' – информация об авиаперелете
+
    "IsAirCraft": false,
−
***** '''Tariff''' – информация о тарифе перелета
+
    "Type": "VehiclePlans"
−
****** '''Key''' – идентификатор
+
  }
−
****** '''Code''' – код тарифа
+
],
−
****** '''Name''' – название тарифа
+
"Seats":
−
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
+
[
−
***** '''QuotaStatus''' – информация о квоте
+
  {
−
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
+
    "Key": 332522,
−
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
    "SeatType": 1,
−
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
    "Index": 0,
−
***** '''PartnerId''' – ключ партнера
+
    "Number": "1",
−
***** '''ByPax''' – цена за человека (true/false)
+
    "Type": "Seat",
−
***** '''Partner''' – информация о партнере
+
    "VPKey": 291,
−
****** '''Key''' – идентификатор
+
    "Border": "2002"
−
****** '''Value''' – название
+
  },
−
**** '''FlightSetting''' – внутренняя информация о перелете из программы туров
+
  {
−
***** '''ServiceId''' – идентификатор класса услуги (внутренняя информация из программы туров)
+
    "Key": 332523,
−
***** '''PatternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров)
+
    "SeatType": 1,
−
***** '''FlightId''' – идентификатор перелета (внутренняя информация из программы туров)
+
    "Index": 1,
−
**** '''FlightSourceMode''' – локальный или удаленный перелет (внутренняя информация из программы туров)
+
    "Number": "2",
−
**** '''Id''' – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
+
    "Type": "Seat",
−
**** '''SvKey''' – ключ типа услуги
+
    "VPKey": 291,
−
**** '''IsSubCode1''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
+
    "Border": "2100"
−
**** '''IsSubCode2''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]]
+
  },
−
**** '''IsPartnerBasedOn''' – признак услуга с приоритетным подбором поставщика
+
  {
−
**** '''Day''' – день предоставления услуги
+
    "Key": 332524,
−
**** '''DurationInNight''' – продолжительность услуги в ночах
+
    "SeatType": 2,
−
**** '''BeginDateTime''' – дата предоставления услуги
+
    "Index": 2,
−
**** '''IsHooded''' – признак скрытая услуга
+
    "Number": "П",
−
**** '''IsDeleted''' – признак удаляемая услуга
+
    "Type": "Seat",
−
**** '''IsNotCalculate''' – признак не рассчитываемая услуга
+
    "VPKey": 291,
−
**** '''PacketId''' – ключ пакета
+
    "Border": "2201"
−
**** '''Index''' – порядковый номер услуги
+
  },
−
*** '''NotRouteServices''' – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
+
  {
−
**** '''ServiceName''' – название типа услуги
+
    "Key": 332525,
−
**** '''City''' – объект город
+
    "SeatType": 1,
−
***** '''Key''' – ключ города
+
    "Index": 3,
−
***** '''Value''' – название города
+
    "Number": "3",
−
**** '''Country''' – ключ страны
+
    "Type": "Seat",
−
**** '''Code''' – объект код услуги
+
    "VPKey": 291,
−
***** '''Key''' – ключ услуги
+
    "Border": "0022"
−
***** '''Value''' – название услуги
+
  },
−
**** '''ByScheduler''' – флаг услуга по расписанию или нет
+
  {
−
**** '''Details''' – объект детализация услуги
+
    "Key": 332526,
−
***** '''SubCode1''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
+
    "SeatType": 1,
−
****** '''Key''' – ключ доп. описания 1
+
    "Index": 4,
−
****** '''Value''' – название доп. описания 1
+
    "Number": "4",
−
***** '''SubCode2''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
+
    "Type": "Seat",
−
****** '''Key''' – ключ доп. описания 2
+
    "VPKey": 291,
−
****** '''Value''' – название доп. описания 2
+
    "Border": "0120"
−
***** '''Date''' – дата услуги
+
  },
−
***** '''IsShowTransportPlan''' – признак показывать ли план рассадки (для автобусов)
+
  {
−
***** '''Cost''' – цена
+
    "Key": 332527,
−
***** '''QuotaStatus''' – объект информация по квотам
+
    "SeatType": 1,
−
****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
+
    "Index": 5,
−
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
    "Number": "5",
−
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
    "Type": "Seat",
−
***** '''PartnerId''' – идентификатор партнера
+
    "VPKey": 291,
−
***** '''ByPax''' – признак цены за человека
+
    "Border": "0221"
−
***** '''Partner''' – объект партнер (не заполняется)
+
  },
−
****** '''Key''' – ключ (не заполняется)
+
  {
−
****** '''Value''' – название (не заполняется)
+
    "Key": 332528,
−
**** '''ParentId''' – идентификатор родительской услуги (для вложенных услуг)
+
    "SeatType": 1,
−
**** '''PartnerBasedOnServiceTemplateId''' – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
+
    "Index": 0,
−
**** '''Id''' – идентификатор услуги
+
    "Number": "1",
−
**** '''SvKey''' – ключ типа услуги
+
    "Type": "Seat",
−
**** '''IsSubCode1''' – наличие [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
+
    "VPKey": 292,
−
**** '''IsSubCode2''' – наличие [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]]
+
    "Border": "2002"
−
**** '''IsPartnerBasedOn''' – услуга с подбором приоритетного поставщика услуги
+
  },
−
**** '''Day''' – день предоставления услуги
+
  {
−
**** '''DurationInNight''' – продолжительность услуги в ночах
+
    "Key": 332529,
−
**** '''BeginDateTime''' – дата предоставления услуги
+
    "SeatType": 1,
−
**** '''EndDateTime''' – дата окончания услуги
+
    "Index": 1,
−
**** '''IsHooded''' – скрытая ли услуга
+
    "Number": "2",
−
**** '''IsDeleted''' – удаляемая ли услуга
+
    "Type": "Seat",
−
**** '''IsNotCalculate''' – не рассчитываемая ли услуга
+
    "VPKey": 292,
−
**** '''PacketId''' – пакет услуги
+
    "Border": "2200"
−
**** '''Index''' – индекс услуги
+
  },
−
*** '''MinCostServicesComposition''' – массив состав услуг минимальной цены
+
  {
−
**** '''Key''' – ключ
+
    "Key": 332530,
−
***** '''TemplateId''' – идентификатор шаблона
+
    "SeatType": 1,
−
***** '''PatternId''' – идентификатор вкладки
+
    "Index": 2,
−
***** '''SettingId''' – идентификатор услуги
+
    "Number": "3",
−
**** '''Value''' – значение
+
    "Type": "Seat",
−
***** '''ServiceType''' – тип услуги
+
    "VPKey": 292,
−
***** '''Code''' – ключ услуги
+
    "Border": "0012"
−
***** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
+
  },
−
***** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
+
  {
−
***** '''PacketId''' – пакет услуги
+
    "Key": 332531,
−
***** '''PartnerId''' – партнер услуги
+
    "SeatType": 1,
−
***** '''CountryId''' – страна услуги
+
    "Index": 3,
−
***** '''CityId''' – город услуги
+
    "Number": "4",
−
***** '''Day''' – день предоставления услуги
+
    "Type": "Seat",
−
***** '''DurationInNight''' – продолжительность услуги в ночах
+
    "VPKey": 292,
−
**** '''COAndSpecialsInfo''' – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
+
    "Border": "0210"
−
***** '''AppliedCostOffersKeys''' – коллекция идентификаторов всех применённых ценовых блоков к одной цене             
+
  },
−
***** '''AppliedSpeciasInfo''' – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
+
  {
−
****** '''SpecialKey''' – ключ акции
+
    "Key": 332532,
−
****** '''SpecialName''' – название акции
+
    "SeatType": 1,
−
****** '''SpecialType''' – тип акции
+
    "Index": 4,
−
****** '''NewPrice''' – цена после применения акции
+
    "Number": "5",
−
****** '''OldPrice''' – цена до применения акции
+
    "Type": "Seat",
−
****** '''ShowOnline''' – нужно ли показывать акцию в поиске
+
    "VPKey": 292,
−
****** '''UntilDate''' – акция действует при совершении покупки до указанной даты
+
    "Border": "1000"
−
****** '''Condition''' – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
+
  },
−
******* ''NightsFrom'' (для типа ''PayStay'') – ночей от
+
  {
−
******* ''NightsTo'' (для типа ''PayStay'') – ночей до
+
    "Key": 332533,
−
******* ''NightValue'' (для типа ''PayStay'') – значение ночи, которое соответствует заданному периоду
+
    "SeatType": 1,
−
******* ''OperationType'' (для типа ''PayStay'') – тип действия
+
    "Index": 5,
−
******* ''SpecialNightType'' (для типа ''PayStay'') – тип бесплатной ночи
+
    "Number": "6",
−
******* ''DurationFrom'' (для типа ''KickBack'') – ночей от
+
    "Type": "Seat",
−
******* ''DurationTo'' (для типа ''KickBack'') – ночей до
+
    "VPKey": 292,
−
******* ''Value'' (для типа ''KickBack'') – значение продолжительности, равное заданному периоду
+
    "Border": "1000"
−
******* ''OperationType'' (для типа ''KickBack'') – тип действия
+
  }
−
******* ''NightsFrom'' (для типа ''EarlyBird'') – ночей от
+
],
−
******* ''NightsTo'' (для типа ''EarlyBird'') – ночей до
+
}
−
******* ''Discount'' (для типа ''EarlyBird'') – размер скидки
+
</syntaxhighlight>
−
******* ''OperationType'' (для типа ''EarlyBird'') – тип действия
+
</TD></TR></TABLE>
−
**** '''COBySubCode''' – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
+
</div></div><br />
−
**** '''SpecialsBySubCode''' -  список применённых акций по SubCode1 и SubCode2
+
 
−
***** '''SubCode1''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
+
===Получение дат заезда по турпрограмме===
−
***** '''SubCode2''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
+
Работает начиная с релиза 15.8.
−
*** '''FlightWeight''' –
+
Метод возвращает даты заезда по ключу турпрограммы.
−
*** '''LinkingFlightsRules''' – объект правил связывания
+
* Формат запроса:
−
**** '''notCombineDifferentAirlineRule''' – объект не скрещивать авиакомпании
+
** GET .../TourSearchOwin/TransportPlan?
−
***** '''airlines''' – авиакомпании
+
* Принимаемые параметры ( '''*''' – обязательный):
−
***** '''flightSettings''' – массив ключей ServiceId, PatternId, FlightId
+
** '''tourProgramKey *''' – ключ турпрограммы
−
***** '''enabled''' – флаг включен/выключен
+
 
−
**** '''checkPlusMinus1CharterRule''' – объект Отличие номера рейса на 1
+
* Возвращаемый результат:
−
***** '''FlightSettingPairs''' – массив чартеров, для которых это правило будет выполняться
+
** '''Массив дат заезда по туру'''
−
***** '''enabled''' – флаг включен/выключен
+
 
−
**** '''notCombineDifferentTariffGroupRule''' – объект не комбинировать рейсы от разных классов перелетов
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
−
***** '''FlightSettings''' – массив ключей ServiceId, PatternId, FlightId
+
<div class="mw-collapsible-content">
−
***** '''enabled''' – флаг включен/выключен
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
**** '''notCombineDifferentPartnerRule''' – объект не комбинировать рейсы от разных партнеров
+
Вызов метода
−
***** '''FlightSettings''' – массив ключей ServiceId, PatternId, FlightId
+
<syntaxhighlight lang="java" enclose="div">
−
***** '''enabled''' – флаг включен/выключен
+
GET http://localhost:9000/TourSearchOwin/TransportPlan?tourProgramKey=100001277
−
**** '''departureCityEqualsArrivalCityRule''' – объект Город вылета = городу прилета
+
</syntaxhighlight>
−
***** '''FlightSettingPairs''' – чартеры, для которых это будет выполняться
+
Возвращаемый результат метода (в формате JSON)
−
***** '''enabled''' – флаг включен/выключен
+
<syntaxhighlight lang="java" enclose="div">
−
**** '''combineOnlySpecificChartersRule''' – объект не комбинировать различные классы перелетов
+
[
−
***** '''settings''' – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
+
    "2022-02-21T00:00:00Z",
−
***** '''enabled''' – флаг включен/выключен
+
    "2022-02-22T00:00:00Z",
−
*** '''RouteSubVariants''' – подварианты услуг (используется в основном поиске)
+
    "2022-02-23T00:00:00Z",
−
** '''SecondaryFiltersResult''' – доп. фильтры (не используется при вызове из корзины)
+
    "2022-02-24T00:00:00Z",
−
 
+
    "2022-02-25T00:00:00Z",
−
 
+
    "2022-02-26T00:00:00Z",
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
]
−
<div class="mw-collapsible-content">
+
</syntaxhighlight>
−
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+
</TD></TR></TABLE>
−
Вызов метода Tour (первоначальный вариант Tour в корзине для бронирования)
+
</div></div><br />
−
<syntaxhighlight lang="java" enclose="div">
+
 
−
GET http://localhost:9000/TourSearchOwin/Tour?DepartureCityKeys=1&DestinationType=1&DestinationKey=90
+
===Получение плана транспортного средства (TransportPlan) по ключу турпрограммы и дате услуги===
−
&Dates=31.03.18&Durations=8&AdultCount=2&CurrencyName=EU&HotelQuota=5&AviaQuota=5&BusTransferQuota=5
+
Работает начиная с релиза 15.8.
−
&HotelScheme=[{"TemplateId":"1","DurationInNight":"7","Code":"707","PacketKey":"779","PartnerKey":"12667"
+
Метод возвращает даты заезда по ключу турпрограммы и дате услуги.
−
"GDSProviderId": "0","TotalTourDuration": "8"}]
+
* Формат запроса:
−
&TourKey=100003404&TourDuration=8&PageNumber=1&PageSize=20&IsFromBasket=true&isFillSecondaryFilters=false
+
** GET .../TourSearchOwin/TransportPlan?
−
</syntaxhighlight>
+
* Принимаемые параметры ( '''*''' – обязательный):
−
Возвращаемый результат метода Tour (в формате JSON)
+
** '''tourProgramKey *''' – ключ турпрограммы
−
<syntaxhighlight lang="java" enclose="div">
+
** '''dateBegin *''' – дата услуги
−
{
+
** '''serviceType *''' – тип услуги
−
  "CheckMessages": null,
+
 
−
  "Message":    {
+
* Возвращаемый результат:
−
      "Key": 0,
+
* '''plan''' – массив данных план
−
      "Value": null
+
** '''VehiclePlans''' – массив параметров зон плана
−
  },
+
*** '''Key''' – ключ зоны
−
  "Result":    [
+
*** '''TransportKey''' – ключ из справочника транспорт
−
            {
+
*** '''Row''' – количество рядов
−
        "Key": 100003404,
+
*** '''AreaNumber''' – номер уровня
−
        "Name": "Удалить этот тур",
+
*** '''Name''' – название уровня
−
         "TourUrl": "www.megatec.ru",
+
*** '''PlanOrientation''' – ориентация плана (''false'' - горизонтальная, ''true'' - вертикальная)
−
         "BookingConditions": "Условия бронирования тура",
+
*** '''Column''' – количество столбцов
−
         "StartDate": "2018-03-31T00:00:00",
+
*** '''IsAirCraft''' – является ли планом самолета (''false'' - нет, ''true'' - является)
−
         "Duration": 8,
+
*** '''Dates''' – не используется
−
        "DurationInNight": 7,
+
*** '''Type''' – не используется
−
        "Types": [2],
+
** '''Seats''' – массив параметров посадочного места
−
        "Cost": 122,
+
*** '''Key''' – ключ места
−
         "Rate": "EU",
+
*** '''SeatType''' – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
−
         "CityDepature":          {
+
*** '''Index''' – индекс места
−
             "Key": 1,
+
*** '''Number''' – название ячейки с местом
−
             "Value": "Москва"
+
*** '''Type''' – тип "место"
−
         },
+
*** '''VPKey''' – ключ зоны
−
         "CountryId": 90,
+
*** '''Border''' – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
−
         "Services":          [
+
* '''routeCity''' – направление автобусного переезда
−
                         {
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
−
               "DepartureCity":                {
+
<div class="mw-collapsible-content">
−
                   "Key": 1,
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
                   "Value": "Москва"
+
Вызов метода
−
               },
+
<syntaxhighlight lang="java" enclose="div">
−
               "DepartureCountry":                {
+
GET http://localhost:9000/TourSearchOwin/TransportPlan?tourProgramKey=100001221&dateBegin=06.09.2023&serviceType=14
−
                   "Key": 460,
+
</syntaxhighlight>
−
                   "Value": "Россия"
+
Возвращаемый результат метода (в формате JSON)
−
               },
+
<syntaxhighlight lang="java" enclose="div">
−
               "ArrivalCity":                {
+
{
−
                   "Key": 35,
+
    "plan": {
−
                   "Value": "Вена"
+
        "VehiclePlans": [
−
               },
+
            {
−
               "ArrivalCountry":                {
+
                "Key": 10,
−
                   "Key": 90,
+
                "TransportKey": 24,
−
                   "Value": "Австрия"
+
                "Row": 10,
−
               },
+
                "AreaNumber": 1,
−
               "DepartureAirport":                {
+
                "Name": "12345678901234567890",
−
                   "Key": "DME",
+
                "PlanOrientation": true,
−
                   "Value": "Домодедово"
+
                "Column": 5,
−
               },
+
                "IsAirCraft": false,
−
               "ArrivalAirport":                {
+
                "Dates": null,
−
                   "Key": "VIE1",
+
                "Type": "VehiclePlans"
−
                   "Value": "Vena1"
+
            }
−
               },
+
        ],
−
               "Airline":                {
+
        "Seats": [
−
                   "Key": "3G",
+
            {
−
                   "Value": "Атлант Союз_d;kgmdlfkgnfdlkhndlfkhnlkfnh"
+
                "Key": 406,
−
               },
+
                "SeatType": 1,
−
               "Aircraft":                {
+
                "Index": 0,
−
                   "Key": "319",
+
                "Number": "1",
−
                   "Value": "AIRBUS "
+
                "Type": "Seat",
−
               },
+
                "VPKey": 10,
−
               "Flight":                {
+
                "Border": "0000"
−
                   "Key": 858,
+
            },
−
                   "Value": "1111"
+
            {
−
               },
+
                "Key": 407,
−
               "DepartureTime": "10:00:00",
+
                "SeatType": 1,
−
               "ArrivalTime": "11:59:00",
+
                "Index": 1,
−
               "EndDateTime": "2018-03-31T11:59:00",
+
                "Number": "2",
−
               "FlightDetails": [              {
+
                "Type": "Seat",
−
                   "Tariff":                  {
+
                "VPKey": 10,
−
                     "Key": 67,
+
                "Border": "0000"
−
                     "Code": "C",
+
            },
−
                     "Name": "Бизнес класс"
+
            {
−
                   },
+
                "Key": 408,
−
                   "Cost": 6.45,
+
                "SeatType": 0,
−
                   "QuotaStatus":                  {
+
                "Index": 2,
−
                     "PlacesStatus": 4,
+
                "Number": "",
−
                     "FreePlaces": 0,
+
                "Type": "Seat",
−
                     "IsFewPlaces": false
+
                "VPKey": 10,
−
                   },
+
                "Border": "0000"
−
                   "PartnerId": 10760,
+
            },
−
                   "ByPax": true,
+
            {
−
                   "Partner":                  {
+
                "Key": 409,
−
                     "Key": 0,
+
                "SeatType": 1,
−
                     "Value": null
+
                "Index": 3,
−
                   }
+
                "Number": "3",
−
               }],
+
                "Type": "Seat",
−
               "FlightSetting":                {
+
                "VPKey": 10,
−
                   "ServiceId": 3,
+
                "Border": "0000"
−
                   "PatternId": 14,
+
            },
−
                   "FlightId": 14
+
            {
 +
                "Key": 410,
 +
                "SeatType": 1,
 +
                "Index": 4,
 +
                "Number": "4",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            },
 +
            {
 +
                "Key": 411,
 +
                "SeatType": 1,
 +
                "Index": 5,
 +
                "Number": "5",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            },
 +
            {
 +
                "Key": 412,
 +
                "SeatType": 1,
 +
                "Index": 6,
 +
                "Number": "6",
 +
                "Type": "Seat",
 +
                "VPKey": 10,
 +
                "Border": "0000"
 +
            }
 +
        ]
 +
    },
 +
    "routeCity": "Москва - Казань"
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
 +
 
 +
===Выгрузка первоначального варианта в корзину для бронирования (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 *''' – объект схемы отеля (при работе с авиабукингом передается конструкция такого вида ''HotelScheme=[{"TemplateId":"}]'')
 +
*** '''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.
 +
** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 +
 
 +
* Возвращаемый результат:
 +
** '''CheckMessages''' – сообщения для логики проверки тура (не используется)
 +
** '''Message''' – сообщение об ошибке
 +
*** '''Key''' – код ошибки
 +
*** '''Value''' – сообщение об ошибке
 +
** '''Result''' – результаты поиска
 +
*** '''Key''' – идентификатор программы тура
 +
*** '''Name''' – название программы тура
 +
*** '''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''' – продолжительность тура (в днях)
 +
*** '''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: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
 +
**** '''IsSubCode2''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 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: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
 +
****** '''Key''' – ключ доп. описания 1
 +
****** '''Value''' – название доп. описания 1
 +
***** '''SubCode2''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, 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: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
 +
**** '''IsSubCode2''' – наличие [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]]
 +
**** '''IsPartnerBasedOn''' – услуга с подбором приоритетного поставщика услуги
 +
**** '''Day''' – день предоставления услуги
 +
**** '''DurationInNight''' – продолжительность услуги в ночах
 +
**** '''BeginDateTime''' – дата предоставления услуги
 +
**** '''EndDateTime''' – дата окончания услуги
 +
**** '''IsHooded''' – скрытая ли услуга
 +
**** '''IsDeleted''' – удаляемая ли услуга
 +
**** '''IsNotCalculate''' – не рассчитываемая ли услуга
 +
**** '''PacketId''' – пакет услуги
 +
**** '''Index''' – индекс услуги
 +
*** '''MinCostServicesComposition''' – массив состав услуг минимальной цены
 +
**** '''Key''' – ключ
 +
***** '''TemplateId''' – идентификатор шаблона
 +
***** '''PatternId''' – идентификатор вкладки
 +
***** '''SettingId''' – идентификатор услуги
 +
**** '''Value''' – значение
 +
***** '''ServiceType''' – тип услуги
 +
***** '''Code''' – ключ услуги
 +
***** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
 +
***** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, 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
 +
***** '''SubCode1''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
 +
***** '''SubCode2''' – объект [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
 +
*** '''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''' – доп. фильтры (не используется при вызове из корзины)
 +
** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 +
 
 +
 
 +
<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>
 +
Вызов метода Tour (первоначальный вариант Tour в корзине для бронирования)
 +
<syntaxhighlight lang="java" enclose="div">
 +
GET http://localhost:9000/TourSearchOwin/Tour?DepartureCityKeys=1&DestinationType=1&DestinationKey=90
 +
&Dates=31.03.18&Durations=8&AdultCount=2&CurrencyName=EU&HotelQuota=5&AviaQuota=5&BusTransferQuota=5
 +
&HotelScheme=[{"TemplateId":"1","DurationInNight":"7","Code":"707","PacketKey":"779","PartnerKey":"12667"
 +
"GDSProviderId": "0","TotalTourDuration": "8"}]
 +
&TourKey=100003404&TourDuration=8&PageNumber=1&PageSize=20&IsFromBasket=true&isFillSecondaryFilters=false
 +
</syntaxhighlight>
 +
Возвращаемый результат метода Tour (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
  "CheckMessages": null,
 +
  "Message":    {
 +
      "Key": 0,
 +
      "Value": null
 +
  },
 +
  "Result":    [
 +
            {
 +
        "Key": 100003404,
 +
        "Name": "Удалить этот тур",
 +
        "TourUrl": "www.megatec.ru",
 +
        "BookingConditions": "Условия бронирования тура",
 +
        "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":          {
 +
             "Key": 1,
 +
             "Value": "Москва"
 +
         },
 +
         "CountryId": 90,
 +
         "Services":          [
 +
                         {
 +
               "DepartureCity":                {
 +
                   "Key": 1,
 +
                   "Value": "Москва"
 +
               },
 +
               "DepartureCountry":                {
 +
                   "Key": 460,
 +
                   "Value": "Россия"
 +
               },
 +
               "ArrivalCity":                {
 +
                   "Key": 35,
 +
                   "Value": "Вена"
 +
               },
 +
               "ArrivalCountry":                {
 +
                   "Key": 90,
 +
                   "Value": "Австрия"
 +
               },
 +
               "DepartureAirport":                {
 +
                   "Key": "DME",
 +
                   "Value": "Домодедово"
 +
               },
 +
               "ArrivalAirport":                {
 +
                   "Key": "VIE1",
 +
                   "Value": "Vena1"
 +
               },
 +
               "Airline":                {
 +
                   "Key": "3G",
 +
                   "Value": "Атлант Союз_d;kgmdlfkgnfdlkhndlfkhnlkfnh"
 +
               },
 +
               "Aircraft":                {
 +
                   "Key": "319",
 +
                   "Value": "AIRBUS "
 +
               },
 +
               "Flight":                {
 +
                   "Key": 858,
 +
                   "Value": "1111"
 +
               },
 +
               "DepartureTime": "10:00:00",
 +
               "ArrivalTime": "11:59:00",
 +
               "EndDateTime": "2018-03-31T11:59:00",
 +
               "FlightDetails": [              {
 +
                   "Tariff":                  {
 +
                     "Key": 67,
 +
                     "Code": "C",
 +
                     "Name": "Бизнес класс"
 +
                   },
 +
                   "Cost": 6.45,
 +
                   "QuotaStatus":                  {
 +
                     "PlacesStatus": 4,
 +
                     "FreePlaces": 0,
 +
                     "IsFewPlaces": false
 +
                   },
 +
                   "PartnerId": 10760,
 +
                   "ByPax": true,
 +
                   "Partner":                  {
 +
                     "Key": 0,
 +
                     "Value": null
 +
                   }
 +
               }],
 +
               "FlightSetting":                {
 +
                   "ServiceId": 3,
 +
                   "PatternId": 14,
 +
                   "FlightId": 14
 
               },
 
               },
 
               "FlightSourceMode": 1,
 
               "FlightSourceMode": 1,
Строка 2727: Строка 3490:
 
* Принимаемые параметры ( '''*''' – обязательный):
 
* Принимаемые параметры ( '''*''' – обязательный):
 
** '''countryId *''' – ключ страны, для которой будут выгружаться настройки
 
** '''countryId *''' – ключ страны, для которой будут выгружаться настройки
 +
** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 +
 
* Возвращаемый результат:
 
* Возвращаемый результат:
 
** '''TouristFieldsSettings''' – массив полей с информацией о туристах (из админки Мастер-Web)  
 
** '''TouristFieldsSettings''' – массив полей с информацией о туристах (из админки Мастер-Web)  
 
*** '''lastname''' – объект фамилия туриста (лат)
 
*** '''lastname''' – объект фамилия туриста (лат)
 +
**** '''Index''' – порядковый индекс элемента
 
**** '''Code''' – код поля
 
**** '''Code''' – код поля
 +
**** '''ApiCode''' – имя поля, которое будет использоваться при бронировании (например при вызове метода CreateReservation)
 
**** '''HeaderText''' – название поля
 
**** '''HeaderText''' – название поля
−
**** '''IsVisible''' – видимость поля
+
**** '''IsEdit''' – признак редактируемости поля
 
**** '''IsRequired''' – признак обязательности заполнения поля
 
**** '''IsRequired''' – признак обязательности заполнения поля
−
**** '''IsEdit''' – признак редактируемости поля
+
**** '''IsVisible''' – видимость поля (видимое)
 +
**** '''IsDisabled''' – служебный внутренний параметр. При работе с API не используется
 
**** '''Translit''' – настройки транслитерации (0 – нет, 1 – транслитерация, 2 – латиница)  
 
**** '''Translit''' – настройки транслитерации (0 – нет, 1 – транслитерация, 2 – латиница)  
 
**** '''LetterCase''' – настройки регистра (0 – по умолчанию, 1 – с заглавной, 2 – большие, 3 – маленькие)
 
**** '''LetterCase''' – настройки регистра (0 – по умолчанию, 1 – с заглавной, 2 – большие, 3 – маленькие)
Строка 2763: Строка 3531:
 
** '''ChildAgeSetting''' – максимальный возраст ребенка, когда он считается ребенком (лет)
 
** '''ChildAgeSetting''' – максимальный возраст ребенка, когда он считается ребенком (лет)
 
** '''InfantAgeSetting''' – максимальный возраст младенца (месяцев)
 
** '''InfantAgeSetting''' – максимальный возраст младенца (месяцев)
 +
** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 2774: Строка 3543:
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
−
  "TouristFieldsSettings":   {
+
  "TouristFieldsSettings": {
−
      "lastname":       {
+
        "number": {
−
        "Code": "lastname",
+
            "Index": 0,
−
        "HeaderText": "Фамилия<font color=\"red\">*<\/font>",
+
            "Code": "number",
−
        "IsVisible": true,
+
            "ApiCode": "Number",
−
        "IsRequired": true,
+
            "HeaderText": "№",
−
        "IsEdit": true,
+
            "IsEdit": false,
−
        "Translit": 1,
+
            "IsRequired": false,
−
        "LetterCase": 2
+
            "IsVisible": false,
−
      },
+
            "IsDisabled": false,
−
      "patronymic":       {
+
            "Translit": 0,
−
        "Code": "patronymic",
+
            "LetterCase": 0
−
        "HeaderText": "Отчество",
+
        },
−
        "IsVisible": false,
+
        "ismain": {
−
        "IsRequired": false,
+
            "Index": 1,
−
        "IsEdit": true,
+
            "Code": "ismain",
−
        "Translit": 0,
+
            "ApiCode": "IsMain",
−
        "LetterCase": 2
+
            "HeaderText": "<img src=\"images/mw_main_tourist.gif\" border=\"0\" alt=\"Главный турист\" />",
−
      },
+
            "IsEdit": false,
−
      "sex":      {
+
            "IsRequired": true,
−
        "Code": "sex",
+
            "IsVisible": true,
−
        "HeaderText": "Пол<font color=\"red\">*<\/font>",
+
            "IsDisabled": true,
−
        "IsVisible": true,
+
            "Translit": 0,
−
        "IsRequired": false,
+
            "LetterCase": 0
−
        "IsEdit": true,
+
        },
−
        "Translit": 0,
+
        "sex": {
−
        "LetterCase": 0
+
            "Index": 2,
−
      },
+
            "Code": "sex",
−
      "firstname":       {
+
            "ApiCode": "Sex",
−
        "Code": "firstname",
+
            "HeaderText": "Пол<font color=\"red\">*</font>",
−
        "HeaderText": "Имя<font color=\"red\">*<\/font>",
+
            "IsEdit": true,
−
        "IsVisible": true,
+
            "IsRequired": false,
−
        "IsRequired": true,
+
            "IsVisible": true,
−
        "IsEdit": true,
+
            "IsDisabled": false,
−
        "Translit": 1,
+
            "Translit": 0,
−
        "LetterCase": 2
+
            "LetterCase": 0
−
      },
+
        },
−
      "passportbywhom":       {
+
        "birthdate": {
−
        "Code": "passportbywhom",
+
            "Index": 3,
−
        "HeaderText": "Кем выдан",
+
            "Code": "birthdate",
−
        "IsVisible": false,
+
            "ApiCode": "BirthDay",
−
        "IsRequired": false,
+
            "HeaderText": "Дата рождения<br />(dd.MM.yyyy)",
−
        "IsEdit": false,
+
            "IsEdit": false,
−
        "Translit": 0,
+
            "IsRequired": false,
−
        "LetterCase": 0
+
            "IsVisible": true,
−
      },
+
            "IsDisabled": false,
−
      "birthplace":       {
+
            "Translit": 0,
−
        "Code": "birthplace",
+
            "LetterCase": 0
−
        "HeaderText": "Место рождения",
+
        },
−
        "IsVisible": false,
+
        "birthplace": {
−
        "IsRequired": false,
+
            "Index": 4,
−
        "IsEdit": false,
+
            "Code": "birthplace",
−
        "Translit": 0,
+
            "ApiCode": "BirthPlace",
−
        "LetterCase": 0
+
            "HeaderText": "Место рождения",
−
      },
+
            "IsEdit": false,
−
      "birthdate":       {
+
            "IsRequired": false,
−
        "Code": "birthdate",
+
            "IsVisible": false,
−
        "HeaderText": "Дата рождения<br />(dd.MM.yyyy)",
+
            "IsDisabled": false,
−
        "IsVisible": true,
+
            "Translit": 0,
−
        "IsRequired": false,
+
            "LetterCase": 0
−
        "IsEdit": true,
+
        },
−
        "Translit": 0,
+
        "citizenship": {
−
        "LetterCase": 0
+
            "Index": 5,
−
      },
+
            "Code": "citizenship",
−
      "patronymicrus":       {
+
            "ApiCode": "Citizenship",
−
        "Code": "patronymicrus",
+
            "HeaderText": "Гражданство",
−
        "HeaderText": "Отчество",
+
            "IsEdit": false,
−
        "IsVisible": false,
+
            "IsRequired": false,
−
        "IsRequired": false,
+
            "IsVisible": true,
−
        "IsEdit": true,
+
            "IsDisabled": false,
−
        "Translit": 0,
+
            "Translit": 0,
−
        "LetterCase": 3
+
            "LetterCase": 0
−
      },
+
        },
−
      "lastnamerus":       {
+
        "lastname": {
−
        "Code": "lastnamerus",
+
            "Index": 6,
−
        "HeaderText": "Нац. паспорт: Фамилия",
+
            "Code": "lastname",
−
        "IsVisible": false,
+
            "ApiCode": "LastName",
−
        "IsRequired": true,
+
            "HeaderText": "Фамилия<font color=\"red\">*</font>",
−
        "IsEdit": true,
+
            "IsEdit": true,
−
        "Translit": 0,
+
            "IsRequired": true,
−
        "LetterCase": 0
+
            "IsVisible": true,
−
      },
+
            "IsDisabled": false,
−
      "citizenid":       {
+
            "Translit": 1,
−
        "Code": "citizenid",
+
            "LetterCase": 2
−
        "HeaderText": "ID туриста1",
+
        },
−
        "IsVisible": false,
+
        "firstname": {
−
        "IsRequired": false,
+
            "Index": 7,
−
        "IsEdit": true,
+
            "Code": "firstname",
−
        "Translit": 2,
+
            "ApiCode": "FirstName",
−
        "LetterCase": 2
+
            "HeaderText": "Имя<font color=\"red\">*</font>",
−
      },
+
            "IsEdit": true,
−
      "passport":       {
+
            "IsRequired": true,
−
        "Code": "passport",
+
            "IsVisible": true,
−
        "HeaderText": "Загран-паспорт: Паспорт<br />(серия/номер)",
+
            "IsDisabled": false,
−
        "IsVisible": true,
+
            "Translit": 1,
−
        "IsRequired": false,
+
            "LetterCase": 2
−
        "IsEdit": true,
+
        },
−
        "Translit": 0,
+
        "patronymic": {
−
        "LetterCase": 2
+
            "Index": 8,
−
      },
+
            "Code": "patronymic",
−
      "passportrus":       {
+
            "ApiCode": "Patronymic",
−
        "Code": "passportrus",
+
            "HeaderText": "Отчество",
−
        "HeaderText": "серия/номер",
+
            "IsEdit": false,
−
        "IsVisible": false,
+
            "IsRequired": false,
−
        "IsRequired": false,
+
            "IsVisible": false,
−
        "IsEdit": false,
+
            "IsDisabled": false,
−
        "Translit": 0,
+
            "Translit": 1,
−
        "LetterCase": 0
+
            "LetterCase": 2
−
      },
+
        },
−
      "ismain":       {
+
        "passport": {
−
        "Code": "ismain",
+
            "Index": 9,
−
        "HeaderText": "<img src=\"images/mw_main_tourist.gif\" border=\"0\" alt=\"Главный турист\" />",
+
            "Code": "passport",
−
        "IsVisible": true,
+
            "ApiCode": "InternationalPassportSeries/InternationalPassportNumber",
−
        "IsRequired": true,
+
            "HeaderText": "Загран-паспорт: Паспорт<br />(серия/номер)",
−
        "IsEdit": false,
+
            "IsEdit": false,
−
        "Translit": 0,
+
            "IsRequired": false,
−
        "LetterCase": 0
+
            "IsVisible": true,
−
      },
+
            "IsDisabled": false,
−
      "passportdate":       {
+
            "Translit": 1,
−
        "Code": "passportdate",
+
            "LetterCase": 2
−
        "HeaderText": "Загран-паспорт: дата выдачи",
+
        },
−
        "IsVisible": false,
+
        "passportdate": {
−
        "IsRequired": false,
+
            "Index": 10,
−
        "IsEdit": false,
+
            "Code": "passportdate",
−
        "Translit": 0,
+
            "ApiCode": "InternationalPassportDateOfIssue",
−
        "LetterCase": 0
+
            "HeaderText": "Загран-паспорт: дата выдачи",
−
      },
+
            "IsEdit": false,
−
      "firstnamerus":       {
+
            "IsRequired": false,
−
        "Code": "firstnamerus",
+
            "IsVisible": false,
−
        "HeaderText": "Нац. паспорт: Имя",
+
            "IsDisabled": false,
−
        "IsVisible": false,
+
            "Translit": 0,
−
        "IsRequired": true,
+
            "LetterCase": 0
−
        "IsEdit": true,
+
        },
−
        "Translit": 0,
+
        "passportdateend": {
−
        "LetterCase": 0
+
            "Index": 11,
−
      },
+
            "Code": "passportdateend",
−
      "passportbywhomrus":       {
+
            "ApiCode": "InternationalPassportDateOfExpiry",
−
        "Code": "passportbywhomrus",
+
            "HeaderText": "Действителен до<br />(dd.MM.yyyy)",
−
        "HeaderText": "Паспорт: кем выдан",
+
            "IsEdit": false,
−
        "IsVisible": false,
+
            "IsRequired": false,
−
        "IsRequired": false,
+
            "IsVisible": true,
−
        "IsEdit": false,
+
            "IsDisabled": false,
−
        "Translit": 0,
+
            "Translit": 0,
−
        "LetterCase": 0
+
            "LetterCase": 0
−
      },
+
        },
−
      "citizenship":       {
+
        "passportbywhom": {
−
        "Code": "citizenship",
+
            "Index": 12,
−
        "HeaderText": "Гражданство",
+
            "Code": "passportbywhom",
−
        "IsVisible": true,
+
            "ApiCode": "internationalPassportByWhom",
−
        "IsRequired": false,
+
            "HeaderText": "Кем выдан",
−
        "IsEdit": true,
+
            "IsEdit": false,
−
        "Translit": 0,
+
            "IsRequired": false,
−
        "LetterCase": 0
+
            "IsVisible": false,
−
      },
+
            "IsDisabled": false,
−
      "passportdaterus":       {
+
            "Translit": 0,
−
        "Code": "passportdaterus",
+
            "LetterCase": 0
−
        "HeaderText": "Нац. паспорт:дата выдачи",
+
        },
−
        "IsVisible": false,
+
        "lastnamerus": {
−
        "IsRequired": false,
+
            "Index": 13,
−
        "IsEdit": false,
+
            "Code": "lastnamerus",
−
        "Translit": 0,
+
            "ApiCode": "LastNameRus",
−
        "LetterCase": 0
+
            "HeaderText": "Нац. паспорт: Фамилия",
−
      },
+
            "IsEdit": false,
−
      "phone":      {
+
            "IsRequired": false,
−
        "Code": "phone",
+
            "IsVisible": false,
−
        "HeaderText": "Телефон",
+
            "IsDisabled": false,
−
        "IsVisible": false,
+
            "Translit": 0,
−
        "IsRequired": false,
+
            "LetterCase": 2
−
        "IsEdit": false,
+
        },
−
        "Translit": 0,
+
        "firstnamerus": {
−
        "LetterCase": 0
+
            "Index": 14,
−
      },
+
            "Code": "firstnamerus",
−
      "number":       {
+
            "ApiCode": "FirstNameRus",
−
        "Code": "number",
+
            "HeaderText": "Нац. паспорт: Имя",
−
        "HeaderText": "№",
+
            "IsEdit": false,
−
        "IsVisible": false,
+
            "IsRequired": false,
−
        "IsRequired": false,
+
            "IsVisible": false,
−
        "IsEdit": false,
+
            "IsDisabled": false,
−
        "Translit": 0,
+
            "Translit": 0,
−
        "LetterCase": 0
+
            "LetterCase": 2
−
      },
+
        },
−
      "passportdateend":       {
+
        "patronymicrus": {
−
        "Code": "passportdateend",
+
            "Index": 15,
−
        "HeaderText": "Действителен до<br />(dd.MM.yyyy)",
+
            "Code": "patronymicrus",
−
        "IsVisible": true,
+
            "ApiCode": "PatronymicRus",
−
        "IsRequired": false,
+
            "HeaderText": "Нац. Отчество",
−
        "IsEdit": true,
+
            "IsEdit": false,
−
        "Translit": 0,
+
            "IsRequired": false,
−
        "LetterCase": 0
+
            "IsVisible": false,
−
      },
+
            "IsDisabled": false,
−
      "email":       {
+
            "Translit": 0,
−
        "Code": "email",
+
            "LetterCase": 2
−
        "HeaderText": "Email",
+
        },
−
        "IsVisible": false,
+
        "passportrus": {
−
        "IsRequired": false,
+
            "Index": 16,
−
        "IsEdit": false,
+
            "Code": "passportrus",
−
        "Translit": 0,
+
            "ApiCode": "PassportSeries/PassportNumber",
−
        "LetterCase": 0
+
            "HeaderText": "серия/номер",
−
      }
+
            "IsEdit": false,
−
  },
+
            "IsRequired": false,
−
  "PassportDurationOfExpiry":   {
+
            "IsVisible": false,
−
      "StartPoint": 0,
+
            "IsDisabled": false,
−
      "Duration": null
+
            "Translit": 0,
−
  },
+
            "LetterCase": 0
−
  "ChildAgeSetting": 16,
+
        },
−
  "InfantAgeSetting": 24
+
        "passportdaterus": {
 +
            "Index": 17,
 +
            "Code": "passportdaterus",
 +
            "ApiCode": "PassportDateOfIssue",
 +
            "HeaderText": "Нац. паспорт:дата выдачи",
 +
            "IsEdit": false,
 +
            "IsRequired": false,
 +
            "IsVisible": false,
 +
            "IsDisabled": false,
 +
            "Translit": 0,
 +
            "LetterCase": 0
 +
        },
 +
        "passportbywhomrus": {
 +
            "Index": 18,
 +
            "Code": "passportbywhomrus",
 +
            "ApiCode": "PassportByWhom",
 +
            "HeaderText": "Паспорт: кем выдан",
 +
            "IsEdit": false,
 +
            "IsRequired": false,
 +
            "IsVisible": false,
 +
            "IsDisabled": false,
 +
            "Translit": 0,
 +
            "LetterCase": 0
 +
        },
 +
        "phone": {
 +
            "Index": 19,
 +
            "Code": "phone",
 +
            "ApiCode": "Phone",
 +
            "HeaderText": "Телефон",
 +
            "IsEdit": false,
 +
            "IsRequired": false,
 +
            "IsVisible": true,
 +
            "IsDisabled": false,
 +
            "Translit": 0,
 +
            "LetterCase": 0
 +
        },
 +
        "email": {
 +
            "Index": 20,
 +
            "Code": "email",
 +
            "ApiCode": "Email",
 +
            "HeaderText": "Email",
 +
            "IsEdit": false,
 +
            "IsRequired": false,
 +
            "IsVisible": true,
 +
            "IsDisabled": false,
 +
            "Translit": 0,
 +
            "LetterCase": 0
 +
        },
 +
        "citizenid": {
 +
            "Index": 21,
 +
            "Code": "citizenid",
 +
            "ApiCode": "CitizenID",
 +
            "HeaderText": "ID туриста1",
 +
            "IsEdit": false,
 +
            "IsRequired": false,
 +
            "IsVisible": false,
 +
            "IsDisabled": false,
 +
            "Translit": 2,
 +
            "LetterCase": 2
 +
        }
 +
    },
 +
    "PassportDurationOfExpiry": {
 +
        "StartPoint": 0,
 +
        "Duration": 0
 +
    },
 +
    "ChildAgeSetting": 16,
 +
    "InfantAgeSetting": 24
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 2988: Строка 3823:
 
Метод производит выгрузку услуг доплат к авиаперелетам.
 
Метод производит выгрузку услуг доплат к авиаперелетам.
 
* Формат запроса:
 
* Формат запроса:
−
** POST .../TourSearchOwin/GetFlightsAdditionalServices?
+
** POST .../TourSearchOwin/GetFlightsAdditionalServices?nodeId=2147483647
 +
, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
  
 
* Принимаемые параметры headers ( '''*''' – обязательный):
 
* Принимаемые параметры headers ( '''*''' – обязательный):
Строка 3021: Строка 3857:
 
**** '''ByPax''' – цена за человека
 
**** '''ByPax''' – цена за человека
 
**** '''QuotaStatus''' – объект статус квотирования
 
**** '''QuotaStatus''' – объект статус квотирования
−
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 3041: Строка 3877:
 
*** '''InternationalPassportSeries''' – серия загранпаспорта
 
*** '''InternationalPassportSeries''' – серия загранпаспорта
 
*** '''InternationalPassportNumber''' – номер загранпаспорта
 
*** '''InternationalPassportNumber''' – номер загранпаспорта
−
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта
+
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке
+
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
−
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта
+
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке
+
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
 
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
 
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
 
*** '''PassportSeries''' – серия паспорта
 
*** '''PassportSeries''' – серия паспорта
 
*** '''PassportNumber''' – номер паспорта
 
*** '''PassportNumber''' – номер паспорта
−
*** '''PassportDateOfIssue''' – дата выдачи паспорта
+
*** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке
+
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
 
*** '''PassportByWhom''' – кем выдан паспорт
 
*** '''PassportByWhom''' – кем выдан паспорт
 
*** '''Citizenship''' – название страны
 
*** '''Citizenship''' – название страны
Строка 3064: Строка 3900:
 
*** '''ServiceName''' – название услуги
 
*** '''ServiceName''' – название услуги
 
*** '''City''' – объект город
 
*** '''City''' – объект город
−
*** '''Country''' – ключ страны
+
*** '''Country''' – объект страна
 +
**** '''Key''' – ключ страны
 +
**** '''Value''' – название страны
 
*** '''Code''' – объект код услуги
 
*** '''Code''' – объект код услуги
 
**** '''Key''' – ключ услуги
 
**** '''Key''' – ключ услуги
Строка 3080: Строка 3918:
 
**** '''Cost''' – цена
 
**** '''Cost''' – цена
 
**** '''QuotaStatus''' – объект статус квотирования
 
**** '''QuotaStatus''' – объект статус квотирования
−
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 3113: Строка 3951:
 
Вызов метода GetHotelsAdditionalServices
 
Вызов метода GetHotelsAdditionalServices
 
<syntaxhighlight lang="java" enclose="div">
 
<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
 
Content-Type: application/json
 
{
 
{
Строка 3254: Строка 4092:
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
−
Возвращаемый результат метода GetHotelsAdditionalServices (в формате JSON)
+
Возвращаемый результат метода GetFlightsAdditionalServices (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
[{
 
[{
 
"ServiceName": "Доплаты к авиаперелетам",
 
"ServiceName": "Доплаты к авиаперелетам",
 
"City": null,
 
"City": null,
−
"Country": 90,
+
        "Country":                {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
},
 
"Code": {
 
"Code": {
 
"Key": 357,
 
"Key": 357,
Строка 3316: Строка 4157:
 
Метод производит выгрузку услуг доплат к отелям.
 
Метод производит выгрузку услуг доплат к отелям.
 
* Формат запроса:
 
* Формат запроса:
−
** POST .../TourSearchOwin/GetHotelsAdditionalServices?
+
** POST .../TourSearchOwin/GetHotelsAdditionalServices?nodeId=2147483647
 +
, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
  
 
* Принимаемые параметры headers ( '''*''' – обязательный):
 
* Принимаемые параметры headers ( '''*''' – обязательный):
Строка 3343: Строка 4185:
 
**** '''IsHooded''' – признак скрытая услуга
 
**** '''IsHooded''' – признак скрытая услуга
 
**** '''IsNotCalculated''' – признак не рассчитываемая услуга
 
**** '''IsNotCalculated''' – признак не рассчитываемая услуга
−
**** '''BeginDateTimeString''' – дата и время начала услуги
+
**** '''BeginDateTimeString''' – дата и время начала услуги (YYYY-MM-DDThh:mm:ss)
−
**** '''EndDateTimeString''' – дата и время окончания услуги
+
**** '''EndDateTimeString''' – дата и время окончания услуги (YYYY-MM-DDThh:mm:ss)
 
**** '''TemplateId''' – шаблон услуги
 
**** '''TemplateId''' – шаблон услуги
 
**** '''Cost''' – цена услуги
 
**** '''Cost''' – цена услуги
 
**** '''ByPax''' – цена за человека
 
**** '''ByPax''' – цена за человека
 
**** '''QuotaStatus''' – объект статус квотирования
 
**** '''QuotaStatus''' – объект статус квотирования
−
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 3370: Строка 4212:
 
*** '''InternationalPassportSeries''' – серия загранпаспорта
 
*** '''InternationalPassportSeries''' – серия загранпаспорта
 
*** '''InternationalPassportNumber''' – номер загранпаспорта
 
*** '''InternationalPassportNumber''' – номер загранпаспорта
−
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта
+
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке
+
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
−
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта
+
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке
+
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
 
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
 
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
 
*** '''PassportSeries''' – серия паспорта
 
*** '''PassportSeries''' – серия паспорта
 
*** '''PassportNumber''' – номер паспорта
 
*** '''PassportNumber''' – номер паспорта
−
*** '''PassportDateOfIssue''' – дата выдачи паспорта
+
*** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке
+
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке (DD.MM.YYYY)
 
*** '''PassportByWhom''' – кем выдан паспорт
 
*** '''PassportByWhom''' – кем выдан паспорт
 
*** '''Citizenship''' – название страны
 
*** '''Citizenship''' – название страны
 
*** '''Phone''' – телефон
 
*** '''Phone''' – телефон
 
*** '''Email''' – e-mail
 
*** '''Email''' – e-mail
−
*** '''BirthDay''' – дата рождения
+
*** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
−
*** '''BirthDayString''' – дата рождения в строковом формате
+
*** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
 
*** '''BirthPlace''' – место рождения
 
*** '''BirthPlace''' – место рождения
 
*** '''CitizenID''' – гражданство
 
*** '''CitizenID''' – гражданство
Строка 3431: Строка 4273:
 
**** '''Cost''' – цена
 
**** '''Cost''' – цена
 
**** '''QuotaStatus''' – объект статус квотирования
 
**** '''QuotaStatus''' – объект статус квотирования
−
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
Строка 3464: Строка 4306:
 
Вызов метода GetHotelsAdditionalServices
 
Вызов метода GetHotelsAdditionalServices
 
<syntaxhighlight lang="java" enclose="div">
 
<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
 
Content-Type: application/json
  
Строка 3600: Строка 4442:
 
"ServiceName": "Доплаты к отелям",
 
"ServiceName": "Доплаты к отелям",
 
"City": null,
 
"City": null,
−
"Country": 90,
+
                "Country":                {
 +
                  "Key": 90,
 +
                  "Value": "Австрия"
 +
},
 
"Code": {
 
"Code": {
 
"Key": 364,
 
"Key": 364,
Строка 3658: Строка 4503:
 
Метод производит расчет услуг с индивидуальным выбором у туристов.
 
Метод производит расчет услуг с индивидуальным выбором у туристов.
 
* Формат запроса:
 
* Формат запроса:
−
** POST .../TourSearchOwin/CalculateIndividualServiceCosts?
+
** POST .../TourSearchOwin/CalculateIndividualServiceCosts?nodeId=2147483647
 +
, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
  
 
* Принимаемые параметры headers ( '''*''' – обязательный):
 
* Принимаемые параметры headers ( '''*''' – обязательный):
Строка 3720: Строка 4566:
 
**** '''Brutto''' – брутто
 
**** '''Brutto''' – брутто
 
**** '''Discount''' – скидка
 
**** '''Discount''' – скидка
 +
** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 3726: Строка 4573:
 
Вызов метода CalculateIndividualServiceCosts
 
Вызов метода CalculateIndividualServiceCosts
 
<syntaxhighlight lang="java" enclose="div">
 
<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
 
Content-Type: application/json
  
Строка 3806: Строка 4653:
  
 
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
 
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
 +
<font style="color:red">''Внимание!''</font> Если в туре используется перелет из GDS, то в параметр '''flightSettings''' передается ответ из секции '''flightGDSRequest''' метода API [[Мастер-Тур(15):API для отдачи цен в поисковые системы#Актуализация тура (ActualizeTour)|ActualizeTour]]. Далее для получения цены выполняем методы [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)|RebuidFlights]] и [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Расчет путевки (CalculateReservation)|CalculateReservation]]. <br />
 
** '''flightSettings''' – информация о шаблоне услуги авиаперелета
 
** '''flightSettings''' – информация о шаблоне услуги авиаперелета
 
*** '''templateId''' – идентификатор шаблона услуги
 
*** '''templateId''' – идентификатор шаблона услуги
Строка 3846: Строка 4694:
 
*** '''InternationalPassportSeries''' – серия загранпаспорта
 
*** '''InternationalPassportSeries''' – серия загранпаспорта
 
*** '''InternationalPassportNumber''' – номер загранпаспорта
 
*** '''InternationalPassportNumber''' – номер загранпаспорта
−
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта
+
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке
+
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
−
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта
+
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке
+
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
 
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
 
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
 
*** '''PassportSeries''' – серия паспорта
 
*** '''PassportSeries''' – серия паспорта
 
*** '''PassportNumber''' – номер паспорта
 
*** '''PassportNumber''' – номер паспорта
−
*** '''PassportDateOfIssue''' – дата выдачи паспорта
+
*** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке
+
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке (DD.MM.YYYY)
 
*** '''PassportByWhom''' – кем выдан паспорт
 
*** '''PassportByWhom''' – кем выдан паспорт
 
*** '''Citizenship''' – название страны
 
*** '''Citizenship''' – название страны
Строка 4062: Строка 4910:
 
     "key": 0,
 
     "key": 0,
 
     "tourDurationByDays": "11",
 
     "tourDurationByDays": "11",
−
     "langueCode": "ru"
+
     "langueCode": "ru",
 +
    "isCanary": "false"
 
}
 
}
  
Строка 4517: Строка 5366:
 
</div></div><br />
 
</div></div><br />
  
−
===Получение семейств тарифов авиаперелетов из внешней системы (GetGDSFlightFareFamilies)===
+
===Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)===
−
Метод получает семейства тарифов для авиаперелетов из внешней системы.
+
<font style="color:red">''Внимание!''</font> Если в туре используется перелет из GDS, то перед этим методом вызывается [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Поиск рейсов из внешней системы (GetGDSFlights)|GetGDSFlights]] в принимаемые параметры которого передается ответ из секции flightGDSRequest метода API [[Мастер-Тур(15):API для отдачи цен в поисковые системы#Актуализация тура (ActualizeTour)|ActualizeTour]]. Далее текущий метод [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)|RebuidFlights]] и далее [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Расчет путевки (CalculateReservation)|CalculateReservation]]. <br />
−
* Формат запроса:
+
Метод возвращает информацию по выбранному перелету от внешнего поставщика.  
−
** POST .../TourSearchOwin/GetGDSFlightFareFamilies?
+
* Формат запроса:
−
 
+
** POST .../TourSearchOwin/RebuildFlights
 
* Принимаемые параметры headers ( '''*''' – обязательный):
 
* Принимаемые параметры headers ( '''*''' – обязательный):
 
** '''Content-Type *''' – application/json
 
** '''Content-Type *''' – application/json
  
 
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
 
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
−
** '''flightId''' – ID внешнего перелета
+
** '''flights''' – перелеты
−
** '''providerId''' – ID внешнего провайдера
+
*** '''direction''' –
−
** '''languageCode''' – код локализации
+
*** '''commonPrice''' – общая стоимость перелета
−
** '''passengers''' – информация о пассажирах
+
*** '''remotePriceSource''' – данные расчета локального перелета
−
*** '''IsMain''' – главный турист
+
**** '''providerId''' – ID внешнего поставщика
−
*** '''Number''' – порядковый номер туриста
+
**** '''flightId''' – идентификатор внешнего перелета  
−
*** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
+
*** '''localPriceSource''' – данные расчета локального перелета
−
*** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
+
**** '''packetId''' – ключ пакета
−
*** '''FirstName''' – имя (лат)
+
**** '''partnerId''' – идентификатор партнера
−
*** '''LastName''' – фамилия (лат)
+
*** '''flightsSequenceSettings''' – описание параметров последовательности перелетов для которых действуют замены 
−
*** '''Patronymic''' – отчество (лат)
+
**** '''templateId''' – идентификатор шаблона услуги
−
*** '''FirstNameRus''' – имя (рус)
+
**** '''patternId''' – идентификатор паттерна услуги
−
*** '''LastNameRus''' – фамилия (рус)
+
**** '''serviceId''' – идентификатор класса услуги
−
*** '''PatronymicRus''' – отчество (рус)
+
*** '''segments''' – сегменты авиаперелета
−
*** '''InternationalPassportSeries''' – серия загранпаспорта
+
**** '''segmentNumber''' – номер сегмента
−
*** '''InternationalPassportNumber''' – номер загранпаспорта
+
**** '''depratureCity''' – город отправления
−
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта
+
***** '''gdsItem''' – справочная информация внешней системы
−
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке
+
****** '''serviceId''' – идентификатор системы
−
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта
+
****** '''languageId''' – идентификатор языка
−
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке
+
****** '''id''' – идентификатор в системе внешнего поставщика
−
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
+
****** '''code''' – код в системе внешнего поставщика
−
*** '''PassportSeries''' – серия паспорта
+
****** '''name''' – имя в системе внешнего поставщика
−
*** '''PassportNumber''' – номер паспорта
+
******* '''automaticallyMappingValue''' – выражение используемое для автоматического маппинга
−
*** '''PassportDateOfIssue''' – дата выдачи паспорта
+
******* '''requestValue''' – значение поля справочника которое используется в запросе к внешнему поставщику
−
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке
+
****** '''displayedValue''' – значение поля справочника который используется для отображения
−
*** '''PassportByWhom''' – кем выдан паспорт
+
****** '''dependencies''' – список зависимых сущностей
−
*** '''Citizenship''' – название страны
+
******* '''dictionaryId''' – идентификатор справочника
−
*** '''Phone''' – телефон
+
******* '''itemId''' –  
−
*** '''Email''' – e-mail
+
****** '''columnValues''' – наименование города и страны
−
*** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
+
***** '''mtItem''' – справочная информации локальной системы
−
*** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
+
****** '''id''' – идентификатор в локальной системе
−
*** '''BirthPlace''' – место рождения
+
****** '''code''' – код в локальной системе
−
*** '''CitizenID''' – гражданство
+
****** '''name''' – имя в локальной системе
−
*** '''Age''' – количество полных лет на момент окончания тура
+
****** '''automaticallyMappingValue''' – выражение используемое для автоматического маппинга
−
** '''currency''' – валюта
+
****** '''requestValue''' – значение поля справочника которое используется в запросе к внешнему поставщику
−
** '''price''' – стоимость
+
****** '''displayedValue''' – значение поля справочника который используется для отображения
−
** '''param''' – параметры перелета
+
****** '''dependencies''' – список зависимых сущностей
−
*** '''flightsSource''' – параметры перелета
+
******* '''dictionaryId''' – идентификатор справочника
−
**** '''flightSettings''' – информация о шаблоне услуги авиаперелета
+
******* '''itemId''' –
−
***** '''templateId''' – идентификатор шаблона услуги
+
****** '''columnValues''' – наименование страны и города
−
***** '''patternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров)
+
***** '''mapping''' – связка
−
***** '''serviceId''' – идентификатор класса услуги (внутренняя информация из программы туров)
+
****** '''id''' – Id маппинга
−
**** '''service''' – информация об услуге авиаперелета
+
****** '''providerId''' – Id провайдера
−
***** '''ServiceType''' – тип услуги
+
****** '''dictionaryId''' – Id справочника
−
***** '''Code''' – ключ услуги
+
****** '''providerDictionaryItemId''' – Id справочника внешнего поставщика
−
***** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
+
****** '''providerDictionaryItemName''' – обозначение справочника внешнего поставщика
−
***** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
+
****** '''mtDictionaryItemId''' – Id справочника МТ
−
***** '''CountryId''' – страна услуги
+
****** '''mtDictionaryItemName''' – обозначение справочника MT
−
***** '''CityId''' – город услуги
+
**** '''arrivalCity''' – город прибытия
−
***** '''PacketId''' – пакет услуги
+
***** '''gdsItem''' – справочная информация внешней системы
−
***** '''PartnerId''' – партнер услуги
+
****** '''serviceId''' – идентификатор системы
−
***** '''Day''' – день предоставления услуги
+
****** '''languageId''' – идентификатор языка
−
***** '''DurationInNight''' – продолжительность услуги в ночах
+
****** '''id''' – идентификатор в системе внешнего поставщика
−
**** '''price''' – стоимость перелета
+
****** '''code''' – код в системе внешнего поставщика
−
**** '''quotaInfo''' – объект информация по квотам  
+
****** '''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''' – статус по квотам (есть места / нет мест / под запрос)
 
***** '''status''' – статус по квотам (есть места / нет мест / под запрос)
−
***** '''freePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
***** '''freePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
−
***** '''isFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
***** '''isFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
−
**** '''flightDateTimeLimitationInterval''' –  
+
** '''tourDate''' – дата тура
−
***** '''startLimitation''' – начало тайм-лимита
+
 
−
***** '''finishLimitation''' – объект тайм-лимита
+
* Возвращаемый результат:
−
****** '''dateTimeString''' – дата окончания тайм-лимита
+
** '''flights''' – информация о рейсах
−
****** '''serviceType''' – тип услуги
+
*** '''remoteFlightId''' – идентификатор внешнего перелета
−
****** '''serviceCode''' – код услуги
+
*** '''flightsSettings''' – внутренняя информация о перелете
−
**** '''flightSourceMode''' – тип перелета (1 – локальный, 2 – из внешний системы)
+
**** '''templateId''' – идентификатор шаблона услуги
−
*** '''passengers''' – информация о пассажирах
+
**** '''patternId''' – идентификатор паттерна услуги
−
**** '''IsMain''' – главный турист
+
**** '''serviceId''' – идентификатор класса услуги
−
**** '''Number''' – порядковый номер туриста
+
*** '''flightsPlains''' – планы полетов
−
**** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
+
**** '''DepartureCity''' – город вылета
−
**** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
+
***** '''Key''' – ключ города
−
**** '''FirstName''' – имя (лат)
+
***** '''Value''' – наименование города
−
**** '''LastName''' – фамилия (лат)
+
**** '''DepartureCountry''' – страна вылета
−
**** '''Patronymic''' – отчество (лат)
+
***** '''Key''' – ключ страны
−
**** '''FirstNameRus''' – имя (рус)
+
***** '''Value''' – наименование страны
−
**** '''LastNameRus''' – фамилия (рус)
+
**** '''ArrivalCity''' – город прибытия
−
**** '''PatronymicRus''' – отчество (рус)
+
***** '''Key''' – ключ города
−
**** '''InternationalPassportSeries''' – серия загранпаспорта
+
***** '''Value''' – наименование города
−
**** '''InternationalPassportNumber''' – номер загранпаспорта
+
**** '''ArrivalCountry''' – страна прибытия
−
**** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта
+
***** '''Key''' – ключ страны
−
**** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке
+
***** '''Value''' – наименование страны
−
**** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта
+
**** '''DepartureAirport''' – аэропорт вылета
−
**** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке
+
***** '''Key''' – ключ аэропорта
−
**** '''internationalPassportByWhom''' – кем выдан загранпаспорт
+
***** '''Value''' – наименование аэропорта
−
**** '''PassportSeries''' – серия паспорта
+
**** '''ArrivalAirport''' – аэропорт прилета
−
**** '''PassportNumber''' – номер паспорта
+
***** '''Key''' – ключ аэропорта
−
**** '''PassportDateOfIssue''' – дата выдачи паспорта
+
***** '''Value''' – наименование аэропорта
−
**** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке
+
**** '''Airline''' – авиакомпания
−
**** '''PassportByWhom''' – кем выдан паспорт
+
***** '''Id''' – идентификатор авиакомпании
−
**** '''Citizenship''' – название страны
+
***** '''"Value''' – наименование авиакомпании
−
**** '''Phone''' – телефон
+
***** '''"Key''' – ключ авиакомпании
−
**** '''Email''' – e-mail
+
**** '''Aircraft''' – воздушное судно
−
**** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
+
***** '''Key''' – ключ воздушного судна
−
**** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
+
***** '''Value''' – наименование воздушного судна
−
**** '''BirthPlace''' – место рождения
+
**** '''Flight''' – рейс
−
**** '''CitizenID''' – гражданство
+
***** '''Key''' – ключ рейса
−
**** '''Age''' – количество полных лет на момент окончания тура
+
***** '''Value''' – наименование рейса
−
*** '''tourDate''' – дата тура
+
**** '''DepartureTime''' – время отправления
−
*** '''tourCurrency''' – валюта тура
+
**** '''ArrivalTime''' – время прибытия
−
*** '''tourId''' – ключ программы тура
+
**** '''TotalTimeOfFlight''' – полное время перелета
−
*** '''filterTariff''' – информация о тарифах
+
**** '''FlightDetails''' – детали авиаперелета
−
*** '''filterDeptime''' – информация о времени вылета
+
***** '''Tariff''' – информация о тарифе перелета
−
*** '''isCommission''' – признак комиссионной цены
+
****** '''Key''' – идентификатор
−
*** '''baseFlightsParams''' – параметра авиаперелета
+
****** '''Code''' – код тарифа
−
**** '''CityArrival''' – город прибытия
+
****** '''Name''' – наименование тарифа
−
**** '''FlightCode''' – код авиаперелета
+
***** '''IsCommission''' – признак, комиссионная ли услуга
−
**** '''TariffKey''' – ключ тарифа
+
***** '''Cost''' – разница в стоимости с самым дешевым вариантом
−
**** '''PartnerId''' – ключ партнера
+
***** '''QuotaStatus''' – информация о квоте
−
*** '''isUpdated''' – информация об обновлении перелета
+
****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
−
*** '''key''' – ключ запроса
+
****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
−
*** '''tourDurationByDays''' – продолжительность перелета
+
****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
−
*** '''langueCode''' – локализация
+
***** '''PartnerId''' – ключ партнера
−
 
+
***** '''ByPax''' – цена за человека (true/false)
−
* Возвращаемый результат:
+
***** '''Partner''' – информация о партнере
−
** '''validationResult''' – информация о валидации
+
****** '''Key''' – идентификатор
−
*** '''Errors''' – ошибки
+
****** '''Value''' – наименование
−
*** '''Warnings''' – предупреждения
+
**** '''FlightSetting''' – информация о шаблоне услуги авиаперелета
−
*** '''States''' – статус
+
***** '''ServiceId''' – идентификатор класса услуги (внутренняя информация из программы туров)
−
*** '''IsValid''' – информация о результате
+
***** '''PatternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров)
−
** '''tariffSequencies''' – информация тарифах
+
***** '''FlightId''' – идентификатор внешнего перелета
−
*** '''flightId''' – идентификатор перелета
+
**** '''FlightSourceMode''' – локальный или внешний перелет (внутренняя информация из программы туров)
−
*** '''universalParametrsSequence''' – параметры тарифов
+
**** '''Id''' – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
−
**** '''universalParametrs''' – массив параметров
+
**** '''SvKey''' – ключ типа услуги
−
***** '''code''' – описание параметра тарифа
+
**** '''IsSubCode1''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]]
−
***** '''priority''' – приоритет показа
+
**** '''IsSubCode2''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]]
−
***** '''needToPay''' – нужна ли доплата
+
**** '''IsPartnerBasedOn''' – признак услуга с приоритетным подбором поставщика
−
***** '''shortDescriptions''' – краткое описание
+
**** '''Day''' – день предоставления услуги
−
****** '''code''' – код
+
**** '''DurationInNight''' – продолжительность услуги в ночах
−
****** '''value''' – значение
+
**** '''BeginDateTime''' – дата предоставления услуги
−
*** '''price''' – стоимость
+
**** '''EndDateTime''' – дата окончания услуги
−
*** '''deltaPrice''' – разница в цене
+
**** '''IsHooded''' – признак скрытая услуга
−
*** '''timeLimit''' – тайм-лимит
+
**** '''IsDeleted''' – признак удаляемая услуга
−
*** '''segments''' – сегменты
+
**** '''IsNotCalculate''' – признак не рассчитываемая услуга
−
*** '''depAirportCode''' – код аэропорта отправления
+
**** '''PacketId''' – ключ пакета
−
*** '''depCityCode''' – код города отправления
+
**** '''Index''' – порядковый номер услуги
−
*** '''arrAirportCode''' – код аэропорта прибытия
 
−
*** '''arrCityCode''' – код города прибытия
 
−
 
 
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
Вызов метода GetGDSFlightFareFamilies
+
Вызов метода RebuildFlights
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
−
POST http://localhost:9000/TourSearchOwin/GetGDSFlightFareFamilies? HTTP/1.1
+
POST http://localhost:9000/TourSearchOwin/RebuildFlights HTTP/1.1
 
Content-Type: application/json
 
Content-Type: application/json
−
 
 
{
 
{
−
     "flightId": "17554943020000",
+
  "flights": [
−
    "providerId": 82,
+
     {
−
    "languageCode": "ru",
+
      "remotePriceSource": {
−
    "passengers": [{
+
        "providerId": 1,
−
             "IsMain": true,
+
        "flightId": "111397601080000"
−
             "Number": 1,
+
      },
−
             "AgeType": 0,
+
      "localPriceSource": {
−
             "MaleFemaleSex": 0,
+
        "packetId": 197,
−
             "FirstName": "",
+
        "partnerId": 10767
−
             "LastName": "",
+
      },
−
             "Patronymic": "",
+
      "flightsSequenceSettings": [
−
             "FirstNameRus": "",
+
        {
−
             "LastNameRus": "",
+
          "templateId": 1,
−
             "PatronymicRus": "",
+
          "patternId": 0,
−
             "InternationalPassportSeries": "",
+
          "serviceId": 0
−
             "InternationalPassportNumber": "",
+
        }
−
             "InternationalPassportDateOfIssue": "",
+
      ],
−
             "InternationalPassportDateOfIssueString": "",
+
      "segments": [
−
             "InternationalPassportDateOfExpiry": "",
+
        {
−
             "InternationalPassportDateOfExpiryString": "",
+
          "segmentNumber": 1,
−
             "internationalPassportByWhom": "",
+
          "depratureCity": {
−
             "PassportSeries": "",
+
             "gdsItem": {
−
             "PassportNumber": "",
+
              "id": "524901",
−
            "PassportDateOfIssue": "",
+
              "code": "MOW",
−
            "PassportDateOfIssueString": "",
+
              "name": "Moscow",
−
             "PassportByWhom": "",
+
              "requestValue": "MOW",
−
            "Citizenship": "",
+
              "displayedValue": "Moscow",
−
            "Phone": "",
+
              "dependencies": [
−
            "Email": "",
+
                {
−
             "BirthDay": "",
+
                  "dictionaryId": 1,
−
             "BirthDayString": "",
+
                  "itemId": "643"
−
            "BirthPlace": "",
+
                }
−
            "CitizenID": "",
+
              ]
−
            "Age": 17
+
            },
−
         }, {
+
             "mtItem": {
−
             "IsMain": false,
+
              "id": "1",
−
             "Number": 2,
+
              "code": "MOW",
−
             "AgeType": 0,
+
              "name": "Москва",
−
             "MaleFemaleSex": 0,
+
              "requestValue": "",
−
             "FirstName": "",
+
              "displayedValue": "Москва",
−
             "LastName": "",
+
              "dependencies": [
−
             "Patronymic": "",
+
                {
−
             "FirstNameRus": "",
+
                  "dictionaryId": 1,
−
             "LastNameRus": "",
+
                  "itemId": "460"
−
             "PatronymicRus": "",
+
                }
−
             "InternationalPassportSeries": "",
+
              ]
−
             "InternationalPassportNumber": "",
+
            },
−
             "InternationalPassportDateOfIssue": "",
+
             "mapping": {
−
             "InternationalPassportDateOfIssueString": "",
+
              "id": 143,
−
             "InternationalPassportDateOfExpiry": "",
+
              "providerId": 1,
−
             "InternationalPassportDateOfExpiryString": "",
+
              "dictionaryId": 2,
−
            "internationalPassportByWhom": "",
+
              "providerDictionaryItemId": "524901",
−
            "PassportSeries": "",
+
              "providerDictionaryItemName": null
−
            "PassportNumber": "",
+
            }
−
             "PassportDateOfIssue": "",
+
          },
−
             "PassportDateOfIssueString": "",
+
          "arrivalCity": {
−
            "PassportByWhom": "",
+
             "gdsItem": {
−
            "Citizenship": "",
+
              "id": "2761369",
−
            "Phone": "",
+
              "code": "VIE",
−
            "Email": "",
+
              "name": "Vienna",
−
            "BirthDay": "",
+
              "requestValue": "VIE",
−
            "BirthDayString": "",
+
              "displayedValue": "Vienna",
−
            "BirthPlace": "",
+
              "dependencies": [
−
            "CitizenID": "",
+
                {
−
            "Age": 17
+
                  "dictionaryId": 1,
 +
                  "itemId": "40"
 +
                }
 +
              ]
 +
            },
 +
             "mtItem": {
 +
              "id": "35",
 +
              "code": "VIE",
 +
              "name": "Вена",
 +
              "requestValue": "",
 +
              "displayedValue": "Вена",
 +
              "dependencies": [
 +
                {
 +
                  "dictionaryId": 1,
 +
                  "itemId": "90"
 +
                }
 +
              ]
 +
            },
 +
             "mapping": {
 +
              "id": 41,
 +
              "providerId": 1,
 +
              "dictionaryId": 2,
 +
              "providerDictionaryItemId": "2761369",
 +
              "providerDictionaryItemName": null
 +
            }
 +
          },
 +
          "departureAirport": {
 +
             "gdsItem": {
 +
              "id": "5135",
 +
              "code": "SVO",
 +
              "name": "Moscow, Sheremetyevo",
 +
              "requestValue": "SVO",
 +
              "displayedValue": "SVO Moscow, Sheremetyevo",
 +
              "dependencies": [
 +
                {
 +
                  "dictionaryId": 1,
 +
                  "itemId": "643"
 +
                },
 +
                {
 +
                  "dictionaryId": 2,
 +
                  "itemId": "524901"
 +
                }
 +
              ]
 +
            },
 +
             "mtItem": {
 +
              "id": "52",
 +
              "code": "SVO",
 +
              "name": "Шереметьево-2",
 +
              "requestValue": "",
 +
              "displayedValue": "SVO Шереметьево-2",
 +
              "dependencies": [
 +
                {
 +
                  "dictionaryId": 1,
 +
                  "itemId": "460"
 +
                },
 +
                {
 +
                  "dictionaryId": 2,
 +
                  "itemId": "1"
 +
                }
 +
              ]
 +
             },
 +
            "mapping": {
 +
              "id": 1619,
 +
              "providerId": 1,
 +
              "dictionaryId": 5,
 +
              "providerDictionaryItemId": "5135",
 +
              "providerDictionaryItemName": null
 +
            }
 +
          },
 +
          "arrivalAirport": {
 +
             "gdsItem": {
 +
              "id": "6625",
 +
              "code": "VIE",
 +
              "name": "Vienna International Airport",
 +
              "requestValue": "VIE",
 +
              "displayedValue": "VIE Vienna International Airport",
 +
              "dependencies": [
 +
                {
 +
                  "dictionaryId": 1,
 +
                  "itemId": "40"
 +
                },
 +
                {
 +
                  "dictionaryId": 2,
 +
                  "itemId": "2761369"
 +
                }
 +
              ]
 +
            },
 +
             "mtItem": {
 +
              "id": "58",
 +
              "code": "VIE",
 +
              "name": "Vena",
 +
              "requestValue": "",
 +
              "displayedValue": "VIE Vena",
 +
              "dependencies": [
 +
                {
 +
                  "dictionaryId": 1,
 +
                  "itemId": "90"
 +
                },
 +
                {
 +
                  "dictionaryId": 2,
 +
                  "itemId": "35"
 +
                }
 +
              ]
 +
            },
 +
             "mapping": {
 +
              "id": 259,
 +
              "providerId": 1,
 +
              "dictionaryId": 5,
 +
              "providerDictionaryItemId": "6625",
 +
              "providerDictionaryItemName": null
 +
            }
 +
          },
 +
          "airline": {
 +
             "gdsItem": {
 +
              "id": "5",
 +
              "code": "SU",
 +
              "name": "Aeroflot",
 +
              "requestValue": "SU",
 +
              "displayedValue": "SU Aeroflot",
 +
              "dependencies": []
 +
            },
 +
             "mtItem": {
 +
              "id": "31",
 +
              "code": "SU",
 +
              "name": "Aeroflot-Russian International AirLines",
 +
              "requestValue": "",
 +
              "displayedValue": "SU Aeroflot-Russian International AirLines",
 +
              "dependencies": []
 +
            },
 +
             "mapping": {
 +
              "id": 265,
 +
              "providerId": 1,
 +
              "dictionaryId": 5,
 +
              "providerDictionaryItemId": "5",
 +
              "providerDictionaryItemName": null
 +
            }
 +
          },
 +
          "aircraft": {
 +
             "gdsItem": {
 +
              "id": "97",
 +
              "code": "73H",
 +
              "name": "Boeing 737",
 +
              "requestValue": "73H",
 +
              "displayedValue": "73H Boeing 737",
 +
              "dependencies": []
 +
            },
 +
             "mtItem": {
 +
              "id": "27",
 +
              "code": "73H",
 +
              "name": "73H",
 +
              "requestValue": "",
 +
              "displayedValue": "73H 73H",
 +
              "dependencies": []
 +
            },
 +
             "mapping": {
 +
              "id": 323,
 +
              "providerId": 1,
 +
              "dictionaryId": 5,tour
 +
              "providerDictionaryItemId": "97",
 +
              "providerDictionaryItemName": null
 +
            }
 +
          },
 +
          "tariff": {
 +
             "gdsItem": {
 +
              "id": "0",
 +
              "code": "N",
 +
              "name": "Экономический класс",
 +
              "requestValue": "",
 +
              "displayedValue": "",
 +
              "dependencies": []
 +
            },
 +
             "mtItem": null,
 +
            "mapping": null
 +
          },
 +
          "flightNumber": "2184",
 +
          "baggageRestriction": [],
 +
          "departureDate": "2021-10-25T09:00:00",
 +
          "arrivalDate": "2021-10-25T11:00:00",
 +
          "quotaInfo": {
 +
             "status": 1,
 +
            "freePlaces": 0,
 +
             "isFewPlaces": false
 +
          }
 +
        }
 +
      ],
 +
      "commonPrice": 313
 +
    }
 +
  ],
 +
  "tourDate": "2021-10-25T00:00:00"
 +
}
 +
</syntaxhighlight>
 +
Возвращаемый результат метода RebuildFlights (в формате JSON)
 +
<syntaxhighlight lang="java" enclose="div">
 +
{
 +
  "flights": [
 +
    {
 +
      "remoteFlightId": "111397601080000",
 +
      "flightsSettings": [
 +
        {
 +
          "templateId": 1,
 +
          "patternId": 0,
 +
          "serviceId": 0
 +
         }
 +
      ],
 +
      "flightsPlains": [
 +
        {
 +
          "DepartureCity": {
 +
             "Key": 1,
 +
            "Value": "Москва"
 +
          },
 +
          "DepartureCountry": {
 +
             "Key": 460,
 +
             "Value": "Россия"
 +
          },
 +
          "ArrivalCity": {
 +
             "Key": 35,
 +
             "Value": "Вена"
 +
          },
 +
          "ArrivalCountry": {
 +
            "Key": 90,
 +
             "Value": "Австрия"
 +
          },
 +
          "DepartureAirport": {
 +
             "Key": "SVO",
 +
             "Value": "Шереметьево-2"
 +
          },
 +
          "ArrivalAirport": {
 +
             "Key": "VIE",
 +
             "Value": "Vena"
 +
          },
 +
          "Airline": {
 +
            "Id": 31,
 +
             "Value": "Aeroflot-Russian International AirLines",
 +
             "Key": "SU"
 +
          },
 +
          "Aircraft": {
 +
             "Key": "73H",
 +
             "Value": "73H"
 +
          },
 +
          "Flight": {
 +
            "Key": 621,
 +
             "Value": "2184"
 +
          },
 +
          "DepartureTime": "09:00:00",
 +
          "ArrivalTime": "11:00:00",
 +
          "TotalTimeOfFlight": null,
 +
          "FlightDetails": [
 +
             {
 +
              "Tariff": {
 +
                "Key": 113,
 +
                "Code": "NSU",
 +
                "Name": "Экономический класс(внешняя система)"
 +
              },
 +
              "IsCommission": false,
 +
              "Cost": 313,
 +
              "QuotaStatus": {
 +
                "PlacesStatus": 1,
 +
                "FreePlaces": 0,
 +
                "IsFewPlaces": false
 +
              },
 +
              "PartnerId": 10767,
 +
              "ByPax": false,
 +
              "Partner": {
 +
                "Key": 0,
 +
                "Value": null
 +
              }
 +
             }
 +
          ],
 +
          "FlightSetting": {
 +
            "ServiceId": 1,
 +
             "PatternId": 0,
 +
            "FlightId": 0
 +
          },
 +
          "FlightSourceMode": 0,
 +
          "Id": 0,
 +
          "SvKey": 1,
 +
          "IsSubCode1": true,
 +
          "IsSubCode2": false,
 +
          "IsPartnerBasedOn": false,
 +
          "Day": 1,
 +
          "DurationInNight": 0,
 +
          "BeginDateTime": "2021-10-25T09:00:00",
 +
          "EndDateTime": "2021-10-25T11:00:00",
 +
          "IsHooded": false,
 +
          "IsDeleted": false,
 +
          "IsNotCalculate": false,
 +
          "PacketId": 197,
 +
          "Index": 0
 
         }
 
         }
−
    ],
+
      ]
−
     "currency": "$",
+
     }
−
    "price": 147,
+
  ]
−
    "param": {
+
}
−
        "flightsSource": [{
+
</syntaxhighlight>
−
                "flightSettings": {
+
</TD></TR></TABLE>
−
                    "templateId": 1,
+
</div></div><br />
−
                    "patternId": 0,
+
 
−
                    "serviceId": 0
+
===Получение семейств тарифов авиаперелетов из внешней системы (GetGDSFlightFareFamilies)===
−
                },
+
Метод получает семейства тарифов для авиаперелетов из внешней системы.
−
                "service": {
+
* Формат запроса:
−
                    "serviceType": 1,
+
** POST .../TourSearchOwin/GetGDSFlightFareFamilies?
−
                    "code": 1084,
+
 
−
                    "subCode1": 67,
+
* Принимаемые параметры headers ( '''*''' – обязательный):
−
                    "subCode2": 1,
+
** '''Content-Type *''' – application/json
−
                    "countryId": 90,
+
 
−
                    "cityId": 35,
+
* Принимаемые параметры POST запроса ( '''*''' – обязательный):
−
                    "packetId": 1037,
+
** '''flightId''' – ID внешнего перелета
−
                    "partnerId": 12792,
+
** '''providerId''' – ID внешнего провайдера
−
                    "day": 1,
+
** '''languageCode''' – код локализации
−
                    "durationInNight": 0
+
** '''passengers''' – информация о пассажирах
−
                },
+
*** '''IsMain''' – главный турист
−
                "price": 146.44,
+
*** '''Number''' – порядковый номер туриста
−
                "quotaInfo": {
+
*** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
−
                    "status": 4,
+
*** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
−
                    "freePlaces": 0,
+
*** '''FirstName''' – имя (лат)
−
                    "isFewPlaces": false
+
*** '''LastName''' – фамилия (лат)
−
                },
+
*** '''Patronymic''' – отчество (лат)
−
                "flightDateTimeLimitationInterval": {
+
*** '''FirstNameRus''' – имя (рус)
−
                    "startLimitation": null,
+
*** '''LastNameRus''' – фамилия (рус)
−
                    "finishLimitation": {
+
*** '''PatronymicRus''' – отчество (рус)
−
                        "dateTimeString": "2021-01-30T21:40:00",
+
*** '''InternationalPassportSeries''' – серия загранпаспорта
−
                        "serviceType": 3,
+
*** '''InternationalPassportNumber''' – номер загранпаспорта
−
                        "serviceCode": 178
+
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
                    }
+
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
−
                },
+
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
                "flightSourceMode": 2
+
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
−
            }
+
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
−
        ],
+
*** '''PassportSeries''' – серия паспорта
−
        "passengers": [{
+
*** '''PassportNumber''' – номер паспорта
−
                "IsMain": true,
+
*** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
−
                "Number": 1,
+
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке (DD.MM.YYYY)
−
                "AgeType": 0,
+
*** '''PassportByWhom''' – кем выдан паспорт
−
                "MaleFemaleSex": 0,
+
*** '''Citizenship''' – название страны
−
                "FirstName": "",
+
*** '''Phone''' – телефон
−
                "LastName": "",
+
*** '''Email''' – e-mail
−
                "Patronymic": "",
+
*** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
−
                "FirstNameRus": "",
+
*** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
−
                "LastNameRus": "",
+
*** '''BirthPlace''' – место рождения
−
                "PatronymicRus": "",
+
*** '''CitizenID''' – гражданство
−
                "InternationalPassportSeries": "",
+
*** '''Age''' – количество полных лет на момент окончания тура
−
                "InternationalPassportNumber": "",
+
** '''currency''' – валюта
−
                "InternationalPassportDateOfIssue": "",
+
** '''price''' – стоимость
−
                "InternationalPassportDateOfIssueString": "",
+
** '''param''' – параметры перелета
−
                "InternationalPassportDateOfExpiry": "",
+
*** '''flightsSource''' – параметры перелета
−
                "InternationalPassportDateOfExpiryString": "",
+
**** '''flightSettings''' – информация о шаблоне услуги авиаперелета
−
                "internationalPassportByWhom": "",
+
***** '''templateId''' – идентификатор шаблона услуги
−
                "PassportSeries": "",
+
***** '''patternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров)
−
                "PassportNumber": "",
+
***** '''serviceId''' – идентификатор класса услуги (внутренняя информация из программы туров)
−
                "PassportDateOfIssue": "",
+
**** '''service''' – информация об услуге авиаперелета
−
                "PassportDateOfIssueString": "",
+
***** '''ServiceType''' – тип услуги
−
                "PassportByWhom": "",
+
***** '''Code''' – ключ услуги
−
                "Citizenship": "",
+
***** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]]
−
                "Phone": "",
+
***** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]]
−
                "Email": "",
+
***** '''CountryId''' – страна услуги
−
                "BirthDay": "",
+
***** '''CityId''' – город услуги
−
                "BirthDayString": "",
+
***** '''PacketId''' – пакет услуги
−
                "BirthPlace": "",
+
***** '''PartnerId''' – партнер услуги
−
                "CitizenID": "",
+
***** '''Day''' – день предоставления услуги
−
                "Age": 17
+
***** '''DurationInNight''' – продолжительность услуги в ночах
−
            }, {
+
**** '''price''' – стоимость перелета
−
                "IsMain": false,
+
**** '''quotaInfo''' – объект информация по квотам
−
                "Number": 2,
+
***** '''status''' – статус по квотам (есть места / нет мест / под запрос)
−
                "AgeType": 0,
+
***** '''freePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
−
                "MaleFemaleSex": 0,
+
***** '''isFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
−
                "FirstName": "",
+
**** '''flightDateTimeLimitationInterval''' –
−
                "LastName": "",
+
***** '''startLimitation''' – начало тайм-лимита
−
                "Patronymic": "",
+
***** '''finishLimitation''' – объект тайм-лимита
−
                "FirstNameRus": "",
+
****** '''dateTimeString''' – дата окончания тайм-лимита
−
                "LastNameRus": "",
+
****** '''serviceType''' – тип услуги
−
                "PatronymicRus": "",
+
****** '''serviceCode''' – код услуги
−
                "InternationalPassportSeries": "",
+
**** '''flightSourceMode''' – тип перелета (1 – локальный, 2 – из внешний системы)
−
                "InternationalPassportNumber": "",
+
*** '''passengers''' – информация о пассажирах
−
                "InternationalPassportDateOfIssue": "",
+
**** '''IsMain''' – главный турист
−
                "InternationalPassportDateOfIssueString": "",
+
**** '''Number''' – порядковый номер туриста
−
                "InternationalPassportDateOfExpiry": "",
+
**** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
−
                "InternationalPassportDateOfExpiryString": "",
+
**** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
−
                "internationalPassportByWhom": "",
+
**** '''FirstName''' – имя (лат)
−
                "PassportSeries": "",
+
**** '''LastName''' – фамилия (лат)
−
                "PassportNumber": "",
+
**** '''Patronymic''' – отчество (лат)
−
                "PassportDateOfIssue": "",
+
**** '''FirstNameRus''' – имя (рус)
−
                "PassportDateOfIssueString": "",
+
**** '''LastNameRus''' – фамилия (рус)
−
                "PassportByWhom": "",
+
**** '''PatronymicRus''' – отчество (рус)
−
                "Citizenship": "",
+
**** '''InternationalPassportSeries''' – серия загранпаспорта
−
                "Phone": "",
+
**** '''InternationalPassportNumber''' – номер загранпаспорта
−
                "Email": "",
+
**** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
                "BirthDay": "",
+
**** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
−
                "BirthDayString": "",
+
**** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
                "BirthPlace": "",
+
**** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
−
                "CitizenID": "",
+
**** '''internationalPassportByWhom''' – кем выдан загранпаспорт
−
                "Age": 17
+
**** '''PassportSeries''' – серия паспорта
−
            }
+
**** '''PassportNumber''' – номер паспорта
−
        ],
+
**** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
−
        "tourDate": "2021-01-30T00:00:00",
+
**** '''PassportDateOfIssueString''' – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
−
        "tourCurrency": "$",
+
**** '''PassportByWhom''' – кем выдан паспорт
−
        "tourId": 100008958,
+
**** '''Citizenship''' – название страны
−
        "filterTariff": {},
+
**** '''Phone''' – телефон
−
        "filterDeptime": ["all"],
+
**** '''Email''' – e-mail
−
        "isCommission": true,
+
**** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
−
        "baseFlightsParams": [{
+
**** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
−
                "CityArrival": 35,
+
**** '''BirthPlace''' – место рождения
−
                "FlightCode": 1084,
+
**** '''CitizenID''' – гражданство
−
                "TariffKey": 67,
+
**** '''Age''' – количество полных лет на момент окончания тура
−
                "PartnerId": 12792
+
*** '''tourDate''' – дата тура
−
            }
+
*** '''tourCurrency''' – валюта тура
−
        ],
+
*** '''tourId''' – ключ программы тура
−
        "isUpdated": false,
+
*** '''filterTariff''' – информация о тарифах
−
        "key": 0,
+
*** '''filterDeptime''' – информация о времени вылета
−
        "tourDurationByDays": "11",
+
*** '''isCommission''' – признак комиссионной цены
−
        "langueCode": "ru"
+
*** '''baseFlightsParams''' – параметра авиаперелета
−
    }
+
**** '''CityArrival''' – город прибытия
−
}
+
**** '''FlightCode''' – код авиаперелета
 +
**** '''TariffKey''' – ключ тарифа
 +
**** '''PartnerId''' – ключ партнера
 +
*** '''isUpdated''' – информация об обновлении перелета
 +
*** '''key''' – ключ запроса
 +
*** '''tourDurationByDays''' – продолжительность перелета
 +
*** '''langueCode''' – локализация
  
−
</syntaxhighlight>
+
* Возвращаемый результат:
−
Возвращаемый результат метода GetGDSFlightFareFamilies (в формате JSON)
+
** '''validationResult''' – информация о валидации
−
<syntaxhighlight lang="java" enclose="div">
+
*** '''Errors''' – ошибки
−
[
+
*** '''Warnings''' – предупреждения
−
{
+
*** '''States''' – статус
−
     "validationResult": {
+
*** '''IsValid''' – информация о результате
−
        "Errors": [],
+
** '''tariffSequencies''' – информация тарифах
−
        "Warnings": null,
+
*** '''flightId''' – идентификатор перелета
−
        "States": null,
+
*** '''universalParametrsSequence''' – параметры тарифов
−
        "IsValid": true
+
**** '''universalParametrs''' – массив параметров
−
    },
+
***** '''code''' – описание параметра тарифа
−
    "tariffSequencies": [{
+
***** '''priority''' – приоритет показа
−
             "flightId": "17554961000000",
+
***** '''needToPay''' – нужна ли доплата
−
             "universalParametrsSequence": [{
+
***** '''shortDescriptions''' – краткое описание
−
                    "universalParametrs": [{
+
****** '''code''' – код
−
                            "code": "description",
+
****** '''value''' – значение
−
                            "priority": 0,
+
*** '''price''' – стоимость
−
                            "needToPay": "Free",
+
*** '''deltaPrice''' – разница в цене
−
                            "shortDescriptions": [{
+
*** '''timeLimit''' – тайм-лимит
−
                                    "code": "RU",
+
*** '''segments''' – сегменты
−
                                    "value": "Минимум"
+
*** '''depAirportCode''' – код аэропорта отправления
−
                                }
+
*** '''depCityCode''' – код города отправления
−
                            ]
+
*** '''arrAirportCode''' – код аэропорта прибытия
−
                        }, {
+
*** '''arrCityCode''' – код города прибытия
−
                            "code": "carry_on",
+
 
−
                            "priority": 1,
+
 
−
                            "needToPay": "Free",
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
−
                            "shortDescriptions": [{
+
<div class="mw-collapsible-content">
−
                                    "code": "RU",
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
                                    "value": "5 кг (40x30x20 см)"
+
Вызов метода GetGDSFlightFareFamilies
−
                                }
+
<syntaxhighlight lang="java" enclose="div">
−
                            ]
+
POST http://localhost:9000/TourSearchOwin/GetGDSFlightFareFamilies? HTTP/1.1
−
                        }, {
+
Content-Type: application/json
−
                            "code": "carry_on",
+
 
−
                            "priority": 2,
+
{
−
                            "needToPay": "Charge",
+
     "flightId": "17554943020000",
−
                            "shortDescriptions": [{
+
    "providerId": 82,
−
                                    "code": "RU",
+
    "languageCode": "ru",
−
                                    "value": "10 кг (55x40x25 см)"
+
    "passengers": [{
−
                                }
+
            "IsMain": true,
−
                            ]
+
            "Number": 1,
−
                        }, {
+
            "AgeType": 0,
−
                            "code": "baggage",
+
            "MaleFemaleSex": 0,
−
                            "priority": 3,
+
             "FirstName": "",
−
                            "needToPay": "Charge",
+
             "LastName": "",
−
                            "shortDescriptions": [{
+
            "Patronymic": "",
−
                                    "code": "RU",
+
            "FirstNameRus": "",
−
                                    "value": "платный"
+
            "LastNameRus": "",
−
                                }
+
            "PatronymicRus": "",
−
                            ]
+
            "InternationalPassportSeries": "",
−
                        }, {
+
            "InternationalPassportNumber": "",
−
                            "code": "exchangeable",
+
            "InternationalPassportDateOfIssue": "",
−
                            "priority": 4,
+
            "InternationalPassportDateOfIssueString": "",
−
                            "needToPay": "Charge",
+
            "InternationalPassportDateOfExpiry": "",
−
                            "shortDescriptions": [{
+
            "InternationalPassportDateOfExpiryString": "",
−
                                    "code": "RU",
+
            "internationalPassportByWhom": "",
−
                                    "value": "Обмен разрешен со сбором"
+
            "PassportSeries": "",
−
                                }
+
            "PassportNumber": "",
−
                            ]
+
            "PassportDateOfIssue": "",
−
                        }, {
+
            "PassportDateOfIssueString": "",
−
                            "code": "refundable",
+
            "PassportByWhom": "",
−
                            "priority": 5,
+
            "Citizenship": "",
−
                            "needToPay": "NotAvailable",
+
            "Phone": "",
−
                            "shortDescriptions": [{
+
            "Email": "",
−
                                    "code": "RU",
+
            "BirthDay": "",
−
                                    "value": "Возврат запрещен"
+
            "BirthDayString": "",
−
                                }
+
            "BirthPlace": "",
−
                            ]
+
            "CitizenID": "",
−
                        }
+
            "Age": 17
−
                    ]
+
        }, {
−
                }
+
            "IsMain": false,
−
             ],
+
            "Number": 2,
−
             "price": 147,
+
            "AgeType": 0,
−
             "deltaPrice": 0,
+
            "MaleFemaleSex": 0,
−
             "timeLimit": "22.01.2021 4:08:00",
+
            "FirstName": "",
−
             "segments": [{
+
            "LastName": "",
−
                    "depAirportCode": "VKO",
+
            "Patronymic": "",
−
                    "depCityCode": "MOW",
+
            "FirstNameRus": "",
−
                    "arrAirportCode": "VIE",
+
            "LastNameRus": "",
−
                    "arrCityCode": "VIE"
+
            "PatronymicRus": "",
−
                }
+
            "InternationalPassportSeries": "",
−
             ]
+
            "InternationalPassportNumber": "",
 +
            "InternationalPassportDateOfIssue": "",
 +
            "InternationalPassportDateOfIssueString": "",
 +
            "InternationalPassportDateOfExpiry": "",
 +
            "InternationalPassportDateOfExpiryString": "",
 +
            "internationalPassportByWhom": "",
 +
            "PassportSeries": "",
 +
            "PassportNumber": "",
 +
            "PassportDateOfIssue": "",
 +
             "PassportDateOfIssueString": "",
 +
             "PassportByWhom": "",
 +
             "Citizenship": "",
 +
             "Phone": "",
 +
             "Email": "",
 +
            "BirthDay": "",
 +
            "BirthDayString": "",
 +
            "BirthPlace": "",
 +
            "CitizenID": "",
 +
             "Age": 17
 
         }
 
         }
 
     ],
 
     ],
−
     "isDone": true
+
     "currency": "$",
−
}
+
    "price": 147,
−
]
+
    "param": {
−
</syntaxhighlight>
+
        "flightsSource": [{
−
</TD></TR></TABLE>
+
                "flightSettings": {
−
</div></div><br />
+
                    "templateId": 1,
−
 
+
                    "patternId": 0,
−
===Загрузка филиалов (Branches) начиная с релиза 15.3===
+
                    "serviceId": 0
−
Метод производит выгрузку филиалов бронирования.
+
                },
−
* Формат запроса:
+
                "service": {
−
** GET .../TourSearchOwin/Branches?
+
                    "serviceType": 1,
−
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
+
                    "code": 1084,
−
** '''ids''' – массив ключей филиалов
+
                    "subCode1": 67,
−
** '''cityKey''' – фильтр по городу филиала (если 0 или не задан, то выбираются все филиалы)
+
                    "subCode2": 1,
−
 
+
                    "countryId": 90,
−
* Возвращаемый результат:
+
                    "cityId": 35,
−
** '''Key''' – ключ филиала (ключ партнера)
+
                    "packetId": 1037,
−
** '''Value''' – название филиала (название партнера)
+
                    "partnerId": 12792,
−
 
+
                    "day": 1,
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
                    "durationInNight": 0
−
<div class="mw-collapsible-content">
+
                },
−
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+
                "price": 146.44,
−
Вызов метода Branches
+
                "quotaInfo": {
−
<syntaxhighlight lang="java" enclose="div">
+
                    "status": 4,
−
GET http://localhost:9000/TourSearchOwin/Branches?
+
                    "freePlaces": 0,
−
</syntaxhighlight>
+
                    "isFewPlaces": false
−
Возвращаемый результат метода Branches (в формате JSON)
+
                },
−
<syntaxhighlight lang="java" enclose="div">
+
                "flightDateTimeLimitationInterval": {
−
[{
+
                    "startLimitation": null,
−
"Key": 12848,
+
                    "finishLimitation": {
−
"Value": "Филиал 1"
+
                        "dateTimeString": "2021-01-30T21:40:00",
−
},
+
                        "serviceType": 3,
−
{
+
                        "serviceCode": 178
−
"Key": 12849,
+
                    }
−
"Value": "Филиал 2"
+
                },
−
},
+
                "flightSourceMode": 2
−
{
+
            }
−
"Key": 12850,
+
        ],
−
"Value": "Филиал 3"
+
        "passengers": [{
−
}]
+
                "IsMain": true,
−
</syntaxhighlight>
+
                "Number": 1,
−
</TD></TR></TABLE>
+
                "AgeType": 0,
−
</div></div><br />
+
                "MaleFemaleSex": 0,
−
 
+
                "FirstName": "",
−
 
+
                "LastName": "",
−
===Загрузка ведущих менеджеров (Users) начиная с релиза 15.3===
+
                "Patronymic": "",
−
Метод производит выгрузку ведущих менеджеров.
+
                "FirstNameRus": "",
−
* Формат запроса:
+
                "LastNameRus": "",
−
** GET .../TourSearchOwin/Users?
+
                "PatronymicRus": "",
−
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
+
                "InternationalPassportSeries": "",
−
** '''ids''' – массив ключей ведущих менеджеров
+
                "InternationalPassportNumber": "",
−
** '''branchKey''' – ключ филиала бронирования, к которому они привязаны
+
                "InternationalPassportDateOfIssue": "",
−
 
+
                "InternationalPassportDateOfIssueString": "",
−
* Возвращаемый результат:
+
                "InternationalPassportDateOfExpiry": "",
−
** '''Key''' – ключ ведущего менеджера
+
                "InternationalPassportDateOfExpiryString": "",
−
** '''Value''' – полное имя ведущего менеджера
+
                "internationalPassportByWhom": "",
−
 
+
                "PassportSeries": "",
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
                "PassportNumber": "",
−
<div class="mw-collapsible-content">
+
                "PassportDateOfIssue": "",
−
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
+
                "PassportDateOfIssueString": "",
−
Вызов метода Users
+
                "PassportByWhom": "",
−
<syntaxhighlight lang="java" enclose="div">
+
                "Citizenship": "",
−
GET http://localhost:9000/TourSearchOwin/Users?
+
                "Phone": "",
−
</syntaxhighlight>
+
                "Email": "",
−
Возвращаемый результат метода Users (в формате JSON)
+
                "BirthDay": "",
−
<syntaxhighlight lang="java" enclose="div">
+
                "BirthDayString": "",
−
[{
+
                "BirthPlace": "",
−
"Key": 1532,
+
                "CitizenID": "",
−
"Value": "Иванов И."
+
                "Age": 17
−
},
+
            }, {
−
{
+
                "IsMain": false,
−
"Key": 12849,
+
                "Number": 2,
−
"Value": "Петров П."
+
                "AgeType": 0,
−
}]
+
                "MaleFemaleSex": 0,
 +
                "FirstName": "",
 +
                "LastName": "",
 +
                "Patronymic": "",
 +
                "FirstNameRus": "",
 +
                "LastNameRus": "",
 +
                "PatronymicRus": "",
 +
                "InternationalPassportSeries": "",
 +
                "InternationalPassportNumber": "",
 +
                "InternationalPassportDateOfIssue": "",
 +
                "InternationalPassportDateOfIssueString": "",
 +
                "InternationalPassportDateOfExpiry": "",
 +
                "InternationalPassportDateOfExpiryString": "",
 +
                "internationalPassportByWhom": "",
 +
                "PassportSeries": "",
 +
                "PassportNumber": "",
 +
                "PassportDateOfIssue": "",
 +
                "PassportDateOfIssueString": "",
 +
                "PassportByWhom": "",
 +
                "Citizenship": "",
 +
                "Phone": "",
 +
                "Email": "",
 +
                "BirthDay": "",
 +
                "BirthDayString": "",
 +
                "BirthPlace": "",
 +
                "CitizenID": "",
 +
                "Age": 17
 +
            }
 +
        ],
 +
        "tourDate": "2021-01-30T00:00:00",
 +
        "tourCurrency": "$",
 +
        "tourId": 100008958,
 +
        "filterTariff": {},
 +
        "filterDeptime": ["all"],
 +
        "isCommission": true,
 +
        "baseFlightsParams": [{
 +
                "CityArrival": 35,
 +
                "FlightCode": 1084,
 +
                "TariffKey": 67,
 +
                "PartnerId": 12792
 +
            }
 +
        ],
 +
        "isUpdated": false,
 +
        "key": 0,
 +
        "tourDurationByDays": "11",
 +
        "langueCode": "ru"
 +
    }
 +
}
 +
 
 
</syntaxhighlight>
 
</syntaxhighlight>
−
</TD></TR></TABLE>
+
Возвращаемый результат метода GetGDSFlightFareFamilies (в формате JSON)
−
</div></div><br />
+
<syntaxhighlight lang="java" enclose="div">
−
 
+
[
−
 
+
{
−
===Расчет путевки (CalculateReservation)===
+
    "validationResult": {
−
Метод производит расчет стоимости путевки.
+
        "Errors": [],
−
* Формат запроса:
+
        "Warnings": null,
−
** POST .../TourSearchOwin/CalculateReservation?
+
        "States": null,
−
 
+
        "IsValid": true
−
* Принимаемые параметры headers ( '''*''' – обязательный):
+
    },
−
** '''Content-Type *''' – application/json
+
    "tariffSequencies": [{
−
 
+
            "flightId": "17554961000000",
−
* Принимаемые параметры POST запроса:
+
            "universalParametrsSequence": [{
−
** '''TourProgramId''' – ключ турпрограммы
+
                    "universalParametrs": [{
−
** '''BeginDate''' – дата начала тура
+
                            "code": "description",
−
** '''Duration''' – продолжительность тура
+
                            "priority": 0,
−
** '''Currency''' – код валюты
+
                            "needToPay": "Free",
−
** '''initialPrice''' – объект изначальная цена
+
                            "shortDescriptions": [{
−
*** '''price''' – цена
+
                                    "code": "RU",
−
*** '''currency''' – код валюты
+
                                    "value": "Минимум"
−
** '''Services''' – массив услуг
+
                                }
−
*** '''Service''' – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
+
                            ]
−
**** '''ServiceType''' – тип услуги (поле ''sv_key'' из таблицы ''service'')
+
                        }, {
−
**** '''Code''' – код услуги
+
                            "code": "carry_on",
−
**** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
+
                            "priority": 1,
−
**** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
+
                            "needToPay": "Free",
−
**** '''Packet''' – ключ пакета услуги
+
                            "shortDescriptions": [{
−
**** '''Partner''' – ключ партнера услуги
+
                                    "code": "RU",
−
**** '''Day''' – день предоставления услуги
+
                                    "value": "5 кг (40x30x20 см)"
−
**** '''DurationInNight''' – продолжительность услуги в ночах
+
                                }
−
**** '''City''' – ключ города
+
                            ]
−
**** '''Country''' – страна услуги
+
                        }, {
−
**** '''Attributes''' – битовая маска атрибутов услуг
+
                            "code": "carry_on",
−
**** '''IsRemovable''' – (не обрабатывается)
+
                            "priority": 2,
−
**** '''Type''' – тип услуги в путевке (базовая дополнительная)
+
                            "needToPay": "Charge",
−
**** '''IsHooded''' – признак скрытая услуга
+
                            "shortDescriptions": [{
−
**** '''IsNotCalculated''' – признак не рассчитываемая услуга
+
                                    "code": "RU",
−
**** '''BeginDateTimeString''' – дата и время начала услуги
+
                                    "value": "10 кг (55x40x25 см)"
−
**** '''EndDateTimeString''' – дата и время окончания услуги
+
                                }
−
**** '''TemplateId''' – шаблон услуги
+
                            ]
−
**** '''Cost''' – цена услуги
+
                        }, {
−
**** '''ByPax''' – цена за человека
+
                            "code": "baggage",
−
**** '''QuotaStatus''' – объект статус квотирования
+
                            "priority": 3,
−
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)
+
                            "needToPay": "Charge",
−
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
                            "shortDescriptions": [{
−
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
                                    "code": "RU",
−
**** '''Index''' – индекс услуги
+
                                    "value": "платный"
−
**** '''IsRoute''' – признак маршрутная услуга
+
                                }
−
**** '''ServiceTemplateIndex''' – индекс шаблона услуги
+
                            ]
−
**** '''RemoteId''' – информация об услуге в удаленной системе
+
                        }, {
−
**** '''IsCommission''' – признак, комиссионная ли услуга
+
                            "code": "exchangeable",
−
**** '''BaseFlightsParams''' – параметры рассчитанных авиаперелетов
+
                            "priority": 4,
−
***** '''CityArrival''' – ключ города прибытия прямого перелета
+
                            "needToPay": "Charge",
−
***** '''FlightCode''' – ключ прямого авиаперелета
+
                            "shortDescriptions": [{
−
***** '''TariffKey''' – ключ тарифа прямого авиаперелета
+
                                    "code": "RU",
−
***** '''PartnerId''' – ключ партнера прямого авиаперелета
+
                                    "value": "Обмен разрешен со сбором"
−
***** '''CityArrival''' – ключ города прибытия обратного перелета
+
                                }
−
***** '''FlightCode''' – ключ обратного авиаперелета
+
                            ]
−
***** '''TariffKey''' – ключ тарифа обратного авиаперелета
+
                        }, {
−
***** '''PartnerId''' – ключ партнера обратного авиаперелета
+
                            "code": "refundable",
−
*** '''TouristNumbersList''' – массив туристов, привязанных к услуге
+
                            "priority": 5,
−
** '''Tourists''' – массив туристов
+
                            "needToPay": "NotAvailable",
−
*** '''IsMain''' – главный турист
+
                            "shortDescriptions": [{
−
*** '''Number''' – порядковый номер туриста
+
                                    "code": "RU",
−
*** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
+
                                    "value": "Возврат запрещен"
−
*** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
+
                                }
−
*** '''FirstName''' – имя (лат)
+
                            ]
−
*** '''LastName''' – фамилия (лат)
+
                        }
−
*** '''Patronymic''' – отчество (лат)
+
                    ]
−
*** '''FirstNameRus''' – имя (рус)
+
                }
−
*** '''LastNameRus''' – фамилия (рус)
+
            ],
−
*** '''PatronymicRus''' – отчество (рус)
+
            "price": 147,
−
*** '''InternationalPassportSeries''' – серия загранпаспорта
+
            "deltaPrice": 0,
−
*** '''InternationalPassportNumber''' – номер загранпаспорта
+
            "timeLimit": "22.01.2021 4:08:00",
−
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта
+
            "segments": [{
−
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке
+
                    "depAirportCode": "VKO",
−
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта
+
                    "depCityCode": "MOW",
−
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке
+
                    "arrAirportCode": "VIE",
−
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
+
                    "arrCityCode": "VIE"
−
*** '''PassportSeries''' – серия паспорта
+
                }
−
*** '''PassportNumber''' – номер паспорта
+
            ]
−
*** '''PassportDateOfIssue''' – дата выдачи паспорта
+
        }
−
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке
+
    ],
−
*** '''PassportByWhom''' – кем выдан паспорт
+
    "isDone": true
−
*** '''Citizenship''' – название страны
+
}
−
*** '''Phone''' – телефон
+
]
−
*** '''Email''' – e-mail
+
</syntaxhighlight>
−
*** '''BirthDay''' – дата рождения
+
</TD></TR></TABLE>
−
*** '''BirthDayString''' – дата рождения в строковом формате
+
</div></div><br />
−
*** '''BirthPlace''' – место рождения
+
 
−
*** '''CitizenID''' – гражданство
+
===Загрузка филиалов (Branches) начиная с релиза 15.3===
−
*** '''Age''' – количество полных лет на момент окончания тура
+
Метод производит выгрузку филиалов бронирования.
−
** '''Day''' – день (перевод)
+
* Формат запроса:
−
** '''Day2''' – дня (перевод)
+
** GET .../TourSearchOwin/Branches?
−
** '''Days''' – дней (перевод)
+
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
−
** '''Night''' – ночь (перевод)
+
** '''ids''' – массив ключей филиалов
−
** '''Night2''' – ночи (перевод)
+
** '''cityKey''' – фильтр по городу филиала (если 0 или не задан, то выбираются все филиалы)
−
** '''Nights''' – ночей (перевод)
+
 
−
** '''adultsCountOverServiceLimit''' – Количество взрослых туристов превышает лимит услуги (перевод)
 
−
** '''at''' – на (перевод)
 
−
** '''incorrectChildrenInf''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод)  
 
−
 
 
 
* Возвращаемый результат:
 
* Возвращаемый результат:
−
** '''IsValid''' – признак валидности путевки
+
** '''Key''' – ключ филиала (ключ партнера)
−
** '''ErrorMessage''' – сообщение об ошибке, если есть
+
** '''Value''' – название филиала (название партнера)
−
** '''CalculatedReservation''' – объект рассчитанной путевки
+
 
−
*** '''TourKey''' – ключ тура
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
−
*** '''BeginDate''' – дата начала тура
+
<div class="mw-collapsible-content">
−
*** '''Duration''' – продолжительность путевки в днях
+
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
*** '''Currency''' – код валюты тура
+
Вызов метода Branches
−
*** '''CalculatedServicesPrice''' – сумма обязательных услуг, входящих в состав тура
+
<syntaxhighlight lang="java" enclose="div">
−
*** '''ChangedPrice''' – сумма, на которую изменилась итоговая стоимость '''TotalPrice''' в результате добавления обязательных и дополнительных услуг
+
GET http://localhost:9000/TourSearchOwin/Branches?
−
*** '''Price''' – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в валюте тура)
+
</syntaxhighlight>
−
*** '''TotalPrice''' – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в валюте тура)
+
Возвращаемый результат метода Branches (в формате JSON)
−
*** '''IsDiscountIsPercent''' – признак, в процентах ли дается партнерская комиссия или в y.e.
+
<syntaxhighlight lang="java" enclose="div">
−
*** '''NationalChangedPrice''' – сумма, на которую изменилась итоговая стоимость '''TotalPrice''' в результате добавления обязательных и дополнительных услуг (в национальной валюте)
+
[{
−
*** '''NationalTotalDiscount''' – партнерская комиссия агентству (в национальной валюте)
+
"Key": 12848,
−
*** '''NationalTotalPrice''' – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в национальной валюте)
+
"Value": "Филиал 1"
−
*** '''NatinoalCalculatedServicesPrice''' – сумма обязательных услуг, входящих в состав тура (в национальной валюте) 
+
},
−
*** '''NationalPrice''' – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в национальной валюте)
+
{
−
*** '''Discount''' – партнерская комиссия агентству (в процентах или y.e.)
+
"Key": 12849,
−
*** '''TotalDiscount''' – партнерская комиссия агентству (в валюте тура)
+
"Value": "Филиал 2"
−
*** '''ServiceTourists''' – массив услуг, входящих в тур
+
},
−
**** '''ServiceType''' – тип услуги
+
{
−
**** '''Day''' – день предоставления
+
"Key": 12850,
−
**** '''DurationInNight''' – продолжительность в ночах
+
"Value": "Филиал 3"
−
**** '''Time''' – время начала услуги
+
}]
−
**** '''Name''' – полное описание услуги
+
</syntaxhighlight>
−
**** '''TouristCount''' – количество туристов на услуге
+
</TD></TR></TABLE>
−
**** '''Attributes''' – битовая маска атрибутов
+
</div></div><br />
−
**** '''Type''' – тип услуги (основная/дополнительная)
+
 
−
**** '''Brutto''' – цена брутто
+
 
−
**** '''NationalBrutto''' – цена брутто в национальной валюте
+
===Загрузка ведущих менеджеров (Users) начиная с релиза 15.3===
−
**** '''TotalBrutto''' – итоговое брутто
+
Метод производит выгрузку ведущих менеджеров.
−
** '''TourName''' – название тура
+
* Формат запроса:
−
** '''BookingConditions''' – разметка условия бронирования
+
** GET .../TourSearchOwin/Users?
−
** '''EndDate''' – дата окончания тура
+
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
−
** '''DurationInNights''' – продолжительность тура в ночах
+
** '''ids''' – массив ключей ведущих менеджеров
−
** '''NationalCurrency''' – код национальной валюты
+
** '''branchKey''' – ключ филиала бронирования, к которому они привязаны
 +
 
 +
* Возвращаемый результат:
 +
** '''Key''' – ключ ведущего менеджера
 +
** '''Value''' – полное имя ведущего менеджера
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
Вызов метода CalculateReservation
+
Вызов метода Users
 +
<syntaxhighlight lang="java" enclose="div">
 +
GET http://localhost:9000/TourSearchOwin/Users?
 +
</syntaxhighlight>
 +
Возвращаемый результат метода Users (в формате JSON)
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
−
POST http://localhost:9000/TourSearchOwin/CalculateReservation? HTTP/1.1
+
[{
−
Content-Type: application/json
+
"Key": 1532,
−
 
+
"Value": "Иванов И."
 +
},
 
{
 
{
−
"tourProgramId": 100003404,
+
"Key": 12849,
−
"beginDate": "2018-04-16T00:00:00",
+
"Value": "Петров П."
−
"duration": 8,
+
}]
−
"currency": "EU",
+
</syntaxhighlight>
−
"initialPrice": {
+
</TD></TR></TABLE>
−
"price": 122,
+
</div></div><br />
−
"currency": "EU"
+
 
−
},
+
 
−
"services": [{
+
===Расчет путевки (CalculateReservation)===
−
"Service": {
+
Метод производит расчет стоимости путевки.
−
"ServiceType": 3,
+
* Формат запроса:
−
"Code": 707,
+
** POST .../TourSearchOwin/CalculateReservation?nodeId=2147483647
−
"SubCode1": 10468,
+
, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
−
"SubCode2": 4,
+
 
−
"Packet": 779,
+
* Принимаемые параметры headers ( '''*''' – обязательный):
−
"Partner": 12667,
+
** '''Content-Type *''' – application/json
−
"Day": 1,
+
 
−
"DurationInNight": 7,
+
* Принимаемые параметры POST запроса:
−
"City": 35,
+
** '''TourProgramId *''' – ключ турпрограммы
−
"Country": 90,
+
** '''BeginDate *''' – дата начала тура
−
"Attributes": 0,
+
** '''Duration *''' – продолжительность тура
−
"IsRemovable": false,
+
** '''Currency *''' – код валюты
−
"Type": 1,
+
** '''initialPrice *''' – объект изначальная цена
−
"IsHooded": false,
+
*** '''price *''' – цена
−
"IsNotCalculated": false,
+
*** '''currency *''' – код валюты
−
"BeginDateTimeString": "2018-04-16T11:59:00",
+
** '''Services *''' – массив услуг
−
"EndDateTimeString": "2018-04-23T11:59:00",
+
*** '''Service *''' – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
−
"TemplateId": 1,
+
**** '''ServiceType *''' – тип услуги (поле ''sv_key'' из таблицы ''service'')
−
"Cost": 114,
+
**** '''Code *''' – код услуги
−
"ByPax": false,
+
**** '''SubCode1 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] услуги
−
"QuotaStatus": {
+
**** '''SubCode2 *''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] услуги
−
"PlacesStatus": 4,
+
**** '''Packet *''' – ключ пакета услуги
−
"FreePlaces": 0,
+
**** '''Partner *''' – ключ партнера услуги
−
"IsFewPlaces": false
+
**** '''Day *''' – день предоставления услуги
−
},
+
**** '''DurationInNight *''' – продолжительность услуги в ночах
−
"Index": 1,
+
**** '''City *''' – ключ города
−
"IsRoute": true,
+
**** '''Country *''' – страна услуги
−
"ServiceTemplateIndex": 1,
+
**** '''Attributes *''' – битовая маска атрибутов услуг (Значение по умолчанию 0. Дальше в зависимости от признака услуги, может принимать значениz:
−
"RemoteId": null,
+
None              = 0,если услуга удаляемая, эта настройка находится в программе туров,</br>
−
"IsCommission": true,
+
Delete            = 1,</br>
−
"BaseFlightsParams": [{
+
CodeEdit          = 2,</br>
−
"CityArrival": 35,
+
SubCode1Edit      = 4,</br>
−
"FlightCode": 882,
+
CityEdit          = 8,</br>
−
"TariffKey": 67,
+
PartnerEdit      = 16,</br>
−
"PartnerId": 12668
+
BadCheck          = 32,</br>
−
},
+
Invisible        = 64, отображаемая</br>
−
{
+
DurationEdit      = 128,</br>
−
"CityArrival": 1,
+
FullEdit          = Delete | CodeEdit | SubCode1Edit | SubCode2Edit | CityEdit | PartnerEdit | DurationEdit,</br>
−
"FlightCode": 774,
+
Host              = 256,</br>
−
"TariffKey": 67,
+
HostChangeCode2  = Host | 512,</br>
−
"PartnerId": 10760
+
HostChangeCode1  = Host | 1024,</br>
−
}]
+
HostChangeCode    = Host | 2048,</br>
−
},
+
HostChangePartner = Host | 4096,</br>
−
"TouristNumbersList": [1,
+
HostChangePacket  = Host | 8192,</br>
−
2]
+
Depended          = 16384,</br>
 +
DependedCode2    = Depended | 512,</br>
 +
DependedCode1    = Depended | 1024,</br>
 +
DependedCode      = Depended | 2048,</br>
 +
DependedCity      = Depended | 4096,</br>
 +
DependedCountry  = Depended | 8192,</br>
 +
FullDepended      = Depended | DependedCode2 | DependedCode1 | DependedCode | DependedCity | DependedCountry,</br>
 +
NotCalculate      = 32768,не рассчитываемая,</br>
 +
SubCode2Edit      = 65536,</br>
 +
GDSService        = 131072, от внешней системы)</br>
 +
**** ''' *IsRemovable''' – (не обрабатывается)
 +
**** ''' *Type''' – тип услуги в путевке. Может принимать значения:
 +
None (0) – не установлено,</br>
 +
Base (1) – базовая услуга. Основные услуги в корзине, проживание, перелет.</br>
 +
Optional (2) – Дополнительная услуга,</br>
 +
NYDinner (4) – Новогодний ужин,</br>
 +
FlightAdditionalPayment (8) – Доплата на перелет,</br>
 +
TourWebDifference (16) – Разница в СПО,</br>
 +
AddedByCalculator (32) – Добавленная при рассчете путевки,</br>
 +
AddedByReservationBuilder (64) – добавленная услуга при формировании состава путевки,</br>
 +
BaseChanged (128) – базовая измененная услуга,</br>
 +
HotelAdditionalPayment (256) – доплата на отель</br>
 +
**** '''IsHooded *''' – признак скрытая услуга
 +
**** '''IsNotCalculated *''' – признак не рассчитываемая услуга
 +
**** '''BeginDateTimeString *''' – дата и время начала услуги
 +
**** '''EndDateTimeString *''' – дата и время окончания услуги
 +
**** '''TemplateId *''' – порядок расположения шаблона услуги в внутри самой услуги в программе тура
 +
[[Файл: Ea_491.png|600px|индекс шаблона услуги]]</br>
 +
**** '''Cost *''' – цена услуги
 +
**** '''ByPax *''' – цена за человека
 +
**** '''QuotaStatus *''' – объект статус квотирования
 +
***** '''PlacesStatus *''' – статус по квотам (есть места / нет мест / под запрос)
 +
***** '''FreePlaces *''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
 +
***** '''IsFewPlaces *''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
 +
**** '''Index *''' – индекс услуги
 +
**** '''IsRoute *''' – признак маршрутная услуга (Перелет, автобусный переезд, жд переезд, трансфер, экскурсия)
 +
**** '''ServiceTemplateIndex *''' – индекс шаблона услуги (Порядок расположения услуги в программе тура. Не отображается в программе туров,это просто порядковый номер услуги в путевке)
 +
[[Файл: Ea_490.png|600px|индекс шаблона услуги]]</br>
 +
**** '''RemoteId *''' – информация об услуге во внешней системе
 +
**** '''IsCommission *''' – признак, комиссионная ли услуга
 +
**** '''BaseFlightsParams *''' – параметры рассчитанных авиаперелетов ''Обязательный параметр, если в путевке есть услуга авиаперелета''
 +
***** '''CityArrival *''' – ключ города прибытия прямого перелета
 +
***** '''FlightCode *''' – ключ прямого авиаперелета
 +
***** '''TariffKey *''' – ключ тарифа прямого авиаперелета
 +
***** '''PartnerId *''' – ключ партнера прямого авиаперелета
 +
***** '''CityArrival *''' – ключ города прибытия обратного перелета
 +
***** '''FlightCode *''' – ключ обратного авиаперелета
 +
***** '''TariffKey *''' – ключ тарифа обратного авиаперелета
 +
***** '''PartnerId *''' – ключ партнера обратного авиаперелета
 +
*** '''TouristNumbersList *''' – массив туристов, привязанных к услуге
 +
** '''Tourists *''' – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка настройки отображения полей по туристам (TouristDataSettings)|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 *''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) ''Может быть с пустым значением''
 +
** '''DiscountCardId *''' – ID основания для скидки (дисконтной карты) полученное в методе [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Проверка основания для скидки (CheckCauseDiscount)|CheckCauseDiscount]] ''Может быть с пустым значением''
 +
** '''PromocodeId *''' – ID промокода полученное в методе [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Проверка промокода (CheckPromocode)|CheckPromocode]] ''Может быть с пустым значением''
 +
 
 +
 
 +
* Возвращаемый результат:
 +
** '''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''' – код национальной валюты
 +
** '''PromoDiscount''' – числовое значение скидки полученное после ввода промокода, либо дисконтной карты
 +
** '''PromoTotalDiscount''' – значение скидки в валюте тура
 +
** '''PromoNationalDiscount''' – значение скидки в национальной валюте
 +
** '''PromoIsDiscountPercent''' – обозначение типа скидки в процентах. Значение может быть:
 +
***'''true''' – скидка по промокоду, либо дисконтной карты предоставляется в процентах
 +
*** '''false''' – скидка по промокоду, либо дисконтной карты предоставляется в фиксированном значении, согласно валюте тура
 +
** '''nodeId''' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
 +
 
 +
 
 +
<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>
 +
Вызов метода CalculateReservation
 +
<syntaxhighlight lang="java" enclose="div">
 +
POST http://localhost:9000/TourSearchOwin/CalculateReservation?nodeId=2147483647 HTTP/1.1
 +
Content-Type: application/json
 +
 
 +
{
 +
"tourProgramId": 100003404,
 +
"beginDate": "2018-04-16T00:00:00",
 +
"duration": 8,
 +
"currency": "EU",
 +
"initialPrice": {
 +
"price": 122,
 +
"currency": "EU"
 +
},
 +
"services": [{
 +
"Service": {
 +
"ServiceType": 3,
 +
"Code": 707,
 +
"SubCode1": 10468,
 +
"SubCode2": 4,
 +
"Packet": 779,
 +
"Partner": 12667,
 +
"Day": 1,
 +
"DurationInNight": 7,
 +
"City": 35,
 +
"Country": 90,
 +
"Attributes": 0,
 +
"IsRemovable": false,
 +
"Type": 1,
 +
"IsHooded": false,
 +
"IsNotCalculated": false,
 +
"BeginDateTimeString": "2018-04-16T11:59:00",
 +
"EndDateTimeString": "2018-04-23T11:59:00",
 +
"TemplateId": 1,
 +
"Cost": 114,
 +
"ByPax": false,
 +
"QuotaStatus": {
 +
"PlacesStatus": 4,
 +
"FreePlaces": 0,
 +
"IsFewPlaces": false
 +
},
 +
"Index": 1,
 +
"IsRoute": true,
 +
"ServiceTemplateIndex": 1,
 +
"RemoteId": null,
 +
"IsCommission": true,
 +
"BaseFlightsParams": [{
 +
"CityArrival": 35,
 +
"FlightCode": 882,
 +
"TariffKey": 67,
 +
"PartnerId": 12668
 +
},
 +
{
 +
"CityArrival": 1,
 +
"FlightCode": 774,
 +
"TariffKey": 67,
 +
"PartnerId": 10760
 +
}]
 +
},
 +
"TouristNumbersList": [1,
 +
2]
 
},
 
},
 
{
 
{
Строка 5340: Строка 6888:
 
"at": "на",
 
"at": "на",
 
"incorrectChildrenInf": "Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание)"
 
"incorrectChildrenInf": "Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание)"
 +
        "PromocodeId":"",
 +
        "DiscountCardId":"95"
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 5364: Строка 6914:
 
"Discount": 0.0,
 
"Discount": 0.0,
 
"TotalDiscount": 0.0,
 
"TotalDiscount": 0.0,
 +
                "PromoDiscount": 50.0,
 +
                "PromoTotalDiscount": 10.0,
 +
                "PromoNationalDiscount": 10.0,
 +
                "PromoIsDiscountPercent": true,
 
"ServiceTourists": [{
 
"ServiceTourists": [{
 
"ServiceType": 1,
 
"ServiceType": 1,
Строка 5415: Строка 6969:
  
 
===Бронирование путевки (CreateReservation)===
 
===Бронирование путевки (CreateReservation)===
−
Метод производит бронирование путевки.
+
Метод производит бронирование путевки.<br />
 +
При бронировании проверяется корректность заполнения обязательных полей туристов (регулируется общими [[Мастер-Тур(15):Программа туров. Настройки#Настройки отображения информации о туристах|настройками]], либо в справочнике [[Мастер-Тур(15):Страны#Настроить информацию о туристах|Страны]]). В случае, если обязательные поля не заполнены, возвращается ошибка с сообщением, бронь не создается.
 +
 
 
* Формат запроса:
 
* Формат запроса:
−
** PUT .../TourSearchOwin/CreateReservation/1?
+
** PUT .../TourSearchOwin/CreateReservation/1?nodeId=2147483647
 +
, где ''nodeId'' – уникальный идентификатор узла в кластере балансировки нагрузки [[Мастер-Тур(15):Балансировщик нагрузки HaProxy|HaProxy]]
  
 
* Принимаемые параметры headers ( '''*''' – обязательный):
 
* Принимаемые параметры headers ( '''*''' – обязательный):
Строка 5424: Строка 6981:
  
 
* Принимаемые параметры PUT запроса:
 
* Принимаемые параметры PUT запроса:
−
** '''TourProgramId''' – ключ турпрограммы
+
** '''TourProgramId *''' – ключ турпрограммы
−
** '''BeginDate''' – дата начала тура
+
** '''BeginDate *''' – дата начала тура (YYYY-MM-DDThh:mm:ss)
−
** '''Duration''' – продолжительность тура
+
** '''Duration *''' – продолжительность тура
−
** '''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''' – битовая маска атрибутов услуг
+
**** '''Attributes *''' – битовая маска атрибутов услуг
−
**** '''IsRemovable''' – (не обрабатывается)
+
**** '''IsRemovable *''' – (не обрабатывается)
−
**** '''Type''' – тип услуги в путевке (базовая дополнительная)
+
**** '''Type *''' – тип услуги в путевке (базовая дополнительная)
−
**** '''IsHooded''' – признак скрытая услуга
+
**** '''IsHooded *''' – признак скрытая услуга
−
**** '''IsNotCalculated''' – признак не рассчитываемая услуга
+
**** '''IsNotCalculated *''' – признак не рассчитываемая услуга
−
**** '''BeginDateTimeString''' – дата и время начала услуги
+
**** '''BeginDateTimeString *''' – дата и время начала услуги
−
**** '''EndDateTimeString''' – дата и время окончания услуги
+
**** '''EndDateTimeString *''' – дата и время окончания услуги
−
**** '''TemplateId''' – шаблон услуги
+
**** '''TemplateId *''' – шаблон услуги
−
**** '''Cost''' – цена услуги
+
**** '''Cost *''' – цена услуги
−
**** '''ByPax''' – цена за человека
+
**** '''ByPax *''' – цена за человека
−
**** '''QuotaStatus''' – объект статус квотирования
+
**** '''QuotaStatus *''' – объект статус квотирования
−
***** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос)  
+
***** '''PlacesStatus *''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)  
−
***** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
+
***** '''FreePlaces *''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''.
−
***** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
+
***** '''IsFewPlaces *''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
−
**** '''Index''' – индекс услуги
+
**** '''Index *''' – индекс услуги
−
**** '''IsRoute''' – признак маршрутная услуга
+
**** '''IsRoute *''' – признак маршрутная услуга
−
**** '''ServiceTemplateIndex''' – индекс шаблона услуги
+
**** '''ServiceTemplateIndex *''' – индекс шаблона услуги
−
**** '''RemoteId''' – информация об услуге в удаленной системе
+
**** '''RemoteId *''' – информация об услуге во внешний системе
−
**** '''IsCommission''' – признак, комиссионная ли услуга
+
**** '''IsCommission *''' – признак, комиссионная ли услуга
−
**** '''BaseFlightsParams''' – параметры рассчитанных авиаперелетов
+
**** '''BaseFlightsParams *''' – параметры рассчитанных авиаперелетов ''Обязательный параметр, если в путевке есть услуга авиаперелета''
−
***** '''CityArrival''' – ключ города прибытия прямого перелета
+
***** '''CityArrival *''' – ключ города прибытия прямого перелета
−
***** '''FlightCode''' – ключ прямого авиаперелета
+
***** '''FlightCode *''' – ключ прямого авиаперелета
−
***** '''TariffKey''' – ключ тарифа прямого авиаперелета
+
***** '''TariffKey *''' – ключ тарифа прямого авиаперелета
−
***** '''PartnerId''' – ключ партнера прямого авиаперелета
+
***** '''PartnerId *''' – ключ партнера прямого авиаперелета
−
***** '''CityArrival''' – ключ города прибытия обратного перелета
+
***** '''CityArrival *''' – ключ города прибытия обратного перелета
−
***** '''FlightCode''' – ключ обратного авиаперелета
+
***** '''FlightCode *''' – ключ обратного авиаперелета
−
***** '''TariffKey''' – ключ тарифа обратного авиаперелета
+
***** '''TariffKey *''' – ключ тарифа обратного авиаперелета
−
***** '''PartnerId''' – ключ партнера обратного авиаперелета
+
***** '''PartnerId *''' – ключ партнера обратного авиаперелета
−
*** '''TouristNumbersList''' – массив туристов, привязанных к услуге
+
*** '''TouristNumbersList *''' – массив туристов, привязанных к услуге
−
** '''Tourists''' – массив туристов
+
** '''Tourists *''' – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка настройки отображения полей по туристам (TouristDataSettings)|TouristDataSettings]] по определенной стране. В каждом объекте есть поле '''IsRequired''', которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
−
*** '''IsMain''' – главный турист
+
*** '''IsMain *''' – главный турист
−
*** '''Number''' – порядковый номер туриста
+
*** '''Number *''' – порядковый номер туриста
−
*** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
+
*** '''AgeType *''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
−
*** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский)
+
*** '''MaleFemaleSex *''' – пол (0 – мужской, 1 – женский)
−
*** '''FirstName''' – имя (лат)
+
*** '''FirstName *''' – имя (лат)
−
*** '''LastName''' – фамилия (лат)
+
*** '''LastName *''' – фамилия (лат)
−
*** '''Patronymic''' – отчество (лат)
+
*** '''Patronymic *''' – отчество (лат)
−
*** '''FirstNameRus''' – имя (рус)
+
*** '''FirstNameRus *''' – имя (рус)
−
*** '''LastNameRus''' – фамилия (рус)
+
*** '''LastNameRus *''' – фамилия (рус)
−
*** '''PatronymicRus''' – отчество (рус)
+
*** '''PatronymicRus *''' – отчество (рус)
−
*** '''InternationalPassportSeries''' – серия загранпаспорта
+
*** '''InternationalPassportSeries *''' – серия загранпаспорта
−
*** '''InternationalPassportNumber''' – номер загранпаспорта
+
*** '''InternationalPassportNumber *''' – номер загранпаспорта
−
*** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта
+
*** '''InternationalPassportDateOfIssue *''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке
+
*** '''InternationalPassportDateOfIssueString *''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
−
*** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта
+
*** '''InternationalPassportDateOfExpiry *''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке
+
*** '''InternationalPassportDateOfExpiryString *''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
−
*** '''internationalPassportByWhom''' – кем выдан загранпаспорт
+
*** '''internationalPassportByWhom *''' – кем выдан загранпаспорт
−
*** '''PassportSeries''' – серия паспорта
+
*** '''PassportSeries *''' – серия паспорта
−
*** '''PassportNumber''' – номер паспорта
+
*** '''PassportNumber *''' – номер паспорта
−
*** '''PassportDateOfIssue''' – дата выдачи паспорта
+
*** '''PassportDateOfIssue *''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
−
*** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке
+
*** '''PassportDateOfIssueString *''' – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
−
*** '''PassportByWhom''' – кем выдан паспорт
+
*** '''PassportByWhom *''' – кем выдан паспорт
−
*** '''Citizenship''' – название страны
+
*** '''Citizenship *''' – название страны
−
*** '''Phone''' – телефон
+
*** '''Phone *''' – телефон
−
*** '''Email''' – e-mail
+
*** '''Email *''' – e-mail
−
*** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
+
*** '''BirthDay *''' – дата рождения (YYYY-MM-DDThh:mm:ssz)
−
*** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY)
+
*** '''BirthDayString *''' – дата рождения в строковом формате (DD.MM.YYYY)
−
*** '''BirthPlace''' – место рождения
+
*** '''BirthPlace *''' – место рождения
−
*** '''CitizenID''' – ID туриста (задается в карточке постоянного клиента)
+
*** '''CitizenID *''' – ID туриста (задается в карточке постоянного клиента)
−
*** '''Age''' – количество полных лет на момент окончания тура
+
*** '''Age *''' – количество полных лет на момент окончания тура
−
** '''BranchId''' – ключ филиала бронирования (начиная с релиза 15.3). Если не передан, то филиал бронирования берется из менеджера по умолчанию либо из пользователя, создавшего тур.
+
** '''BranchId *''' – ключ филиала бронирования (начиная с релиза 15.3). Если не передан, то филиал бронирования берется из менеджера по умолчанию либо из пользователя, создавшего тур. ''Может быть с пустым значением''
−
** '''OwnerId''' – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура.
+
** '''OwnerId *''' – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура. ''Может быть с пустым значением''
−
** '''Day''' – день (перевод)
+
** '''Day *''' – день (перевод) ''Может быть с пустым значением''
−
** '''Day2''' – дня (перевод)
+
** '''Day2 *''' – дня (перевод) ''Может быть с пустым значением''
−
** '''Days''' – дней (перевод)
+
** '''Days *''' – дней (перевод) ''Может быть с пустым значением''
−
** '''Night''' – ночь (перевод)
+
** '''Night *''' – ночь (перевод) ''Может быть с пустым значением''
−
** '''Night2''' – ночи (перевод)
+
** '''Night2 *''' – ночи (перевод) ''Может быть с пустым значением''
−
** '''Nights''' – ночей (перевод)
+
** '''Nights *''' – ночей (перевод) ''Может быть с пустым значением''
−
** '''adultsCountOverServiceLimit''' – Количество взрослых туристов превышает лимит услуги (перевод)
+
** '''adultsCountOverServiceLimit *''' – Количество взрослых туристов превышает лимит услуги (перевод) ''Может быть с пустым значением''
−
** '''incorrectChildrenInf''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод)  
+
** '''incorrectChildrenInf *''' – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) ''Может быть с пустым значением''
−
 
+
** '''OrderInfoUrl''' – Адрес окна путевки в личном кабинете
−
* Возвращаемый результат:
+
** '''DogovorComment''' – Комментарий к путевке (сохраняется как сообщения в истории путевки) ''Может быть с пустым значением''
−
** '''Reservation''' – объект путевки
+
** '''DiscountCardId ''' – ID основания для скидки (дисконтной карты) полученное в методе [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Проверка основания для скидки (CheckCauseDiscount)|CheckCauseDiscount]] ''Может быть с пустым значением''
−
*** '''$id''' – внутренний идентификатор для установки связей между сущностями,
+
** '''PromocodeId ''' – ID промокода полученное в методе [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Проверка промокода (CheckPromocode)|CheckPromocode]] ''Может быть с пустым значением''
 +
 
 +
 
 +
 
 +
* Возвращаемый результат:
 +
** '''Reservation''' – объект путевки
 +
*** '''$id''' – внутренний идентификатор для установки связей между сущностями,
 
*** '''Code''' – код путевки
 
*** '''Code''' – код путевки
 
*** '''TurDate''' – дата заезда
 
*** '''TurDate''' – дата заезда
Строка 5531: Строка 7094:
 
*** '''Discount''' – величина скидки на одного человека
 
*** '''Discount''' – величина скидки на одного человека
 
*** '''DiscountSum''' – абсолютная величина скидки
 
*** '''DiscountSum''' – абсолютная величина скидки
−
*** '''SORCode''' – ключ статус путевки
+
*** '''SORCode''' – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
 
*** '''CrDate''' – дата и время создания путевки
 
*** '''CrDate''' – дата и время создания путевки
 
*** '''Rate''' – код валюты путевки
 
*** '''Rate''' – код валюты путевки
Строка 5584: Строка 7147:
 
**** '''SubCode2''' – ключ доп.описания 2 услуги
 
**** '''SubCode2''' – ключ доп.описания 2 услуги
 
**** '''Men''' – количество человек, пользующихся услугой по путевке
 
**** '''Men''' – количество человек, пользующихся услугой по путевке
−
**** '''Days''' – количество дней услуги
+
**** '''Days''' – количество дней услуги (для услуги Отель ("SVKey": 3) количество ночей услуги)
 
**** '''CNKey''' – ключ страны услуги
 
**** '''CNKey''' – ключ страны услуги
 
**** '''CTKey''' – ключ города услуги
 
**** '''CTKey''' – ключ города услуги
Строка 5594: Строка 7157:
 
**** '''Control''' – ключ статуса услуги (ссылка на таблицу Controls),
 
**** '''Control''' – ключ статуса услуги (ссылка на таблицу Controls),
 
**** '''Attribute''' – атрибут услуги
 
**** '''Attribute''' – атрибут услуги
−
**** '''DateBeg''' – дата начала действия услуги
+
**** '''DateBeg''' – дата начала действия услуги в днях (для отеля - в ночах)
−
**** '''DateEnd''' – дата окончания действия услуги
+
**** '''DateEnd''' – дата окончания действия услуги в днях (для отеля - в ночах)
 
**** '''Discount''' – размер скидки по услуге
 
**** '''Discount''' – размер скидки по услуге
 
**** '''Comment''' – комментарий к услуге
 
**** '''Comment''' – комментарий к услуге
Строка 5682: Строка 7245:
 
Вызов метода CreateReservation
 
Вызов метода CreateReservation
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
−
PUT http://localhost:9000/TourSearchOwin/CreateReservation/1? HTTP/1.1
+
PUT http://localhost:9000/TourSearchOwin/CreateReservation/1?nodeId=2147483647 HTTP/1.1
 
Content-Type: application/json
 
Content-Type: application/json
 
Authorization: Bearer AQAAANCMnd8BFdERjHoAwE_Cl-sBAAAAdsCC8X7m9E-2bg0-uS0VfgAAAAAAAAADZgAAwAAAA-
 
Authorization: Bearer AQAAANCMnd8BFdERjHoAwE_Cl-sBAAAAdsCC8X7m9E-2bg0-uS0VfgAAAAAAAAADZgAAwAAAA-
Строка 5858: Строка 7421:
 
             "Phone": "",
 
             "Phone": "",
 
             "Email": "",
 
             "Email": "",
−
             "BirthDay": "1979-12-31T21:00:00.000Z",
+
             "BirthDay": "1980-01-01T00:00:00.000Z",
 
             "BirthDayString": "01.01.1980",
 
             "BirthDayString": "01.01.1980",
 
             "BirthPlace": "Москва",
 
             "BirthPlace": "Москва",
Строка 5889: Строка 7452:
 
             "Phone": "",
 
             "Phone": "",
 
             "Email": "",
 
             "Email": "",
−
             "BirthDay": "1980-12-31T21:00:00.000Z",
+
             "BirthDay": "1981-01-01T00:00:00.000Z",
 
             "BirthDayString": "01.01.1981",
 
             "BirthDayString": "01.01.1981",
 
             "BirthPlace": "Москва",
 
             "BirthPlace": "Москва",
Строка 5906: Строка 7469:
 
     "Nights": "ночей",
 
     "Nights": "ночей",
 
     "adultsCountOverServiceLimit": "Количество взрослых туристов превышает лимит услуги",
 
     "adultsCountOverServiceLimit": "Количество взрослых туристов превышает лимит услуги",
−
     "incorrectChildrenInf": "Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание)"
+
     "incorrectChildrenInf": "Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание)",
 +
    "OrderInfoUrl": "http://localhost/MasterWeb/OrderInfo.aspx",
 +
    "DogovorComment": ""
 +
    "PromocodeId":"301",
 +
    "DiscountCardId":""
 +
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
Строка 6326: Строка 7894:
 
</div></div><br />
 
</div></div><br />
  
−
===Выгрузка информации о путевке (GetReservation)===
+
===Бронирование путевки с упрощенными входными параметрами (CreateReservationExternalSystem)===
−
Метод выводит информацию о бронированной путевке.
+
Метод производит бронирование путевки с упрощенными входными параметрами. <br />
 +
При бронировании проверяется корректность заполнения обязательных полей туристов. В случае, если обязательные поля не заполнены, возвращается ошибка с сообщением, бронь не создается.
 +
Данный метод разработан индивидуально для одного из клиентов. В обычном режиме нужно пользоваться всегда методом [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Бронирование путевки (CreateReservation)|Бронирование путевки (CreateReservation)]]
  
−
* Формат запроса:
+
*Формат запроса:
−
** GET .../TourSearchOwin/GetReservation?
+
** PUT .../TourSearchOwin/CreateReservationExternalSystem/1?
  
−
* Принимаемые параметры headers ( '''*''' – обязательный):
+
*Принимаемые параметры headers ('''*''' – обязательный):
 
** '''Content-Type *''' – application/json
 
** '''Content-Type *''' – application/json
−
** '''Authorization *''' – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)  
+
** '''Authorization *''' – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
 +
 
 +
*Принимаемые параметры PUT запроса:
 +
** '''BeginDate *''' – дата начала тура (YYYY-MM-DDThh:mm)
 +
** '''Duration *''' – продолжительность тура в днях
 +
** '''Currency *''' – код валюты
 +
** '''TourProgramId''' – идентификатор турпрограммы (необязательный, по умолчанию 0)
 +
** '''Services *''' – массив услуг, в данном случае будет содержать только услугу отель
 +
*** '''Code *''' – идентификатор отеля во внешней системе, сравниваются с промежуточной базой данных статического адаптера [[Megatec Integration Service:Индивидуальные особенности адаптеров TravelLine (Россия)|MIS TravelLine (Россия)]]
 +
*** '''Cost *''' – стоимость проживания за весь период
 +
*** '''Packet *''' – идентификатор пакета, сравниваются с промежуточной базой данных статического адаптера [[Megatec Integration Service:Индивидуальные особенности адаптеров TravelLine (Россия)|MIS TravelLine (Россия)]]
 +
*** '''SubCode1 *''' – идентификатор типа номера, сравниваются с промежуточной базой данных статического адаптера [[Megatec Integration Service:Индивидуальные особенности адаптеров TravelLine (Россия)|MIS TravelLine (Россия)]]
 +
** '''Tourists *''' – массив туристов
 +
*** '''FirstName *''' – имя туриста
 +
*** '''LastName *''' – фамилия туриста
 +
*** '''Patronymic *''' – отчество туриста
 +
*** '''MaleFemaleSex *''' – пол (0 – мужской, 1 – женский)
 +
*** '''AgeType *''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
 +
*** '''Age *''' – количество полных лет на момент окончания тура
 +
*** '''Phone *''' – телефон (обязателен для первого туриста)
 +
*** '''Email *''' – e-mail (обязателен для первого туриста)
 +
** '''DogovorComment *''' – комментарий к путевке (ограничение 254 символа, при превышении разбивается на части)
 +
[[Файл:Am 063.png|left]]<br />
 +
1. В случае, если в теле запроса указываются ID несинхронизированных отелей, пакета, типа номера, то создаются фиктивные данные, которые необходимо изменить в услуге экрана ''Путевка'' (пример: Отель – ApiHotel, пакет – ApiPacket, тип номера – ApiRoom(ApiRoomCategory),ApiAccmdmen)<br />
 +
2. Тип питания всегда будет создаваться фиктивный и его необходимо изменить в услуге экрана ''Путевка'' (пример: Тип питания – ApiPansion)<br /><br /><br />
 +
*Возвращаемый результат:
 +
** '''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''' – атрибут результата бронирования
 +
 
 +
 
 +
<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px">Пример запроса
 +
<div class="mw-collapsible-content">
 +
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 +
Вызов метода CreateReservationExternalSystem
 +
<syntaxhighlight lang="java" enclose="div">
 +
PUT http://localhost:9000/TourSearchOwin/CreateReservationExternalSystem/1?
 +
Content-Type: application/json
 +
Authorization: Bearer AQAAANCMnd8BFdERjHoAwE_Cl-sBAAAAObjhnb1q7EOpYmBFLH9T4AAAAAACAAAAAAAQZgAAAAEAACAAAACi2OgeCgKM2UVjnd-_y7WK9Tp90D7uiyDzOpQNy2PUrQAAAAAOgAAAAAIAACAAAABBwMz7N-
 +
lZMFS0R9BqYXrNkVEL0ORSd2IpZ95J78cBHDABAABoZQCpqlwdHPASxLfQj-sRBv1S-kkGRC3g6wMlF_UjzI4PGIv_x5SdDwdIqoveXSyxshY88VidzcMRZjk2HJFjUJrcG_e8FfKpzUZUuFvq1dASzSm83JNgdqNaPjnjqSpffBEfD-zA1L77wMgN9_d70lVTh8PlxXkx_fxQI3D0Dcymqz-Q7ymsWM9HMDlmQ2BllmjBisc8UaYLT3VvmAvI1uDL08FFT1Rx9LFMi2B36OGZQgUoona0KuY48x5Xhbx5yeLAKdvqqEDViG35z7H8_gVU8T5TR08PDJvxvAe24lV1rBGidGNZqPL4meuSrh1hUl9j2vmFfhdGIyBhz7B9Z1Q2iDNfL6j-YfNEcuj8SGTMm5pfObAdcjH5CKI4T-
 +
QWcvE6HUfRs0UzAf2eF1bXQAAAAGMNV8S-M1ckRYpUCIVNPCLWi4g9HR0oIIJIRCMpu3hAJPM1xlNSaaYabu-il-PwoOthHujA2PZXtXj9-o3wpEA
 +
{
 +
    "BeginDate": "2024-12-16T14:00",
 +
    "Duration": 4,
 +
    "Currency": "рб",
 +
    "TourProgramId": 0,
 +
    "Services": [
 +
        {
 +
            "Code": "8746",
 +
            "Cost": 9900,
 +
            "Packet": "359679",
 +
            "SubCode1": "356847"
 +
        }
 +
    ],
 +
    "Tourists": [
 +
        {
 +
            "FirstName": "Иван",
 +
            "LastName": "Иванов",
 +
            "Patronymic": "Иванович",
 +
            "MaleFemaleSex": 0,
 +
            "AgeType": 0,
 +
            "Age": 18,
 +
            "Phone": "79876543232",
 +
            "Email": "emailqwerty123@example.com"
 +
        },
 +
        {
 +
            "FirstName": "Петр",
 +
            "LastName": "Петров",
 +
            "Patronymic": "Петрович",
 +
            "MaleFemaleSex": 0,
 +
            "AgeType": 0,
 +
            "Age": 18
 +
        }
 +
    ],
 +
    "DogovorComment": "Это тестовая путевка. Клиент указывает детали отеля и размещения."
 +
}
 +
</syntaxhighlight>
 +
</TD></TR></TABLE>
 +
</div></div><br />
  
−
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
 
−
** '''dgCode *''' – номер путевки:
 
−
 
−
* Возвращаемый результат:
 
−
** '''$id''' – внутренний идентификатор для установки связей между сущностями,
 
−
** '''Code''' – код путевки
 
−
** '''TurDate''' – дата заезда
 
−
** '''TRKey''' – ключ тура
 
−
** '''CNKey''' – ключ страны
 
−
** '''CTKey''' – ключ города
 
−
** '''NMen''' – количество туристов по путевке
 
−
** '''Price''' – стоимость путевки за вычетом скидки (комиссии)
 
−
** '''Payed''' – оплаченная сумма по путевке
 
−
** '''NDay''' – продолжительность тура в днях
 
−
** '''MainMan''' – ФИО лица, заключившего договор
 
−
** '''MainManPhone''' – номер телефона лица, заключившего договор
 
−
** '''MainManAddress''' – адрес лица, заключившего договор
 
−
** '''MainManPassport''' – паспортные данные лица, заключившего договор
 
−
** '''PartnerKey''' – ключ партнера, оформившего договор
 
−
** '''Operator''' – ФИО создателя договора
 
−
** '''Discount''' – величина скидки на одного человека
 
−
** '''DiscountSum''' – абсолютная величина скидки
 
−
** '''SORCode''' – ключ статус путевки
 
−
** '''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''
 
  
−
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
+
<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px">Пример ответа
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
 
<TABLE STYLE="border: 0.1em dashed #2F6FAB; margin: 8px; padding: 8px" WIDTH="99%"><TR><TD>
−
Вызов метода CostOfferDescriptions
+
Возвращаемый результат метода CreateReservationExternalSystem (в формате JSON)
−
<syntaxhighlight lang="java" enclose="div">
 
−
GET http://localhost:9000/TourSearchOwin/GetReservation?dgCode=AU10101003
 
−
Content-Type: application/json
 
−
Authorization: Bearer AQAAANCMnd8BFdERjHoAwE_Cl-sBAAAAdsCC8X7m9E-2bg0-uS0VfgAAAAAAAAADZgAAwAAAA-
 
−
EqAAAAAASAAACgAAAAEAAAAO4S-VrqBhQuhqliqrAKKfIgAQAAn-gfgP-rYjk-Krr1Ck2A-IGCw6FBhamUOzFxgTtk1hR-
 
−
GLMryFIH8VK5GmHdHubZWj4S7XcazGL1Kn5-VlbiYdW2ZVWpYlk638aV-XS2kpZ9YrKgViiM_x8RH5TPo4-
 
−
9LhE7V-SjiB_CP_qs58DRKcyohq3Tz9QaiFgH1Ko7O2XKjTBG7SHyQPDPYjaqg9kDxmzq0UcIT6Fm4YkDxmm9-
 
−
CW7u3cEFWcpiqKOc2VvZFKPPHc07uDOO4w9FXPhpXZwOqrJBxzhbr73RuhzPs_e-hgxKaIlsMaK5b0v5ReAMy1kuY0ebXA
 
−
</syntaxhighlight>
 
−
Возвращаемый результат метода GetReservation (в формате JSON)
 
 
<syntaxhighlight lang="java" enclose="div">
 
<syntaxhighlight lang="java" enclose="div">
 
{
 
{
−
     "$id": 1,
+
     "Reservation": {
−
    "Code": "AU10101003",
+
        "$id": 1,
−
    "TurDate": "2021-01-01T00:00:00",
+
        "Code": "RU27010037",
−
    "TRKey": 100000038,
+
        "TurDate": "2025-01-27T12:00:00",
−
    "CNKey": 90,
+
        "TRKey": 0,
−
    "CTKey": 35,
+
        "CNKey": 460,
−
    "NMen": 2,
+
        "CTKey": 1,
−
    "Price": 877,
+
        "NMen": 2,
−
    "Payed": 0,
+
        "Price": 9900.0,
−
    "NDay": 9,
+
        "Payed": 0.0,
−
    "MainMan": "",
+
        "NDay": 4,
−
    "MainManPhone": "",
+
        "MainMan": "Тестовый Представитель",
−
    "MainManAddress": "",
+
        "MainManPhone": "+79139992222",
−
    "MainManPassport": "",
+
        "MainManAddress": "",
−
    "PartnerKey": 10762,
+
        "MainManPassport": "11111 2222222222222",
−
    "Operator": "Megatec ",
+
        "PartnerKey": 12667,
−
    "Discount": 40,
+
        "Operator": "Allservises A.A.",
−
    "DiscountSum": 80,
+
        "Discount": 17.0,
−
    "SORCode": 3,
+
        "DiscountSum": 0.0,
−
    "CrDate": "2020-10-12T15:02:29.013",
+
        "SORCode": 0,
−
    "Rate": "$",
+
        "CrDate": "2025-01-24T17:26:17.25",
−
    "Advertise": 0,
+
        "Rate": "рб",
−
    "Locked": null,
+
        "Advertise": 0,
−
    "CauseDisc": null,
+
        "Locked": null,
−
    "PPaymentDate": null,
+
        "CauseDisc": 0,
−
    "PaymentDate": "2020-10-14T00:00:00",
+
        "PPaymentDate": null,
−
    "Procent": 1,
+
        "PaymentDate": "2025-01-26T00:00:00",
−
    "TurDateBfrAnnul": null,
+
        "Procent": 1,
−
    "ARKey": 0,
+
        "TurDateBfrAnnul": null,
−
    "Key": 40335,
+
        "ARKey": 0,
−
    "CodePartner": null,
+
        "Key": 54010,
−
    "FilialKey": 1,
+
        "CodePartner": null,
−
    "IsOutDoc": 0,
+
        "FilialKey": 12850,
−
    "Notes": null,
+
        "IsOutDoc": 0,
−
    "DiscSumBfrAnn": null,
+
        "Notes": null,
−
    "PriceBfrAnn": null,
+
        "DiscSumBfrAnn": null,
−
    "RazmerP": 0,
+
        "PriceBfrAnn": null,
−
    "LeadDepartment": 0,
+
        "RazmerP": 10.0,
−
    "MainManEmail": "test@megatec.ru",
+
        "LeadDepartment": 0,
−
    "MainManComment": "",
+
        "MainManEmail": "test@megatec.ru",
−
    "DupUserKey": 6,
+
        "MainManComment": "",
−
    "BTKey": 1,
+
        "DupUserKey": 333,
−
    "ConfirmedDate": null,
+
        "BTKey": 1,
−
    "PrtDogKey": 11,
+
        "ConfirmedDate": null,
−
    "CTDepartureKey": 1,
+
        "PrtDogKey": 1335,
−
    "PDTType": 0,
+
        "CTDepartureKey": 0,
−
    "NationalCurrencyPrice": null,
+
        "PDTType": 0,
−
    "NationalCurrencyDiscountSum": null,
+
        "NationalCurrencyPrice": null,
−
    "NationalCurrencyPayed": null,
+
        "NationalCurrencyDiscountSum": null,
−
    "CurrencyKey": null,
+
        "NationalCurrencyPayed": null,
−
    "CurrencyRate": null,
+
        "CurrencyKey": null,
−
    "ClientKey": null,
+
        "CurrencyRate": null,
−
    "Partner": {
+
        "ClientKey": null,
−
        "$id": 2,
+
        "AgencyPrice": 0.0,
−
        "Key": 10762,
+
        "Partner": {
−
        "FullName": "Агентство",
+
            "$id": 2,
−
        "Name": "Агентство"
+
            "Key": 12667,
−
    },
+
            "FullName": "Партнер-покупатель (полное название)",
−
    "Services": [{
+
            "Name": "Партнер-покупатель122"
−
            "$id": 3,
+
        },
−
            "DGCod": "AU10101003",
+
        "Services": [
−
            "TurDate": "2021-01-01T00:00:00",
+
            {
−
            "Key": 202463,
+
                "$id": 3,
−
            "PaketKey": 209,
+
                "DGCod": "RU27010037",
−
            "TRKey": 100000038,
+
                "TurDate": "2025-01-27T12:00:00",
−
            "SVKey": 1,
+
                "Key": 250570,
−
            "Name": "А_П::Москва/Вена/00444, DME-VIE, 14:00-16:30/C Бизнес класс",
+
                "PaketKey": 2043,
−
            "Day": 1,
+
                "TRKey": 0,
−
            "Code": 570,
+
                "SVKey": 3,
−
            "SubCode1": 67,
+
                "Name": "HOTEL::Москва/ApiHotel-,3 ночи/ApiRoom(ApiRoomCategory),ApiAccmdmen/ApiPansion ApiPansion",
−
            "SubCode2": 1,
+
                "Day": 1,
−
            "Men": 2,
+
                "Code": 341264,
−
            "Days": 0,
+
                "SubCode1": 1552918,
−
            "CNKey": 90,
+
                "SubCode2": 1812,
−
            "CTKey": 35,
+
                "Men": 2,
−
            "PartnerKey": 10760,
+
                "Days": 3,
−
            "Brutto": 162.2,
+
                "CNKey": 460,
−
            "Wait": null,
+
                "CTKey": 1,
−
            "Warning": 0,
+
                "PartnerKey": 0,
−
            "TimeBeg": "1899-01-01T14:00:00",
+
                "Brutto": 9900.0,
−
            "Control": 1,
+
                "Wait": null,
−
            "Attribute": 65695,
+
                "Warning": 0,
−
            "DateBeg": "2021-01-01T00:00:00",
+
                "TimeBeg": "1899-01-01T00:00:00",
−
            "DateEnd": "2021-01-01T00:00:00",
+
                "Control": 1,
−
            "Discount": 14.8,
+
                "Attribute": 65695,
−
            "Comment": null,
+
                "DateBeg": "2025-01-27T00:00:00",
−
            "DGKey": 40335,
+
                "DateEnd": "2025-01-29T00:00:00",
−
            "Blocked": null,
+
                "Discount": 0.0,
−
            "NameLat": "А_П::Москва/Вена/00444, DME-VIE, 14:00-16:30/C Бизнес класс",
+
                "Comment": null,
−
            "Long": 9,
+
                "DGKey": 54010,
−
            "TRFId": 0,
+
                "Blocked": null,
−
            "CreateDate": "2020-10-12T15:02:29.013",
+
                "NameLat": "HOTEL::Москва/ApiHotel-,3 ночи/ApiRoom(ApiRoomCategory),ApiAccmdmen/ApiPansion ApiPansion",
−
            "CalculatePriceDate": "2020-10-12T15:02:29.013",
+
                "Long": 4,
−
            "ShowOrder": 1,
+
                "TRFId": 0,
−
            "Connections": [{
+
                "CreateDate": "2025-01-24T17:26:17.25",
−
                    "$ref": 1
+
                "CalculatePriceDate": "2025-01-24T17:26:17.25",
−
                 }
+
                "ShowOrder": 1,
−
            ]
+
                "Connections": [
−
         }, {
+
                    {
−
            "$id": 4,
+
                        "$ref": 1
−
            "DGCod": "AU10101003",
+
                    }
−
            "TurDate": "2021-01-01T00:00:00",
+
                 ]
−
            "Key": 202462,
+
            }
−
            "PaketKey": 209,
+
        ],
−
            "TRKey": 100000038,
+
         "Turists": [
−
            "SVKey": 3,
+
            {
−
            "Name": "HOTEL::Вена/Albatros-1*,8 ночей/Double(Standart),2 Adult/HB Полупансион",
+
                "$id": 4,
−
            "Day": 1,
+
                "DGCod": "RU27010037",
−
            "Code": 702,
+
                "Key": 120806,
−
            "SubCode1": 1113,
+
                "TurDate": "2025-01-27T12:00:00",
−
            "SubCode2": 2,
+
                "NameRus": "Иванов",
−
            "Men": 2,
+
                "NameLat": "Иванов",
−
            "Days": 8,
+
                "ShortName": "И.И.",
−
            "CNKey": 90,
+
                "Sex": 0,
−
            "CTKey": 35,
+
                "FNameRus": "Иван",
−
            "PartnerKey": 10760,
+
                "FNameLat": "Иван",
−
            "Brutto": 519.6,
+
                "SNameRus": "Иванович",
−
            "Wait": null,
+
                "SNameLat": "Иванович",
−
            "Warning": 0,
+
                "BirthDay": "2007-01-24T00:00:00",
−
            "TimeBeg": "1899-01-01T16:30:00",
+
                "BirthCountry": null,
−
            "Control": 1,
+
                "BirthCity": null,
−
            "Attribute": 65695,
+
                "Citizen": null,
−
            "DateBeg": "2021-01-01T00:00:00",
+
                "PostIndex": null,
−
            "DateEnd": "2021-01-08T00:00:00",
+
                "PostCity": null,
−
            "Discount": 47.4,
+
                "PostStreet": null,
−
            "Comment": null,
+
                "PostBild": null,
−
            "DGKey": 40335,
+
                "PostFlat": null,
−
            "Blocked": null,
+
                "Phone": "79876543232",
−
            "NameLat": "HOTEL::Вена/Albatros-1*,8 ночей/Double(Standart),2 Adult/HB Полупансион",
+
                "PhoneCode": null,
−
            "Long": 9,
+
                "PasportType": "",
−
            "TRFId": 0,
+
                "PasportNum": "",
−
            "CreateDate": "2020-10-12T15:02:29.013",
+
                "PasportDate": null,
−
            "CalculatePriceDate": "2020-10-12T15:02:29.013",
+
                "PasportDateEnd": null,
−
            "ShowOrder": 2,
+
                "PasportByWhom": null,
−
            "Connections": [{
+
                "Place": null,
−
                    "$ref": 1
+
                "IsAnketa": null,
−
                }
+
                "PaspRuser": "",
−
            ]
+
                "PaspRuNum": "",
−
        }, {
+
                "PaspRuDate": null,
−
            "$id": 5,
+
                "PaspRuByWhom": "",
−
            "DGCod": "AU10101003",
+
                "ClientId": null,
−
            "TurDate": "2021-01-01T00:00:00",
+
                "IsMain": 1,
−
            "Key": 202461,
+
                "DGKey": 54010,
−
            "PaketKey": 209,
+
                "RealSex": 0,
−
            "TRKey": 100000038,
+
                "Email": "emailqwerty123@example.com",
−
            "SVKey": 1,
+
                "EnableSmsNotifications": 0,
−
            "Name": "А_П::Вена/Москва/00444, VIE-SV1, 14:00-16:45/C Бизнес класс",
+
                "CitizenId": "",
−
            "Day": 9,
+
                "Connections": [
−
            "Code": 572,
+
                    {
−
            "SubCode1": 67,
+
                        "$ref": 1
−
            "SubCode2": 35,
+
                    }
−
            "Men": 2,
+
                ]
−
            "Days": 0,
+
            },
−
            "CNKey": 460,
+
            {
−
            "CTKey": 1,
+
                "$id": 5,
−
            "PartnerKey": 10760,
+
                "DGCod": "RU27010037",
−
            "Brutto": 195.2,
+
                "Key": 120805,
−
            "Wait": null,
+
                "TurDate": "2025-01-27T12:00:00",
−
            "Warning": 0,
+
                "NameRus": "Петров",
−
            "TimeBeg": "1899-01-01T14:00:00",
+
                "NameLat": "Петров",
−
            "Control": 1,
+
                "ShortName": "П.П.",
−
            "Attribute": 65695,
+
                "Sex": 0,
−
            "DateBeg": "2021-01-09T00:00:00",
+
                "FNameRus": "Петр",
−
            "DateEnd": "2021-01-09T00:00:00",
+
                "FNameLat": "Петр",
−
            "Discount": 17.8,
+
                "SNameRus": "Петрович",
−
            "Comment": null,
+
                "SNameLat": "Петрович",
−
            "DGKey": 40335,
+
                "BirthDay": "2007-01-24T00:00:00",
−
            "Blocked": null,
+
                "BirthCountry": null,
−
            "NameLat": "А_П::Вена/Москва/00444, VIE-SV1, 14:00-16:45/C Бизнес класс",
+
                "BirthCity": null,
−
            "Long": 9,
+
                "Citizen": null,
−
            "TRFId": 0,
+
                "PostIndex": null,
−
            "CreateDate": "2020-10-12T15:02:29.013",
+
                "PostCity": null,
−
            "CalculatePriceDate": "2020-10-12T15:02:29.013",
+
                "PostStreet": null,
−
            "ShowOrder": 3,
+
                "PostBild": null,
−
            "Connections": [{
+
                "PostFlat": null,
−
                    "$ref": 1
+
                "Phone": null,
−
                }
+
                "PhoneCode": null,
−
            ]
+
                "PasportType": "",
−
        }
+
                "PasportNum": "",
−
    ],
+
                "PasportDate": null,
−
    "Turists": [{
+
                "PasportDateEnd": null,
−
            "$id": 6,
+
                "PasportByWhom": null,
−
            "DGCod": "AU10101003",
+
                "Place": null,
−
            "Key": 88653,
+
                "IsAnketa": null,
−
            "TurDate": "2021-01-01T00:00:00",
+
                "PaspRuser": "",
−
            "NameRus": "IVANOV",
+
                "PaspRuNum": "",
−
            "NameLat": "IVANOV",
+
                "PaspRuDate": null,
−
            "ShortName": "I.",
+
                "PaspRuByWhom": "",
−
            "Sex": 0,
+
                "ClientId": null,
−
            "FNameRus": "IVAN",
+
                "IsMain": 0,
−
            "FNameLat": "IVAN",
+
                "DGKey": 54010,
−
            "SNameRus": "",
+
                "RealSex": 0,
−
            "SNameLat": "",
+
                "Email": "",
−
            "BirthDay": "1980-01-01T00:00:00",
+
                "EnableSmsNotifications": 0,
−
             "BirthCountry": null,
+
                "CitizenId": "",
−
            "BirthCity": "Москва",
+
                "Connections": [
−
            "Citizen": "",
+
                    {
−
            "PostIndex": null,
+
                        "$ref": 1
−
            "PostCity": null,
+
                    }
−
            "PostStreet": null,
+
                ]
−
            "PostBild": null,
+
            }
−
            "PostFlat": null,
+
        ],
−
            "Phone": "",
+
        "TuristServices": [
−
            "PhoneCode": null,
+
            {
−
            "PasportType": "",
+
                "$id": 6,
−
            "PasportNum": "",
+
                "TUKey": 120806,
−
            "PasportDate": null,
+
                "DLKey": 250570,
−
             "PasportDateEnd": null,
+
                "NumDoc": null,
−
            "PasportByWhom": "",
+
                "NumRoom": 0,
−
             "Place": null,
+
                "Seat": null,
−
            "IsAnketa": null,
+
                "Area": null,
−
            "PaspRuser": "",
+
                "DocDate": null,
−
            "PaspRuNum": "",
+
                "Key": 134191,
−
            "PaspRuDate": null,
+
                "Connections": [
−
            "PaspRuByWhom": "",
+
                    {
−
             "ClientId": null,
+
                        "$ref": 1
−
            "IsMain": 1,
+
                    },
−
            "DGKey": 40335,
+
                    {
−
            "RealSex": 0,
+
                        "$ref": 3
−
             "Email": "",
+
                    },
−
             "EnableSmsNotifications": 0,
+
                    {
−
             "CitizenId": "",
+
                        "$ref": 4
−
             "Connections": [{
+
                    }
−
                    "$ref": 1
+
                ]
−
                }
+
            },
−
            ]
+
             {
−
        }, {
+
                "$id": 7,
−
            "$id": 7,
+
                "TUKey": 120805,
−
            "DGCod": "AU10101003",
+
                "DLKey": 250570,
−
            "Key": 88652,
+
                "NumDoc": null,
−
            "TurDate": "2021-01-01T00:00:00",
+
                "NumRoom": 0,
−
            "NameRus": "PETROV",
+
                "Seat": null,
−
            "NameLat": "PETROV",
+
                "Area": null,
−
            "ShortName": "P.",
+
                "DocDate": null,
−
            "Sex": 0,
+
                "Key": 134190,
−
            "FNameRus": "PETR",
+
                "Connections": [
−
            "FNameLat": "PETR",
+
                    {
−
            "SNameRus": "",
+
                        "$ref": 1
−
            "SNameLat": "",
+
                    },
−
            "BirthDay": "1981-01-01T00:00:00",
+
                    {
−
            "BirthCountry": null,
+
                        "$ref": 3
−
            "BirthCity": "Москва",
+
                    },
−
            "Citizen": "",
+
                    {
−
            "PostIndex": null,
+
                        "$ref": 5
−
            "PostCity": null,
+
                    }
−
            "PostStreet": null,
+
                ]
−
            "PostBild": null,
+
             }
−
            "PostFlat": null,
+
        ],
−
            "Phone": "",
+
        "DogovorMessages": [
−
            "PhoneCode": null,
+
             {
−
            "PasportType": "",
+
                "$id": 8,
−
            "PasportNum": "",
+
                "Date": "2025-01-24T17:26:18.26",
−
            "PasportDate": null,
+
                "Text": "Это тестовая путевка",
−
            "PasportDateEnd": null,
+
                "Remark": "от агента",
−
            "PasportByWhom": "",
+
                "Connections": [
−
            "Place": null,
+
                    {
−
            "IsAnketa": null,
+
                        "$ref": 1
−
            "PaspRuser": "",
+
                    }
−
            "PaspRuNum": "",
+
                ]
−
            "PaspRuDate": null,
+
             }           
−
            "PaspRuByWhom": "",
+
        ]
−
            "ClientId": null,
+
    },
−
            "IsMain": 0,
+
    "UsedMailService": false,
−
            "DGKey": 40335,
+
    "ValidationResultSummary": {
−
            "RealSex": 0,
+
        "ValidationResult": {
−
            "Email": "",
+
             "Errors": [],
−
            "EnableSmsNotifications": 0,
+
             "Warnings": null,
−
            "CitizenId": "",
+
             "States": null,
−
            "Connections": [{
+
             "IsValid": true
−
                    "$ref": 1
+
        },
−
                }
+
        "ValidationResultAttributes": 0
−
            ]
+
    }
−
        }
+
}
−
    ],
+
</syntaxhighlight>
−
    "TuristServices": [{
+
</TD></TR></TABLE>
−
            "$id": 8,
+
</div></div><br />
−
            "TUKey": 88653,
+
 
−
            "DLKey": 202463,
+
===Выгрузка информации о путевке (GetReservation)===
−
            "NumDoc": null,
+
Метод выводит информацию о бронированной путевке.
−
            "NumRoom": 0,
+
 
−
            "Seat": null,
+
* Формат запроса:
−
            "Area": null,
+
** GET .../TourSearchOwin/GetReservation?
−
            "DocDate": null,
+
 
−
            "Key": 3770,
+
* Принимаемые параметры headers ( '''*''' – обязательный):
−
            "Connections": [{
+
** '''Content-Type *''' – application/json
−
                    "$ref": 1
+
** '''Authorization *''' – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
−
                }, {
+
 
−
                    "$ref": 3
+
* Принимаемые параметры GET запроса ( '''*''' – обязательный):
−
                }, {
+
** '''dgCode *''' – номер путевки:
−
                    "$ref": 6
+
 
−
                }
+
* Возвращаемый результат:
−
            ]
+
** '''$id''' – внутренний идентификатор для установки связей между сущностями,
−
        }, {
+
** '''Code''' – код путевки
−
            "$id": 9,
+
** '''TurDate''' – дата заезда
−
            "TUKey": 88652,
+
** '''TRKey''' – ключ тура
−
            "DLKey": 202463,
+
** '''CNKey''' – ключ страны
−
            "NumDoc": null,
+
** '''CTKey''' – ключ города
−
            "NumRoom": 0,
+
** '''NMen''' – количество туристов по путевке
−
            "Seat": null,
+
** '''Price''' – стоимость путевки за вычетом скидки (комиссии)
−
            "Area": null,
+
** '''Payed''' – оплаченная сумма по путевке
−
            "DocDate": null,
+
** '''NDay''' – продолжительность тура в днях
−
            "Key": 3768,
+
** '''MainMan''' – ФИО лица, заключившего договор
−
            "Connections": [{
+
** '''MainManPhone''' – номер телефона лица, заключившего договор
−
                    "$ref": 1
+
** '''MainManAddress''' – адрес лица, заключившего договор
−
                }, {
+
** '''MainManPassport''' – паспортные данные лица, заключившего договор
−
                    "$ref": 3
+
** '''PartnerKey''' – ключ партнера, оформившего договор
−
                }, {
+
** '''Operator''' – ФИО создателя договора
−
                    "$ref": 7
+
** '''Discount''' – величина скидки на одного человека
−
                }
+
** '''DiscountSum''' – абсолютная величина скидки
−
            ]
+
** '''SORCode''' – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
−
        }, {
+
** '''CrDate''' – дата и время создания путевки
−
            "$id": 10,
+
** '''Rate''' – код валюты путевки