Мастер-Тур(15):API для разработки онлайн поиска и бронирования — различия между версиями
| [досмотренная версия] | [досмотренная версия] |
Biryukov (обсуждение | вклад) (→Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)) |
Biryukov (обсуждение | вклад) (→Установка) |
||
| (не показана 161 промежуточная версия 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 /> | ||
| − | ===Выгрузка списка | + | ===Выгрузка списка валют в онлайне (Currency)=== |
| − | Метод возвращает список | + | Метод возвращает список используемых валют. |
* Формат запроса: | * Формат запроса: | ||
| − | ** GET .../TourSearchOwin/ | + | ** 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> | ||
| − | Вызов метода | + | Вызов метода Currency |
<syntaxhighlight lang="java" enclose="div"> | <syntaxhighlight lang="java" enclose="div"> | ||
| − | GET http://localhost:9000/TourSearchOwin/ | + | GET http://localhost:9000/TourSearchOwin/Currency |
</syntaxhighlight> | </syntaxhighlight> | ||
| − | Возвращаемый результат метода | + | Возвращаемый результат метода Currency (в формате JSON) |
<syntaxhighlight lang="java" enclose="div"> | <syntaxhighlight lang="java" enclose="div"> | ||
[ | [ | ||
| Строка 243: | Строка 321: | ||
"Symbol": "$", | "Symbol": "$", | ||
"Key": 1 | "Key": 1 | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
} | } | ||
] | ] | ||
| Строка 260: | Строка 328: | ||
| − | ===Выгрузка | + | ===Выгрузка курсов валют (CurrencyRates) начиная с 15.7=== |
| − | Метод возвращает список | + | Полный аналог метода [[Мастер-Тур(15):API для отдачи цен в поисковые системы#Выгрузка курсов валют (GetCurrencyRates)|Выгрузка курсов валют (GetCurrencyRates)]]<br /> |
| + | Метод возвращает список курсов валют, актуальных на дату запроса. Курсы отображаются только для тех валют, которые отмечены в справочнике признаком ''Отображать в онлайне'' | ||
* Формат запроса: | * Формат запроса: | ||
| − | ** GET .../TourSearchOwin/ | + | ** GET .../TourSearchOwin/CurrencyRates |
* Принимаемые параметры: | * Принимаемые параметры: | ||
| − | ** | + | ** '''dateFrom''' – начальная дата, от которой вывести список курсов валют, в формате DD.MM.YYYY, необязательный параметр (если не указан, берется за текущий день) |
| + | ** '''dateTo''' – конечная дата, до которой вывести список курсов валют, в формате DD.MM.YYYY, необязательный параметр (если не указан, берется за текущий день) | ||
| + | ** '''otherBaseCurrencyId''' – идентификатор любой валюты, эмулирующей работу национальной валюты, необязательный параметр. Если заполнен, то в результатах выдачи параметр ''baseCurrencyId'' будет заменяться на валюту из параметра ''otherBaseCurrencyId'' (обрабатывается с релиза 15.9). | ||
| + | |||
* Возвращаемый результат: | * Возвращаемый результат: | ||
| − | ** ''' | + | ** '''baseCurrencyId''' – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке ''basketCurrency'' в конфигурационном файле (обрабатывается с релиза 15.6) |
| − | + | ** '''currencyId''' – идентификатор валюты, курс которой приводится | |
| − | + | ** '''rate''' – курс валюты (отношение '''currencyId''' к '''baseCurrencyId''') | |
| − | ** ''' | + | ** '''date''' – дата, на которую был зарегистрирован выводимый курс валюты |
| − | ** ''' | ||
| − | |||
| − | |||
| − | ** ''' | ||
| + | <div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример | ||
| + | <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> | ||
| − | Вызов метода | + | Вызов метода getAllCurrencies |
<syntaxhighlight lang="java" enclose="div"> | <syntaxhighlight lang="java" enclose="div"> | ||
| − | GET http://localhost:9000/TourSearchOwin/ | + | GET http://localhost:9000/TourSearchOwin/AllCurencies/getAllCurrencies |
</syntaxhighlight> | </syntaxhighlight> | ||
| − | Возвращаемый результат метода | + | Возвращаемый результат метода 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 /> | ||
| − | === | + | |
| − | Метод | + | ===Получение сконвертированных цен (convertFilterPrice)=== |
| + | Метод возвращает сконвертированные цен для допфильтра ''Цена'' (используется в canary) | ||
* Формат запроса: | * Формат запроса: | ||
| − | ** GET .../TourSearchOwin/ | + | ** 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''' – наименование услуги (русский) | ||
| Строка 431: | Строка 595: | ||
* Принимаемые параметры ( '''*''' – обязательный): | * Принимаемые параметры ( '''*''' – обязательный): | ||
** '''departureCities *''' – идентификатор города(ов) отправления (из контроллера [[#Выгрузка актуальных городов отправления (departureCities)|''.../TourSearchOwin/departureCities?'']]) | ** '''departureCities *''' – идентификатор города(ов) отправления (из контроллера [[#Выгрузка актуальных городов отправления (departureCities)|''.../TourSearchOwin/departureCities?'']]) | ||
| + | ** '''type''' – настройка easySearchFilter (0/не указано - настройка выключена, 1 - настройка включена) | ||
** '''term''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой) | ** '''term''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой) | ||
* Возвращаемый результат: | * Возвращаемый результат: | ||
** '''Name''' – название страны | ** '''Name''' – название страны | ||
** '''Key''' – идентификатор страны | ** '''Key''' – идентификатор страны | ||
| − | ** '''DestinationType''' – тип результата (всегда возвращается | + | ** '''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: | ||
[ | [ | ||
{ | { | ||
| − | " | + | "Data": null, |
| − | "Key": | + | "DestinationType": 1, |
| − | " | + | "IsExist": false, |
| + | "Key": 90, | ||
| + | "Name": "Австрия" | ||
| + | |||
| + | |||
}, | }, | ||
{ | { | ||
| − | " | + | "Data": null, |
| − | "Key": | + | "DestinationType": 1, |
| − | " | + | "IsExist": false, |
| + | "Key": 53, | ||
| + | "Name": "Тайланд" | ||
| + | |||
| + | |||
}, | }, | ||
{ | { | ||
| − | " | + | "Data": null, |
| − | "Key": | + | "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 *''' – тип результата (всегда | + | ** '''Type *''' – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1) |
** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны | ** '''destinationCity *''' – идентификатор города(ов) прибытия (полученный из метода ''.../TourSearchOwin/ActualizeCities?''), по умолчанию передается ''-1'', то есть все города в рамках данной страны | ||
** '''terms''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой) | ** '''terms''' – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой) | ||
| Строка 519: | Строка 788: | ||
** '''Key''' – идентификатор типа тура | ** '''Key''' – идентификатор типа тура | ||
** '''Name''' – название типа тура | ** '''Name''' – название типа тура | ||
| − | ** '''ParentId''' – идентификатор группы, к которой относится данный | + | ** '''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 *''' – тип результата (всегда | + | ** '''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 *''' – тип результата (всегда | + | ** '''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 | + | ** '''isFillSecondaryFilters''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется. |
| − | ** '''DestinationType *''' – тип результата (всегда | + | ** '''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'' (уникальный ключ) – передается на клиент от первого запроса из внешней системы. С данным уникальным ключом осуществляется второй запрос от | + | ** '''GroupGuid''' – используется для получения турпрограмм по уникальному ключу из кэша при использовании группировки. Примеры использования. ''GroupGuid=00000000-0000-0000-0000-000000000000'' – при первом запросе от локальной системы. ''GroupGuid=936DA01F-9ABD-4d9d-80C7-02AF85C822A8'' (уникальный ключ) – передается на клиент от первого запроса из внешней системы. С данным уникальным ключом осуществляется второй запрос от внешней системы. Далее происходит получение значений по данному уникальному ключу. Обрабатывается начиная с релиза 15.4. |
| − | ** '''IsGroupingTourAlreadyMerge''' – определяет слияние данных турпрограмм от локальной системы с данными от внешней системы при использовании группировки. Примеры использования. ''IsGroupingTourAlreadyMerge=false'' – полученные данные от локальной системы не объединены с данными от внешней | + | ** '''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''' – | ||
| − | |||
**** '''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": | + | "Country": { |
| + | "Key": 90, | ||
| + | "Value": "Австрия" | ||
| + | }, | ||
"Code": { | "Code": { | ||
"Key": 297, | "Key": 297, | ||
| Строка 1294: | Строка 1628: | ||
"Value": "Санто-Доминго" | "Value": "Санто-Доминго" | ||
}, | }, | ||
| − | "Country": | + | "Country": { |
| + | "Key": 90, | ||
| + | "Value": "Австрия" | ||
| + | }, | ||
"Code": { | "Code": { | ||
"Key": 743, | "Key": 743, | ||
| Строка 1429: | Строка 1766: | ||
} | } | ||
}, | }, | ||
| − | "RouteSubVariants": [] | + | "RouteSubVariants": [], |
| + | "Routes": 1, | ||
| + | "IsRemoteHotels": false, | ||
| + | "IsTourImages": false, | ||
| + | "MaskKeys": null | ||
} | } | ||
], | ], | ||
| Строка 1497: | Строка 1838: | ||
} | } | ||
}, | }, | ||
| − | |||
"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 /> | ||
| − | ===Выгрузка | + | ===Выгрузка транспортного плана (TransportPlan) начиная с релиза 15.8=== |
| − | Метод | + | Метод производит выгрузку транспортного плана. |
* Формат запроса: | * Формат запроса: | ||
| − | ** GET .../TourSearchOwin/ | + | ** GET .../TourSearchOwin/TransportPlan? |
* Принимаемые параметры ( '''*''' – обязательный): | * Принимаемые параметры ( '''*''' – обязательный): | ||
| − | ** ''' | + | ** '''code''' – код услуги |
| − | + | ** '''dateBegin''' – дата услуги | |
| − | + | ** '''serviceType''' – тип услуги | |
| − | + | ** '''transportKey''' – ключ справочника транспорт | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | ** ''' | ||
| − | ** ''' | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | ** ''' | ||
| − | |||
| − | |||
| − | |||
| − | |||
* Возвращаемый результат: | * Возвращаемый результат: | ||
| − | ** ''' | + | ** '''VehiclePlans''' – массив параметров зон плана |
| − | + | *** '''Key''' – ключ зоны | |
| − | *** '''Key''' – | + | *** '''TransportKey''' – ключ из справочника транспорт |
| − | *** ''' | + | *** '''Row''' – количество рядов |
| − | ** ''' | + | *** '''AreaNumber''' – номер уровня |
| − | *** ''' | + | *** '''Name''' – название уровня |
| − | *** '''Name''' – название | + | *** '''PlanOrientation''' – ориентация плана (''false'' - горизонтальная, ''true'' - вертикальная) |
| − | *** ''' | + | *** '''Column''' – количество столбцов |
| − | + | *** '''IsAirCraft''' – является ли планом самолета (''false'' - нет, ''true'' - является) | |
| − | *** ''' | + | *** '''Type''' – не используется |
| − | *** ''' | + | ** '''Seats''' – массив параметров посадочного места |
| − | + | *** '''Key''' – ключ места | |
| − | *** ''' | + | *** '''SeatType''' – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5) |
| − | + | *** '''Index''' – индекс места | |
| − | *** ''' | + | *** '''Number''' – название ячейки с местом |
| − | *** ''' | + | *** '''Type''' – тип "место" |
| − | + | *** '''VPKey''' – ключ зоны | |
| − | + | *** '''Border''' – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px) | |
| − | *** ''' | + | |
| − | *** ''' | + | <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> | |
| − | + | Вызов метода TransportPlan | |
| − | + | <syntaxhighlight lang="java" enclose="div"> | |
| − | + | GET http://localhost:9000/TourSearchOwin/TransportPlan?code=1776&dateBegin=28.03.2022&serviceType=14&transportKey=35 | |
| − | + | </syntaxhighlight> | |
| − | + | Возвращаемый результат метода TransportPlan (в формате JSON) | |
| − | + | <syntaxhighlight lang="java" enclose="div"> | |
| − | + | { | |
| − | + | "VehiclePlans": | |
| − | + | [ | |
| − | + | { | |
| − | + | "Key": 291, | |
| − | + | "TransportKey": 35, | |
| − | + | "Row": 2, | |
| − | + | "AreaNumber": 1, | |
| − | + | "Name": "Зона 1", | |
| − | + | "PlanOrientation": false, | |
| − | + | "Column": 3, | |
| − | + | "IsAirCraft": false, | |
| − | + | "Type": "VehiclePlans" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 292, | |
| − | + | "TransportKey": 35, | |
| − | + | "Row": 3, | |
| − | + | "AreaNumber": 2, | |
| − | + | "Name": "Зона 2", | |
| − | + | "PlanOrientation": true, | |
| − | + | "Column": 2, | |
| − | + | "IsAirCraft": false, | |
| − | + | "Type": "VehiclePlans" | |
| − | + | } | |
| − | + | ], | |
| − | + | "Seats": | |
| − | + | [ | |
| − | + | { | |
| − | + | "Key": 332522, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 0, | |
| − | + | "Number": "1", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 291, | |
| − | + | "Border": "2002" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 332523, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 1, | |
| − | + | "Number": "2", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 291, | |
| − | + | "Border": "2100" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 332524, | |
| − | + | "SeatType": 2, | |
| − | + | "Index": 2, | |
| − | + | "Number": "П", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 291, | |
| − | + | "Border": "2201" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 332525, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 3, | |
| − | + | "Number": "3", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 291, | |
| − | + | "Border": "0022" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 332526, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 4, | |
| − | + | "Number": "4", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 291, | |
| − | + | "Border": "0120" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 332527, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 5, | |
| − | + | "Number": "5", | |
| − | + | "Type": "Seat", | |
| − | **** | + | "VPKey": 291, |
| − | + | "Border": "0221" | |
| − | * | + | }, |
| − | + | { | |
| − | + | "Key": 332528, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 0, | |
| − | + | "Number": "1", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 292, | |
| − | + | "Border": "2002" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 332529, | |
| − | + | "SeatType": 1, | |
| − | **** ''' | + | "Index": 1, |
| − | + | "Number": "2", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 292, | |
| − | * | + | "Border": "2200" |
| − | + | }, | |
| − | *** ''' | + | { |
| − | + | "Key": 332530, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 2, | |
| − | + | "Number": "3", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 292, | |
| − | + | "Border": "0012" | |
| − | + | }, | |
| − | ***** ''' | + | { |
| − | + | "Key": 332531, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 3, | |
| − | + | "Number": "4", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 292, | |
| − | + | "Border": "0210" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 332532, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 4, | |
| − | + | "Number": "5", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 292, | |
| − | + | "Border": "1000" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 332533, | |
| − | + | "SeatType": 1, | |
| − | + | "Index": 5, | |
| − | + | "Number": "6", | |
| − | + | "Type": "Seat", | |
| − | + | "VPKey": 292, | |
| − | + | "Border": "1000" | |
| − | + | } | |
| − | + | ], | |
| − | + | } | |
| − | + | </syntaxhighlight> | |
| − | + | </TD></TR></TABLE> | |
| − | + | </div></div><br /> | |
| − | + | ||
| − | + | ===Получение дат заезда по турпрограмме=== | |
| − | + | Работает начиная с релиза 15.8. | |
| − | + | Метод возвращает даты заезда по ключу турпрограммы. | |
| − | + | * Формат запроса: | |
| − | + | ** GET .../TourSearchOwin/TransportPlan? | |
| − | + | * Принимаемые параметры ( '''*''' – обязательный): | |
| − | + | ** '''tourProgramKey *''' – ключ турпрограммы | |
| − | + | ||
| − | + | * Возвращаемый результат: | |
| − | + | ** '''Массив дат заезда по туру''' | |
| − | + | ||
| − | + | <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> | |
| − | + | Вызов метода | |
| − | + | <syntaxhighlight lang="java" enclose="div"> | |
| − | + | GET http://localhost:9000/TourSearchOwin/TransportPlan?tourProgramKey=100001277 | |
| − | + | </syntaxhighlight> | |
| − | + | Возвращаемый результат метода (в формате JSON) | |
| − | + | <syntaxhighlight lang="java" enclose="div"> | |
| − | + | [ | |
| − | + | "2022-02-21T00:00:00Z", | |
| − | + | "2022-02-22T00:00:00Z", | |
| − | + | "2022-02-23T00:00:00Z", | |
| − | + | "2022-02-24T00:00:00Z", | |
| − | + | "2022-02-25T00:00:00Z", | |
| − | + | "2022-02-26T00:00:00Z", | |
| − | + | ] | |
| − | + | </syntaxhighlight> | |
| − | + | </TD></TR></TABLE> | |
| − | + | </div></div><br /> | |
| − | < | + | |
| − | + | ===Получение плана транспортного средства (TransportPlan) по ключу турпрограммы и дате услуги=== | |
| − | + | Работает начиная с релиза 15.8. | |
| − | + | Метод возвращает даты заезда по ключу турпрограммы и дате услуги. | |
| − | + | * Формат запроса: | |
| − | + | ** GET .../TourSearchOwin/TransportPlan? | |
| − | + | * Принимаемые параметры ( '''*''' – обязательный): | |
| − | + | ** '''tourProgramKey *''' – ключ турпрограммы | |
| − | + | ** '''dateBegin *''' – дата услуги | |
| − | + | ** '''serviceType *''' – тип услуги | |
| − | + | ||
| − | + | * Возвращаемый результат: | |
| − | + | * '''plan''' – массив данных план | |
| − | + | ** '''VehiclePlans''' – массив параметров зон плана | |
| − | + | *** '''Key''' – ключ зоны | |
| − | + | *** '''TransportKey''' – ключ из справочника транспорт | |
| − | + | *** '''Row''' – количество рядов | |
| − | + | *** '''AreaNumber''' – номер уровня | |
| − | + | *** '''Name''' – название уровня | |
| − | " | + | *** '''PlanOrientation''' – ориентация плана (''false'' - горизонтальная, ''true'' - вертикальная) |
| − | " | + | *** '''Column''' – количество столбцов |
| − | " | + | *** '''IsAirCraft''' – является ли планом самолета (''false'' - нет, ''true'' - является) |
| − | " | + | *** '''Dates''' – не используется |
| − | + | *** '''Type''' – не используется | |
| − | + | ** '''Seats''' – массив параметров посадочного места | |
| − | + | *** '''Key''' – ключ места | |
| − | "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''' – название поля | ||
| − | **** ''' | + | **** '''IsEdit''' – признак редактируемости поля |
**** '''IsRequired''' – признак обязательности заполнения поля | **** '''IsRequired''' – признак обязательности заполнения поля | ||
| − | **** ''' | + | **** '''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": { | |
| − | + | "number": { | |
| − | + | "Index": 0, | |
| − | + | "Code": "number", | |
| − | + | "ApiCode": "Number", | |
| − | + | "HeaderText": "№", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "ismain": { | |
| − | + | "Index": 1, | |
| − | + | "Code": "ismain", | |
| − | + | "ApiCode": "IsMain", | |
| − | + | "HeaderText": "<img src=\"images/mw_main_tourist.gif\" border=\"0\" alt=\"Главный турист\" />", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": true, | |
| − | + | "IsVisible": true, | |
| − | + | "IsDisabled": true, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "sex": { | |
| − | + | "Index": 2, | |
| − | + | "Code": "sex", | |
| − | + | "ApiCode": "Sex", | |
| − | + | "HeaderText": "Пол<font color=\"red\">*</font>", | |
| − | + | "IsEdit": true, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": true, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "birthdate": { | |
| − | + | "Index": 3, | |
| − | + | "Code": "birthdate", | |
| − | + | "ApiCode": "BirthDay", | |
| − | + | "HeaderText": "Дата рождения<br />(dd.MM.yyyy)", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": true, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "birthplace": { | |
| − | + | "Index": 4, | |
| − | + | "Code": "birthplace", | |
| − | + | "ApiCode": "BirthPlace", | |
| − | + | "HeaderText": "Место рождения", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "citizenship": { | |
| − | + | "Index": 5, | |
| − | + | "Code": "citizenship", | |
| − | + | "ApiCode": "Citizenship", | |
| − | + | "HeaderText": "Гражданство", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": true, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "lastname": { | |
| − | + | "Index": 6, | |
| − | + | "Code": "lastname", | |
| − | + | "ApiCode": "LastName", | |
| − | + | "HeaderText": "Фамилия<font color=\"red\">*</font>", | |
| − | + | "IsEdit": true, | |
| − | + | "IsRequired": true, | |
| − | + | "IsVisible": true, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 1, | |
| − | + | "LetterCase": 2 | |
| − | + | }, | |
| − | + | "firstname": { | |
| − | + | "Index": 7, | |
| − | + | "Code": "firstname", | |
| − | + | "ApiCode": "FirstName", | |
| − | + | "HeaderText": "Имя<font color=\"red\">*</font>", | |
| − | + | "IsEdit": true, | |
| − | + | "IsRequired": true, | |
| − | + | "IsVisible": true, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 1, | |
| − | + | "LetterCase": 2 | |
| − | + | }, | |
| − | + | "patronymic": { | |
| − | + | "Index": 8, | |
| − | + | "Code": "patronymic", | |
| − | + | "ApiCode": "Patronymic", | |
| − | + | "HeaderText": "Отчество", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 1, | |
| − | + | "LetterCase": 2 | |
| − | + | }, | |
| − | + | "passport": { | |
| − | + | "Index": 9, | |
| − | + | "Code": "passport", | |
| − | + | "ApiCode": "InternationalPassportSeries/InternationalPassportNumber", | |
| − | + | "HeaderText": "Загран-паспорт: Паспорт<br />(серия/номер)", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": true, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 1, | |
| − | + | "LetterCase": 2 | |
| − | + | }, | |
| − | + | "passportdate": { | |
| − | + | "Index": 10, | |
| − | + | "Code": "passportdate", | |
| − | + | "ApiCode": "InternationalPassportDateOfIssue", | |
| − | + | "HeaderText": "Загран-паспорт: дата выдачи", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "passportdateend": { | |
| − | + | "Index": 11, | |
| − | + | "Code": "passportdateend", | |
| − | + | "ApiCode": "InternationalPassportDateOfExpiry", | |
| − | + | "HeaderText": "Действителен до<br />(dd.MM.yyyy)", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": true, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "passportbywhom": { | |
| − | + | "Index": 12, | |
| − | + | "Code": "passportbywhom", | |
| − | + | "ApiCode": "internationalPassportByWhom", | |
| − | + | "HeaderText": "Кем выдан", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "lastnamerus": { | |
| − | + | "Index": 13, | |
| − | + | "Code": "lastnamerus", | |
| − | + | "ApiCode": "LastNameRus", | |
| − | + | "HeaderText": "Нац. паспорт: Фамилия", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 2 | |
| − | + | }, | |
| − | + | "firstnamerus": { | |
| − | + | "Index": 14, | |
| − | + | "Code": "firstnamerus", | |
| − | + | "ApiCode": "FirstNameRus", | |
| − | + | "HeaderText": "Нац. паспорт: Имя", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 2 | |
| − | + | }, | |
| − | + | "patronymicrus": { | |
| − | + | "Index": 15, | |
| − | + | "Code": "patronymicrus", | |
| − | + | "ApiCode": "PatronymicRus", | |
| − | + | "HeaderText": "Нац. Отчество", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 2 | |
| − | + | }, | |
| − | + | "passportrus": { | |
| − | + | "Index": 16, | |
| − | + | "Code": "passportrus", | |
| − | + | "ApiCode": "PassportSeries/PassportNumber", | |
| − | + | "HeaderText": "серия/номер", | |
| − | + | "IsEdit": false, | |
| − | + | "IsRequired": false, | |
| − | + | "IsVisible": false, | |
| − | + | "IsDisabled": false, | |
| − | + | "Translit": 0, | |
| − | + | "LetterCase": 0 | |
| − | + | }, | |
| − | + | "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/ | + | POST http://localhost:9000/TourSearchOwin/GetFlightsAdditionalServices?nodeId=2147483647 HTTP/1.1 |
Content-Type: application/json | Content-Type: application/json | ||
{ | { | ||
| Строка 3254: | Строка 4092: | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | Возвращаемый результат метода | + | Возвращаемый результат метода GetFlightsAdditionalServices (в формате JSON) |
<syntaxhighlight lang="java" enclose="div"> | <syntaxhighlight lang="java" enclose="div"> | ||
[{ | [{ | ||
"ServiceName": "Доплаты к авиаперелетам", | "ServiceName": "Доплаты к авиаперелетам", | ||
"City": null, | "City": null, | ||
| − | + | "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": { | |
| + | "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 /> | ||
| − | === | + | ===Выгрузка информации от внешнего поставщика по перелету (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/ | + | * Формат запроса: |
| − | + | ** POST .../TourSearchOwin/RebuildFlights | |
* Принимаемые параметры headers ( '''*''' – обязательный): | * Принимаемые параметры headers ( '''*''' – обязательный): | ||
** '''Content-Type *''' – application/json | ** '''Content-Type *''' – application/json | ||
* Принимаемые параметры POST запроса ( '''*''' – обязательный): | * Принимаемые параметры POST запроса ( '''*''' – обязательный): | ||
| − | ** '''flightId''' – | + | ** '''flights''' – перелеты |
| − | ** ''' | + | *** '''direction''' – |
| − | ** ''' | + | *** '''commonPrice''' – общая стоимость перелета |
| − | ** ''' | + | *** '''remotePriceSource''' – данные расчета локального перелета |
| − | *** ''' | + | **** '''providerId''' – ID внешнего поставщика |
| − | *** ''' | + | **** '''flightId''' – идентификатор внешнего перелета |
| − | *** ''' | + | *** '''localPriceSource''' – данные расчета локального перелета |
| − | *** ''' | + | **** '''packetId''' – ключ пакета |
| − | *** ''' | + | **** '''partnerId''' – идентификатор партнера |
| − | *** ''' | + | *** '''flightsSequenceSettings''' – описание параметров последовательности перелетов для которых действуют замены |
| − | *** ''' | + | **** '''templateId''' – идентификатор шаблона услуги |
| − | *** ''' | + | **** '''patternId''' – идентификатор паттерна услуги |
| − | *** ''' | + | **** '''serviceId''' – идентификатор класса услуги |
| − | *** ''' | + | *** '''segments''' – сегменты авиаперелета |
| − | *** ''' | + | **** '''segmentNumber''' – номер сегмента |
| − | *** ''' | + | **** '''depratureCity''' – город отправления |
| − | *** ''' | + | ***** '''gdsItem''' – справочная информация внешней системы |
| − | *** ''' | + | ****** '''serviceId''' – идентификатор системы |
| − | *** ''' | + | ****** '''languageId''' – идентификатор языка |
| − | *** ''' | + | ****** '''id''' – идентификатор в системе внешнего поставщика |
| − | *** ''' | + | ****** '''code''' – код в системе внешнего поставщика |
| − | *** ''' | + | ****** '''name''' – имя в системе внешнего поставщика |
| − | *** ''' | + | ******* '''automaticallyMappingValue''' – выражение используемое для автоматического маппинга |
| − | *** ''' | + | ******* '''requestValue''' – значение поля справочника которое используется в запросе к внешнему поставщику |
| − | *** ''' | + | ****** '''displayedValue''' – значение поля справочника который используется для отображения |
| − | *** ''' | + | ****** '''dependencies''' – список зависимых сущностей |
| − | *** ''' | + | ******* '''dictionaryId''' – идентификатор справочника |
| − | *** ''' | + | ******* '''itemId''' – |
| − | *** ''' | + | ****** '''columnValues''' – наименование города и страны |
| − | *** ''' | + | ***** '''mtItem''' – справочная информации локальной системы |
| − | *** ''' | + | ****** '''id''' – идентификатор в локальной системе |
| − | *** ''' | + | ****** '''code''' – код в локальной системе |
| − | *** ''' | + | ****** '''name''' – имя в локальной системе |
| − | *** ''' | + | ****** '''automaticallyMappingValue''' – выражение используемое для автоматического маппинга |
| − | ** ''' | + | ****** '''requestValue''' – значение поля справочника которое используется в запросе к внешнему поставщику |
| − | ** ''' | + | ****** '''displayedValue''' – значение поля справочника который используется для отображения |
| − | ** ''' | + | ****** '''dependencies''' – список зависимых сущностей |
| − | *** ''' | + | ******* '''dictionaryId''' – идентификатор справочника |
| − | **** ''' | + | ******* '''itemId''' – |
| − | ***** ''' | + | ****** '''columnValues''' – наименование страны и города |
| − | ***** ''' | + | ***** '''mapping''' – связка |
| − | ***** '''serviceId''' – идентификатор | + | ****** '''id''' – Id маппинга |
| − | **** ''' | + | ****** '''providerId''' – Id провайдера |
| − | ***** ''' | + | ****** '''dictionaryId''' – Id справочника |
| − | ***** ''' | + | ****** '''providerDictionaryItemId''' – Id справочника внешнего поставщика |
| − | ***** ''' | + | ****** '''providerDictionaryItemName''' – обозначение справочника внешнего поставщика |
| − | ***** ''' | + | ****** '''mtDictionaryItemId''' – Id справочника МТ |
| − | ***** ''' | + | ****** '''mtDictionaryItemName''' – обозначение справочника MT |
| − | ***** ''' | + | **** '''arrivalCity''' – город прибытия |
| − | ***** ''' | + | ***** '''gdsItem''' – справочная информация внешней системы |
| − | ***** ''' | + | ****** '''serviceId''' – идентификатор системы |
| − | ***** ''' | + | ****** '''languageId''' – идентификатор языка |
| − | ***** ''' | + | ****** '''id''' – идентификатор в системе внешнего поставщика |
| − | **** ''' | + | ****** '''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, то руководствоваться следует значением, полученном в параметре | + | ***** '''freePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus. |
| − | ***** '''isFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": | + | ***** '''isFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены. |
| − | + | ** '''tourDate''' – дата тура | |
| − | * | + | |
| − | + | * Возвращаемый результат: | |
| − | + | ** '''flights''' – информация о рейсах | |
| − | + | *** '''remoteFlightId''' – идентификатор внешнего перелета | |
| − | + | *** '''flightsSettings''' – внутренняя информация о перелете | |
| − | **** ''' | + | **** '''templateId''' – идентификатор шаблона услуги |
| − | *** ''' | + | **** '''patternId''' – идентификатор паттерна услуги |
| − | **** ''' | + | **** '''serviceId''' – идентификатор класса услуги |
| − | **** ''' | + | *** '''flightsPlains''' – планы полетов |
| − | **** ''' | + | **** '''DepartureCity''' – город вылета |
| − | **** ''' | + | ***** '''Key''' – ключ города |
| − | **** ''' | + | ***** '''Value''' – наименование города |
| − | **** ''' | + | **** '''DepartureCountry''' – страна вылета |
| − | **** ''' | + | ***** '''Key''' – ключ страны |
| − | **** ''' | + | ***** '''Value''' – наименование страны |
| − | **** ''' | + | **** '''ArrivalCity''' – город прибытия |
| − | **** ''' | + | ***** '''Key''' – ключ города |
| − | **** ''' | + | ***** '''Value''' – наименование города |
| − | **** ''' | + | **** '''ArrivalCountry''' – страна прибытия |
| − | **** ''' | + | ***** '''Key''' – ключ страны |
| − | **** ''' | + | ***** '''Value''' – наименование страны |
| − | **** ''' | + | **** '''DepartureAirport''' – аэропорт вылета |
| − | **** ''' | + | ***** '''Key''' – ключ аэропорта |
| − | **** ''' | + | ***** '''Value''' – наименование аэропорта |
| − | **** ''' | + | **** '''ArrivalAirport''' – аэропорт прилета |
| − | **** ''' | + | ***** '''Key''' – ключ аэропорта |
| − | **** ''' | + | ***** '''Value''' – наименование аэропорта |
| − | **** ''' | + | **** '''Airline''' – авиакомпания |
| − | **** ''' | + | ***** '''Id''' – идентификатор авиакомпании |
| − | **** ''' | + | ***** '''"Value''' – наименование авиакомпании |
| − | **** ''' | + | ***** '''"Key''' – ключ авиакомпании |
| − | **** ''' | + | **** '''Aircraft''' – воздушное судно |
| − | **** ''' | + | ***** '''Key''' – ключ воздушного судна |
| − | **** ''' | + | ***** '''Value''' – наименование воздушного судна |
| − | **** ''' | + | **** '''Flight''' – рейс |
| − | **** ''' | + | ***** '''Key''' – ключ рейса |
| − | **** ''' | + | ***** '''Value''' – наименование рейса |
| − | *** ''' | + | **** '''DepartureTime''' – время отправления |
| − | *** ''' | + | **** '''ArrivalTime''' – время прибытия |
| − | ** | + | **** '''TotalTimeOfFlight''' – полное время перелета |
| − | *** ''' | + | **** '''FlightDetails''' – детали авиаперелета |
| − | *** ''' | + | ***** '''Tariff''' – информация о тарифе перелета |
| − | *** ''' | + | ****** '''Key''' – идентификатор |
| − | *** ''' | + | ****** '''Code''' – код тарифа |
| − | **** ''' | + | ****** '''Name''' – наименование тарифа |
| − | **** ''' | + | ***** '''IsCommission''' – признак, комиссионная ли услуга |
| − | **** ''' | + | ***** '''Cost''' – разница в стоимости с самым дешевым вариантом |
| − | **** ''' | + | ***** '''QuotaStatus''' – информация о квоте |
| − | *** ''' | + | ****** '''PlacesStatus''' – статус по квотам (есть места-1 / нет мест-2 / под запрос-4) |
| − | *** ''' | + | ****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus. |
| − | *** ''' | + | ****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены. |
| − | *** ''' | + | ***** '''PartnerId''' – ключ партнера |
| − | + | ***** '''ByPax''' – цена за человека (true/false) | |
| − | * | + | ***** '''Partner''' – информация о партнере |
| − | ** ''' | + | ****** '''Key''' – идентификатор |
| − | *** ''' | + | ****** '''Value''' – наименование |
| − | *** | + | **** '''FlightSetting''' – информация о шаблоне услуги авиаперелета |
| − | *** ''' | + | ***** '''ServiceId''' – идентификатор класса услуги (внутренняя информация из программы туров) |
| − | *** ''' | + | ***** '''PatternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров) |
| − | ** ''' | + | ***** '''FlightId''' – идентификатор внешнего перелета |
| − | *** ''' | + | **** '''FlightSourceMode''' – локальный или внешний перелет (внутренняя информация из программы туров) |
| − | *** ''' | + | **** '''Id''' – идентификатор базового шаблона услуги (внутренняя информация из программы туров) |
| − | **** ''' | + | **** '''SvKey''' – ключ типа услуги |
| − | + | **** '''IsSubCode1''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 1]] | |
| − | + | **** '''IsSubCode2''' – признак наличия [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описания 2]] | |
| − | + | **** '''IsPartnerBasedOn''' – признак услуга с приоритетным подбором поставщика | |
| − | + | **** '''Day''' – день предоставления услуги | |
| − | + | **** '''DurationInNight''' – продолжительность услуги в ночах | |
| − | + | **** '''BeginDateTime''' – дата предоставления услуги | |
| − | *** ''' | + | **** '''EndDateTime''' – дата окончания услуги |
| − | *** ''' | + | **** '''IsHooded''' – признак скрытая услуга |
| − | *** ''' | + | **** '''IsDeleted''' – признак удаляемая услуга |
| − | *** ''' | + | **** '''IsNotCalculate''' – признак не рассчитываемая услуга |
| − | *** ''' | + | **** '''PacketId''' – ключ пакета |
| − | *** ''' | + | **** '''Index''' – порядковый номер услуги |
| − | *** ''' | ||
| − | *** ''' | ||
| − | |||
<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> | ||
| − | Вызов метода | + | Вызов метода RebuildFlights |
<syntaxhighlight lang="java" enclose="div"> | <syntaxhighlight lang="java" enclose="div"> | ||
| − | POST http://localhost:9000/TourSearchOwin/ | + | POST http://localhost:9000/TourSearchOwin/RebuildFlights HTTP/1.1 |
Content-Type: application/json | Content-Type: application/json | ||
| − | |||
{ | { | ||
| − | "flightId": " | + | "flights": [ |
| − | + | { | |
| − | + | "remotePriceSource": { | |
| − | + | "providerId": 1, | |
| − | " | + | "flightId": "111397601080000" |
| − | " | + | }, |
| − | " | + | "localPriceSource": { |
| − | " | + | "packetId": 197, |
| − | " | + | "partnerId": 10767 |
| − | " | + | }, |
| − | " | + | "flightsSequenceSettings": [ |
| − | " | + | { |
| − | " | + | "templateId": 1, |
| − | " | + | "patternId": 0, |
| − | " | + | "serviceId": 0 |
| − | " | + | } |
| − | " | + | ], |
| − | " | + | "segments": [ |
| − | " | + | { |
| − | " | + | "segmentNumber": 1, |
| − | " | + | "depratureCity": { |
| − | " | + | "gdsItem": { |
| − | " | + | "id": "524901", |
| − | + | "code": "MOW", | |
| − | + | "name": "Moscow", | |
| − | " | + | "requestValue": "MOW", |
| − | + | "displayedValue": "Moscow", | |
| − | + | "dependencies": [ | |
| − | + | { | |
| − | " | + | "dictionaryId": 1, |
| − | " | + | "itemId": "643" |
| − | + | } | |
| − | + | ] | |
| − | + | }, | |
| − | }, { | + | "mtItem": { |
| − | " | + | "id": "1", |
| − | " | + | "code": "MOW", |
| − | " | + | "name": "Москва", |
| − | " | + | "requestValue": "", |
| − | " | + | "displayedValue": "Москва", |
| − | " | + | "dependencies": [ |
| − | " | + | { |
| − | " | + | "dictionaryId": 1, |
| − | " | + | "itemId": "460" |
| − | " | + | } |
| − | " | + | ] |
| − | " | + | }, |
| − | " | + | "mapping": { |
| − | " | + | "id": 143, |
| − | " | + | "providerId": 1, |
| − | " | + | "dictionaryId": 2, |
| − | + | "providerDictionaryItemId": "524901", | |
| − | + | "providerDictionaryItemName": null | |
| − | + | } | |
| − | " | + | }, |
| − | " | + | "arrivalCity": { |
| − | + | "gdsItem": { | |
| − | + | "id": "2761369", | |
| − | + | "code": "VIE", | |
| − | + | "name": "Vienna", | |
| − | + | "requestValue": "VIE", | |
| − | + | "displayedValue": "Vienna", | |
| − | + | "dependencies": [ | |
| − | + | { | |
| − | + | "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 | ||
} | } | ||
| − | + | ] | |
| − | + | } | |
| − | + | ] | |
| − | + | } | |
| − | + | </syntaxhighlight> | |
| − | + | </TD></TR></TABLE> | |
| − | + | </div></div><br /> | |
| − | + | ||
| − | + | ===Получение семейств тарифов авиаперелетов из внешней системы (GetGDSFlightFareFamilies)=== | |
| − | + | Метод получает семейства тарифов для авиаперелетов из внешней системы. | |
| − | + | * Формат запроса: | |
| − | + | ** POST .../TourSearchOwin/GetGDSFlightFareFamilies? | |
| − | + | ||
| − | + | * Принимаемые параметры headers ( '''*''' – обязательный): | |
| − | + | ** '''Content-Type *''' – application/json | |
| − | + | ||
| − | + | * Принимаемые параметры POST запроса ( '''*''' – обязательный): | |
| − | + | ** '''flightId''' – ID внешнего перелета | |
| − | + | ** '''providerId''' – ID внешнего провайдера | |
| − | + | ** '''languageCode''' – код локализации | |
| − | + | ** '''passengers''' – информация о пассажирах | |
| − | + | *** '''IsMain''' – главный турист | |
| − | + | *** '''Number''' – порядковый номер туриста | |
| − | + | *** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант) | |
| − | + | *** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский) | |
| − | + | *** '''FirstName''' – имя (лат) | |
| − | + | *** '''LastName''' – фамилия (лат) | |
| − | + | *** '''Patronymic''' – отчество (лат) | |
| − | + | *** '''FirstNameRus''' – имя (рус) | |
| − | + | *** '''LastNameRus''' – фамилия (рус) | |
| − | + | *** '''PatronymicRus''' – отчество (рус) | |
| − | + | *** '''InternationalPassportSeries''' – серия загранпаспорта | |
| − | + | *** '''InternationalPassportNumber''' – номер загранпаспорта | |
| − | + | *** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz) | |
| − | + | *** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строке (DD.MM.YYYY) | |
| − | + | *** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz) | |
| − | + | *** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строке (DD.MM.YYYY) | |
| − | + | *** '''internationalPassportByWhom''' – кем выдан загранпаспорт | |
| − | + | *** '''PassportSeries''' – серия паспорта | |
| − | + | *** '''PassportNumber''' – номер паспорта | |
| − | + | *** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz) | |
| − | + | *** '''PassportDateOfIssueString''' – дата выдачи паспорта в строке (DD.MM.YYYY) | |
| − | + | *** '''PassportByWhom''' – кем выдан паспорт | |
| − | + | *** '''Citizenship''' – название страны | |
| − | + | *** '''Phone''' – телефон | |
| − | + | *** '''Email''' – e-mail | |
| − | + | *** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz) | |
| − | + | *** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY) | |
| − | + | *** '''BirthPlace''' – место рождения | |
| − | + | *** '''CitizenID''' – гражданство | |
| − | + | *** '''Age''' – количество полных лет на момент окончания тура | |
| − | + | ** '''currency''' – валюта | |
| − | + | ** '''price''' – стоимость | |
| − | + | ** '''param''' – параметры перелета | |
| − | + | *** '''flightsSource''' – параметры перелета | |
| − | + | **** '''flightSettings''' – информация о шаблоне услуги авиаперелета | |
| − | + | ***** '''templateId''' – идентификатор шаблона услуги | |
| − | + | ***** '''patternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров) | |
| − | + | ***** '''serviceId''' – идентификатор класса услуги (внутренняя информация из программы туров) | |
| − | + | **** '''service''' – информация об услуге авиаперелета | |
| − | + | ***** '''ServiceType''' – тип услуги | |
| − | + | ***** '''Code''' – ключ услуги | |
| − | + | ***** '''SubCode1''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 1]] | |
| − | + | ***** '''SubCode2''' – [[#Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)|доп. описание 2]] | |
| − | + | ***** '''CountryId''' – страна услуги | |
| − | + | ***** '''CityId''' – город услуги | |
| − | + | ***** '''PacketId''' – пакет услуги | |
| − | + | ***** '''PartnerId''' – партнер услуги | |
| − | + | ***** '''Day''' – день предоставления услуги | |
| − | + | ***** '''DurationInNight''' – продолжительность услуги в ночах | |
| − | + | **** '''price''' – стоимость перелета | |
| − | + | **** '''quotaInfo''' – объект информация по квотам | |
| − | + | ***** '''status''' – статус по квотам (есть места / нет мест / под запрос) | |
| − | + | ***** '''freePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''. | |
| − | + | ***** '''isFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены. | |
| − | + | **** '''flightDateTimeLimitationInterval''' – | |
| − | + | ***** '''startLimitation''' – начало тайм-лимита | |
| − | + | ***** '''finishLimitation''' – объект тайм-лимита | |
| − | + | ****** '''dateTimeString''' – дата окончания тайм-лимита | |
| − | + | ****** '''serviceType''' – тип услуги | |
| − | + | ****** '''serviceCode''' – код услуги | |
| − | + | **** '''flightSourceMode''' – тип перелета (1 – локальный, 2 – из внешний системы) | |
| − | + | *** '''passengers''' – информация о пассажирах | |
| − | + | **** '''IsMain''' – главный турист | |
| − | + | **** '''Number''' – порядковый номер туриста | |
| − | + | **** '''AgeType''' – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант) | |
| − | + | **** '''MaleFemaleSex''' – пол (0 – мужской, 1 – женский) | |
| − | + | **** '''FirstName''' – имя (лат) | |
| − | + | **** '''LastName''' – фамилия (лат) | |
| − | + | **** '''Patronymic''' – отчество (лат) | |
| − | + | **** '''FirstNameRus''' – имя (рус) | |
| − | + | **** '''LastNameRus''' – фамилия (рус) | |
| − | + | **** '''PatronymicRus''' – отчество (рус) | |
| − | + | **** '''InternationalPassportSeries''' – серия загранпаспорта | |
| − | + | **** '''InternationalPassportNumber''' – номер загранпаспорта | |
| − | + | **** '''InternationalPassportDateOfIssue''' – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz) | |
| − | + | **** '''InternationalPassportDateOfIssueString''' – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY) | |
| − | + | **** '''InternationalPassportDateOfExpiry''' – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz) | |
| − | + | **** '''InternationalPassportDateOfExpiryString''' – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY) | |
| − | + | **** '''internationalPassportByWhom''' – кем выдан загранпаспорт | |
| − | + | **** '''PassportSeries''' – серия паспорта | |
| − | + | **** '''PassportNumber''' – номер паспорта | |
| − | + | **** '''PassportDateOfIssue''' – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz) | |
| − | + | **** '''PassportDateOfIssueString''' – дата выдачи паспорта в строковом формате (DD.MM.YYYY) | |
| − | + | **** '''PassportByWhom''' – кем выдан паспорт | |
| − | + | **** '''Citizenship''' – название страны | |
| − | + | **** '''Phone''' – телефон | |
| − | + | **** '''Email''' – e-mail | |
| − | + | **** '''BirthDay''' – дата рождения (YYYY-MM-DDThh:mm:ssz) | |
| − | + | **** '''BirthDayString''' – дата рождения в строковом формате (DD.MM.YYYY) | |
| − | + | **** '''BirthPlace''' – место рождения | |
| − | + | **** '''CitizenID''' – гражданство | |
| − | + | **** '''Age''' – количество полных лет на момент окончания тура | |
| − | + | *** '''tourDate''' – дата тура | |
| − | + | *** '''tourCurrency''' – валюта тура | |
| − | + | *** '''tourId''' – ключ программы тура | |
| − | + | *** '''filterTariff''' – информация о тарифах | |
| − | + | *** '''filterDeptime''' – информация о времени вылета | |
| − | + | *** '''isCommission''' – признак комиссионной цены | |
| − | + | *** '''baseFlightsParams''' – параметра авиаперелета | |
| − | + | **** '''CityArrival''' – город прибытия | |
| − | + | **** '''FlightCode''' – код авиаперелета | |
| + | **** '''TariffKey''' – ключ тарифа | ||
| + | **** '''PartnerId''' – ключ партнера | ||
| + | *** '''isUpdated''' – информация об обновлении перелета | ||
| + | *** '''key''' – ключ запроса | ||
| + | *** '''tourDurationByDays''' – продолжительность перелета | ||
| + | *** '''langueCode''' – локализация | ||
| − | < | + | * Возвращаемый результат: |
| − | + | ** '''validationResult''' – информация о валидации | |
| − | <syntaxhighlight lang="java" enclose="div"> | + | *** '''Errors''' – ошибки |
| − | + | *** '''Warnings''' – предупреждения | |
| − | { | + | *** '''States''' – статус |
| − | " | + | *** '''IsValid''' – информация о результате |
| − | + | ** '''tariffSequencies''' – информация тарифах | |
| − | + | *** '''flightId''' – идентификатор перелета | |
| − | + | *** '''universalParametrsSequence''' – параметры тарифов | |
| − | + | **** '''universalParametrs''' – массив параметров | |
| − | + | ***** '''code''' – описание параметра тарифа | |
| − | + | ***** '''priority''' – приоритет показа | |
| − | " | + | ***** '''needToPay''' – нужна ли доплата |
| − | " | + | ***** '''shortDescriptions''' – краткое описание |
| − | + | ****** '''code''' – код | |
| − | + | ****** '''value''' – значение | |
| − | + | *** '''price''' – стоимость | |
| − | + | *** '''deltaPrice''' – разница в цене | |
| − | + | *** '''timeLimit''' – тайм-лимит | |
| − | + | *** '''segments''' – сегменты | |
| − | + | *** '''depAirportCode''' – код аэропорта отправления | |
| − | + | *** '''depCityCode''' – код города отправления | |
| − | + | *** '''arrAirportCode''' – код аэропорта прибытия | |
| − | + | *** '''arrCityCode''' – код города прибытия | |
| − | + | ||
| − | + | ||
| − | + | <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> | |
| − | + | Вызов метода GetGDSFlightFareFamilies | |
| − | + | <syntaxhighlight lang="java" enclose="div"> | |
| − | + | POST http://localhost:9000/TourSearchOwin/GetGDSFlightFareFamilies? HTTP/1.1 | |
| − | + | Content-Type: application/json | |
| − | + | ||
| − | + | { | |
| − | + | "flightId": "17554943020000", | |
| − | + | "providerId": 82, | |
| − | + | "languageCode": "ru", | |
| − | + | "passengers": [{ | |
| − | + | "IsMain": true, | |
| − | + | "Number": 1, | |
| − | + | "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 | |
| − | + | }, { | |
| − | + | "IsMain": false, | |
| − | + | "Number": 2, | |
| − | " | + | "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 | ||
} | } | ||
], | ], | ||
| − | " | + | "currency": "$", |
| − | } | + | "price": 147, |
| − | + | "param": { | |
| − | + | "flightsSource": [{ | |
| − | + | "flightSettings": { | |
| − | + | "templateId": 1, | |
| − | + | "patternId": 0, | |
| − | + | "serviceId": 0 | |
| − | + | }, | |
| − | + | "service": { | |
| − | + | "serviceType": 1, | |
| − | + | "code": 1084, | |
| − | + | "subCode1": 67, | |
| − | + | "subCode2": 1, | |
| − | + | "countryId": 90, | |
| − | + | "cityId": 35, | |
| − | + | "packetId": 1037, | |
| − | + | "partnerId": 12792, | |
| − | + | "day": 1, | |
| − | + | "durationInNight": 0 | |
| − | + | }, | |
| − | + | "price": 146.44, | |
| − | + | "quotaInfo": { | |
| − | + | "status": 4, | |
| − | + | "freePlaces": 0, | |
| − | + | "isFewPlaces": false | |
| − | + | }, | |
| − | + | "flightDateTimeLimitationInterval": { | |
| − | + | "startLimitation": null, | |
| − | + | "finishLimitation": { | |
| − | + | "dateTimeString": "2021-01-30T21:40:00", | |
| − | + | "serviceType": 3, | |
| − | + | "serviceCode": 178 | |
| − | + | } | |
| − | + | }, | |
| − | + | "flightSourceMode": 2 | |
| − | + | } | |
| − | + | ], | |
| − | + | "passengers": [{ | |
| − | } | + | "IsMain": true, |
| − | + | "Number": 1, | |
| − | + | "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 | |
| − | }, | + | }, { |
| − | + | "IsMain": false, | |
| − | + | "Number": 2, | |
| − | + | "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> | ||
| − | + | Возвращаемый результат метода GetGDSFlightFareFamilies (в формате JSON) | |
| − | < | + | <syntaxhighlight lang="java" enclose="div"> |
| − | + | [ | |
| − | + | { | |
| − | + | "validationResult": { | |
| − | + | "Errors": [], | |
| − | + | "Warnings": null, | |
| − | + | "States": null, | |
| − | + | "IsValid": true | |
| − | + | }, | |
| − | + | "tariffSequencies": [{ | |
| − | + | "flightId": "17554961000000", | |
| − | + | "universalParametrsSequence": [{ | |
| − | + | "universalParametrs": [{ | |
| − | + | "code": "description", | |
| − | + | "priority": 0, | |
| − | + | "needToPay": "Free", | |
| − | + | "shortDescriptions": [{ | |
| − | + | "code": "RU", | |
| − | + | "value": "Минимум" | |
| − | + | } | |
| − | + | ] | |
| − | + | }, { | |
| − | + | "code": "carry_on", | |
| − | + | "priority": 1, | |
| − | + | "needToPay": "Free", | |
| − | + | "shortDescriptions": [{ | |
| − | + | "code": "RU", | |
| − | + | "value": "5 кг (40x30x20 см)" | |
| − | + | } | |
| − | + | ] | |
| − | + | }, { | |
| − | + | "code": "carry_on", | |
| − | + | "priority": 2, | |
| − | + | "needToPay": "Charge", | |
| − | + | "shortDescriptions": [{ | |
| − | + | "code": "RU", | |
| − | + | "value": "10 кг (55x40x25 см)" | |
| − | + | } | |
| − | + | ] | |
| − | + | }, { | |
| − | + | "code": "baggage", | |
| − | + | "priority": 3, | |
| − | + | "needToPay": "Charge", | |
| − | + | "shortDescriptions": [{ | |
| − | + | "code": "RU", | |
| − | + | "value": "платный" | |
| − | + | } | |
| − | + | ] | |
| − | + | }, { | |
| − | + | "code": "exchangeable", | |
| − | + | "priority": 4, | |
| − | + | "needToPay": "Charge", | |
| − | + | "shortDescriptions": [{ | |
| − | + | "code": "RU", | |
| − | + | "value": "Обмен разрешен со сбором" | |
| − | + | } | |
| − | + | ] | |
| − | + | }, { | |
| − | + | "code": "refundable", | |
| − | + | "priority": 5, | |
| − | + | "needToPay": "NotAvailable", | |
| − | + | "shortDescriptions": [{ | |
| − | + | "code": "RU", | |
| − | + | "value": "Возврат запрещен" | |
| − | + | } | |
| − | + | ] | |
| − | + | } | |
| − | + | ] | |
| − | + | } | |
| − | + | ], | |
| − | + | "price": 147, | |
| − | + | "deltaPrice": 0, | |
| − | + | "timeLimit": "22.01.2021 4:08:00", | |
| − | + | "segments": [{ | |
| − | + | "depAirportCode": "VKO", | |
| − | + | "depCityCode": "MOW", | |
| − | + | "arrAirportCode": "VIE", | |
| − | + | "arrCityCode": "VIE" | |
| − | + | } | |
| − | + | ] | |
| − | + | } | |
| − | + | ], | |
| − | + | "isDone": true | |
| − | + | } | |
| − | + | ] | |
| − | + | </syntaxhighlight> | |
| − | + | </TD></TR></TABLE> | |
| − | + | </div></div><br /> | |
| − | + | ||
| − | + | ===Загрузка филиалов (Branches) начиная с релиза 15.3=== | |
| − | + | Метод производит выгрузку филиалов бронирования. | |
| − | + | * Формат запроса: | |
| − | * | + | ** GET .../TourSearchOwin/Branches? |
| − | ** | + | * Принимаемые параметры GET запроса ( '''*''' – обязательный): |
| − | * | + | ** '''ids''' – массив ключей филиалов |
| − | + | ** '''cityKey''' – фильтр по городу филиала (если 0 или не задан, то выбираются все филиалы) | |
| − | + | ||
| − | ** ''' | ||
| − | ** ''' | ||
| − | |||
| − | |||
* Возвращаемый результат: | * Возвращаемый результат: | ||
| − | ** ''' | + | ** '''Key''' – ключ филиала (ключ партнера) |
| − | ** ''' | + | ** '''Value''' – название филиала (название партнера) |
| − | + | ||
| − | + | <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> | |
| − | + | Вызов метода Branches | |
| − | + | <syntaxhighlight lang="java" enclose="div"> | |
| − | + | GET http://localhost:9000/TourSearchOwin/Branches? | |
| − | + | </syntaxhighlight> | |
| − | + | Возвращаемый результат метода Branches (в формате JSON) | |
| − | + | <syntaxhighlight lang="java" enclose="div"> | |
| − | + | [{ | |
| − | + | "Key": 12848, | |
| − | + | "Value": "Филиал 1" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 12849, | |
| − | + | "Value": "Филиал 2" | |
| − | + | }, | |
| − | + | { | |
| − | + | "Key": 12850, | |
| − | + | "Value": "Филиал 3" | |
| − | + | }] | |
| − | + | </syntaxhighlight> | |
| − | + | </TD></TR></TABLE> | |
| − | + | </div></div><br /> | |
| − | + | ||
| − | *** | + | |
| − | * | + | ===Загрузка ведущих менеджеров (Users) начиная с релиза 15.3=== |
| − | + | Метод производит выгрузку ведущих менеджеров. | |
| − | ** ''' | + | * Формат запроса: |
| − | ** ''' | + | ** GET .../TourSearchOwin/Users? |
| − | * | + | * Принимаемые параметры GET запроса ( '''*''' – обязательный): |
| − | ** ''' | + | ** '''ids''' – массив ключей ведущих менеджеров |
| − | ** ''' | + | ** '''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> | ||
| − | Вызов метода | + | Вызов метода 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"> | ||
| − | + | [{ | |
| − | + | "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 *''' – ключ города прибытия прямого перелета | |
| − | ***** '''FlightCode''' – ключ прямого авиаперелета | + | ***** '''FlightCode *''' – ключ прямого авиаперелета |
| − | ***** '''TariffKey''' – ключ тарифа прямого авиаперелета | + | ***** '''TariffKey *''' – ключ тарифа прямого авиаперелета |
| − | ***** '''PartnerId''' – ключ партнера прямого авиаперелета | + | ***** '''PartnerId *''' – ключ партнера прямого авиаперелета |
| − | ***** '''CityArrival''' – ключ города прибытия обратного перелета | + | ***** '''CityArrival *''' – ключ города прибытия обратного перелета |
| − | ***** '''FlightCode''' – ключ обратного авиаперелета | + | ***** '''FlightCode *''' – ключ обратного авиаперелета |
| − | ***** '''TariffKey''' – ключ тарифа обратного авиаперелета | + | ***** '''TariffKey *''' – ключ тарифа обратного авиаперелета |
| − | ***** '''PartnerId''' – ключ партнера обратного авиаперелета | + | ***** '''PartnerId *''' – ключ партнера обратного авиаперелета |
| − | *** '''TouristNumbersList''' – массив туристов, привязанных к услуге | + | *** '''TouristNumbersList *''' – массив туристов, привязанных к услуге |
| − | ** '''Tourists''' – массив туристов | + | ** '''Tourists *''' – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Выгрузка настройки отображения полей по туристам (TouristDataSettings)|TouristDataSettings]] по определенной стране. В каждом объекте есть поле '''IsRequired''', которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением. |
| − | + | *** '''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 *''' – дата выдачи паспорта в строковом формате (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": " | + | "BirthDay": "1980-01-01T00:00:00.000Z", |
"BirthDayString": "01.01.1980", | "BirthDayString": "01.01.1980", | ||
"BirthPlace": "Москва", | "BirthPlace": "Москва", | ||
| Строка 5889: | Строка 7452: | ||
"Phone": "", | "Phone": "", | ||
"Email": "", | "Email": "", | ||
| − | "BirthDay": " | + | "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 /> | ||
| − | === | + | ===Бронирование путевки с упрощенными входными параметрами (CreateReservationExternalSystem)=== |
| − | Метод | + | Метод производит бронирование путевки с упрощенными входными параметрами. <br /> |
| + | При бронировании проверяется корректность заполнения обязательных полей туристов. В случае, если обязательные поля не заполнены, возвращается ошибка с сообщением, бронь не создается. | ||
| + | Данный метод разработан индивидуально для одного из клиентов. В обычном режиме нужно пользоваться всегда методом [[Мастер-Тур(15):API для разработки онлайн поиска и бронирования#Бронирование путевки (CreateReservation)|Бронирование путевки (CreateReservation)]] | ||
| − | * Формат запроса: | + | *Формат запроса: |
| − | ** | + | ** 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 /> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | <div class="toccolours mw-collapsible mw-collapsed" style="width: | + | <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> | ||
| − | + | Возвращаемый результат метода CreateReservationExternalSystem (в формате JSON) | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | Возвращаемый результат метода | ||
<syntaxhighlight lang="java" enclose="div"> | <syntaxhighlight lang="java" enclose="div"> | ||
{ | { | ||
| − | "$id": 1, | + | "Reservation": { |
| − | + | "$id": 1, | |
| − | + | "Code": "RU27010037", | |
| − | + | "TurDate": "2025-01-27T12:00:00", | |
| − | + | "TRKey": 0, | |
| − | + | "CNKey": 460, | |
| − | + | "CTKey": 1, | |
| − | + | "NMen": 2, | |
| − | + | "Price": 9900.0, | |
| − | + | "Payed": 0.0, | |
| − | + | "NDay": 4, | |
| − | + | "MainMan": "Тестовый Представитель", | |
| − | + | "MainManPhone": "+79139992222", | |
| − | + | "MainManAddress": "", | |
| − | + | "MainManPassport": "11111 2222222222222", | |
| − | + | "PartnerKey": 12667, | |
| − | + | "Operator": "Allservises A.A.", | |
| − | + | "Discount": 17.0, | |
| − | + | "DiscountSum": 0.0, | |
| − | + | "SORCode": 0, | |
| − | + | "CrDate": "2025-01-24T17:26:17.25", | |
| − | + | "Rate": "рб", | |
| − | + | "Advertise": 0, | |
| − | + | "Locked": null, | |
| − | + | "CauseDisc": 0, | |
| − | + | "PPaymentDate": null, | |
| − | + | "PaymentDate": "2025-01-26T00:00:00", | |
| − | + | "Procent": 1, | |
| − | + | "TurDateBfrAnnul": null, | |
| − | + | "ARKey": 0, | |
| − | + | "Key": 54010, | |
| − | + | "CodePartner": null, | |
| − | + | "FilialKey": 12850, | |
| − | + | "IsOutDoc": 0, | |
| − | + | "Notes": null, | |
| − | + | "DiscSumBfrAnn": null, | |
| − | + | "PriceBfrAnn": null, | |
| − | + | "RazmerP": 10.0, | |
| − | + | "LeadDepartment": 0, | |
| − | + | "MainManEmail": "test@megatec.ru", | |
| − | + | "MainManComment": "", | |
| − | + | "DupUserKey": 333, | |
| − | + | "BTKey": 1, | |
| − | + | "ConfirmedDate": null, | |
| − | + | "PrtDogKey": 1335, | |
| − | + | "CTDepartureKey": 0, | |
| − | + | "PDTType": 0, | |
| − | + | "NationalCurrencyPrice": null, | |
| − | + | "NationalCurrencyDiscountSum": null, | |
| − | + | "NationalCurrencyPayed": null, | |
| − | + | "CurrencyKey": null, | |
| − | + | "CurrencyRate": null, | |
| − | + | "ClientKey": null, | |
| − | + | "AgencyPrice": 0.0, | |
| − | + | "Partner": { | |
| − | + | "$id": 2, | |
| − | + | "Key": 12667, | |
| − | + | "FullName": "Партнер-покупатель (полное название)", | |
| − | + | "Name": "Партнер-покупатель122" | |
| − | + | }, | |
| − | + | "Services": [ | |
| − | + | { | |
| − | + | "$id": 3, | |
| − | + | "DGCod": "RU27010037", | |
| − | + | "TurDate": "2025-01-27T12:00:00", | |
| − | + | "Key": 250570, | |
| − | + | "PaketKey": 2043, | |
| − | + | "TRKey": 0, | |
| − | + | "SVKey": 3, | |
| − | + | "Name": "HOTEL::Москва/ApiHotel-,3 ночи/ApiRoom(ApiRoomCategory),ApiAccmdmen/ApiPansion ApiPansion", | |
| − | + | "Day": 1, | |
| − | + | "Code": 341264, | |
| − | + | "SubCode1": 1552918, | |
| − | + | "SubCode2": 1812, | |
| − | + | "Men": 2, | |
| − | + | "Days": 3, | |
| − | + | "CNKey": 460, | |
| − | + | "CTKey": 1, | |
| − | + | "PartnerKey": 0, | |
| − | + | "Brutto": 9900.0, | |
| − | + | "Wait": null, | |
| − | + | "Warning": 0, | |
| − | + | "TimeBeg": "1899-01-01T00:00:00", | |
| − | + | "Control": 1, | |
| − | + | "Attribute": 65695, | |
| − | + | "DateBeg": "2025-01-27T00:00:00", | |
| − | + | "DateEnd": "2025-01-29T00:00:00", | |
| − | + | "Discount": 0.0, | |
| − | + | "Comment": null, | |
| − | + | "DGKey": 54010, | |
| − | + | "Blocked": null, | |
| − | + | "NameLat": "HOTEL::Москва/ApiHotel-,3 ночи/ApiRoom(ApiRoomCategory),ApiAccmdmen/ApiPansion ApiPansion", | |
| − | + | "Long": 4, | |
| − | + | "TRFId": 0, | |
| − | + | "CreateDate": "2025-01-24T17:26:17.25", | |
| − | + | "CalculatePriceDate": "2025-01-24T17:26:17.25", | |
| − | } | + | "ShowOrder": 1, |
| − | + | "Connections": [ | |
| − | + | { | |
| − | + | "$ref": 1 | |
| − | + | } | |
| − | + | ] | |
| − | + | } | |
| − | + | ], | |
| − | + | "Turists": [ | |
| − | + | { | |
| − | + | "$id": 4, | |
| − | + | "DGCod": "RU27010037", | |
| − | + | "Key": 120806, | |
| − | + | "TurDate": "2025-01-27T12:00:00", | |
| − | + | "NameRus": "Иванов", | |
| − | + | "NameLat": "Иванов", | |
| − | + | "ShortName": "И.И.", | |
| − | + | "Sex": 0, | |
| − | + | "FNameRus": "Иван", | |
| − | + | "FNameLat": "Иван", | |
| − | + | "SNameRus": "Иванович", | |
| − | + | "SNameLat": "Иванович", | |
| − | + | "BirthDay": "2007-01-24T00:00:00", | |
| − | + | "BirthCountry": null, | |
| − | + | "BirthCity": null, | |
| − | + | "Citizen": null, | |
| − | + | "PostIndex": null, | |
| − | + | "PostCity": null, | |
| − | + | "PostStreet": null, | |
| − | + | "PostBild": null, | |
| − | + | "PostFlat": null, | |
| − | + | "Phone": "79876543232", | |
| − | + | "PhoneCode": null, | |
| − | + | "PasportType": "", | |
| − | + | "PasportNum": "", | |
| − | + | "PasportDate": null, | |
| − | + | "PasportDateEnd": null, | |
| − | + | "PasportByWhom": null, | |
| − | + | "Place": null, | |
| − | + | "IsAnketa": null, | |
| − | + | "PaspRuser": "", | |
| − | + | "PaspRuNum": "", | |
| − | + | "PaspRuDate": null, | |
| − | + | "PaspRuByWhom": "", | |
| − | + | "ClientId": null, | |
| − | + | "IsMain": 1, | |
| − | + | "DGKey": 54010, | |
| − | + | "RealSex": 0, | |
| − | + | "Email": "emailqwerty123@example.com", | |
| − | + | "EnableSmsNotifications": 0, | |
| − | + | "CitizenId": "", | |
| − | + | "Connections": [ | |
| − | + | { | |
| − | + | "$ref": 1 | |
| − | + | } | |
| − | + | ] | |
| − | + | }, | |
| − | + | { | |
| − | + | "$id": 5, | |
| − | + | "DGCod": "RU27010037", | |
| − | + | "Key": 120805, | |
| − | + | "TurDate": "2025-01-27T12:00:00", | |
| − | + | "NameRus": "Петров", | |
| − | + | "NameLat": "Петров", | |
| − | + | "ShortName": "П.П.", | |
| − | + | "Sex": 0, | |
| − | + | "FNameRus": "Петр", | |
| − | + | "FNameLat": "Петр", | |
| − | + | "SNameRus": "Петрович", | |
| − | + | "SNameLat": "Петрович", | |
| − | + | "BirthDay": "2007-01-24T00:00:00", | |
| − | + | "BirthCountry": null, | |
| − | + | "BirthCity": null, | |
| − | + | "Citizen": null, | |
| − | + | "PostIndex": null, | |
| − | + | "PostCity": null, | |
| − | + | "PostStreet": null, | |
| − | + | "PostBild": null, | |
| − | + | "PostFlat": null, | |
| − | + | "Phone": null, | |
| − | + | "PhoneCode": null, | |
| − | + | "PasportType": "", | |
| − | + | "PasportNum": "", | |
| − | + | "PasportDate": null, | |
| − | + | "PasportDateEnd": null, | |
| − | + | "PasportByWhom": null, | |
| − | + | "Place": null, | |
| − | + | "IsAnketa": null, | |
| − | + | "PaspRuser": "", | |
| − | + | "PaspRuNum": "", | |
| − | + | "PaspRuDate": null, | |
| − | + | "PaspRuByWhom": "", | |
| − | + | "ClientId": null, | |
| − | + | "IsMain": 0, | |
| − | + | "DGKey": 54010, | |
| − | + | "RealSex": 0, | |
| − | + | "Email": "", | |
| − | + | "EnableSmsNotifications": 0, | |
| − | " | + | "CitizenId": "", |
| − | + | "Connections": [ | |
| − | + | { | |
| − | + | "$ref": 1 | |
| − | + | } | |
| − | + | ] | |
| − | + | } | |
| − | + | ], | |
| − | + | "TuristServices": [ | |
| − | + | { | |
| − | + | "$id": 6, | |
| − | + | "TUKey": 120806, | |
| − | + | "DLKey": 250570, | |
| − | + | "NumDoc": null, | |
| − | + | "NumRoom": 0, | |
| − | " | + | "Seat": null, |
| − | + | "Area": null, | |
| − | + | "DocDate": null, | |
| − | + | "Key": 134191, | |
| − | + | "Connections": [ | |
| − | + | { | |
| − | + | "$ref": 1 | |
| − | + | }, | |
| − | + | { | |
| − | + | "$ref": 3 | |
| − | " | + | }, |
| − | " | + | { |
| − | " | + | "$ref": 4 |
| − | " | + | } |
| − | + | ] | |
| − | + | }, | |
| − | + | { | |
| − | + | "$id": 7, | |
| − | + | "TUKey": 120805, | |
| − | + | "DLKey": 250570, | |
| − | + | "NumDoc": null, | |
| − | + | "NumRoom": 0, | |
| − | + | "Seat": null, | |
| − | + | "Area": null, | |
| − | + | "DocDate": null, | |
| − | + | "Key": 134190, | |
| − | + | "Connections": [ | |
| − | + | { | |
| − | + | "$ref": 1 | |
| − | + | }, | |
| − | + | { | |
| − | + | "$ref": 3 | |
| − | + | }, | |
| − | + | { | |
| − | + | "$ref": 5 | |
| − | + | } | |
| − | + | ] | |
| − | + | } | |
| − | + | ], | |
| − | + | "DogovorMessages": [ | |
| − | + | { | |
| − | + | "$id": 8, | |
| − | + | "Date": "2025-01-24T17:26:18.26", | |
| − | + | "Text": "Это тестовая путевка", | |
| − | + | "Remark": "от агента", | |
| − | + | "Connections": [ | |
| − | + | { | |
| − | + | "$ref": 1 | |
| − | + | } | |
| − | + | ] | |
| − | + | } | |
| − | + | ] | |
| − | + | }, | |
| − | + | "UsedMailService": false, | |
| − | + | "ValidationResultSummary": { | |
| − | + | "ValidationResult": { | |
| − | + | "Errors": [], | |
| − | + | "Warnings": null, | |
| − | + | "States": null, | |
| − | + | "IsValid": true | |
| − | + | }, | |
| − | + | "ValidationResultAttributes": 0 | |
| − | + | } | |
| − | + | } | |
| − | + | </syntaxhighlight> | |
| − | + | </TD></TR></TABLE> | |
| − | + | </div></div><br /> | |
| − | + | ||
| − | + | ===Выгрузка информации о путевке (GetReservation)=== | |
| − | + | Метод выводит информацию о бронированной путевке. | |
| − | + | ||
| − | + | * Формат запроса: | |
| − | + | ** GET .../TourSearchOwin/GetReservation? | |
| − | + | ||
| − | + | * Принимаемые параметры headers ( '''*''' – обязательный): | |
| − | + | ** '''Content-Type *''' – application/json | |
| − | + | ** '''Authorization *''' – token_type + access_token (полученные из метода .../TourSearchOwin/Token?) | |
| − | + | ||
| − | + | * Принимаемые параметры GET запроса ( '''*''' – обязательный): | |
| − | + | ** '''dgCode *''' – номер путевки: | |
| − | + | ||
| − | + | * Возвращаемый результат: | |
| − | + | ** '''$id''' – внутренний идентификатор для установки связей между сущностями, | |
| − | + | ** '''Code''' – код путевки | |
| − | + | ** '''TurDate''' – дата заезда | |
| − | + | ** '''TRKey''' – ключ тура | |
| − | + | ** '''CNKey''' – ключ страны | |
| − | + | ** '''CTKey''' – ключ города | |
| − | + | ** '''NMen''' – количество туристов по путевке | |
| − | + | ** '''Price''' – стоимость путевки за вычетом скидки (комиссии) | |
| − | + | ** '''Payed''' – оплаченная сумма по путевке | |
| − | + | ** '''NDay''' – продолжительность тура в днях | |
| − | + | ** '''MainMan''' – ФИО лица, заключившего договор | |
| − | + | ** '''MainManPhone''' – номер телефона лица, заключившего договор | |
| − | + | ** '''MainManAddress''' – адрес лица, заключившего договор | |
| − | + | ** '''MainManPassport''' – паспортные данные лица, заключившего договор | |
| − | + | ** '''PartnerKey''' – ключ партнера, оформившего договор | |
| − | + | ** '''Operator''' – ФИО создателя договора | |
| − | + | ** '''Discount''' – величина скидки на одного человека | |
| − | + | ** '''DiscountSum''' – абсолютная величина скидки | |
| − | + | ** '''SORCode''' – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок. | |
| − | + | ** '''CrDate''' – дата и время создания путевки | |
| − | + | ** '''Rate''' – код валюты путевки | |
| − | + | ** '''Advertise''' – ключ источника рекламы | |
| − | + | ** '''Locked''' – блокировка путевки: ''1'' – если заблокирована | |
| − | + | ** '''CauseDisc''' – ключ основания для скидки | |
| − | + | ** '''PPaymentDate''' – максимальная дата внесения предоплаты | |
| − | + | ** '''PaymentDate''' – максимальная дата полной оплаты | |
| − | + | ** '''Procent''' – информация о предоплате: ''1'' – предоплата в %; ''0'' – предоплата в у.е. | |
| − | + | ** '''TurDateBfrAnnul''' – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899) | |
| − | + | ** '''ARKey''' – ключ причины аннуляции путевки | |
| − | + | ** '''Key''' – ключ договора | |
| − | + | ** '''CodePartner''' – значение ключевого поля из таблицы партнеров | |
| − | + | ** '''FilialKey''' – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка | |
| − | + | ** '''IsOutDoc''' – статус выдачи документов | |
| − | + | ** '''Notes''' – сообщение поставщику | |
| − | + | ** '''DiscSumBfrAnn''' – числовое значение скидки перед аннуляцией путевки | |
| − | + | ** '''PriceBfrAnn''' – стоимость путевки перед ее аннуляцией | |
| − | + | ** '''RazmerP''' – размер предоплаты | |
| − | + | ** '''LeadDepartment''' – ключ отдела, ведущего данный тур | |
| − | + | ** '''MainManEmail''' – адрес е-mail из данных лица, заключившего договор | |
| − | + | ** '''MainManComment''' – примечание из данных лица, заключившего договор | |
| − | + | ** '''DupUserKey''' – ключ представителя партнера, которым был оформлен договор | |
| − | + | ** '''BTKey''' – ключ системы бронирования, из которой был оформлен договор | |
| − | + | ** '''ConfirmedDate''' – дата подтверждения путевки покупателю | |
| − | + | ** '''PrtDogKey''' – договор партнера, по которому оформлена путевка | |
| − | + | ** '''CTDepartureKey''' – ключ города начала поездки | |
| − | + | ** '''PDTType''' – тип договора, по которому оформлена путевка | |
| − | + | ** '''NationalCurrencyPrice''' – стоимость путевки в национальной валюте | |
| − | + | ||