Депозиты и штрафы

​

Обзор

​

Модель данных

​

Залог аренды

​

Штраф аренды

​

Где хранятся суммарные штрафы

​

Логика и побочные эффекты

​

Оформление и возврат залога

• Создание. Аренда берётся из адреса запроса, автор проставляется из текущего пользователя. Для текстового залога сумма обнуляется. После сохранения запускается пересчёт сумм аренды, чтобы залог учёлся в общей картине по заявке.
• Изменение. Работает симметрично: текстовый залог снова обнуляет сумму, затем идёт тот же пересчёт сумм аренды.
• Удаление. После удаления также выполняется пересчёт сумм аренды.
• Возврат. Отдельное действие возвращает залог клиенту: оно создаёт встречные расходные операции на внесённые по залогу деньги, переводит залог в статус «возвращён», проставляет дату возврата текущим моментом и пересчитывает суммы аренды. Залог ищется одновременно по своему идентификатору и по аренде из адреса запроса, поэтому вернуть через одну аренду залог другой нельзя.

​

Что происходит с деньгами при возврате залога

1. Считается остаток по залогу. Берутся все успешные операции, привязанные к этому залогу, и суммируются по каждой паре «вид оплаты + счёт». Возвращается именно остаток (приходы минус уже сделанные возвраты), а не номинал залога.
2. Создаются встречные расходные операции. На каждый положительный остаток создаётся расходная операция с отметкой возврата — той же формы, что и ручной возврат оплаты. Деньги уходят с того счёта, на который приходили (счёт определяется видом оплаты).
3. Залог помечается возвращённым. Проставляются статус «возвращён» и дата возврата, затем пересчитываются суммы аренды.

​

Ручные штрафы и пересчёт полей аренды

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

​

График разбивки штрафа

​

Автоматические штрафы по позициям инвентаря

• Если у позиции сумма штрафа стала нулевой — соответствующий авто-штраф по этой позиции удаляется.
• Если сумма изменилась (и не ноль) — авто-штраф обновляется.
• Если у позиции появился штраф, а записи ещё нет — авто-штраф создаётся.

​

Фоновое начисление штрафов за просрочку

​

Формула авто-штрафа за просрочку

Период просрочки = (фактический возврат или, если его нет, текущий момент)
                   − плановое окончание − время пауз

# штраф = 0, если:
#   позиция ещё не выдана, либо это продажа,
#   либо просрочка ещё в пределах грейс-периода

Штраф =
    шаг округления суммы ×
    ОКРУГЛ_ДО_ЦЕЛОГО(                             ← округление к ближайшему целому
        МАКСИМУМ(
            цена тарифа ×
            ОКРУГЛ_ШАГОВ( (Период просрочки − буфер) ÷ шаг начисления штрафа )
            ÷ округл_вверх( длительность тарифа ÷ шаг начисления штрафа )
            ÷ шаг округления суммы,
            0
        )
    )

• шаг начисления штрафа — из настройки аренды «Шаг начисления штрафа», а если не задан — 1 час;
• буфер (грейс-период) — по умолчанию 1 час;
• шаг округления суммы — по умолчанию 1;
• ОКРУГЛ_ШАГОВ — округление вверх, если включена настройка «штраф вперёд», иначе вниз. Округление вверх/вниз применяется только к числу просроченных шагов; внешнее приведение к целому округляет итог к ближайшему целому и от настройки «штраф вперёд» не зависит.

шагов сверх буфера = округл_вниз((5,5 ч − 1 ч) ÷ 1 ч) = округл_вниз(4,5) = 4
цена за шаг        = 3000 ÷ округл_вверх(24 ч ÷ 1 ч) = 3000 ÷ 24 = 125 ₸/час
штраф              = 1 × округл_до_целого(3000 × 4 ÷ 24 ÷ 1) = округл_до_целого(500) = 500 ₸

​

Расписание авто-штрафа

​

Как строится расписание

• Дата старта начислений = дата окончания позиции.
• Шаг начисления берётся из настройки шага начисления штрафа в аренде.
• Активно = аренда находится в статусе «в аренде» или «просрочка» и не удалена. В остальных статусах расписание помечается неактивным.

​

Как начисляются штрафы

1. Обрабатываются только компании с активным подключением интеграции аренды. Если у компании нет действующего подключения, её расписания в этом цикле не трогаются.
2. Расписание считается «пора», если оно активно и дата старта уже наступила, при этом выполнено хотя бы одно из условий: запусков ещё не было, с прошлого запуска прошёл хотя бы один шаг начисления, либо дата старта оказалась позже последнего запуска.
3. Для каждой аренды из расписания:
   • Если аренда удалена или её статус не «в аренде» и не «просрочка» — расписание по этой аренде удаляется, начисление не производится. Так завершённые, отменённые и забронированные аренды автоматически перестают штрафоваться.
   • Иначе выполняется начисление: пересчёт сумм аренды (который и обновляет штрафные поля), а для просроченных аренд дополнительно ставится уведомление «Аренда просрочена» — оно уходит сотрудникам, работавшим с этой арендой, и её создателю.
4. После обработки у обработанных за цикл расписаний обновляется отметка последнего запуска.

​

Как это используется

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

​

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

• Автоматический пересчёт штрафных полей аренды при сохранении/удалении штрафа срабатывает только для ручных штрафов; для автоматических он завершается сразу и ничего не пересчитывает.
• Поле авто-штрафов аренды пишет только пересчёт сумм аренды — по живой формуле просрочки и по всем позициям; сохранение или удаление ручного штрафа его не затрагивает.
• Ручной штраф, оформленный на клиента без привязки к аренде, сохраняется штатно и штрафные поля какой-либо аренды не меняет.
• Текстовый залог всегда принудительно обнуляет сумму при создании и изменении, даже если сумма была передана.
• Пропуск записи при пересчёте штрафных полей сравнивает только сумму ручных штрафов; общая сумма отдельно в условии не участвует, но пересчитывается вместе с ней.
• Возврат залога создаёт встречные расходные операции на остаток по залогу, поэтому повторный возврат ничего не создаёт, а по залогу без операций возврат просто меняет статус.
• Операции по возврату залога не порождают уведомлений — это то же правило, по которому не шумят операции по залогам и операции с отрицательной суммой.
• Условие срабатывания расписания включает три альтернативы: запусков ещё не было, с прошлого запуска прошёл шаг начисления, либо дата старта позже последнего запуска.
• Если у аренды нет позиций с датой окончания, удаление лишних расписаний внутри цикла не выполняется, так как оно вложено в перебор найденных дат.
• График штрафа валиден только если сумма по всем датам в точности равна сумме штрафа; проверка применяется только к непустому списку дат.

​

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