Master-Interlook:Использование веб-сервиса
Версия статьи от 6-02-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:Это возможно. Алгоритм такой: стандартным методом получаем путевку, меняем в ней то, что нам необходимо, отправляем эту путевку методом для бронирования путевки. Метод определит, что такая путевка уже была, и произведет изменения вместо создания новой.
Часто используемые параметры
Параметр DownloadCostsDateBegin используется при установке параметра DownloadCostsFromDate.
Параметр DownloadOnlyActualCosts - закачивать только актуальные цены (CS_DATEEND >= GETDATE())
Параметр DownloadCostsFromDate – закачивать цены только с выбранной даты(CS_UpdateDate >= DownloadCostsDateBegin)
Параметр TariffKey – ключ тарифа(в таблице цен это CS_CVId).
Параметр SpoKey – ключ СПО.
Параметр Code – ключ услуги(отеля в частности).
Параметр PriceType - тип цены(за комнату(1) или за человека(0)).
Параметр ServiceKey – тип услуги(SvKey).У услуги проживания SvKey = 1.
