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

Версия статьи от 27-11-2012.

Введение

Данная статья содержит ответы на часто возникающие вопросы(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:Это возможно. Алгоритм такой: стандартным методом получаем путевку, меняем в ней то, что нам необходимо, отправляем эту путевку методом для бронирования путевки. Метод определит, что такая путевка уже была, и произведет изменения вместо создания новой.