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

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

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

- написать новое сообщение (если у пользователя есть данное полномочие);
- запросить письма (см. раздел Запрос банковских писем);
- подписать, отклонить, удалить, редактировать, копировать письма для пользователей с соответствующими полномочиями (см. раздел Манипуляции с банковскими письмами)
- сбросить статус письма до черновика (доступно только администраторам), подробнее см. раздел Сброс статуса банковского письма до черновика;
- отсортировать письма при помощи стрелок в заголовках полей (см. раздел Представление данных, фильтрация и сортировка);
- отфильтровать письма при помощи пустых полей для поиска под заголовками (см. раздел Представление данных, фильтрация и сортировка);
- отфильтровать письма при помощи набора статусов;
- просмотреть информацию по документу, дважды кликнув на строчку с ним (см. раздел Форма “Банковское письмо”);

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

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

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

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

Развернутая информация о банковском письме

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

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

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

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

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

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

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

1. `Получатель` - выбирается из выпадающего списка, значения представлены в формате “Организация: Банк: Счет”. Доступен текстовый поиск;
2. `Категория` - выбирается из выпадающего списка, для каждого банка предусмотрен индивидуальный набор категорий. Доступен текстовый поиск;
3. `Тема` - заполняется пользователем вручную;
4. `Текст письма` - заполняется пользователем вручную (для банков, работающих по стандарту ISO, текст сообщения обязателен для заполнения и не должен превышать 1025 символов);
5. `Файлы` - при необходимости можно прикрепить к письму файлы:
   - Кнопка `Добавить файлы` - по нажатию на кнопку открывается Проводник для выбора файла, который необходимо вложить в сообщение;
   - Кнопка удаления - предусмотрена возможность удалить вложенный файл нажатием на кнопку;
   - Кнопка скачивания вложений - по кнопке можно скачать вложение.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4. `Связанные документы` - вкладка отображается только для тех писем, у которых есть связанные документы. Например, на этой вкладке отображаются квитанции, полученные от банка в ответ на письмо.

Связанные документы на форме Банковское письмо

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

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

### Быстрый просмотр информации о письме

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

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

- Номер письма из банка.
- Дата и время получения письма.
- Сообщение.

Для исходящих писем отображается только сообщение.

Информация входящего письма

### Отмечание письма прочитанным/непрочитанным

Для удобства банковские письма могут помечаться как прочитанные (столбец `Прочитано`). Письма могут помечаться прочитанными как автоматически, так и вручную.

Письмо автоматически помечается прочитанным, если его открыли или скачали вложение письма.
Для ручного изменения статуса письма в шапке раздела находится кнопка `Пометить прочитанным`. Она становится активна при выборе в таблице одного или нескольких непрочитанных писем, или при выборе писем в обоих статусах. Кнопка меняется на `Пометить непрочитанным` при выборе в таблице только просмотренных писем.

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

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

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

Пример:

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

Настройка модели счета

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

Настройка полномочий пользователя

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

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

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

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

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

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

### Повторная отправка банковских писем

При ошибках доставки документы можно отправлять в банк повторно, для этого над таблицей находится кнопка `Отправить повторно`. Кнопка доступна для документов в статусе Ошибка при отправке, для документов ВТБ также в статусе Направлено адаптеру в НРД.

Внимание: для модуля Т-Банк кнопка `Отправить повторно` недоступна.

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

### Просмотр переписки

Для удобства работы с письмами в разделе Банковские письма предусмотрена кнопка `Показать переписку`. Кнопка доступна над таблицей, справа от кнопки `Отправить повторно`.

Кнопка `Показать переписку` доступна при выполнении следующих условий:

1. В таблице выбрано не более одного письма.
2. У выбранного письма заполнен атрибут `Идентификатор переписки`.

При нажатии на кнопку в списке отображаются только письма, у которых идентификаторы переписки равны идентификатору выделенного письма. Это позволяет просмотреть всю переписку (входящие и исходящие письма) с банком по одному вопросу.

Для отмены фильтрации необходимо очистить поле под наименованием колонки “Идентификатор переписки”.

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

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

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

### Особенности создания банковских писем для модуля Т-Банк

Запрос писем - для Т-Банка реализован функционал запроса банковских писем в ручном и автоматическом режиме. При запросе писем для Т-Банка поля “Дата начала периода” и “Дата окончания периода” скрыты на форме запроса, так как данные атрибуты не передаются в банк.

Подробнее о запросе писем см. раздел Запрос банковских писем.

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

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

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

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

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

Создание банковского письма для модуля Райффайзенбанк

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

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

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

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

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

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

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

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

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

6. Если выбрана категория `Письмо для целей ВК`, то на форме будут отображаться поля для заполнения:

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

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

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

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

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

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

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

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

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

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

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

  Запрос справочников

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

  Получение справочника категорий писем

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

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

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

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

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

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

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

Подписание вложения

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

Подписание через Инфокрипт

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

Отправка вложения в банк

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

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

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

Подписание письма

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

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

Подписанное письмо первой подписью

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для категории писем Письмо для целей ВК дополнительно доступны поля:

- `Номер телефона ответственного сотрудника` - автоматически заполняется номером текущего пользователя, можно изменить вручную.
- `Тип документа-основания` — выберите документ из списка.
- `Уникальный номер контракт` — укажите номер контракта. Поле доступно, если в качестве типа документа-основания выбран `УНК`.
- `Номер договора (контракта)` — укажите номер договора. номер контракта. Поле доступно, если в качестве типа документа-основания выбран `Договор (контракт)`.
- `Дата контракта` — выберите дату контракта. Поле доступно, если в качестве типа документа-основания выбран `Договор (контракт)`.

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

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

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

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

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

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

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

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

   Добавление фазы подписания

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

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

   Настройка полномочий пользователя для запроса банковских писем

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

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

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

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

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

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

Сформированные запросы в табличной части

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

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

Рисунок - Фильтр по типу для модуля ВТБ (НРД)

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

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

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

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

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

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

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

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

- установить опцию `Автоматически запрашивать письма` и задать период и интервал, когда Мультибанк (Транзит 2.0) будет запрашивать письма. Значение задается в формате СRON (например, запрос писем каждый день в 8 утра в формате CRON будет выглядеть следующим образом `0 0 8 ? * * *`). При необходимости воспользуйтесь любым генератором CRON-выражений в интернете;

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

Настройка автоматического запроса банковских писем

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

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

Автоматически созданный запрос банковских писем

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

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

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

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

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

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

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

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

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

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

Ошибка при сохранении счета - неверный путь

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

Получено входящее письмо

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

Сохранение входящего письма на сервере Мультибанка (Транзит 2.0)

В данном примере входящее письмо было сохранено в формате PDF и как 1C файл (с расширением txt). Также было сохранено само вложение письма.
Файлы вложений сохраняются рядом с письмом в оригинальном расширении и именуются по схеме: {имя письма}_{имя файла}_{номер файла}.{расширение}. При этом нумерация файлов начинается с нуля, и с каждым новым файлом номер увеличивается на единицу.

Примечание: При желании можно сохранять данные форматы в отдельных директориях, для этого следует нажать на кнопку `Добавить папку`, и в одном блоке указать `1C` и путь к директории, а в другом выбрать `PDF` и путь к директории.

Сохранение форматов в разных директориях