Master-Interlook:Использование веб-сервиса — различия между версиями
| [досмотренная версия] | [досмотренная версия] |
Schukin (обсуждение | вклад) |
|||
| (не показаны 4 промежуточные версии 1 участника) | |||
| Строка 6: | Строка 6: | ||
==Ответы на часто возникающие вопросы== | ==Ответы на часто возникающие вопросы== | ||
'''Q:'''Возможно ли бронирование отелей? <br /> | '''Q:'''Возможно ли бронирование отелей? <br /> | ||
| − | '''A:'''Да<br /><br /> | + | '''A:'''Да, возможно<br /><br /> |
'''Q:'''Возможно ли через веб-сервис бронирование экскурсий?<br /> | '''Q:'''Возможно ли через веб-сервис бронирование экскурсий?<br /> | ||
| − | '''A:'''Да<br /><br /> | + | '''A:'''Да, возможно<br /><br /> |
'''Q:'''Возможно ли через веб-сервис бронирование трансферов?<br /> | '''Q:'''Возможно ли через веб-сервис бронирование трансферов?<br /> | ||
| − | '''A:'''Да<br /><br /> | + | '''A:'''Да, возможно<br /><br /> |
'''Q:'''Возможно ли через веб-сервис бронирование каких-либо ещё услуг?<br /> | '''Q:'''Возможно ли через веб-сервис бронирование каких-либо ещё услуг?<br /> | ||
'''A:'''Да (доп. услуги и пакеты)<br /><br /> | '''A:'''Да (доп. услуги и пакеты)<br /><br /> | ||
| Строка 30: | Строка 30: | ||
'''Q:'''Возможно ли с помощью сервиса изменять уже забронированные услуги?<br /> | '''Q:'''Возможно ли с помощью сервиса изменять уже забронированные услуги?<br /> | ||
'''A:'''Это возможно. Алгоритм такой: стандартным методом получаем путевку, меняем в ней то, что нам необходимо, отправляем эту путевку методом для бронирования путевки. Метод определит, что такая путевка уже была, и произведет изменения вместо создания новой.<br /><br /> | '''A:'''Это возможно. Алгоритм такой: стандартным методом получаем путевку, меняем в ней то, что нам необходимо, отправляем эту путевку методом для бронирования путевки. Метод определит, что такая путевка уже была, и произведет изменения вместо создания новой.<br /><br /> | ||
| + | '''Q:'''Что такое статус услуги (Megatec.Travel.Entities.Service.status)? Какую информацию он несет? <br /> | ||
| + | '''A:''' Статус услуги – это статус, который может иметь услуга в зависимости от текущего состояния в процессе работы с ней. Значения статусов услуг хранятся в таблице DLSTATUS. Услуга может принимать следующие статусы:1 – Wait, 2 – Confirmed, 4 – Not confirmed.<br /><br /> | ||
| + | '''Q:'''Что указывать в качестве партнера для услуги (Megatec.Travel.Entities.Service.Partner)? Обязательно ли его указывать?<br /> | ||
| + | '''A:'''Megatec.Travel.Entities.Service.Partner – это покупатель. В методе бронирования через веб-сервис проставляется автоматически(берется из данных пользователя, под которым делается запрос к веб-сервису). <br /><br /> | ||
| + | '''Q:'''Учитывается ли время для услуги (Megatec.Travel.Entities.Service.startDate) или нужно указывать только дату?<br /> | ||
| + | '''A:'''Время не учитывается.<br /><br /> | ||
| + | |||
==Часто используемые параметры== | ==Часто используемые параметры== | ||
| + | ===Метод GetCosts=== | ||
Параметр DownloadCostsDateBegin используется при установке параметра DownloadCostsFromDate. <br /> | Параметр DownloadCostsDateBegin используется при установке параметра DownloadCostsFromDate. <br /> | ||
Параметр DownloadOnlyActualCosts - закачивать только актуальные цены (CS_DATEEND >= GETDATE()) <br /> | Параметр DownloadOnlyActualCosts - закачивать только актуальные цены (CS_DATEEND >= GETDATE()) <br /> | ||
Текущая версия на 10:09, 2 августа 2013
Версия статьи от 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.
