Скачать
- Расчёт пени по периодам — таблица с датами начала и конца периода, числом дней, остатком задолженности, ставкой и суммой пени за период.
- Итоговая строка — суммарная пени и общее количество дней просрочки в таблице.
- Отгрузки и оплаты — произвольное количество строк, добавление и удаление на фронтенде.
- Дата окончания расчёта — необязательное поле; если пусто, расчёт ведётся до последней оплаты или текущей даты.
- Загрузка примера — кнопка подставляет демонстрационный набор данных.
- Загрузка из файла — текстовый файл (.txt, .csv): в строке дата и сумма; положительная сумма — отгрузка, отрицательная — оплата. Таблицы отгрузок и оплат перед загрузкой очищаются.
- Методика FIFO — оплаты зачитываются в хронологии отгрузок; пени с первого дня после срока оплаты.
- 6 цветовых пресетов — оформление калькулятора через CSS-переменные.
- 5 текстовых блоков — включаются и редактируются в настройках; видимость дублируется атрибутами шорткода.
- Проверка обновлений — бейдж на странице «Плагины» и ссылка «Проверить обновления» без автоустановки.
| Параметр | Значение |
|---|---|
| Шорткод | [due-penalty-calc] |
| Опция БД | due_penalty_calc_settings |
| AJAX-действие | due_penalty_calc_run |
| Nonce | due_penalty_calc_run |
| Атрибуты шорткода | description, instructions, scientific, faq, disclaimer (1 / 0) |
| URL обновлений | https://smirnovcode.ru/updates/due-penalty-calc-smirnovcode.json |
| Кеш версии | transient due_penalty_calc_smirnovcode_remote_version, TTL 12 ч |
| PHP | 8.0+, без enum/readonly |
1. Установка и активация
- Скопируйте папку
due-penalty-calc-smirnovcodeвwp-content/plugins/. - В админке WordPress откройте Плагины и активируйте «Калькулятор пени за просрочку оплаты».
2. Настройка плагина
- Перейдите в Настройки → Калькулятор пени.
- Выберите цветовой пресет.
- При необходимости отредактируйте текстовые блоки и FAQ, сохраните изменения.
3. Вывод на странице
Вставьте в запись или страницу:
[due-penalty-calc]4. Параметры шорткода
| Атрибут | Значение | Описание |
|---|---|---|
description | 1 / 0 | Блок описания над калькулятором |
instructions | 1 / 0 | Инструкция под формой |
scientific | 1 / 0 | Методика расчёта |
faq | 1 / 0 | Аккордеон FAQ |
disclaimer | 1 / 0 | Дисклеймер |
Пример без FAQ:
[due-penalty-calc faq="0"]5. Проверка обновлений
На странице Плагины доступны ссылки Настройки и Проверить обновления. При наличии новой версии на smirnovcode.ru в строке описания плагина появится бейдж «Доступно обновление» со ссылкой на страницу плагина. Автообновление из админки WordPress не выполняется.
Версия 1.0.1
- Загрузка отгрузок и оплат из файла (дата + сумма, знак суммы).
- При импорте очищаются таблицы отгрузок и оплат.
Версия 1.0.0
- Первый релиз: расчёт пени по отгрузкам и оплатам, таблица периодов и итог.
- Шорткод
[due-penalty-calc], AJAX-расчёт, пример данных. - Настройки: 6 пресетов, текстовые блоки, FAQ.
- Механизм проверки обновлений с сервера smirnovcode.ru.
Демонстрация
Калькулятор пени за просрочку оплаты по договору поставки: укажите отсрочку платежа, ставку пени в процентах за каждый день просрочки, список отгрузок и оплат. Плагин построит таблицу начисления пени по периодам и покажет итоговую сумму.
Расчёт пени за просрочку оплаты
Таблица начисления пени
| # |
|---|
| Итого | 0 | 0 |
Инструкция
Шаг 1. Укажите количество дней отсрочки по договору и процент пени в день на остаток просроченной суммы.
Шаг 2. Заполните отгрузки (дата и сумма) и оплаты (дата и сумма). При необходимости добавьте строки кнопками «Добавить отгрузку» / «Добавить оплату».
Шаг 3. При необходимости задайте дату окончания расчёта (если поле пустое — расчёт ведётся до последней оплаты или текущей даты).
Шаг 4. Нажмите «Рассчитать пени» — ниже появится таблица периодов просрочки и итоговая сумма пени.
Шаг 5. Кнопка «Загрузить пример» подставляет типовой набор данных для проверки расчёта.
Шаг 6. Блок «Загрузка из файла»: каждая строка — дата и сумма (пробел, табуляция или «;»). Плюс — отгрузка, минус — оплата. Существующие строки в таблицах заменяются.
Методика расчёта
Срок оплаты. Для каждой отгрузки срок оплаты = дата отгрузки + дней отсрочки по договору.
Начало начисления пени. Пени начисляются с первого дня после истечения срока оплаты на непогашенный остаток по этой отгрузке.
Зачёт оплат. Поступившие платежи уменьшают задолженность по методу FIFO: сначала погашается самая ранняя отгрузка.
Колонки таблицы. «Сумма отгрузки» и «Сумма оплаты» — обороты за дни периода. «Сумма задолженности» — весь непогашенный долг на конец периода. «Просроченная задолженность» — часть долга с истёкшим сроком оплаты; пени начисляется только на неё.
Формула за период. Сумма пени = просроченная задолженность × (ставка % / 100) × количество календарных дней в периоде.
Таблица. Соседние дни с одинаковым остатком объединяются в один период для наглядности.
Частые вопросы
Пени (неустойка) — денежная сумма, которую должник уплачивает кредитору за просрочку исполнения денежного обязательства. Размер обычно установлен договором в процентах от неуплаченной суммы за каждый день просрочки.
В калькуляторе срок оплаты определяется как дата отгрузки плюс количество календарных дней отсрочки, указанных в договоре. Если отгрузок несколько, для каждой строки срок считается отдельно.
Начисление ведётся с первого календарного дня после даты, когда платёж должен был быть произведён согласно отсрочке, до момента погашения соответствующей части долга (или до даты окончания расчёта).
Оплаты зачитываются в хронологическом порядке по отгрузкам (FIFO): сначала погашается самая ранняя неоплаченная поставка, затем следующая. Это наиболее распространённый порядок при множественных отгрузках.
«Просроченная задолженность» — часть долга с истёкшим сроком оплаты; пени начисляется только на неё. «Сумма задолженности» включает также долг, срок оплаты по которому ещё не наступил.
Если задолженность ещё не погашена полностью, дата окончания ограничивает период начисления (например, датой подачи иска). Если поле пустое, расчёт продолжается до последней оплаты или текущей даты.
Результат расчёта носит справочный характер и не заменяет юридическую экспертизу. Условия договора (порядок зачёта платежей, исключение праздничных дней, лимит пени и т.д.) могут отличаться от заложенной в калькулятор модели. Перед предъявлением требований сверьте расчёт с текстом договора и при необходимости обратитесь к юристу.
