Содержание

Банковские письма

Банковские письма — раздел Терминала Транзита, в котором осуществляется работа с банковскими письмами.

Раздел позволяет:

Представление данных, фильтрация и сортировка

В табличной части представлена информация о банковских письмах входящих и исходящих. Текущему пользователю банковские выписки по счету доступны для просмотра, при условии, что в настройках пользователя для искомого счета и типа документа включено полномочие Просмотр.
Полномочие на просмотр Банковского письма

При нажатии на левую кнопку мыши в строке таблицы будет представлена в развернутом виде информация по документу. Здесь можно увидеть:

  • Сообщение письма;
  • Вложенные файлы. Здесь же можно скачать вложенный файл, кликнув на него левой кнопкой мыши;
  • Возникшие ошибки на любом из этапов;
Развернутая информация о банковском письме

В разделе Банковские письма в табличной части отображаются следующие столбцы:

  • Отправитель - отображается отправитель сообщения, для исходящих сообщений отправителем будет организация, для входящих - банк. В качестве организации отображается сокращенное наименование организации из настроек счета. Значение в поле фильтра вводится вручную;
  • Получатель - отображается получатель сообщения, для исходящих сообщений получателем будет банк, для входящих - организация. Значение в поле фильтра вводится вручную;
  • Дата и время - отображается дата и время отправки сообщения. Значение в поле фильтра выбирыается из календаря;
  • Дата запроса - отображается дата запроса, данное поле заполняется только для запросов писем. Значение в поле фильтра выбирается из календаря;
  • Категория - отображается категория письма, для запросов писем поле не заполняется. Значение в поле фильтра устанавливается галочками, предусмотрена возможность текстового поиска для оперативного нахождения нужной категории из списка;
  • Тема - отображается тема письма. Значение в поле фильтра вводится вручную;
  • Статус - по аналогии с другими разделами в Терминале Транзита отображается текущий статус сообщения. Значение в поле фильтра устанавливается галочками, предусмотрена возможность текстового поиска;
  • Тип - отображается тип сообщения. Значение в поле фильтра устанавливается галочками, предусмотрена возможность текстового поиска;
  • Направление - может быть входящее или исходящее, при необходимости пользователь может отфильтровать записи в таблице только по входящим или только по исходящим сообщениям, включив соответствующий флажок;
  • Транспортный идентификатор - поле актуально для исходящих документов. По умолчанию столбец не отображается в табличной части, см. раздел Транспортный идентификатор;
  • Фазы - по аналогии с другими разделами в Терминале Транзита отображаются все фазы сообщения (подписание или согласование), выполненные фазы помечаются галочкой;

На рисунке ниже представлена табличная часть в разделе Банковские письма, и продемонстрирован пример установки фильтра в поле Направление с целью увидеть только исходящие сообщения:
Установка фильтров в разделе Банковские письма

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

Создание банковского письма

Перед созданием банковского письма необходимо настроить модель подписания для счета и типа документа Банковское письмо, а также установить пользователю полномочия на Импорт для этого счета и типа документа Банковское письмо. Чтобы пользователь мог также просматривать созданные банковские письма в табличной части не забудьте включить право на Просмотр документа.

Обратите внимание, что Терминал Транзита предоставляет возможность настройки модели подписания и полномочий пользователя для банковских писем как по дефолтному счету, так и по конкретному счету.

Для того чтобы создать банковское письмо, необходимо нажать на кнопку Новое сообщение, откроется форма Создать письмо, где предусмотрены следующие поля для заполнения:

  1. Получатель - выбирается из выпадающего списка, значения представлены в формате “Организация: Банк: Счет”. Доступен текстовый поиск;

  2. Категория - выбирается из выпадающего списка, для каждого банка предусмотрен индивидуальный набор категорий. Доступен текстовый поиск;

  3. Тема - заполняется пользователем вручную;

  4. Сообщение - заполняется пользователем вручную (для банков, работающих по стандарту ISO, текст сообщения обязателен для заполнения);

  5. Файлы - при необходимости можно прикрепить к письму файлы:

    • Кнопка Добавить файлы - по нажатию на кнопку открывается Проводник для выбора файла, который необходимо вложить в сообщение;
    • Кнопка удаления - предусмотрена возможность удалить вложенный файл нажатием на кнопку;
    • Кнопка скачивания вложений - по кнопке можно скачать вложение.

    Примечание: при добавлении вложений осуществляется контроль на превышение максимального объема, который составляет 195 мегабайт. Для писем Росбанка максимальный объем вложений составляет 75000 байтов.

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

На рисунке ниже приведен пример формы создания письма:
Создание банковского письма

Для некоторых банков, таких как Газпромбанк, ЮниКредит Банк, МКБ, МТС-банк, Совкомбанк, Кредит Урал Банк, ИНГ Банк, Меткомбанк, МС Банк Рус, СПФС ВТБ, Металлинвестбанк на форме предусмотрена дополнительная опция Предоставить ответ на запрос. Если опция включена, появляется поле Дата, не позднее которой требуется ответ, которое необходимо обязательно заполнить (можно заполнить поле из календаря или проставить дату вручную в формате DD.MM.YYYY). При включенной опции соответствующая отметка и указанная дата будут переданы в банк.

Ниже на рисунке приведен пример формы создания письма для одного из банков, для которого предусмотрена опция Предоставить ответ на запрос:
Создание банковского письма с дополнительной опцией

Важно: выше приведены примеры формы со стандартным набором полей, которые актуальны для большинства банков. Тем не менее для некоторых банков состав полей на форме может отличаться. Ниже будут приведены разделы, посвященные нюансам заполнения данной формы для некоторых банков (Уралсиб, Росбанк, Райффайзенбанк, Сбербанк, ВТБ (НРД)).

Форма “Банковское письмо”

При двойном нажатии на левую кнопку мыши в строке таблицы открывается форма “Банковское письмо”. На форме присутствуют следующие кнопки:

  1. Скачать- по кнопке скачивается документ. В случае если документ находится в статусе Черновик, то он будет сохранен в универсальном формате (json). Иначе, если документ был конвертирован в формат банка (при согласовании или подписании), то он будет скачен в формате банка (для большинства банков это формат ISO20020, для ряда банков предусмотрены свои форматы);
  2. Скачать PDF - документ скачивается в формате PDF;
  3. Обновить - обновляется форма в соответствии с актуальными данными по документу;
  4. Скачать диагностическую информацию - скачивается архив, который содержит следующие файлы:
    • Лог Терминала Транзита за дату проведения документа;
    • Версия приложения;
    • Информация с вкладки “Детализация” по документу;
    • Информация с вкладки “История статусов”;
    • Документ в формате банка;
    • Документ в универсальном формате;
    • Конфигурационный файл Терминала Транзита;
    • Конфигурационный файл модуля банка;

Данный архив может быть скачен и направлен в техническую поддержку при возникновении проблем или ошибок в процессе работы с приложением Транзит 2.0.

На форме предусмотрены следующие вкладки:

  1. Документ - отображаются все данные по письму (тема, сообщение, файлы и т.д.). По составу полей дублирует форму Создать письмо. По кнопке можно скачать вложение при условии, что у пользователя есть полномочия на просмотр вложений. При отсутствии полномочий на просмотр вложений скачивание невозможно. Здесь же можно отредактировать письмо при условии, что оно находится в статусе Черновик, и у пользователя имеются соответствующие полномочия (подробнее см. раздел Редактирование банковского письма);
  2. Детализация - отображаются параметры документа и их значения;
  3. История статусов - можно проследить изменение статусов документа;
  4. Содержимое документа - представлено содержимое документа. В случае если документ находится в статусе Черновик, то он будет отображен в универсальном формате (json). Иначе, если документ был конвертирован в формат банка (при согласовании или подписании), то он будет отображен в формате банка (для большинства банков это формат ISO20020, для ряда банков предусмотрены свои форматы);
Форма Банковское письмо
  1. Связанные документы - вкладка отображается только для тех писем, у которых есть связанные документы. Например, на этой вкладке отображаются квитанции, полученные от банка в ответ на письмо.
Связанные документы на форме Банковское письмо

Манипуляции с банковскими письмами

Терминал Транзита предоставляет пользователю возможность подписывать, отклонять, удалять, копировать, редактировать документ, а также сбрасывать до Черновика статус документа.

Ниже приведена подробная информация обо всех имеющихся возможностях.

Подписание банковского письма

В разделе Банковские письма предусмотрена кнопка Подписать / Согласовать для тех счетов, для которых настроенная модель включает фазы подписания/согласования.

Название кнопки динамично в зависимости от того, какой у текущей фазы тип - подписание или согласование. Если тип Подпись, то кнопка будет иметь название “Подписать и отправить” либо “Подписать” (в случае, если настроено несколько подписей, и проставляемая подпись не является заключительной). Аналогично, если настроено согласование, то кнопка называется “Согласовать и отправить” либо “Согласовать” (в случае если настроено несколько фаз согласований, и текущее согласование не является заключительным).

Пример:

Настроенная модель счета включает 2 фазы с типом Подпись:
Настройка модели счета

У пользователя настроены полномочия и настроена фаза Подпись:
Настройка полномочий пользователя

Чтобы пользователю подписать банковское письмо, необходимо отметить галочкой искомый документ (документы) в табличной части или же отметить галочкой искомую фазу в столбце Фазы, и нажать на кнопку Подписать.
Подписание банковского письма

Для пользователя, который будет ставить заключительную подпись, кнопка будет отображаться с названием Подписать и отправить.

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

Процесс подписания в Терминале Транзита одинаков для всех типов документов. С подробным описанием функционала подписания документов дополнительно можно ознакомиться в разделе Подписание документов в ТТ.

Отклонение банковского письма

В разделе Банковские письма предусмотрена кнопка Отклонить. Кнопка активируется только для документов в статусах Черновик или На контроле при условии, что у пользователя в настройках для искомого счета включено полномочие Отклонение.
Настройка полномочий пользователя

Чтобы отклонить документ, необходимо отметить его галочкой, после чего нажать на кнопку Отклонить.
Отклонение банковского письма

Если отклоняется документ в статусе Черновик, то он переходит в статус Отклонено пользователем, искомая запись в таблице выделяется красным цветом. Если отклоняется документ в статусе На контроле, то он переходит в статус Отклонено на этапе контроля, искомая запись в таблице также выделяется красным цветом.

Можно отклонить сразу несколько документов, отметив их всех галочкой, и нажав на кнопку Отклонить.

Удаление банковского письма

В разделе Банковские письма предусмотрена кнопка Удалить, которая позволяет удалять документы в статусах Черновик, Ошибка терминала, Отклонен на этапе контроля, Ошибка при отправке, Ошибка отправки и Ошибка преобразования.

Кнопка активируется только для документов в перечисленных выше статусах при условии, что у пользователя в настройках для искомого счета включено полномочие Удаление.
Настройка полномочий пользователя

Чтобы удалить документ, необходимо отметить его галочкой, после чего нажать на кнопку Удалить.
Удаление банковского письма

Искомый документ будет удален, тем самым исчезнет из табличной части.

Можно удалить сразу несколько документов, отметив их всех галочкой, и нажав на кнопку Удалить.

Копирование банковского письма

В разделе Банковские письма предусмотрена возможность копирования документа.

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

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

После того как документ был скопирован, его можно отредактировать и далее подписать и отправить. Если модель счета не предусматривает фазы подписания/согласования, то скопированный и далее отредактированный документ можно отправить нажав на кнопку Отправить в интерфейсе.

Редактирование банковского письма

Терминал Транзита предоставляет пользователю возможность редактирования банковских писем, находящихся в статусе Черновик. У пользователя для соответствующего счета и типа документа (Банковское письмо) должны быть установлены полномочия на Импорт, и соответственно на Просмотр (чтобы документ отображался в табличной части). При отсутствии прав на импорт документа функция редактирования будет не доступна пользователю.
Настройка полномочий для редактирования Банковского письма

Для того чтобы отредактировать банковское письмо, необходимо:

  1. дважды кликнуть на левую кнопку мыши в строке с искомым банковским письмом, после чего откроется форма Банковское письмо;
  2. на форме на вкладке Документ отредактировать необходимые данные;
  3. нажать на кнопку Сохранить - внесенные изменения будут сохранены;
Редактирование банковского письма

Сброс статуса банковского письма до черновика

Только для пользователей с правами “Администратор” предусмотрена кнопка Сбросить до черновика. По её нажатию осуществляется перевод документа в статус Черновик. Данная кнопка активируется только для документов, находящихся в статусе Ошибка терминала, Ошибка преобразования, На контроле, Отклонено на этапе контроля, Отклонено пользователем, Ошибка при отправке.

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

При необходимости можно сбросить до статуса Черновик сразу несколько документов. Для этого необходимо отметить галочкой все подходящие документы и нажать на кнопку Сбросить до черновика.

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

Особенности создания писем для банковских модулей

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

Более подробная информация представлена в разделах ниже.

Особенности создания банковских писем для модуля Райффайзенбанк

При создании банковских писем для модуля Райффайзенбанк на форме Создать письмо дополнительно предусмотрены следующие поля, являющиеся обязательными для заполнения:

  1. Тема - значение выбирается из выпадающего списка, доступен текстовый поиск по списку с целью облегчения поиска;
  2. Получатель письма - значение выбирается из выпадающего списка, доступен текстовый поиск по списку. Список получателей письма формируется на основании выбранной темы;
  3. Номер документа - значение в поле генерируется автоматически в соответствии с маской MMDDXX, где MM - текущий месяц, DD - текущий день, XX - номер письма за текущий день. Для сохранения уникальности номеров рекомендуется не изменять автоматически сгенерированное значение;

При перевыборе значения в поле Тема, поле Получатель письма очищается.

На рисунке ниже приведен пример заполнения формы Создать письмо для модуля Райффайзенбанк:
Создание банковского письма для модуля Райффайзенбанк

Создание и отправка писем в банк для модуля Сбербанк

Для отправки сообщения в Сбербанк необходимо:

  1. нажать на кнопку Создать сообщение, после чего откроется форма Создать письмо;

  2. на форме в поле Получатель выбрать счет сбербанка;

  3. заполнить поле Категория. Для модуля Сбербанк доступны следующие категории:

    • Уточнение по запросу Инобанка по валютному п.поручению (COMPLIANCE);
    • Копии документов (п/поручение, договора, исполнительные документы) - для данной категории доступен выбор вложения;
    • Ошибка в полученной справке - для данной категории доступен выбор вложения;
    • Уточнение реквизитов;
    • Отзыв платежа;
    • Отзыв платежа из картотеки;

    Внимание: список категорий, представленный выше, актуален для тестового контура. На продуктовом контуре справочник с категориями для Сбербанка может обновляться еженедельно или по запросу, следовательно, список категорий будет иной. Соответственно, для тех категорий, для которых предусмотрена поддержка вложений, на форме создания письма будет отображаться раздел Файлы. Подробнее по запросу справочника категорий писем см. раздел Запрос категорий писем Сбербанка.

  4. Заполнить поля Тема, Номер документа и Сообщение;

  5. Если выбрана категория, для которой Сбербанк поддерживает отправку писем с вложениями (см. пункт 3), то на форме будет доступен раздел Файлы, где по кнопке Добавить файлы можно выбрать файлы, которые необходимо прикрепить к письму. В наименованиях вложений Сбербанка не должны содержаться пробелы и символы кириллицы;

  6. Нажать кнопку Создать;

В случае если пользователь передумал сохранять введенные изменения, то на форме Создать письмо необходимо нажать на кнопку Отмена;

На рисунке ниже приведен пример заполнения формы Создать письмо для модуля Сбербанк. Указана категория, для которой не доступен выбор вложения:
Создание банковского письма для модуля Сбербанк без вложения

На рисунке ниже приведен пример заполнения формы для модуля Сбербанк с указанием категории, для которой доступен выбор вложения:
Создание банковского письма для модуля Сбербанк с вложением

Для модуля Сбербанк также реализован функционал отправки запросов банковских писем в ручном и автоматическом режиме. Подробнее см. раздел Запрос банковских писем.

Запрос категорий писем Сбербанка

Для Сбербанка реализована возможность запроса справочника категорий писем. Предусмотрено несколько способов обновления/получения справочника:

  • справочник можно запросить по кнопке Отправить запрос справочников в настройках банковского модуля:
    Запрос справочников

    По получению справочника будет обновлена табличная часть (наименование искомого справочника появится в таблице):
    Получение справочника категорий писем

  • справочник также будет обновлен/получен при получении кода авторизации пользователя через адаптер (при подписании оферты), подробнее см. раздел Настройка Терминала Транзита для адаптера Сбербанка;

  • справочник может быть получен/обновлен по расписанию, которое устанавливается в конфигурационном файле банковского модуля в ключе DictRequestPeriod. В качестве значения ключа задается периодичность в формате СRON.

Особенность отправки писем в Сбербанк

Существует некоторая особенность отправки писем с вложениями в Сбербанк. Сначала подписываются и отправляются в банк вложения, затем, после ответа банка, отправляется само письмо.

Ниже рассмотрим на конкретном примере, каким образом в Терминале Транзита осуществляется отправка письма с вложениями в Сбербанк.

Допустим, у нас есть письмо с вложениями для Сбербанка (процесс создания письма с вложениями был описан выше). В данном примере настроено 2 фазы подписания (у вас может быть иное количество фаз).

Сначала пользователь выделяет галочкой искомое письмо, и нажимает на кнопку Подписать:
Подписание вложения

Появляется модальное окно Подписание через Инфокрипт, где необходимо выбрать соответствующий PIN и ввести пароль, после чего нажать кнопку Авторизоваться и подписать:
Подписание через Инфокрипт

В этот момент подписывается и отправляется в банк само вложение. Сначала документ переходит в статус Направлено получателю (см. рисунок ниже). Можно заметить, что ни одна из фаз не была отмечена галочкой (столбец Фазы), поскольку само письмо еще не подписывалось. Выполнялось подписание и отправка в банк исключительно вложений письма.
Отправка вложения в банк

Внимание: Если настроено несколько фаз подписания, вложение может подписать любой из пользователей, имеющий полномочие на подписание документа на той или иной фазе.

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

Важно: пока документ находится в статусе Направлено получателю подписание невозможно, кнопка подписания активируется только после того, как документ переходит в статус Требует действия.
Подписание письма

Здесь также появляется модальное окно Подписание через Инфокрипт, где выбирается соответствующий PIN и вводится пароль, после чего нажимается кнопка Авторизоваться и подписать.

В нашем случае, после того как письмо было подписано, оно переходит в статус На контроле, поскольку у нас в примере настроены 2 фазы подписания. Здесь можно обратить внимание, что в столбце Фазы проставилась галочка, поскольку в этот раз было подписано само письмо.
Подписанное письмо первой подписью

В нашем примере на заключительном этапе второй пользователь подписывает документ на второй фазе, и выполняется отправка самого письма в банк:
Отправка письма в Сбербанк

Особенности создания банковских писем для модуля Росбанк

Внимание: для передачи зарплатных реестров в Росбанк можно использовать как тип документа Зарплатная ведомость (подробнее см. раздел Создание зарплатной ведомости для Росбанка), так и Банковское письмо. Для передачи зарплатного реестра как банковского письма используется категория Payroll - Зарплатные реестры (в банк будет передаваться сообщение с типом PAYR, которое будет принято как зарплатный реестр). См. рисунок ниже Создание зарплатного реестра для модуля Росбанк.

При создании банковских писем для модуля Росбанк на форме “Создать письмо” дополнительно предусмотрены следующие опции и поля:

  1. Опция Предоставить ответ на запрос - если опция включена, на форме появляется поле Дата, не позднее которой требуется ответ, которое необходимо обязательно заполнить (можно заполнить поле из календаря или проставить дату вручную в формате DD.MM.YYYY). При включенной опции соответствующая отметка и указанная дата будут переданы в банк;
  2. Номер телефона ответственного сотрудника - обязательное поле, которое должно быть заполнено в формате +X-XXX-XXXXXXX;
  3. Для категории Payroll - Зарплатные реестры дополнительно предусмотрены поля, обязательные для заполнения:
    • Номер реестра;
    • Дата реестра - можно заполнить из календаря или проставить вручную в формате DD.MM.YYYY;

На рисунке ниже приведен пример заполнения формы Создать письмо для модуля Росбанк, в частности продемонстрирован пример создания зарплатного реестра для отправки в банк:
Создание зарплатного реестра для модуля Росбанк

Примечание: при настройке модели подписания для счетов Росбанка реализована возможность указания типа подписи для каждой из фаз. Используя данный функционал, можно настроить для банковского письма одну подпись, но при этом с типом подписи, например, 3. В этом случае при подписании документа атрибуту signKind (тега signature) будет проставлено значение 3. Подробнее по данному функционалу см. раздел Модели подписания для счетов Росбанка.

Особенности создания банковских писем для модуля Уралсиб

При создании банковских писем для модуля Уралсиб на форме Создать письмо для категории Заказ наличных дополнительно предусмотрены следующие поля, являющиеся обязательными для заполнения:

  1. Сумма выдачи - значение суммы заполняется с клавиатуры;
  2. Дата выдачи - можно заполнить с клавиатуры в формате DD.MM.YYYY, либо воспользоваться кнопкой с иконкой календаря и выбрать нужную дату в окне календаря;
  3. Офис выдачи - значение выбирается из выпадающего списка, который формируется в соответствии с имеющимися записями в Базе данных. В поле предусмотрен текстовый поиск;

При выборе другой категории (отличной от “Заказ наличных”) перечисленные выше поля скрываются, введенные ранее в эти поля значения очищаются.

На рисунке ниже приведен пример заполнения формы Создать письмо с категорией Заказ наличных для модуля Уралсиб:
Создание банковского письма для модуля Уралсиб

На форме вне зависимости от выбранной категории также присутствует опция Предоставить ответ на запрос. Если опция включена, на форме появляется поле Дата, не позднее которой требуется ответ, которое необходимо обязательно заполнить (можно заполнить поле из календаря или проставить дату вручную в формате DD.MM.YYYY). При включенной опции соответствующая отметка и указанная дата будут переданы в банк.

Особенности создания банковских писем для модуля ВТБ (НРД)

При создании банковских писем для модуля ВТБ (НРД) на форме Создать письмо предусмотрены дополнительно следующие поля:

  1. Ф. И. О. ответственного сотрудника - обязательное поле, заполняется вручную, предусмотрена проверка на недопустимые символы;
  2. Получатель письма - необязательное поле, заполняется вручную;

На рисунке ниже приведен пример заполнения формы Создать письмо для модуля ВТБ (НРД):
Создание банковского письма для модуля ВТБ (НРД)

Для модуля ВТБ (НРД) также реализован функционал отправки запросов банковских писем в ручном режиме. Подробнее см. раздел Запрос банковских писем.

Запрос банковских писем

Запрос банковских писем в разделе Банковские письма предоставляет пользователю возможность отправки в банк запроса на получение писем за указанный период. Данный функционал поддерживается исключительно для модулей Сбербанк и ВТБ (НРД).

Для того чтобы выполнить запрос писем по искомому счету, необходимо:

  1. Настроить модель для счета в разделе Настройки->Счета, в качестве типа документа должен быть указан Запрос банковских писем. Ниже на рисунке приведен пример настройки модели для запроса банковских писем:
    Настройка модели для запроса банковских писем

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

    Важно: Настройка моделей подписания запросов банковских писем может выполняться как для конкретных, так и для дефолтных счетов.

  2. Настроить полномочия по искомому счету для пользователя. В качестве Типа документа необходимо указать “Запрос банковских выписок”, обязательно должно быть включено полномочие Импорт.
    Настройка полномочий пользователя для запроса банковских писем

    Важно: Настройка полномочий пользователя для запросов банковских писем может выполняться как для конкретных, так и для дефолтных счетов.

После того как модель для счета и полномочия пользователя для искомого счета настроены, можно использовать функционал запроса писем. Для этого необходимо нажать на кнопку Запросить письма - откроется форма Запрос писем, где заполняются следующие поля:

  1. Организация - выбирается из выпадающего списка;
  2. Счет для формирования запроса писем - выбирается из выпадающего списка (отображаются только те счета, для которых настроена соответствующая модель и полномочия пользователя, см. выше);
  3. Дата начала периода - указывается дата, начиная с которой необходимо получить письма от банка. Доступен выбор из календаря либо ручной ввод в формате DD.MM.YYYY;
  4. Дата окончания периода - указывается дата, до какого периода необходимо получить письма от банка. Доступен выбор из календаря либо ручной ввод в формате DD.MM.YYYY;

Далее необходимо нажать на кнопку “Отправить”.
Запрос банковских писем

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

Далее в зависимости от настроенных фаз в модели счета может понадобиться согласование документа “Запрос писем”.

Существует различие между тем как Сбербанк и ВТБ (НРД) обрабатывают полученный запрос банковских писем. Сбербанк на запрос присылает сразу все письма за указанный период, в то время как ВТБ (НРД) сначала присылает список писем без самих писем, после чего по каждому элементу списка запрашивается письмо. Делается это в автоматическом режиме, и никакие дополнительные действия от пользователя в данном случае не потребуются. Воспользовавшись фильтром в поле Тип можно увидеть сам список без писем, полученный от ВТБ (НРД) - для этого в фильтре устанавливается значение Список писем, и одиночные письма от ВТБ (НРД) - для этого в фильтре устанавливается значение Запрос письма. Данные значения фильтров применимы только для модуля ВТБ (НРД).
Рисунок - Фильтр по типу для модуля ВТБ (НРД)

В Терминале транзита в табличной части по результатам ответа от банка на запрос банковских писем отобразятся только те письма, которые ранее не были получены, таким образом дублирование писем исключено.

В Терминале Транзита поддерживается также автоматический запрос банковских писем, подробное описание данного функционала приведено в следующем разделе.

Автозапрос писем

В Терминале Транзита реализован функционал автоматического запроса писем для модулей Сбербанк и ВТБ (НРД).

Предварительно для счета должна быть настроена модель подписания для типа документа Запрос банковских писем.

Ниже на рисунке приведен возможный пример настройки модели подписания для запроса банковских писем:
Настройка модели для запроса банковских писем

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

  • установить опцию Автоматически запрашивать письма и задать период и интервал, когда Терминал Транзита будет запрашивать письма. Значение задается в формате СRON (например, запрос писем каждый день в 8 утра в формате CRON будет выглядеть следующим образом 0 0 8 ? * * *). Для работы с форматом можно воспользоваться конвектором, который доступен по ссылке: Free Online Cron Expression Generator and Describer;

Ниже на рисунке приведен пример карточки счета, где настроен автоматический запрос писем:
Настройка автоматического запроса банковских писем

Внимание: Настройка автозапроса писем в карточке счета может быть выполнена как для конкретных, так и для дефолтных счетов.

В соответствии с указанным расписанием в Терминале Транзита будут автоматически создаваться запросы банковских писем. На рисунке ниже в табличной части раздела “Банковские письма” видим автоматически созданный запрос банковских писем (за текущий день).
Автоматически созданный запрос банковских писем

Соответственно, чтобы текущий пользователь мог увидеть в табличной части созданные автоматически запросы банковских писем, у него должно быть в настройках полномочий включено полномочие на просмотр для искомого счета и типа документа Запрос банковских писем.

Далее для отправки в банк созданные автоматически запросы необходимо согласовать в случае, если настроенная модель подписания включает фазы согласования.

Если же для запроса банковских писем не предусмотрены фазы согласования, то после создания запрос автоматически будет отправлен в банк.

Автоматическое сохранение входящих писем

В Терминале Транзита предусмотрена возможность автоматического сохранения входящих писем.

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

  • в настройках установить опцию Автоматически сохранять письма;
  • по необходимости установить опцию Перезаписывать файл письма с совпадающим именем - в случае если нужна перезапись файлов с одинаковым именем;
  • выбрать формат сохранения документа: 1С и/или PDF, при необходимости можно сохранять документы в обоих форматах;
  • указать путь к директории сохранения писем на сервере Терминала Транзита;
  • в поле Формат наименования письма можно указать шаблон наименования выписок (справок по счету), в котором можно использовать переменные DD (день, двузначное число), MM (месяц, двузначное число), YY (последние две цифры года), YYYY (год), N (номер письма), вместо которых автоматически подставятся соответствующие значения. В этом поле можно также использовать переменную ORG, вместо которой будет проставляться название организации.
  • сохранить введенные настройки по кнопке Сохранить.

На рисунке ниже приведен пример введенных настроек для автосохранения входящих писем.
Включение автоматического сохранения входящих писем

В случае если указан неверный (несуществующий) путь к директории, то при попытке сохранить счет возникнет ошибка:
Ошибка при сохранении счета - неверный путь

При получении письма от банка, оно будет отображено в разделе Банковские письма в табличной части:
Получено входящее письмо

И, если включена настройка автоматического сохранения писем, то письмо будет сохранено в искомой директории на сервере Терминала Транзита в указанных форматах.
Сохранение входящего письма на сервере Терминала Транзита

В данном примере входящее письмо было сохранено в формате PDF и как 1C файл (с расширением txt). Также было сохранено само вложение письма.