Master-Interlook:Использование веб-сервиса — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[досмотренная версия][досмотренная версия]
(Отметить эту версию для перевода)
 
(не показано 5 промежуточных версий 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 />
 +
Параметр DownloadOnlyActualCosts - закачивать только актуальные цены (CS_DATEEND >= GETDATE()) <br />
 +
Параметр DownloadCostsFromDate – закачивать цены только с выбранной даты(CS_UpdateDate >= DownloadCostsDateBegin) <br />
 +
Параметр TariffKey – ключ тарифа(в таблице цен это CS_CVId). <br />
 +
Параметр SpoKey – ключ СПО. <br />
 +
Параметр Code – ключ услуги(отеля в частности). <br />
 +
Параметр PriceType - тип цены(за комнату(1) или за человека(0)). <br />
 +
Параметр ServiceKey – тип услуги(SvKey).У услуги проживания SvKey = 1. <br />
  
 
<!--T:2-->
 
<!--T:2-->

Текущая версия на 10:09, 2 августа 2013

Другие языки:
English • ‎русский

Версия статьи от 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.