prices — Цены и ограничения на даты

📌 Основная информация

URL: https://restota.inn-book.com/v1/prices
Метод: POST
Назначение: Получение информации о ценах, вариантах размещения и ограничениях по категориям номеров и тарифам отеля на заданный период.

---

⚠️ Важно

Если отель не добавил OTA как канал продаж в своём личном кабинете InnBook — сервис вернёт ошибку, и доступ к данным будет запрещён.

---

📤 Описание

Некоторые OTA используют этот метод как контент API для:

• создания у себя отсутствующих категорий номеров или тарифов
• актуализации названий, фотографий или схем размещения

---

📤 Запрос

{
  "hid": 455221,              // ID отеля в базе InnBook
  "rates": [20],              // Список ID тарифов
  "roomtypes": [49],          // Список ID категорий номеров
  "date_start": "2024-12-10", // Дата начала периода
  "date_stop": "2024-12-12"   // Дата окончания периода
}

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

Поле	Тип	Описание
hid	integer	ID отеля в системе Inn-Book
rates	array	Список ID тарифов
roomtypes	array	Список ID категорий номеров
date_start	string	Дата начала периода (YYYY-MM-DD)
date_stop	string	Дата окончания периода (YYYY-MM-DD)

---

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

{
  "49": [ // Ключ — ID категории номера по InnBook
    {
      "rates_id": 21,     // ID тарифа
      "seats": 2,         // Количество гостей (вариант размещения)
      "prices": [
        {
          "date": "2024-12-10", // Дата
          "price": 1410,        // Цена за ночь
          "close_s": 1,         // Закрыт для продажи (1 — да, 0 — нет)
          "ban_entr": 1,        // Ограничение на заезд (1 — запрещён)
          "ban_ext": 1,         // Ограничение на выезд (1 — запрещён)
          "min_dey": 1,         // Минимальное количество дней бронирования
          "max_dey": 1          // Максимальное количество дней бронирования
        }
      ]
    }
  ]
}

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

Основные поля

Поле	Описание
key	ID категории номера в Inn-Book
rates_id	ID тарифа
seats	Количество гостей (вариант размещения)
prices	Массив цен и ограничений на даты

Поля объектов в prices

Поле	Описание
date	Дата
price	Цена за ночь
close_s	Закрыт для продажи (1 — да, 0 — нет)
ban_entr	Ограничение на заезд (1 — запрещён)
ban_ext	Ограничение на выезд (1 — запрещён)
min_dey	Минимальное количество дней бронирования
max_dey	Максимальное количество дней бронирования