Расчёт забронированных единиц проживания
Сценарий применяется для аналитики загрузки по конкретному тарифу за период. Метод возвращает суммарное количество забронированных единиц проживания (ночей или дней в зависимости от настроек АСУ) и не требует вебхук-триггера.
1. Запрос показателей
Запрос:
GET /api/pms-integration-storage/v1/properties/{{ propertyId }}/calculate-stay-units?firstStayDate=2025-05-15&lastStayDate=2025-08-15&pmsSideRatePlanCode=BAR1 HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{ access_token }}
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
propertyId | string (path) | Да | ID средства размещения. |
firstStayDate | string (query, date) | Да | Начало периода (включительно) в формате ISO-8601 yyyy-MM-dd, локальное время средства размещения. |
lastStayDate | string (query, date) | Да | Конец периода (включительно) в формате ISO-8601 yyyy-MM-dd, локальное время средства размещения. |
pmsSideRatePlanCode | string (query) | Да | Код тарифа на стороне PMS. Чувствителен к регистру. |
Ответ:
{
"stayUnits": 92
}
В расчёт попадают брони, у которых даты проживания пересекаются с указанным диапазоном и у которых выбранный тариф используется хотя бы в одном проживании. Значение возвращается как целое число — суммарное количество забронированных единиц проживания для тарифа за период.