Банковская выгрузка
Банковская выгрузка используется для загрузки фактических оплат из клиент-банка или 1С. После загрузки система разбирает файл, создаёт платежи по счетам, пытается автоматически привязать их к счетам на оплату, определяет предполагаемого покупателя и обновляет статусы счетов.
Эпик переработки финансов: finance-redesign.md.
Архивация лишних платежей: archive-extraneous-payments.md (ITR-2964).
Где открыть
| Место | Маршрут | Назначение |
|---|---|---|
| Банк (верхнее меню) | /bank-statements | Журнал загруженных выгрузок, загрузка нового файла |
| Платежи выгрузки | /bank-statements/{id}/payments | Разбор платежей конкретного файла |
| Финансы → Платежи | /invoice-payments | Общий реестр платежей |
| Финансы → Нераспределённые платежи | /invoice-payments/need-review | Очередь платежей, требующих ручного разбора |
Подробнее о платежах как сущности — Платёж по счёту.
Типовой сценарий
- Бухгалтер выгружает из банка файл
.txt. - Открывает меню Банк → Загрузить выгрузку.
- В диалоге Добавить выгрузку выбирает файл и нажимает Сохранить.
- Система создаёт банковскую выгрузку и платежи; показывает диалог Итог загрузки файла со сводкой.
- Бухгалтер открывает платежи выгрузки (двойной клик по строке или действие в таблице).
- Платежи с ошибками или без привязки разбирает в таблице или переходит в Нераспределённые платежи.
- Посторонние платежи (не относятся к системе) архивирует на странице платежей выгрузки — см. Архивация лишних платежей.
Требования к файлу
Загружается только файл с расширением .txt. Интерфейс проверяет расширение до отправки на сервер.
Файл должен быть в формате обмена 1CClientBankExchange и кодировке Windows-1251. Система читает:
- дату создания выгрузки из поля
ДатаСоздания; - период —
ДатаНачала,ДатаКонца(если не распознаны — min/max дат платежей); - платежные документы между
СекцияДокументиКонецДокумента; - номер, дату, сумму, счета и реквизиты плательщика/получателя, назначение платежа.
Если дата создания выгрузки не заполнена или не распознана в формате dd.MM.yyyy, записывается текущая дата. Пустой файл или файл без документов — ошибка загрузки.
Таблица банковских выгрузок
Данные: GET /Order/BankStatement/table_new.
| Колонка | Что означает |
|---|---|
| Дата загрузки | Когда файл загружен в систему |
| Период выгрузки | Min–max дат платежей в файле |
| Дата файла | ДатаСоздания из файла |
| Автор | Кто загрузил |
| Статус | Успешно / Частично успешно / Ошибка |
| Платежей | Всего документов в файле |
| Сумма платежей | Общая сумма |
| Создано | Новых платежей (без дублей) |
| Дубли | Пропущено как уже существующие |
| Привязано | Автоматически связано со счетами |
| Не привязано | Без связи со счётом |
| Требует проверки | С ошибками сопоставления |
| Действия | Открыть все / проблемные / нераспределённые платежи |
По двойному клику открываются все платежи выгрузки. Доступны фильтры, сортировка, пагинация, настройка колонок.
Статус обработки выгрузки
| Статус | Условие |
|---|---|
| Успешно | Все новые платежи привязаны, ошибок нет |
| Частично успешно | Есть непривязанные или требующие проверки |
| Ошибка | Критическая ошибка обработки файла |
Колонка Требуется корректировка из старой таблицы (
GET .../table, obsolete) заменена статусом и счётчиками сводки.
Итог загрузки файла
После успешного POST /Order/BankStatement интерфейс показывает диалог со сводкой (processingSummary):
- платежей в файле и сумма;
- создано новых;
- дублей пропущено;
- привязано / не привязано;
- требует проверки.
Те же показатели доступны в шапке страницы /bank-statements/{id}/payments.
Что происходит при загрузке
- Читает файл и создаёт платежи по каждому документу.
- Отбрасывает дубликаты (номер + дата + счёт плательщика). Заархивированные платежи в поиске дублей не участвуют — повторная загрузка того же документа создаёт новый платёж.
- Для новых платежей определяет предполагаемого покупателя (
SuggestedBuyer) по ИНН/КПП. - Пытается автоматически привязать к счёту на оплату.
- Сохраняет ошибки сопоставления и пересчитывает статусы счетов.
- При статусе счёта Оплачен / Переплачен уведомляет сервис задач (закрытие задачи подписания спецификации, где применимо).
- Записывает сводку обработки и статус выгрузки.
Повторная загрузка того же содержимого не создаёт дубли. Если новых платежей не осталось — ошибка Данная выгрузка уже добавлена.
Автоматическая привязка к счету
- В назначении платежа ищется номер счёта
\b(\d+-\d+)\b(например25-1). - Ищется счёт с этим номером у покупателя по ИНН (и КПП, если указан).
- Проверяется счёт получателя и статус счёта (не Отменён).
- Создаётся связь на полную сумму платежа.
Если счёт найден с замечаниями (другой счёт получателя, отменённый счёт), связь может создаться, но платёж получит ошибку для ручной проверки.
Ошибки сопоставления
| Ошибка | Когда возникает |
|---|---|
| В НазначениеПлатежа не найден номер счёта на оплату | Нет номера в ожидаемом формате |
| Счёт на оплату … не найден | Номер в назначении не существует |
| ИНН покупателя и указанный в счёте не совпадают | Покупатель счёта не совпал с плательщиком |
| Банковский счёт получателя в платеже и счёте на оплату различаются | Другой счёт получателя |
| Привязана к отменённому счёту | Счёт в статусе Отменён |
| По данному ИНН не найдено контрагентов | Нет покупателя для предполагаемого контрагента |
| Найдено несколько контрагентов по ИНН | Не удалось однозначно определить покупателя |
| Сумма платежей превышает сумму в счёте | Переплата по счёту |
| К платежу привязано несколько счетов на оплату | Несколько связей (не штатный сценарий v1) |
Платежи по выгрузке
Страница /bank-statements/{id}/payments:
- шапка с реквизитами выгрузки и карточками сводки;
- таблица платежей (
GET /Order/BankStatement/{id}/payments).
Колонки и действия — как в Платёж по счёту. Дополнительно на этом экране видны Статус разбора, Статус счёта, Предполагаемый покупатель, колонка Заархивирован, действия архивации.
Действия в таблице выгрузок журнала:
- открыть все платежи;
- открыть проблемные (фильтр на стороне UI по статусу/ошибкам);
- открыть нераспределённые.
Архивация лишних платежей
Для платежей, которые попали в файл банка случайно и не относятся к системе (внутренние переводы, чужие контрагенты, комиссии и т.п.).
Эпик: archive-extraneous-payments.md. Подробности сущности — invoicePayment.md.
Когда архивировать
- Платёж без привязки к счёту на оплату.
- Бухгалтер уверен, что документ не нужно учитывать в OlMag.
С привязкой сначала отвязать счёт, затем архивировать. Восстановления из архива нет: при необходимости загружают выгрузку повторно (архивный экземпляр не блокирует создание нового платежа как дубль).
Как сделать
- Открыть
/bank-statements/{id}/payments. - По одной строке — действие Архивировать, или отметить несколько доступных строк (чекбоксы) и Архивировать выбранные.
- В диалоге указать обязательную причину и подтвердить.
- Строки остаются в таблице выгрузки (приглушённый стиль); в колонке «Активный» у них снята галочка, причина архивации — в подсказке. Фильтр по колонке «Активный» скрывает их при разборе.
Чекбоксы и массовое действие есть только на этой странице. Отметить можно только строки, где бек разрешил архивацию (CanArchive).
Где архивные не видны
Общий реестр Платежи, Нераспределённые платежи, платежи в карточке счёта, вкладки Финансы заказа и контрагента.
Сводка выгрузки
После архивации пересчитываются сумма активных платежей, привязано / не привязано / требует проверки и статус обработки. Счётчики «платежей в файле», «создано» и «дубли» при импорте не переписываются как дубли архивации.
Просмотр и корректировка платежа
См. Платёж по счёту:
- просмотр полей документа и привязанного счёта;
- смена привязки через диалог с таблицей счетов;
- комментарий —
PATCH .../comment; - архивация лишних платежей — см. выше.
Исходный документ (RawDocument) хранится зашифрованным; в таблицы не отдаётся.
Статусы счетов после оплаты
Ожидаемая сумма счёта:
- с процентом оплаты —
сумма × процент / 100; - без процента — 100% суммы счёта.
| Условие | Статус счёта |
|---|---|
| нет привязанных платежей | Не оплачен |
| оплачено меньше ожидаемой | Частично оплачен |
| оплачено ровно ожидаемую | Оплачен |
| оплачено больше | Переплачен |
При загрузке и при ручной смене привязки статус пересчитывается для затронутых счетов.
Тестовая выгрузка
GET /Order/PaymentInvoice/{id}/fakeBankStatement — генерация txt для тестирования (роли тестировщик, admin). Не рабочий сценарий бухгалтера.
Права доступа
| Действие | Роли |
|---|---|
| Страница Банк, просмотр журнала | бухгалтер, admin |
| Загрузка выгрузки | бухгалтер |
| Платежи выгрузки | бухгалтер, admin |
| Архивация платежа | бухгалтер |
| Нераспределённые платежи (меню Финансы) | бухгалтер, нач. продаж, admin |
| Общий реестр Платежи | бухгалтер, нач. продаж, admin |
| Смена привязки | см. invoicePayment.md |
Данные
Банковская выгрузка хранит:
- период (
PeriodStart,PeriodEnd), дату файла, дату загрузки; - автора, ссылку на документ;
ProcessingStatusId, счётчики сводки (NeedReviewPaymentsCount,UnlinkedPaymentsCountи др.);- список платежей.
Платёж — см. invoicePayment.md.
API
| Метод | Адрес | Назначение |
|---|---|---|
| GET | /Order/BankStatement/table_new | Журнал выгрузок (актуальный) |
| POST | /Order/BankStatement | Загрузка и разбор файла; в ответе — строка таблицы + processingSummary |
| GET | /Order/BankStatement/{id}/payments | Платежи выгрузки + сводка |
| GET | /Order/PaymentInvoice/{id}/fakeBankStatement | Тестовый txt |
Obsolete (ITR-2848):
| Метод | Адрес | Замена |
|---|---|---|
| GET | /Order/BankStatement/table | table_new |
| GET | /BankStatement/{id}/InvoicePayment/table | /Order/BankStatement/{id}/payments |
Операции с платежами — в invoicePayment.md.