Мастер-Тур:Работа с методами веб-сервисов — различия между версиями
[непроверенная версия] | [непроверенная версия] |
(→TourML) |
(→TourML) |
||
Строка 678: | Строка 678: | ||
===TourML=== | ===TourML=== | ||
− | Данный модуль предназначен для работ по выгрузке рассчитанных цен и созданию путевок - [[Web-сервисы: | + | Данный модуль предназначен для работ по выгрузке рассчитанных цен и созданию путевок - [[Web-сервисы: Сервис TourML|TourML]]. |
====Метод CancelAgreement==== | ====Метод CancelAgreement==== |
Версия 09:52, 21 июля 2016
Статья находится на стадии разработки.
Более ранние версии: |
Содержание
- 1 Введение
- 2 Список существующих веб-сервисов
- 2.1 Поисковый сервис (Search)
- 2.2 Сервис по оплате путевок внешними системами (сервис для интеграции с платежной системой, прием наличных через платежный терминал, FinanceService)
- 2.3 Сервис по работе с курсами валют (Rates)
- 2.4 Сервис по работе с заявками (BookingManager)
- 2.5 Мастер-Web: Способы аутентификации
- 2.6 Сервис для отправки запроса на аннуляцию путевки (AnnulateService)
- 2.7 WsAuthorization
- 2.8 Сервис по проверке наличия мест (CheckQuotesService)
- 2.9 Сервис "Бронирование индивидуального тура" (ComplexTourService)
- 2.10 Сервис для шифрования строковых значений (EncryptionService)
- 2.11 Сервис по загрузке поисковых фильтров (FilterBindingService)
- 2.12 HotelInfoService
- 2.13 CalculateReservation
- 2.14 ServiceProvider
- 2.15 Сервис для получения информации по турам (FullTourInfoService)
- 2.16 Сервис для работы с пользователями системы (UserManagementService)
- 2.16.1 Метод AgencyRegistration
- 2.16.2 Метод PersonRegistration
- 2.16.3 Метод UniqueLoginCheck
- 2.16.4 Метод GetUserKeyAndType
- 2.16.5 Метод UserAuthorization
- 2.16.6 Метод PasswordRecovery
- 2.16.7 Метод GetAgencyInfo
- 2.16.8 Метод GetPersonInfo
- 2.16.9 Метод ModifyAgencyInfo
- 2.16.10 Метод ModifyPersonInfo
- 2.17 MasterTourFacade
- 2.18 TourML
- 2.18.1 Метод CancelAgreement
- 2.18.2 Метод CheckBooking
- 2.18.3 Метод CreateBooking
- 2.18.4 Метод GetAgencies
- 2.18.5 Метод GetAgreementCredentials
- 2.18.6 Метод GetAgreementsByCode
- 2.18.7 Метод GetAgreementsByKeys
- 2.18.8 Метод GetAgreementsByNumber
- 2.18.9 Метод GetBookingInfo
- 2.18.10 Метод GetCountries
- 2.18.11 Метод GetCourse
- 2.18.12 Метод GetFlightQuotes
- 2.18.13 Метод GetHotelKeys
- 2.18.14 Метод GetHotelQuotes
- 2.18.15 Метод GetInfo
- 2.18.16 Метод GetNationalCourse
- 2.18.17 Метод GetNationalRateCode
- 2.18.18 Метод GetReferences
- 2.18.19 Метод GetSPOArrayByKeyCompressed
- 2.18.20 Метод GetSPOByKey
- 2.18.21 Метод GetSPOByKey_DC
- 2.18.22 Метод GetSPOByKeyCompressed
- 2.18.23 Метод GetSPOByKeyCompressed_DC
- 2.18.24 Метод GetSPOPageByKey
- 2.18.25 Метод GetSPOPageByKeyCompressed
- 2.18.26 Метод GetSimpleDogovorsBronni
- 2.18.27 Метод GetSimpleDogovorsByCreateDates
- 2.18.28 Метод GetStopSalesAndQuotes
- 2.18.29 Метод GetStopSalesAndQuotes2
- 2.18.30 Метод GetStopSalesAndQuotesByHotels
- 2.18.31 Метод GetStopSalesAndQuotesCompressed
- 2.18.32 Метод GetValidTourList
- 2.18.33 Метод GetValidTourListCompressed
- 2.18.34 Метод GetValidTourListFrom
- 2.18.35 Метод GetValidTourListFrom_DC
- 2.18.36 Метод GetValidTourListFromCompressed
- 2.18.37 Метод GetVersion
- 2.18.38 Метод Info
- 2.18.39 Метод ValidatePriceServices
- 2.19 AddCostLogic
- 2.20 AdminService
- 2.21 ApplicationsLog
- 2.22 CalculatePriceListDynamic
- 2.23 DictionaryService
- 2.24 QuotaLogic
- 2.25 TourMarginLogic
- 2.26 UserService
Введение
Обзор
В данной статье собрана краткая информация о существующих web-сервисах, используемых в ПК "Мастер-Тур"/"Мастер-Web".
Установка
Для установки Веб-сервисов нужно создать директорию сервиса (название директории можно найти в соответствующем разделе или в статьях, ссылка на которые есть в соответствующих разделах) в каталоге c:/inetpub/wwwroot/MasterWeb и выложить туда распакованные файлы из архива, содержащего файлы веб-сервиса. Название архива для каждого из веб-сервисов можно найти в соответствующем разделе или в статьях, ссылка на которые есть в соответствующих разделах.
В управлении IIS необходимо создать виртуальный каталог для этой папки.
Создание виртуального каталога
По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:
- 1. Зайти в Пуск (Start) – Настройки (Settings) – Панель управления (Control Panel)
- 2. В открывшемся окне выбрать Администрирование (Administrative Tools)
- 3. Запустить Internet Information Services (IIS) Manager
- 4. В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и зайти в Свойства (Properties)
- 5. В открывшемся окне, в закладке Directory нужно нажать кнопку «Create», а затем кнопку «ОК»
Подключение к базе данных ПК «Мастер-Тур»
В файле web.config, расположенном в папке WebServices пропишите необходимые параметры подключения (курсивом выделены значения, которые необходимо ввести). Строка подключения к базе данных ПК «Мастер-Тур»:
- 1. <add key = "connectionString" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-тур;Initial Catalog=название базы данных ПК Мастер-тур;User ID=логин пользователя ПК Мастер-тур;Password=пароль пользователя ПК Мастер-тур"/>
- 2. <add key = "connectionStringShort" value = "Data Source=ip-адрес сервера базы данных ПК Мастер-Тур;Initial Catalog=название базы данных ПК Мастер-Тур;"/>
Список существующих веб-сервисов
Поисковый сервис (Search)
Данный модуль предназначен для осуществления поиска и подбора туров из внешних приложений - Поисковый сервис.
Архив для установки - mw-megatecwebservices-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки WebServices.
После установки «Поисковый сервис» доступен по адресу http://ip-адрес сервера Мастер-Веб/WebServices/Search.asmx.
Метод Search.DoSearch
Метод Search.DoSearch позволяет осуществлять поиск туров - Метод Search.DoSearch
Метод DoSearch обладает параметрами:
- SearchFilter filter – объект класса, описывающего критерии подбора тура
- int pageNumber – порядковый номер запрашиваемой страницы
- SearchParams searchParams – объект класса, описывающего параметры подбора тура
Сервис возвращает объект класса SearchResult, содержащий коллекцию объектов класса SearchResultItem.
Сервис по оплате путевок внешними системами (сервис для интеграции с платежной системой, прием наличных через платежный терминал, FinanceService)
Данный модуль предназначен для проверки заявки и проведения платежа через платежную систему в базу туроператора(Сервис для интеграции с платежной системой). Модуль совместим со следующими платежными системами:
- TourPay
- Контакт
- Лидер
Архив для установки - mw-finance-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки Finance.
После установки «Сервис по оплате путевок внешними системами» доступен по адресу http://ip-адрес сервера Мастер-Веб/Finance/FinanceService.asmx.
Метод GetUserToken
Метод GetUserToken возвращает строку - идентификатор аутентификации, который используется для подтверждения авторизации при вызове методов веб-сервисов - Метод GetUserToken.
Сигнатура метода - public TokenResult GetUserToken(string userLogin, string userPassword)
Принимаемые методом параметры:
- userLogin - имя пользователя;
- userPassword - пароль.
Возвращаемые значения - метод возвращает результат своей работы в виде класса TokenResult. Корректность результата проверяется значением поля ErrorCode данного класса:
- 0 - результат корректный;
- 2 – внутренняя ошибка;
- 5 - неправильный логин или пароль.
Описание класса приведено ниже:
public class TokenResult { public int ErrorCode; public string Token; }
где
- ErrorCode - код результата;
- Token - идентификатор аутентификации.
Метод CheckReservation
Метод CheckReservation предназначен для проверки наличия заявки в базе данных и определения ее стоимости - Метод CheckReservation.
Сигнатура метода - public AmountSum CheckReservation(string userToken, string dgCode)
Принимаемые методом параметры:
- userToken - идентификатор аутентификации, полученный при вызове метода GetUserToken;
- dgCode - строковая переменная, представляющая собой код проверяемой путевки.
Возвращаемые значения - метод возвращает результат своей работы в виде класса AmountSum. Корректность результата проверяется значением поля ErrorCode данного класса:
- 0 – результат корректный, в полях возвращены корректные значения;
- 1 – заявка не найдена в БД;
- 2 – внутренняя ошибка;
- 3 - заявка была аннулирована;
- 4 - путевка уже оплачена;
- 6 - некорректный или устаревший идентификатор аутентификации(token).
Ниже приводится описание класса.
public class AmountSum { public double Amount public string RateCode public double NationalCurrencyPrice public string NationalRateCode public int ErrorCode public int FilialKey public DateTime BeginTourDate public DateTime EndTourDate }
- Amount - сумма к оплате в валюте тура;
- RateCode - iso-код валюты тура;
- NationalCurrencyPrice - сумма к оплате в национальной валюте;
- NationalRateCode - iso-код национальной валюты;
- ErrorCode - код результата;
- FilialKey - ключ филиала, который создал заявку;
- BeginTourDate - дата начала тура;
- EndTourDate - дата окончания тура.
Метод CreatePayment
Метод CreatePayment предназначен для создания платежа по путевке в финансовом блоке ПК Мастер-Тур - Метод CreatePayment.
Сигнатура метода - public int CreatePayment(string userToken, DateTime date, Decimal sum, string currencyIsoCode, string reservationCode, string paymentId)
Принимаемые методом параметры:
- userToken - идентификатор аутентифкации;
- date – дата проведения платежа;
- sum – сумма платежа;
- currencyIsoCode – ISO-код валюты, в которой осуществляется платеж;
- reservationCode – номер путевки;
- paymentId – идентификатор платежа во внешней системе.
Возвращаемые значения - метод возвращает целочисленное значение обозначающее результат выполнения операции:
- 0 – операция выполнена успешно, платеж проведен;
- 1 – заявка не найдена в БД;
- 2 – внутренняя ошибка при создании платежа;
- 3 - заявка была аннулирована;
- 4 - путевка уже оплачена;
- 6 - некорректный или устаревший идентификатор аутентификации(token).
При этом в БД создается платеж по выбранной путевке.
Метод GetReservationInfo
Данный метод предназначен для выгрузки данных по путевке из базы данных ПК «Мастер-Тур» для проведения платежа.
Сигнатура метода - public ReservationInformationResult GetReservationInfo(string userToken, string dgCode)
Принимаемые методом параметры:
- userToken - идентификатор аутентификации, полученный при вызове метода GetUserToken;
- dgCode - строковая переменная, представляющая собой код проверяемой путевки.
Возвращаемые значения - метод возвращает результат своей работы в виде класса ReservationInformationResult. Корректность результата проверяется значением поля ResultCode данного класса:
- 0 – результат корректный, в полях возвращены корректные значения;
- 2 – внутренняя ошибка;
- 5 - некорректный логин или пароль;
- 6 - некорректный или устаревший идентификатор аутентификации(token).
Ниже приводится описание класса.
public class ReservationInformationResult { public double Price { get; set; } public double PriceNational { get; set; } public double DiscountSum { get; set; } public double DiscountSumNational { get; set; } public double PriceToPay { get; set; } public double PriceToPayNational { get; set; } public string IsoRateCode { get; set; } public string IsoRateCodeNational { get; set; } public int ResultCode { get; set; } public int? FilialKey { get; set; } public DateTime TourDate { get; set; } public DateTime TourDateEnd { get; set; } public string CountryName { get; set; } public string TourName { get; set; } public List<TouristFinanceInfo> ReservationTourists { get; set; } public List<string> ReservationServices { get; set; } }
- Price - полная стоимость тура (в валюте тура);
- PriceNational - полная стоимость тура (в нац. валюте);
- DiscountSum - скидка по путевке (в валюте тура);
- DiscountSumNational - скидка по путевке (в нац. валюте);
- PriceToPay - cумма к оплате в валюте тура (PriceToPay = Price - DiscountSum);
- PriceToPayNational - cумма к оплате в национальной валюте;
- intIsoRateCode - iso-код валюты тура;
- IsoRateCodeNational - iso-код национальной валюты;
- ResultCode - код результата;
- FilialKey - ключ филиала, который создал заявку;
- TourDate - дата начала тура;
- TourDateEnd - дата окончания тура;
- CountryName - название страны на русском языке;
- ReservationTourist - Массив туристов по путевке;
- FullName - ФИО туриста на русском языке;
- FullNameLat - имя туриста на английском языке;
- BirthDate - дата рождения туриста;
- IsMain - параметр, показывающий главного туриста;
- ReservationServices - массив услуг в путевке.
Сервис по работе с курсами валют (Rates)
Данный модуль предназначен для работы с курсами валют - Сервис по работе с курсами валют.
Архив для установки - mw-megatecwebservices-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки WebServices.
После установки «Сервис по работе с курсами валют» доступен по адресу http://ip- адрес сервера Мастер-Веб/WebServices/Rates.asmx.
Метод GetCourse
Метод GetCourse служит для получения кросс-курса валют - Метод GetCourse.
Для получения результата необходимо передать следующие значения:
- «rateCodeFrom» - код валюты, кросс-курс которой нужно вывести
- «rateCodeTo» - код валюты 2
- «exchangeDate» - дата, на которую необходимо взять курсы валют.
Результаты возвращаются в виде xml-файлов.
Метод Exchange
Метод Exchange служит для пересчета стоимости из одной валюты в другую - Метод Exchange.
Для получения результата необходимо передать следующие значения:
- «cost» - сумма или стоимость, которую нужно пересчитать
- «rateCodeFrom» - код валюты, из которой нужно произвести конвертацию
- «rateCodeTo» - код валюты, в которую необходимо конвертировать стоимость
- «exchangeDate» - дата, на которую необходимо взять курсы валют.
Результаты возвращаются в виде xml-файлов.
Метод GetNationalCourse
Метод GetNationalCourse служит для получения курса валюты - Метод GetNationalCourse.
Для получения результата необходимо передать следующие значения:
- «rateCode - код валюты, курс которой нужно получить
- «exchangeDate» - дата, на которую необходимо взять курс валют.
Результаты возвращаются в виде xml-файлов.
Метод GetNationalCourseToday
Метод GetNationalCourseToday служит для получения курса валюты на текущую дату - Метод GetNationalCourseToday.
Для получения результата необходимо передать следующие значения:
- «rateCode - код валюты, курс которой нужно получить
Результаты возвращаются в виде xml-файлов.
Метод GetNationalRateCode
Метод GetNationalRateCode служит для получения кода национальной валюты - Метод GetNationalRateCode.
Данный метод не принимает параметров.
Результаты возвращаются в виде xml-файлов.
Сервис по работе с заявками (BookingManager)
Данный модуль предназначен для работы с заявками, в которых были произведены изменения - Сервис по работе с заявками.
Архив для установки - mw-megatecwebservices-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки WebServices.
После установки «Сервис по работе с заявками» доступен по адресу http://ip- адрес сервера Мастер-Веб/WebServices/BookingManager.asmx.
Метод GetChangedBookings
Метод GetChangedBookings служит для формирования списка путевок, по которым были произведены изменения за заданный период - Метод GetChangedBookings.
Сигнатура метода - List<SimpleDogovor> GetChangedBookings(DateTime dateFrom, DateTime dateTo)
Параметры, принимаемые методом:
- dateFrom - дата, начиная с которой ищутся изменения;
- dateTo - дата, заканчивая которой ищутся изменения.
Возвращаемое значение - коллекция путевок представленных классом SimpleDogovor
Метод VerifyBookingChanges
Метод VerifyBookingChanges служит для определения, были ли произведены изменения по конкретной путевке Метод VerifyBookingChanges.
Сигнатура метода - bool VerifyBookingChanges(int dogovorKey, DateTime dateFrom, DateTime dateTo)
Параметры, принимаемые методом:
- dogovorKey – ключ путевки, по которой определяется наличие изменений;
- dateFrom - дата, начиная с которой ищутся изменения;
- dateTo - дата, заканчивая которой ищутся изменения.
Возвращаемое значение - булевая переменная, определяющая, были ли произведены изменения по путевке за указанный период.
Мастер-Web: Способы аутентификации
Аутентификация – это процедура, проверяющая, имеет ли пользователь с предъявленным идентификатором право на доступ к ресурсу - Способы аутентификации.
Метод Authenticate
При аутентификации через Web-сервис используется метод Authenticate (Метод Authenticate). В этом случае передаются параметры:
- userName – логин;
- password – пароль.
При проверке соответствия имени и пароля пользователя возвращается булевское значение: true – в случае успешной аутентификации, в противном случае false.
Сервис для отправки запроса на аннуляцию путевки (AnnulateService)
Данный модуль предназначен для отправки запроса на аннуляцию путевки из сторонних приложений - Сервис для отправки запроса на аннуляцию путевки.
Архив для установки - mw-annulation-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки Annulation.
После установки «Сервис для отправки запроса на аннуляцию путевки» доступен по адресу http://ip- адрес сервера Мастер-Веб/Annulation/Annulation.asmx.
Метод SendAnnulate
Метод SendAnnulate предоставляет возможность отправлять заявку на аннуляцию путевки от имени on-line пользователя указанного в параметрах вызова метода - Метод SendAnnulate.
Сигнатура метода - string SendAnnulate(string code, string login, string password)
Параметры, принимаемые методом:
- code - строковая переменная, представляющая собой код предлагаемой к аннуляции путевки;
- login - строковая переменная, представляющая собой логин пользователя, от имени которого отправляется заявка на аннуляцию;
- password - строковая переменная, представляющая собой пароль для доступа в систему on-line бронирования пользователя, от имени которого отправляется заявка на аннуляцию.
Возвращаемые значения - метод возвращает результат своей работы в виде строкового значения. Возможны следующие значения:
- Вам запретили доступ к системе.
- Вы ввели неправильный пароль \ Попробуйте еще раз. Обратите внимание, не включен ли у Вас Caps Lock \ и на каком языке Вы вводите пароль.
- Договор с туроператором не заключен или его действие закончилось!
- Путевка {0} не найдена!
- Неверно задан пользователь!
- У указанного пользователя нет прав на аннуляцию заданной путевки!
- Запрос на аннулирование заявки {0} по стране {1} успешно отослан.
- Ошибка. Не удалось отправить запрос.
WsAuthorization
Данный вспомогательный модуль предназначен для авторизации пользователей в распределенном поиске - Распределенный поиск.
Сервис по проверке наличия мест (CheckQuotesService)
Модуль «Сервис проверки наличия мест» предназначен как для проверки квот на одну конкретную услугу, так и на совокупность услуг - Сервис по проверке наличия мест.
Архив для установки - mw-ws-checkquotes-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки CheckQuotes.
После установки «Сервис проверки наличия мест» доступен по адресу: http://ip- адрес сервера Мастер-Веб/CheckQuotes/CheckQuotesService.asmx.
Метод CheckQuotes
Метод позволяет осуществить проверку квот на совокупность услуг - Метод CheckQuotes
Сигнатура метода - public QuotaResult.Status CheckQuotes(List<Megatec.Travel.Entities.Service>services, DateTime tourDate, int tourDuration, int currentUserKey)
Параметры, принимаемые методом:
- services - коллекция услуг, на которые необходимо проверить квоты
- tourDate - дата начала тура
- tourDuration - продолжительность тура
- currentUserKey - ключ агентства в таблице партнеров
Сервис "Бронирование индивидуального тура" (ComplexTourService)
Данный экран предназначен для бронирования в ПК Мастер-Web сложных туров, т.е. туров включающих в себя нестандартный набор услуг, который нельзя рассчитать и забронировать, используя стандартный интерфейс ПК «Мастер-Web» - Бронирование индивидуального тура.
- Установка экрана «Бронирование индивидуального тура» включает в себя следующие этапы:
- Установка доп.экрана «Бронирование индивидуального тура»
- Установка web-сервиса «Сервис бронирования»
- Установка web-сервиса «Сервис проверки наличия мест»
- Установка web-сервиса «Сложный тур»
- Настройка конфигурационного файла web.config основного приложения и конфигурационных файлов веб-сервисов
Сервис для шифрования строковых значений (EncryptionService)
Данный модуль предназначен для шифрования и дешифрации строковых значений - Сервис для шифрования строковых значений.
Архив для установки - mw-encryptionservice-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки Annulation.
После установки «Сервис для шифрования строковых значений» доступен по адресу: http://ip- адрес сервера Мастер-Веб/EncryptionService/EncryptionService.asmx.
Метод EncryptString
Данный метод предоставляет возможность шифрации строкового значения методом, используемым в продуктах Мастер-Тур и Мастер-Веб - Метод EncryptString.
Сигнатура метода string EncryptString(string source)
Параметры, принимаемые методом:
- source - строковое значение, подвергаемое шифрование
Возвращаемое значение - метод возвращает строку, представляющую собой зашифрованный вид полученного на вход значения.
Метод DecryptString
Данный метод предоставляет возможность дешифровки строкового значения, ранее зашифрованного методом, используемым в продуктах Мастер-Тур и Мастер-Веб - Метод DecryptString.
Сигнатура метода - string DecryptString(string source)
Параметры, принимаемые методом:
- source - строковое значение подвергаемое дешифровке
Возвращаемое значение - метод возвращает строку, представляющую собой исходное значение полученной на вход зашифрованной строки.
Сервис по загрузке поисковых фильтров (FilterBindingService)
Данный модуль предназначен для формирования поискового фильтра, т.е. позволяет при изменении какого-либо из критериев отбора туров определить возможные значения зависимых от него критериев - Сервис по загрузке поисковых фильтров.
Архив для установки - mw-filterbinding-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки FilterBinding.
После установки «Сервис по загрузке поисковых фильтров» доступен по адресу:
- http://ip- адрес сервера Мастер-Веб/FilterBinding/FilterBindingService.asmx (обращение к сервису происходит путем передачи ему SOAP-сообщения)
- http://ip- адрес сервера Мастер-Веб/FilterBinding/FilterBindingScriptService.asmx (обращение к сервису происходит из javascript с передачей параметров в формате JSON)
Метод GetFilter
Сигнатура метода - public HybridArrayDictionary<SchemeNodeBase, IList> GetFilter(List<SchemeNodeBase> nodes, SchemeNode changedNode, BindType bindType)
HotelInfoService
Данный модуль предназначен для получения информации по отелю - HotelInfoService.
CalculateReservation
ServiceProvider
Сервис для получения информации по турам (FullTourInfoService)
Данный модуль предназначен для получения информации по списку рассчитанных туров, их типам, а также детализации рассчитанных цен - Сервис для получения информации по турам.
Архив для установки - mw-ws-tourinfo-2007.2.XX.XXXX.zip.
В управлении IIS необходимо создать виртуальный каталог для папки TourInfo.
После установки «Сервис для получения информации по турам» доступен по адресу: http://ip- адрес сервера Мастер-Веб/TourInfo/FullTourInfoService.asmx.
Метод GetTourInfo
Параметры, принимаемые методом:
- token
- tourKey - идентификационный номер тура
- beginDate Значение - дата начиная с которой выдавать информацию, в формате «yyyy-MM-dd»
Возвращаемое значение:
- ExtendedTourInfo
- TourID – идентификационный номер тура
- TourPriceID - идентификационный номер стоимости тура
- Name – название тура
- TypeID – идентификационный номер типа тура
- URL – url страницы с описанием тура
- CreatedDate – дата создания тура (формат «yyyy-MM-ddThh:mm:ss»)
- ValidFrom – действителен с
- ValidTo – дейстивтелен по
- Code – код тура
- CountryID – идентификационный номер страны
- TourByDateInfos
- TourByDateInfo
- Date – дата заезда
- TourCosts
- TourCosts
- TourCost
- TourCosts
- AccomodationType – тип размещения
- Cost – стоимость
- Currency – валюта
- ServicesCosts
- ServiceCost
- ServiceName – назавние услуги
- Cost – стоимость услуги
- Currency – валюта
- TransportKey – ключ транспорта (-1, если услуга не подразумевает схему размещения в транспорте)
- ServiceID – идентификационный номер услуги
- ServiceCost
Метод GetBusyBusPlan
Параметры, принимаемые методом:
- token
- tourKey - идентификационный номер тура
- tourDate - дата начиная с которой выдавать информацию, в формате «yyyy-MM-dd»
Возвращаемое значение:
- BusPlan
- TransportKey – идентификационный номер траспортного средства
- Title – название транспортного средства
- AreasCount – количество зон (автобусов)
- RowsCount – количество рядов
- ColumnsCount – количество мест в ряду
- Cells
- BusPlanCell
- Row – горизонтальная составляющая координаты места
- Column – вертикальная составляющая координаты места
- Area – зона (номер автобуса)
- BusPlanCellType – тип места (None, Comment - комментарий, Gangway – проход, Seat – пассажирское место)
- IsUsed – true – место занято, иначе - false
- BusPlanCell
Метод GetTours
Параметры, принимаемые методом:
- token
- beginDate - дата, начиная с которой выбирать туры (дата создания тура), в формате «yyyy-MM-dd»
Возвращаемое значение:
- ArrayOfTourInfo
- TourInfo
- TourID – идентификационный номер тура
- TourPriceID - идентификационный номер стоимости тура
- Name – название тура
- TypeID – идентификационный номер типа тура
- URL – url страницы с описанием тура
- CreatedDate – дата создания тура (формат «yyyy-MM-ddThh:mm:ss»)
- ValidFrom – действителен с
- ValidTo – дейстивтелен по
- Code – код тура
- CountryID – идентификационный номер страны
- TourInfo
Метод GetTourTypes
Параметры, принимаемые методом:
- token
Возвращаемое значение:
- ArrayOfTourType
- TourType
- TourTypeID – идентификационный номер типа тура
- Name – название типа тура
- TourType
Метод GetCountries
Параметры, принимаемые методом:
- token
Возвращаемое значение:
- ArrayOfCountry
- Country
- CountryID – идентификационный номер страны
- Name – название страны
- Country
Сервис для работы с пользователями системы (UserManagementService)
Сервис UserManagementService предназначен для работы с пользователями системы.
Метод AgencyRegistration
Данный метод предназначен для регистрации пользователей (агентств).
Параметры, принимаемые методом:
- Address - адрес
- AgencyName – название агентства (обязательный параметр)
- City – город
- Comment – примечание
- ContactName – контактное лицо
- Contry – страна
- Email – e-mail пользователя(обязательный параметр)
- Fax – факс
- Filial – филиал
- INN – ИНН
- IsActive – признак активности пользователя сразу после регистрации
- Login – логин (обязательный параметр)
- Password – пароль (пароль передается в незашифрованном виде. При работе с сервисом рекомендуется использовать протокол https) (обязательный параметр)
- PhoneCode – код города
- PhoneNumber – телефон
- Token - токен (обязательный параметр)
- ZipCode – индекс
Возвращаемое значение:
- UserKey - идентификатор пользователя
Метод PersonRegistration
Данный метод предназначен для регистрации пользователей (частных лиц).
Параметры, принимаемые методом:
- Address - адрес
- City – город
- Contry – страна
- Email – e-mail пользователя (обязательный параметр)
- Filial – филиал
- IsActive – признак активности пользователя сразу после регистрации
- Login – логин (обязательный параметр)
- Name – имя (обязательный параметр)
- Password – пароль (пароль передается в незашифрованном виде. При работе с сервисом рекомендуется использовать протокол https) (обязательный параметр)
- PhoneCode – код города
- PhoneNumber – телефон
- SecondName - отчество
- Surname – фамилия
- Token - токен (обязательный параметр)
- ZipCode – индекс
Возвращаемое значение:
- UserKey - идентификатор пользователя
Метод UniqueLoginCheck
Данный метод предназначен для проверки логина пользователя на уникальность.
Параметры, принимаемые методом:
- Login – логин (обязательный параметр)
- Token - токен (обязательный параметр)
Возвращаемое значение:
- LoginUnique - статус проверки логина на уникальность:
- 0 – логин не найден в БД
- 1 – логин найден в БД
Метод GetUserKeyAndType
Данный метод предназначен для получения идентификатора (UserKey) и типа пользователя (агентство или частное лицо).
Параметры, принимаемые методом:
- Login – логин (обязательный параметр)
- Token - токен (обязательный параметр)
Возвращаемое значение:
- UserKey - идентификатор пользователя
- UserType - тип пользователя:
- 0 - агентство
- 1 - частник
Метод UserAuthorization
Данный метод предназначен для аутентификации/авторизации пользователя.
Параметры, принимаемые методом:
- Login – логин (обязательный параметр)
- Password - пароль (обязательный параметр)
- Token - токен (обязательный параметр)
Возвращаемое значение:
- AuthorizationStatus - статус авторизации:
- 0 - AccessDenied - пользователь не найден с указанным username и password
- 1 - AccessAllow - пользователь найден с указанным username и password
- 2 - DogovorExpired - дата окончания договора партнёра меньше текущей (для частников не проверять)
- UserCanBooking - возможность бронирования:
- false
- true
- UserRight - права пользователя:
- 1 - уполномоченный
- 0 - неуполномеченный
- UserType - тип пользователя:
- 0 - агентство
- 1 - частник
Метод PasswordRecovery
Данный метод предназначен для восстановления пароля зарегистрированного пользователя.
Параметры, принимаемые методом:
- Email - адрес электронной почты (обязательный параметр)
- Login – логин (обязательный параметр)
- Token - токен (обязательный параметр)
Возвращаемое значение:
- Password - пароль (пароль передается в незашифрованном виде. При работе с сервисом рекомендуется использовать протокол https)
Метод GetAgencyInfo
Данный метод предназначен для получения данных зарегистрированного пользователя "агентство".
Параметры, принимаемые методом:
- Token - токен (обязательный параметр)
- UserKey - идентификатор пользователя (обязательный параметр)
Возвращаемое значение:
- Address - адрес
- AgencyName – название агентства
- City – город
- Comment – примечание
- ContactName – контактное лицо
- Contry – страна
- Email – e-mail
- Fax – факс
- Filial – филиал
- INN – ИНН
- IsActive – признак активности пользователя сразу после регистрации
- PhoneCode – код города
- PhoneNumber – телефон
- ZipCode – индекс
Метод GetPersonInfo
Данный метод предназначен для получения данных зарегистрированного пользователя "частное лицо".
Параметры, принимаемые методом:
- Token - токен (обязательный параметр)
- UserKey - идентификатор пользователя (обязательный параметр)
Возвращаемое значение:
- Address - адрес
- City – город
- Contry – страна
- Email – e-mail
- Filial – филиал
- IsActive – признак активности пользователя сразу после регистрации
- Name – имя
- PhoneCode – код города
- PhoneNumber – телефон
- SecondName - отчество
- Surname – фамилия
- ZipCode – индекс
Метод ModifyAgencyInfo
Данный метод предназначен для изменения данных зарегистрированного пользователя "агентство".
Параметры, принимаемые методом:
- Address - адрес
- AgencyName – название агентства
- City – город
- Comment – примечание
- ContactName – контактное лицо
- Contry – страна
- Email – e-mail
- Fax – факс
- Filial – филиал
- INN – ИНН
- IsActive – признак активности пользователя сразу после регистрации
- Login – логин
- Password – пароль (пароль передается в незашифрованном виде. При работе с сервисом рекомендуется использовать протокол https)
- PhoneCode – код города
- PhoneNumber – телефон
- Token - токен (обязательный параметр)
- UserKey - идентификатор пользователя (обязательный параметр)
- ZipCode – индекс
Возвращаемое значение:
- Status - статус изменения данных пользователя:
- 0 - Error
- 1 - Ok
Метод ModifyPersonInfo
Данный метод предназначен для изменения данных зарегистрированного пользователя "частное лицо".
Параметры, принимаемые методом:
- Address - адрес
- City – город
- Contry – страна
- Email – e-mail
- Filial – филиал
- IsActive – признак активности пользователя сразу после регистрации
- Login – логин
- Name – имя
- Password – пароль (пароль передается в незашифрованном виде. При работе с сервисом рекомендуется использовать протокол https)
- PhoneCode – код города
- PhoneNumber – телефон
- SecondName - отчество
- Surname – фамилия
- Token - токен (обязательный параметр)
- UserKey - идентификатор пользователя (обязательный параметр)
- ZipCode – индекс
Возвращаемое значение:
- Status - статус изменения данных пользователя:
- 0 - Error
- 1 - Ok
MasterTourFacade
Данный модуль предназначен для работы со справочниками и путевками - MasterTourFacade.
TourML
Данный модуль предназначен для работ по выгрузке рассчитанных цен и созданию путевок - TourML.
Метод CancelAgreement
Данный метод отправляет запрос на аннуляцию путевки.
Метод CheckBooking
Данный метод осуществляет проверку возможности бронирования рассчитанного прайса.
Метод CreateBooking
Данный метод осуществляет бронирование путевки по рассчитанному прайсу.
Метод GetAgencies
Данный метод возвращает список агентств по определенному фильтру.
Метод GetAgreementCredentials
Данный метод возвращает ключ агентства и номер договора по логину и паролю онлайн пользователя.
Метод GetAgreementsByCode
Данный метод возвращает список путевок по кодам.
Метод GetAgreementsByKeys
Данный метод возвращает список путевок по ключам.
Метод GetAgreementsByNumber
Данный метод возвращает информацию по забронированным путевкам.
Метод GetBookingInfo
Данный метод возвращает информацию о путевке.
Метод GetCountries
Данный метод возвращает список стран, по которым имеются туры. В каждой стране – список городов, на которые имеются квоты.
Метод GetCourse
Данный метод возвращает информацию о кросс-курсе валют.
Метод GetFlightQuotes
Данный метод возвращает расписание и квоты (наличие и количество мест) по авиаперелетам.
Метод GetHotelKeys
Данный метод возвращает список отелей, по которым имеются туры.
Метод GetHotelQuotes
Данный метод возвращает квотsы(наличие и количество мест) по отелям.
Метод GetInfo
Внутренний метод для тестовых целей.
Метод GetNationalCourse
Данный метод возвращает возвращает курс национальной валюты.
Метод GetNationalRateCode
Данный метод возвращает код национальной валюты.
Метод GetReferences
Данный метод возвращает справочники по фильтрам.
Метод GetSPOArrayByKeyCompressed
Данный метод осуществляет загрузку цен (данные возвращаются в сжатом виде по частям).
Метод GetSPOByKey
Данный метод осуществляет загрузку цен.
Метод GetSPOByKey_DC
Данный метод осуществляет загрузку цен для динамического ценообразования.
Метод GetSPOByKeyCompressed
Данный метод осуществляет загрузку цен (данные возвращаются в сжатом виде).
Метод GetSPOByKeyCompressed_DC
Данный метод осуществляет загрузку цен для динамического ценообразования (данные возвращаются в сжатом виде).
Метод GetSPOPageByKey
Данный метод осуществляет постраничную загрузку цен.
Метод GetSPOPageByKeyCompressed
Данный метод возвращает постраничную загрузку цен (данные возвращаются в сжатом виде).
Метод GetSimpleDogovorsBronni
Данный метод возвращает список путевок в формате Бронни.
Метод GetSimpleDogovorsByCreateDates
Данный метод возвращает список путевок в формате Бронни по датам создания.
Метод GetStopSalesAndQuotes
Данный метод возвращает информацию по квотам и Stop-Sale для версии 7.2.
Метод GetStopSalesAndQuotes2
Данный метод возвращает информацию по квотам и Stop-Sale для версии 9.2.
Метод GetStopSalesAndQuotesByHotels
Данный метод возвращает информацию по квотам и Stop-Sale по дате по конкретному ключу отеля.
Метод GetStopSalesAndQuotesCompressed
Данный метод возвращает информацию по квотам и Stop-Sale для версии 9.2 (данные возвращаются в сжатом виде).
Метод GetValidTourList
Данный метод возвращает список актуальных туров.
Метод GetValidTourListCompressed
Данный метод возвращает список актуальных туров (данные возвращаются в сжатом виде).
Метод GetValidTourListFrom
Данный метод возвращает список актуальных туров с определенной даты.
Метод GetValidTourListFrom_DC
Данный метод возвращает список актуальных туров с определенной даты для динамического ценообразования.
Метод GetValidTourListFromCompressed
Данный метод возвращает список актуальных туров с определенной даты (данные возвращаются в сжатом виде).
Метод GetVersion
Данный метод возвращает версию базы данных Мастер-Тур и текущей бизнес-логики сервиса
Метод Info
Внутренний метод для тестовых целей.
Метод ValidatePriceServices
Данный метод проверяет валидность услуг на даты заездов.
AddCostLogic
Данный модуль предназначен для расчета доплаты из очереди расчета доплат (ДЦ) - AddCostLogic.
AdminService
Данный модуль предназначен для проверки принадлежности пользователя к роли - AdminService.
ApplicationsLog
Данный модуль предназначен для реализация метода логирования в базе данных - ApplicationsLog.
CalculatePriceListDynamic
Данный модуль предназначен для запуска расчета прайс-листа - CalculatePriceListDynamic.
DictionaryService
Данный модуль предназначен для работы со справочниками стран - DictionaryService.
QuotaLogic
Данный модуль предназначен для работы с квотами - QuotaLogic.
TourMarginLogic
Данный модуль предназначен для расчета наценок из очереди (ДЦ) - TourMarginLogic.
UserService
Данный модуль предназначен для работы с пользователями - UserService.