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

Банковская выгрузка

Банковская выгрузка используется для загрузки фактических оплат из клиент-банка или 1С. После загрузки система разбирает файл, создаёт платежи по счетам, пытается автоматически привязать их к счетам на оплату, определяет предполагаемого покупателя и обновляет статусы счетов.

Эпик переработки финансов: finance-redesign.md.
Архивация лишних платежей: archive-extraneous-payments.md (ITR-2964).

Где открыть​

МестоМаршрутНазначение
Банк (верхнее меню)/bank-statementsЖурнал загруженных выгрузок, загрузка нового файла
Платежи выгрузки/bank-statements/{id}/paymentsРазбор платежей конкретного файла
Финансы → Платежи/invoice-paymentsОбщий реестр платежей
Финансы → Нераспределённые платежи/invoice-payments/need-reviewОчередь платежей, требующих ручного разбора

Подробнее о платежах как сущности — Платёж по счёту.

Типовой сценарий​

  1. Бухгалтер выгружает из банка файл .txt.
  2. Открывает меню Банк → Загрузить выгрузку.
  3. В диалоге Добавить выгрузку выбирает файл и нажимает Сохранить.
  4. Система создаёт банковскую выгрузку и платежи; показывает диалог Итог загрузки файла со сводкой.
  5. Бухгалтер открывает платежи выгрузки (двойной клик по строке или действие в таблице).
  6. Платежи с ошибками или без привязки разбирает в таблице или переходит в Нераспределённые платежи.
  7. Посторонние платежи (не относятся к системе) архивирует на странице платежей выгрузки — см. Архивация лишних платежей.

Требования к файлу​

Загружается только файл с расширением .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.

Что происходит при загрузке​

  1. Читает файл и создаёт платежи по каждому документу.
  2. Отбрасывает дубликаты (номер + дата + счёт плательщика). Заархивированные платежи в поиске дублей не участвуют — повторная загрузка того же документа создаёт новый платёж.
  3. Для новых платежей определяет предполагаемого покупателя (SuggestedBuyer) по ИНН/КПП.
  4. Пытается автоматически привязать к счёту на оплату.
  5. Сохраняет ошибки сопоставления и пересчитывает статусы счетов.
  6. При статусе счёта Оплачен / Переплачен уведомляет сервис задач (закрытие задачи подписания спецификации, где применимо).
  7. Записывает сводку обработки и статус выгрузки.

Повторная загрузка того же содержимого не создаёт дубли. Если новых платежей не осталось — ошибка Данная выгрузка уже добавлена.

Автоматическая привязка к счету​

  1. В назначении платежа ищется номер счёта \b(\d+-\d+)\b (например 25-1).
  2. Ищется счёт с этим номером у покупателя по ИНН (и КПП, если указан).
  3. Проверяется счёт получателя и статус счёта (не Отменён).
  4. Создаётся связь на полную сумму платежа.

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

Ошибки сопоставления​

ОшибкаКогда возникает
В НазначениеПлатежа не найден номер счёта на оплатуНет номера в ожидаемом формате
Счёт на оплату … не найденНомер в назначении не существует
ИНН покупателя и указанный в счёте не совпадаютПокупатель счёта не совпал с плательщиком
Банковский счёт получателя в платеже и счёте на оплату различаютсяДругой счёт получателя
Привязана к отменённому счётуСчёт в статусе Отменён
По данному ИНН не найдено контрагентовНет покупателя для предполагаемого контрагента
Найдено несколько контрагентов по ИНННе удалось однозначно определить покупателя
Сумма платежей превышает сумму в счётеПереплата по счёту
К платежу привязано несколько счетов на оплатуНесколько связей (не штатный сценарий v1)

Платежи по выгрузке​

Страница /bank-statements/{id}/payments:

  • шапка с реквизитами выгрузки и карточками сводки;
  • таблица платежей (GET /Order/BankStatement/{id}/payments).

Колонки и действия — как в Платёж по счёту. Дополнительно на этом экране видны Статус разбора, Статус счёта, Предполагаемый покупатель, колонка Заархивирован, действия архивации.

Действия в таблице выгрузок журнала:

  • открыть все платежи;
  • открыть проблемные (фильтр на стороне UI по статусу/ошибкам);
  • открыть нераспределённые.

Архивация лишних платежей​

Для платежей, которые попали в файл банка случайно и не относятся к системе (внутренние переводы, чужие контрагенты, комиссии и т.п.).

Эпик: archive-extraneous-payments.md. Подробности сущности — invoicePayment.md.

Когда архивировать​

  • Платёж без привязки к счёту на оплату.
  • Бухгалтер уверен, что документ не нужно учитывать в OlMag.

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

Как сделать​

  1. Открыть /bank-statements/{id}/payments.
  2. По одной строке — действие Архивировать, или отметить несколько доступных строк (чекбоксы) и Архивировать выбранные.
  3. В диалоге указать обязательную причину и подтвердить.
  4. Строки остаются в таблице выгрузки (приглушённый стиль); в колонке «Активный» у них снята галочка, причина архивации — в подсказке. Фильтр по колонке «Активный» скрывает их при разборе.

Чекбоксы и массовое действие есть только на этой странице. Отметить можно только строки, где бек разрешил архивацию (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/tabletable_new
GET/BankStatement/{id}/InvoicePayment/table/Order/BankStatement/{id}/payments

Операции с платежами — в invoicePayment.md.

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