Балансы броней

Единый отчёт для работы с просроченной дебиторкой, открытыми долгами, переплатами и зависшими после возврата сделками. В одном месте — все ситуации, когда у брони ненулевой баланс.

Как открыть

Раздел Отчёты → «Балансы броней».

Что попадает в отчёт

Открытый долг (balanceType = debt) — бронь не закрыта полностью, гость должен. Включая брони с будущим сроком оплаты — они помечаются статусом «Срок не наступил».
Переплата (balanceType = overpaid) — внесённая гостем сумма больше итоговой стоимости брони. Частый сигнал, что платёж занесён не на ту бронь.
К списанию (был возврат) — гостю оформлен полный возврат, но бронь так и не закрыта записью «Списан». Денег с гостя мы не ждём, но «висячую» сделку нужно закрыть.
«Платёж не на ту бронь» — переключатель в фильтрах. Показывает гостей, у которых одновременно есть бронь с долгом и бронь с переплатой: типичный признак ошибки разнесения.

Отменённые брони и no-show в отчёт не попадают — для них баланс операционного смысла не имеет.

Сводка сверху (6 KPI-карточек)

Открытый долг — общая сумма долга и количество броней
Из них просроч. — долги с истёкшим сроком оплаты
Глубокая просрочка 90+ — самая старая корзина, проблемная задолженность
Переплаты — общая сумма и количество броней с переплатой
К списанию — счётчик броней с полным возвратом, ожидающих списания (сумма справочная — это не реальный долг)
Платёж не на ту бронь — счётчик гостей с одновременным долгом и переплатой

Фильтры

Все фильтры сохраняются в URL — ссылку с настроенными фильтрами можно отправить коллеге. Применённые фильтры показываются пилюлями под строкой фильтров: клик по крестику убирает один, кнопка «Очистить всё» — все разом.

Фильтр	Описание
Поиск	По имени гостя, номеру брони или названию юнита
Срок долга	Корзины старения: 0–30 дн. / 31–60 / 61–90 / 90+
Статус	Срок не наступил, Не согласовано, Отсрочка, Отсрочка истекла, В споре, Подтверждён, К списанию (был возврат), Списан, Переплата
Тип баланса	Только долги / только переплаты
Платёж не на ту бронь	Переключатель — таблица меняется на список гостей с одновременной парой долг + переплата

По умолчанию списанные долги в выдаче скрыты — они показываются только при явном выборе статуса «Списан» в фильтре.

Статусы долга

Статус	Когда применяется
Срок не наступил	Долг есть, но эффективный срок оплаты ещё в будущем. Не считается просрочкой
Не согласовано	Дефолтный статус для просроченных долгов
Отсрочка	Оператор зафиксировал договорённость с гостем о позднем платеже, согласованный срок ещё впереди
Отсрочка истекла	Согласованный срок прошёл, гость так и не доплатил
В споре	Гость оспаривает сумму — например, доплату за поздний выезд
Подтверждён	Легитимный долг, который не нужно собирать: бесплатное проживание гостя владельца, корпоративный клиент, сотрудник. Не считается просрочкой и не учитывается в уведомлениях
К списанию (был возврат)	Гостю оформлен полный возврат, бронь не закрыта записью «Списан». Денег не ждём — нужно оформить списание. Перекрывает остальные статусы долга
Списан	Безнадёжный долг. По умолчанию скрыт в отчёте, отдельно отмечается в бухгалтерии
Переплата	Используется для строк с переплатой

Управление статусом

Кнопки «Подтвердить долг», «В спор», «Списать долг», «Вернуть в Не согласовано» живут не в отчёте, а на самой странице брони — в секции «Статус задолженности». Секция видна, только если у брони есть фактический долг или переплата, и при этом долг просрочен, ранее уже размечался оператором, либо бронь уже формально завершена (выезд / no-show) с остатком долга.

Право менять статус (bookings.debt.collection.update) есть у ролей Администратор, Управляющий и Бухгалтер (и Супер-админ). Без права секция видна, но кнопки скрыты.

В том же окне изменения статуса оператор может включить согласованную отсрочку — указать дату, до которой гость обещал погасить остаток. Бронь уходит из просрочки в статус «Отсрочка», и по ней включаются напоминания накануне и в день срока.

При смене статуса нужно указать причину (для всех статусов кроме «Не согласовано»). Списание — действие необратимое: оператор обязан поставить галочку «Я понимаю, что списываю долг — это видно бухгалтеру и в журнале изменений», только тогда красная кнопка разблокируется.

Таблица

Колонка	Описание
Просрочка	Бейдж с количеством дней и корзиной (0–30 / 31–60 / 61–90 / 90+). Чем старее долг, тем насыщеннее цвет. У согласованной отсрочки и долга с будущим сроком — зелёный/нейтральный таймер «через N дн.», у остальных без просрочки — прочерк
Тип/Статус	Бейдж со статусом долга. Hover-подсказка: кто и когда поменял статус + причина
Гость	Имя гостя — ссылка на карточку. Знак ⚠ — подозрение на платёж не на ту бронь
Бронь	Номер брони
Юнит	Название номера
Заезд / Выезд	Даты
Срок	Эффективный срок оплаты (`outstandingDueAt`, либо `paymentDueAt`, либо `checkOut` — в этом порядке)
Сумма	Долг (красный, со знаком «−») или переплата (синий, со знаком «+»)

Клик по строке открывает бронь. Имя гостя — отдельная ссылка на карточку гостя.

Снизу — пагинация по 100 строк (опции: 10/25/50/100), сохраняется в URL.

Режим «Платёж не на ту бронь»

Включённый переключатель меняет таблицу на список гостей: по каждому — сумма долга, сумма переплаты и нетто-баланс. Это самый быстрый способ увидеть, у кого платёж сел не на ту бронь, и переразнести его. Клик по строке открывает карточку гостя на вкладке броней.

Экспорт

Кнопка Excel скачивает текущую выдачу с учётом всех фильтров.