> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yume.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Штрафы

> Учёт штрафов по арендам: автоматическое начисление за просрочку, штрафы вручную, статус оплаты и сводка.

Полный перечень полей — в [глоссарии](/ru/logic/metrics/penalties-glossary).

## Что показывает эта страница

Отчёт — это журнал штрафов по аренде: денег, которые клиент должен доплатить сверх стоимости аренды за просрочку,
повреждение или по решению сотрудника. Это отдельный список с постраничной выдачей и сводкой (агрегатами) в шапке
ответа, которая считается по тем же фильтрам, что применены к списку.

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

В отчёт включаются только штрафы с суммой, отличной от нуля, и только двух видов:

* **Автоматический штраф**, если он привязан к конкретной единице инвентаря в составе аренды;
* **Штраф, начисленный вручную**, независимо от того, привязан он к единице инвентаря или нет.

Автоматический штраф, который ещё не привязан ни к какой единице инвентаря, в отчёт не попадает.

<Note>
  Штраф технически может ссылаться либо на клиента напрямую, либо на конкретную аренду (заполняется хотя бы одно из двух) — это позволяет штрафовать клиента и без активной аренды. Это ограничение закреплено не только в форме ввода, но и на уровне самой базы данных.
</Note>

## Откуда берутся автоматические штрафы

Автоматический штраф по единице инвентаря создаётся и поддерживается фоновым пересчётом, который сравнивает текущую расчётную сумму штрафа по каждой единице инвентаря в аренде (например, за просрочку возврата) с уже существующими штрафами:

* если расчётная сумма стала нулевой, а штраф уже существует — штраф удаляется;
* если расчётная сумма изменилась и осталась не нулевой — штраф обновляется;
* если штрафа ещё нет, а расчётная сумма не нулевая — создаётся новый автоматический штраф.

Отдельно, по расписанию, фоновая задача проверяет активные аренды на просроченный возврат и обновляет связанные с арендой данные (в том числе пересчитывает автоматические штрафы); если аренда за это время была удалена или уже не находится в статусе «в аренде», её больше не проверяют повторно. За один запуск эта задача обрабатывает не более 100 просроченных аренд суммарно по всем компаниям — если лимит достигнут, часть просрочек будет обработана только в следующем цикле.

Штраф, оформленный сотрудником вручную, создаётся без такого фонового пересчёта — сотрудник указывает сумму и причину сам.

## Как считается итоговая сумма штрафов по аренде

При каждом сохранении или удалении штрафа, оформленного вручную, для соответствующей аренды пересчитываются три накопительных поля:

* сумма всех штрафов, оформленных вручную по этой аренде;
* сумма всех автоматических штрафов по аренде, которые **не привязаны** к конкретной единице инвентаря;
* их сумма — общая сумма штрафов аренды.

<Info>
  Пересчёт запускается при сохранении или удалении любого штрафа, но для автоматических штрафов он сразу завершается без действий — фактически суммы пересчитываются только в ответ на штрафы, оформленные вручную. Автоматические штрафы, привязанные к единице инвентаря, в эти накопительные суммы не входят в принципе (они поддерживаются отдельным фоновым механизмом, описанным выше).
</Info>

## Статус оплаты (вычисляется на лету)

В отчёте по штрафам статус оплаты не хранится в базе, а вычисляется в момент построения списка на основе фактически поступивших денег:

| Условие                                 | Статус           |
| --------------------------------------- | ---------------- |
| Оплаченная сумма равна нулю             | Не оплачен       |
| Остаток к оплате равен нулю             | Оплачен          |
| Оплачено частично (не 0 и не полностью) | Частично оплачен |

Оплаченная сумма — это не поле, хранящееся на самом штрафе, а сумма всех проводок прибыли, связанных с этим штрафом (то есть фактически распределённых поступивших платежей). Остаток к оплате — это сумма штрафа минус оплаченная сумма.

<Warning>
  На модели штрафа есть отдельное поле «оплаченная сумма», но отчёт его не использует и всегда считает оплату заново по проводкам прибыли. Если это поле на модели не синхронизировано, на отчёт это не влияет — он использует только вычисленное значение.
</Warning>

Распределение фактических платежей аренды между штрафом и прочими статьями (инвентарём, услугами, доставкой, скидками) происходит по единому механизму пересчёта прибыли аренды: платежи «размазываются» по дням и статьям в порядке приоритета, и остаток на штраф достаётся после того, как покрыты предыдущие статьи (см. [«Прибыль и окупаемость»](/ru/logic/profit-payback)). Штраф, оформленный вручную, распределяется на дату его создания; штраф за просрочку по единице инвентаря — на дату окончания аренды. Если платежей клиента не хватает на покрытие всех статей, штраф может остаться частично или полностью неоплаченным даже при формально закрытой аренде.

## Фильтры и поиск

Список штрафов можно отфильтровать по статусу оплаты, по сотруднику, оформившему штраф, по дате создания (диапазон), по клиенту, по точке проката (через связанную аренду) и по типу штрафа (автоматический/вручную). Поиск работает по имени и телефону клиента. Сортировка доступна по сумме, сотруднику и дате создания.

## Сводка в шапке отчёта

Поверх постраничного списка отчёт возвращает три агрегированные суммы по всем штрафам, попавшим под текущие фильтры (а не только по текущей странице): общая сумма штрафов, суммарно оплаченная сумма и суммарный остаток к оплате.

## Права доступа

Отчёт требует, чтобы у пользователя было право на просмотр данных метрик — доступ проверяется по стандартной модели прав компании и настраивается для ролей сотрудников отдельно от права на само начисление штрафа.

## Особенности поведения

* В отчёт попадают автоматические штрафы, только если у них есть привязка к единице инвентаря; автоматический штраф без такой привязки не отображается.
* Из отчёта полностью исключаются записи с нулевой суммой штрафа.
* Штраф может ссылаться либо на клиента, либо на аренду, либо на оба сразу, но не может остаться без обеих привязок — это гарантировано на уровне базы данных.
* Пересчёт накопительных сумм штрафов аренды запускается при любом изменении штрафа, но фактически ничего не делает для автоматических штрафов — пересчитываются только штрафы, оформленные вручную.
* Фоновая проверка просроченных аренд обрабатывает не более 100 просрочек за один запуск по всем компаниям сразу — при превышении лимита часть просрочек обрабатывается только в следующем цикле.
* При расчёте прибыли штраф, оформленный вручную, относится на дату его создания, а автоматический штраф по инвентарю — на дату окончания аренды, а не на дату фактического начисления просрочки.

## Связанные страницы

<CardGroup cols={2}>
  <Card title="Глоссарий: Штрафы" icon="book" href="/ru/logic/metrics/penalties-glossary">
    Полный перечень полей штрафа и вычисляемых показателей отчёта.
  </Card>

  <Card title="Метрики и аналитика" icon="chart-line" href="/ru/logic/metrics">
    Хаб раздела аналитики со ссылками на все отчёты компании.
  </Card>

  <Card title="Скидки" icon="percent" href="/ru/logic/metrics/discounts">
    История применения скидок к арендам и сводная группировка по каждой скидке из справочника.
  </Card>

  <Card title="Депозиты" icon="vault" href="/ru/logic/metrics/deposits">
    Залоги по аренде: денежные и предметные, статусы и фактические платежи.
  </Card>

  <Card title="Обзор и общая сводка" icon="gauge" href="/ru/logic/metrics/overview">
    Дневная сводка по компании: доход, заявки и детализация — точка входа в аналитику.
  </Card>

  <Card title="Финансы: список, PnL, движение денег" icon="money-bill-wave" href="/ru/logic/metrics/finances">
    Финансовые отчёты компании: список операций, прибыли и убытки, движение денег.
  </Card>

  <Card title="Транзакции" icon="receipt" href="/ru/logic/metrics/transactions">
    Сводка транзакций: разбивка по видам оплаты и постраничный список операций.
  </Card>

  <Card title="Услуги" icon="sparkles" href="/ru/logic/metrics/services">
    Метрики дополнительных услуг: общая сводка, список по видам, по исполнителям и история.
  </Card>

  <Card title="Зарплаты и субаренда сотрудников" icon="wallet" href="/ru/logic/metrics/salaries-sublease">
    Расчёт зарплат по выполненным действиям и учёт субаренды инвентаря сотрудникам.
  </Card>

  <Card title="Амортизация и окупаемость инвентаря" icon="arrow-trend-down" href="/ru/logic/metrics/depreciation-payback">
    Амортизация единиц инвентаря и накопленная окупаемость дохода по группам и единицам.
  </Card>

  <Card title="Эффективность инвентаря" icon="gauge-high" href="/ru/logic/metrics/efficiency">
    Загрузка и простой инвентаря по комплектам, группам и отдельным единицам.
  </Card>

  <Card title="Рефералы и клиенты" icon="users" href="/ru/logic/metrics/referrals-clients">
    Реферальная программа (агенты и начисления) и клиентская аналитика: рост, отток, LTV.
  </Card>

  <Card title="Смены сотрудников" icon="clock" href="/ru/logic/metrics/workshifts">
    Список и детализация рабочих смен персонала на точках проката.
  </Card>

  <Card title="Модули: доставки, мастерская, воронки, склад, инвентаризации" icon="truck" href="/ru/logic/metrics/modules">
    Отчётность прикладных модулей: доставки, мастерская, воронки продаж, продажи и инвентаризации.
  </Card>

  <Card title="Бонусы сотрудников" icon="gift" href="/ru/logic/metrics/bonuses">
    Баланс, история и общая сводка бонусных начислений клиентам.
  </Card>
</CardGroup>
