Master-Interlook:Использование веб-сервиса

Версия статьи от 2-08-2013.

Введение

Данная статья содержит ответы на часто возникающие вопросы(FAQ) по работе с веб-сервисом использумым в ПК "Мастер-Interlook".

Ответы на часто возникающие вопросы

Q:Возможно ли бронирование отелей?
A:Да, возможно

Q:Возможно ли через веб-сервис бронирование экскурсий?
A:Да, возможно

Q:Возможно ли через веб-сервис бронирование трансферов?
A:Да, возможно

Q:Возможно ли через веб-сервис бронирование каких-либо ещё услуг?
A:Да (доп. услуги и пакеты)

Q:Бронируется путевка с произвольным набором услуг.
Какие есть ограничения при использовании веб-сервиса (как технические, так и алгоритмические)?
A:Microsoft.Net FrameWork 4.0 IIS 7 и выше.

Q:Возможно ли получение всех необходимых справочных данных (города, страны, отели, типы трансферов, документов, места, языки и т.д.)?
A:Есть набор методов по получению данных из справочников. Метод GetData(DataRequest dataRequest) получает данные справочников(тип справочника передается в параметры): ExtraServices, Countries, Regions, Cities, RoomCategories, RoomTypes, RoomAccommodations, Pansions, Hotels, Ratings, Airports, Transports, Providers, Excursions, Transfers, TransferTypes, ServicePackages, Rates, DLStatuses,Tariffs, Charters, RoomDescriptions. Так же есть отдельные методы по получению данных из справочников.

Q:Есть ли возможность поиска услуг по заранее определённым параметрам, а именно: даты проведения, место проведения – страна, город (для трансферов точки начала и окончания), количество человек, дополнительные ограничения( тип трансфера, экскурсии, отель, звёздность, питание)? В результатах поиска должны быть услуги с их описанием и конечной ценой услуги (для квотируемых услуг квоты).
A:Метода для поиска услуг нет. Есть метод для поиска путевок Megatec.Interlook.DataObjects.DataRequestResult GetPagingData(string guid, Megatec.Interlook.DataObjects.DataRequestParams dataRequest) (так же этот метод умеет обсчитывать и искать цены на услуги). Этим методо можно получить список путевок по параметрам, а методом Megatec.Travel.Entities.Reservation GetReservation(string guid, int dgKey) получить нужную путевку с детализацией по услугам, туристам и т.д.

Q:Есть ли возможность запроса дополнительной информации по услугам (данный пункт может быть реализован в поиске): возврат информации по возможным штрафам за незаезд, условия предоставления услуг, детальное описание услуг?
A:Нет, нужно получить путевку – в ней содержится вся информация по ее услугам.

Q:Есть ли возможность бронирования услуги. Метод должен принять запрос на бронирование и вернуть как минимум идентификатор брони для дальнейшего запроса статуса?
A:Метод Megatec.Travel.Entities.Reservation CreateReservation(string guid, Megatec.Travel.Entities.Reservation reserv) создает путевку и возвращает получившуюся путевку после бронирования.
Q:Есть ли возможность запроса статуса забронированной услуги. Возвращает статус (и если есть изменения) по бронированной услуге?
A:Получив услуги путевки стандартными методами, можно у услуги посмотреть ее статус.

Q:Есть ли возможность аннулирования услуги (аналогично бронированию, но с соответствующим назначением)?
A:Метод string CancelReservation(string guid, int dgKey, int annulReasonID, string note) аннулирует путевку. Метод string CancelServices(string guid, int dgKey, string dlKeys, int annulReasonID, string note) аннулирует определенные услуги из путевки.

Q:Возможно ли с помощью сервиса изменять уже забронированные услуги?
A:Это возможно. Алгоритм такой: стандартным методом получаем путевку, меняем в ней то, что нам необходимо, отправляем эту путевку методом для бронирования путевки. Метод определит, что такая путевка уже была, и произведет изменения вместо создания новой.

Q:Что такое статус услуги (Megatec.Travel.Entities.Service.status)? Какую информацию он несет?
A: Статус услуги – это статус, который может иметь услуга в зависимости от текущего состояния в процессе работы с ней. Значения статусов услуг хранятся в таблице DLSTATUS. Услуга может принимать следующие статусы:1 – Wait, 2 – Confirmed, 4 – Not confirmed.

Q:Что указывать в качестве партнера для услуги (Megatec.Travel.Entities.Service.Partner)? Обязательно ли его указывать?
A:Megatec.Travel.Entities.Service.Partner – это покупатель. В методе бронирования через веб-сервис проставляется автоматически(берется из данных пользователя, под которым делается запрос к веб-сервису).

Q:Учитывается ли время для услуги (Megatec.Travel.Entities.Service.startDate) или нужно указывать только дату?
A:Время не учитывается.

Часто используемые параметры

Метод GetCosts

Параметр DownloadCostsDateBegin используется при установке параметра DownloadCostsFromDate.
Параметр DownloadOnlyActualCosts - закачивать только актуальные цены (CS_DATEEND >= GETDATE())
Параметр DownloadCostsFromDate – закачивать цены только с выбранной даты(CS_UpdateDate >= DownloadCostsDateBegin)
Параметр TariffKey – ключ тарифа(в таблице цен это CS_CVId).
Параметр SpoKey – ключ СПО.
Параметр Code – ключ услуги(отеля в частности).
Параметр PriceType - тип цены(за комнату(1) или за человека(0)).
Параметр ServiceKey – тип услуги(SvKey).У услуги проживания SvKey = 1.