Мастер-Тур(15):API для разработки онлайн поиска и бронирования
Версия статьи от 5-03-2025.
Поддерживаемые версии ПК «Мастер-Тур»: |
Содержание
[убрать]- 1 Введение
- 2 Установка
- 3 Список методов
- 3.1 Авторизация (Token)
- 3.2 Выгрузка настроек службы поиска (Settings)
- 3.3 Выгрузка списка валют в онлайне (Currency)
- 3.4 Выгрузка курсов валют (CurrencyRates) начиная с 15.7
- 3.5 Выгрузка списка всех валют (getAllCurrencies)
- 3.6 Получение сконвертированных цен (convertFilterPrice)
- 3.7 Выгрузка квотируемых услуг системы (QuotedServices)
- 3.8 Выгрузка актуальных городов отправления (departureCities)
- 3.9 Выгрузка актуальных стран (Destination)
- 3.10 Выгрузка актуальных городов (ActualizeCities)
- 3.11 Выгрузка актуальных типов туров (ActualizeTourType)
- 3.12 Выгрузка актуальных дат заездов (TourDate)
- 3.13 Выгрузка актуальных продолжительностей (Duration)
- 3.14 Поиск туров (Tour)
- 3.15 Выгрузка транспортного плана (TransportPlan) до релиза 15.7 включительно
- 3.16 Выгрузка транспортного плана (TransportPlan) начиная с релиза 15.8
- 3.17 Получение дат заезда по турпрограмме
- 3.18 Получение плана транспортного средства (TransportPlan) по ключу турпрограммы и дате услуги
- 3.19 Выгрузка первоначального варианта в корзину для бронирования (Tour)
- 3.20 Выгрузка настройки отображения полей по туристам (TouristDataSettings)
- 3.21 Выгрузка услуг доплат к авиаперелетам (GetFlightsAdditionalServices)
- 3.22 Выгрузка услуг доплат к отелям (GetHotelsAdditionalServices)
- 3.23 Расчет индивидуальных услуг (CalculateIndividualServiceCosts)
- 3.24 Поиск рейсов из внешней системы (GetGDSFlights)
- 3.25 Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)
- 3.26 Получение семейств тарифов авиаперелетов из внешней системы (GetGDSFlightFareFamilies)
- 3.27 Загрузка филиалов (Branches) начиная с релиза 15.3
- 3.28 Загрузка ведущих менеджеров (Users) начиная с релиза 15.3
- 3.29 Расчет путевки (CalculateReservation)
- 3.30 Бронирование путевки (CreateReservation)
- 3.31 Бронирование путевки с упрощенными входными параметрами (CreateReservationExternalSystem)
- 3.32 Выгрузка информации о путевке (GetReservation)
- 3.33 Выгрузка информации о ценовых блоках (CostOfferDescriptions)
- 3.34 Получение капчи (GetCaptcha)
- 3.35 Проверка капчи (CheckCaptcha)
- 3.36 Проверка e-mail (CheckMail)
- 3.37 Проверка туриста (checkTourist)
- 3.38 Список значений параметра гражданства (Citizenships)
- 3.39 Выгрузка постоянного клиента (Client)
- 3.40 Выгрузка описаний ценовых блоков (CostOfferDescriptions)
- 3.41 Выгрузка описания по стране (CountryInfo)
- 3.42 Выгрузка картинки по отелю (HotelImages)
- 3.43 Выгрузка картинки по туру (TourImages)
- 3.44 Регистрация частного лица (PersonalRegistration)
- 3.45 Выгрузка плана рассадки (TransportPlan)
- 3.46 Выгрузка списка всех стран (Countries)
- 3.47 Выгрузка списка всех городов (Cities)
- 3.48 Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)
- 3.49 Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)
- 3.50 Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)
- 3.51 Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)
- 3.52 Поиск туров в оформлении клиентов (Search)
- 3.53 Поиск туров онлайн (TourForWeb)
- 3.54 Проверка дублирующих туристов (CheckDoubleDogovor)
- 4 Дополнительные методы
- 4.1 Выгрузка измененных турпрограмм (TourProgram) начиная с релиза 15.3
- 4.2 Проверка построения маршрутов турпрограммы (CheckTourProgram)
- 4.3 Получение разметки формы для новой формы быстрого поиска (GetJavascriptFile)
- 4.4 Проверка подключения к внешним системам (GDSCheckConnection)
- 4.5 Подтверждения оплаты полиса в ЕВРОИНС
- 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: "Кеш ещё инициализирован".
Выгрузка списка валют в онлайне (Currency)
Метод возвращает список используемых валют.
- Формат запроса:
- GET .../TourSearchOwin/Currency
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- Code – код валюты
- Name – наименование валюты
- IsMain – признак валюты «Главная»
- IsNational – признак валюты «Национальная»
- IsoCode – ISO код валюты
- IsShowInSearch – признак показывать ли валюту в поиске
- Symbol – символ валюты (обрабатывается с 15.7)
- Key – идентификатор валюты
Выгрузка курсов валют (CurrencyRates) начиная с 15.7
Полный аналог метода Выгрузка курсов валют (GetCurrencyRates)
Метод возвращает список курсов валют, актуальных на дату запроса. Курсы отображаются только для тех валют, которые отмечены в справочнике признаком Отображать в онлайне
- Формат запроса:
- GET .../TourSearchOwin/CurrencyRates
- Принимаемые параметры:
- dateFrom – начальная дата, от которой вывести список курсов валют, в формате DD.MM.YYYY, не обязательный параметр
- dateTo – конечная дата, до которой вывести список курсов валют, в формате DD.MM.YYYY, не обязательный параметр
- Возвращаемый результат:
- baseCurrencyId – идентификатор национальной валюты, либо произвольной валюты, указанной в настройке basketCurrency в конфигурационном файле (обрабатывается с релиза 15.6)
- currencyId – идентификатор валюты, курс которой приводится
- rate – курс валюты (отношение currencyId к baseCurrencyId)
- date – дата, на которую был зарегистрирован выводимый курс валюты
Выгрузка списка всех валют (getAllCurrencies)
Метод возвращает список всех валют.
- Формат запроса:
- GET .../TourSearchOwin/AllCurencies/getAllCurrencies
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- Code – код валюты
- Name – наименование валюты
- IsMain – признак валюты «Главная»
- IsNational – признак валюты «Национальная»
- IsoCode – ISO код валюты
- IsShowInSearch – признак показывать ли валюту в поиске
- Symbol – символ валюты (обрабатывается с 15.7)
- Key – идентификатор валюты
Получение сконвертированных цен (convertFilterPrice)
Метод возвращает сконвертированные цен для допфильтра Цена (используется в canary)
- Формат запроса:
- GET .../TourSearchOwin/AllCurencies/convertFilterPrice
- Принимаемые параметры ( * – обязательный):
- SourceRateKey * – ключ исходной валюты конвертации
- TargetRateKey * – ключ валюты, в которую будет произведена конвертация
- MinPrice * – значение минимальной цены, которое будет участвовать в конвертации
- MaxPrice * – значение максимальной цены, которое будет участвовать в конвертации
- Возвращаемый результат:
- m_Item1 – сконвертированная минимальная цена
- m_Item12 – сконвертированная максимальная цена
Выгрузка квотируемых услуг системы (QuotedServices)
Метод производит выгрузку услуг с признаком «Квотируемая»
- Формат запроса:
- GET .../TourSearchOwin/QuotedServices
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- Key – идентификатор услуги
- Code – код услуги
- Name – наименование услуги (русский)
- NameLat – наименование услуги (английский)
- IsDuration – наличие продолжительности у услуги
- IsCity – наличие города у услуги
- IsSubCode1 – признак наличия SubCode1 у услуги
- IsSubCode2 – признак наличия SubCode2 у услуги
- Quoted – признак квотируемости услуги
- CheckGeoPoint – наличие геоточек у услуги
- IsRoute – признак маршрутной услуги
- IsPartnerBasedOn – признак сопоставления партнера услуги в зависимости от отеля
- Control – идентификатор статуса услуги
Выгрузка актуальных городов отправления (departureCities)
Метод производит выгрузку всех доступных городов отправления для поискового запроса.
- Формат запроса:
- GET .../TourSearchOwin/departureCities?
- Принимаемые параметры:
- нет принимаемых параметров
- Возвращаемый результат:
- Key – идентификатор города
- Name – название города
Выгрузка актуальных стран (Destination)
Метод производит выгрузку всех доступных направлений туроператора.
- Формат запроса:
- GET .../TourSearchOwin/Destination?
- Принимаемые параметры ( * – обязательный):
- departureCities * – идентификатор города(ов) отправления (из контроллера .../TourSearchOwin/departureCities?)
- type – настройка easySearchFilter (0/не указано - настройка выключена, 1 - настройка включена)
- term – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Name – название страны
- Key – идентификатор страны
- DestinationType – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
- IsExist – не используется
- Data – массив данных для контекстного поиска
- CityKey – код города
- CityName – Название
- HotelKey – код отеля
- HotelName – название отеля
- ResortKey – код курорта
- ResortName – название курорта
Выгрузка актуальных городов (ActualizeCities)
Метод возвращает список всех доступных городов по определенному городу отправления и стране прибытия.
- Формат запроса:
- GET .../TourSearchOwin/ActualizeCities?
- Принимаемые параметры ( * – обязательный):
- cityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- term – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Key – идентификатор города
- Name – название города
Выгрузка актуальных типов туров (ActualizeTourType)
Метод возвращает список типов туров по определенному городу отправления, стране и городу прибытия.
- Формат запроса:
- GET .../TourSearchOwin/ActualizeTourType?
- Принимаемые параметры ( * – обязательный):
- departureCityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
- destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
- terms – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Key – идентификатор типа тура
- Name – название типа тура
- ParentId – идентификатор группы, к которой относится данный тип тура (если тип тура не относится к группе, то возвращается null)
Выгрузка актуальных дат заездов (TourDate)
Метод производит выгрузку доступных дат заездов для поискового запроса.
- Формат запроса:
- GET .../TourSearchOwin/TourDate?
- Принимаемые параметры ( * – обязательный):
- departureCity * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
- Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
- tourTypes * – идентификатор типа тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны
- Возвращаемый результат:
- массив дат
Выгрузка актуальных продолжительностей (Duration)
Метод производит выгрузку доступных продолжительностей для поискового запроса.
- Формат запроса:
- GET .../TourSearchOwin/Duration?
- Принимаемые параметры ( * – обязательный):
- departureCity * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- destinationCity * – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны
- Key * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- Type * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
- tourDate * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- tourTypes * – идентификатор типа(ов) тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны
- Возвращаемый результат:
- массив продолжительностей (в днях)
Поиск туров (Tour)
Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод возвращает наиболее дешевые предложения, найденные по предоставленным параметрам и сгруппированные по отелям в порядке возрастания цены.
- Формат запроса:
- GET .../TourSearchOwin/Tour?
- Принимаемые параметры ( * – обязательный):
- DepartureCityKeys * – идентификатор города(ов) отправления (полученный из метода .../TourSearchOwin/departureCities?)
- Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
- PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
- isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false)
- isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
- DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
- DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- AdultCount * – количество взрослых
- ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- CurrencyName * – код валюты
- AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- MinPrice * – минимальная цена (по умолчанию не задана, передается NaN)
- MaxPrice – максимальная цена (по умолчанию не передается)
- Groups – группировка результатов (2 – по названию тура, 4 – по дате тура, 8 – по продолжительности тура, 16 – по городу вылета, 32 – по отелю, 64 – по городу отеля, 128 – по курорту отеля, 256 – по категории отеля)
- HotelScheme – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля. Передаются следующие параметры:
- TemplateId – идентификатор шаблона услуги,
- DurationInNight – продолжительность отеля в ночах,
- Code – ключ отеля,
- PacketKey – ключ пакета,
- PartnerKey – ключ партнера
- GDSProviderId – ключ провайдера из внешней системы
- TotalTourDuration – общая продолжительность тура в днях
- BusTransferPointKeys – данный признак проставляется в true в том случае, когда происходит запрос вариантов проживания (кнопка Варианты) в автобусных переездах
- TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
- TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
- TourType – идентификатор типа(ов) тура (полученный из метода .../TourSearchOwin/ActualizeTourType?), по умолчанию передается -1, то есть все типы тура в рамках данной страны. Возможна множественная передача параметров.
- Tour – ключ программы тура (дополнительный фильтр)
- Duration – продолжительность тура (дополнительный фильтр)
- DateTour – дата тура (дополнительный фильтр)
- HotelResort – ключ курорта отеля (дополнительный фильтр)
- HotelCity – ключ города отеля (дополнительный фильтр)
- HotelType – ключ признака отеля (дополнительный фильтр)
- HotelStars – ключ категории отеля (дополнительный фильтр)
- Hotel – ключ отеля (дополнительный фильтр)
- Pansions – ключ питания (дополнительный фильтр)
- Airline – ключ авиакомпании (дополнительный фильтр)
- AirportDeparture – ключ аэропорта вылета (дополнительный фильтр)
- AirportArrival – ключ аэропорта прилета (дополнительный фильтр)
- CityIds – идентификатор города(ов) прибытия (полученный из метода .../TourSearchOwin/ActualizeCities?), по умолчанию передается -1, то есть все города в рамках данной страны. Возможна множественная передача параметров.
- TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
- TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
- TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
- TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
- ArrivalFlightNoTransfer – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
- DepartureFlightNoTransfer – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
- DepartureFlightNumberTransfer – наличие пересадок в прямом направлении (1 – одна пересадка, 2 – две пересадки и более, 3 – одна пересадка совместно с двумя пересадками и более). Обрабатывается начиная с релиза 15.3.
- ArrivalFlightNumberTransfer – наличие пересадок в обратном направлении (1 – одна пересадка, 2 – две пересадки и более, 3 – одна пересадка совместно с двумя пересадками и более). Обрабатывается начиная с релиза 15.3.
- Tariff – ключ класса авиаперелета (дополнительный фильтр)
- CombineAirlines — разрешить комбинировать авиаперелеты (дополнительный фильтр). Параметр применяется только при наличии параметра airline. Обрабатывается начиная с релиза 15.3.
- CombineTariffs — разрешить комбинировать классы перелета (дополнительный фильтр). Параметр применяется только при наличии параметра tariff. Обрабатывается начиная с релиза 15.3.
- FlightCityDeparture – ключ город вылета в параметрах авиаперелета (дополнительный фильтр)
- CityDeparture – ключ города начала поездки (дополнительный фильтр)
- RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
- GroupGuid – используется для получения турпрограмм по уникальному ключу из кэша при использовании группировки. Примеры использования. GroupGuid=00000000-0000-0000-0000-000000000000 – при первом запросе от локальной системы. GroupGuid=936DA01F-9ABD-4d9d-80C7-02AF85C822A8 (уникальный ключ) – передается на клиент от первого запроса из внешней системы. С данным уникальным ключом осуществляется второй запрос от внешней системы. Далее происходит получение значений по данному уникальному ключу. Обрабатывается начиная с релиза 15.4.
- IsGroupingTourAlreadyMerge – определяет слияние данных турпрограмм от локальной системы с данными от внешней системы при использовании группировки. Примеры использования. IsGroupingTourAlreadyMerge=false – полученные данные от локальной системы не объединены с данными от внешней системы. На клиенте осуществляется объединение данных турпрограмм с последующей сортировкой по минимальной цене. IsGroupingTourAlreadyMerge=true – полученные данные от локальной системы уже объединены с данными от внешней системы. На клиенте осуществляется только сортировка по минимальной цене. Обрабатывается начиная с релиза 15.4.
- SearchId – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.
- Возвращаемый результат:
- CheckMessages – сообщения для логики проверки тура (не используется)
- Message – сообщение об ошибке
- Key – код ошибки
- Value – сообщение об ошибке
- Result – результаты поиска
- Key – идентификатов программы тура
- Name – название программы тура
- TourUrl – ссылка на программу тура
- BookingConditions – условия бронирования программы туров
- StartDate – дата начала тура
- Duration – продолжительность тура (в днях)
- DurationInNight – продолжительность проживания (в ночах)
- Types – идентификатор типа туров
- Cost – цена тура
- Rate – код валюты тура
- CityDepature – город отправления
- Key – идентификатор города отправления
- Value – название города отправления
- CountryId – всегда возвращается ключ 0
- Services – услуги в туре
- DepartureCity – город отправления
- Key – идентификатор
- Value – название
- DepartureCountry – страна отправления
- Key – идентификатор
- Value – название
- ArrivalCity – город прибытия
- Key – идентификатор
- Value – название
- ArrivalCountry – страна прибытия
- Key – идентификатор
- Value – название
- DepartureAirport – аэропорт отправления
- Key – идентификатор
- Value – название
- ArrivalAirport – аэропорт прибытия
- Key – идентификатор
- Value – название
- Airline – авиакомпания
- Key – идентификатор
- Value – название
- Aircraft – воздушное судно
- Key – идентификатор
- Value – название
- Flight – рейс
- Key – идентификатор
- Value – название
- DepartureTime – время вылета
- ArrivalTime – время прилета
- EndDateTime – дата и время прилета
- FlightDetails – информация об авиаперелете
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – название тарифа
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – название
- 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 – объект страна
- Key – ключ страны
- Value – название страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – флаг услуга по расписанию или нет
- Details – объект детализация услуги
- SubCode1 – объект доп. описание 1
- Key – ключ доп. описания 1
- Value – название доп. описания 1
- SubCode2 – объект доп. описание 2
- Key – ключ доп. описания 2
- Value – название доп. описания 2
- Date – дата услуги
- IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
- Cost – цена
- QuotaStatus – объект информация по квотам
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – идентификатор партнера
- ByPax – признак цены за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- 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 –
- Type – тип справочника (используется для внутренних целей)
- TourDurations – продолжительность тура
- TourDates – список дат заездов в турпрограмме
- HotelCities – город в дополнительных фильтрах
- ' –
- HotelResorts – курорты в дополнительных фильтрах
- ' –
- HotelCategories – категории отеля в дополнительных фильтрах
- ' –
- Hotels – отели в дополнительных фильтрах
- ' –
- Pansions – питания в дополнительных фильтрах
- ' –
- Airlines – авиакомпании в дополнительных фильтрах
- ' –
- FlightTariffs – класс перелета в дополнительных фильтрах
- ' –
- DepartureCities – города вылета в дополнительных фильтрах
- ' –
- DepartureAirports – аэропорты вылета в дополнительных фильтрах
- ' –
- ArrivalCities – города прибытия в дополнительных фильтрах
- ' –
- ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
- ' –
- HotelTypes – признаки отелей в дополнительных фильтрах
- ' –
- HotelCities – город в дополнительных фильтрах
- TourTypes – типы тура
Выгрузка транспортного плана (TransportPlan) до релиза 15.7 включительно
Метод производит выгрузку транспортного плана.
- Формат запроса:
- GET .../TourSearchOwin/TransportPlan?
- Принимаемые параметры ( * – обязательный):
- code – код услуги
- dateBegin – дата услуги
- serviceType – тип услуги
- transportKey – ключ справочника транспорт
- Возвращаемый результат:
- TransportKey – ключ справочника транспорт
- Title – описание
- AreasCount – количество уровней
- RowsCount – количество рядов
- ColumnsCount – количество мест в ряду
- BusySeats – не используется
- Cells – массив описаний всех мест
- Row – ряд
- Column – место в ряду
- Area – уровень места
- Type – тип (None = 0, Seat = 1, Block = 4, Busy = 5)
- Name – название/номер
- UserSeats – не используется
- BlockSeat – не используется
Выгрузка транспортного плана (TransportPlan) начиная с релиза 15.8
Метод производит выгрузку транспортного плана.
- Формат запроса:
- GET .../TourSearchOwin/TransportPlan?
- Принимаемые параметры ( * – обязательный):
- code – код услуги
- dateBegin – дата услуги
- serviceType – тип услуги
- transportKey – ключ справочника транспорт
- Возвращаемый результат:
- VehiclePlans – массив параметров зон плана
- Key – ключ зоны
- TransportKey – ключ из справочника транспорт
- Row – количество рядов
- AreaNumber – номер уровня
- Name – название уровня
- PlanOrientation – ориентация плана (false - горизонтальная, true - вертикальная)
- Column – количество столбцов
- IsAirCraft – является ли планом самолета (false - нет, true - является)
- Type – не используется
- Seats – массив параметров посадочного места
- Key – ключ места
- SeatType – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
- Index – индекс места
- Number – название ячейки с местом
- Type – тип "место"
- VPKey – ключ зоны
- Border – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
- VehiclePlans – массив параметров зон плана
Получение дат заезда по турпрограмме
Работает начиная с релиза 15.8.
Метод возвращает даты заезда по ключу турпрограммы.
- Формат запроса:
- GET .../TourSearchOwin/TransportPlan?
- Принимаемые параметры ( * – обязательный):
- tourProgramKey * – ключ турпрограммы
- Возвращаемый результат:
- Массив дат заезда по туру
Получение плана транспортного средства (TransportPlan) по ключу турпрограммы и дате услуги
Работает начиная с релиза 15.8.
Метод возвращает даты заезда по ключу турпрограммы и дате услуги.
- Формат запроса:
- GET .../TourSearchOwin/TransportPlan?
- Принимаемые параметры ( * – обязательный):
- tourProgramKey * – ключ турпрограммы
- dateBegin * – дата услуги
- serviceType * – тип услуги
- Возвращаемый результат:
- plan – массив данных план
- VehiclePlans – массив параметров зон плана
- Key – ключ зоны
- TransportKey – ключ из справочника транспорт
- Row – количество рядов
- AreaNumber – номер уровня
- Name – название уровня
- PlanOrientation – ориентация плана (false - горизонтальная, true - вертикальная)
- Column – количество столбцов
- IsAirCraft – является ли планом самолета (false - нет, true - является)
- Dates – не используется
- Type – не используется
- Seats – массив параметров посадочного места
- Key – ключ места
- SeatType – тип места (None = 0, Seat = 1, Pass/comment = 2, Block = 4, Busy = 5)
- Index – индекс места
- Number – название ячейки с местом
- Type – тип "место"
- VPKey – ключ зоны
- Border – обводка границы (комбинация цифр, где 0 - нет обводки, 1 - обводка в 1 px, 2 - обводка в 2 px)
- VehiclePlans – массив параметров зон плана
- routeCity – направление автобусного переезда
Выгрузка первоначального варианта в корзину для бронирования (Tour)
Метод поиска, который возвращает варианты только по данной турпрограмме и схеме отеля.
- Формат запроса:
- GET .../TourSearchOwin/Tour?
- Принимаемые параметры ( * – обязательный):
- DepartureCityKeys * – идентификатор города отправления (полученный из метода .../TourSearchOwin/departureCities?)
- DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
- DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- AdultCount * – количество взрослых
- ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- CurrencyName * – код валюты
- HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelScheme * – объект схемы отеля
- TemplateId – идентификатор шаблона услуги
- DurationInNight – продолжительность отеля в ночах
- Code – ключ отеля
- PacketKey – ключ пакета
- PartnerKey – ключ партнера
- GDSProviderId – ключ провайдера из внешней системы
- TotalTourDuration – общая продолжительность тура в днях, обрабатывается начиная с релиза 15.6, обязательный параметр. Изменения связаны с возможностью работы поиска в ночах проживания в отеле, для перехода в корзину необходимо знать общую продолжительность тура. Взять значение для параметра TotalTourDuration для HotelScheme можно из свойства Duration, пришедшего для данной цены в ответе метода поиск туров (Tour)
- PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
- PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
- isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false).
- isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
- TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
- TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
- RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
- Возвращаемый результат:
- CheckMessages – сообщения для логики проверки тура (не используется)
- Message – сообщение об ошибке
- Key – код ошибки
- Value – сообщение об ошибке
- Result – результаты поиска
- Key – идентификатор программы тура
- Name – название программы тура
- TourUrl – ссылка на программу тура
- BookingConditions – условия бронирования программы туров
- StartDate – дата начала тура
- Duration – продолжительность тура (в днях)
- DurationInNight – продолжительность проживания (в ночах)
- Types – идентификатор типа туров
- Cost – цена тура
- Rate – код валюты тура
- CityDepature – город отправления
- Key – идентификатор города отправления
- Value – название города отправления
- CountryId – всегда возвращается ключ 0
- Services – услуги в туре
- DepartureCity – город отправления
- Key – идентификатор
- Value – название
- DepartureCountry – страна отправления
- Key – идентификатор
- Value – название
- ArrivalCity – город прибытия
- Key – идентификатор
- Value – название
- ArrivalCountry – страна прибытия
- Key – идентификатор
- Value – название
- DepartureAirport – аэропорт отправления
- Key – идентификатор
- Value – название
- ArrivalAirport – аэропорт прибытия
- Key – идентификатор
- Value – название
- Airline – авиакомпания
- Key – идентификатор
- Value – название
- Aircraft – воздушное судно
- Key – идентификатор
- Value – название
- Flight – рейс
- Key – идентификатор
- Value – название
- DepartureTime – время вылета
- ArrivalTime – время прилета
- EndDateTime – дата и время прилета
- FlightDetails – информация об авиаперелете
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – название тарифа
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – название
- 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 – объект страна
- Key – ключ страны
- Value – название страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – флаг услуга по расписанию или нет
- Details – объект детализация услуги
- SubCode1 – объект доп. описание 1
- Key – ключ доп. описания 1
- Value – название доп. описания 1
- SubCode2 – объект доп. описание 2
- Key – ключ доп. описания 2
- Value – название доп. описания 2
- Date – дата услуги
- IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
- Cost – цена
- QuotaStatus – объект информация по квотам
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – идентификатор партнера
- ByPax – признак цены за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- 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 – объект фамилия туриста (лат)
- Index – порядковый индекс элемента
- Code – код поля
- ApiCode – имя поля, которое будет использоваться при бронировании (например при вызове метода CreateReservation)
- HeaderText – название поля
- IsEdit – признак редактируемости поля
- IsRequired – признак обязательности заполнения поля
- IsVisible – видимость поля (видимое)
- IsDisabled – служебный внутренний параметр. При работе с API не используется
- Translit – настройки транслитерации (0 – нет, 1 – транслитерация, 2 – латиница)
- LetterCase – настройки регистра (0 – по умолчанию, 1 – с заглавной, 2 – большие, 3 – маленькие)
- patronymic – объект отчество туриста (лат)
- sex – объект пол туриста
- firstname – объект имя туриста (лат)
- passportbywhom – объект кем выдан заграничный паспорт
- birthplace – объект место рождения
- birthdate – объект дата рождения
- patronymicrus – объект отчество (рус)
- lastnamerus – объект фамилия туриста (рус)
- citizenid – объект ID туриста
- passport – объект серия и номер заграничного паспорта
- passportrus – объект серия и номер национального паспорт а
- ismain – объект признак главного туриста
- passportdate – объект дата выдачи заграничного паспорта
- firstnamerus – объект имя туриста (рус)
- passportbywhomrus – объект кем выдан национальный паспорт
- citizenship – объект гражданство
- passportdaterus – объект дата выдачи национального паспорта
- phone – объект телефон
- number – объект порядковый номер
- passportdateend – объект дата окончания заграничного паспорта
- email – объект e-mail туриста
- 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 – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- 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 – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
- PassportDateOfIssueString – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- Возвращаемый результат:
- Массив – массив объектов доплат к авиаперелетам
- ServiceName – название услуги
- City – объект город
- Country – объект страна
- Key – ключ страны
- Value – название страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – признак по расписанию
- Details - объект детализация
- SubCode1 – объект доп. описание 1
- Key – ключ
- Value – название
- SubCode2 – объект доп. описание 2
- Key – ключ
- Value – название
- Date – дата услуги
- IsShowTransportPlan – признак показать транспортный план (для автобусов)
- Cost – цена
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – признак за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- 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 – дата и время начала услуги (YYYY-MM-DDThh:mm:ss)
- EndDateTimeString – дата и время окончания услуги (YYYY-MM-DDThh:mm:ss)
- TemplateId – шаблон услуги
- Cost – цена услуги
- ByPax – цена за человека
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index – индекс услуги
- IsRoute – признак маршрутная услуга
- ServiceTemplateIndex – индекс шаблона услуги
- RemoteId – (в доплатах не используется)
- TouristNumbersList – массив туристов, привязанных к услуге
- Service – объект услуга отель
- Tourists – массив туристов
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
- PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- Возвращаемый результат:
- Массив – массив объектов связок Возраст-Отель-Доп. услуги
- Age – возраст туриста
- Hotel – объект отель
- ServiceType – тип услуги
- Code – код услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- PacketId – ключ пакета
- PartnerId – ключ партнера
- Day – день предоставления услуги
- BeginTime – время начала услуги
- EndTime – время окончания услуги
- DurationInNight – продолжительность услуги в ночах
- Attributes – маска атрибутов услуги
- CountryId – ключ страны услуги
- CityId – ключ города
- Type – тип услуги в путевке
- ShowOrder – порядок при печати (сортировка) по услуге
- ShowOrderAddDescript1 – порядок при печати (сортировка) по доп. описанию 1
- ShowOrderAddDescript2 – порядок при печати (сортировка) по доп. описанию 2
- IsCommission – признак, комиссионная ли услуга
- BaseFlightsParams – параметр не обрабатывается
- AdditionalServices – массив доплат
- ServiceName – название услуги
- City – объект город
- Country – ключ страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – признак по расписанию
- Details - объект детализация
- SubCode1 – объект доп. описание 1
- Key – ключ
- Value – название
- SubCode2 – объект доп. описание 2
- Key – ключ
- Value – название
- Date – дата услуги
- IsShowTransportPlan – признак показать транспортный план (для автобусов)
- Cost – цена
- QuotaStatus – объект статус квотирования
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – признак за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- 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 запроса ( * – обязательный):
Внимание! Если в туре используется перелет из GDS, то в параметр flightSettings передается ответ из секции flightGDSRequest метода API ActualizeTour. Далее для получения цены выполняем методы RebuidFlights и CalculateReservation.
- flightSettings – информация о шаблоне услуги авиаперелета
- templateId – идентификатор шаблона услуги
- patternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- serviceId – идентификатор класса услуги (внутренняя информация из программы туров)
- service – информация об услуге авиаперелета
- ServiceType – тип услуги
- Code – ключ услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- CountryId – страна услуги
- CityId – город услуги
- PacketId – пакет услуги
- PartnerId – партнер услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- price – стоимость перелета
- quotaInfo – объект информация по квотам
- status – статус по квотам (есть места / нет мест / под запрос)
- freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- flightDateTimeLimitationInterval –
- startLimitation – начало тайм-лимита
- finishLimitation – объект тайм-лимита
- dateTimeString – дата окончания тайм-лимита
- serviceType – тип услуги
- serviceCode – код услуги
- flightSourceMode – тип перелета (1 – локальный, 2 – из внешний системы)
- passengers – информация о пассажирах
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
- PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- tourDate – дата тура
- tourCurrency – валюта тура
- tourId – ключ программы тура
- filterTariff – информация о тарифах
- filterDeptime – информация о времени вылета
- isCommission – признак комиссионной цены
- baseFlightsParams – параметра авиаперелета
- CityArrival – город прибытия
- FlightCode – код авиаперелета
- TariffKey – ключ тарифа
- PartnerId – ключ партнера
- isUpdated – информация об обновлении перелета
- key – ключ запроса
- tourDurationByDays – продолжительность перелета
- langueCode – локализация
- 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 – информация о валидации
Выгрузка информации от внешнего поставщика по перелету (RebuildFlights)
Внимание! Если в туре используется перелет из GDS, то перед этим методом вызывается GetGDSFlights в принимаемые параметры которого передается ответ из секции flightGDSRequest метода API ActualizeTour. Далее текущий метод RebuidFlights и далее CalculateReservation.
Метод возвращает информацию по выбранному перелету от внешнего поставщика.
- Формат запроса:
- POST .../TourSearchOwin/RebuildFlights
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- flights – перелеты
- direction –
- commonPrice – общая стоимость перелета
- remotePriceSource – данные расчета локального перелета
- providerId – ID внешнего поставщика
- flightId – идентификатор внешнего перелета
- localPriceSource – данные расчета локального перелета
- packetId – ключ пакета
- partnerId – идентификатор партнера
- flightsSequenceSettings – описание параметров последовательности перелетов для которых действуют замены
- templateId – идентификатор шаблона услуги
- patternId – идентификатор паттерна услуги
- serviceId – идентификатор класса услуги
- segments – сегменты авиаперелета
- segmentNumber – номер сегмента
- depratureCity – город отправления
- gdsItem – справочная информация внешней системы
- serviceId – идентификатор системы
- languageId – идентификатор языка
- id – идентификатор в системе внешнего поставщика
- code – код в системе внешнего поставщика
- name – имя в системе внешнего поставщика
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- dictionaryId – идентификатор справочника
- itemId –
- columnValues – наименование города и страны
- mtItem – справочная информации локальной системы
- id – идентификатор в локальной системе
- code – код в локальной системе
- name – имя в локальной системе
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- dictionaryId – идентификатор справочника
- itemId –
- columnValues – наименование страны и города
- mapping – связка
- id – Id маппинга
- providerId – Id провайдера
- dictionaryId – Id справочника
- providerDictionaryItemId – Id справочника внешнего поставщика
- providerDictionaryItemName – обозначение справочника внешнего поставщика
- mtDictionaryItemId – Id справочника МТ
- mtDictionaryItemName – обозначение справочника MT
- gdsItem – справочная информация внешней системы
- arrivalCity – город прибытия
- gdsItem – справочная информация внешней системы
- serviceId – идентификатор системы
- languageId – идентификатор языка
- id – идентификатор в системе внешнего поставщика
- code – код в системе внешнего поставщика
- name – имя в системе внешнего поставщика
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- dictionaryId – идентификатор справочника
- itemId –
- columnValues – наименование города и страны
- mtItem – справочная информации локальной системы
- id – идентификатор в локальной системе
- code – код в локальной системе
- name – имя в локальной системе
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- dictionaryId – идентификатор справочника
- itemId –
- columnValues – наименование страны и города
- mapping – связка
- id – Id маппинга
- providerId – Id провайдера
- dictionaryId – Id справочника
- providerDictionaryItemId – Id справочника внешнего поставщика
- providerDictionaryItemName – обозначение справочника внешнего поставщика
- mtDictionaryItemId – Id справочника МТ
- mtDictionaryItemName – обозначение справочника MT
- gdsItem – справочная информация внешней системы
- departureAirport – аэропорт вылета
- arrivalAirport – аэропорт прилета
- gdsItem –справочная информация внешней системы
- serviceId – идентификатор системы
- languageId – идентификатор языка
- id – идентификатор аэропорта вылета
- code – код аэропорта вылета
- name – наименование аэропорта
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- dictionaryId – идентификатор справочника
- itemId –
- columnValues – наименование аэропорта города страны
- mtItem – справочная информации из локальной системы
- id – идентификатор аэропорта в локальной системе
- code – код аэропорта в локальной системе
- name – имя аэропорта в локальной системе
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- dictionaryId – идентификатор справочника
- itemId –
- columnValues – наименование страны и города
- mapping – связка
- id – Id маппинга аэропорта
- providerId – Id провайдера аэропорта
- dictionaryId – Id справочника аэропорта
- providerDictionaryItemId – Id справочника аэропорта внешнего поставщика
- providerDictionaryItemName – обозначение справочника аэропорта внешнего поставщика
- mtDictionaryItemId – Id справочника аэропорта МТ
- mtDictionaryItemName – обозначение справочника аэропорта MT
- gdsItem –справочная информация внешней системы
- airline – авиакомпания
- gdsItem – справочная информация внешней системы
- serviceId – идентификатор авиакомпании внешней системы
- languageId – идентификатор языка
- id – идентификатор авиакомпании
- code – код авиакомпании
- name – наименование авиакомпании
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- columnValues – наименование авиакомпании
- mtItem – справочная информация из локальной системы
- id – идентификатор авиакомпании в локальной системе
- code – код авиакомпании в локальной системе
- name – наименование авиакомпании в локальной системе
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- columnValues – наименование авиакомпании
- mapping – связка
- id – Id маппинга авиакомпании
- providerId – Id провайдера авиакомпании
- dictionaryId – Id справочника авиакомпании
- providerDictionaryItemId – Id справочника авиакомпании внешнего поставщика
- providerDictionaryItemName – обозначение справочника авиакомпании внешнего поставщика
- mtDictionaryItemId – Id справочника авиакомпании МТ
- mtDictionaryItemName – обозначение справочника авиакомпании MT
- gdsItem – справочная информация внешней системы
- aircraft – воздушное судно
- gdsItem – справочная информация внешней системы
- serviceId – идентификатор воздушного судна внешней системы
- languageId – идентификатор языка
- id – идентификатор воздушного судна
- code – код воздушного судна
- name – наименование воздушного судна
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- columnValues – наименование воздушного судна
- mtItem – справочная информация из локальной системы
- id – идентификатор воздушного судна в локальной системе
- code – код воздушного судна в локальной системе
- name – наименование воздушного судна в локальной системе
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- columnValues – наименование воздушного судна
- mapping – связка
- id – Id маппинга воздушного судна
- providerId – Id провайдера воздушного судна
- dictionaryId – Id справочника воздушного судна
- providerDictionaryItemId – Id справочника воздушного судна внешнего поставщика
- providerDictionaryItemName – обозначение справочника воздушного судна внешнего поставщика
- mtDictionaryItemId – Id справочника воздушного судна МТ
- mtDictionaryItemName – обозначение справочника воздушного судна MT
- gdsItem – справочная информация внешней системы
- tariff – тариф
- gdsItem – справочная информация внешней системы
- id – идентификатор тарифа
- code – код тарифа
- name – наименование тарифа
- automaticallyMappingValue – выражение используемое для автоматического маппинга
- requestValue – значение поля справочника которое используется в запросе к внешнему поставщику
- displayedValue – значение поля справочника который используется для отображения
- dependencies – список зависимых сущностей
- columnValues – наименование тарифа
- mtItem – справочная информация из локальной системы
- mapping – связка
- gdsItem – справочная информация внешней системы
- flightNumber – номер перелета
- baggageRestriction – ограничение провоза багажа
- caryyOncarry – ограничение ручной клади
- departureDate – дата вылета
- arrivalDate – дата прилета
- quotaInfo – объект информация по квотам
- status – статус по квотам (есть места / нет мест / под запрос)
- freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- tourDate – дата тура
- flights – перелеты
- Возвращаемый результат:
- flights – информация о рейсах
- remoteFlightId – идентификатор внешнего перелета
- flightsSettings – внутренняя информация о перелете
- templateId – идентификатор шаблона услуги
- patternId – идентификатор паттерна услуги
- serviceId – идентификатор класса услуги
- flightsPlains – планы полетов
- DepartureCity – город вылета
- Key – ключ города
- Value – наименование города
- DepartureCountry – страна вылета
- Key – ключ страны
- Value – наименование страны
- ArrivalCity – город прибытия
- Key – ключ города
- Value – наименование города
- ArrivalCountry – страна прибытия
- Key – ключ страны
- Value – наименование страны
- DepartureAirport – аэропорт вылета
- Key – ключ аэропорта
- Value – наименование аэропорта
- ArrivalAirport – аэропорт прилета
- Key – ключ аэропорта
- Value – наименование аэропорта
- Airline – авиакомпания
- Id – идентификатор авиакомпании
- "Value – наименование авиакомпании
- "Key – ключ авиакомпании
- Aircraft – воздушное судно
- Key – ключ воздушного судна
- Value – наименование воздушного судна
- Flight – рейс
- Key – ключ рейса
- Value – наименование рейса
- DepartureTime – время отправления
- ArrivalTime – время прибытия
- TotalTimeOfFlight – полное время перелета
- FlightDetails – детали авиаперелета
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – наименование тарифа
- IsCommission – признак, комиссионная ли услуга
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – наименование
- Tariff – информация о тарифе перелета
- FlightSetting – информация о шаблоне услуги авиаперелета
- ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
- PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- FlightId – идентификатор внешнего перелета
- FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
- Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
- SvKey – ключ типа услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- EndDateTime – дата окончания услуги
- IsHooded – признак скрытая услуга
- IsDeleted – признак удаляемая услуга
- IsNotCalculate – признак не рассчитываемая услуга
- PacketId – ключ пакета
- Index – порядковый номер услуги
- DepartureCity – город вылета
- flights – информация о рейсах
Получение семейств тарифов авиаперелетов из внешней системы (GetGDSFlightFareFamilies)
Метод получает семейства тарифов для авиаперелетов из внешней системы.
- Формат запроса:
- POST .../TourSearchOwin/GetGDSFlightFareFamilies?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- flightId – ID внешнего перелета
- providerId – ID внешнего провайдера
- languageCode – код локализации
- passengers – информация о пассажирах
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
- PassportDateOfIssueString – дата выдачи паспорта в строке (DD.MM.YYYY)
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- currency – валюта
- price – стоимость
- param – параметры перелета
- flightsSource – параметры перелета
- flightSettings – информация о шаблоне услуги авиаперелета
- templateId – идентификатор шаблона услуги
- patternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- serviceId – идентификатор класса услуги (внутренняя информация из программы туров)
- service – информация об услуге авиаперелета
- ServiceType – тип услуги
- Code – ключ услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- CountryId – страна услуги
- CityId – город услуги
- PacketId – пакет услуги
- PartnerId – партнер услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- price – стоимость перелета
- quotaInfo – объект информация по квотам
- status – статус по квотам (есть места / нет мест / под запрос)
- freePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- isFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- flightDateTimeLimitationInterval –
- startLimitation – начало тайм-лимита
- finishLimitation – объект тайм-лимита
- dateTimeString – дата окончания тайм-лимита
- serviceType – тип услуги
- serviceCode – код услуги
- flightSourceMode – тип перелета (1 – локальный, 2 – из внешний системы)
- flightSettings – информация о шаблоне услуги авиаперелета
- passengers – информация о пассажирах
- IsMain – главный турист
- Number – порядковый номер туриста
- AgeType – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex – пол (0 – мужской, 1 – женский)
- FirstName – имя (лат)
- LastName – фамилия (лат)
- Patronymic – отчество (лат)
- FirstNameRus – имя (рус)
- LastNameRus – фамилия (рус)
- PatronymicRus – отчество (рус)
- InternationalPassportSeries – серия загранпаспорта
- InternationalPassportNumber – номер загранпаспорта
- InternationalPassportDateOfIssue – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfIssueString – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
- InternationalPassportDateOfExpiry – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfExpiryString – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
- internationalPassportByWhom – кем выдан загранпаспорт
- PassportSeries – серия паспорта
- PassportNumber – номер паспорта
- PassportDateOfIssue – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
- PassportDateOfIssueString – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
- PassportByWhom – кем выдан паспорт
- Citizenship – название страны
- Phone – телефон
- Email – e-mail
- BirthDay – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace – место рождения
- CitizenID – гражданство
- Age – количество полных лет на момент окончания тура
- tourDate – дата тура
- tourCurrency – валюта тура
- tourId – ключ программы тура
- filterTariff – информация о тарифах
- filterDeptime – информация о времени вылета
- isCommission – признак комиссионной цены
- baseFlightsParams – параметра авиаперелета
- CityArrival – город прибытия
- FlightCode – код авиаперелета
- TariffKey – ключ тарифа
- PartnerId – ключ партнера
- isUpdated – информация об обновлении перелета
- key – ключ запроса
- tourDurationByDays – продолжительность перелета
- langueCode – локализация
- 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 * – битовая маска атрибутов услуг (Значение по умолчанию 0. Дальше в зависимости от признака услуги, может принимать значениz:
- Service * – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
None = 0,если услуга удаляемая, эта настройка находится в программе туров,
Delete = 1,
CodeEdit = 2,
SubCode1Edit = 4,
CityEdit = 8,
PartnerEdit = 16,
BadCheck = 32,
Invisible = 64, отображаемая
DurationEdit = 128,
FullEdit = Delete | CodeEdit | SubCode1Edit | SubCode2Edit | CityEdit | PartnerEdit | DurationEdit,
Host = 256,
HostChangeCode2 = Host | 512,
HostChangeCode1 = Host | 1024,
HostChangeCode = Host | 2048,
HostChangePartner = Host | 4096,
HostChangePacket = Host | 8192,
Depended = 16384,
DependedCode2 = Depended | 512,
DependedCode1 = Depended | 1024,
DependedCode = Depended | 2048,
DependedCity = Depended | 4096,
DependedCountry = Depended | 8192,
FullDepended = Depended | DependedCode2 | DependedCode1 | DependedCode | DependedCity | DependedCountry,
NotCalculate = 32768,не рассчитываемая,
SubCode2Edit = 65536,
GDSService = 131072, от внешней системы)
- *IsRemovable – (не обрабатывается)
- *Type – тип услуги в путевке. Может принимать значения:
None (0) – не установлено,
Base (1) – базовая услуга. Основные услуги в корзине, проживание, перелет.
Optional (2) – Дополнительная услуга,
NYDinner (4) – Новогодний ужин,
FlightAdditionalPayment (8) – Доплата на перелет,
TourWebDifference (16) – Разница в СПО,
AddedByCalculator (32) – Добавленная при рассчете путевки,
AddedByReservationBuilder (64) – добавленная услуга при формировании состава путевки,
BaseChanged (128) – базовая измененная услуга,
HotelAdditionalPayment (256) – доплата на отель
- IsHooded * – признак скрытая услуга
- IsNotCalculated * – признак не рассчитываемая услуга
- BeginDateTimeString * – дата и время начала услуги
- EndDateTimeString * – дата и время окончания услуги
- TemplateId * – порядок расположения шаблона услуги в внутри самой услуги в программе тура
- Cost * – цена услуги
- ByPax * – цена за человека
- QuotaStatus * – объект статус квотирования
- PlacesStatus * – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index * – индекс услуги
- IsRoute * – признак маршрутная услуга (Перелет, автобусный переезд, жд переезд, трансфер, экскурсия)
- ServiceTemplateIndex * – индекс шаблона услуги (Порядок расположения услуги в программе тура. Не отображается в программе туров,это просто порядковый номер услуги в путевке)
- RemoteId * – информация об услуге во внешней системе
- IsCommission * – признак, комиссионная ли услуга
- BaseFlightsParams * – параметры рассчитанных авиаперелетов Обязательный параметр, если в путевке есть услуга авиаперелета
- CityArrival * – ключ города прибытия прямого перелета
- FlightCode * – ключ прямого авиаперелета
- TariffKey * – ключ тарифа прямого авиаперелета
- PartnerId * – ключ партнера прямого авиаперелета
- CityArrival * – ключ города прибытия обратного перелета
- FlightCode * – ключ обратного авиаперелета
- TariffKey * – ключ тарифа обратного авиаперелета
- PartnerId * – ключ партнера обратного авиаперелета
- TouristNumbersList * – массив туристов, привязанных к услуге
- Tourists * – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу TouristDataSettings по определенной стране. В каждом объекте есть поле IsRequired, которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
- IsMain * – главный турист
- Number * – порядковый номер туриста
- AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex * – пол (0 – мужской, 1 – женский)
- FirstName * – имя (лат)
- LastName * – фамилия (лат)
- Patronymic * – отчество (лат)
- FirstNameRus * – имя (рус)
- LastNameRus * – фамилия (рус)
- PatronymicRus * – отчество (рус)
- InternationalPassportSeries * – серия загранпаспорта
- InternationalPassportNumber * – номер загранпаспорта
- InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строке (DD.MM.YYYY)
- InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строке (DD.MM.YYYY)
- internationalPassportByWhom * – кем выдан загранпаспорт
- PassportSeries * – серия паспорта
- PassportNumber * – номер паспорта
- PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
- PassportDateOfIssueString * – дата выдачи паспорта строковом формате (DD.MM.YYYY)
- PassportByWhom * – кем выдан паспорт
- Citizenship * – название страны
- Phone * – телефон
- Email * – e-mail
- BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace * – место рождения
- CitizenID * – гражданство
- Age * – количество полных лет на момент окончания тура
- Day * – день (перевод) Может быть с пустым значением
- Day2 * – дня (перевод) Может быть с пустым значением
- Days * – дней (перевод) Может быть с пустым значением
- Night * – ночь (перевод) Может быть с пустым значением
- Night2 * – ночи (перевод) Может быть с пустым значением
- Nights * – ночей (перевод) Может быть с пустым значением
- adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги (перевод) Может быть с пустым значением
- at * – на (перевод) Может быть с пустым значением
- incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) Может быть с пустым значением
- Возвращаемый результат:
- IsValid – признак валидности путевки
- ErrorMessage – сообщение об ошибке, если есть
- CalculatedReservation – объект рассчитанной путевки
- TourKey – ключ тура
- BeginDate – дата начала тура
- Duration – продолжительность путевки в днях
- Currency – код валюты тура
- CalculatedServicesPrice – сумма обязательных услуг, входящих в состав тура
- ChangedPrice – сумма, на которую изменилась итоговая стоимость TotalPrice в результате добавления обязательных и дополнительных услуг
- Price – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в валюте тура)
- TotalPrice – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в валюте тура)
- IsDiscountIsPercent – признак, в процентах ли дается партнерская комиссия или в y.e.
- NationalChangedPrice – сумма, на которую изменилась итоговая стоимость TotalPrice в результате добавления обязательных и дополнительных услуг (в национальной валюте)
- NationalTotalDiscount – партнерская комиссия агентству (в национальной валюте)
- NationalTotalPrice – итоговая стоимость тура для туриста, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг (в национальной валюте)
- NatinoalCalculatedServicesPrice – сумма обязательных услуг, входящих в состав тура (в национальной валюте)
- NationalPrice – итоговая стоимость тура для агентства, рассчитывается как стоимость обязательных услуг, входящих в состав тура + стоимость обязательных услуг, не входящих в состав тура + стоимость дополнительных услуг - партнерская комиссия (в национальной валюте)
- Discount – партнерская комиссия агентству (в процентах или y.e.)
- TotalDiscount – партнерская комиссия агентству (в валюте тура)
- ServiceTourists – массив услуг, входящих в тур
- ServiceType – тип услуги
- Day – день предоставления
- DurationInNight – продолжительность в ночах
- Time – время начала услуги
- Name – полное описание услуги
- TouristCount – количество туристов на услуге
- Attributes – битовая маска атрибутов
- Type – тип услуги (основная/дополнительная)
- Brutto – цена брутто
- NationalBrutto – цена брутто в национальной валюте
- TotalBrutto – итоговое брутто
- TourName – название тура
- BookingConditions – разметка условия бронирования
- EndDate – дата окончания тура
- DurationInNights – продолжительность тура в ночах
- NationalCurrency – код национальной валюты
Бронирование путевки (CreateReservation)
Метод производит бронирование путевки.
При бронировании проверяется корректность заполнения обязательных полей туристов (регулируется общими настройками, либо в справочнике Страны). В случае, если обязательные поля не заполнены, возвращается ошибка с сообщением, бронь не создается.
- Формат запроса:
- PUT .../TourSearchOwin/CreateReservation/1?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
- Принимаемые параметры PUT запроса:
- TourProgramId * – ключ турпрограммы
- BeginDate * – дата начала тура (YYYY-MM-DDThh:mm:ss)
- Duration * – продолжительность тура
- Currency * – код валюты
- Services * – массив услуг
- Service * – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
- ServiceType * – тип услуги (поле sv_key из таблицы service)
- Code * – код услуги
- SubCode1 * – доп. описание 1 услуги
- SubCode2 * – доп. описание 2 услуги
- Packet * – ключ пакета услуги
- Partner * – ключ партнера услуги
- Day * – день предоставления услуги
- DurationInNight * – продолжительность услуги в ночах
- City * – ключ города
- Country * – страна услуги
- Attributes * – битовая маска атрибутов услуг
- IsRemovable * – (не обрабатывается)
- Type * – тип услуги в путевке (базовая дополнительная)
- IsHooded * – признак скрытая услуга
- IsNotCalculated * – признак не рассчитываемая услуга
- BeginDateTimeString * – дата и время начала услуги
- EndDateTimeString * – дата и время окончания услуги
- TemplateId * – шаблон услуги
- Cost * – цена услуги
- ByPax * – цена за человека
- QuotaStatus * – объект статус квотирования
- PlacesStatus * – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index * – индекс услуги
- IsRoute * – признак маршрутная услуга
- ServiceTemplateIndex * – индекс шаблона услуги
- RemoteId * – информация об услуге во внешний системе
- IsCommission * – признак, комиссионная ли услуга
- BaseFlightsParams * – параметры рассчитанных авиаперелетов Обязательный параметр, если в путевке есть услуга авиаперелета
- CityArrival * – ключ города прибытия прямого перелета
- FlightCode * – ключ прямого авиаперелета
- TariffKey * – ключ тарифа прямого авиаперелета
- PartnerId * – ключ партнера прямого авиаперелета
- CityArrival * – ключ города прибытия обратного перелета
- FlightCode * – ключ обратного авиаперелета
- TariffKey * – ключ тарифа обратного авиаперелета
- PartnerId * – ключ партнера обратного авиаперелета
- TouristNumbersList * – массив туристов, привязанных к услуге
- Service * – объект услуги (отель/круиз, авиаперелет, трансфер или др.)
- Tourists * – массив туристов. Для того, чтобы узнать, какие поля обязательные для туриста, мы можем обратиться к методу TouristDataSettings по определенной стране. В каждом объекте есть поле IsRequired, которое отвечает за то, будет ли оно обязательным для заполнения или его можно оставить с пустым значением.
- IsMain * – главный турист
- Number * – порядковый номер туриста
- AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex * – пол (0 – мужской, 1 – женский)
- FirstName * – имя (лат)
- LastName * – фамилия (лат)
- Patronymic * – отчество (лат)
- FirstNameRus * – имя (рус)
- LastNameRus * – фамилия (рус)
- PatronymicRus * – отчество (рус)
- InternationalPassportSeries * – серия загранпаспорта
- InternationalPassportNumber * – номер загранпаспорта
- InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
- InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
- internationalPassportByWhom * – кем выдан загранпаспорт
- PassportSeries * – серия паспорта
- PassportNumber * – номер паспорта
- PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
- PassportDateOfIssueString * – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
- PassportByWhom * – кем выдан паспорт
- Citizenship * – название страны
- Phone * – телефон
- Email * – e-mail
- BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace * – место рождения
- CitizenID * – ID туриста (задается в карточке постоянного клиента)
- Age * – количество полных лет на момент окончания тура
- BranchId * – ключ филиала бронирования (начиная с релиза 15.3). Если не передан, то филиал бронирования берется из менеджера по умолчанию либо из пользователя, создавшего тур. Может быть с пустым значением
- OwnerId * – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура. Может быть с пустым значением
- Day * – день (перевод) Может быть с пустым значением
- Day2 * – дня (перевод) Может быть с пустым значением
- Days * – дней (перевод) Может быть с пустым значением
- Night * – ночь (перевод) Может быть с пустым значением
- Night2 * – ночи (перевод) Может быть с пустым значением
- Nights * – ночей (перевод) Может быть с пустым значением
- adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги (перевод) Может быть с пустым значением
- incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) (перевод) Может быть с пустым значением
- OrderInfoUrl – Адрес окна путевки в личном кабинете
- DogovorComment – Комментарий к путевке (сохраняется как сообщения в истории путевки) Может быть с пустым значением
- Возвращаемый результат:
- Reservation – объект путевки
- $id – внутренний идентификатор для установки связей между сущностями,
- Code – код путевки
- TurDate – дата заезда
- TRKey – ключ тура
- CNKey – ключ страны
- CTKey – ключ города
- NMen – количество туристов по путевке
- Price – стоимость путевки за вычетом скидки (комиссии)
- Payed – оплаченная сумма по путевке
- NDay – продолжительность тура в днях
- MainMan – ФИО лица, заключившего договор
- MainManPhone – номер телефона лица, заключившего договор
- MainManAddress – адрес лица, заключившего договор
- MainManPassport – паспортные данные лица, заключившего договор
- PartnerKey – ключ партнера, оформившего договор
- Operator – ФИО создателя договора
- Discount – величина скидки на одного человека
- DiscountSum – абсолютная величина скидки
- SORCode – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
- CrDate – дата и время создания путевки
- Rate – код валюты путевки
- Advertise – ключ источника рекламы
- Locked – блокировка путевки: 1 – если заблокирована
- CauseDisc – ключ основания для скидки
- PPaymentDate – максимальная дата внесения предоплаты
- PaymentDate – максимальная дата полной оплаты
- Procent – информация о предоплате: 1 – предоплата в %; 0 – предоплата в у.е.
- TurDateBfrAnnul – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
- ARKey – ключ причины аннуляции путевки
- Key – ключ договора
- CodePartner – значение ключевого поля из таблицы партнеров
- FilialKey – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
- IsOutDoc – статус выдачи документов
- Notes – сообщение поставщику
- DiscSumBfrAnn – числовое значение скидки перед аннуляцией путевки
- PriceBfrAnn – стоимость путевки перед ее аннуляцией
- RazmerP – размер предоплаты
- LeadDepartment – ключ отдела, ведущего данный тур
- MainManEmail – адрес е-mail из данных лица, заключившего договор
- MainManComment – примечание из данных лица, заключившего договор
- DupUserKey – ключ представителя партнера, которым был оформлен договор
- BTKey – ключ системы бронирования, из которой был оформлен договор
- ConfirmedDate – дата подтверждения путевки покупателю
- PrtDogKey – договор партнера, по которому оформлена путевка
- CTDepartureKey – ключ города начала поездки
- PDTType – тип договора, по которому оформлена путевка
- NationalCurrencyPrice – стоимость путевки в национальной валюте
- NationalCurrencyDiscountSum – значение скидки в национальной валюте
- NationalCurrencyPayed – сумма платежей по путевке, зафиксированная в национальной валюте
- CurrencyKey – ключ национальной валюты путевки
- CurrencyRate – курс национальной валюты путевки
- ClientKey – ключ частника, которым был оформлен договор
- Partner – информация о партнере покупателе, привязанным к путевке
- $id – внутренний идентификатор для установки связей между сущностями
- Key – ключ партнера покумателя
- FullName – полное имя партнера
- Name – имя партнера
- Services – коллекция услуг в данной путевке
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки
- TurDate – дата начала тура
- Key – ключ услуги
- PaketKey – ключ пакета
- TRKey – клют тура
- SVKey – ключ типа услуги
- Name – наименование услуги
- Day – порядковый номер дня тура, в который предоставляется услуга
- Code – ключ кода услуги
- SubCode1 – ключ доп.описания 1 услуги
- SubCode2 – ключ доп.описания 2 услуги
- Men – количество человек, пользующихся услугой по путевке
- Days – количество дней услуги
- CNKey – ключ страны услуги
- CTKey – ключ города услуги
- PartnerKey – ключ партнера, предоставляющего услугу
- Brutto – стоимость услуги брутто
- Wait – признак услуги Снимать квоту при бронировании
- Warning – неиспользуемое поле
- TimeBeg – поле используется для сортировки услуг в путевке
- Control – ключ статуса услуги (ссылка на таблицу Controls),
- Attribute – атрибут услуги
- DateBeg – дата начала действия услуги
- DateEnd – дата окончания действия услуги
- Discount – размер скидки по услуге
- Comment – комментарий к услуге
- DGKey – ключ договора,
- Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
- NameLat – наименование услуги (латинский)
- Long – продолжительность тура в днях
- TRFId – ключ тарифа
- CreateDate – дата создания услуги в путевке
- CalculatePriceDate – дата расчета цены
- ShowOrder – порядок при сортировке
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- Turists – коллекция туристов в данной путевке
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки, к которому привязан турист
- Key – ключ туриста
- TurDate – дата начала тура
- NameRus – фамилия туриста (русское)
- NameLat – фамилия туриста (латинское)
- ShortName – имя и отчество туриста в формате И.О.
- Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
- FNameRus – имя туриста (русское)
- FNameLat – имя туриста (латинское)
- SNameRus – отчество туриста (русское)
- SNameLat – отчество туриста (латинское)
- BirthDay – дата рождения туриста
- BirthCountry – страна рождения туриста
- BirthCity – город рождения туриста
- Citizen – гражданство туриста
- PostIndex – почтовый индекс
- PostCity – адрес проживания туриста (город)
- PostStreet – адрес проживания туриста (улица)
- PostBild – адрес проживания туриста (номер дома)
- PostFlat – адрес проживания туриста (номер квартиры)
- Phone – номер телефона туриста
- PhoneCode – код телефона туриста
- PasportType – серия заграничного паспорта
- PasportNum – номер заграничного паспорта
- PasportDate – дата выдачи заграничного паспорта
- PasportDateEnd – дата окончания срока действия заграничного паспорта
- PasportByWhom – кем выдан заграничный паспорт
- Place – место рождения
- IsAnketa – выдавалась ли анкета
- PaspRuser – серия общегражданского паспорта
- PaspRuNum – номер общегражданского паспорта
- PaspRuDate – дата выдачи общегражданского паспорта
- PaspRuByWhom – кем выдан общегражданский паспорт
- ClientId – ключ в таблице клиентов
- IsMain – признак главного туриста по путевке
- DGKey – ключ кутевки
- RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
- Email – е-mail туриста
- EnableSmsNotifications – согласен получать уведомления по СМС
- CitizenId – идентификатор туриста
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- TuristServices – коллекция связей туриста с услугой
- $id – внутренний идентификатор для установки связей между сущностями
- TUKey – ключ туриста
- DLKey – ключ услуги
- NumDoc – номер документа (авиабилета)
- NumRoom – номер комнаты (каюты)
- Seat – номер места (в номере отеля, каюты) или место в транспорте
- Area – зона (палуба) в отеле, круизе
- DocDate – дата документа (авиабелета)
- Key – первичный ключ связки
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- DogovorMessages – сообщение по путевке покупателю
- id – внутренний идентификатор для установки связей между сущностями
- Date – дата создание сообщения
- Text – текст сообщения
- Remark – код сообщения
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- ValidationResultSummary – объект статус результата бронирования
- ValidationResult – объект с ошибками и флагом валидности путевки
- Errors – массив ошибок бронирования
- IsValid – признак валидности бронирования
- ValidationResultAttributes – атрибут результата бронирования
- ValidationResult – объект с ошибками и флагом валидности путевки
- Reservation – объект путевки
Бронирование путевки с упрощенными входными параметрами (CreateReservationExternalSystem)
Метод производит бронирование путевки с упрощенными входными параметрами.
При бронировании проверяется корректность заполнения обязательных полей туристов. В случае, если обязательные поля не заполнены, возвращается ошибка с сообщением, бронь не создается.
- Формат запроса:
- PUT .../TourSearchOwin/CreateReservationExternalSystem/1?
- Принимаемые параметры headers (* – обязательный):
- Content-Type * – application/json
- Authorization * – token_type + access_token (полученные из метода .../TourSearchOwin/Token?)
- Принимаемые параметры PUT запроса:
- BeginDate * – дата начала тура (YYYY-MM-DDThh:mm)
- Duration * – продолжительность тура в днях
- Currency * – код валюты
- TourProgramId – идентификатор турпрограммы (необязательный, по умолчанию 0)
- Services * – массив услуг, в данном случае будет содержать только услугу отель
- Code * – идентификатор отеля во внешней системе, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
- Cost * – стоимость проживания за весь период
- Packet * – идентификатор пакета, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
- SubCode1 * – идентификатор типа номера, сравниваются с промежуточной базой данных статического адаптера MIS TravelLine (Россия)
- Tourists * – массив туристов
- FirstName * – имя туриста
- LastName * – фамилия туриста
- Patronymic * – отчество туриста
- MaleFemaleSex * – пол (0 – мужской, 1 – женский)
- AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- Age * – количество полных лет на момент окончания тура
- Phone * – телефон (обязателен для первого туриста)
- Email * – e-mail (обязателен для первого туриста)
- DogovorComment * – комментарий к путевке (ограничение 254 символа, при превышении разбивается на части)
1. В случае, если в теле запроса указываются ID несинхронизированных отелей, пакета, типа номера, то создаются фиктивные данные, которые необходимо изменить в услуге экрана Путевка (пример: Отель – ApiHotel, пакет – ApiPacket, тип номера – ApiRoom(ApiRoomCategory),ApiAccmdmen)
2. Тип питания всегда будет создаваться фиктивный и его необходимо изменить в услуге экрана Путевка (пример: Тип питания – ApiPansion)
- Возвращаемый результат:
- Reservation – объект путевки
- $id – внутренний идентификатор для установки связей между сущностями,
- Code – код путевки
- TurDate – дата начала тура
- TRKey – идентификатор тура
- CNKey – идентификатор страны
- CTKey – идентификатор города
- NMen – количество туристов
- Price – стоимость путевки
- Payed – оплаченная сумма
- NDay – продолжительность тура в днях
- MainMan – контактное лицо
- MainManPhone – телефон контактного лица
- MainManAddress – адрес лица, заключившего договор
- MainManPassport – паспортные данные контактного лица
- PartnerKey – идентификатор партнера
- Operator – оператор, оформивший путевку
- Discount – размер скидки
- DiscountSum – сумма скидки
- SORCode – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
- CrDate – дата создания путевки
- Rate – код валюты путевки
- Advertise – идентификатор рекламного источника
- Locked – статус блокировки путевки
- CauseDisc – код основания скидки
- PPaymentDate – дата предоплаты
- PaymentDate – максимальная дата полной оплаты
- Procent – предоплата в %
- TurDateBfrAnnul – дата начала тура до аннуляции
- ARKey – идентификатор причины аннуляции
- Key – идентификатор договора
- CodePartner – идентификатор партнера
- FilialKey – идентификатор филиала
- IsOutDoc – статус выдачи документов
- Notes – примечания
- DiscSumBfrAnn – сумма скидки перед аннуляцией
- PriceBfrAnn – цена путевки перед аннуляцией
- RazmerP – размер предоплаты
- LeadDepartment – идентификатор ведущего отдела
- MainManEmail – e-mail контактного лица
- MainManComment – комментарий контактного лица
- DupUserKey – идентификатор представителя агента
- BTKey – идентификатор системы бронирования
- ConfirmedDate – дата подтверждения путевки
- PrtDogKey – идентификатор договора партнера
- CTDepartureKey – идентификатор города отправления
- PDTType – тип договора путевки
- NationalCurrencyPrice – цена в национальной валюте
- NationalCurrencyDiscountSum – сумма скидки в национальной валюте
- NationalCurrencyPayed – оплаченная сумма в национальной валюте
- CurrencyKey – идентификатор валюты
- CurrencyRate – курс валюты
- ClientKey – идентификатор клиента
- AgencyPrice – цена для агентства
- Partner – информация о партнере
- $id – идентификатор записи
- Key – идентификатор партнера
- FullName – полное название партнера
- Name – краткое название партнера
- Services – список услуг
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки
- TurDate – дата начала тура
- Key – ключ услуги
- PaketKey – ключ пакета
- TRKey – клют тура
- SVKey – ключ типа услуги
- Name – наименование услуги
- Day – порядковый номер дня тура, в который предоставляется услуга
- Code – ключ кода услуги
- SubCode1 – ключ доп.описания 1 услуги
- SubCode2 – ключ доп.описания 2 услуги
- Men – количество человек, пользующихся услугой по путевке
- Days – количество дней услуги
- CNKey – ключ страны услуги
- CTKey – ключ города услуги
- PartnerKey – ключ партнера, предоставляющего услугу
- Brutto – стоимость услуги брутто
- Wait – признак услуги Снимать квоту при бронировании
- Warning – неиспользуемое поле
- TimeBeg – поле используется для сортировки услуг в путевке
- Control – ключ статуса услуги (ссылка на таблицу Controls),
- Attribute – атрибут услуги
- DateBeg – дата начала действия услуги
- DateEnd – дата окончания действия услуги
- Discount – размер скидки по услуге
- Comment – комментарий к услуге
- DGKey – ключ договора,
- Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
- NameLat – наименование услуги (латинский)
- Long – продолжительность тура в днях
- TRFId – ключ тарифа
- CreateDate – дата создания услуги в путевке
- CalculatePriceDate – дата расчета цены
- ShowOrder – порядок при сортировке
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- Turists – список туристов
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки, к которому привязан турист
- Key – ключ туриста
- TurDate – дата начала тура
- NameRus – фамилия туриста (русское)
- NameLat – фамилия туриста (латинское)
- ShortName – имя и отчество туриста в формате И.О.
- Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
- FNameRus – имя туриста (русское)
- FNameLat – имя туриста (латинское)
- SNameRus – отчество туриста (русское)
- SNameLat – отчество туриста (латинское)
- BirthDay – дата рождения туриста
- BirthCountry – страна рождения туриста
- BirthCity – город рождения туриста
- Citizen – гражданство туриста
- PostIndex – почтовый индекс
- PostCity – адрес проживания туриста (город)
- PostStreet – адрес проживания туриста (улица)
- PostBild – адрес проживания туриста (номер дома)
- PostFlat – адрес проживания туриста (номер квартиры)
- Phone – номер телефона туриста
- PhoneCode – код телефона туриста
- PasportType – серия заграничного паспорта
- PasportNum – номер заграничного паспорта
- PasportDate – дата выдачи заграничного паспорта
- PasportDateEnd – дата окончания срока действия заграничного паспорта
- PasportByWhom – кем выдан заграничный паспорт
- Place – место рождения
- IsAnketa – выдавалась ли анкета
- PaspRuser – серия общегражданского паспорта
- PaspRuNum – номер общегражданского паспорта
- PaspRuDate – дата выдачи общегражданского паспорта
- PaspRuByWhom – кем выдан общегражданский паспорт
- ClientId – ключ в таблице клиентов
- IsMain – признак главного туриста по путевке
- DGKey – ключ кутевки
- RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
- Email – е-mail туриста
- EnableSmsNotifications – согласен получать уведомления по СМС
- CitizenId – идентификатор туриста
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- TuristServices – коллекция связей туриста с услугой
- $id – внутренний идентификатор для установки связей между сущностями
- TUKey – ключ туриста
- DLKey – ключ услуги
- NumDoc – номер документа (авиабилета)
- NumRoom – номер комнаты (каюты)
- Seat – номер места (в номере отеля, каюты) или место в транспорте
- Area – зона (палуба) в отеле, круизе
- DocDate – дата документа (авиабелета)
- Key – первичный ключ связки
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- DogovorMessages – сообщение по путевке покупателю
- id – внутренний идентификатор для установки связей между сущностями
- Date – дата создание сообщения
- Text – текст сообщения
- Remark – код сообщения
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- ValidationResultSummary – объект статус результата бронирования
- ValidationResult – объект с ошибками и флагом валидности путевки
- Errors – массив ошибок бронирования
- IsValid – признак валидности бронирования
- ValidationResultAttributes – атрибут результата бронирования
- 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 – ключ статус путевки, возможные значения: 0-в работе, 1-не определён, 2-аннулирован, 3-wait лист, 7-ок.
- CrDate – дата и время создания путевки
- Rate – код валюты путевки
- Advertise – ключ источника рекламы
- Locked – блокировка путевки: 1 – если заблокирована
- CauseDisc – ключ основания для скидки
- PPaymentDate – максимальная дата внесения предоплаты
- PaymentDate – максимальная дата полной оплаты
- Procent – информация о предоплате: 1 – предоплата в %; 0 – предоплата в у.е.
- TurDateBfrAnnul – значение даты заезда до аннуляции путевки (при аннуляции дата заезда заменяется на 31.12.1899)
- ARKey – ключ причины аннуляции путевки
- Key – ключ договора
- CodePartner – значение ключевого поля из таблицы партнеров
- FilialKey – ключ филиала фирмы-владельца, пользователем которого была забронирована путевка
- IsOutDoc – статус выдачи документов
- Notes – сообщение поставщику
- DiscSumBfrAnn – числовое значение скидки перед аннуляцией путевки
- PriceBfrAnn – стоимость путевки перед ее аннуляцией
- RazmerP – размер предоплаты
- LeadDepartment – ключ отдела, ведущего данный тур
- MainManEmail – адрес е-mail из данных лица, заключившего договор
- MainManComment – примечание из данных лица, заключившего договор
- DupUserKey – ключ представителя партнера, которым был оформлен договор
- BTKey – ключ системы бронирования, из которой был оформлен договор
- ConfirmedDate – дата подтверждения путевки покупателю
- PrtDogKey – договор партнера, по которому оформлена путевка
- CTDepartureKey – ключ города начала поездки
- PDTType – тип договора, по которому оформлена путевка
- NationalCurrencyPrice – стоимость путевки в национальной валюте
- NationalCurrencyDiscountSum – значение скидки в национальной валюте
- NationalCurrencyPayed – сумма платежей по путевке, зафиксированная в национальной валюте
- CurrencyKey – ключ национальной валюты путевки
- CurrencyRate – курс национальной валюты путевки
- ClientKey – ключ частника, которым был оформлен договор
- Partner – информация о партнере покупателе, привязанным к путевке
- $id – внутренний идентификатор для установки связей между сущностями
- Key – ключ партнера покумателя
- FullName – полное имя партнера
- Name – имя партнера
- Services – коллекция услуг в данной путевке
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки
- TurDate – дата начала тура
- Key – ключ услуги
- PaketKey – ключ пакета
- TRKey – клют тура
- SVKey – ключ типа услуги
- Name – наименование услуги
- Day – порядковый номер дня тура, в который предоставляется услуга
- Code – ключ кода услуги
- SubCode1 – ключ доп.описания 1 услуги
- SubCode2 – ключ доп.описания 2 услуги
- Men – количество человек, пользующихся услугой по путевке
- Days – количество дней услуги
- CNKey – ключ страны услуги
- CTKey – ключ города услуги
- PartnerKey – ключ партнера, предоставляющего услугу
- Brutto – стоимость услуги брутто
- Wait – признак услуги Снимать квоту при бронировании
- Warning – неиспользуемое поле
- TimeBeg – поле используется для сортировки услуг в путевке
- Control – ключ статуса услуги (ссылка на таблицу Controls),
- Attribute – атрибут услуги
- DateBeg – дата начала действия услуги
- DateEnd – дата окончания действия услуги
- Discount – размер скидки по услуге
- Comment – комментарий к услуге
- DGKey – ключ договора,
- Blocked – признак блокировки услуги (0 – не блокирована, 1 – блокирована)
- NameLat – наименование услуги (латинский)
- Long – продолжительность тура в днях
- TRFId – ключ тарифа
- CreateDate – дата создания услуги в путевке
- CalculatePriceDate – дата расчета цены
- ShowOrder – порядок при сортировке
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- Turists – коллекция туристов в данной путевке
- $id – внутренний идентификатор для установки связей между сущностями
- DGCod – номер путевки, к которому привязан турист
- Key – ключ туриста
- TurDate – дата начала тура
- NameRus – фамилия туриста (русское)
- NameLat – фамилия туриста (латинское)
- ShortName – имя и отчество туриста в формате И.О.
- Sex – пол туриста (признак): Null или 0 – Муж; 1 – Жен; 2 – Child (ребенок); 3 – Infant (младенец)
- FNameRus – имя туриста (русское)
- FNameLat – имя туриста (латинское)
- SNameRus – отчество туриста (русское)
- SNameLat – отчество туриста (латинское)
- BirthDay – дата рождения туриста
- BirthCountry – страна рождения туриста
- BirthCity – город рождения туриста
- Citizen – гражданство туриста
- PostIndex – почтовый индекс
- PostCity – адрес проживания туриста (город)
- PostStreet – адрес проживания туриста (улица)
- PostBild – адрес проживания туриста (номер дома)
- PostFlat – адрес проживания туриста (номер квартиры)
- Phone – номер телефона туриста
- PhoneCode – код телефона туриста
- PasportType – серия заграничного паспорта
- PasportNum – номер заграничного паспорта
- PasportDate – дата выдачи заграничного паспорта
- PasportDateEnd – дата окончания срока действия заграничного паспорта
- PasportByWhom – кем выдан заграничный паспорт
- Place – место рождения
- IsAnketa – выдавалась ли анкета
- PaspRuser – серия общегражданского паспорта
- PaspRuNum – номер общегражданского паспорта
- PaspRuDate – дата выдачи общегражданского паспорта
- PaspRuByWhom – кем выдан общегражданский паспорт
- ClientId – ключ в таблице клиентов
- IsMain – признак главного туриста по путевке
- DGKey – ключ кутевки
- RealSex – реальный пол туриста: Null или 0 – Муж; 1 – Жен
- Email – е-mail туриста
- EnableSmsNotifications – согласен получать уведомления по СМС
- CitizenId – идентификатор туриста
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- TuristServices – коллекция связей туриста с услугой
- $id – внутренний идентификатор для установки связей между сущностями
- TUKey – ключ туриста
- DLKey – ключ услуги
- NumDoc – номер документа (авиабилета)
- NumRoom – номер комнаты (каюты)
- Seat – номер места (в номере отеля, каюты) или место в транспорте
- Area – зона (палуба) в отеле, круизе
- DocDate – дата документа (авиабелета)
- Key – первичный ключ связки
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
- DogovorMessages – сообщение по путевке покупателю
- id – внутренний идентификатор для установки связей между сущностями
- Date – дата создание сообщения
- Text – текст сообщения
- Remark – код сообщения
- Connections – коллекция связей с сущностями через внутренний идентификатор $id
- $ref – связь с внутренним идентификатором $id
Выгрузка информации о ценовых блоках (CostOfferDescriptions)
Метод принимает на вход ключи ценовых блоков и возвращает, прикреплённое к ним описание.
- Формат запроса:
- GET .../TourSearchOwin/CostOfferDescriptions?
- Принимаемые параметры ( * – обязательный):
- COKeysString * – ключи ценовых блоков через запятую
- Возвращаемый результат:
- CostOfferImageInfo – коллекция объектов из двух полей:
- IdCostOffer – ключ ценового блока
- InfoText – описание ценового блока
- 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 – есть ли информация
- ImagesCount – общее количество картинок по отелю
- либо (если передан hotelKey)
- Images – объект картинок
- Key – ключ картинки
- Description – описание картинки
- Priority – приоритет
- Name – название файла
- HotelKey – ключ отеля
- InfoExists – есть ли информация
- Country – страна отеля
- City – город отеля
- Name – название отеля
- HotelCategoryName – категория отеля
- Address – адрес отеля
- Phone – телефон
- Email – e-mail
- Http – адрес сайта
- Description – описание отеля
- InfrastructureHotel – инфраструктура отеля
- RecreationSport – развлечения и спорт
- Beach – информация о пляже
- Healing – лечение
- Excursion – экскурсии
- AdditionalService – дополнительные услуги
- ForChildren – для детей
- AddCost – доплаты
- CheckoutTimeFrom – заезд в отель
- CheckoutTimeTo – выезд из отеля
- Latitude – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
- Longitude – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
- Images – объект картинок
Отображение картинки в браузере (GetImage)
Данный метод реализован не на API, а внутри самого приложения (Canary или TourSearchClient) и отображает картинку, полученную в методе HotelImages.
- Формат запроса:
- Принимаемые параметры ( * – обязательный):
- code * – ключ отеля
- type * – размер картинки (возможные значения: small1, small160x90, medium, big)
- name * – название файла (берется из метода HotelImages)
- imageType * – тип картинки (возможные значения: hotels, tours)
- Возвращаемый результат:
- изображение картинки отеля
Выгрузка картинки по туру (TourImages)
Метод выгружает картинки по туру.
- Формат запроса:
- GET .../TourSearchOwin/TourImages?
- Принимаемые параметры ( * – обязательный):
- tourKeys * – ключ тура (можно передать несколько ключей тура, каждый раз указывая параметр tourKeys)
- Возвращаемый результат:
- Images – объект картинок
- Key – ключ картинки
- Description – описание картинки
- Priority – приоритет
- Name – название файла
- TourKey – ключ тура
- Images – объект картинок
Отображение картинки в браузере (GetImage)
Данный метод реализован не на API, а внутри самого приложения (Canary или TourSearchClient) и отображает картинку, полученную в методе TourImages.
- Формат запроса:
- Принимаемые параметры ( * – обязательный):
- code * – ключ тура
- type * – размер картинки (возможные значения: small1, small160x90, medium, big)
- name * – название файла (берется из метода TourImages)
- imageType * – тип картинки (возможные значения: hotels, tours)
- Возвращаемый результат:
- изображение картинки отеля
Регистрация частного лица (PersonalRegistration)
Метод производит регистрацию частного лица.
- Формат запроса:
- GET .../TourSearchOwin/PersonalRegistration?
- Принимаемые параметры ( * – обязательный):
- name * – имя
- surname * – фамилия
- phone * – телефон
- login * – e-mail (он же является логином). Предварительно нужно вызывать метод проверки e-mail CheckMail
- password * – пароль (при упрощенной регистрации пароль не передается, а формируется системой автоматически)
- citizen * – гражданство (возможна передача пустого значения)
- country * – страна (возможна передача пустого значения)
- city * – город (возможна передача пустого значения)
- address * – адрес (возможна передача пустого значения)
- comment * – комментарий (возможна передача пустого значения)
- captchaText * – текст капчи. Предварительно нужно вызывать метод получения капчи GetCaptcha. Полученный FileContents преобразовать с помощью json в картинку, текст из которой вставить как значение captchaText.
- sessionId * – Id сессии (возможна передача произвольного значения)
- Возвращаемый результат:
- SxotpFhg – сформированный (при упрощенной регистрации) или заданный пользователем пароль
Выгрузка плана рассадки (TransportPlan)
Метод выгружает план рассадки транспортного средства.
- Формат запроса:
- GET .../TourSearchOwin/TransportPlan?
- Принимаемые параметры ( * – обязательный):
- code * – код услуги
- dateBegin * – дата начала услуги
- serviceType * – класс услуги
- transportKey * – ключ транспорта
- Возвращаемый результат:
- TransportKey – ключ транспорта
- Title – название
- AreasCount – количество зон (уровней)
- RowsCount – количество рядов
- ColumnsCount – количество колонок
- BusySeats – информация о занятых местах
- Cells – блок не заполняется
- Row – ряд
- Column – колонка
- Area – уровень
- Type – тип места (1 - свободно, 5 - занято)
- Name – номер места
- UserSeats – блок не заполняется
- BlockSeat – блок не заполняется
Выгрузка списка всех стран (Countries)
Метод производит выгрузку всех стран (используется для регистрации частного лица).
- Формат запроса:
- GET .../TourSearchOwin/Countries?
- Принимаемые параметры ( * – обязательный):
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Key – ключ страны
- Name – название
Выгрузка списка всех городов (Cities)
Метод производит выгрузку всех городов (используется для регистрации частного лица).
- Формат запроса:
- GET .../TourSearchOwin/Cities?
- Принимаемые параметры ( * – обязательный):
- countryKey * – ключ страны, по которой выгружать города (при значении -1 выгружаются все города)
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Key – ключ города
- Name – название
Выгрузка городов отправления в оформлении клиентов (RegistrationClientsDepartureCities)
Метод производит выгрузку городов отправления в оформлении клиентов.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClientsDepartureCities?
- Принимаемые параметры ( * – обязательный):
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- withoutFlight – перевод для ключа -1 (Без перелета)
- Возвращаемый результат:
- Key – ключ города
- Name – название
- IsExist – информация о том, есть ли в этом городе отправления актуальные программы туров (true/false)
Выгрузка стран в оформлении клиентов (RegistrationClientsDestination)
Метод производит выгрузку стран в оформлении клиентов.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClientsDestination?
- Принимаемые параметры ( * – обязательный):
- departureCity * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- Возвращаемый результат:
- Name – название
- Key – ключ страны
- DestinationType – тип результата (внутренний параметр, не изменяемый, всегда возвращается значение = 1)
- IsExist – информация о том, есть ли в этой стране актуальные программы туров (true/false)
Выгрузка турпрограмм в оформлении клиентов (RegistrationClientsTourPrograms)
Метод производит выгрузку турпрограмм в оформлении клиентов.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClientsTourPrograms?
- Принимаемые параметры ( * – обязательный):
- departureCity * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
- destination * – ключ страны (из контроллера .../TourSearchOwin/RegistrationClientsDestination?)
- destinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
- term * – фильтрация результатов по контекстному поиску (по умолчанию параметр пустой)
- individualTitle – перевод для программы тура с ключом 0 (Индивидуально)
- Возвращаемый результат:
- Key – ключ программы туров
- Name – название программы туров
- Rate – валюта тура
Выгрузка дат заезда в оформлении клиентов (RegistrationClientsTourDate)
Метод производит выгрузку дат заезда в оформлении клиентов.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClientsTourDate?
- Принимаемые параметры ( * – обязательный):
- tourKey * – ключ программы тура
- Возвращаемый результат:
- массив дат
Поиск туров в оформлении клиентов (Search)
Метод возвращает наиболее дешевое предложения по определенному туру.
- Формат запроса:
- GET .../TourSearchOwin/RegistrationClient/Search?
- Принимаемые параметры ( * – обязательный):
- DepartureCityKeys * – ключ города отправления (из контроллера .../TourSearchOwin/RegistrationClientsDepartureCities?)
- Dates * – дата заезда (из контроллера .../TourSearchOwin/RegistrationClientsTourDate?)
- Durations * – продолжительность
- PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
- PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
- isFromBasket * – всегда false
- isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
- DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
- DestinationKey * – идентификатор страны прибытия (из контроллера .../TourSearchOwin/RegistrationClientsDestination?)
- AdultCount * – количество взрослых
- ChildAges – возраст детей. Если детей несколько, и параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- IsRegistrationClients – по умолчанию всегда приходит false
- CurrencyName * – код валюты
- AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelScheme – пустой по умолчанию
- TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
- TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
- TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
- TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
- ArrivalFlightNoTransfer – производить поиск без пересадок в прямом направлении (true/false, по умолчанию false)
- DepartureFlightNoTransfer – производить поиск без пересадок в обратном направлении (true/false, по умолчанию false)
- TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
- Tour – ключ программы тура
- Возвращаемый результат:
- CheckMessages – сообщения для логики проверки тура (не используется)
- Message – сообщение об ошибке
- Key – код ошибки
- Value – сообщение об ошибке
- Result – результаты поиска
- Key – идентификатов программы тура
- Name – название программы тура
- TourUrl – ссылка на программу тура
- BookingConditions – условия бронирования программы туров
- StartDate – дата начала тура
- Duration – продолжительность тура (в днях)
- DurationInNight – продолжительность проживания (в ночах)
- Types – идентификатор типа туров
- Cost – цена тура
- Rate – код валюты тура
- CityDepature – город отправления
- Key – идентификатор города отправления
- Value – название города отправления
- CountryId – всегда возвращается ключ 0
- Services – услуги в туре
- DepartureCity – город отправления
- Key – идентификатор
- Value – название
- DepartureCountry – страна отправления
- Key – идентификатор
- Value – название
- ArrivalCity – город прибытия
- Key – идентификатор
- Value – название
- ArrivalCountry – страна прибытия
- Key – идентификатор
- Value – название
- DepartureAirport – аэропорт отправления
- Key – идентификатор
- Value – название
- ArrivalAirport – аэропорт прибытия
- Key – идентификатор
- Value – название
- Airline – авиакомпания
- Key – идентификатор
- Value – название
- Aircraft – воздушное судно
- Key – идентификатор
- Value – название
- Flight – рейс
- Key – идентификатор
- Value – название
- DepartureTime – время вылета
- ArrivalTime – время прилета
- EndDateTime – дата и время прилета
- FlightDetails – информация об авиаперелете
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – название тарифа
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – название
- 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 – объект страна
- Key – ключ страны
- Value – название страны
- Code – объект код услуги
- Key – ключ услуги
- Value – название услуги
- ByScheduler – флаг услуга по расписанию или нет
- Details – объект детализация услуги
- SubCode1 – объект доп. описание 1
- Key – ключ доп. описания 1
- Value – название доп. описания 1
- SubCode2 – объект доп. описание 2
- Key – ключ доп. описания 2
- Value – название доп. описания 2
- Date – дата услуги
- IsShowTransportPlan – признак показывать ли план рассадки (для автобусов)
- Cost – цена
- QuotaStatus – объект информация по квотам
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – идентификатор партнера
- ByPax – признак цены за человека
- Partner – объект партнер (не заполняется)
- Key – ключ (не заполняется)
- Value – название (не заполняется)
- 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 –
- Type – тип справочника (используется для внутренних целей)
- TourDurations – продолжительность тура
- TourDates – список дат заездов в турпрограмме
- HotelCities – город в дополнительных фильтрах
- ' –
- HotelResorts – курорты в дополнительных фильтрах
- ' –
- HotelCategories – категории отеля в дополнительных фильтрах
- ' –
- Hotels – отели в дополнительных фильтрах
- ' –
- Pansions – питания в дополнительных фильтрах
- ' –
- Airlines – авиакомпании в дополнительных фильтрах
- ' –
- FlightTariffs – класс перелета в дополнительных фильтрах
- ' –
- DepartureCities – города вылета в дополнительных фильтрах
- ' –
- DepartureAirports – аэропорты вылета в дополнительных фильтрах
- ' –
- ArrivalCities – города прибытия в дополнительных фильтрах
- ' –
- ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
- ' –
- HotelTypes – признаки отелей в дополнительных фильтрах
- ' –
- HotelCities – город в дополнительных фильтрах
- TourTypes – типы тура
Поиск туров онлайн (TourForWeb)
Метод поиска туров использует множество параметров для поиска и фильтрации туров. Метод возвращает наиболее дешевые предложения, найденные по предоставленным параметрам и сгруппированные по отелям в порядке возрастания цены. В зависимости от параметров запроса, дополнительных фильтров формат запроса имеет отличия. Метод используется при работе веб-приложения Canary.
- Обычный формат запроса GET:
- GET .../TourSearchOwin/TourForWeb/search/simple?
- Принимаемые параметры ( * – обязательный):
- DepartureCityKeys * – идентификатор города отправления (полученный из метода .../TourSearchOwin/departureCities?)
- Dates * – массив дат заезда (полученные из метода .../TourSearchOwin/TourDate?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- Durations * – массив продолжительностей (полученные из метода .../TourSearchOwin/Duration?). Если параметры передаются через url, то каждое значение необходимо передавать отдельным параметром.
- PageNumber * – номер возвращаемой страницы (по умолчанию возвращается 1)
- PageSize * – количество возвращаемых результатов на одной странице (возвращается 20)
- HotelScheme * – объект схемы отеля
- TourKey – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: ключ программы тура
- TourDuration – пустой по умолчанию. Заполняется при вызове вариантов размещений в рамках одного отеля: продолжительность тура в днях
- ShowToursWithoutHotels – показывать ли туры без проживания
- isFromBasket * – происходит ли обращение из корзины или из поиска туров (true/false).
- isFillSecondaryFilters – заполнены ли дополнительные фильтры (по умолчанию всегда приходит true). Служебный внутренний параметр. При работе с API не используется.
- DestinationType * – тип результата (внутренний параметр, не изменяемый, всегда указывать значение = 1)
- DestinationKey * – идентификатор страны прибытия (полученный из метода .../TourSearchOwin/Destination?)
- AdultCount * – количество взрослых
- CurrencyName * – код валюты
- AviaQuota * – информация о квотах на авиаперелет (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- HotelQuota * – информация о квотах на отель (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- BusTransferQuota – информация о квотах на автобусный переезд (значения параметров: "1" — фильтр "Есть", "5" — фильтр "Есть+запрос", "7" — фильтр "Все")
- TourType – тип тура
- CityIds – идентификатор города
- TimeDepartureFrom – время отправления с (по умолчанию возвращается 00:00)
- TimeDepartureTo – время отправления по (по умолчанию возвращается 23:59)
- TimeArrivalFrom – время прибытия с (по умолчанию возвращается 00:00)
- TimeArrivalTo – время прибытия по (по умолчанию возвращается 23:59)
- SearchId – уникальный идентификатор запроса поиска, передаваемый с клиентской части. Возвращается в ответе без изменений. Обрабатывается начиная с релиза 15.5.
- MatrixAlgoritm – используется ли дополнительный фильтр «Таблица цен»
- SearchMaxPriceAlgoritm –
- wrongLicenseFileUpperTitle – проверка файла лицензии
- RemoteHotelMode – признак того, производится поиск только локальных отелей или и от внешних поставщиков тоже (только локальные отели – 0, только внешние отели – 2, локальные и внешние отели – 1). Если признак отсутствует – поиск будет только по локальным отелям. Обрабатывается начиная с релиза 15.4.
- Возвращаемый результат:
- Result – результаты поиска
- Key – идентификатор программы тура
- Name – название программы тура
- TourUrl – ссылка на программу тура
- BookingConditions – условия бронирования программы туров
- DefaultManagers – менеджер по-умолчанию
- Manager – обозначение менеджера
- Branches – филиал
- DetermineTheBranchOnCity – признак определения филиала в зависимости от города начала поездки
- StartDate – дата начала тура
- Duration – продолжительность тура (в днях)
- DurationInNight – продолжительность проживания (в ночах)
- Types – идентификатор типа туров
- Cost – цена тура
- Rate – код валюты тура
- CityDepature – город отправления
- Key – идентификатор города отправления
- Value – название города отправления
- CountryId – всегда возвращается ключ 0
- Services – услуги в туре
- DepartureCity – город отправления
- Key – идентификатор
- Value – название
- DepartureCountry – страна отправления
- Key – идентификатор
- Value – название
- ArrivalCity – город прибытия
- Key – идентификатор
- Value – название
- ArrivalCountry – страна прибытия
- Key – идентификатор
- Value – название
- DepartureAirport – аэропорт отправления
- Key – идентификатор
- Value – название
- ArrivalAirport – аэропорт прибытия
- Key – идентификатор
- Value – название
- Airline – авиакомпания
- Key – идентификатор
- Value – название
- Aircraft – воздушное судно
- Key – идентификатор
- Value – название
- Flight – рейс
- Key – идентификатор
- Value – название
- DepartureTime – время вылета
- ArrivalTime – время прилета
- TotalTimeOfFlight – полное время перелета
- FlightDetails – детали авиаперелета
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – наименование тарифа
- IsCommission – признак, комиссионная ли услуга
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – наименование
- Tariff – информация о тарифе перелета
- FlightSetting – информация о шаблоне услуги авиаперелета
- ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
- PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- FlightId – идентификатор внешнего перелета
- FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
- Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
- SvKey – ключ типа услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- EndDateTime – дата окончания услуги
- IsHooded – признак скрытая услуга
- IsDeleted – признак удаляемая услуга
- IsNotCalculate – признак не рассчитываемая услуга
- PacketId – ключ пакета
- Index – порядковый номер услуги
- DepartureCity – город отправления
- Key – ключ города
- Value – наименование города
- DepartureCountry – страна отправления
- Key – ключ страны
- Value – наименование страны
- ArrivalCity – город прибытия
- Key – ключ города
- Value – наименование города
- ArrivalCountry – страна прибытия
- Key – ключ страны
- Value – наименование страны
- DepartureAirport – аэропорт прилета
- Key – ключ аэропорта
- Value – наименование аэропорта
- ArrivalAirport – аэропорт прилета
- Key – ключ аэропорта
- Value – наименование аэропорта
- Airline – наименование авиакомпании
- Id – идентификатор авиакомпании
- Value – наименование авиакомпании
- Key – ключ авиакомпании
- Aircraft – воздушное судно
- Key – ключ воздушного судна
- Value – наименование воздушного судна
- Flight – перелет
- Key – ключ перелета
- Value – наименование авиаперелета
- DepartureTime – время отправления
- ArrivalTime – время прилета
- TotalTimeOfFlight – полное время перелета
- FlightDetails – информация об авиаперелете
- Tariff – информация о тарифе перелета
- Key – идентификатор
- Code – код тарифа
- Name – название тарифа
- IsCommission – признак, комиссионная ли услуга
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места / нет мест / под запрос)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – наименование
- Tariff – информация о тарифе перелета
- FlightSetting – внутренняя информация о перелете из программы туров
- ServiceId – идентификатор класса услуги (внутренняя информация из программы туров)
- PatternId – идентификатор паттерна услуги (внутренняя информация из программы туров)
- FlightId – идентификатор перелета (внутренняя информация из программы туров)
- FlightSourceMode – локальный или внешний перелет (внутренняя информация из программы туров)
- Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
- SvKey – ключ типа услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- EndDateTime – дата окончания услуги
- IsHooded – признак скрытая услуга
- IsDeleted – признак удаляемая услуга
- IsNotCalculate – признак не рассчитываемая услуга
- PacketId – ключ пакета
- Index – порядковый номер услуги
- Hotel – отель
- Key – ключ отеля
- Value – наименование отеля
- City – город
- Key – ключ города
- Value – наименование города
- Stars – категория отеля
- Key – ключ категории отеля
- Value – наименование категории отеля
- StarsGlobalCode – глобальный код категории отеля
- Key – глобальный ключ категории отеля
- Value – наименование категории отеля
- Resort – курорт
- Key – ключ курорта
- Value – наименование курорта
- ImageURL – ссылка на лого отеля
- Http – ссылка на сайт отеля
- Description – описание
- Latitude – GPS координаты: географическая широта
- Longitude – GPS координаты: географическая долгота
- Country – страна
- Key – ключ страны
- Value – наименование страны
- HotelDetails – массив данных отель
- HotelRoom – категория номера
- Room – номер
- Key – ключ номера
- Value – наименование номера
- RoomCategory – тип номера
- Key – ключ типа номера
- Value – наименование типа номера
- AccomodationType – тип размещения
- Key – ключ типа размещения
- Value – наименование типа размещения
- AdultCount – количество взрослых
- ChildCount – количество детей
- Pansion – тип питания
- Key – ключ типа питания
- Value – наименование типа питания
- PansionGlobalCode – глобальный код типа питания
- Key – ключ типа питания
- Value – наименование типа питания
- RemoteId – не используется
- Cost – разница в стоимости с самым дешевым вариантом
- QuotaStatus – информация о квоте
- PlacesStatus – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- PartnerId – ключ партнера
- ByPax – цена за человека (true/false)
- Partner – информация о партнере
- Key – идентификатор
- Value – название
- HotelTypes – признаки отелей в дополнительных фильтрах
- Key – ключ
- Value – значение
- RemoteId – не используется
- COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
- AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
- AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
- Id – идентификатор базового шаблона услуги (внутренняя информация из программы туров)
- SvKey – ключ типа услуги
- IsSubCode1 – признак наличия доп. описания 1
- IsSubCode2 – признак наличия доп. описания 2
- IsPartnerBasedOn – признак услуга с приоритетным подбором поставщика
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- BeginDateTime – дата предоставления услуги
- EndDateTime – дата окончания услуги
- IsHooded – признак скрытая услуга
- IsDeleted – признак удаляемая услуга
- IsNotCalculate – признак не рассчитываемая услуга
- PacketId – ключ пакета
- Index – порядковый номер услуги
- DepartureCity – город отправления
- NotRouteServices – массив коллекций немаршрутных услуг (например если две экскурсии будут являться одним элементом массива, то это будет говорить о том, что эти экскурсии можно будет выбрать в выпадающем списке)
- MinCostServicesComposition – массив состав услуг минимальной цены
- Key – ключ
- TemplateId – идентификатор шаблона
- PatternId – идентификатор вкладки
- SettingId – идентификатор услуги
- Value – значение
- ServiceType – тип услуги
- Code – ключ услуги
- SubCode1 – доп. описание 1
- SubCode2 – доп. описание 2
- PacketId – пакет услуги
- PartnerId – партнер услуги
- CountryId – страна услуги
- CityId – город услуги
- Day – день предоставления услуги
- DurationInNight – продолжительность услуги в ночах
- GDSProviderId – ключ провайдера из внешней системы
- COAndSpecialsInfo – формирует, фильтрует и выдаёт списки применённых акций и ценовых блоков
- AppliedCostOffersKeys – коллекция идентификаторов всех применённых ценовых блоков к одной цене
- AppliedSpeciasInfo – коллекция всех применённых акций к одной цене, содержит информацию об условиях, с которыми применилась каждая акция
- COBySubCode – список применённых идентификаторов ценовых блоков по SubCode1 и SubCode2
- SpecialsBySubCode – список применённых акций по SubCode1 и SubCode2
- 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 – подварианты услуг (используется в основном поиске)
- Routes – массив возможных маршрутов в данной программе туров
- IsRemoteHotels – удаленные отели
- SecondaryFiltersResult – результаты доп. фильтров
- TourTypes – типы тура
- Id – ключ типа тура
- Name – название типа тура
- ParentId – родительский элемент типа тура (если есть)
- Type – тип справочника (используется для внутренних целей)
- TourPrograms – информация по каждой турпрограмме
- Key – ключ турпрограммы
- Name – название турпрограммы
- TourUrl – ссылка на тур
- BookingConditions – условия бронирования
- DefaultManagers – менеджер по-умолчанию
- Manager – обозначение менеджера
- Branches – филиал
- DetermineTheBranchOnCity – признак определения филиала в зависимости от города начала поездки
- IsLandOnly – признак только наземное обслуживание
- IsApplyMarginAddCostToRemoteService –
- IsRestrictMultiHotels – ограничивать ли расчёт многоотельных туров категориями отелей
- IsHotelTemplates – есть ли вообще отели в данной турпрограмме
- IsRouteServices – есть ли маршрутные услуги
- IsAviaBooking –
- MultiHotelDelta – Значение отклонения звездности последующих отелей от первого отеля в многоотельном туре. По умолчанию 0. Звездность определяется числом, заданном в поле порядок при печати.
- Rate – валюта тура
- RateId – идентификатор валюты тура
- DateStart – нижняя граница дат заезда по программе тура
- DateEnd – верхняя граница дат заезда по программе тура
- DateList – список дат заездов
- UpdateDate – дата обновления
- Status – статус турпрограммы
- Key – ключ
- Value – значение
- Templates – шаблоны услуг
- $id – шаблон 1
- $id – шаблон 2
- Types – типы тура
- Id – ключ типа тура
- Name – название типа тура
- ParentId – родительский элемент типа тура (если есть)
- Type – тип справочника (используется для внутренних целей)
- LinkingFlightsRules – правила связывания перелетов
- notCombineDifferentAirlineRule – объект не скрещивать авиакомпании
- airlines – авиакомпании
- flightSettings – массив ключей ServiceId, PatternId, FlightId
- enabled – флаг включен/выключен
- checkPlusMinus1CharterRule – объект Отличие номера рейса на 1
- FlightSettingPairs – массив чартеров, для которых это правило будет выполняться
- enabled – флаг включен/выключен
- notCombineDifferentTariffGroupRule – объект не комбинировать рейсы от разных классов перелетов
- FlightSettings – массив ключей ServiceId, PatternId, FlightId
- enabled – флаг включен/выключен
- notCombineDifferentPartnerRule – объект не комбинировать рейсы от разных партнеров
- FlightSettings – массив ключей ServiceId, PatternId, FlightId
- enabled – флаг включен/выключен
- departureCityEqualsArrivalCityRule – объект Город вылета = городу прилета
- FlightSettingPairs – чартеры, для которых это будет выполняться
- enabled – флаг включен/выключен
- combineOnlySpecificChartersRule – объект не комбинировать различные классы перелетов
- settings – массив ключей чартеров CharterIds и ServiceId, PatternId, FlightId
- enabled – флаг включен/выключен
- IsMultiHotel –
- Type – тип справочника (используется для внутренних целей)
- TourDurations – продолжительность тура
- TourDates – список дат заездов в турпрограмме
- HotelCities – город в дополнительных фильтрах
- key – ключ города
- Country – страна
- key – ключ страны
- name – наименование страны
- Code – код страны
- DigitCode – цифровой код
- Alpha2Code –
- Alpha3Code –
- CitizenName – наименование страны
- CitizenNameLat – наименование страны латиницей
- PassportMinDurCheckFrom –
- CheckINN – проверка ИНН
- PassportMinDur –
- INNName – наименование поля ИНН
- Web –
- WebImage – логотип страны
- WebHTTP – сайт
- AnkLang –
- Key – ключ страны
- Type – тип (страна)
- name – наименование города
- Code – код города
- Web –
- RSKey –
- WebImage –
- IsDeparture –
- Key – ключ города
- Type – тип (город)
- HotelResorts – курорты в дополнительных фильтрах
- CountryKey – ключ
- Name – наименование
- NameLat – наименование латиницей
- Key – ключ
- Type – тип (курорт)
- HotelCategories – категории отеля в дополнительных фильтрах
- Name – наименование категории
- PrintNumber – номер для печати
- GlobalCode – глобальный код
- Key – ключ
- Type – тип (категория отеоля)
- Hotels – отели в дополнительных фильтрах
- Country – страна
- key – ключ страны
- name – наименование страны
- Code – код страны
- DigitCode – цифровой код
- Alpha2Code –
- Alpha3Code –
- CitizenName – наименование страны
- CitizenNameLat – наименование страны латиницей
- PassportMinDurCheckFrom –
- CheckINN – проверка ИНН
- PassportMinDur –
- INNName –
- Web –
- WebImage – логотип страны
- WebHTTP – сайт
- AnkLang –
- Key – ключ страны
- Type – тип (страна)
- Country – страна
- Сity – город
- key – ключ города
- Country – страна
- key – ключ страны
- name – наименование страны
- Code – код страны
- DigitCode – цифровой код
- Alpha2Code –
- Alpha3Code –
- CitizenName – наименование страны
- CitizenNameLat – наименование страны латиницей
- PassportMinDurCheckFrom –
- CheckINN – проверка ИНН
- PassportMinDur –
- INNName –
- Web –
- WebImage – логотип страны
- WebHTTP – сайт
- AnkLang –
- Key – ключ страны
- Type – тип (страна)
- name – наименование города
- Code – код города
- Web –
- RSKey –
- WebImage –
- IsDeparture –
- Key – ключ города
- Type – тип (город)
- Resort – курорт
- ResortKey – ключ курорта
- Name – наименование
- Category – категория
- Name – наименование категории
- PrintNumber – ключ для печати
- GlobalCode – глобальный код
- Key – ключ
- Type – тип (категория отеля)
- CategoryKey – ключ категории
- TimeFrom – время с
- TimeTo – время по
- HTTP": сайт
- Stars – категория
- TimeIsEmpty – вышло ли время
- NameLat – наименование латиницей
- Address – адрес
- IsCruise – имеется круиз
- Phone – телефон
- Email – E-mail
- Fax – факс
- Code – код
- Site – сайт
- Descript – описание
- PayHourNote – час оплаты
- EarlyCheckInSurcharge – доплаты за ранний заезд
- LateCheckOutSurcharge – доплата за поздний выезд
- Latitude – GPS координаты: географическая широта (обрабатывается с релиза 15.6)
- Longitude – GPS координаты: географическая долгота (обрабатывается с релиза 15.6)
- DescExcur –
- DescSport –
- DescHealth –
- DescService –
- Key – ключ
- Type – тип (отель)
- Pansions – питание
- Code – код питания
- Name – наименование питания
- NameLat – наименование питания латиницей
- GlobalCode – глобальный код
- Key – ключ
- Type – тип (питание)
- Airlines – авиакомпании в дополнительных фильтрах
- Key – ключ авиакомпании
- Code – код авиакомпании
- ICAO – код ИКАО
- Name – наименование авиакомпании
- NameLat – наименование авиакомпании латиницей
- Type – тип (авиакомпания)
- FlightTariffs – класс перелета в дополнительных фильтрах
- Key – ключ
- Code – код
- Name – наименование
- NameLat – наименование латиницей
- Group – группа
- Type – тип (авиаперелет)
- DepartureCities – города вылета в дополнительных фильтрах
- key – ключ города
- Country – страна
- key – ключ страны
- name – наименование страны
- Code – код страны
- DigitCode – цифровой код
- Alpha2Code –
- Alpha3Code –
- CitizenName – наименование страны
- CitizenNameLat – наименование страны латиницей
- PassportMinDurCheckFrom –
- CheckINN – проверка ИНН
- PassportMinDur –
- INNName –
- Web –
- WebImage – логотип страны
- WebHTTP – сайт
- AnkLang –
- Key – ключ страны
- Type – тип (страна)
- name – наименование города
- Code – код города
- Web –
- RSKey –
- WebImage –
- IsDeparture –
- Key – ключ города
- Type – тип (город)
- DepartureAirports – аэропорты вылета в дополнительных фильтрах
- Key – ключ
- Code – код аэропорта
- Name – наименование аэропорта
- NameLat – наименование аэропорта латиницей
- CityKey – ключ города
- CountryKey – ключ страны
- Letter – присвоенный символд
- Site – сайт
- Type – тип (аэропорт)
- ArrivalCities – города прибытия в дополнительных фильтрах
- key – ключ города
- Country – страна
- key – ключ страны
- name – наименование страны
- Code – код страны
- DigitCode – цифровой код
- Alpha2Code –
- Alpha3Code –
- CitizenName – наименование страны
- CitizenNameLat – наименование страны латиницей
- PassportMinDurCheckFrom –
- CheckINN – проверка ИНН
- PassportMinDur –
- INNName –
- Web –
- WebImage – логотип страны
- WebHTTP – сайт
- AnkLang –
- Key – ключ страны
- Type – тип (страна)
- name – наименование города
- Code – код города
- Web –
- RSKey –
- WebImage –
- IsDeparture –
- Key – ключ города
- Type – тип (город)
- ArrivalAirports – аэропорты прибытия в дополнительных фильтрах
- Key – ключ аэропорта
- Code – код аэропорта
- Name – наименование аэропорта
- NameLat – наименование аэропорта латиницей
- CityKey – ключ города
- CountryKey – ключ страны
- Letter – буква аэропорта
- Site – сайт
- Type – тип (аэропорт)
- HotelTypes – признаки отелей в дополнительных фильтрах
- key – ключ
- name – обозначение
- Type – тип (отель)
- ComplexHotelIds –
- Message – сообщение
- Key – ключ
- Value – значение
- HotelCities – город в дополнительных фильтрах
- TourTypes – типы тура
- Result – результаты поиска
- Формат запроса GET с таблицей цен:
- GET .../TourSearchOwin/TourForWeb/search/matrix?
- Принимаемые параметры ( * – обязательный):
Аналогичны стандартному запросу (simple)
- Возвращаемый результат:
- CellsForMatrix – ячейки таблицы
- Key – ключ
- StartDate – дата начала
- Duration – продолжительность
- DurationInNight – количество ночей
- Cost – цена
- CitiesWithMinimalCosts – города с минимальной ценой
- DepartureCityKey – ключ города отправления
- ArrivalCityKey – ключ города прибытия
- DepartureCityName – наименование города отправления
- ArrivalCityName – наименование города прибытия
- RouteMinimalPrice – минимальная цена маршрута
- TourMinimalAndMaximalCost – минимальная и максимальная цены тура
- MinimalPrice – минимальная цена
- MaximalPrice – максимальная цена
- CellsForMatrix – ячейки таблицы
- Формат запроса GET с минимальной и максимальной ценой:
- GET .../TourSearchOwin/TourForWeb/search/minMaxPrices?
- Принимаемые параметры ( * – обязательный):
Аналогичны стандартному запросу (simple)
- Возвращаемый результат:
- MinimalPrice – минимальная цена
- MaximalPrice – максимальная цена
Проверка дублирующих туристов (CheckDoubleDogovor)
Метод проверяет есть ли дублирующие туристы в существующих путевках. Проверка на дублирование регулируется настройкой Предупреждать при дублировании туристов.
- Формат запроса POST:
- POST .../TourSearchOwin/CheckDoubleDogovor
- Принимаемые параметры ( * – обязательный):
- TourProgramId * – ключ турпрограммы
- BeginDate * – дата начала тура
- Duration * – продолжительность тура
- Currency * – код валюты
- Services * – массив услуг авиаперелетов для получения доплат
- Service * – объект услуга авиаперелет
- ServiceType * – тип услуги
- Code * – код услуги
- SubCode1 * – доп. описание 1 услуги
- SubCode2 * – доп. описание 2 услуги
- Packet * – ключ пакета услуги
- Partner * – ключ партнера услуги
- Day * – день предоставления услуги
- DurationInNight * – продолжительность услуги в ночах
- City * – ключ города
- Country * – страна услуги
- Attributes * – битовая маска атрибутов услуг
- IsRemovable * – (не обрабатывается)
- Type * – тип услуги в путевке (базовая дополнительная)
- IsHooded * – признак скрытая услуга
- IsNotCalculated * – признак не рассчитываемая услуга
- BeginDateTimeString * – дата и время начала услуги
- EndDateTimeString * – дата и время окончания услуги
- TemplateId * – шаблон услуги
- Cost * – цена услуги
- ByPax * – цена за человека
- QuotaStatus * – объект статус квотирования
- PlacesStatus * – статус по квотам (есть места-1 / нет мест-2 / под запрос-4)
- FreePlaces * – количество свободных мест, если удовлетворяются условия, заданные в настройке "Мало" и включена настройка "Отображать числовое значение оставшихся мест". Иначе возвращается 0. Если в данном параметре 0, то руководствоваться следует значением, полученном в параметре PlacesStatus.
- IsFewPlaces * – выполнены ли условия, заданные в настройке "Мало": true – если заданы условия количества мест "Мало" и данные условия выполнены, false – если не заданы условия количества мест "Мало" или они заданы, но не выполнены.
- Index * – индекс услуги
- IsRoute * – признак маршрутная услуга
- ServiceTemplateIndex * – индекс шаблона услуги
- RemoteId * – информация об услуге во внешней системе
- IsCommission * – признак, комиссионная ли услуга
- BaseFlightsParams * – параметры рассчитанных авиаперелетов
- CityArrival * – ключ города прибытия прямого перелета
- FlightCode * – ключ прямого авиаперелета
- TariffKey * – ключ тарифа прямого авиаперелета
- PartnerId * – ключ партнера прямого авиаперелета
- TouristNumbersList * – массив туристов, привязанных к услуге
- Service * – объект услуга авиаперелет
- Tourists * – массив туристов
- IsMain * – главный турист
- Number * – порядковый номер туриста
- AgeType * – тип туриста (0 – взрослый, 1 – ребенок, 2 – инфант)
- MaleFemaleSex * – пол (0 – мужской, 1 – женский)
- FirstName * – имя (лат)
- LastName * – фамилия (лат)
- Patronymic * – отчество (лат)
- FirstNameRus * – имя (рус)
- LastNameRus * – фамилия (рус)
- PatronymicRus * – отчество (рус)
- InternationalPassportSeries * – серия загранпаспорта
- InternationalPassportNumber * – номер загранпаспорта
- InternationalPassportDateOfIssue * – дата выдачи загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfIssueString * – дата выдачи загранпаспорта в строковом формате (DD.MM.YYYY)
- InternationalPassportDateOfExpiry * – дата окончания действия загранпаспорта (YYYY-MM-DDThh:mm:ssz)
- InternationalPassportDateOfExpiryString * – дата окончания действия загранпаспорта в строковом формате (DD.MM.YYYY)
- internationalPassportByWhom * – кем выдан загранпаспорт
- PassportSeries * – серия паспорта
- PassportNumber * – номер паспорта
- PassportDateOfIssue * – дата выдачи паспорта (YYYY-MM-DDThh:mm:ssz)
- PassportDateOfIssueString * – дата выдачи паспорта в строковом формате (DD.MM.YYYY)
- PassportByWhom * – кем выдан паспорт
- Citizenship * – название страны
- Phone * – телефон
- Email * – e-mail
- BirthDay * – дата рождения (YYYY-MM-DDThh:mm:ssz)
- BirthDayString * – дата рождения в строковом формате (DD.MM.YYYY)
- BirthPlace * – место рождения
- CitizenID * – ID туриста (задается в карточке постоянного клиента)
- Age * – количество полных лет на момент окончания тура
- TechnicalProblemsDuringUpdateFlights * – технические проблемы при обновлении рейсов
- TimeLimit * – лимит времени
- CountryKey * – ключ страны
- OwnerId * – ключ ведущего менеджера (начиная с релиза 15.3). Если 0, то берется по умолчанию. Если по умолчанию не указан, то берется создатель тура.
- Day * – день Может быть с пустым значением
- Day2 * – дня Может быть с пустым значением
- Days * – дней Может быть с пустым значением
- Night * – ночь Может быть с пустым значением
- Night2 * – ночи Может быть с пустым значением
- Nights * – ночей Может быть с пустым значением
- adultsCountOverServiceLimit * – Количество взрослых туристов превышает лимит услуги Может быть с пустым значением
- at * – на (перевод) Может быть с пустым значением
- incorrectChildrenInf * – Возраст детей не соответствует допустимому в выбранном варианте размещения (см. Услуги: Проживание) Может быть с пустым значением
- Возвращаемый результат:
- Errors – описание ошибки
- Warnings – предупреждение
- States – статус
- IsValid – результат проверки подключения (true/false)
Дополнительные методы
Выгрузка измененных турпрограмм (TourProgram) начиная с релиза 15.3
Метод производит выгрузку измененных турпрограмм, в которых были сделаны изменения с указанной даты и времени и повлияли на маршруты в турпрограмме. К таким изменениям относятся изменения страны и города начала поездки, страны и города по туру, типа тура. Изменения цен по услугам не приводят к обновлению турпрограмме, такие турпрограммы в ответе не будут указаны. Турпрограммы, по которым статус Доступен для продажи сменился на другой за период, указанный в запросе, в ответе тоже не будут указаны.
- Формат запроса:
- GET .../TourSearchOwin/TourProgram?
- Принимаемые параметры GET запроса ( * – обязательный):
- fromDateTime – дата (в формате dd.MM.yyyy HH:mm:ss), начиная с которой будут выгружаться изменения,
- Возвращаемый результат:
- Key – ключ программы туров
- Name – название программы туров
- UpdateDate – дата последнего изменения программы туров (или связанных с ней компонентов)
- routes – массив возможных маршрутов в данной программе туров
- departureCountryKey – страна начала поездки (для каждой страны начала поездки в одной программе тура будет отдельный маршрут)
- departureCityKey – город начала поездки (для каждого города начала поездки в одной программе тура будет отдельный маршрут)
- destinationCountryKeys – страны по туру (если в туре несколько услуг класса отель и они в разных странах, то будут возвращаться все страны отелей)
- destinationCityKeys – города по туру (если в туре отели в нескольких городах, то будут возвращаться все города отелей)
- tourTypeKeys – типы туров для данной программы туров
Проверка построения маршрутов турпрограммы (CheckTourProgram)
Метод производит построение маршрутов турпрограмм (вызывается из проверки тура). Метод проверяет маршруты по турпрограммам с любым статусом (не только по статусу Доступен для подажи).
- Формат запроса:
- GET .../TourSearchOwin/CheckTourProgram?
- Принимаемые параметры GET запроса ( * – обязательный):
- tourKey – ключ турпрограммы
- Возвращаемый результат:
- Message – сообщение Начинаем строить маршрут.
- Message – сообщение Маршрутов по данной программе тура построилось – количество
- Message – сообщение Построено каркасов маршрутов (без конкретных отелей) – количество
Получение разметки формы для новой формы быстрого поиска (GetJavascriptFile)
Метод получает разметку формы для новой формы быстрого поиска.
- Формат запроса:
- GET .../TourSearchOwin/GetJavascriptFile/Get?
- Принимаемые параметры GET запроса ( * – обязательный):
- name – имя файла
- Возвращаемый результат:
- полученный файл
Проверка подключения к внешним системам (GDSCheckConnection)
Метод производит проверку подключения к внешней системе.
- Формат запроса:
- POST .../TourSearchOwin/GDSCheckConnection?
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- adapterTypeName – адаптер
- id – ключ адаптера
- apiAddress – api-адрес
- settings – набор настроек (у каждого адаптера индивидуальный)
- Key – _Login
- Value – логин
- Key – _Password
- Value – пароль
- Key – _UserID
- Value – ID пользователя
- licenseDateExpiry – дата окончания лицензии
- Возвращаемый результат:
- Errors – описание ошибки
- Warnings – предупреждение
- States – статус
- IsValid – результат проверки подключения (true/false)
Подтверждения оплаты полиса в ЕВРОИНС
Для подтверждения оплаты метод будет обращаться к внешним службам для подтверждения платежа.
Страховая компания ЕВРОИНС
- Формат запроса:
- POST .../TourSearchOwin/EuroinsConfirmPay
- Принимаемые параметры headers ( * – обязательный):
- Content-Type * – application/json
- Принимаемые параметры POST запроса ( * – обязательный):
- policyId * – ID полиса
- code * – код партнера
- Возвращаемый результат:
- success: true – подтверждено (код 200)
- error – описание ошибки (код 400)
Приложения
Приложение 1: параметры услуги (ServiceType, Code, SubCode1, SubCode2)
Параметры ServiceType – это ключ типа услуги, Сode – ключ услуги, SubCode1 и SubCode2, возвращаемые при API-запросах – это параметры дополнительных описаний двух типов, индивидуальных для каждой услуги.
Ключ типа услуги (ServiceType) | Наименование типа услуги | Ключ услуги (Code) | Доп. описание 1 (SubCode1) | Таблица БД со значениями SubCode1 | Доп. описание 2 (SubCode2) | Таблица БД со значениями SubCode2 |
---|---|---|---|---|---|---|
1 | Авиаперелет | индивидуальный ключ услуги | Тариф | AirService | отсутствует | отсутствует |
2 | Трансфер | индивидуальный ключ услуги | Вид транспорта | Transport | отсутствует | отсутствует |
3 | Отель/Круиз | индивидуальный ключ услуги | Вид проживания (Тип номера + Категория номера + Тип размещения) | HotelRooms (Rooms + RoomCategory + Accmdmentype) | Тип питания | Pansion |
4 | Экскурсия | индивидуальный ключ услуги | Вид транспорта | Transport | отсутствует | отсутствует |
5 | Виза | индивидуальный ключ услуги | отсутствует | отсутствует | отсутствует | отсутствует |
6 | Страховка | индивидуальный ключ услуги | Доп. описание 1 | AddDescript1 | Доп. описание 2 | AddDescript2 |
8 | Доп услуга в отеле/круизе | индивидуальный ключ услуги | Вид проживания (Тип номера + Категория номера + Тип размещения) | HotelRooms (Rooms + RoomCategory + Accmdmentype) | Доп. описание 2 | AddDescript2 |
14 | Автобусный переезд | индивидуальный ключ услуги | Место посадки | BusTransferPoints | Вид транспорта | Transport |
99 | Любая пользовательская услуга | индивидуальный ключ услуги | Доп. описание 1 | AddDescript1 | Доп. описание 2 | AddDescript2 |