Получение ежедневной статистики заполняемости

Метод возвращает ежедневную статистику заполняемости и выручки для средства размещения за указанный период.

Ограничения: диапазон между startStayDate и endStayDate не должен превышать 31 день.

Запрос:

GET /api/pms-analytics/v1/properties/5431/daily-occupancy?startStayDate=2026-01-01&endStayDate=2026-01-25 HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{ access_token }}

Параметры:

Параметр	Тип	Обязательный	Описание
propertyId	path	Да	Идентификатор средства размещения
startStayDate	query	Да	Начало периода (ISO-8601 YYYY-MM-DD). Лимит диапазона — 31 день
endStayDate	query	Да	Конец периода (ISO-8601 YYYY-MM-DD). Лимит диапазона — 31 день
otbDate	query	Нет	Дата снимка OTB (On-the-Books). Фильтрация по дате создания бронирования

Ответ:

{
  "currencyCode": "RUB",
  "propertyRoomCount": 90,
  "dailyOccupancies": [
    {
      "date": "2026-01-01",
      "occupancyRate": 0.85,
      "closedRoomCount": 7,
      "occupancyRoomCount": 79,
      "complimentaryOccupancyRoomCount": 3,
      "roomRevenue": 158000,
      "revenue": 195000,
      "mealRevenue": 37000,
      "arrivalCount": 15,
      "guestCount": 120
    },
    {
      "date": "2026-01-02",
      "occupancyRate": 0.82,
      "closedRoomCount": 7,
      "occupancyRoomCount": 76,
      "complimentaryOccupancyRoomCount": 2,
      "roomRevenue": 152000,
      "revenue": 188000,
      "mealRevenue": 36000,
      "arrivalCount": 12,
      "guestCount": 115
    }
  ]
}

Опциональный параметр otbDate

Параметр otbDate позволяет получить статистику на основе снимка бронирований на указанную дату. Если параметр указан, в расчёт попадают только бронирования, созданные на дату otbDate или ранее. Это полезно для ретроспективного анализа и отчётности «как было на книге» на определённый момент времени.

Пример запроса с otbDate:

GET /api/pms-analytics/v1/properties/5431/daily-occupancy?startStayDate=2026-01-01&endStayDate=2026-01-25&otbDate=2025-12-15 HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{ access_token }}