Master-Interlook:HotelService

Материал из Megatec
Перейти к: навигация, поиск

Версия статьи от 13-05-2022.

Доступно начиная с релиза 11.20


Введение

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

Предупреждение


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


Методы HotelService

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

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

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

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

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

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

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:Connect>
         <!--Optional:-->
         <tem:login>mk1</tem:login>
         <!--Optional:-->
         <tem:password>123</tem:password>
      </tem:Connect>
   </soapenv:Body>
</soapenv:Envelope>

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

<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>
      <ConnectResponse xmlns="http://tempuri.org/">
         <ConnectResult>123c02db-3d47-4db5-861b-758be524a5fe</ConnectResult>
      </ConnectResponse>
   </soap:Body>
</soap:Envelope>


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

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

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

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

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

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

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:tem="http://tempuri.org/">
   <soap:Header/>
   <soap:Body>
      <tem:CheckConnect>
         <!--Optional:-->
         <tem:guid>123c02db-3d47-4db5-861b-758be524a5fe</tem:guid>
      </tem:CheckConnect>
   </soap:Body>
</soap:Envelope>

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

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <CheckConnectResponse xmlns="http://tempuri.org/">
         <CheckConnectResult>true</CheckConnectResult>
      </CheckConnectResponse>
   </soap:Body>
</soap:Envelope>


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

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

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

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

Заявка получает статус InWork в следующих случаях:
- если через HotelService в методе ManageBooking по заявке передан параметр <hotelWorkStatus>true</hotelWorkStatus>
- если по заявке распечатано или отправлено какое-либо из уведомлений по кнопке Actions в окне Interlook.

  • showConfirmed - отображает путевки со статусом Confirmed (false или отсутствие настройки означает, что путевки со статусом Confirmed не отображаются)

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

    • 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 – имя статуса по услуге проживания
          • 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>2022-01-02</tem:dateFrom>
         <tem:dateTo>2022-04-01</tem:dateTo>
         <tem:checkInFrom>2022-02-02</tem:checkInFrom>
         <tem:checkInTo>2022-05-28</tem:checkInTo>
         <tem:New>true</tem:New>
         <tem:change>true</tem:change>
         <tem:cancel>true</tem:cancel>
         <tem:inwork>true</tem:inwork>
         <tem:showConfirmed>true</tem:showConfirmed>
      </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>
    <Booking>MGR20228A01</Booking>
               <BookingID>37062</BookingID>
               <Action>Changed</Action>
               <CreationDate>2022-02-14T11:40:03.61</CreationDate>
               <ChangeDate xsi:nil="true"/>
               <CancelDate xsi:nil="true"/>
               <CustomerMarket>
                  <CustomerMarketId>2</CustomerMarketId>
                  <CustomerMarketName>Russian Market</CustomerMarketName>
               </CustomerMarket>
               <HotelServices>
                  <HotelServiceInfo>
                     <HotelServiceId>167845</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>Bed and Breakfast</PansionName>
                     </Pansion>
                     <RoomType>
                        <RoomTypeId>3</RoomTypeId>
                        <RoomTypeName>Double Room</RoomTypeName>
                     </RoomType>
                     <RoomAccomodation>
                        <AccommodationId>5558</AccommodationId>
                        <AccommodationName>2AD</AccommodationName>
                     </RoomAccomodation>
                     <RoomCategory>
                        <RoomCategoryId>19</RoomCategoryId>
                        <RoomCategoryName>Inner View</RoomCategoryName>
                     </RoomCategory>
                     <Status>
                        <StatusId>1</StatusId>
                        <StatusName>confirmed</StatusName>
                     </Status>
                     <CheckIn>2022-02-28T00:00:00</CheckIn>
                     <CheckOut>2022-04-04T00:00:00</CheckOut>
                     <Tourists>
                        <TouristInfo>
                           <Name>Вровро Враовро</Name>
                           <BirthDate xsi:nil="true"/>
                           <Sex>MR</Sex>
                           <HotelServiceId>167845</HotelServiceId>
                        </TouristInfo>
                        <TouristInfo>
                           <Name>Аврпро Варовро</Name>
                           <BirthDate xsi:nil="true"/>
                           <Sex>MR</Sex>
                           <HotelServiceId>167845</HotelServiceId>
                        </TouristInfo>
                     </Tourists>
                     <CostOffers>
                        <CostOfferInfo>
                           <CostOfferName>kolesnyk/kolesnyk</CostOfferName>
                           <CostOfferDateBegin>2022-02-28T00:00:00</CostOfferDateBegin>
                           <CostOfferDateEnd>2022-03-01T00:00:00</CostOfferDateEnd>
                           <CostOfferDuration>1</CostOfferDuration>
                        </CostOfferInfo>
                        <CostOfferInfo>
                           <CostOfferName>Green - 14-12/Green - 14-12</CostOfferName>
                           <CostOfferDateBegin>2022-03-02T00:00:00</CostOfferDateBegin>
                           <CostOfferDateEnd>2022-03-12T00:00:00</CostOfferDateEnd>
                           <CostOfferDuration>10</CostOfferDuration>
                        </CostOfferInfo>
                        <CostOfferInfo>
                           <CostOfferName>kolesnyk/kolesnyk</CostOfferName>
                           <CostOfferDateBegin>2022-03-13T00:00:00</CostOfferDateBegin>
                           <CostOfferDateEnd>2022-03-14T00:00:00</CostOfferDateEnd>
                           <CostOfferDuration>1</CostOfferDuration>
                        </CostOfferInfo>
                        <CostOfferInfo>
                           <CostOfferName>Green - 14-12/Green - 14-12</CostOfferName>
                           <CostOfferDateBegin>2022-03-15T00:00:00</CostOfferDateBegin>
                           <CostOfferDateEnd>2022-03-18T00:00:00</CostOfferDateEnd>
                           <CostOfferDuration>3</CostOfferDuration>
                        </CostOfferInfo>
                        <CostOfferInfo>
                           <CostOfferName>kolesnyk/kolesnyk</CostOfferName>
                           <CostOfferDateBegin>2022-03-19T00:00:00</CostOfferDateBegin>
                           <CostOfferDateEnd>2022-04-04T00:00:00</CostOfferDateEnd>
                           <CostOfferDuration>20</CostOfferDuration>
                        </CostOfferInfo>
                     </CostOffers>
                     <Penalty/>
                  </HotelServiceInfo>
               </HotelServices>
              <Messages>
                  <MessageInfo>
                     <Id>780510</Id>
                     <IsOutgoing>false</IsOutgoing>
                     <DateCreate>2022-03-15T18:33:07.953</DateCreate>
                     <IsRead>false</IsRead>
                     <Text>HTL::Kiev/Green/Double Room/2AD/Inner View/BB:
                     ftigjhfjhjhkjhjhk</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 – возвращает информацию об отмененных бронированиях за выбранный период
  • inwork – возвращает информацию по заявкам взятым отелем в работу

Заявка получает статус InWork в следующих случаях:
- если через HotelService в методе ManageBooking по заявке передан параметр <hotelWorkStatus>true</hotelWorkStatus>
- если по заявке распечатано или отправлено какое-либо из уведомлений по кнопке Actions в окне Interlook.

  • showConfirmed - отображает путевки со статусом Confirmed (false или отсутствие настройки означает, что путевки со статусом Confirmed не отображаются)

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

  • 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 – имя статуса по услуге проживания
          • 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 – текст сообщения
Пример

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:SearchBookingsJSON>
         <!--Optional:-->
         <tem:guid>bbadd56d-5f81-421e-ab8c-0c7380074447</tem:guid>
         <!--Optional:-->
         <tem:hotelID>
            <!--Zero or more repetitions:-->
            <tem:int>2942</tem:int>
         </tem:hotelID>
         <tem:dateInfo>1</tem:dateInfo>
         <tem:dateFrom>2022-01-02</tem:dateFrom>
         <tem:dateTo>2022-04-01</tem:dateTo>
         <tem:checkInFrom>2022-02-02</tem:checkInFrom>
         <tem:checkInTo>2022-05-28</tem:checkInTo>
         <tem:New>true</tem:New>
         <tem:change>true</tem:change>
         <tem:cancel>true</tem:cancel>
         <tem:inwork>true</tem:inwork>
         <tem:showConfirmed>true</tem:showConfirmed>
      </tem:SearchBookingsJSON>
   </soapenv:Body>
</soapenv:Envelope>

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

<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>
      <SearchBookingsJSONResponse xmlns="http://tempuri.org/">
         <SearchBookingsJSONResult>[{"Booking":"MGR20301A01","BookingID":37061,"Action":"Changed",
"CreationDate":"2022-02-14T11:12:51.767","ChangeDate":null,"CancelDate":null,"CustomerMarket":
{"CustomerMarketId":2,"CustomerMarketName":"Russian Market"},"HotelServices":[{"CheckIn":"2022-03-01T00:00:00",
"CheckOut":"2022-03-10T00:00:00","Tourists":[{"Name":"Dfhfgh Fdghfghg","BirthDate":null,"Sex":"MR",
"HotelServiceId":167841},{"Name":"Xdghfh Fghfghdfgh","BirthDate":null,"Sex":"MR","HotelServiceId":167841}],
"CostOffers":[{"CostOfferName":"Green - 14-12/Green - 14-12","CostOfferDateBegin":"2022-03-01T00:00:00",
"CostOfferDateEnd":"2022-03-10T00:00:00","CostOfferDuration":9}],"Penalty":"","Notes":null,"HotelServiceId"
:167841,"HotelServiceName":"HTL::Kiev/Green/Double Room/2AD/Jakuzzi/BB","Hotel":{"HotelId":2942,
"HotelName":"Green"},"Pansion":{"PansionId":3,"PansionName":"Bed and Breakfast"},"RoomType":
{"RoomTypeId":3,"RoomTypeName":"Double Room"},"RoomAccomodation":{"AccommodationId":5558,
"AccommodationName":"2AD"},"RoomCategory":{"RoomCategoryId":20,"RoomCategoryName":"Jakuzzi"},
"Status":{"StatusId":1,"StatusName":"Wait"}}],"Messages":[{"Id":780700,"IsOutgoing":false,
"DateCreate":"2022-04-04T10:39:39.26","SenderName":null,"IsRead":false,"Text":"HTL::Kiev/Green/Double
 Room/2AD/Jakuzzi/BB:\r\nHotel confirmation number is changed\nBooking not processed"},{
"Id":780701,"IsOutgoing":false,"DateCreate":"2022-04-04T10:40:56.287","SenderName":null,"IsRead":false,
"Text":"HTL::Kiev/Green/Double Room/2AD/Jakuzzi/BB:\r\nBooking is being process"}]},{
"Booking":"MGR20228A01","BookingID":37062,"Action":"Changed","CreationDate":"2022-02-14T11:40:03.61"
,"ChangeDate":null,"CancelDate":null,"CustomerMarket":{"CustomerMarketId":2,"CustomerMarketName"
:"Russian Market"},"HotelServices":[{"CheckIn":"2022-02-28T00:00:00","CheckOut":
"2022-04-04T00:00:00","Tourists":[{"Name":"Вровро Враовро","BirthDate":null,"Sex":"MR",
"HotelServiceId":167845},{"Name":"Аврпро Варовро","BirthDate":null,"Sex":"MR","HotelServiceId"
:167845}],"CostOffers":[{"CostOfferName":"kolesnyk/kolesnyk","CostOfferDateBegin":
"2022-02-28T00:00:00","CostOfferDateEnd":"2022-03-01T00:00:00","CostOfferDuration":1},
{"CostOfferName":"Green - 14-12/Green - 14-12","CostOfferDateBegin":"2022-03-02T00:00:00",
"CostOfferDateEnd":"2022-03-12T00:00:00","CostOfferDuration":10},{"CostOfferName":
"kolesnyk/kolesnyk","CostOfferDateBegin":"2022-03-13T00:00:00","CostOfferDateEnd":
"2022-03-14T00:00:00","CostOfferDuration":1},{"CostOfferName":"Green - 14-12/Green - 14-12",
"CostOfferDateBegin":"2022-03-15T00:00:00","CostOfferDateEnd":"2022-03-18T00:00:00",
"CostOfferDuration":3},{"CostOfferName":"kolesnyk/kolesnyk","CostOfferDateBegin":
"2022-03-19T00:00:00","CostOfferDateEnd":"2022-04-04T00:00:00","CostOfferDuration":20}],
"Penalty":"","Notes":null,"HotelServiceId":167845,"HotelServiceName":
"HTL::Kiev/Green/Double Room/2AD/Inner View/BB","Hotel":{"HotelId":2942,"HotelName":"Green"},
"Pansion":{"PansionId":3,"PansionName":"Bed and Breakfast"},"RoomType":
{"RoomTypeId":3,"RoomTypeName":"Double Room"},"RoomAccomodation":
{"AccommodationId":5558,"AccommodationName":"2AD"},"RoomCategory":
{"RoomCategoryId":19,"RoomCategoryName":"Inner View"},"Status":
{"StatusId":1,"StatusName":"Wait"}}],"Messages":[]},{"Booking":
"MT120224A01","BookingID":37210,"Action":"Changed","CreationDate":
"2022-02-24T11:20:28.673","ChangeDate":null,"CancelDate":null,"CustomerMarket":
{"CustomerMarketId":2,"CustomerMarketName":"Russian Market"},"HotelServices":
[{"CheckIn":"2022-02-24T00:00:00","CheckOut":"2022-02-27T00:00:00","Tourists":
[{"Name":"Mr Mr","BirthDate":null,"Sex":"MR","HotelServiceId":168484},{"Name":
"Mrs Mrs","BirthDate":null,"Sex":"MR","HotelServiceId":168484}],"CostOffers":
[{"CostOfferName":"kolesnyk/kolesnyk","CostOfferDateBegin":"2022-02-24T00:00:00",
"CostOfferDateEnd":"2022-02-27T00:00:00","CostOfferDuration":3}],
"Penalty":"","Notes":null,"HotelServiceId":168484,"HotelServiceName":
"HTL::Kiev/Green/Double Room/2AD/Inner View/BB","Hotel":{"HotelId"
:2942,"HotelName":"Green"},"Pansion":{"PansionId":3,"PansionName":
"Bed and Breakfast"},"RoomType":{"RoomTypeId":3,"RoomTypeName":"Double Room"},
"RoomAccomodation":{"AccommodationId":5558,"AccommodationName":"2AD"},"RoomCategory":
{"RoomCategoryId":19,"RoomCategoryName":"Inner View"},"Status":{"StatusId":1,
"StatusName":"Wait"}}],"Messages":[]},{"Booking":"MT120304A01","BookingID":
37234,"Action":"Changed","CreationDate":"2022-03-01T18:20:17.683","ChangeDate"
:null,"CancelDate":null,"CustomerMarket":{"CustomerMarketId":2,"CustomerMarketName"
:"Russian Market"},"HotelServices":[{"CheckIn":"2022-03-04T00:00:00",
"CheckOut":"2022-04-04T00:00:00","Tourists":[{"Name":"Jiouiop Hopiopiop",
"BirthDate":null,"Sex":"MR","HotelServiceId":168594},{"Name":"Uioyuioio 
Yuiouyouio","BirthDate":null,"Sex":"MR","HotelServiceId":168594}],"CostOffers":
[{"CostOfferName":"kolesnyk/kolesnyk","CostOfferDateBegin":"2022-03-04T00:00:00",
"CostOfferDateEnd":"2022-03-08T00:00:00","CostOfferDuration":4},{"CostOfferName":
"Green - 14-12/Green - 14-12","CostOfferDateBegin":"2022-03-09T00:00:00",
"CostOfferDateEnd":"2022-03-12T00:00:00","CostOfferDuration":3},{"CostOfferName":
"kolesnyk/kolesnyk","CostOfferDateBegin":"2022-03-13T00:00:00","CostOfferDateEnd":
"2022-03-14T00:00:00","CostOfferDuration":1},{"CostOfferName":"Green - 14-12/Green 
- 14-12","CostOfferDateBegin":"2022-03-15T00:00:00","CostOfferDateEnd":"2022-04-04T00:00:00"
,"CostOfferDuration":23}],"Penalty":"","Notes":null,"HotelServiceId":168594,
"HotelServiceName":"HTL::Kiev/Green/Double Room/2AD/Inner View/BB","Hotel":{"HotelId":
2942,"HotelName":"Green"},"Pansion":{"PansionId":3,"PansionName":"Bed and Breakfast"},
"RoomType":{"RoomTypeId":3,"RoomTypeName":"Double Room"},"RoomAccomodation":
{"AccommodationId":5558,"AccommodationName":"2AD"},"RoomCategory":{"RoomCategoryId":19,
"RoomCategoryName":"Inner View"},"Status":{"StatusId":2,"StatusName":"Confirmed"}}],
"Messages":[{"Id":780510,"IsOutgoing":false,"DateCreate":"2022-03-15T18:33:07.953",
"SenderName":null,"IsRead":false,"Text":"HTL::Kiev/Green/Double Room/2AD/Inner View/BB:
\r\nftigjhfjhjhkjhjhk"},{"Id":780511,"IsOutgoing":false,"DateCreate":"2022-03-15T18:33:
08.153","SenderName":null,"IsRead":false,"Text":"HTL::Kiev/Green/Double Room/2AD/Inner 
View/BB:\r\nService status is changed\nBooking is being process"},{"Id":780512,"IsOutgoing"
:true,"DateCreate":"2022-03-15T18:36:54.267","SenderName":"Work Name work","IsRead":
false,"Text":"fgjhghjghhhhhhhhhhhhhhhhhjkkkkkkkkkkkk"},{"Id":780513,"IsOutgoing":true,
"DateCreate":"2022-03-15T18:39:27.29","SenderName":"Work Name work","IsRead":false,
"Text":"jhkhjkjjjjjjjjjjjjjjjjjjjjjjjjhhhhhhhhhhhhhhhhhjjjj"}]},{"Booking":"MT120331A03"
,"BookingID":37292,"Action":"Changed","CreationDate":"2022-03-31T18:16:28.457",
"ChangeDate":null,"CancelDate":null,"CustomerMarket":{"CustomerMarketId":2,"CustomerMarketName"
:"Russian Market"},"HotelServices":[{"CheckIn":"2022-03-31T00:00:00","CheckOut":
"2022-04-14T00:00:00","Tourists":[{"Name":"Иванов Иван","BirthDate":null,"Sex":"MR",
"HotelServiceId":169028},{"Name":"Иван Иван","BirthDate":null,"Sex":"MR","HotelServiceId":169028}]
,"CostOffers":[{"CostOfferName":"Green - 14-12/Green - 14-12","CostOfferDateBegin":
"2022-03-31T00:00:00","CostOfferDateEnd":"2022-04-14T00:00:00","CostOfferDuration":14}],"Penalty":
"","Notes":null,"HotelServiceId":169028,"HotelServiceName":"HTL::Kiev/Green/Double Room/2AD/Jakuzzi
/BB","Hotel":{"HotelId":2942,"HotelName":"Green"},"Pansion":{"PansionId":3,"PansionName":"Bed and 
Breakfast"},"RoomType":{"RoomTypeId":3,"RoomTypeName":"Double Room"},"RoomAccomodation":{"AccommodationId":
5558,"AccommodationName":"2AD"},"RoomCategory":{"RoomCategoryId":20,"RoomCategoryName":"Jakuzzi"},
"Status":{"StatusId":1,"StatusName":"Wait"}}],"Messages":[]}]</SearchBookingsJSONResult>
      </SearchBookingsJSONResponse>
   </soap:Body>
</soap:Envelope>


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

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

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

  • 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>


Источник — «http://wiki.megatec.ru/index.php?title=Master-Interlook:HotelService&oldid=27458»