Перейти к основному содержимому

2026-09-03 — Архивация лишних платежей из банковской выгрузки

Статус: Реализовано

Источник: Максим

Эпик: ITR-2964

Задачи реализации: бек ITR-2976, фронт ITR-2978.

Цель​

Дать бухгалтеру возможность убрать из учёта платежи, которые попали в банковскую выгрузку по ошибке и не относятся к заказам в системе (оплаты других направлений, внутренние переводы, посторонние поступления).

Платёж не удаляется физически: он архивируется — исчезает из рабочих реестров и очередей, но на странице платежей конкретной выгрузки остаётся виден как заархивированный.

Контекст (как было)​

  • Бухгалтер загружает файл клиент-банка → система создаёт платежи и пытается привязать их к счетам.
  • Часть документов в файле не имеет отношения к OlMag: зарплата, налоги, переводы между счетами, оплаты по другим юрлицам группы и т.п.
  • Такие платежи попадали в Нераспределённые платежи, общий реестр Платежи, сводку выгрузки — и «засоряли» разбор.
  • Не было способа убрать их из рабочих списков, кроме как оставить «непривязанными».

Как работает (реализация)​

Пользовательская документация: bankStatement.md, invoicePayment.md.

Где доступно действие​

МестоПоведение
Платежи банковской выгрузки (/bank-statements/{id}/payments)«Архивировать» по строке и «Архивировать выбранные»; колонка «Активный» (у архивных галочка снята, причина — в подсказке) с фильтром; заархивированные строки остаются в таблице
Общий реестр ПлатежиЗаархивированные не показываются
Нераспределённые платежиЗаархивированные не показываются
Платежи в карточке счёта на оплатуЗаархивированные не показываются
Вкладка Финансы заказа / контрагентаЗаархивированные не участвуют в суммах и списках
Журнал Банковские выгрузкиСводка (сумма / привязано / не привязано / требует проверки, статус) пересчитывается без учёта заархивированных; Created / Duplicate / Total в файле не меняются при архивации

Сценарий бухгалтера​

  1. Загружает банковскую выгрузку, открывает её платежи.
  2. Находит строки, которые не относятся к системе.
  3. Отмечает одну или несколько строк и выбирает «Архивировать» — либо архивирует по одной строке.
  4. В диалоге указывает обязательный комментарий и подтверждает.
  5. Строки помечаются как заархивированные; в остальных местах платежи больше не фигурируют.

Массовая архивация​

Первая массовая операция в таблицах системы (чекбоксы только на странице платежей выгрузки).

  • Чекбокс только у строк с CanArchive; остальные не выбираются.
  • Одиночное «Архивировать» в строке — по тому же флагу.
  • Бек: из пакета исключает привязанные / уже архивные / не найденные; если архивировать некого — 400; иначе 200 с итогами.
  • Один диалог и один комментарий на всю операцию.

Ответ API архивации​

PATCH /Order/InvoicePayment/batch-archive — тело: paymentIds + обязательный comment. Одиночная архивация = один id в списке. Роль: бухгалтер.

Успех (HTTP 200):

ПолеТипСмысл
paymentIdsGuid[]Id платежей, которые реально заархивированы
warningstring?Если часть id пропущена (привязка, уже архив и т.п.)

Ошибка (HTTP 400) — если после отбора допустимых список пуст. Без смеси «400 + успешный payload». Сводку/таблицу эндпоинт не отдаёт — фронт делает refetch GET .../BankStatement/{id}/payments.

Правила архивации​

УсловиеПоведение
Платёж без привязки к счётуМожно архивировать
Платёж с привязкойНа UI недоступно; в пакете — пропуск + warning; если некого архивировать — 400
Уже заархивированПовторно нельзя
Повторная загрузка файлаАрхивный платёж не считается дублем; при появлении того же документа снова — создаётся новый платёж

При архивации: DateArchived, ArchiveComment; пересчёт сводки выгрузки в том же сохранении; исключение из реестров / need-review / счёта / финансов.

Восстановление из архива не предусмотрено — повторная загрузка выгрузки.

Права​

ДействиеРоли
АрхивироватьБухгалтер
Просмотр заархивированных на странице выгрузкиБухгалтер, Admin

Принятые решения​

ТемаРешение
Способ «удаления»Мягкая архивация (DateArchived), не физическое удаление
Где видны архивныеТолько /bank-statements/{id}/payments
Ответ API200: 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 (первая версия)​

  • Восстановление заархивированного платежа
  • Архивация целиком банковской выгрузки
  • Автоархивация по правилам
  • Журнал аудита «кто и когда архивировал»

Связанные материалы​