Master-Interlook:HotelService — различия между версиями
| [досмотренная версия] | [досмотренная версия] |
Aefremov (обсуждение | вклад) |
Aefremov (обсуждение | вклад) (→ManageBooking (Передача изменений по услуге проживания в Interlook)) |
||
| (не показаны 2 промежуточные версии этого же участника) | |||
| Строка 162: | Строка 162: | ||
<tem:SearchBookings> | <tem:SearchBookings> | ||
<!--Optional:--> | <!--Optional:--> | ||
| − | <tem:guid> | + | <tem:guid>69ad76b6-3551-403d-934e-18d8358a60e2</tem:guid> |
<!--Optional:--> | <!--Optional:--> | ||
<tem:hotelID> | <tem:hotelID> | ||
<!--Zero or more repetitions:--> | <!--Zero or more repetitions:--> | ||
| − | <tem:int> | + | <tem:int>2942</tem:int> |
</tem:hotelID> | </tem:hotelID> | ||
<tem:dateInfo>1</tem:dateInfo> | <tem:dateInfo>1</tem:dateInfo> | ||
| − | <tem:dateFrom>2021- | + | <tem:dateFrom>2021-11-26</tem:dateFrom> |
| − | <tem:dateTo>2021-12- | + | <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:New>true</tem:New> | ||
<tem:change>true</tem:change> | <tem:change>true</tem:change> | ||
| Строка 176: | Строка 178: | ||
</tem:SearchBookings> | </tem:SearchBookings> | ||
</soapenv:Body> | </soapenv:Body> | ||
| − | + | </soapenv:Envelope> | |
</syntaxhighlight> | </syntaxhighlight> | ||
| Строка 186: | Строка 188: | ||
<SearchBookingsResult> | <SearchBookingsResult> | ||
<BookingInfo> | <BookingInfo> | ||
| − | <Booking> | + | <Booking>MT111127A02</Booking> |
| − | <BookingID> | + | <BookingID>36440</BookingID> |
<Action>New</Action> | <Action>New</Action> | ||
| − | <CreationDate>2021- | + | <CreationDate>2021-11-26T15:11:20.68</CreationDate> |
<ChangeDate xsi:nil="true"/> | <ChangeDate xsi:nil="true"/> | ||
<CancelDate xsi:nil="true"/> | <CancelDate xsi:nil="true"/> | ||
| Строка 198: | Строка 200: | ||
<HotelServices> | <HotelServices> | ||
<HotelServiceInfo> | <HotelServiceInfo> | ||
| − | <HotelServiceId> | + | <HotelServiceId>165447</HotelServiceId> |
| − | <HotelServiceName>HTL::Kiev/ | + | <HotelServiceName>HTL::Kiev/Green/Double Room/2Ad/Inner View/HB</HotelServiceName> |
<Hotel> | <Hotel> | ||
| − | <HotelId> | + | <HotelId>2942</HotelId> |
| − | <HotelName> | + | <HotelName>Green</HotelName> |
</Hotel> | </Hotel> | ||
<Pansion> | <Pansion> | ||
| − | <PansionId> | + | <PansionId>4</PansionId> |
| − | <PansionName> | + | <PansionName>Half Board</PansionName> |
</Pansion> | </Pansion> | ||
<RoomType> | <RoomType> | ||
| Строка 213: | Строка 215: | ||
</RoomType> | </RoomType> | ||
<RoomAccomodation> | <RoomAccomodation> | ||
| − | <AccommodationId> | + | <AccommodationId>8082</AccommodationId> |
| − | <AccommodationName> | + | <AccommodationName>2Ad</AccommodationName> |
</RoomAccomodation> | </RoomAccomodation> | ||
<RoomCategory> | <RoomCategory> | ||
| − | <RoomCategoryId> | + | <RoomCategoryId>19</RoomCategoryId> |
| − | <RoomCategoryName> | + | <RoomCategoryName>Inner View</RoomCategoryName> |
</RoomCategory> | </RoomCategory> | ||
<Status> | <Status> | ||
| − | <StatusId> | + | <StatusId>2</StatusId> |
| − | <StatusName> | + | <StatusName>Confirmed</StatusName> |
</Status> | </Status> | ||
| − | + | <CheckIn>2021-11-27T00:00:00</CheckIn> | |
| − | <CheckIn>2021- | + | <CheckOut>2021-12-10T00:00:00</CheckOut> |
| − | <CheckOut>2021- | ||
<Tourists> | <Tourists> | ||
<TouristInfo> | <TouristInfo> | ||
| − | <Name> | + | <Name/> |
| − | < | + | <BirthDate xsi:nil="true"/> |
| − | < | + | <Sex/> |
| − | <HotelServiceId> | + | <HotelServiceId>165447</HotelServiceId> |
| + | </TouristInfo> | ||
| + | <TouristInfo> | ||
| + | <Name/> | ||
| + | <BirthDate xsi:nil="true"/> | ||
| + | <Sex/> | ||
| + | <HotelServiceId>165447</HotelServiceId> | ||
</TouristInfo> | </TouristInfo> | ||
| − | + | </Tourists> | |
</HotelServiceInfo> | </HotelServiceInfo> | ||
</HotelServices> | </HotelServices> | ||
| − | < | + | <Messages/> |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
</BookingInfo> | </BookingInfo> | ||
| − | + | </SearchBookingsResult> | |
</SearchBookingsResponse> | </SearchBookingsResponse> | ||
</soap:Body> | </soap:Body> | ||
</soap:Envelope> | </soap:Envelope> | ||
| − | |||
</syntaxhighlight> | </syntaxhighlight> | ||
</TD></TR></TABLE> | </TD></TR></TABLE> | ||
| Строка 336: | Строка 334: | ||
<tem:dateFrom>2021-01-01</tem:dateFrom> | <tem:dateFrom>2021-01-01</tem:dateFrom> | ||
<tem:dateTo>2021-12-01</tem:dateTo> | <tem:dateTo>2021-12-01</tem:dateTo> | ||
| + | <tem:checkInFrom>2021-11-24</tem:checkInFrom> | ||
| + | <tem:checkInTo>2021-12-28</tem:checkInTo> | ||
<tem:New>true</tem:New> | <tem:New>true</tem:New> | ||
<tem:change>true</tem:change> | <tem:change>true</tem:change> | ||
| Строка 432: | Строка 432: | ||
<tem:ManageBooking> | <tem:ManageBooking> | ||
<!--Optional:--> | <!--Optional:--> | ||
| − | <tem:guid> | + | <tem:guid>69ad76b6-3551-403d-934e-18d8358a60e2</tem:guid> |
<tem:hotelServiceId>163806</tem:hotelServiceId> | <tem:hotelServiceId>163806</tem:hotelServiceId> | ||
| − | + | <tem:status>1</tem:status> | |
<!--Optional:--> | <!--Optional:--> | ||
<tem:hotelConfirmationNumber>88888888i</tem:hotelConfirmationNumber> | <tem:hotelConfirmationNumber>88888888i</tem:hotelConfirmationNumber> | ||
Версия 14:17, 26 ноября 2021
Версия статьи от 26-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 – возвращает информацию об отмененных бронированиях за выбранный период
Возвращаемый результат:
- 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 – массив данных брони
развернутьПример
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 – имя статуса по услуге проживания
- HotelConfirmationNumber – номер заказа у поставщика
- Messages – массив данных сообщений
- Id – идентификатор сообщения
- IsOutgoing – исходящее (true - исходящее, false - входящее)
- DateCreate – дата создания сообщения
- SenderName - не указывается
- IsRead – прочитано (true - прочитано, false - не прочитано )
- Text – текст сообщения
развернутьПример
Методы передачи изменений по услугам
ManageBooking (Передача изменений по услуге проживания в Interlook)
Принимаемые параметры запроса ( * – обязательный):
- ManageBooking>
- guid * – идентификатор аутентификации (возвращается при запросе к методу Connect)
- hotelServiceId * – ключ услуги проживания (возвращается при запросе к методу SearchBookings)
- status – фильтр для отбора услуг с определенным статусом (1 - Wait, 2 - Confirmed, 3 - notConfirmed)
- hotelConfirmationNumber – номер брони от провайдера
- message – сообщение для пользователя Interlook
- guid * – идентификатор аутентификации (возвращается при запросе к методу Connect)
Возвращаемый результат:
- ManageBookingResult – массив данных
- HotelServiceId – ключ сервиса отеля
- HotelServiceName – имя сервиса отеля
- Hotel – массив данных по отелям
- HotelId – ключ отеля
- HotelName – имя отеля
- Pansion – тип питания
- PansionId – ключ питания
- PansionName – имя питания
- RoomType – тип номера
- RoomTypeId – ключ типа номера
- RoomTypeName – имя типа номера
- RoomAccomodation – тип размещения
- AccommodationId – ключ типа размещения
- AccommodationName – имя типа размещения
- RoomCategory – категория номер
- RoomCategoryId – ключ категории номера
- RoomCategoryName – имя категории номера
- Status – статус по услуге проживания
- StatusId – ключ статуса по услуге проживания
- StatusName – имя статуса по услуге проживания
- HotelConfirmationNumber – номер заказа у поставщика
- Hotel – массив данных по отелям
развернутьПример
