Версия статьи от 16-03-2022.

Поддерживаемые версии «»:
Начиная с

Содержание

1 Введение
2 Методы HotelService

Введение

Сервис InterlookHotelService работает с методами REST API. Для вызова методов REST API можно использовать SoapUi.

Для доступа к сервису у онлайн пользователя должен быть установлен признак Hotel/Service в настройке Person connection и в настройках Role активирован параметр Show hotel reservations by date.

Методы HotelService

Методы аутентификации

Connect (Получение аутентификационного токена)

Принимаемые параметры запроса ( * – обязательный):

Login * – логин online пользователя
Password * – пароль online пользователя

Возвращаемый результат:

ConnectResult – идентификатор аутентификации (если аутентификация прошла успешно. то получаем идентификатор, в противном случае результат -1)

развернутьПример

CheckConnect (Проверка активности подключения под конкретным идентификатором)

Метод проверяет наличие активного подключения под конкретным идентификатором аутентификации.
Принимаемые параметры запроса ( * – обязательный):

Guid * – идентификатор аутентификации (возвращается при запросе к методу Connect)

Возвращаемый результат:

CheckConnectResult – идентификатор аутентификации (true – если подключение активно, false – если подключения нет)

развернутьПример

Методы поиска

SearchBookings (Получение списка забронированных заявок)

Метод предназначен для поиска забронированных заявок. Отбираются те заявки, у которых партнер предоставления услуги совпадает с партнером для логина, под которым осуществляется поиск.
Принимаемые параметры запроса ( * – обязательный):

Guid * – идентификатор аутентификации (возвращается при запросе к методу Connect)
hotelID – массив данных с ключами отелей. Можно передавать как один так и несколько ключей отелей. Если не передаём данный параметр, то в ответ получаем все заказы, подходящие под выбранные даты.
dateInfo * – по какой дате осуществлять поиск (1 - дата создания заявки, 2 - дата заезда в отель, 3 - дата выезда из отеля)
dateFrom * – дата начала
dateTo * – дата окончания
checkInFrom – дата заезда от
checkInTo – дата заезда по
New – возвращает новые бронирования с датой, попадающей в указанное выше условие
change – возвращает измененные бронирования с изменениями, внесенными в выбранный период
cancel – возвращает информацию об отмененных бронированиях за выбранный период

Возвращаемый результат:

- BookingInfo – массив данных брони
  - Booking – номер брони в системе Interlook
  - BookingID – ключ заявки из базы данных
  - Action – новая, отмененная или измененная заявка
  - CreationDate – дата создания услуги в заявке
  - ChangeDate – не используется
  - CancelDate – не используется
  - CustomerMarket – данные туроператора, оформившего заявку
    - CustomerMarketId – ключ туроператора, оформившего заявку
    - CustomerMarketName – имя туроператора, оформившего заявку
  - HotelServices – массив данных по сервисам отелей
    - HotelServiceInfo – информация по сервису отеля
      - HotelServiceId – ключ сервиса отеля
      - HotelServiceName – имя сервиса отеля
      - Hotel – массив данных по отелям
        HotelId – ключ отеля
        
        HotelName – имя отеля
      - Pansion – тип питания
        PansionId – ключ питания
        
        PansionName – имя питания
      - RoomType – тип номера
        RoomTypeId – ключ типа номера
        
        RoomTypeName – имя типа номера
      - RoomAccomodation – тип размещения
        AccommodationId – ключ типа размещения
        
        AccommodationName – имя типа размещения
      - RoomCategory – категория номер
        RoomCategoryId – ключ категории номера
        
        RoomCategoryName – имя категории номера
      - Status – статус по услуге проживания
        StatusId – ключ статуса по услуге проживания
        
        StatusName – имя статуса по услуге проживания
      - CostOffer – наименование Costoffer, по которому рассчитана нетто цена
      - CheckIn – дата заезда в отель
      - CheckOut – дата выезда из отеля
      - Tourists – массив данных туристов
        TouristInfo – массив данных по туристу
        Name – имя туриста
        
        BirthDate – дата рождения туриста
        
        Sex – пол туриста
        
        HotelServiceId – ключ услуги проживания с которой связан турист
      - CostOffers – массив данных по CostOffers, по которым рассчитана цена услуги
        CostOfferInfo – массив данных по конкретному CostOffer
        CostOfferName – название CostOffer (Если заявка не аннулирована, то выводим название CostOffer по цене netto. Если заявка аннулирована со штрафами, то выводим название CostOffer по цене брутто. Если заявка аннулирована без штрафов, то выводим текст "Canceled without penalty")
        
        CostOfferDateBegin – дата начала действия CostOffer
        
        CostOfferDateEnd – дата окончания действия CostOffer
        
        CostOfferDuration – продолжительность проживания до данному CostOffer
      - Penalty – информация о штрафах по аннулированной заявке
  - MessageInfo – массив данных сообщений
    - Id – идентификатор сообщения
    - IsOutgoing – исходящее (true - исходящее, false - входящее)
    - DateCreate – дата создания сообщения
    - IsRead – прочитано (true - прочитано, false - не прочитано )
    - Text – текст сообщения

развернутьПример

Вызов метода SearchBookings

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:SearchBookings>
         <!--Optional:-->
         <tem:guid>69ad76b6-3551-403d-934e-18d8358a60e2</tem:guid>
         <!--Optional:-->
         <tem:hotelID>
            <!--Zero or more repetitions:-->
            <tem:int>2942</tem:int>
         </tem:hotelID>
         <tem:dateInfo>1</tem:dateInfo>
         <tem:dateFrom>2021-11-26</tem:dateFrom>
         <tem:dateTo>2021-12-26</tem:dateTo>
         <tem:checkInFrom>2021-11-24</tem:checkInFrom>
         <tem:checkInTo>2021-12-28</tem:checkInTo>
         <tem:New>true</tem:New>
         <tem:change>true</tem:change>
         <tem:cancel>true</tem:cancel>
      </tem:SearchBookings>
   </soapenv:Body>
</soapenv:Envelope>

Возвращаемый результат метода SearchBookings

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <SearchBookingsResponse xmlns="http://tempuri.org/">
         <SearchBookingsResult>
            <BookingInfo>
               <Booking>MT120304A01</Booking>
               <BookingID>37234</BookingID>
               <Action>Changed</Action>
               <CreationDate>2022-03-01T18:20:17.683</CreationDate>
               <ChangeDate xsi:nil="true"/>
               <CancelDate xsi:nil="true"/>
               <CustomerMarket>
                  <CustomerMarketId>2</CustomerMarketId>
                  <CustomerMarketName>Russian Market</CustomerMarketName>
               </CustomerMarket>
               <HotelServices>
                  <HotelServiceInfo>
                     <HotelServiceId>168594</HotelServiceId>
                     <HotelServiceName>HTL::Kiev/Green/Double Room/2AD/Inner View/BB</HotelServiceName>
                     <Hotel>
                        <HotelId>2942</HotelId>
                        <HotelName>Green</HotelName>
                     </Hotel>
                     <Pansion>
                        <PansionId>3</PansionId>
                        <PansionName/>
                     </Pansion>
                     <RoomType>
                        <RoomTypeId>3</RoomTypeId>
                        <RoomTypeName/>
                     </RoomType>
                     <RoomAccomodation>
                        <AccommodationId>5558</AccommodationId>
                        <AccommodationName/>
                     </RoomAccomodation>
                     <RoomCategory>
                        <RoomCategoryId>19</RoomCategoryId>
                        <RoomCategoryName/>
                     </RoomCategory>
                     <Status>
                        <StatusId>1</StatusId>
                        <StatusName>Wait</StatusName>
                     </Status>
                     <CostOffer>([kolesnyk/kolesnyk]*4 + [Green - 14-12/Green - 14-12]*3 + [kolesnyk/kolesnyk]*1 + [Green - 14-12/Green - 14-12]*23) * 1 room</CostOffer>
                     <CheckIn>2022-03-04T00:00:00</CheckIn>
                     <CheckOut>2022-04-04T00:00:00</CheckOut>
                     <Tourists>
                        <TouristInfo>
                           <Name>Jiouiop Hopiopiop</Name>
                           <BirthDate xsi:nil="true"/>
                           <Sex>MR</Sex>
                           <HotelServiceId>168594</HotelServiceId>
                        </TouristInfo>
                        <TouristInfo>
                           <Name>Uioyuioio Yuiouyouio</Name>
                           <BirthDate xsi:nil="true"/>
                           <Sex>MR</Sex>
                           <HotelServiceId>168594</HotelServiceId>
                        </TouristInfo>
                     </Tourists>
                     <CostOffers>
                        <CostOfferInfo>
                           <CostOfferName>Green - 14-12</CostOfferName>
                           <CostOfferDateBegin>2021-07-19T00:00:00</CostOfferDateBegin>
                           <CostOfferDateEnd>2022-07-01T00:00:00</CostOfferDateEnd>
                           <CostOfferDuration>6</CostOfferDuration>
                        </CostOfferInfo>
                        <CostOfferInfo>
                           <CostOfferName>kolesnyk</CostOfferName>
                           <CostOfferDateBegin>2022-03-04T00:00:00</CostOfferDateBegin>
                           <CostOfferDateEnd>2022-04-04T00:00:00</CostOfferDateEnd>
                           <CostOfferDuration>5</CostOfferDuration>
                        </CostOfferInfo>
                     </CostOffers>
                     <Penalty/>
                  </HotelServiceInfo>
               </HotelServices>
               <Messages>
               <MessageInfo>
                     <Id>779217</Id>
                     <IsOutgoing>false</IsOutgoing>
                     <DateCreate>2021-11-15T22:21:34.393</DateCreate>
                     <IsRead>false</IsRead>
                     <Text>HTL::Kiev/Hilton/Double Room/2AD/Jakuzzi/BB:
                   яварааааааааарвя</Text>
                  </MessageInfo>
               <Messages/>
            </BookingInfo>
         </SearchBookingsResult>
      </SearchBookingsResponse>
   </soap:Body>
</soap:Envelope>

SearchBookingsJSON (Получение списка забронированных заявок в формате JSON)

Метод предназначен для поиска забронированных заявок. Отбираются те заявки, у которых партнер предоставления услуги совпадает с партнером для логина, под которым осуществляется поиск.
Принимаемые параметры запроса ( * – обязательный):

Guid * – идентификатор аутентификации (возвращается при запросе к методу Connect)
hotelID – массив данных с ключами отелей. Можно передавать как один так и несколько ключей отелей. Если не передаём данный параметр, то в ответ получаем все заказы, подходящие под выбранные даты.
dateInfo * – по какой дате осуществлять поиск (1 - дата создания заявки, 2 - дата заезда в отель, 3 - дата выезда из отеля)
dateFrom * – дата начала
dateTo * – дата окончания
checkInFrom – дата заезда от
checkInTo – дата заезда по
New – возвращает новые бронирования с датой, попадающей в указанное выше условие
change – возвращает измененные бронирования с изменениями, внесенными в выбранный период
cancel – возвращает информацию об отмененных бронированиях за выбранный период

Возвращаемый результат:

Booking – номер брони в системе Interlook
BookingID – ключ заявки из базы данных
Action – новая, отмененная или измененная заявка
CreationDate – дата создания услуги в заявке
ChangeDate – не используется
CancelDate – не используется
CustomerMarket – данные туроператора, оформившего заявку
- CustomerMarketId – ключ туроператора, оформившего заявку
- CustomerMarketName – имя туроператора, оформившего заявку
HotelServices – массив данных по сервисам отелей
- CheckIn – дата заезда в отель
- CheckOut – дата выезда из отеля
- Tourists – массив данных туристов
  - - Name – имя туриста
    - BirthDate – дата рождения туриста
    - Sex – пол туриста
    - HotelServiceId – ключ услуги проживания с которой связан турист
- Notes – не указывается
  - HotelServiceId – ключ сервиса отеля
  - HotelServiceName – имя сервиса отеля
  - Hotel – массив данных по отелям
    - HotelId – ключ отеля
    - HotelName – имя отеля
  - Pansion – тип питания
    - PansionId – ключ питания
    - PansionName – имя питания
  - RoomType – тип номера
    - RoomTypeId – ключ типа номера
    - RoomTypeName – имя типа номера
  - RoomAccomodation – тип размещения
    - AccommodationId – ключ типа размещения
    - AccommodationName – имя типа размещения
  - RoomCategory – категория номер
    - RoomCategoryId – ключ категории номера
    - RoomCategoryName – имя категории номера
  - Status – статус по услуге проживания
    - StatusId – ключ статуса по услуге проживания
    - StatusName – имя статуса по услуге проживания
      - CostOffer – наименование Costoffer, по которому рассчитана нетто цена
      - CheckIn – дата заезда в отель
      - CheckOut – дата выезда из отеля
      - Tourists – массив данных туристов
        TouristInfo – массив данных по туристу
        Name – имя туриста
        
        BirthDate – дата рождения туриста
        
        Sex – пол туриста
        
        HotelServiceId – ключ услуги проживания с которой связан турист
      - CostOffers – массив данных по CostOffers, по которым рассчитана цена услуги
        CostOfferInfo – массив данных по конкретному CostOffer
        CostOfferName – название CostOffer (Если заявка не аннулирована, то выводим название CostOffer по цене netto. Если заявка аннулирована со штрафами, то выводим название CostOffer по цене брутто. Если заявка аннулирована без штрафов, то выводим текст "Canceled without penalty")
        
        CostOfferDateBegin – дата начала действия CostOffer
        
        CostOfferDateEnd – дата окончания действия CostOffer
        
        CostOfferDuration – продолжительность проживания до данному CostOffer
      - Penalty – информация о штрафах по аннулированной заявке
  - MessageInfo – массив данных сообщений
    - Id – идентификатор сообщения
    - IsOutgoing – исходящее (true - исходящее, false - входящее)
    - DateCreate – дата создания сообщения
    - IsRead – прочитано (true - прочитано, false - не прочитано )
    - Text – текст сообщения

развернутьПример

Методы передачи изменений по услугам

ManageBooking (Передача изменений по услуге проживания в Interlook)

Принимаемые параметры запроса ( * – обязательный):

ManageBooking>
- guid * – идентификатор аутентификации (возвращается при запросе к методу Connect)
- hotelServiceId * – ключ услуги проживания (возвращается при запросе к методу SearchBookings)
- status – фильтр для отбора услуг с определенным статусом (1 - Wait, 2 - Confirmed, 3 - notConfirmed)
- message – сообщение для пользователя Interlook
- hotelWorkStatus – отметка отеля по заявке (true - отель взял заявку в работу, false - отель заявку в работу не взял). При отправке этого параметра формируется запись в историю по заявке и сообщение от провайдера.

Возвращаемый результат:

ManageBookingResult – массив данных
HotelServiceId – ключ сервиса отеля
HotelServiceName – имя сервиса отеля
- Hotel – массив данных по отелям
  - HotelId – ключ отеля
  - HotelName – имя отеля
- Pansion – тип питания
  - PansionId – ключ питания
  - PansionName – имя питания
- RoomType – тип номера
  - RoomTypeId – ключ типа номера
  - RoomTypeName – имя типа номера
- RoomAccomodation – тип размещения
  - AccommodationId – ключ типа размещения
  - AccommodationName – имя типа размещения
- RoomCategory – категория номер
  - RoomCategoryId – ключ категории номера
  - RoomCategoryName – имя категории номера
- Status – статус по услуге проживания
  - StatusId – ключ статуса по услуге проживания
  - StatusName – имя статуса по услуге проживания

развернутьПример

Вызов метода ManageBooking

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ManageBooking>
         <!--Optional:-->
         <tem:guid>69ad76b6-3551-403d-934e-18d8358a60e2</tem:guid>
         <tem:hotelServiceId>163806</tem:hotelServiceId>
         <tem:status>1</tem:status>
         <!--Optional:-->
         <tem:message>яварааааааааарвя</tem:message>
         <tem:hotelWorkStatus>false</tem:hotelWorkStatus>
      </tem:ManageBooking>
   </soapenv:Body>
</soapenv:Envelope>

Возвращаемый результат метода ManageBooking

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ManageBookingResponse xmlns="http://tempuri.org/">
         <ManageBookingResult Message="Ok">
            <Data>
               <ManageBookingResult>
                  <HotelServiceId>163806</HotelServiceId>
                  <HotelServiceName>HTL::Kiev/Hilton/Double Room/2AD/Jakuzzi/BB</HotelServiceName>
                  <Hotel>
                     <HotelId>2935</HotelId>
                     <HotelName>Hilton</HotelName>
                  </Hotel>
                  <Pansion>
                     <PansionId>3</PansionId>
                     <PansionName>Bed and Breakfast</PansionName>
                  </Pansion>
                  <RoomType>
                     <RoomTypeId>3</RoomTypeId>
                     <RoomTypeName>Double Room</RoomTypeName>
                  </RoomType>
                  <RoomAccomodation>
                     <AccommodationId>5558</AccommodationId>
                     <AccommodationName>2AD</AccommodationName>
                  </RoomAccomodation>
                  <RoomCategory>
                     <RoomCategoryId>20</RoomCategoryId>
                     <RoomCategoryName>Jakuzzi</RoomCategoryName>
                  </RoomCategory>
                  <Status>
                     <StatusId>1</StatusId>
                     <StatusName>Wait</StatusName>
                  </Status>
               </ManageBookingResult>
            </Data>
         </ManageBookingResult>
      </ManageBookingResponse>
   </soap:Body>
</soap:Envelope>

Master-Interlook:HotelService

Содержание

Введение

Методы HotelService

Методы аутентификации

Connect (Получение аутентификационного токена)

CheckConnect (Проверка активности подключения под конкретным идентификатором)

Методы поиска

SearchBookings (Получение списка забронированных заявок)

SearchBookingsJSON (Получение списка забронированных заявок в формате JSON)

Методы передачи изменений по услугам

ManageBooking (Передача изменений по услуге проживания в Interlook)

Навигация

Персональные инструменты

Пространства имён

Варианты

Просмотры

Ещё

Поиск

Навигация

Инструменты