Master-Interlook:HotelService
Версия статьи от 16-11-2021.
Поддерживаемые версии «»: |
Содержание
[убрать]Введение
Сервис 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 – возвращает информацию об отмененных бронировки за выбранный период
Возвращаемый результат:
- SearchBookingsResult – массив данных ответа
- 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 – имя статуса по услуге проживания
- HotelConfirmationNumber – номер заказа у поставщика
- CheckIn – дата заезда в отель
- CheckOut – дата выезда из отеля
- Tourists – массив данных туристов
- TouristInfo – массив данных по туристу
- Name – имя туриста
- BirthDate – дата рождения туриста
- Sex – пол туриста
- HotelServiceId – ключ услуги проживания с которой связан турист
- TouristInfo – массив данных по туристу
- HotelServiceInfo – информация по сервису отеля
- MessageInfo – массив данных сообщений
- Id – идентификатор сообщения
- IsOutgoing – исходящее (true - исходящее, false - входящее)
- DateCreate – дата создания сообщения
- IsRead – прочитано (true - прочитано, false - не прочитано )
- Text – текст сообщения
- BookingInfo – массив данных брони
Методы передачи изменений по услугам
ManageBooking (Передача изменений по услуге проживания в Interlook)
Принимаемые параметры запроса ( * – обязательный):
- ManageBooking>
- guid * – идентификатор аутентификации (возвращается при запросе к методу Connect)
- hotelServiceId * – ключ услуги проживания (возвращается при запросе к методу SearchBookings)
- status – фильтр для отбора услуг с определенным статусом (1 - Wait, 2 - Confirmed, 3 - notConfirmed)
- hotelConfirmationNumber – номер брони от провайдера
- message – сообщение для пользователя Interlook
- guid * – идентификатор аутентификации (возвращается при запросе к методу Connect)
Возвращаемый результат:
- ConnectResult – идентификатор аутентификации (если аутентификация прошла успешно. то получаем идентификатор, в противном случае результат -1)