Перейти к основному содержимому

Метод getRooms

📌 Описание

Метод используется для получения от OTA информации о доступных категориях номеров и тарифах, которые могут быть сопоставлены с объектами в системе Inn-Book.


⚠️ Важно

Метод не содержит данных в объекте data.


🎯 Назначение

Метод вызывается для получения списка номеров и тарифов, зарегистрированных в OTA, с целью дальнейшего создания сопоставлений (matching) между Inn-Book и OTA.


📤 Пример запроса

{
"auth": {},
"action": "get_rooms",
"data": {}
}

🔎 Пояснение к параметрам запроса

ПолеТипОписание
authobjectОбъект авторизации/идентификации отеля
actionstringНазвание метода (get_rooms)
dataobjectПустой объект данных

📥 Пример ответа OTA

{
"rooms": [
{
"id": "5",
"name": "Трехместный стандарт",
"seats": "3",
"idInnBook": "94"
}
],
"rates": [
{
"id": "253",
"name": "Без завтрака",
"idInnBook": "45"
}
],
"status": "ok"
}

🧾 Пояснение к полям ответа

📦 Основные массивы

ПолеОписание
roomsСписок категорий номеров, зарегистрированных в OTA
ratesСписок тарифов, зарегистрированных в OTA
statusСтатус выполнения запроса

🏷 Поля объектов rooms и rates

ПолеОписание
idУникальный идентификатор номера/тарифа в системе OTA
nameНазвание категории номера или тарифа
seatsКоличество мест в категории номера (только для rooms)
idInnBookID соответствующего объекта в Inn-Book, если сопоставление уже выполнено; null — если сопоставления нет

🔗 Логика сопоставления (Matching)

После получения ответа:

  1. OTA передает список своих категорий номеров и тарифов
  2. Система Inn-Book выполняет сопоставление с внутренними объектами
  3. При успешном сопоставлении в поле idInnBook передается соответствующий ID
  4. Если сопоставление отсутствует — возвращается null

🔐 Рекомендации по реализации на стороне OTA

Рекомендуется
  • Передавать полный актуальный список номеров и тарифов
  • Сохранять неизменность id для корректного matching
  • Возвращать единый формат ответа с обязательным полем status