Мастер-Тур(15):API для разработки онлайн поиска и бронирования — различия между версиями
[досмотренная версия] | [досмотренная версия] |
Biryukov (обсуждение | вклад) (→Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)) |
Biryukov (обсуждение | вклад) (→Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)) |
||
Строка 8264: | Строка 8264: | ||
"15.05.2021" | "15.05.2021" | ||
] | ] | ||
+ | </syntaxhighlight> | ||
+ | </TD></TR></TABLE> | ||
+ | </div></div><br /> | ||
+ | |||
+ | ===Поиск туров в оформлении клиентов (Search)=== | ||
+ | Метод возвращает наиболее дешевое предложения по определенному туру. | ||
+ | * Формат запроса: | ||
+ | ** GET .../TourSearchOwin/RegistrationClient/Search? | ||
+ | * Принимаемые параметры ( '''*''' – обязательный): | ||
+ | ** '''DepartureCityKeys *''' – ключ города отправления (из контроллера [[#Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)|''.../TourSearchOwin/RegistrationClientsDepartureCities?'']]) | ||
+ | ** '''Dates *''' – дата заезда (из контроллера [[#Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)|''.../TourSearchOwin/RegistrationClientsTourDate?'']]) | ||
+ | ** '''Durations *''' – продолжительность | ||
+ | ** '''PageNumber *''' – номер возвращаемой страницы (по умолчанию возвращается 1) | ||
+ | ** '''PageSize *''' – количество возвращаемых результатов на одной странице (возвращается 20) | ||
+ | ** '''isFromBasket *''' – всегда false | ||
+ | ** '''isFillSecondaryFilters *''' – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true) | ||
+ | ** '''DestinationType *''' – тип результата (всегда возвращается в JSON = 1, в xml = country) | ||
+ | ** '''DestinationKey *''' – идентификатор страны прибытия (из контроллера [[#Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)|''.../TourSearchOwin/RegistrationClientsDestination?'']]) | ||
+ | ** '''AdultCount *''' – количество взрослых | ||
+ | ** '''ChildAges''' – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром. | ||
+ | ** '''IsRegistrationClients''' – по умолчанию всегда приходит false | ||
+ | ** '''CurrencyName *''' – код валюты | ||
+ | ** '''AviaQuota *''' – информация о квотах на авиаперелет (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все") | ||
+ | ** '''HotelQuota *''' – информация о квотах на отель (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все") | ||
+ | ** '''BusTransferQuota''' – информация о квотах на автобусный переезд (значения параметров: ''"1"'' — фильтр "Есть", ''"5"'' — фильтр "Есть+запрос", ''"7"'' — фильтр "Все") | ||
+ | ** '''HotelScheme''' – пустой по умолчанию | ||
+ | ** '''TimeDepartureFrom''' – время отправления с (по умолчанию возвращается 00:00) | ||
+ | ** '''TimeDepartureTo''' – время отправления по (по умолчанию возвращается 23:59) | ||
+ | ** '''TimeArrivalFrom''' – время прибытия с (по умолчанию возвращается 00:00) | ||
+ | ** '''TimeArrivalTo''' – время прибытия по (по умолчанию возвращается 23:59) | ||
+ | ** '''ArrivalFlightNoTransfer''' – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false) | ||
+ | ** '''DepartureFlightNoTransfer''' – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false) | ||
+ | ** '''TourDuration''' – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях | ||
+ | ** '''Tour''' – ключ программы тура | ||
+ | |||
+ | * Возвращаемый результат: | ||
+ | ** '''CheckMessages''' – сообщения для логики проверки тура (не используется) | ||
+ | ** '''Message''' – сообщение об ошибке | ||
+ | *** '''Key''' – код ошибки | ||
+ | *** '''Value''' – сообщение об ошибке | ||
+ | ** '''Result''' – результаты поиска | ||
+ | *** '''Key''' – идентификатов программы тура | ||
+ | *** '''Name''' – название программы тура | ||
+ | *** '''TourUrl''' – ссылка на программу тура | ||
+ | *** '''BookingConditions''' – условия бронирования программы туров | ||
+ | *** '''StartDate''' – дата начала тура | ||
+ | *** '''Duration''' – продолжительность тура (в днях) | ||
+ | *** '''DurationInNight''' – продолжительность проживания (в ночах) | ||
+ | *** '''Types''' – идентификатор типа туров | ||
+ | *** '''Cost''' – цена тура | ||
+ | *** '''Rate''' – код валюты тура | ||
+ | *** '''CityDepature''' – город отправления | ||
+ | **** '''Key''' – идентификатор города отправления | ||
+ | **** '''Value''' – название города отправления | ||
+ | *** '''CountryId''' – всегда возвращается ключ 0 | ||
+ | *** '''Services''' – услуги в туре | ||
+ | **** '''DepartureCity''' – город отправления | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''DepartureCountry''' – страна отправления | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''ArrivalCity''' – город прибытия | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''ArrivalCountry''' – страна прибытия | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''DepartureAirport''' – аэропорт отправления | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''ArrivalAirport''' – аэропорт прибытия | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''Airline''' – авиакомпания | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''Aircraft''' – воздушное судно | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''Flight''' – рейс | ||
+ | ***** '''Key''' – идентификатор | ||
+ | ***** '''Value''' – название | ||
+ | **** '''DepartureTime''' – время вылета | ||
+ | **** '''ArrivalTime''' – время прилета | ||
+ | **** '''EndDateTime''' – дата и время прилета | ||
+ | **** '''FlightDetails''' – информация об авиаперелете | ||
+ | ***** '''Tariff''' – информация о тарифе перелета | ||
+ | ****** '''Key''' – идентификатор | ||
+ | ****** '''Code''' – код тарифа | ||
+ | ****** '''Name''' – название тарифа | ||
+ | ***** '''Cost''' – разница в стоимости с самым дешевым вариантом | ||
+ | ***** '''QuotaStatus''' – информация о квоте | ||
+ | ****** '''PlacesStatus''' – статус по квотам (есть места / нет мест / под запрос) | ||
+ | ****** '''FreePlaces''' – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре '''PlacesStatus'''. | ||
+ | ****** '''IsFewPlaces''' – выполнены ли условия, заданные в настройке "Мало": '''true''' – если заданы условия количества мест "Мало" и данные условия выполнены, '''false''' – если не заданы условия количества мест "Мало" или они заданы, но не выполнены. | ||
+ | ***** '''PartnerId''' – ключ партнера | ||
+ | ***** '''ByPax''' – цена за человека (true/false) | ||
+ | ***** '''Partner''' – информация о партнере | ||
+ | ****** '''Key''' – идентификатор | ||
+ | ****** '''Value''' – название | ||
+ | **** '''FlightSetting''' – внутренняя информация о перелете из программы туров | ||
+ | ***** '''ServiceId''' – идентификатор класса услуги (внутренняя информация из программы туров) | ||
+ | ***** '''PatternId''' – идентификатор паттерна услуги (внутренняя информация из программы туров) | ||
+ | ***** '''FlightId''' – идентификатор перелета (внутренняя информация из программы туров) | ||
+ | **** '''FlightSourceMode''' – локальный или удаленный перелет (внутренняя информация из программы туров) | ||
+ | **** '''Id''' – идентификатор базового шаблона услуги (внутренняя информация из программы туров) | ||
+ | **** '''SvKey''' – ключ типа услуги | ||
+ | **** '''IsSubCode1''' – признак наличия [[#Приложение 1: параметры услуги (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''' – ключ страны | ||
+ | **** '''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''' – статус по квотам (есть места / нет мест / под запрос) | ||
+ | ****** '''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''' – результаты доп. фильтров | ||
+ | *** '''TourTypes''' – типы тура | ||
+ | **** '''Id''' – ключ типа тура | ||
+ | **** '''Name''' – название типа тура | ||
+ | **** '''ParentId''' – родительский элемент типа тура (если есть) | ||
+ | **** '''Type''' – тип справочника (используется для внутренних целей) | ||
+ | *** '''TourPrograms''' – информация по каждой турпрограмме | ||
+ | **** '''Key''' – ключ турпрограммы | ||
+ | **** '''Name''' – название турпрограммы | ||
+ | **** '''TourUrl''' – ссылка на тур | ||
+ | **** '''BookingConditions''' – условия бронирования | ||
+ | **** '''IsLandOnly''' – признак только наземное обслуживание | ||
+ | **** '''IsRestrictMultiHotels''' – ограничивать ли расчёт многоотельных туров категориями отелей | ||
+ | **** '''IsHotelTemplates''' – есть ли вообще отели в данной турпрограмме | ||
+ | **** '''IsRouteServices''' – есть ли маршрутные услуги | ||
+ | **** '''MultiHotelDelta''' – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати. | ||
+ | **** '''Rate''' – валюта тура | ||
+ | **** '''DateStart''' – нижняя граница дат заезда по программе тура | ||
+ | **** '''DateEnd''' – верхняя граница дат заеда по программе тура | ||
+ | **** '''Status''' – статус турпрограммы | ||
+ | ***** '''Key''' – ключ | ||
+ | ***** '''Value''' – значение | ||
+ | **** '''Templates''' – шаблоны услуг | ||
+ | ***** '''$id''' – шаблон 1 | ||
+ | ***** '''$id''' – шаблон 2 | ||
+ | **** '''Types''' – типы тура | ||
+ | ***** '''Id''' – ключ типа тура | ||
+ | ***** '''Name''' – название типа тура | ||
+ | ***** '''ParentId''' – родительский элемент типа тура (если есть) | ||
+ | ***** '''Type''' – тип справочника (используется для внутренних целей) | ||
+ | **** '''LinkingFlightsRules''' – правила связывания перелетов | ||
+ | ***** '''notCombineDifferentAirlineRule''' – | ||
+ | ****** '''airlines''' – | ||
+ | ****** '''flightSettings''' – | ||
+ | ****** '''enabled''' – | ||
+ | ***** '''checkPlusMinus1CharterRule''' – | ||
+ | ****** '''FlightSettingPairs''' – | ||
+ | ****** '''enabled''' – | ||
+ | ***** '''notCombineDifferentTariffGroupRule''' – | ||
+ | ****** '''FlightSettings''' – | ||
+ | ****** '''enabled''' – | ||
+ | ***** '''notCombineDifferentPartnerRule''' – | ||
+ | ****** '''FlightSettings''' – | ||
+ | ****** '''enabled''' – | ||
+ | ***** '''departureCityEqualsArrivalCityRule''' – | ||
+ | ****** '''FlightSettingPairs''' – | ||
+ | ****** '''enabled''' – | ||
+ | ***** '''combineOnlySpecificChartersRule''' – | ||
+ | ****** '''settings''' – | ||
+ | ****** '''enabled''' – | ||
+ | **** '''XmlSettings''' – строка xml для актуальных фильтров | ||
+ | **** '''Type''' – тип справочника (используется для внутренних целей) | ||
+ | *** '''TourDurations''' – продолжительность тура | ||
+ | *** '''TourDates''' – список дат заездов в турпрограмме | ||
+ | **** '''HotelCities''' – город в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''HotelResorts''' – курорты в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''HotelCategories''' – категории отеля в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''Hotels''' – отели в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''Pansions''' – питания в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''Airlines''' – авиакомпании в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''FlightTariffs''' – класс перелета в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''DepartureCities''' – города вылета в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''DepartureAirports''' – аэропорты вылета в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''ArrivalCities''' – города прибытия в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''ArrivalAirports''' – аэропорты прибытия в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | **** '''HotelTypes''' – признаки отелей в дополнительных фильтрах | ||
+ | ***** '''''' – | ||
+ | |||
+ | <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 | ||
+ | <syntaxhighlight lang="java" enclose="div"> | ||
+ | GET http://localhost:9000/TourSearchOwin/Tour?DepartureCityKeys=1&Dates=25.02.2018&Durations=4 | ||
+ | &PageNumber=1&PageSize=20&HotelScheme=&TourKey=&TourDuration=&isFromBasket=false | ||
+ | &isFillSecondaryFilters=true&DestinationType=1&DestinationKey=90&AdultCount=2&ChildAges=2 | ||
+ | &ChildAges=2&CurrencyName=EU&AviaQuota=5&HotelQuota=5&BusTransferQuota=5&MinPrice=NaN&TourType=-1 | ||
+ | &CityIds=-1&TimeDepartureFrom=00%3A00&TimeDepartureTo=23%3A59&TimeArrivalFrom=00%3A00 | ||
+ | &TimeArrivalTo=23%3A59&ArrivalFlightNoTransfer=false&DepartureFlightNoTransfer=false | ||
+ | </syntaxhighlight> | ||
+ | Возвращаемый результат метода Tour (в формате JSON) | ||
+ | <syntaxhighlight lang="java" enclose="div"> | ||
+ | { | ||
+ | "CheckMessages": null, | ||
+ | "Message": { | ||
+ | "Key": 0, | ||
+ | "Value": null | ||
+ | }, | ||
+ | "Result": [ | ||
+ | { | ||
+ | "Key": 100000004, | ||
+ | "Name": "Общая проверка системы", | ||
+ | "TourUrl": "www.megatec.ru", | ||
+ | "BookingConditions": "<p>Условия бронирования тура.<\/p>", | ||
+ | "StartDate": "2018-02-25T00:00:00", | ||
+ | "Duration": 4, | ||
+ | "DurationInNight": 3, | ||
+ | "Types": [2], | ||
+ | "Cost": 260, | ||
+ | "Rate": "EU", | ||
+ | "CityDepature": { | ||
+ | "Key": 1, | ||
+ | "Value": "Москва" | ||
+ | }, | ||
+ | "CountryId": 0, | ||
+ | "Services": [ | ||
+ | { | ||
+ | "DepartureCity": { | ||
+ | "Key": 1, | ||
+ | "Value": "Москва" | ||
+ | }, | ||
+ | "DepartureCountry": { | ||
+ | "Key": 460, | ||
+ | "Value": "Россия" | ||
+ | }, | ||
+ | "ArrivalCity": { | ||
+ | "Key": 35, | ||
+ | "Value": "Вена" | ||
+ | }, | ||
+ | "ArrivalCountry": { | ||
+ | "Key": 90, | ||
+ | "Value": "Австрия" | ||
+ | }, | ||
+ | "DepartureAirport": { | ||
+ | "Key": "SVO4", | ||
+ | "Value": "Шереметьево-24" | ||
+ | }, | ||
+ | "ArrivalAirport": { | ||
+ | "Key": "VIE1", | ||
+ | "Value": "Vena1" | ||
+ | }, | ||
+ | "Airline": { | ||
+ | "Key": "BA7", | ||
+ | "Value": "BRITISH AIRWAYS" | ||
+ | }, | ||
+ | "Aircraft": { | ||
+ | "Key": "319", | ||
+ | "Value": "AIRBUS " | ||
+ | }, | ||
+ | "Flight": { | ||
+ | "Key": 882, | ||
+ | "Value": "4444" | ||
+ | }, | ||
+ | "DepartureTime": "10:00:00", | ||
+ | "ArrivalTime": "12:00:00", | ||
+ | "EndDateTime": "2018-02-25T12:00:00", | ||
+ | "FlightDetails": [ { | ||
+ | "Tariff": { | ||
+ | "Key": 89, | ||
+ | "Code": "Y", | ||
+ | "Name": "Экономический класс" | ||
+ | }, | ||
+ | "Cost": 10, | ||
+ | "QuotaStatus": { | ||
+ | "PlacesStatus": 4, | ||
+ | "FreePlaces": 0, | ||
+ | "IsFewPlaces": false | ||
+ | }, | ||
+ | "PartnerId": 12668, | ||
+ | "ByPax": true, | ||
+ | "Partner": { | ||
+ | "Key": 0, | ||
+ | "Value": null | ||
+ | } | ||
+ | }], | ||
+ | "FlightSetting": { | ||
+ | "ServiceId": 3, | ||
+ | "PatternId": 13, | ||
+ | "FlightId": 13 | ||
+ | }, | ||
+ | "FlightSourceMode": 1, | ||
+ | "Id": 3, | ||
+ | "SvKey": 1, | ||
+ | "IsSubCode1": true, | ||
+ | "IsSubCode2": false, | ||
+ | "IsPartnerBasedOn": false, | ||
+ | "Day": 1, | ||
+ | "DurationInNight": 0, | ||
+ | "BeginDateTime": "2018-02-25T10:00:00", | ||
+ | "IsHooded": false, | ||
+ | "IsDeleted": false, | ||
+ | "IsNotCalculate": false, | ||
+ | "PacketId": 779, | ||
+ | "Index": 0 | ||
+ | }, | ||
+ | { | ||
+ | "Hotel": { | ||
+ | "Key": 709, | ||
+ | "Value": "Am Brilliantengrund" | ||
+ | }, | ||
+ | "City": { | ||
+ | "Key": 35, | ||
+ | "Value": "Вена" | ||
+ | }, | ||
+ | "Stars": { | ||
+ | "Key": -1, | ||
+ | "Value": null | ||
+ | }, | ||
+ | "Resort": { | ||
+ | "Key": -1, | ||
+ | "Value": null | ||
+ | }, | ||
+ | "ImageURL": "", | ||
+ | "Http": null, | ||
+ | "Description": "", | ||
+ | "Country": { | ||
+ | "Key": 90, | ||
+ | "Value": "Австрия" | ||
+ | }, | ||
+ | "HotelDetails": [ { | ||
+ | "HotelRoom": 46463, | ||
+ | "Room": { | ||
+ | "Key": 129, | ||
+ | "Value": "DBL" | ||
+ | }, | ||
+ | "RoomCategory": { | ||
+ | "Key": 3493, | ||
+ | "Value": "Cosy" | ||
+ | }, | ||
+ | "AccomodationType": { | ||
+ | "Key": 1256, | ||
+ | "Value": "2+1_K", | ||
+ | "AdultCount": 2, | ||
+ | "ChildCount": 1 | ||
+ | }, | ||
+ | "Pansion": { | ||
+ | "Key": 4, | ||
+ | "Value": "Завтрак" | ||
+ | }, | ||
+ | "Cost": 19.47, | ||
+ | "QuotaStatus": { | ||
+ | "PlacesStatus": 4, | ||
+ | "FreePlaces": 0, | ||
+ | "IsFewPlaces": false | ||
+ | }, | ||
+ | "PartnerId": 12667, | ||
+ | "ByPax": false, | ||
+ | "Partner": { | ||
+ | "Key": 12667, | ||
+ | "Value": "Партнер-покупатель1" | ||
+ | } | ||
+ | }], | ||
+ | "HotelTypes": [ { | ||
+ | "Key": 5, | ||
+ | "Value": "Рекомендуемые" | ||
+ | }], | ||
+ | "Id": 1, | ||
+ | "SvKey": 3, | ||
+ | "IsSubCode1": true, | ||
+ | "IsSubCode2": true, | ||
+ | "IsPartnerBasedOn": false, | ||
+ | "Day": 1, | ||
+ | "DurationInNight": 3, | ||
+ | "BeginDateTime": "2018-02-25T12:00:00", | ||
+ | "EndDateTime": "2018-02-28T12:00:00", | ||
+ | "IsHooded": false, | ||
+ | "IsDeleted": false, | ||
+ | "IsNotCalculate": false, | ||
+ | "PacketId": 779, | ||
+ | "Index": 1 | ||
+ | }, | ||
+ | { | ||
+ | "DepartureCity": { | ||
+ | "Key": 35, | ||
+ | "Value": "Вена" | ||
+ | }, | ||
+ | "DepartureCountry": { | ||
+ | "Key": 90, | ||
+ | "Value": "Австрия" | ||
+ | }, | ||
+ | "ArrivalCity": { | ||
+ | "Key": 1, | ||
+ | "Value": "Москва" | ||
+ | }, | ||
+ | "ArrivalCountry": { | ||
+ | "Key": 460, | ||
+ | "Value": "Россия" | ||
+ | }, | ||
+ | "DepartureAirport": { | ||
+ | "Key": "VIE1", | ||
+ | "Value": "Vena1" | ||
+ | }, | ||
+ | "ArrivalAirport": { | ||
+ | "Key": "DME", | ||
+ | "Value": "Домодедово" | ||
+ | }, | ||
+ | "Airline": { | ||
+ | "Key": "7U", | ||
+ | "Value": "Авиаэнерго" | ||
+ | }, | ||
+ | "Aircraft": { | ||
+ | "Key": "727", | ||
+ | "Value": "Boeing" | ||
+ | }, | ||
+ | "Flight": { | ||
+ | "Key": 774, | ||
+ | "Value": "222" | ||
+ | }, | ||
+ | "DepartureTime": "00:00:00", | ||
+ | "ArrivalTime": "00:00:00", | ||
+ | "EndDateTime": "2018-02-28T00:00:00", | ||
+ | "FlightDetails": [ { | ||
+ | "Tariff": { | ||
+ | "Key": 89, | ||
+ | "Code": "Y", | ||
+ | "Name": "Экономический класс" | ||
+ | }, | ||
+ | "Cost": 0, | ||
+ | "QuotaStatus": { | ||
+ | "PlacesStatus": 4, | ||
+ | "FreePlaces": 0, | ||
+ | "IsFewPlaces": false | ||
+ | }, | ||
+ | "PartnerId": 10760, | ||
+ | "ByPax": true, | ||
+ | "Partner": { | ||
+ | "Key": 0, | ||
+ | "Value": null | ||
+ | } | ||
+ | }], | ||
+ | "FlightSetting": { | ||
+ | "ServiceId": 4, | ||
+ | "PatternId": 5, | ||
+ | "FlightId": 4 | ||
+ | }, | ||
+ | "FlightSourceMode": 1, | ||
+ | "Id": 4, | ||
+ | "SvKey": 1, | ||
+ | "IsSubCode1": true, | ||
+ | "IsSubCode2": false, | ||
+ | "IsPartnerBasedOn": false, | ||
+ | "Day": 4, | ||
+ | "DurationInNight": 0, | ||
+ | "BeginDateTime": "2018-02-28T00:00:00", | ||
+ | "IsHooded": false, | ||
+ | "IsDeleted": false, | ||
+ | "IsNotCalculate": false, | ||
+ | "PacketId": 779, | ||
+ | "Index": 4 | ||
+ | } | ||
+ | ], | ||
+ | "NotRouteServices": [ | ||
+ | [ { | ||
+ | "ServiceName": "страховка", | ||
+ | "City": null, | ||
+ | "Country": 6245, | ||
+ | "Code": { | ||
+ | "Key": 297, | ||
+ | "Value": "Страховка от несчастного случая" | ||
+ | }, | ||
+ | "ByScheduler": false, | ||
+ | "Details": [ { | ||
+ | "SubCode1": { | ||
+ | "Key": 18, | ||
+ | "Value": "2" | ||
+ | }, | ||
+ | "SubCode2": { | ||
+ | "Key": null, | ||
+ | "Value": "" | ||
+ | }, | ||
+ | "Date": null, | ||
+ | "IsShowTransportPlan": true, | ||
+ | "Cost": 16, | ||
+ | "QuotaStatus": { | ||
+ | "PlacesStatus": 1, | ||
+ | "FreePlaces": 0, | ||
+ | "IsFewPlaces": false | ||
+ | }, | ||
+ | "PartnerId": 12668, | ||
+ | "ByPax": true, | ||
+ | "Partner": { | ||
+ | "Key": 0, | ||
+ | "Value": null | ||
+ | } | ||
+ | }], | ||
+ | "ParentId": null, | ||
+ | "PartnerBasedOnServiceTemplateId": null, | ||
+ | "Id": 10, | ||
+ | "SvKey": 6, | ||
+ | "IsSubCode1": true, | ||
+ | "IsSubCode2": true, | ||
+ | "IsPartnerBasedOn": false, | ||
+ | "Day": 1, | ||
+ | "DurationInNight": 3, | ||
+ | "BeginDateTime": "2018-02-25T00:00:00", | ||
+ | "EndDateTime": "2018-02-28T00:00:00", | ||
+ | "IsHooded": false, | ||
+ | "IsDeleted": true, | ||
+ | "IsNotCalculate": true, | ||
+ | "PacketId": 882, | ||
+ | "Index": 2 | ||
+ | }], | ||
+ | [ { | ||
+ | "ServiceName": "экскурсия", | ||
+ | "City": { | ||
+ | "Key": 1046, | ||
+ | "Value": "Санто-Доминго" | ||
+ | }, | ||
+ | "Country": 6245, | ||
+ | "Code": { | ||
+ | "Key": 743, | ||
+ | "Value": "4" | ||
+ | }, | ||
+ | "ByScheduler": false, | ||
+ | "Details": [ { | ||
+ | "SubCode1": { | ||
+ | "Key": 37, | ||
+ | "Value": "Мини-автобус 10 чел." | ||
+ | }, | ||
+ | "SubCode2": { | ||
+ | "Key": null, | ||
+ | "Value": "" | ||
+ | }, | ||
+ | "Date": null, | ||
+ | "IsShowTransportPlan": false, | ||
+ | "Cost": 85.22, | ||
+ | "QuotaStatus": { | ||
+ | "PlacesStatus": 1, | ||
+ | "FreePlaces": 0, | ||
+ | "IsFewPlaces": false | ||
+ | }, | ||
+ | "PartnerId": 12667, | ||
+ | "ByPax": true, | ||
+ | "Partner": { | ||
+ | "Key": 0, | ||
+ | "Value": null | ||
+ | } | ||
+ | }], | ||
+ | "ParentId": null, | ||
+ | "PartnerBasedOnServiceTemplateId": null, | ||
+ | "Id": 7, | ||
+ | "SvKey": 4, | ||
+ | "IsSubCode1": true, | ||
+ | "IsSubCode2": false, | ||
+ | "IsPartnerBasedOn": true, | ||
+ | "Day": 1, | ||
+ | "DurationInNight": 0, | ||
+ | "BeginDateTime": "2018-02-25T00:00:00", | ||
+ | "EndDateTime": "2018-02-26T00:00:00", | ||
+ | "IsHooded": false, | ||
+ | "IsDeleted": true, | ||
+ | "IsNotCalculate": true, | ||
+ | "PacketId": 779, | ||
+ | "Index": 3 | ||
+ | }] | ||
+ | ], | ||
+ | "MinCostServicesComposition": [ | ||
+ | { | ||
+ | "Key": { | ||
+ | "TemplateId": 3, | ||
+ | "PatternId": 13, | ||
+ | "SettingId": 13 | ||
+ | }, | ||
+ | "Value": { | ||
+ | "ServiceType": 1, | ||
+ | "Code": 882, | ||
+ | "SubCode1": 89, | ||
+ | "SubCode2": 1, | ||
+ | "PacketId": 779, | ||
+ | "PartnerId": 12668, | ||
+ | "CountryId": 90, | ||
+ | "CityId": 35, | ||
+ | "Day": 1, | ||
+ | "DurationInNight": 0 | ||
+ | } | ||
+ | }, | ||
+ | { | ||
+ | "Key": { | ||
+ | "TemplateId": 1, | ||
+ | "PatternId": 0, | ||
+ | "SettingId": 0 | ||
+ | }, | ||
+ | "Value": { | ||
+ | "ServiceType": 3, | ||
+ | "Code": 709, | ||
+ | "SubCode1": 46463, | ||
+ | "SubCode2": 4, | ||
+ | "PacketId": 779, | ||
+ | "PartnerId": 12667, | ||
+ | "CountryId": 90, | ||
+ | "CityId": 35, | ||
+ | "Day": 1, | ||
+ | "DurationInNight": 3 | ||
+ | } | ||
+ | }, | ||
+ | { | ||
+ | "Key": { | ||
+ | "TemplateId": 4, | ||
+ | "PatternId": 5, | ||
+ | "SettingId": 4 | ||
+ | }, | ||
+ | "Value": { | ||
+ | "ServiceType": 1, | ||
+ | "Code": 774, | ||
+ | "SubCode1": 89, | ||
+ | "SubCode2": 35, | ||
+ | "PacketId": 779, | ||
+ | "PartnerId": 10760, | ||
+ | "CountryId": 460, | ||
+ | "CityId": 1, | ||
+ | "Day": 4, | ||
+ | "DurationInNight": 0 | ||
+ | } | ||
+ | } | ||
+ | ], | ||
+ | "FlightWeight": 2, | ||
+ | "LinkingFlightsRules": { | ||
+ | "notCombineDifferentAirlineRule": { | ||
+ | "airlines": ["AY2"], | ||
+ | "flightSettings": [], | ||
+ | "enabled": true | ||
+ | }, | ||
+ | "checkPlusMinus1CharterRule": { | ||
+ | "FlightSettingPairs": [], | ||
+ | "enabled": false | ||
+ | }, | ||
+ | "notCombineDifferentTariffGroupRule": { | ||
+ | "FlightSettings": [], | ||
+ | "enabled": true | ||
+ | }, | ||
+ | "notCombineDifferentPartnerRule": { | ||
+ | "FlightSettings": [], | ||
+ | "enabled": false | ||
+ | }, | ||
+ | "departureCityEqualsArrivalCityRule": { | ||
+ | "FlightSettingPairs": [], | ||
+ | "enabled": false | ||
+ | }, | ||
+ | "combineOnlySpecificChartersRule": { | ||
+ | "settings": [], | ||
+ | "enabled": false | ||
+ | } | ||
+ | }, | ||
+ | "RouteSubVariants": [] | ||
+ | } | ||
+ | ], | ||
+ | "SecondaryFiltersResult": { | ||
+ | "TourTypes": [ { | ||
+ | "Id": 2, | ||
+ | "Name": "Стандартный тур", | ||
+ | "ParentId": null, | ||
+ | "Type": "TourType" | ||
+ | }], | ||
+ | "TourPrograms": [ | ||
+ | { | ||
+ | "Key": 100000004, | ||
+ | "Name": "Общая проверка системы", | ||
+ | "TourUrl": "www.megatec.ru", | ||
+ | "BookingConditions": "<p>Условия бронирования тура.<\/p>", | ||
+ | "IsLandOnly": false, | ||
+ | "IsRestrictMultiHotels": false, | ||
+ | "IsHotelTemplates": true, | ||
+ | "IsRouteServices": true, | ||
+ | "MultiHotelDelta": 0, | ||
+ | "Rate": "EU", | ||
+ | "DateStart": "2018-01-30T00:00:00Z", | ||
+ | "DateEnd": "2018-02-27T00:00:00Z", | ||
+ | "Status": { | ||
+ | "Key": 3, | ||
+ | "Value": "Доступен для продажи" | ||
+ | }, | ||
+ | "Templates": [ | ||
+ | {"$id": "5"}, | ||
+ | {"$id": "6"}, | ||
+ | {"$id": "7"}, | ||
+ | {"$id": "8"}, | ||
+ | {"$id": "9"} | ||
+ | ], | ||
+ | "Types": [ { | ||
+ | "Id": 2, | ||
+ | "Name": "Стандартный тур", | ||
+ | "ParentId": null, | ||
+ | "Type": "TourType" | ||
+ | }], | ||
+ | "LinkingFlightsRules": { | ||
+ | "notCombineDifferentAirlineRule": { | ||
+ | "airlines": ["AY2"], | ||
+ | "flightSettings": [], | ||
+ | "enabled": true | ||
+ | }, | ||
+ | "checkPlusMinus1CharterRule": { | ||
+ | "FlightSettingPairs": [], | ||
+ | "enabled": false | ||
+ | }, | ||
+ | "notCombineDifferentTariffGroupRule": { | ||
+ | "FlightSettings": [], | ||
+ | "enabled": true | ||
+ | }, | ||
+ | "notCombineDifferentPartnerRule": { | ||
+ | "FlightSettings": [], | ||
+ | "enabled": false | ||
+ | }, | ||
+ | "departureCityEqualsArrivalCityRule": { | ||
+ | "FlightSettingPairs": [], | ||
+ | "enabled": false | ||
+ | }, | ||
+ | "combineOnlySpecificChartersRule": { | ||
+ | "settings": [], | ||
+ | "enabled": false | ||
+ | } | ||
+ | }, | ||
+ | "XmlSettings": "информация о туре в формате xml", | ||
+ | "Type": "TourProgram" | ||
+ | } | ||
+ | ], | ||
+ | "TourDurations": [4], | ||
+ | "TourDates": ["2018-02-25T00:00:00"], | ||
+ | "HotelCities": [ { | ||
+ | "key": 35, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "name": "Вена", | ||
+ | "Code": "VIE", | ||
+ | "Web": 0, | ||
+ | "RSKey": 0, | ||
+ | "WebImage": null, | ||
+ | "IsDeparture": 1, | ||
+ | "Type": "City" | ||
+ | }], | ||
+ | "HotelResorts": [ { | ||
+ | "Key": -1, | ||
+ | "CountryKey": 0, | ||
+ | "Name": "Не указан", | ||
+ | "NameLat": null, | ||
+ | "Type": "Resort" | ||
+ | }], | ||
+ | "HotelCategories": [ | ||
+ | { | ||
+ | "Key": 23, | ||
+ | "Name": "1*", | ||
+ | "PrintNumber": 1, | ||
+ | "Type": "HotelCatigory" | ||
+ | }, | ||
+ | { | ||
+ | "Key": 56, | ||
+ | "Name": "2*", | ||
+ | "PrintNumber": 2, | ||
+ | "Type": "HotelCatigory" | ||
+ | }, | ||
+ | { | ||
+ | "Key": 66, | ||
+ | "Name": "4*Boutique", | ||
+ | "PrintNumber": null, | ||
+ | "Type": "HotelCatigory" | ||
+ | } | ||
+ | ], | ||
+ | "Hotels": [ | ||
+ | { | ||
+ | "Key": 705, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "City": { | ||
+ | "key": 35, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "name": "Вена", | ||
+ | "Code": "VIE", | ||
+ | "Web": 0, | ||
+ | "RSKey": 0, | ||
+ | "WebImage": null, | ||
+ | "IsDeparture": 1, | ||
+ | "Type": "City" | ||
+ | }, | ||
+ | "Resort": null, | ||
+ | "Name": "Continental", | ||
+ | "Category": { | ||
+ | "Key": 23, | ||
+ | "Name": "1*", | ||
+ | "PrintNumber": 1, | ||
+ | "Type": "HotelCatigory" | ||
+ | }, | ||
+ | "TimeFrom": null, | ||
+ | "TimeTo": null, | ||
+ | "HTTP": null, | ||
+ | "Stars": "1*", | ||
+ | "TimeIsEmpty": true, | ||
+ | "NameLat": "Continental", | ||
+ | "Address": null, | ||
+ | "IsCruise": 0, | ||
+ | "Phone": null, | ||
+ | "Code": null, | ||
+ | "Type": "Hotel" | ||
+ | }, | ||
+ | { | ||
+ | "Key": 178, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "City": { | ||
+ | "key": 35, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "name": "Вена", | ||
+ | "Code": "VIE", | ||
+ | "Web": 0, | ||
+ | "RSKey": 0, | ||
+ | "WebImage": null, | ||
+ | "IsDeparture": 1, | ||
+ | "Type": "City" | ||
+ | }, | ||
+ | "Resort": null, | ||
+ | "Name": "Ananas", | ||
+ | "Category": { | ||
+ | "Key": 56, | ||
+ | "Name": "2*", | ||
+ | "PrintNumber": 2, | ||
+ | "Type": "HotelCatigory" | ||
+ | }, | ||
+ | "TimeFrom": "1900-01-01T11:00:00", | ||
+ | "TimeTo": "1900-01-01T12:00:00", | ||
+ | "HTTP": "http://booking.panteon.ru/TourPrograms/Home/Tour/?tourKey=100000007", | ||
+ | "Stars": "2*", | ||
+ | "TimeIsEmpty": false, | ||
+ | "NameLat": "Ananas", | ||
+ | "Address": null, | ||
+ | "IsCruise": 0, | ||
+ | "Phone": "(+43/1) 546200", | ||
+ | "Code": null, | ||
+ | "Type": "Hotel" | ||
+ | }, | ||
+ | { | ||
+ | "Key": 707, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "City": { | ||
+ | "key": 35, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "name": "Вена", | ||
+ | "Code": "VIE", | ||
+ | "Web": 0, | ||
+ | "RSKey": 0, | ||
+ | "WebImage": null, | ||
+ | "IsDeparture": 1, | ||
+ | "Type": "City" | ||
+ | }, | ||
+ | "Resort": null, | ||
+ | "Name": "Beim Theresianum", | ||
+ | "Category": { | ||
+ | "Key": 66, | ||
+ | "Name": "4*Boutique", | ||
+ | "PrintNumber": null, | ||
+ | "Type": "HotelCatigory" | ||
+ | }, | ||
+ | "TimeFrom": null, | ||
+ | "TimeTo": null, | ||
+ | "HTTP": null, | ||
+ | "Stars": "4*Boutique", | ||
+ | "TimeIsEmpty": true, | ||
+ | "NameLat": "Beim Theresianum", | ||
+ | "Address": null, | ||
+ | "IsCruise": 0, | ||
+ | "Phone": null, | ||
+ | "Code": null, | ||
+ | "Type": "Hotel" | ||
+ | }, | ||
+ | { | ||
+ | "Key": 709, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "City": { | ||
+ | "key": 35, | ||
+ | "Country": { | ||
+ | "key": 90, | ||
+ | "name": "Австрия", | ||
+ | "Code": "AUS", | ||
+ | "CitizenName": "Австрия", | ||
+ | "CitizenNameLat": "AUSTRIA", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": false, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 1, | ||
+ | "WebImage": "/pics/animate/austria.gif", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "name": "Вена", | ||
+ | "Code": "VIE", | ||
+ | "Web": 0, | ||
+ | "RSKey": 0, | ||
+ | "WebImage": null, | ||
+ | "IsDeparture": 1, | ||
+ | "Type": "City" | ||
+ | }, | ||
+ | "Resort": null, | ||
+ | "Name": "Am Brilliantengrund", | ||
+ | "Category": null, | ||
+ | "TimeFrom": null, | ||
+ | "TimeTo": null, | ||
+ | "HTTP": null, | ||
+ | "Stars": "", | ||
+ | "TimeIsEmpty": true, | ||
+ | "NameLat": "Am Brilliantengrund", | ||
+ | "Address": null, | ||
+ | "IsCruise": 0, | ||
+ | "Phone": null, | ||
+ | "Code": null, | ||
+ | "Type": "Hotel" | ||
+ | } | ||
+ | ], | ||
+ | "Pansions": [ | ||
+ | { | ||
+ | "Key": 46, | ||
+ | "Code": "RO", | ||
+ | "Name": "RO", | ||
+ | "NameLat": null, | ||
+ | "Type": "Pansion" | ||
+ | }, | ||
+ | { | ||
+ | "Key": 4, | ||
+ | "Code": "BB2", | ||
+ | "Name": "Завтрак", | ||
+ | "NameLat": null, | ||
+ | "Type": "Pansion" | ||
+ | }, | ||
+ | { | ||
+ | "Key": 2, | ||
+ | "Code": "HB", | ||
+ | "Name": "Полупансион", | ||
+ | "NameLat": null, | ||
+ | "Type": "Pansion" | ||
+ | } | ||
+ | ], | ||
+ | "Airlines": [ | ||
+ | { | ||
+ | "Key": 8, | ||
+ | "Code": "BA7", | ||
+ | "Name": "BRITISH AIRWAYS", | ||
+ | "NameLat": "en_BRITISH AIRWAYS", | ||
+ | "Type": "AirLine" | ||
+ | }, | ||
+ | { | ||
+ | "Key": 3, | ||
+ | "Code": "7U", | ||
+ | "Name": "Авиаэнерго", | ||
+ | "NameLat": "en_Авиаэнерго", | ||
+ | "Type": "AirLine" | ||
+ | } | ||
+ | ], | ||
+ | "FlightTariffs": [ { | ||
+ | "Key": 89, | ||
+ | "Code": "Y", | ||
+ | "Name": "Экономический класс", | ||
+ | "NameLat": "Coach economy", | ||
+ | "Group": null, | ||
+ | "Type": "AirService" | ||
+ | }], | ||
+ | "DepartureCities": [ { | ||
+ | "key": 1, | ||
+ | "Country": { | ||
+ | "key": 460, | ||
+ | "name": "Россия", | ||
+ | "Code": null, | ||
+ | "CitizenName": "Россия", | ||
+ | "CitizenNameLat": "Russia", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": true, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 0, | ||
+ | "WebImage": "", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "name": "Москва", | ||
+ | "Code": "MOW", | ||
+ | "Web": 0, | ||
+ | "RSKey": 0, | ||
+ | "WebImage": null, | ||
+ | "IsDeparture": 1, | ||
+ | "Type": "City" | ||
+ | }], | ||
+ | "DepartureAirports": [ { | ||
+ | "Key": 52, | ||
+ | "Code": "SVO4", | ||
+ | "Name": "Шереметьево-24", | ||
+ | "NameLat": "Шереметьево-", | ||
+ | "CityKey": 1, | ||
+ | "CountryKey": 460, | ||
+ | "Letter": "S", | ||
+ | "Site": 0, | ||
+ | "Type": "Airport" | ||
+ | }], | ||
+ | "ArrivalCities": [ { | ||
+ | "key": 1, | ||
+ | "Country": { | ||
+ | "key": 460, | ||
+ | "name": "Россия", | ||
+ | "Code": null, | ||
+ | "CitizenName": "Россия", | ||
+ | "CitizenNameLat": "Russia", | ||
+ | "PassportMinDurCheckFrom": 0, | ||
+ | "CheckINN": true, | ||
+ | "PassportMinDur": null, | ||
+ | "INNName": "ИНН", | ||
+ | "Web": 0, | ||
+ | "WebImage": "", | ||
+ | "WebHTTP": "", | ||
+ | "AnkLang": 0, | ||
+ | "Type": "Country" | ||
+ | }, | ||
+ | "name": "Москва", | ||
+ | "Code": "MOW", | ||
+ | "Web": 0, | ||
+ | "RSKey": 0, | ||
+ | "WebImage": null, | ||
+ | "IsDeparture": 1, | ||
+ | "Type": "City" | ||
+ | }], | ||
+ | "ArrivalAirports": [ { | ||
+ | "Key": 12, | ||
+ | "Code": "DME", | ||
+ | "Name": "Домодедово", | ||
+ | "NameLat": "Домодедово", | ||
+ | "CityKey": 1, | ||
+ | "CountryKey": 460, | ||
+ | "Letter": "D", | ||
+ | "Site": 0, | ||
+ | "Type": "Airport" | ||
+ | }], | ||
+ | "HotelTypes": [ | ||
+ | { | ||
+ | "key": 94, | ||
+ | "name": "Молодежный отдых", | ||
+ | "Type": "HotelType" | ||
+ | }, | ||
+ | { | ||
+ | "key": 5, | ||
+ | "name": "Рекомендуемые", | ||
+ | "Type": "HotelType" | ||
+ | } | ||
+ | ] | ||
+ | } | ||
+ | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</TD></TR></TABLE> | </TD></TR></TABLE> |
Версия 15:45, 3 февраля 2021
Версия статьи от 3-02-2021.
Поддерживаемые версии ПК «Мастер-Тур»: |
Содержание
[убрать]- 1 Введение
- 2 Установка
- 3 Список методов
- 3.1 Авторизация (Token)
- 3.2 Выгрузка настроек службы поиска (Settings)
- 3.3 Выгрузка списка всех валют (getAllCurrencies)
- 3.4 Выгрузка списка валют в онлайне (Currency)
- 3.5 Выгрузка квотируемых услуг системы (QuotedServices)
- 3.6 Выгрузка актуальных городов отправления (departureCities)
- 3.7 Выгрузка актуальных стран (Destination)
- 3.8 Выгрузка актуальных городов (ActualizeCities)
- 3.9 Выгрузка актуальных типов туров (ActualizeTourType)
- 3.10 Выгрузка актуальных дат заездов (TourDate)
- 3.11 Выгрузка актуальных продолжительностей (Duration)
- 3.12 Поиск туров (Tour)
- 3.13 Выгрузка транспортного плана (TransportPlan)
- 3.14 Выгрузка первоначального варианта в корзину для бронирования (Tour)
- 3.15 Выгрузка настройки отображения полей по туристам (TouristDataSettings)
- 3.16 Выгрузка услуг доплат к авиаперелетам (GetFlightsAdditionalServices)
- 3.17 Выгрузка услуг доплат к отелям (GetHotelsAdditionalServices)
- 3.18 Расчет индивидуальных услуг (CalculateIndividualServiceCosts)
- 3.19 Поиск рейсов из внешней системы (GetGDSFlights)
- 3.20 Получение семейств тарифов авиаперелетов из внешней системы (GetGDSFlightFareFamilies)
- 3.21 Загрузка филиалов (Branches) начиная с релиза 15.3
- 3.22 Загрузка ведущих менеджеров (Users) начиная с релиза 15.3
- 3.23 Расчет путевки (CalculateReservation)
- 3.24 Бронирование путевки (CreateReservation)
- 3.25 Выгрузка информации о путевке (GetReservation)
- 3.26 Выгрузка информации о ценовых блоках (CostOfferDescriptions)
- 3.27 Получение капчи (GetCaptcha)
- 3.28 Проверка капчи (CheckCaptcha)
- 3.29 Проверка e-mail (CheckMail)
- 3.30 Проверка туриста (checkTourist)
- 3.31 Список значений параметра гражданства (Citizenships)
- 3.32 Выгрузка постоянного клиента (Client)
- 3.33 Выгрузка описаний ценовых блоков (CostOfferDescriptions)
- 3.34 Выгрузка описания по стране (CountryInfo)
- 3.35 Выгрузка картинки по отелю (HotelImages)
- 3.36 Регистрация частного лица (PersonalRegistration)
- 3.37 Выгрузка списка всех стран (Countries)
- 3.38 Выгрузка списка всех городов (Cities)
- 3.39 Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)
- 3.40 Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)
- 3.41 Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)
- 3.42 Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)
- 3.43 Поиск туров в оформлении клиентов (Search)
- 4 Дополнительные методы
- 5 Приложения
Введение
Данный web-сервис служит для разработки собственного сайта туроператору на основе API.
Установка
Для работы с web-сервисом необходимо на отдающей стороне установить службу поиска.
После установки web-сервис будет доступен по адресу http://значение настройки "serviceAddress" в TourSearchOwin/"название метода" (пример: http://localhost:9000/TourSearchOwin/Settings)
Список методов
Последовательность вызова методов сервиса
Авторизация (Token)
Метод производит получение авторизационного токена (описание стандарта).
- Формат запроса:
- POST .../TourSearchOwin/Token?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/x-www-form-urlencoded
- Принимаемые параметры POST запроса ( * – обязательный):
- grant_type * – текст password
- username * – логин представителя партнера или частного лица
- password * – пароль представителя партнера или частного лица
- Возвращаемый результат:
- access_token – токен
- token_type – тип токена
- expires_in – код
- userKey – ключ пользователя
- userType – тип пользователя (0 – представитель партнера, 1 – частное лицо)
- .issued – дата получения
- .expires – дата действия до
Выгрузка настроек службы поиска (Settings)
Метод производит выгрузку настроек службы поиска.
- Формат запроса:
- GET .../TourSearchOwin/Settings?
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- ChildAgesSetting – регулируется настройкой максимальный возраст ребенка (массив возрастов, при которых турист будет считаться ребенком
- DurationSetting – регулируется настройкой максимальная продолжительность тура (массив продолжительностей, доступных в фильтрах для поиска)
- RoundServiceSetting – признак округления цены (количество знаков после запятой)
- CacheReady – статус готовности службы поиска к работе (true/false)
- EnableFiterTree – устаревшая настройка, будет убрана (по умолчанию всегда false)
- EnableActualFilters – включены ли актуальные фильтры (true/false)
- CorrectLicense – проверка лицензии (true/false)
- CorrectLicenseMessage – сообщение, если проверка лицензии не прошла
- IsCorrectUser – проверка наличия пользователя в таблице Userlist, под которым запущена служба поиска (true/false)
- IsShowCitizenAuthTourist – настройка запрашивать гражданство при регистрации частного лица (true/false)
- IsShowFewCountPlaces – настройка отображения числового значения оставшихся мест, когда достигнуто значение «Мало» (true/false)
- IsShowBusTransferPlaces – использовать фильтр наличие мест на автобусный переезд в поиске (true/false)
- UseBusSeatChecks – план рассадки автобусного переезда (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
- UseTransferSeatChecks – план рассадки трансфера (0 – не отображать, 1 – отображать без проверки, 2 – отображать с проверкой)
- IsShowFiltersByCity – отображать фильтр по городам на главной странице поиска (true/false)
- CheckRealCourses – включена ли проверка курсов реальных валют при поиске (true/false)
- CommonImagesFolderPath – путь к папке для хранения изображений
- UseApplyFiltersButton – отображать кнопку «Применить фильтры» (true/false)
- AutoSearchFiltersTimeout – задержка между выбором дополнительных фильтров и выводом результатов (в секундах)
- UseFastSearchAlgoritm – использовать быстрый алгоритм поиска (true/false)
- MaxSearchDatesCountClient – максимальное количество дат, которое будет обрабатываться в клиенте поиска
- MaxDurationsCountClient – максимальное количество продолжительностей, которое будет обрабатываться в клиенте поиска
- UseHotelCategoryGlobalCodeInDopFilter – использовать глобальные коды категорий отелей в поиске
- UsePansionGlobalCodeInDopFilter – использовать глобальные коды питаний в поиске
- CheckTouristDataInBasket – проверять корректность данных туристов
- SimpleRegistration – упрощенная регистрация частного лица
- ShowHotelImagesInSearch – показывать описание и изображения отелей в поиске
- CacheReadyMessage – сообщение о готовности службы поиска или службы расчета актуальных фильтров. Варианты возвращаемых значений:
- <add key="enableActualFilters" value="true" /> - CacheReady: true = CacheReadyMessage: "Кеш инициализирован"; CacheReady: false = CacheReadyMessage: "Кеш еще не инициализирован"
- <add key="enableActualFilters" value="false" /> - Служба актуальных фильтров недоступна (выключена, неверно указана ссылка на нее и т.п.) CacheReadyMessage: "Служба актуальных фильтров недоступна"; Служба актуальных фильтров доступна но не готова - CacheReadyMessage: "Кеш службы актуальных фильтров не инициализирован"; Служба актуальных фильтров готова, а основная служба не готова - CacheReadyMessage: "Кеш ещё не инициализирован"; Служба актуальных фильтров готова, и основная служба готова - CacheReadyMessage: "Кеш ещё инициализирован".
Выгрузка списка всех валют (getAllCurrencies)
Метод возвращает список всех валют.
- Формат запроса:
- GET .../TourSearchOwin/AllCurencies/getAllCurrencies
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- Code – код валюты
- Name – наименование валюты
- IsMain – признак валюты «Главная»
- IsNational – признак валюты «Национальная»
- IsoCode – ISO код валюты
- IsShowInSearch – признак показывать ли валюту в поиске
- Symbol – символ валюты (обрабатывается с 15.7)
- Key – идентификатор валюты
Выгрузка списка валют в онлайне (Currency)
Метод возвращает список используемых валют.
- Формат запроса:
- GET .../TourSearchOwin/Currency
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- Code – код валюты
- Name – наименование валюты
- IsMain – признак валюты «Главная»
- IsNational – признак валюты «Национальная»
- IsoCode – ISO код валюты
- IsShowInSearch – признак показывать ли валюту в поиске
- Symbol – символ валюты (обрабатывается с 15.7)
- Key – идентификатор валюты
Выгрузка квотируемых услуг системы (QuotedServices)
Метод производит выгрузку услуг с признаком «Квотируемая»
- Формат запроса:
- GET .../TourSearchOwin/QuotedServices
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- Key – идентификатор услуги
- Code – код услуги
- Name – наименование услуги (русский)
- NameLat – наименование услуги (английский)
- IsDuration – наличие продолжительности у услуги
- IsCity – наличие города у услуги
- IsSubCode1 – признак наличия SubCode1 у услуги
- IsSubCode2 – признак наличия SubCode2 у услуги
- Quoted – признак квотируемости услуги
- CheckGeoPoint – наличие геоточек у услуги
- IsRoute – признак маршрутной услуги
- IsPartnerBasedOn – признак сопоставления партнера услуги в зависимости от отеля
- Control – идентификатор статуса услуги
Выгрузка актуальных городов отправления (departureCities)
Метод производит выгрузку всех доступных городов отправления для поискового запроса.
- Формат запроса:
- GET .../TourSearchOwin/departureCities?
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- Key – идентификатор города
- Name – название города
Выгрузка актуальных стран (Destination)
Метод производит выгрузку всех доступных направлений туроператора.
- Формат запроса:
- GET .../TourSearchOwin/Destination?
- Принимаемые параметры ( * – обязательный):
- departureCities * – идентификатор города(ов) отправления (из контроллера .../TourSearchOwin/departureCities?)
- term – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Name – название страны
- Key – идентификатор страны
- DestinationType – тип результата (всегда возвращается в JSON = 1, в xml = country)
Выгрузка актуальных городов (ActualizeCities)
Метод возвращает список всех доступных городов по определенному городу отправления и стране прибытия.
- Формат запроса:
- GET .../TourSearchOwin/ActualizeCities?
- Принимаемые параметры ( * – обязательный):
- cityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- term – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Key – идентификатор города
- Name – название города
Выгрузка актуальных типов туров (ActualizeTourType)
Метод возвращает список типов туров по определенному городу отправления, стране и городу прибытия.
- Формат запроса:
- GET .../TourSearchOwin/ActualizeTourType?
- Принимаемые параметры ( * – обязательный):
- departureCityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- Type * – тип результата (всегда возвращается в JSON = 1, в xml = country)
- destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
- terms – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Key – идентификатор типа тура
- Name – название типа тура
- ParentId – идентификатор группы, к которой относится данный типа тура (если тип тура не относится к группе, то возвращается null)
Выгрузка актуальных дат заездов (TourDate)
Метод производит выгрузку доступных дат заездов для поискового запроса.
- Формат запроса:
- GET .../TourSearchOwin/TourDate?
- Принимаемые параметры ( * – обязательный):
- departureCity * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
- Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- Type * – тип результата (всегда возвращается в JSON = 1, в xml = country)
- tourTypes * – идентификатор типа тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны
- Возвращаемый результат:
- массив дат
Выгрузка актуальных продолжительностей (Duration)
Метод производит выгрузку доступных продолжительностей для поискового запроса.
- Формат запроса:
- GET .../TourSearchOwin/Duration?
- Принимаемые параметры ( * – обязательный):
- departureCity * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
- Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- Type * – тип результата (всегда возвращается в JSON = 1, в xml = country)
- tourDate * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- tourTypes * – идентификатор типа(ов) тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны
- Возвращаемый результат:
- массив продолжительностей (в днях)
Поиск туров (Tour)
Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод возвращает наиболее дешевые предложения, найденные по предоставленным параметрам и сгруппированные по отелям в порядке возрастания цены.
- Формат запроса:
- GET .../TourSearchOwin/Tour?
- Принимаемые параметры ( * – обязательный):
- DepartureCityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
- PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
- isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false)
- isFillSecondaryFilters * – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true)
- DestinationType * – тип результата (всегда возвращается в JSON = 1, в xml = country)
- DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- AdultCount * – количество взрослых
- ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- CurrencyName * – код валюты
- AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- MinPrice * – минимальная цена (по умолчанию не задана, передается NaN)
- MaxPrice – максимальная цена (по умолчанию не передается)
- Groups – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
- HotelScheme – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры:
- TemplateId – идентификатор шаблона услуги,
- DurationInNight – продолжительность отеля в ночах,
- Code – ключ отеля,
- PacketKey – ключ пакета,
- PartnerKey – ключ партнера
- GDSProviderId – ключ провайдера из внешней системы
- TotalTourDuration – общая продолжительность тура в днях
- BusTransferPointKeys – данный признак проставляется в true в том случае, когда происходит запрос вариантов проживания (кнопка Варианты) в автобусных переездах
- TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
- TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
- TourType – идентификатор типа(ов) тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны. Возможна множественная передача параметров.
- Tour – ключ программы тура (дополнительный фильтр)
- Duration – продолжительность тура (дополнительный фильтр)
- DateTour – дата тура (дополнительный фильтр)
- HotelResort – ключ курорта отеля (дополнительный фильтр)
- HotelCity – ключ города отеля (дополнительный фильтр)
- HotelType – ключ признака отеля (дополнительный фильтр)
- HotelStars – ключ категории отеля (дополнительный фильтр)
- Hotel – ключ отеля (дополнительный фильтр)
- Pansions – ключ питания (дополнительный фильтр)
- Airline – ключ авиакомпании (дополнительный фильтр)
- AirportDeparture – ключ аэропорта вылета (дополнительный фильтр)
- AirportArrival – ключ аэропорта прилета (дополнительный фильтр)
- CityIds – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны. Возможна множественная передача параметров.
- TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
- TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
- TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
- TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
- ArrivalFlightNoTransfer – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
- DepartureFlightNoTransfer – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
- DepartureFlightNumberTransfer – наличие пересадок в прямом направлении (1 – одна пересадка, 2 – две пересадки и более, 3 – одна пересадка совместно с двумя пересадками и более). Обрабатывается начиная с релиза 15.3.
- ArrivalFlightNumberTransfer – наличие пересадок в обратном направлении (1 – одна пересадка, 2 – две пересадки и более, 3 – одна пересадка совместно с двумя пересадками и более). Обрабатывается начиная с релиза 15.3.
- Tariff – ключ класса авиаперелета (дополнительный фильтр)
- CombineAirlines — разрешить комбинировать авиаперелеты (дополнительный фильтр). Параметр применяется только при наличии параметра airline. Обрабатывается начиная с релиза 15.3.
- CombineTariffs — разрешить комбинировать классы перелета (дополнительный фильтр). Параметр применяется только при наличии параметра tariff. Обрабатывается начиная с релиза 15.3.
- FlightCityDeparture – ключ город вылета в параметрах авиаперелета (дополнительный фильтр)
- CityDeparture – ключ города начала поездки (дополнительный фильтр)
- RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Обрабатывается начиная с релиза 15.4.
- GroupGuid – используется для получения турпрограмм по уникальному ключу из кэша при использовании группировки. Примеры использования. GroupGuid=00000000-0000-0000-0000-000000000000 – при первом запросе от локальной системы. GroupGuid=936DA01F-9ABD-4d9d-80C7-02AF85C822A8 (уникальный ключ) – передается на клиент от первого запроса из внешней системы. С данным уникальным ключом осуществляется второй запрос от удаленной внешней системы. Далее происходит получение значений по данному уникальному ключу. Обрабатывается начиная с релиза 15.4.
- IsGroupingTourAlreadyMerge – определяет слияние данных турпрограмм от локальной системы с данными от внешней системы при использовании группировки. Примеры использования. IsGroupingTourAlreadyMerge=false – полученные данные от локальной системы не объединены с данными от внешней удаленной системы. На клиенте осуществляется объединение данных турпрограмм с последующей сортировкой по минимальной цене. IsGroupingTourAlreadyMerge=true – полученные данные от локальной системы уже объединены с данными от внешней удаленной системы. На клиенте осуществляется только сортировка по минимальной цене. Обрабатывается начиная с релиза 15.4.
- SearchId – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.
- Возвращаемый результат:
- CheckMessages – сообщения для логики проверки тура (не используется)
- Message – сообщение об ошибке
- Key – код ошибки
- Value – сообщение об ошибке
- Result – результаты поиска
- Key – идентификатов программы тура
- Name – название программы тура
- TourUrl – ссылка на программу тура
- BookingConditions – условия бронирования программы туров
- StartDate – дата начала тура
- Duration – продолжительность тура (в днях)
- DurationInNight – продолжительность проживания (в ночах)
- Types – идентификатор типа туров
- Cost – цена тура
- Rate – код валюты тура
- CityDepature – город отправления
- Key – идентификатор города отправления
- Value – название города отправления
- CountryId – всегда возвращается ключ 0
- Services – услуги в туре
- DepartureCity – город отправления
- Key – идентификатор
- Value – название
- DepartureCountry – страна отправления
- Key – идентификатор
- Value – название
- ArrivalCity – город прибытия
- Key – идентификатор
- Value – название
- ArrivalCountry – страна прибытия
- Key – идентификатор
- Value – название
- DepartureAirport – аэропорт отправления
- Key – идентификатор
- Value – название
- ArrivalAirport – аэропорт прибытия
- Key – идентификатор
- Value – название
- Airline – авиакомпания
- Key – идентификатор
- Value – название
- Aircraft – воздушное судно
- Key – идентификатор
- Value – название
- Flight – рейс
- Key – идентификатор
- Value – название
- DepartureTime – время вылета
- ArrivalTime – время прилета
- EndDateTime – дата и время прилета
- FlightDetails – информация об авиаперелете
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – название тарифа
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – название
- Tariff – информация о тарифе перелета
- FlightSetting – внутренняя информация о перелете из программы туров
- ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
- PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- FlightId – идентификатор перелета (внутренняя информация из программы туров)
- FlightSourceMode – локальный или удаленный перелет (внутренняя информация из программы туров)
- Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
- SvKey – ключ типа услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- IsHooded – признак скрытая услуга
- IsDeleted – признак удаляемая услуга
- IsNotCalculate – признак не рассчитываемая услуга
- PacketId – ключ пакета
- Index – порядковый номер услуги
- DepartureCity – город отправления
- NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
- ServiceName – название типа услуги
- City – объект город
- Key – ключ города
- Value – название города
- Country – ключ страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – флаг услуга по расписанию или нет
- Details – объект детализация услуги
- SubCode1 – объект доп. описание 1
- Key – ключ доп. описания 1
- Value – название доп. описания 1
- SubCode2 – объект доп. описание 2
- Key – ключ доп. описания 2
- Value – название доп. описания 2
- Date – дата услуги
- IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
- Cost – цена
- QuotaStatus – объект информация по квотам
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – идентификатор партнера
- ByPax – признак цены за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- SubCode1 – объект доп. описание 1
- ParentId – идентификатор родительской услуги (для вложенных услуг)
- PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
- Id – идентификатор услуги
- SvKey – ключ типа услуги
- IsSubCode1 – наличие доп. описания 1
- IsSubCode2 – наличие доп. описания 2
- IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- EndDateTime – дата окончания услуги
- IsHooded – скрытая ли услуга
- IsDeleted – удаляемая ли услуга
- IsNotCalculate – не рассчитываемая ли услуга
- PacketId – пакет услуги
- Index – индекс услуги
- MinCostServicesComposition – массив состав услуг минимальной цены
- Key – ключ
- TemplateId – идентификатор шаблона
- PatternId – идентификатор вкладки
- SettingId – идентификатор услуги
- Value – значение
- ServiceType – тип услуги
- Code – ключ услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- PacketId – пакет услуги
- PartnerId – партнер услуги
- CountryId – страна услуги
- CityId – город услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
- AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
- AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
- SpecialKey – ключ акции
- SpecialName – название акции
- SpecialType – тип акции
- NewPrice – цена после применения акции
- OldPrice – цена до применения акции
- ShowOnline – нужно ли показывать акцию в поиске
- UntilDate – акция действует при совершении покупки до указанной даты
- Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
- NightsFrom (для типа PayStay) – ночей от
- NightsTo (для типа PayStay) – ночей до
- NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
- OperationType (для типа PayStay) – тип действия
- SpecialNightType (для типа PayStay) – тип бесплатной ночи
- DurationFrom (для типа KickBack) – ночей от
- DurationTo (для типа KickBack) – ночей до
- Value (для типа KickBack) – значение продолжительности, равное заданному периоду
- OperationType (для типа KickBack) – тип действия
- NightsFrom (для типа EarlyBird) – ночей от
- NightsTo (для типа EarlyBird) – ночей до
- Discount (для типа EarlyBird) – размер скидки
- OperationType (для типа EarlyBird) – тип действия
- COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
- SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
- SubCode1 – объект доп. описание 1
- SubCode2 – объект доп. описание 2
- Key – ключ
- 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 – флаг включен/выключен
- notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
- RouteSubVariants – подварианты услуг (используется в основном поиске)
- SecondaryFiltersResult – результаты доп. фильтров
- TourTypes – типы тура
- Id – ключ типа тура
- Name – название типа тура
- ParentId – родительский элемент типа тура (если есть)
- Type – тип справочника (используется для внутренних целей)
- TourPrograms – информация по каждой турпрограмме
- Key – ключ турпрограммы
- Name – название турпрограммы
- TourUrl – ссылка на тур
- BookingConditions – условия бронирования
- IsLandOnly – признак только наземное обслуживание
- IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
- IsHotelTemplates – есть ли вообще отели в данной турпрограмме
- IsRouteServices – есть ли маршрутные услуги
- MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
- Rate – валюта тура
- DateStart – нижняя граница дат заезда по программе тура
- DateEnd – верхняя граница дат заеда по программе тура
- Status – статус турпрограммы
- Key – ключ
- Value – значение
- Templates – шаблоны услуг
- $id – шаблон 1
- $id – шаблон 2
- Types – типы тура
- Id – ключ типа тура
- Name – название типа тура
- ParentId – родительский элемент типа тура (если есть)
- Type – тип справочника (используется для внутренних целей)
- LinkingFlightsRules – правила связывания перелетов
- notCombineDifferentAirlineRule –
- airlines –
- flightSettings –
- enabled –
- checkPlusMinus1CharterRule –
- FlightSettingPairs –
- enabled –
- notCombineDifferentTariffGroupRule –
- FlightSettings –
- enabled –
- notCombineDifferentPartnerRule –
- FlightSettings –
- enabled –
- departureCityEqualsArrivalCityRule –
- FlightSettingPairs –
- enabled –
- combineOnlySpecificChartersRule –
- settings –
- enabled –
- notCombineDifferentAirlineRule –
- XmlSettings – строка xml для актуальных фильтров
- Type – тип справочника (используется для внутренних целей)
- TourDurations – продолжительность тура
- TourDates – список дат заездов в турпрограмме
- HotelCities – город в дополнительных фильтрах
- ' –
- HotelResorts – курорты в дополнительных фильтрах
- ' –
- HotelCategories – категории отеля в дополнительных фильтрах
- ' –
- Hotels – отели в дополнительных фильтрах
- ' –
- Pansions – питания в дополнительных фильтрах
- ' –
- Airlines – авиакомпании в дополнительных фильтрах
- ' –
- FlightTariffs – класс перелета в дополнительных фильтрах
- ' –
- DepartureCities – города вылета в дополнительных фильтрах
- ' –
- DepartureAirports – аэропорты вылета в дополнительных фильтрах
- ' –
- ArrivalCities – города прибытия в дополнительных фильтрах
- ' –
- ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
- ' –
- HotelTypes – признаки отелей в дополнительных фильтрах
- ' –
- HotelCities – город в дополнительных фильтрах
- TourTypes – типы тура
Выгрузка транспортного плана (TransportPlan)
Метод производит выгрузку транспортного плана.
- Формат запроса:
- GET .../TourSearchOwin/TransportPlan?
- Принимаемые параметры ( * – обязательный):
- code – код услуги
- dateBegin – дата услуги
- serviceType – тип услуги
- transportKey – ключ справочника транспорт
- Возвращаемый результат:
- TransportKey – ключ справочника транспорт
- Title – описание
- AreasCount – количество уровней
- RowsCount – количество рядов
- ColumnsCount – количество мест в ряду
- BusySeats – не используется
- Cells – массив описаний всех мест
- Row – ряд
- Column – место в ряду
- Area – уровень места
- Type – тип (None = 0, Seat = 1, Block = 4, Busy = 5)
- Name – название/номер
- UserSeats – не используется
- BlockSeat – не используется
Выгрузка первоначального варианта в корзину для бронирования (Tour)
Метод поиска, который возвращает варианты только по данной турпрограмме и схеме отеля.
- Формат запроса:
- GET .../TourSearchOwin/Tour?
- Принимаемые параметры ( * – обязательный):
- DepartureCityKeys * – идентификатор города отправления (полученный из метода .../TourSearchOwin/departureCities?)
- DestinationType * – тип результата (всегда возвращается в JSON = 1, в xml = country)
- DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- AdultCount * – количество взрослых
- ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- CurrencyName * – код валюты
- HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelScheme * – объект схемы отеля
- TemplateId – идентификатор шаблона услуги
- DurationInNight – продолжительность отеля в ночах
- Code – ключ отеля
- PacketKey – ключ пакета
- PartnerKey – ключ партнера
- GDSProviderId – ключ провайдера из внешней системы
- TotalTourDuration – общая продолжительность тура в днях, обрабатывается начиная с релиза 15.6, обязательный параметр. Изменения связаны с возможностью работы поиска в ночах проживания в отеле, для перехода в корзину необходимо знать общую продолжительность тура. Взять значение для параметра TotalTourDuration для HotelScheme можно из свойства Duration, пришедшего для данной цены в ответе метода поиск туров (Tour)
- PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
- PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
- isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false).
- isFillSecondaryFilters * – заполнены ли дополнительные фильтры (true/false)
- TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
- TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
- RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Обрабатывается начиная с релиза 15.4.
- Возвращаемый результат:
- CheckMessages – сообщения для логики проверки тура (не используется)
- Message – сообщение об ошибке
- Key – код ошибки
- Value – сообщение об ошибке
- Result – результаты поиска
- Key – идентификатор программы тура
- Name – название программы тура
- TourUrl – ссылка на программу тура
- BookingConditions – условия бронирования программы туров
- StartDate – дата начала тура
- Duration – продолжительность тура (в днях)
- DurationInNight – продолжительность проживания (в ночах)
- Types – идентификатор типа туров
- Cost – цена тура
- Rate – код валюты тура
- CityDepature – город отправления
- Key – идентификатор города отправления
- Value – название города отправления
- CountryId – всегда возвращается ключ 0
- Services – услуги в туре
- DepartureCity – город отправления
- Key – идентификатор
- Value – название
- DepartureCountry – страна отправления
- Key – идентификатор
- Value – название
- ArrivalCity – город прибытия
- Key – идентификатор
- Value – название
- ArrivalCountry – страна прибытия
- Key – идентификатор
- Value – название
- DepartureAirport – аэропорт отправления
- Key – идентификатор
- Value – название
- ArrivalAirport – аэропорт прибытия
- Key – идентификатор
- Value – название
- Airline – авиакомпания
- Key – идентификатор
- Value – название
- Aircraft – воздушное судно
- Key – идентификатор
- Value – название
- Flight – рейс
- Key – идентификатор
- Value – название
- DepartureTime – время вылета
- ArrivalTime – время прилета
- EndDateTime – дата и время прилета
- FlightDetails – информация об авиаперелете
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – название тарифа
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – название
- Tariff – информация о тарифе перелета
- FlightSetting – внутренняя информация о перелете из программы туров
- ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
- PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- FlightId – идентификатор перелета (внутренняя информация из программы туров)
- FlightSourceMode – локальный или удаленный перелет (внутренняя информация из программы туров)
- Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
- SvKey – ключ типа услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- IsHooded – признак скрытая услуга
- IsDeleted – признак удаляемая услуга
- IsNotCalculate – признак не рассчитываемая услуга
- PacketId – ключ пакета
- Index – порядковый номер услуги
- DepartureCity – город отправления
- NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
- ServiceName – название типа услуги
- City – объект город
- Key – ключ города
- Value – название города
- Country – ключ страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – флаг услуга по расписанию или нет
- Details – объект детализация услуги
- SubCode1 – объект доп. описание 1
- Key – ключ доп. описания 1
- Value – название доп. описания 1
- SubCode2 – объект доп. описание 2
- Key – ключ доп. описания 2
- Value – название доп. описания 2
- Date – дата услуги
- IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
- Cost – цена
- QuotaStatus – объект информация по квотам
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – идентификатор партнера
- ByPax – признак цены за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- SubCode1 – объект доп. описание 1
- ParentId – идентификатор родительской услуги (для вложенных услуг)
- PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
- Id – идентификатор услуги
- SvKey – ключ типа услуги
- IsSubCode1 – наличие доп. описания 1
- IsSubCode2 – наличие доп. описания 2
- IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- EndDateTime – дата окончания услуги
- IsHooded – скрытая ли услуга
- IsDeleted – удаляемая ли услуга
- IsNotCalculate – не рассчитываемая ли услуга
- PacketId – пакет услуги
- Index – индекс услуги
- MinCostServicesComposition – массив состав услуг минимальной цены
- Key – ключ
- TemplateId – идентификатор шаблона
- PatternId – идентификатор вкладки
- SettingId – идентификатор услуги
- Value – значение
- ServiceType – тип услуги
- Code – ключ услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- PacketId – пакет услуги
- PartnerId – партнер услуги
- CountryId – страна услуги
- CityId – город услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
- AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
- AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
- SpecialKey – ключ акции
- SpecialName – название акции
- SpecialType – тип акции
- NewPrice – цена после применения акции
- OldPrice – цена до применения акции
- ShowOnline – нужно ли показывать акцию в поиске
- UntilDate – акция действует при совершении покупки до указанной даты
- Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
- NightsFrom (для типа PayStay) – ночей от
- NightsTo (для типа PayStay) – ночей до
- NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
- OperationType (для типа PayStay) – тип действия
- SpecialNightType (для типа PayStay) – тип бесплатной ночи
- DurationFrom (для типа KickBack) – ночей от
- DurationTo (для типа KickBack) – ночей до
- Value (для типа KickBack) – значение продолжительности, равное заданному периоду
- OperationType (для типа KickBack) – тип действия
- NightsFrom (для типа EarlyBird) – ночей от
- NightsTo (для типа EarlyBird) – ночей до
- Discount (для типа EarlyBird) – размер скидки
- OperationType (для типа EarlyBird) – тип действия
- COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
- SpecialsBySubCode - список применённых акций по SubCode1 и SubCode2
- SubCode1 – объект доп. описание 1
- SubCode2 – объект доп. описание 2
- Key – ключ
- 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 – флаг включен/выключен
- notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
- RouteSubVariants – подварианты услуг (используется в основном поиске)
- SecondaryFiltersResult – доп. фильтры (не используется при вызове из корзины)
Выгрузка настройки отображения полей по туристам (TouristDataSettings)
Метод производит выгрузку настроек отображения полей по туристам.
- Формат запроса:
- GET .../TourSearchOwin/TouristDataSettings?
- Принимаемые параметры ( * – обязательный):
- countryId * – ключ страны, для которой будут выгружаться настройки
- Возвращаемый результат:
- TouristFieldsSettings – массив полей с информацией о туристах (из админки Мастер-Web)
- lastname – объект фамилия туриста (лат)
- Code – код поля
- HeaderText – название поля
- IsVisible – видимость поля
- IsRequired – признак обязательности заполнения поля
- IsEdit – признак редактируемости поля
- Translit – настройки транслитерации (0 – нет, 1 – транслитерация, 2 – латиница)
- LetterCase – настройки регистра (0 – по умолчанию, 1 – с заглавной, 2 – большие, 3 – маленькие)
- patronymic – объект отчество туриста (лат)
- sex – объект пол туриста
- firstname – объект имя туриста (лат)
- passportbywhom – объект кем выдан заграничный паспорт
- birthplace – объект место рождения
- birthdate – объект дата рождения
- patronymicrus – объект отчество (рус)
- lastnamerus – объект фамилия туриста (рус)
- citizenid – объект ID туриста
- passport – объект серия и номер заграничного паспорта
- passportrus – объект серия и номер национального паспорт а
- ismain – объект признак главного туриста
- passportdate – объект дата выдачи заграничного паспорта
- firstnamerus – объект имя туриста (рус)
- passportbywhomrus – объект кем выдан национальный паспорт
- citizenship – объект гражданство
- passportdaterus – объект дата выдачи национального паспорта
- phone – объект телефон
- number – объект порядковый номер
- passportdateend – объект дата окончания заграничного паспорта
- email – объект e-mail туриста
- lastname – объект фамилия туриста (лат)
- PassportDurationOfExpiry – объект минимальный срок действия загранпаспорта туриста
- StartPoint – точка отсчета
- Duration – минимальная продолжительность
- ChildAgeSetting – максимальный возраст ребенка, когда он считается ребенком (лет)
- InfantAgeSetting – максимальный возраст младенца (месяцев)
- TouristFieldsSettings – массив полей с информацией о туристах (из админки Мастер-Web)
Выгрузка услуг доплат к авиаперелетам (GetFlightsAdditionalServices)
Метод производит выгрузку услуг доплат к авиаперелетам.
- Формат запроса:
- POST .../TourSearchOwin/GetFlightsAdditionalServices?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- TourProgramId – ключ турпрограммы
- BeginDate – дата начала тура
- Duration – продолжительность тура
- Currency – код валюты
- Services – массив услуг авиаперелетов для получения доплат
- Service – объект услуга авиаперелет
- ServiceType – тип услуги
- Code – код услуги
- SubCode1 – доп. описание 1 услуги
- SubCode2 – доп. описание 2 услуги
- Packet – ключ пакета услуги
- Partner – ключ партнера услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- City – ключ города
- Country – страна услуги
- Attributes – битовая маска атрибутов услуг
- IsRemovable – (не обрабатывается)
- Type – тип услуги в путевке (базовая дополнительная)
- IsHooded – признак скрытая услуга
- IsNotCalculated – признак не рассчитываемая услуга
- BeginDateTimeString – дата и время начала услуги
- EndDateTimeString – дата и время окончания услуги
- TemplateId – шаблон услуги
- Cost – цена услуги
- ByPax – цена за человека
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index – индекс услуги
- IsRoute – признак маршрутная услуга
- ServiceTemplateIndex – индекс шаблона услуги
- TouristNumbersList – массив туристов, привязанных к услуге
- Service – объект услуга авиаперелет
- Tourists – массив туристов
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта
- PassportDateOfIssueString – дата выдачи паспорта в строке
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- Возвращаемый результат:
- Массив – массив объектов доплат к авиаперелетам
- ServiceName – название услуги
- City – объект город
- Country – ключ страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – признак по расписанию
- Details - объект детализация
- SubCode1 – объект доп. описание 1
- Key – ключ
- Value – название
- SubCode2 – объект доп. описание 2
- Key – ключ
- Value – название
- Date – дата услуги
- IsShowTransportPlan – признак показать транспортный план (для автобусов)
- Cost – цена
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – признак за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- SubCode1 – объект доп. описание 1
- ParentId – ключ родительской услуги
- PartnerBasedOnServiceTemplateId – шаблон услуги для подбора поставщика
- ShowOrder – порядок при печати (сортировка) по услуге
- ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
- ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
- Id – идентификатор услуги
- SvKey – тип услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата начала услуги
- EndDateTime – дата окончания
- IsHooded – признак скрытая
- IsDeleted – признак удаляемая
- IsNotCalculate – признак не рассчитываемая
- PacketId – ключ пакета
- Index – индекс шаблона услуги
- Массив – массив объектов доплат к авиаперелетам
Выгрузка услуг доплат к отелям (GetHotelsAdditionalServices)
Метод производит выгрузку услуг доплат к отелям.
- Формат запроса:
- POST .../TourSearchOwin/GetHotelsAdditionalServices?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- TourProgramId – ключ турпрограммы
- BeginDate – дата начала тура
- Duration – продолжительность тура
- Currency – код валюты
- Services – массив услуг отелей для получения доплат
- Service – объект услуга отель
- ServiceType – тип услуги
- Code – код услуги
- SubCode1 – доп. описание 1 услуги
- SubCode2 – доп. описание 2 услуги
- Packet – ключ пакета услуги
- Partner – ключ партнера услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- City – ключ города
- Country – страна услуги
- Attributes – битовая маска атрибутов услуг
- IsRemovable – (не обрабатывается)
- Type – тип услуги в путевке (базовая дополнительная)
- IsHooded – признак скрытая услуга
- IsNotCalculated – признак не рассчитываемая услуга
- BeginDateTimeString – дата и время начала услуги
- EndDateTimeString – дата и время окончания услуги
- TemplateId – шаблон услуги
- Cost – цена услуги
- ByPax – цена за человека
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index – индекс услуги
- IsRoute – признак маршрутная услуга
- ServiceTemplateIndex – индекс шаблона услуги
- RemoteId – (в доплатах не используется)
- TouristNumbersList – массив туристов, привязанных к услуге
- Service – объект услуга отель
- Tourists – массив туристов
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта
- PassportDateOfIssueString – дата выдачи паспорта в строке
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения
- BirthDayString – дата рождения в строковом формате
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- Возвращаемый результат:
- Массив – массив объектов связок Возраст-Отель-Доп. услуги
- Age – возраст туриста
- Hotel – объект отель
- ServiceType – тип услуги
- Code – код услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- PacketId – ключ пакета
- PartnerId – ключ партнера
- Day – день предоставления услуги
- BeginTime – время начала услуги
- EndTime – время окончания услуги
- DurationInNight – продолжительность услуги в ночах
- Attributes – маска атрибутов услуги
- CountryId – ключ страны услуги
- CityId – ключ города
- Type – тип услуги в путевке
- ShowOrder – порядок при печати (сортировка) по услуге
- ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
- ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
- IsCommission – признак, комиссионная ли услуга
- BaseFlightsParams – параметр не обрабатывается
- AdditionalServices – массив доплат
- ServiceName – название услуги
- City – объект город
- Country – ключ страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – признак по расписанию
- Details - объект детализация
- SubCode1 – объект доп. описание 1
- Key – ключ
- Value – название
- SubCode2 – объект доп. описание 2
- Key – ключ
- Value – название
- Date – дата услуги
- IsShowTransportPlan – признак показать транспортный план (для автобусов)
- Cost – цена
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – признак за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- SubCode1 – объект доп. описание 1
- ParentId – ключ родительской услуги
- PartnerBasedOnServiceTemplateId – шаблон услуги для подбора поставщика
- ShowOrder – порядок при печати (сортировка) по услуге
- ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
- ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
- Id – идентификатор услуги
- SvKey – тип услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата начала услуги
- EndDateTime – дата окончания
- IsHooded – признак скрытая
- IsDeleted – признак удаляемая
- IsNotCalculate – признак не рассчитываемая
- PacketId – ключ пакета
- Index – индекс шаблона услуги
- Массив – массив объектов связок Возраст-Отель-Доп. услуги
Расчет индивидуальных услуг (CalculateIndividualServiceCosts)
Метод производит расчет услуг с индивидуальным выбором у туристов.
- Формат запроса:
- POST .../TourSearchOwin/CalculateIndividualServiceCosts?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- TourProgramId – ключ тура
- TourDate – дата тура
- TourDuration – продолжительность тура
- Currency – код валюты
- Services – массив индивидуальных услуг
- ServiceType – тип услуги
- Code – код услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- Packet – ключ пакета
- Partner – ключ партнера
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- City – объект город
- Country – страна услуги
- Attributes – маска атрибутов услуги
- Type – тип услуги
- IsHooded – признак скрытая
- IsNotCalculated – признак не рассчитываемая
- BeginDateTimeString – дата начала услуги в строке
- EndDateTimeString – дата начала услуги в строке
- TemplateId – номер шаблона услуги
- Cost – цена услуги
- ByPax – цена за человека
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index – индекс услуги
- IsRoute – признак маршрутная услуга
- ServiceTemplateIndex – индекс шаблона услуги
- RemoteId – (не используется)
- Ages – массив возрастов туристов
- Возвращаемый результат:
- Массив – массив связок Возраст-Услуга-Цена
- Age – возраст
- Service – объект услуга
- ServiceType – тип услуги
- Code – код услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- PacketId – ключ пакета услуги
- PartnerId – ключ партнера
- Day – день предоставления услуги
- BeginTime – время начала услуги
- EndTime – время окончания услуги
- DurationInNight – продолжительность услуги в ночах
- Attributes – маска атрибутов услуги
- CountryId – ключ страны
- CityId – ключ города
- Type – тип услуги
- ShowOrder – порядковый номер
- SimpleServiceCost – объект цена
- Brutto – брутто
- Discount – скидка
- Массив – массив связок Возраст-Услуга-Цена
Поиск рейсов из внешней системы (GetGDSFlights)
Метод производит поиск рейсов из внешней системы.
- Формат запроса:
- POST .../TourSearchOwin/GetGDSFlights?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- flightSettings – информация о шаблоне услуги авиаперелета
- templateId – идентификатор шаблона услуги
- patternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- serviceId – идентификатор класса услуги (внутренняя информация из программы туров)
- service – информация об услуге авиаперелета
- ServiceType – тип услуги
- Code – ключ услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- CountryId – страна услуги
- CityId – город услуги
- PacketId – пакет услуги
- PartnerId – партнер услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- price – стоимость перелета
- quotaInfo – объект информация по квотам
- status – статус по квотам (есть места / нет мест / под запрос)
- freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- flightDateTimeLimitationInterval –
- startLimitation – начало тайм-лимита
- finishLimitation – объект тайм-лимита
- dateTimeString – дата окончания тайм-лимита
- serviceType – тип услуги
- serviceCode – код услуги
- flightSourceMode – тип перелета (1 – локальный, 2 – из внешний системы)
- passengers – информация о пассажирах
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта
- PassportDateOfIssueString – дата выдачи паспорта в строке
- 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 – локализация
- flightSettings – информация о шаблоне услуги авиаперелета
- Возвращаемый результат:
- validationResult – информация о валидации
- Errors – ошибки
- Warnings – предупреждения
- States – статус
- IsValid – информация о результате
- flightsStartEndPointPatterns – информация о начале и окончании перелета
- fromPoint – информация о перелете отправления
- country – страна вылета
- id – ключ
- description – описание
- code – код
- city – город вылета
- id – ключ
- description – описание
- code – код
- airport – аэропорт вылета
- id – ключ
- description – описание
- code – код
- country – страна вылета
- toPoint – информация о перелете прибытия
- country – страна прилета
- id – ключ
- description – описание
- code – код
- city – город прилета
- id – ключ
- description – описание
- code – код
- airport – аэропорт прилета
- id – ключ
- description – описание
- code – код
- country – страна прилета
- fromPoint – информация о перелете отправления
- passengersAgeInfos – информация о возрасте пассажиров
- ageType – тип пассажира
- count – количество человек
- flightsSequencies – информация о перелете
- flights – массив данных о перелете из внешнего поставщика
- – ...
- deltaPrice – разница в цене
- amount – стоимость
- currency – валюта
- timeForward – время вперед
- timeBackward – время обратно
- hasTariffFamily – имеется ли семейство тарифов
- rating – рейтинг
- flights – массив данных о перелете из внешнего поставщика
- airTravelAdapterFilterValues – дополнительная информация
- LuggageFilterValue – багаж
- ClassAirTravelFilterValue – класс перелета
- ConnectionsFilterValue – пересадки
- SortFilterValue – сортировка
- AutomaticFlightSelection – подбор перелета
- tariff – тариф
- minFlightTimeForward – минимальное время в пути туда
- maxFlightTimeForward – максимальное время в пути туда
- minFlightTimeBackward – минимальное время в пути обратно
- maxFlightTimeBackward – максимальное время в пути обратно
- validationResult – информация о валидации
Получение семейств тарифов авиаперелетов из внешней системы (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 – дата выдачи загранпаспорта
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта
- PassportDateOfIssueString – дата выдачи паспорта в строке
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- currency – валюта
- price – стоимость
- param – параметры перелета
- flightsSource – параметры перелета
- flightSettings – информация о шаблоне услуги авиаперелета
- templateId – идентификатор шаблона услуги
- patternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- serviceId – идентификатор класса услуги (внутренняя информация из программы туров)
- service – информация об услуге авиаперелета
- ServiceType – тип услуги
- Code – ключ услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- CountryId – страна услуги
- CityId – город услуги
- PacketId – пакет услуги
- PartnerId – партнер услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- price – стоимость перелета
- quotaInfo – объект информация по квотам
- status – статус по квотам (есть места / нет мест / под запрос)
- freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- flightDateTimeLimitationInterval –
- startLimitation – начало тайм-лимита
- finishLimitation – объект тайм-лимита
- dateTimeString – дата окончания тайм-лимита
- serviceType – тип услуги
- serviceCode – код услуги
- flightSourceMode – тип перелета (1 – локальный, 2 – из внешний системы)
- flightSettings – информация о шаблоне услуги авиаперелета
- passengers – информация о пассажирах
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта
- PassportDateOfIssueString – дата выдачи паспорта в строке
- 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 – локализация
- flightsSource – параметры перелета
- Возвращаемый результат:
- validationResult – информация о валидации
- Errors – ошибки
- Warnings – предупреждения
- States – статус
- IsValid – информация о результате
- tariffSequencies – информация тарифах
- flightId – идентификатор перелета
- universalParametrsSequence – параметры тарифов
- universalParametrs – массив параметров
- code – описание параметра тарифа
- priority – приоритет показа
- needToPay – нужна ли доплата
- shortDescriptions – краткое описание
- code – код
- value – значение
- universalParametrs – массив параметров
- price – стоимость
- deltaPrice – разница в цене
- timeLimit – тайм-лимит
- segments – сегменты
- depAirportCode – код аэропорта отправления
- depCityCode – код города отправления
- arrAirportCode – код аэропорта прибытия
- arrCityCode – код города прибытия
- validationResult – информация о валидации
Загрузка филиалов (Branches) начиная с релиза 15.3
Метод производит выгрузку филиалов бронирования.
- Формат запроса:
- GET .../TourSearchOwin/Branches?
- Принимаемые параметры GET запроса ( * – обязательный):
- ids – массив ключей филиалов
- cityKey – фильтр по городу филиала (если 0 или не задан, то выбираются все филиалы)
- Возвращаемый результат:
- Key – ключ филиала (ключ партнера)
- Value – название филиала (название партнера)
Загрузка ведущих менеджеров (Users) начиная с релиза 15.3
Метод производит выгрузку ведущих менеджеров.
- Формат запроса:
- GET .../TourSearchOwin/Users?
- Принимаемые параметры GET запроса ( * – обязательный):
- ids – массив ключей ведущих менеджеров
- branchKey – ключ филиала бронирования, к которому они привязаны
- Возвращаемый результат:
- Key – ключ ведущего менеджера
- Value – полное имя ведущего менеджера
Расчет путевки (CalculateReservation)
Метод производит расчет стоимости путевки.
- Формат запроса:
- POST .../TourSearchOwin/CalculateReservation?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса:
- TourProgramId – ключ турпрограммы
- BeginDate – дата начала тура
- Duration – продолжительность тура
- Currency – код валюты
- initialPrice – объект изначальная цена
- price – цена
- currency – код валюты
- Services – массив услуг
- Service – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
- ServiceType – тип услуги (поле sv_key из таблицы service)
- Code – код услуги
- SubCode1 – доп. описание 1 услуги
- SubCode2 – доп. описание 2 услуги
- Packet – ключ пакета услуги
- Partner – ключ партнера услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- City – ключ города
- Country – страна услуги
- Attributes – битовая маска атрибутов услуг
- IsRemovable – (не обрабатывается)
- Type – тип услуги в путевке (базовая дополнительная)
- IsHooded – признак скрытая услуга
- IsNotCalculated – признак не рассчитываемая услуга
- BeginDateTimeString – дата и время начала услуги
- EndDateTimeString – дата и время окончания услуги
- TemplateId – шаблон услуги
- Cost – цена услуги
- ByPax – цена за человека
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index – индекс услуги
- IsRoute – признак маршрутная услуга
- ServiceTemplateIndex – индекс шаблона услуги
- RemoteId – информация об услуге в удаленной системе
- IsCommission – признак, комиссионная ли услуга
- BaseFlightsParams – параметры рассчитанных авиаперелетов
- CityArrival – ключ города прибытия прямого перелета
- FlightCode – ключ прямого авиаперелета
- TariffKey – ключ тарифа прямого авиаперелета
- PartnerId – ключ партнера прямого авиаперелета
- CityArrival – ключ города прибытия обратного перелета
- FlightCode – ключ обратного авиаперелета
- TariffKey – ключ тарифа обратного авиаперелета
- PartnerId – ключ партнера обратного авиаперелета
- TouristNumbersList – массив туристов, привязанных к услуге
- Service – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
- Tourists – массив туристов
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта
- PassportDateOfIssueString – дата выдачи паспорта в строке
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения
- BirthDayString – дата рождения в строковом формате
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- Day – день (перевод)
- Day2 – дня (перевод)
- Days – дней (перевод)
- Night – ночь (перевод)
- Night2 – ночи (перевод)
- Nights – ночей (перевод)
- adultsCountOverServiceLimit – Количество взрослых туристов превышает лимит услуги (перевод)
- at – на (перевод)
- incorrectChildrenInf – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод)
- Возвращаемый результат:
- IsValid – признак валидности путевки
- ErrorMessage – сообщение об ошибке, если есть
- CalculatedReservation – объект рассчитанной путевки
- TourKey – ключ тура
- BeginDate – дата начала тура
- Duration – продолжительность путевки в днях
- Currency – код валюты тура
- CalculatedServicesPrice – сумма обязательных услуг, входящих в состав тура
- ChangedPrice – сумма, на которую изменилась итоговая стоимость TotalPrice в результате добавления обязательных и дополнительных услуг
- Price – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в валюте тура)
- TotalPrice – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в валюте тура)
- IsDiscountIsPercent – признак, в процентах ли дается партнерская комиссия или в y.e.
- NationalChangedPrice – сумма, на которую изменилась итоговая стоимость TotalPrice в результате добавления обязательных и дополнительных услуг (в национальной валюте)
- NationalTotalDiscount – партнерская комиссия агентству (в национальной валюте)
- NationalTotalPrice – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в национальной валюте)
- NatinoalCalculatedServicesPrice – сумма обязательных услуг, входящих в состав тура (в национальной валюте)
- NationalPrice – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в национальной валюте)
- Discount – партнерская комиссия агентству (в процентах или y.e.)
- TotalDiscount – партнерская комиссия агентству (в валюте тура)
- ServiceTourists – массив услуг, входящих в тур
- ServiceType – тип услуги
- Day – день предоставления
- DurationInNight – продолжительность в ночах
- Time – время начала услуги
- Name – полное описание услуги
- TouristCount – количество туристов на услуге
- Attributes – битовая маска атрибутов
- Type – тип услуги (основная/дополнительная)
- Brutto – цена брутто
- NationalBrutto – цена брутто в национальной валюте
- TotalBrutto – итоговое брутто
- TourName – название тура
- BookingConditions – разметка условия бронирования
- EndDate – дата окончания тура
- DurationInNights – продолжительность тура в ночах
- NationalCurrency – код национальной валюты
Бронирование путевки (CreateReservation)
Метод производит бронирование путевки.
- Формат запроса:
- PUT .../TourSearchOwin/CreateReservation/1?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
- Принимаемые параметры PUT запроса:
- TourProgramId – ключ турпрограммы
- BeginDate – дата начала тура
- Duration – продолжительность тура
- Currency – код валюты
- Services – массив услуг
- Service – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
- ServiceType – тип услуги (поле sv_key из таблицы service)
- Code – код услуги
- SubCode1 – доп. описание 1 услуги
- SubCode2 – доп. описание 2 услуги
- Packet – ключ пакета услуги
- Partner – ключ партнера услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- City – ключ города
- Country – страна услуги
- Attributes – битовая маска атрибутов услуг
- IsRemovable – (не обрабатывается)
- Type – тип услуги в путевке (базовая дополнительная)
- IsHooded – признак скрытая услуга
- IsNotCalculated – признак не рассчитываемая услуга
- BeginDateTimeString – дата и время начала услуги
- EndDateTimeString – дата и время окончания услуги
- TemplateId – шаблон услуги
- Cost – цена услуги
- ByPax – цена за человека
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index – индекс услуги
- IsRoute – признак маршрутная услуга
- ServiceTemplateIndex – индекс шаблона услуги
- RemoteId – информация об услуге в удаленной системе
- IsCommission – признак, комиссионная ли услуга
- BaseFlightsParams – параметры рассчитанных авиаперелетов
- CityArrival – ключ города прибытия прямого перелета
- FlightCode – ключ прямого авиаперелета
- TariffKey – ключ тарифа прямого авиаперелета
- PartnerId – ключ партнера прямого авиаперелета
- CityArrival – ключ города прибытия обратного перелета
- FlightCode – ключ обратного авиаперелета
- TariffKey – ключ тарифа обратного авиаперелета
- PartnerId – ключ партнера обратного авиаперелета
- TouristNumbersList – массив туристов, привязанных к услуге
- Service – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
- Tourists – массив туристов
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта
- PassportDateOfIssueString – дата выдачи паспорта в строке
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace – место рождения
- CitizenID – ID туриста (задается в карточке постоянного клиента)
- Age – количество полных лет на момент окончания тура
- BranchId – ключ филиала бронирования (начиная с релиза 15.3). Если не передан, то филиал бронирования берется из менеджера по умолчанию либо из пользователя, создавшего тур.
- OwnerId – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура.
- Day – день (перевод)
- Day2 – дня (перевод)
- Days – дней (перевод)
- Night – ночь (перевод)
- Night2 – ночи (перевод)
- Nights – ночей (перевод)
- adultsCountOverServiceLimit – Количество взрослых туристов превышает лимит услуги (перевод)
- incorrectChildrenInf – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод)
- Возвращаемый результат:
- Reservation – объект путевки
- $id – внутренний идентификатор для установки связей между сущностями,
- Code – код путевки
- TurDate – дата заезда
- TRKey – ключ тура
- CNKey – ключ страны
- CTKey – ключ города
- NMen – количество туристов по путевке
- Price – стоимость путевки за вычетом скидки (комиссии)
- Payed – оплаченная сумма по путевке
- NDay – продолжительность тура в днях
- MainMan – ФИО лица, заключившего договор
- MainManPhone – номер телефона лица, заключившего договор
- MainManAddress – адрес лица, заключившего договор
- MainManPassport – паспортные данные лица, заключившего договор
- PartnerKey – ключ партнера, оформившего договор
- Operator – ФИО создателя договора
- Discount – величина скидки на одного человека
- DiscountSum – абсолютная величина скидки
- SORCode – ключ статус путевки
- CrDate – дата и время создания путевки
- Rate – код валюты путевки
- Advertise – ключ источника рекламы
- Locked – блокировка путевки: 1 – если заблокирована
- CauseDisc – ключ основания для скидки
- PPaymentDate – максимальная дата внесения предоплаты
- PaymentDate – максимальная дата полной оплаты
- Procent – информация о предоплате: 1 – предоплата в %; 0 – предоплата в у.е.
- TurDateBfrAnnul – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
- ARKey – ключ причины аннуляции путевки
- Key – ключ договора
- CodePartner – значение ключевого поля из таблицы партнеров
- FilialKey – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
- IsOutDoc – статус выдачи документов
- Notes – сообщение поставщику
- DiscSumBfrAnn – числовое значение скидки перед аннуляцией путевки
- PriceBfrAnn – стоимость путевки перед ее аннуляцией
- RazmerP – размер предоплаты
- LeadDepartment – ключ отдела, ведущего данный тур
- MainManEmail – адрес е-mail из данных лица, заключившего договор
- MainManComment – примечание из данных лица, заключившего договор
- DupUserKey – ключ представителя партнера, которым был оформлен договор
- BTKey – ключ системы бронирования, из которой был оформлен договор
- ConfirmedDate – дата подтверждения путевки покупателю
- PrtDogKey – договор партнера, по которому оформлена путевка
- CTDepartureKey – ключ города начала поездки
- PDTType – тип договора, по которому оформлена путевка
- NationalCurrencyPrice – стоимость путевки в национальной валюте
- NationalCurrencyDiscountSum – значение скидки в национальной валюте
- NationalCurrencyPayed – сумма платежей по путевке, зафиксированная в национальной валюте
- CurrencyKey – ключ национальной валюты путевки
- CurrencyRate – курс национальной валюты путевки
- ClientKey – ключ частника, которым был оформлен договор
- Partner – информация о партнере покупателе, привязанным к путевке
- $id – внутренний идентификатор для установки связей между сущностями
- Key – ключ партнера покумателя
- FullName – полное имя партнера
- Name – имя партнера
- Services – коллекция услуг в данной путевке
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки
- TurDate – дата начала тура
- Key – ключ услуги
- PaketKey – ключ пакета
- TRKey – клют тура
- SVKey – ключ типа услуги
- Name – наименование услуги
- Day – порядковый номер дня тура, в который предоставляется услуга
- Code – ключ кода услуги
- SubCode1 – ключ доп.описания 1 услуги
- SubCode2 – ключ доп.описания 2 услуги
- Men – количество человек, пользующихся услугой по путевке
- Days – количество дней услуги
- CNKey – ключ страны услуги
- CTKey – ключ города услуги
- PartnerKey – ключ партнера, предоставляющего услугу
- Brutto – стоимость услуги брутто
- Wait – признак услуги Снимать квоту при бронировании
- Warning – неиспользуемое поле
- TimeBeg – поле используется для сортировки услуг в путевке
- Control – ключ статуса услуги (ссылка на таблицу Controls),
- Attribute – атрибут услуги
- DateBeg – дата начала действия услуги
- DateEnd – дата окончания действия услуги
- Discount – размер скидки по услуге
- Comment – комментарий к услуге
- DGKey – ключ договора,
- Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
- NameLat – наименование услуги (латинский)
- Long – продолжительность тура в днях
- TRFId – ключ тарифа
- CreateDate – дата создания услуги в путевке
- CalculatePriceDate – дата расчета цены
- ShowOrder – порядок при сортировке
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- Turists – коллекция туристов в данной путевке
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки, к которому привязан турист
- Key – ключ туриста
- TurDate – дата начала тура
- NameRus – фамилия туриста (русское)
- NameLat – фамилия туриста (латинское)
- ShortName – имя и отчество туриста в формате И.О.
- Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
- FNameRus – имя туриста (русское)
- FNameLat – имя туриста (латинское)
- SNameRus – отчество туриста (русское)
- SNameLat – отчество туриста (латинское)
- BirthDay – дата рождения туриста
- BirthCountry – страна рождения туриста
- BirthCity – город рождения туриста
- Citizen – гражданство туриста
- PostIndex – почтовый индекс
- PostCity – адрес проживания туриста (город)
- PostStreet – адрес проживания туриста (улица)
- PostBild – адрес проживания туриста (номер дома)
- PostFlat – адрес проживания туриста (номер квартиры)
- Phone – номер телефона туриста
- PhoneCode – код телефона туриста
- PasportType – серия заграничного паспорта
- PasportNum – номер заграничного паспорта
- PasportDate – дата выдачи заграничного паспорта
- PasportDateEnd – дата окончания срока действия заграничного паспорта
- PasportByWhom – кем выдан заграничный паспорт
- Place – место рождения
- IsAnketa – выдавалась ли анкета
- PaspRuser – серия общегражданского паспорта
- PaspRuNum – номер общегражданского паспорта
- PaspRuDate – дата выдачи общегражданского паспорта
- PaspRuByWhom – кем выдан общегражданский паспорт
- ClientId – ключ в таблице клиентов
- IsMain – признак главного туриста по путевке
- DGKey – ключ кутевки
- RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
- Email – е-mail туриста
- EnableSmsNotifications – согласен получать уведомления по СМС
- CitizenId – идентификатор туриста
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- TuristServices – коллекция связей туриста с услугой
- $id – внутренний идентификатор для установки связей между сущностями
- TUKey – ключ туриста
- DLKey – ключ услуги
- NumDoc – номер документа (авиабилета)
- NumRoom – номер комнаты (каюты)
- Seat – номер места (в номере отеля, каюты) или место в транспорте
- Area – зона (палуба) в отеле, круизе
- DocDate – дата документа (авиабелета)
- Key – первичный ключ связки
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- DogovorMessages – сообщение по путевке покупателю
- id – внутренний идентификатор для установки связей между сущностями
- Date – дата создание сообщения
- Text – текст сообщения
- Remark – код сообщения
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- ValidationResultSummary – объект статус результата бронирования
- ValidationResult – объект с ошибками и флагом валидности путевки
- Errors – массив ошибок бронирования
- IsValid – признак валидности бронирования
- ValidationResultAttributes – атрибут результата бронирования
- ValidationResult – объект с ошибками и флагом валидности путевки
- Reservation – объект путевки
Выгрузка информации о путевке (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 – ключ статус путевки
- CrDate – дата и время создания путевки
- Rate – код валюты путевки
- Advertise – ключ источника рекламы
- Locked – блокировка путевки: 1 – если заблокирована
- CauseDisc – ключ основания для скидки
- PPaymentDate – максимальная дата внесения предоплаты
- PaymentDate – максимальная дата полной оплаты
- Procent – информация о предоплате: 1 – предоплата в %; 0 – предоплата в у.е.
- TurDateBfrAnnul – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
- ARKey – ключ причины аннуляции путевки
- Key – ключ договора
- CodePartner – значение ключевого поля из таблицы партнеров
- FilialKey – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
- IsOutDoc – статус выдачи документов
- Notes – сообщение поставщику
- DiscSumBfrAnn – числовое значение скидки перед аннуляцией путевки
- PriceBfrAnn – стоимость путевки перед ее аннуляцией
- RazmerP – размер предоплаты
- LeadDepartment – ключ отдела, ведущего данный тур
- MainManEmail – адрес е-mail из данных лица, заключившего договор
- MainManComment – примечание из данных лица, заключившего договор
- DupUserKey – ключ представителя партнера, которым был оформлен договор
- BTKey – ключ системы бронирования, из которой был оформлен договор
- ConfirmedDate – дата подтверждения путевки покупателю
- PrtDogKey – договор партнера, по которому оформлена путевка
- CTDepartureKey – ключ города начала поездки
- PDTType – тип договора, по которому оформлена путевка
- NationalCurrencyPrice – стоимость путевки в национальной валюте
- NationalCurrencyDiscountSum – значение скидки в национальной валюте
- NationalCurrencyPayed – сумма платежей по путевке, зафиксированная в национальной валюте
- CurrencyKey – ключ национальной валюты путевки
- CurrencyRate – курс национальной валюты путевки
- ClientKey – ключ частника, которым был оформлен договор
- Partner – информация о партнере покупателе, привязанным к путевке
- $id – внутренний идентификатор для установки связей между сущностями
- Key – ключ партнера покумателя
- FullName – полное имя партнера
- Name – имя партнера
- Services – коллекция услуг в данной путевке
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки
- TurDate – дата начала тура
- Key – ключ услуги
- PaketKey – ключ пакета
- TRKey – клют тура
- SVKey – ключ типа услуги
- Name – наименование услуги
- Day – порядковый номер дня тура, в который предоставляется услуга
- Code – ключ кода услуги
- SubCode1 – ключ доп.описания 1 услуги
- SubCode2 – ключ доп.описания 2 услуги
- Men – количество человек, пользующихся услугой по путевке
- Days – количество дней услуги
- CNKey – ключ страны услуги
- CTKey – ключ города услуги
- PartnerKey – ключ партнера, предоставляющего услугу
- Brutto – стоимость услуги брутто
- Wait – признак услуги Снимать квоту при бронировании
- Warning – неиспользуемое поле
- TimeBeg – поле используется для сортировки услуг в путевке
- Control – ключ статуса услуги (ссылка на таблицу Controls),
- Attribute – атрибут услуги
- DateBeg – дата начала действия услуги
- DateEnd – дата окончания действия услуги
- Discount – размер скидки по услуге
- Comment – комментарий к услуге
- DGKey – ключ договора,
- Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
- NameLat – наименование услуги (латинский)
- Long – продолжительность тура в днях
- TRFId – ключ тарифа
- CreateDate – дата создания услуги в путевке
- CalculatePriceDate – дата расчета цены
- ShowOrder – порядок при сортировке
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- Turists – коллекция туристов в данной путевке
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки, к которому привязан турист
- Key – ключ туриста
- TurDate – дата начала тура
- NameRus – фамилия туриста (русское)
- NameLat – фамилия туриста (латинское)
- ShortName – имя и отчество туриста в формате И.О.
- Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
- FNameRus – имя туриста (русское)
- FNameLat – имя туриста (латинское)
- SNameRus – отчество туриста (русское)
- SNameLat – отчество туриста (латинское)
- BirthDay – дата рождения туриста
- BirthCountry – страна рождения туриста
- BirthCity – город рождения туриста
- Citizen – гражданство туриста
- PostIndex – почтовый индекс
- PostCity – адрес проживания туриста (город)
- PostStreet – адрес проживания туриста (улица)
- PostBild – адрес проживания туриста (номер дома)
- PostFlat – адрес проживания туриста (номер квартиры)
- Phone – номер телефона туриста
- PhoneCode – код телефона туриста
- PasportType – серия заграничного паспорта
- PasportNum – номер заграничного паспорта
- PasportDate – дата выдачи заграничного паспорта
- PasportDateEnd – дата окончания срока действия заграничного паспорта
- PasportByWhom – кем выдан заграничный паспорт
- Place – место рождения
- IsAnketa – выдавалась ли анкета
- PaspRuser – серия общегражданского паспорта
- PaspRuNum – номер общегражданского паспорта
- PaspRuDate – дата выдачи общегражданского паспорта
- PaspRuByWhom – кем выдан общегражданский паспорт
- ClientId – ключ в таблице клиентов
- IsMain – признак главного туриста по путевке
- DGKey – ключ кутевки
- RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
- Email – е-mail туриста
- EnableSmsNotifications – согласен получать уведомления по СМС
- CitizenId – идентификатор туриста
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- TuristServices – коллекция связей туриста с услугой
- $id – внутренний идентификатор для установки связей между сущностями
- TUKey – ключ туриста
- DLKey – ключ услуги
- NumDoc – номер документа (авиабилета)
- NumRoom – номер комнаты (каюты)
- Seat – номер места (в номере отеля, каюты) или место в транспорте
- Area – зона (палуба) в отеле, круизе
- DocDate – дата документа (авиабелета)
- Key – первичный ключ связки
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- DogovorMessages – сообщение по путевке покупателю
- id – внутренний идентификатор для установки связей между сущностями
- Date – дата создание сообщения
- Text – текст сообщения
- Remark – код сообщения
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
Выгрузка информации о ценовых блоках (CostOfferDescriptions)
Метод принимает на вход ключи ценовых блоков и возвращает, прикреплённое к ним описание.
- Формат запроса:
- GET .../TourSearchOwin/CostOfferDescriptions?
- Принимаемые параметры ( * – обязательный):
- COKeysString * – ключи ценовых блоков через запятую
- Возвращаемый результат:
- CostOfferImageInfo – коллекция объектов из двух полей:
- IdCostOffer – ключ ценового блока
- InfoText – описание ценового блока
- CostOfferImageInfo – коллекция объектов из двух полей:
Получение капчи (GetCaptcha)
Метод возвращает капчу (используется при регистрации частного лица).
- Формат запроса:
- GET .../TourSearchOwin/GetCaptcha?
- Принимаемые параметры ( * – обязательный):
- sessionId * – Id сессии
- Возвращаемый результат:
- FileContents – файл капчи в бинарном виде
- ContentType – расширение файла (image/jpeg)
- FileDownloadName – имя файла
Проверка капчи (CheckCaptcha)
Метод проверяет введенную капчу (используется при регистрации частного лица).
- Формат запроса:
- GET .../TourSearchOwin/CheckCaptcha?
- Принимаемые параметры ( * – обязательный):
- captchaText * – текст капчи
- sessionId * – Id сессии
- Возвращаемый результат:
- true/false – результат проверки (false – капча или Id сессии неверные, true – капча верна)
Проверка e-mail (CheckMail)
Метод проверяет e-mail при регистрации частного лица на существование такого же e-mail в базе данных.
- Формат запроса:
- GET .../TourSearchOwin/CheckMail?
- Принимаемые параметры ( * – обязательный):
- mail * – e-mail пользователя
- Возвращаемый результат:
- true/false – результат проверки (false – пользователь с таким e-mail уже существует, true – пользователь с таким e-mail нет в базе данных)
Проверка туриста (checkTourist)
Метод служит для получения информации о путевке по номеру путевки и номеру паспорта туриста.
- Формат запроса:
- GET .../TourSearchOwin/checkTourist?
- Принимаемые параметры ( * – обязательный):
- dogovorNumber * – номер путевки.
- passport * – номер паспорта туриста (заграничного или общегражданского).
- Возвращаемый результат:
- isDogovor – true, если путевка найдена по номеру путевки, false, если не найдена.
- isAnnulated – true, если путевка аннулирована, false, если не аннулирована.
- dogovorStatus – статус путевки
- isPay – true, если путевка полностью оплачена, false, если не оплачена или оплачена частично.
- dogovorDateBegin – дата начала заезда.
- dogovorDateEnd – дата окончания заезда.
- dogovorDateCreate – дата создания путевки.
- isTouristDogovorCreate – true, если турист (по номеру паспорта) является главным туристом в путевке.
- services – набор услуг в путевке.
- svKey – код класса услуги.
- code – код услуги.
- subCode1 – код доп. описания 1 услуги.
- subCode2 – код доп. описания 2 услуги.
- name – название услуги.
- touristInfo – информация о главном туристе.
- lastname – фамилия туриста (рус).
- firstname – имя туриста (рус).
- surname – отчество туриста.
- address – адрес (индекс, город, улица, дом, квартира).
- postcode – индекс.
- city – город.
- street – улица.
- home – дом.
- roomNumber – квартира.
Список значений параметра гражданства (Citizenships)
Метод служит для получения списка значений параметра гражданства.
- Формат запроса:
- GET .../TourSearchOwin/Citizenships?
- Принимаемые параметры ( * – обязательный):
- pageSize * – размер выдачи
- pageNumber * – порядковый номер страницы выдачи
- term * – подстрочный фильтр для отбора (пустой по умолчанию)
- Возвращаемый результат:
- Key – ключ страны
- Name – название гражданства
Выгрузка постоянного клиента (Client)
Метод выгружает постоянного клиента при авторизации частного лица.
- Формат запроса:
- GET .../TourSearchOwin/Client?
- Принимаемые параметры ( * – обязательный):
- clientId * – Id постоянного клиента
- Возвращаемый результат:
- $id – внутренний порядковый идентификатор
- CL_KEY – ключ справочника постоянные клиенты
- CL_OPERUPDATE – ключ менеджера, который последний обновил постоянного клиента
- CL_OPERUPDATE – дата обновления постоянного клиента
- CL_PFKEY – внутренний ключ
- CL_NAMERUS – имя (на русском)
- CL_NAMELAT – имя (на латинице)
- CL_SHORTNAME – инициалы
- CL_SEX – пол
- CL_FNAMERUS – фамилия (на русском)
- CL_FNAMELAT – фамилия (на латинице)
- CL_SNAMERUS – отчество (на русском)
- CL_SNAMELAT – отчество (на латинице)
- CL_BIRTHDAY – дата рождения
- CL_BIRTHCOUNTRY – страна рождения
- CL_BIRTHCITY – место рождения (город)
- CL_CITIZEN – гражданство
- CL_ADDRESS – полный адрес
- CL_POSTINDEX – почтовый индекс
- CL_POSTCITY – город
- CL_POSTSTREET – улица
- CL_POSTBILD – дом
- CL_POSTFLAT – квартира
- CL_PHONE – телефон
- CL_PASPORTSER – серия загранпаспорта
- CL_PASPORTNUM – номер загранпаспорта
- CL_PASPORTDATE – дата выдачи загранпаспорта
- CL_PASPORTDATEEND – срок действия загранпаспорта
- CL_PASPORTBYWHOM – кем выдан загранпаспорт
- CL_PASPRUSER – серия общегражданского паспорта
- CL_PASPRUNUM – номер общегражданского паспорта
- CL_PASPRUDATE – дата выдачи общегражданского паспорта
- CL_PASPRUBYWHOM – кем выдан общегражданский паспорт
- CL_ISMARK – профессия
- CL_TYPE – примечания
- CL_IMPRESSNOTE – общие впечатления
- CL_NOTE – особые отметки
- CL_REMARK – примечания
- CL_IMPRESSKEY – ключ выбранного впечатления
- CL_TITLE1 – служебные отметки, заголовок 1
- CL_TITLE2 – служебные отметки, заголовок 2
- CL_TITLE3 – служебные отметки, заголовок 3
- CL_TITLE4 – служебные отметки, заголовок 4
- CL_FUTURE – пожелания
- CL_LASTSTAT – информация о статистике
- CL_SUMMA – сумма по клиенту
- CL_NMENWITH – число спутников
- CL_SUMDOGOVOR – сумма по путевкам
- CL_NTRIP – число поездок
- ROWID – внутренний идентификатор
- cl_fax – факс
- cl_mail: – e-mail
- CL_MINCOST – минимальная стоимость поездки
- CL_MAXCOST – максимальная стоимость поездки
- CL_RealSex – пол
- CL_EnableSmsNotifications – признак согласен получать sms-уведомление
- CL_CHECKED – оповещения
- CL_Creator – создатель постоянного клиента
- CL_CreateDate – дата создания постоянного клиента
- CL_Login – логин
- CL_Password – пароль
- CL_IsOnlineUser – является ли постоянный клиент онлайн пользователем
- CL_CitizenID – ID гражданства
- CARDS – информация о дисконтной карте
Выгрузка описаний ценовых блоков (CostOfferDescriptions)
Метод выгружает описания ценовых блоков.
- Формат запроса:
- GET .../TourSearchOwin/CostOfferDescriptions?
- Принимаемые параметры ( * – обязательный):
- COKeysString * – ключи ценовых блоков
- Возвращаемый результат:
- IdCostOffer – Id ценового блока
- InfoText – описание ценового блока
Выгрузка описания по стране (CountryInfo)
Метод выгружает описание по стране.
- Формат запроса:
- GET .../TourSearchOwin/CountryInfo?
- Принимаемые параметры ( * – обязательный):
- countryKey * – ключ страны
- Возвращаемый результат:
- информация по выбранной стране
Выгрузка картинки по отелю (HotelImages)
Метод выгружает картинку по отелю.
- Формат запроса:
- GET .../TourSearchOwin/HotelImages?
- Принимаемые параметры ( * – обязательный):
- hotelKeys * – ключ отеля (можно передать несколько ключей отеля, каждый раз указывая параметр hotelKeys), в этом случае возвращается информация о главном фото отеля
- либо
- hotelKey * – либо ключ отеля, в этом случае возвращается полная информация всех фотографиях в отеле
- Возвращаемый результат (если передан hotelKeys):
- Name – название файла
- HotelKey – ключ отеля
- InfoExists – есть ли информация
- либо (если передан hotelKey)
- Images – объект картинок
- Key – ключ картинки
- Description – описание картинки
- Priority – приоритет
- Name – название файла
- HotelKey – ключ отеля
- InfoExists – есть ли информация
- Country – страна отеля
- City – город отеля
- Name – название отеля
- HotelCategoryName – категория отеля
- Address – адрес отеля
- Phone – телефон
- Email – e-mail
- Http – адрес сайта
- Description – описание отеля
- InfrastructureHotel – инфраструктура отеля
- RecreationSport – развлечения и спорт
- Beach – информация о пляже
- Healing – лечение
- Excursion – экскурсии
- AdditionalService – дополнительные услуги
- ForChildren – для детей
- AddCost – доплаты
- CheckoutTimeFrom – заезд в отель
- CheckoutTimeTo – выезд из отеля
- Latitude – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
- Longitude – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
- Images – объект картинок
Регистрация частного лица (PersonalRegistration)
Метод производит регистрацию частного лица.
- Формат запроса:
- GET .../TourSearchOwin/PersonalRegistration?
- Принимаемые параметры ( * – обязательный):
- name * – имя
- surname * – фамилия
- phone * – телефон
- login * – e-mail (он же является логином). Предварительно нужно вызывать метод проверки e-mail CheckMail
- password * – пароль (при упрощенной регистрации пароль не передается, а формируется системой автоматически)
- citizen * – гражданство (возможна передача пустого значения)
- country * – страна (возможна передача пустого значения)
- city * – город (возможна передача пустого значения)
- address * – адрес (возможна передача пустого значения)
- comment * – комментарий (возможна передача пустого значения)
- captchaText * – текст капчи. Предварительно нужно вызывать метод получения капчи GetCaptcha
- sessionId * – Id сессии (возможна передача произвольного значения)
- Возвращаемый результат:
- SxotpFhg – сформированный (при упрощенной регистрации) или заданный пользователем пароль
Выгрузка списка всех стран (Countries)
Метод производит выгрузку всех стран (используется для регистрации частного лица).
- Формат запроса:
- GET .../TourSearchOwin/Countries?
- Принимаемые параметры ( * – обязательный):
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Key – ключ страны
- Name – название
Выгрузка списка всех городов (Cities)
Метод производит выгрузку всех городов (используется для регистрации частного лица).
- Формат запроса:
- GET .../TourSearchOwin/Cities?
- Принимаемые параметры ( * – обязательный):
- countryKey * – ключ страны, по которой выгружать города (при значении -1 выгружаются все города)
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Key – ключ города
- Name – название
Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)
Метод производит выгрузку городов отправления в оформлении клиентов.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClientsDepartureCities?
- Принимаемые параметры ( * – обязательный):
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- withoutFlight – перевод для ключа -1 (Без перелета)
- Возвращаемый результат:
- Key – ключ города
- Name – название
- IsExist – информация о том, есть ли в этом городе отправления актуальные программы туров (true/false)
Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)
Метод производит выгрузку стран в оформлении клиентов.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClientsDestination?
- Принимаемые параметры ( * – обязательный):
- departureCity * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Name – название
- Key – ключ страны
- DestinationType – тип результата (всегда возвращается в JSON = 1, в xml = country)
- IsExist – информация о том, есть ли в этой стране актуальные программы туров (true/false)
Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)
Метод производит выгрузку турпрограмм в оформлении клиентов.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClientsTourPrograms?
- Принимаемые параметры ( * – обязательный):
- departureCity * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
- destination * – ключ страны (из контроллера .../TourSearchOwin/RegistrationClientsDestination?)
- destinationType * – тип результата (всегда возвращается в JSON = 1, в xml = country)
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- individualTitle – перевод для программы тура с ключом 0 (Индивидуально)
- Возвращаемый результат:
- Key – ключ программы туров
- Name – название программы туров
- Rate – валюта тура
Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)
Метод производит выгрузку дат заезда в оформлении клиентов.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClientsTourDate?
- Принимаемые параметры ( * – обязательный):
- tourKey * – ключ программы тура
- Возвращаемый результат:
- массив дат
Поиск туров в оформлении клиентов (Search)
Метод возвращает наиболее дешевое предложения по определенному туру.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClient/Search?
- Принимаемые параметры ( * – обязательный):
- DepartureCityKeys * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
- Dates * – дата заезда (из контроллера .../TourSearchOwin/RegistrationClientsTourDate?)
- Durations * – продолжительность
- PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
- PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
- isFromBasket * – всегда false
- isFillSecondaryFilters * – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true)
- DestinationType * – тип результата (всегда возвращается в JSON = 1, в xml = country)
- DestinationKey * – идентификатор страны прибытия (из контроллера .../TourSearchOwin/RegistrationClientsDestination?)
- AdultCount * – количество взрослых
- ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- IsRegistrationClients – по умолчанию всегда приходит false
- CurrencyName * – код валюты
- AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelScheme – пустой по умолчанию
- TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
- TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
- TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
- TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
- ArrivalFlightNoTransfer – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
- DepartureFlightNoTransfer – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
- TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
- Tour – ключ программы тура
- Возвращаемый результат:
- CheckMessages – сообщения для логики проверки тура (не используется)
- Message – сообщение об ошибке
- Key – код ошибки
- Value – сообщение об ошибке
- Result – результаты поиска
- Key – идентификатов программы тура
- Name – название программы тура
- TourUrl – ссылка на программу тура
- BookingConditions – условия бронирования программы туров
- StartDate – дата начала тура
- Duration – продолжительность тура (в днях)
- DurationInNight – продолжительность проживания (в ночах)
- Types – идентификатор типа туров
- Cost – цена тура
- Rate – код валюты тура
- CityDepature – город отправления
- Key – идентификатор города отправления
- Value – название города отправления
- CountryId – всегда возвращается ключ 0
- Services – услуги в туре
- DepartureCity – город отправления
- Key – идентификатор
- Value – название
- DepartureCountry – страна отправления
- Key – идентификатор
- Value – название
- ArrivalCity – город прибытия
- Key – идентификатор
- Value – название
- ArrivalCountry – страна прибытия
- Key – идентификатор
- Value – название
- DepartureAirport – аэропорт отправления
- Key – идентификатор
- Value – название
- ArrivalAirport – аэропорт прибытия
- Key – идентификатор
- Value – название
- Airline – авиакомпания
- Key – идентификатор
- Value – название
- Aircraft – воздушное судно
- Key – идентификатор
- Value – название
- Flight – рейс
- Key – идентификатор
- Value – название
- DepartureTime – время вылета
- ArrivalTime – время прилета
- EndDateTime – дата и время прилета
- FlightDetails – информация об авиаперелете
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – название тарифа
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – название
- Tariff – информация о тарифе перелета
- FlightSetting – внутренняя информация о перелете из программы туров
- ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
- PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- FlightId – идентификатор перелета (внутренняя информация из программы туров)
- FlightSourceMode – локальный или удаленный перелет (внутренняя информация из программы туров)
- Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
- SvKey – ключ типа услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- IsHooded – признак скрытая услуга
- IsDeleted – признак удаляемая услуга
- IsNotCalculate – признак не рассчитываемая услуга
- PacketId – ключ пакета
- Index – порядковый номер услуги
- DepartureCity – город отправления
- NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
- ServiceName – название типа услуги
- City – объект город
- Key – ключ города
- Value – название города
- Country – ключ страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – флаг услуга по расписанию или нет
- Details – объект детализация услуги
- SubCode1 – объект доп. описание 1
- Key – ключ доп. описания 1
- Value – название доп. описания 1
- SubCode2 – объект доп. описание 2
- Key – ключ доп. описания 2
- Value – название доп. описания 2
- Date – дата услуги
- IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
- Cost – цена
- QuotaStatus – объект информация по квотам
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – идентификатор партнера
- ByPax – признак цены за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- SubCode1 – объект доп. описание 1
- ParentId – идентификатор родительской услуги (для вложенных услуг)
- PartnerBasedOnServiceTemplateId – ключ шаблона услуги, по которой приоритетно выбирается партнер текущей услуги
- Id – идентификатор услуги
- SvKey – ключ типа услуги
- IsSubCode1 – наличие доп. описания 1
- IsSubCode2 – наличие доп. описания 2
- IsPartnerBasedOn – услуга с подбором приоритетного поставщика услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- EndDateTime – дата окончания услуги
- IsHooded – скрытая ли услуга
- IsDeleted – удаляемая ли услуга
- IsNotCalculate – не рассчитываемая ли услуга
- PacketId – пакет услуги
- Index – индекс услуги
- MinCostServicesComposition – массив состав услуг минимальной цены
- Key – ключ
- TemplateId – идентификатор шаблона
- PatternId – идентификатор вкладки
- SettingId – идентификатор услуги
- Value – значение
- ServiceType – тип услуги
- Code – ключ услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- PacketId – пакет услуги
- PartnerId – партнер услуги
- CountryId – страна услуги
- CityId – город услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
- AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
- AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
- SpecialKey – ключ акции
- SpecialName – название акции
- SpecialType – тип акции
- NewPrice – цена после применения акции
- OldPrice – цена до применения акции
- ShowOnline – нужно ли показывать акцию в поиске
- UntilDate – акция действует при совершении покупки до указанной даты
- Condition – json форма условия применения акции. Данное поле включает в себя следующие значения в зависимости от типа акции:
- NightsFrom (для типа PayStay) – ночей от
- NightsTo (для типа PayStay) – ночей до
- NightValue (для типа PayStay) – значение ночи, которое соответствует заданному периоду
- OperationType (для типа PayStay) – тип действия
- SpecialNightType (для типа PayStay) – тип бесплатной ночи
- DurationFrom (для типа KickBack) – ночей от
- DurationTo (для типа KickBack) – ночей до
- Value (для типа KickBack) – значение продолжительности, равное заданному периоду
- OperationType (для типа KickBack) – тип действия
- NightsFrom (для типа EarlyBird) – ночей от
- NightsTo (для типа EarlyBird) – ночей до
- Discount (для типа EarlyBird) – размер скидки
- OperationType (для типа EarlyBird) – тип действия
- COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
- SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
- SubCode1 – объект доп. описание 1
- SubCode2 – объект доп. описание 2
- Key – ключ
- 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 – флаг включен/выключен
- notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
- RouteSubVariants – подварианты услуг (используется в основном поиске)
- SecondaryFiltersResult – результаты доп. фильтров
- TourTypes – типы тура
- Id – ключ типа тура
- Name – название типа тура
- ParentId – родительский элемент типа тура (если есть)
- Type – тип справочника (используется для внутренних целей)
- TourPrograms – информация по каждой турпрограмме
- Key – ключ турпрограммы
- Name – название турпрограммы
- TourUrl – ссылка на тур
- BookingConditions – условия бронирования
- IsLandOnly – признак только наземное обслуживание
- IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
- IsHotelTemplates – есть ли вообще отели в данной турпрограмме
- IsRouteServices – есть ли маршрутные услуги
- MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
- Rate – валюта тура
- DateStart – нижняя граница дат заезда по программе тура
- DateEnd – верхняя граница дат заеда по программе тура
- Status – статус турпрограммы
- Key – ключ
- Value – значение
- Templates – шаблоны услуг
- $id – шаблон 1
- $id – шаблон 2
- Types – типы тура
- Id – ключ типа тура
- Name – название типа тура
- ParentId – родительский элемент типа тура (если есть)
- Type – тип справочника (используется для внутренних целей)
- LinkingFlightsRules – правила связывания перелетов
- notCombineDifferentAirlineRule –
- airlines –
- flightSettings –
- enabled –
- checkPlusMinus1CharterRule –
- FlightSettingPairs –
- enabled –
- notCombineDifferentTariffGroupRule –
- FlightSettings –
- enabled –
- notCombineDifferentPartnerRule –
- FlightSettings –
- enabled –
- departureCityEqualsArrivalCityRule –
- FlightSettingPairs –
- enabled –
- combineOnlySpecificChartersRule –
- settings –
- enabled –
- notCombineDifferentAirlineRule –
- XmlSettings – строка xml для актуальных фильтров
- Type – тип справочника (используется для внутренних целей)
- TourDurations – продолжительность тура
- TourDates – список дат заездов в турпрограмме
- HotelCities – город в дополнительных фильтрах
- ' –
- HotelResorts – курорты в дополнительных фильтрах
- ' –
- HotelCategories – категории отеля в дополнительных фильтрах
- ' –
- Hotels – отели в дополнительных фильтрах
- ' –
- Pansions – питания в дополнительных фильтрах
- ' –
- Airlines – авиакомпании в дополнительных фильтрах
- ' –
- FlightTariffs – класс перелета в дополнительных фильтрах
- ' –
- DepartureCities – города вылета в дополнительных фильтрах
- ' –
- DepartureAirports – аэропорты вылета в дополнительных фильтрах
- ' –
- ArrivalCities – города прибытия в дополнительных фильтрах
- ' –
- ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
- ' –
- HotelTypes – признаки отелей в дополнительных фильтрах
- ' –
- HotelCities – город в дополнительных фильтрах
- TourTypes – типы тура
Дополнительные методы
Выгрузка измененных турпрограмм (TourProgram) начиная с релиза 15.3
Метод производит выгрузку измененных турпрограмм.
- Формат запроса:
- GET .../TourSearchOwin/TourProgram?
- Принимаемые параметры GET запроса ( * – обязательный):
- fromDateTime – дата (в формате dd.MM.yyyy HH:mm:ss), начиная с которой будут выгружаться изменения
- Возвращаемый результат:
- Key – ключ программы туров
- Name – название программы туров
- UpdateDate – дата последнего изменения программы туров (или связанных с ней компонентов)
- routes – массив возможных маршрутов в данной программе туров
- departureCountryKey – страна начала поездки (для каждой страны начала поездки в одной программе тура будет отдельный маршрут)
- departureCityKey – город начала поездки (для каждого города начала поездки в одной программе тура будет отдельный маршрут)
- destinationCountryKeys – страны по туру (если в туре несколько услуг класса отель и они в разных странах, то будут возвращаться все страны отелей)
- destinationCityKeys – города по туру (если в туре отели в нескольких городах, то будут возвращаться все города отелей)
- tourTypeKeys – типы туров для данной программы туров
Проверка построения маршрутов турпрограммы (CheckTourProgram)
Метод производит построение маршрутов турпрограмм (вызывается из проверки тура).
- Формат запроса:
- GET .../TourSearchOwin/CheckTourProgram?
- Принимаемые параметры GET запроса ( * – обязательный):
- tourKey – ключ турпрограммы
- Возвращаемый результат:
- Message – сообщение Начинаем строить маршрут.
- Message – сообщение Маршрутов по данной программе тура построилось – количество
- Message – сообщение Построено каркасов маршрутов (без конкретных отелей) – количество
Проверка подключения к внешним системам (GDSCheckConnection)
Метод производит проверку подключения к внешней системе.
- Формат запроса:
- POST .../TourSearchOwin/GDSCheckConnection?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- adapterTypeName – адаптер
- id – ключ адаптера
- apiAddress – api-адрес
- settings – набор настроек (у каждого адаптера индивидуальный)
- Key – _Login
- Value – логин
- Key – _Password
- Value – пароль
- Key – _UserID
- Value – ID пользователя
- licenseDateExpiry – дата окончания лицензии
- Возвращаемый результат:
- Errors – описание ошибки
- Warnings – предупреждение
- States – статус
- IsValid – результат проверки подключения (true/false)
Приложения
Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)
Параметры ServiceType – это ключ типа услуги, Сode – ключ услуги, SubCode1 и SubCode2, возвращаемые при API-запросах – это параметры дополнительных описаний двух типов, индивидуальных для каждой услуги.
Ключ типа услуги (ServiceType) | Наименование типа услуги | Ключ услуги (Code) | Доп. описание 1 (SubCode1) | Таблица БД со значениями SubCode1 | Доп. описание 2 (SubCode2) | Таблица БД со значениями SubCode2 |
---|---|---|---|---|---|---|
1 | Авиаперелет | индивидуальный ключ услуги | Тариф | AirService | отсутствует | отсутствует |
2 | Трансфер | индивидуальный ключ услуги | Вид транспорта | Transport | отсутствует | отсутствует |
3 | Отель/Круиз | индивидуальный ключ услуги | Вид проживания (Тип номера + Категория номера + Тип размещения) | HotelRooms (Rooms + RoomCategory + Accmdmentype) | Тип питания | Pansion |
4 | Экскурсия | индивидуальный ключ услуги | Вид транспорта | Transport | отсутствует | отсутствует |
5 | Виза | индивидуальный ключ услуги | отсутствует | отсутствует | отсутствует | отсутствует |
6 | Страховка | индивидуальный ключ услуги | Доп. описание 1 | AddDescript1 | Доп. описание 2 | AddDescript2 |
8 | Доп услуга в отеле/круизе | индивидуальный ключ услуги | Вид проживания (Тип номера + Категория номера + Тип размещения) | HotelRooms (Rooms + RoomCategory + Accmdmentype) | Доп. описание 2 | AddDescript2 |
14 | Автобусный переезд | индивидуальный ключ услуги | Место посадки | BusTransferPoints | Вид транспорта | Transport |
99 | Любая пользовательская услуга | индивидуальный ключ услуги | Доп. описание 1 | AddDescript1 | Доп. описание 2 | AddDescript2 |