2026-09-03 — Архивация лишних платежей из банковской выгрузки
Статус: Реализовано
Источник: Максим
Эпик: ITR-2964
Задачи реализации: бек ITR-2976, фронт ITR-2978.
Цель
Дать бухгалтеру возможность убрать из учёта платежи, которые попали в банковскую выгрузку по ошибке и не относятся к заказам в системе (оплаты других направлений, внутренние переводы, посторонние поступления).
Платёж не удаляется физически: он архивируется — исчезает из рабочих реестров и очередей, но на странице платежей конкретной выгрузки остаётся виден как заархивированный.
Контекст (как было)
- Бухгалтер загружает файл клиент-банка → система создаёт платежи и пытается привязать их к счетам.
- Часть документов в файле не имеет отношения к OlMag: зарплата, налоги, переводы между счетами, оплаты по другим юрлицам группы и т.п.
- Такие платежи попадали в Нераспределённые платежи, общий реестр Платежи, сводку выгрузки — и «засоряли» разбор.
- Не было способа убрать их из рабочих списков, кроме как оставить «непривязанными».
Как работает (реализация)
Пользовательская документация: bankStatement.md, invoicePayment.md.
Где доступно действие
| Место | Поведение |
|---|---|
Платежи банковской выгрузки (/bank-statements/{id}/payments) | «Архивировать» по строке и «Архивировать выбранные»; колонка «Активный» (у архивных галочка снята, причина — в подсказке) с фильтром; заархивированные строки остаются в таблице |
| Общий реестр Платежи | Заархивированные не показываются |
| Нераспределённые платежи | Заархивированные не показываются |
| Платежи в карточке счёта на оплату | Заархивированные не показываются |
| Вкладка Финансы заказа / контрагента | Заархивированные не участвуют в суммах и списках |
| Журнал Банковские выгрузки | Сводка (сумма / привязано / не привязано / требует проверки, статус) пересчитывается без учёта заархивированных; Created / Duplicate / Total в файле не меняются при архивации |
Сценарий бухгалтера
- Загружает банковскую выгрузку, открывает её платежи.
- Находит строки, которые не относятся к системе.
- Отмечает одну или несколько строк и выбирает «Архивировать» — либо архивирует по одной строке.
- В диалоге указывает обязательный комментарий и подтверждает.
- Строки помечаются как заархивированные; в остальных местах платежи больше не фигурируют.
Массовая архивация
Первая массовая операция в таблицах системы (чекбоксы только на странице платежей выгрузки).
- Чекбокс только у строк с
CanArchive; остальные не выбираются. - Одиночное «Архивировать» в строке — по тому же флагу.
- Бек: из пакета исключает привязанные / уже архивные / не найденные; если архивировать некого — 400; иначе 200 с итогами.
- Один диалог и один комментарий на всю операцию.
Ответ API архивации
PATCH /Order/InvoicePayment/batch-archive — тело: paymentIds + обязательный comment. Одиночная архивация = один id в списке. Роль: бухгалтер.
Успех (HTTP 200):
| Поле | Тип | Смысл |
|---|---|---|
paymentIds | Guid[] | Id платежей, которые реально заархивированы |
warning | string? | Если часть id пропущена (привязка, уже архив и т.п.) |
Ошибка (HTTP 400) — если после отбора допустимых список пуст. Без смеси «400 + успешный payload». Сводку/таблицу эндпоинт не отдаёт — фронт делает refetch GET .../BankStatement/{id}/payments.
Правила архивации
| Условие | Поведение |
|---|---|
| Платёж без привязки к счёту | Можно архивировать |
| Платёж с привязкой | На UI недоступно; в пакете — пропуск + warning; если некого архивировать — 400 |
| Уже заархивирован | Повторно нельзя |
| Повторная загрузка файла | Архивный платёж не считается дублем; при появлении того же документа снова — создаётся новый платёж |
При архивации: DateArchived, ArchiveComment; пересчёт сводки выгрузки в том же сохранении; исключение из реестров / need-review / счёта / финансов.
Восстановление из архива не предусмотрено — повторная загрузка выгрузки.
Права
| Действие | Роли |
|---|---|
| Архивировать | Бухгалтер |
| Просмотр заархивированных на странице выгрузки | Бухгалтер, Admin |
Принятые решения
| Тема | Решение |
|---|---|
| Способ «удаления» | Мягкая архивация (DateArchived), не физическое удаление |
| Где видны архивные | Только /bank-statements/{id}/payments |
| Ответ API | 200: paymentIds + опциональный warning; не 400+payload |
| Массовая архивация | Да; первая массовая операция в таблицах |
| Восстановление | Нет; обход — повторная загрузка |
| Комментарий | Обязателен |
Задачи эпика
| # | Задача | Содержание |
|---|---|---|
| 1 | Задача 1. Бек. Архивация платежа | Реализовано (ITR-2976) |
| 2 | Задача 2. Бек. Ограничения и CanArchive | Реализовано (ITR-2976) |
| 3 | Задача 3. Фронт. Архивация на странице выгрузки | Реализовано (ITR-2978) |
| 4 | Задача 4. Документация. Пользовательские материалы | Этот файл + bankStatement.md + invoicePayment.md |
Критерии приёмки
- Бухгалтер может архивировать непривязанный платёж — по одному и несколько выбранных.
- Обязателен комментарий.
- 200 →
paymentIds+ опциональныйwarning; 400 если архивировать некого. - Фронт показывает
warningи делает refetch платежей выгрузки. - Архивные не в реестре, need-review, платежах счёта, финансах.
- На странице выгрузки архивные видны; колонка «Активный» с фильтром.
- С привязкой на UI не выбираются; на беке в пакете — skip + warning.
- Восстановление отсутствует.
- Сводка выгрузки без учёта архивных (сумма / linked / unlinked / needReview / статус).
- Архивация только роли бухгалтер.
- Обновлена пользовательская документация.
Вне scope (первая версия)
- Восстановление заархивированного платежа
- Архивация целиком банковской выгрузки
- Автоархивация по правилам
- Журнал аудита «кто и когда архивировал»