Мастер-Тур:Работа с методами веб-сервисов

Материал из Megatec
Перейти к: навигация, поиск

Статья находится на стадии разработки.

Более ранние версии:
До версии ПК «Мастер-Web» 2009.2.20.21 включительно


Содержание

[править] Введение

[править] Обзор

В данной статье собрана краткая информация о существующих web-сервисах, используемых в ПК "Мастер-Тур"/"Мастер-Web".

[править] Установка

Для установки Веб-сервисов нужно создать директорию сервиса (название директории можно найти в соответствующем разделе или в статьях, ссылка на которые есть в соответствующих разделах) в каталоге c:/inetpub/wwwroot/MasterWeb и выложить туда распакованные файлы из архива, содержащего файлы веб-сервиса. Название архива для каждого из веб-сервисов можно найти в соответствующем разделе или в статьях, ссылка на которые есть в соответствующих разделах.

В управлении IIS необходимо создать виртуальный каталог для этой папки.

[править] Создание виртуального каталога

По умолчанию корневым каталогом IIS является C:/Inetpub/wwwroot. Для создания виртуального каталога для приложения находящегося в этом каталоге нужно выполнить следующие действия:

  • 1. Зайти в Пуск (Start) – Настройки (Settings) – Панель управления (Control Panel)


875.PNG

  • 2. В открывшемся окне выбрать Администрирование (Administrative Tools)


876.PNG

  • 3. Запустить Internet Information Services (IIS) Manager


877.PNG

  • 4. В открывшемся дереве каталогов выбрать Web Sites – Default Web Site. В открывшемся списке найти папку, для которой нужно создать виртуальный каталог, кликнуть по ней правой кнопкой мыши и зайти в Свойства (Properties)


878.PNG

  • 5. В открывшемся окне, в закладке Directory нужно нажать кнопку «Create», а затем кнопку «ОК»


879.PNG

[править] Подключение к базе данных ПК «Мастер-Тур»

В файле 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)

Параметры, принимаемые методом:

  • token - авторизационный токен;
  • 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» - Бронирование индивидуального тура.

  1. Установка экрана «Бронирование индивидуального тура» включает в себя следующие этапы:
  2. Установка доп.экрана «Бронирование индивидуального тура»
  3. Установка web-сервиса «Сервис бронирования»
  4. Установка web-сервиса «Сервис проверки наличия мест»
  5. Установка web-сервиса «Сложный тур»
  6. Настройка конфигурационного файла 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

Метод 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
  • AccomodationType – тип размещения
  • Cost – стоимость
  • Currency – валюта
  • ServicesCosts
    • ServiceCost
      • ServiceName – назавние услуги
      • Cost – стоимость услуги
      • Currency – валюта
      • TransportKey – ключ транспорта (-1, если услуга не подразумевает схему размещения в транспорте)
      • ServiceID – идентификационный номер услуги

[править] Метод GetBusyBusPlan

Метод 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

[править] Метод GetTours

Метод GetTours

Параметры, принимаемые методом:

  • token
  • beginDate - дата, начиная с которой выбирать туры (дата создания тура), в формате «yyyy-MM-dd»

Возвращаемое значение:

  • ArrayOfTourInfo
    • TourInfo
      • TourID – идентификационный номер тура
      • TourPriceID - идентификационный номер стоимости тура
      • Name – название тура
      • TypeID – идентификационный номер типа тура
      • URL – url страницы с описанием тура
      • CreatedDate – дата создания тура (формат «yyyy-MM-ddThh:mm:ss»)
      • ValidFrom – действителен с
      • ValidTo – действителен по
      • Code – код тура
      • CountryID – идентификационный номер страны

[править] Метод GetTourTypes

Метод GetTourTypes

Параметры, принимаемые методом:

  • token

Возвращаемое значение:

  • ArrayOfTourType
    • TourType
      • TourTypeID – идентификационный номер типа тура
      • Name – название типа тура

[править] Метод GetCountries

Метод GetCountries

Параметры, принимаемые методом:

  • token

Возвращаемое значение:

  • ArrayOfCountry
    • Country
      • CountryID – идентификационный номер страны
      • Name – название страны

[править] Сервис для работы с пользователями системы (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.

Личные инструменты
Пространства имён

Варианты
Просмотры
Действия
Навигация
Инструменты