Содержание

API Оркестратор

С целью упрощения установки и сокращения выделение мощностей на стороне клиента был разработан сервис, объединяющий все адаптеры - API Оркестратор. Данный сервис представляет собой группу адаптеров для взаимодействия напрямую с API банков.

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

Описаны инструкции для ОС:

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

Введение настроек в Мультибанке (Транзит 2.0)

После того как была успешно выполнена инсталляция, необходимо ввести ряд настроек в Мультибанке (Транзит 2.0). Необходимо выполнить следующие шаги:

  1. В Мультибанке (Транзит 2.0) авторизоваться под пользователем с правами Администратора и перейти в панель настроек администратора в раздел Адаптеры, здесь на начальном этапе будет отображаться только один подраздел – Терминал.
    Настройки Терминала

    В подразделе Терминал в поле Шаблоны для предзаполнения настроек (заполняются только пустые поля) следует выбрать готовый шаблон – По умолчанию (localhost), после чего автоматически будет заполнен блок Настройки подключения к маршрутизатору.
    Выбор шаблона при настройке Терминала

    Внимание: если адрес маршрутизатора не соответствует значению localhost, то необходимо ввести нужный адрес. В качестве адреса указывается DNS-имя сервера либо IP адрес (при этом обязательно нужно указать протокол https://<DNS-имя или IP-адрес>). Допустимо использование исключительно протокола https, протокол http не поддерживается.

    После того как все настройки были перепроверены и введены, необходимо нажать на кнопку Отправить, после чего в меню появится подразделы маршрутизатор, и подразделы Адаптеров банков. В скобках отображаются версии маршрутизатора и адаптеров, а индикаторы серого цвета напротив появившихся подразделов означают, что Маршрутизатор и адаптеры еще не были сконфигурированы. Дальнейшая настройка осуществляется на шагах 2 и 3.
    Подразделы Маршрутизатор и Адаптеры банков

  2. Необходимо перейти в подраздел маршрутизатор. Здесь также следует выбрать готовый шаблон в поле Шаблоны для предзаполнения настроек (заполняются только пустые поля) - поля с настройками будут заполнены автоматически. Далее важно перепроверить заполненные поля. Например, адрес сервера базы данных (поле Адрес сервера относительно маршрутизатора) может отличаться. Следует также перепроверить порты. Дополнительно потребуется заполнить поля Имя пользователя и Пароль (в блоке Настройки базы данных).

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

    Примечание: если установка является первичной (ранее старая версия адаптера для Сбербанка/Райффайзенбанка не устанавливалась и не использовалась), то понадобится выполнить установку сервера БД PostgreSQL (см. раздел Установка PostgreSQL).

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

  3. На этом этапе осуществляется настройка адаптеров необходимых банков. Необходимо перейти в подраздел Адаптера банка. Для ускорения введения настроек в поле Шаблоны для предзаполнения настроек (заполняются только пустые поля) выберите нужный контур (тестовый или промышленный).
    Настройка адаптеров

    После выбора шаблона автоматически будет заполнена большая часть полей. Необходимо будет дозаполнить поля Идентификатор клиента и Секретный код клиента. Для Адаптера Сбербанка необходимо дополнительно выбрать файл сертификата для TLS подключения по кнопке + Выбрать файл и указать пароль к TLS-сертификату.

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

    Для Адаптера Сбербанка также можно дополнительно указать Адрес сервиса больших файлов для ФПСУ, при этом поле не является обязательным к заполнению.

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

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

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

    Примечание: если ранее использовалась старая версия адаптера Райффайзенбанка, то необходимо будет удалить ранее полученные хэши, и выполнить авторизацию заново. Подробнее см. раздел Обновление Хэша для Райффайзенбанка. Для Сбербанка никаких дополнительных манипуляций не потребуется.

Внимание: Начиная с 21 версии Мультибанка (Транзит 2.0) ссылка для редиректа (redirect_uri) должна указывать на адрес терминала, а не на адрес адаптера, как было ранее. Адрес переадресации должен соответствовать значению {адрес хоста}/adapters/{банковский модуль(sberbank|raiffeisenbankapi)}. Этот же адрес указывается в настройках Мультибанка (Транзит 2.0) в разделе Адаптеры для конкретного адаптера банка (поле Адрес, на который будет произведена переадресация при успешном получении accessToken). Данное поле автоматически заполняется соответствующей ссылкой при выборе нужного контура в поле Шаблоны для предзаполнения настроек.
Ссылка для редиректа

Ввиду этого изменения не забудьте в личных кабинетах банков указать правильные ссылки для редиректа (переадресации) или согласовать ссылку редиректа с банком:

  • Для Сбербанка - в СББОЛ в услуге SberBusinessAPI в параметре «redirect_uri» необходимо указать адрес терминала ({адрес хоста}/adapters/sberbank);
  • Для Райффайзенбанка - URI редиректа ({адрес хоста}/adapters/raiffeisenbankapi), на который сервис Райффайзенбанка будет отправлять ответы по результатам аутентификации, предварительно требуется согласовать c Райффайзенбанком.

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

Обновление Хэша для Райффайзенбанка

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

  1. перейти в панель настроек администратора в раздел Банковские модули, выбрать модуль Райффайзенбанк (API), нажать на кнопку :
    Удаление Хэша из таблицы

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

  2. Нажать на кнопку Авторизоваться:
    Авторизация

    Будет выполнен автоматический переход на страницу авторизации сервиса Райффайзенбанка.

  3. На странице авторизации сервиса Райффайзенбанка необходимо ввести логин и пароль, и нажать на кнопку Войти:
    Авторизация на странице сервиса Райффайзенбанка

  4. После авторизации осуществляется переадресация на Терминал (согласно настройкам адаптера, поле Адрес, на который будет произведена переадресация при успешном получении accessToken). Открывается страничка с информацией об успешной авторизации, где необходимо нажать на кнопку Войти:
    Успешная авторизация

  5. На последнем шаге следует проверить появление кода авторизации в таблице в настройках искомого банковского модуля. Для этого необходимо перейти в Настройки:
    Переход в Настройки

    После чего перейти в раздел Банковские модули, выбрать модуль Райффайзенбанк (API) в списке, и убедиться, что в Таблице кодов авторизации появился Хэш:
    Появление Хэша в Таблице кодов авторизации

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

Примечание: дополнительные настройки Мультибанка (Транзит 2.0), которые потребуется ввести при первичной установке адаптера Райффайзенбанка описаны в разделе Настройка Мультибанка (Транзит 2.0) для адаптера Райффайзенбанка.

Адаптер Райффазенбанка

Настройка Мультибанка (Транзит 2.0) для адаптера Райффайзенбанка

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

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

  1. Перейти в панель настроек администратора в раздел Банковские модули, выбрать модуль Райффайзенбанк (API), нажать на кнопку Авторизоваться:
    Авторизация

    Будет выполнен автоматический переход на страницу авторизации сервиса Райффайзенбанка.

  2. На странице авторизации сервиса Райффайзенбанка необходимо ввести логин и пароль, и нажать на кнопку Войти:
    Авторизация на странице сервиса Райффайзенбанка

  3. После авторизации осуществляется переадресация на Терминал (согласно настройкам адаптера, поле Адрес, на который будет произведена переадресация при успешном получении accessToken). Открывается страничка с информацией об успешной авторизации, где необходимо нажать на кнопку Войти:
    Успешная авторизация

  4. Проверить появление кода авторизации в таблице в настройках искомого банковского модуля. Для этого необходимо перейти в Настройки:
    Переход в Настройки

    После чего перейти в раздел Банковские модули, выбрать модуль Райффайзенбанк (API) в списке, и убедиться, что в Таблице кодов авторизации появился Хэш:
    Появление Хэша в Таблице кодов авторизации

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

  5. Необходимо полученный хэш привязать к организации. Для этого нужно перейти в настройки соответствующей организации, и в поле Идентификатор Райффайзенбанка выбрать из выпадающего списка полученный на шаге 3 хэш (код авторизации). При наличии нескольких кодов авторизации в выпадающем списке, можно дополнительно ориентироваться по имени пользователя.
    Настройки организации - выбор хэша

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

  6. Счета, для которых планируется получать выписки, используя адаптер, необходимо привязать к модулю «Райффайзенбанк (API)»:
    Настройки счета Райффайзенбанка

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

Идентификатор клиента в модуле Райффайзенбанк (API)

В разделе Адаптеры на вкладке Адаптер Райффайзенбанка в таблице Учетные данные организации есть возможность добавлять идентификатор клиента. Доступно создание более одного идентификатора клиента.
Учетные данные организации

Для создания следует:

  1. Нажать на кнопку Добавить
  2. В модальном окне заполнить поля:
    • Идентификатор клиента* - текстовое поле, заполняется вручную, допускается ввод любых символов;
    • Секретный код клиента* - текстовое поле, заполняется вручную, допускается ввод любых символов;
    • Описание* - текстовое поле, указывается дополнительная информация об идентификаторе клиента;
  3. Нажать на кнопку Сохранить.
Создание идентификатора клиента

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

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

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

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

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

Настройка Мультибанка (Транзит 2.0) для адаптера Сбербанка

Организационная подготовка. Подключение

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

В процессе взаимодействия со Сбербанком необходимо будет заполнить Заявление от банка для подключения к сервису/каналу Sber API. Если подключения требует Холдинг (несколько ЮЛ), то сервис API подключается только для головной компании. При этом, необходимо иметь в виду, что в случае наличия планов по подключению к сервису Мультибанка (Транзит 2.0) Мультибанк (и к каналу Sber API) дочерних организаций необходимо выбирать пункт «Прямая интеграция с Банком (холдинг)».

Такой тип интеграции запрашивается по электронной почте в Сбербанк с электронной почты уполномоченного администратора системы Заказчика, указанного изначально в ЛК Головной компании при подключении канала API. Если к каналу Sber API будет подключена одна организация, то выбрать следует пункт «Прямая интеграция с Банком (host2host)».

В ответ на заявление от Сбербанка будет направлена Анкета, содержащие все параметры подключения к сервису SberBusiness API (пример анкеты).

Для настройки Мультибанка (Транзит 2.0) Сбербанка потребуются следующие данные:

  • Client_ID (Идентификатор клиента) получаете в Сбербанке,
  • Secret_key (Секретный код клиента) получаете в Сбербанке,
  • Scope (v1) (Параметр, определяющий права доступа для access_token) получаете в Сбербанке,
  • Redirect URI (Адрес, на который будет произведена переадресация при успешном получении accessToken) пользователь отправляет Сбербанку. Значение Redirect URI берется из поля «Адрес, по которому будет произведена переадресация при успешном получении accessToken» после выбора шаблона в поле «Шаблоны для предзаполнения настроек (заменяются только пустые поля)».
  • TLS Certificate (Файл сертификата для TLS подключения, Пароль к TLS-сертификату) получется пользователем в Сбербанке.

Эти данные потребуются для подписания оферты. Получить эти данные Вы можете из Анкеты, либо обратившись в техническую поддержку Сбербанка supportdbo2@sberbank.ru Все указанные параметры являются едиными для всех компаний Холдинга. После подключения Sber API в ЛК СББОЛ головной компании на почту ответственному администратору приходят указанные параметры. Отдельной кнопкой выпускается TLS Certificate в ЛК СББОЛ Головной компании.

Ниже подробно будет описан процесс подписания оферты.

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

Ниже будет приведен порядок действий по подписанию оферты, который потребуется выполнить при первичной установке адаптера Сбербанка или в случае регистрации нового пользователя в ССБОЛ.

Внимание: Пользователь СББОЛ подписывает оферту в Мультибанке (Транзит 2.0) для головной организации с точки зрения Sber API (организация, которая имеет client_id Sber API), должен иметь признак ЕИО (единоличный исполнительный орган) и/или доступ к вызову /v1/crypto/eio (метод GET_CRYPTO_INFO_EIO, CRYPTO_CERT_REQUEST_EIO). В случае отсутствия доступа к этому методу его необходимо заказать – уточнить наличие доступа и заказать его можно, обратившись в техническую поддержку Сбербанка по услуге Sber API supportdbo2@sberbank.ru При подписании оферты дочерних организаций необходимо использовать сертификат пользователя дочерней организации, при этом признак ЕИО (единоличный исполнительный орган) не обязателен.

Для выполнения подписания оферты рекомендуем воспользоваться браузером Google Chrome или Mozilla Firefox. Необходимо выполнить следующие шаги:

  1. Для подписания оферты на рабочем месте подписанта необходимо войти в СББОЛ соответствующим пользователем/токеном Сбербанка – см. замечание выше.

  2. В дополнительной вкладке браузера в web-интерфейсе Мультибанка (Транзит 2.0) необходимо зайти пользователем с правами Администратора.

  3. В интерфейсе Мультибанка (Транзит 2.0) перейти в Настройки в раздел Банковские модули, в списке банков слева выбрать Сбербанк, перейти на вкладку Расширенные настройки к таблице кодов авторизации, и нажать на кнопку Подписать оферту под таблицей:
    Подписание оферты

  4. Выбрать способ подписания оферты (Токен или СМС). Для способа СМС дополнительно выбирается адрес для подписи по СМС.
    Выбор способа подписания оферты

    После нажатия на кнопку Подписать осуществляется переадресация на Терминал (согласно настройкам адаптера, поле Адрес, на который будет произведена переадресация при успешном получении accessToken). Открывается страничка с информацией об успешной авторизации, где необходимо нажать на кнопку Войти:
    Успешная авторизация

  5. Проверить появление кода авторизации в таблице в настройках искомого банковского модуля. Для этого необходимо перейти в Настройки:
    Переход в Настройки

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

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

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

  7. После выполнения всех настроек выше следует выполнить тестовый запрос выписки по любому счету этой Организации, но лучше по всем для проверки всех настроенных/выданных полномочий на стороне Банка.

Если на шаге 4 возникнет какая-либо ошибка при попытке подписать оферту, пользователю будет выведено соответствующее сообщение. Например, как на рисунке ниже:
Ошибка при подписании оферты

На рисунке выше приведен лишь один из примеров возможных ошибок.

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

Получение/обновление списка сертификатов и договоров для Сбербанка

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

По кнопке обновляется таблица с сертификатами в соответствии с имеющимися изменениями:
Появление/обновление списка сертификатов

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

Примечание: по кнопке также обновляется таблица кодов авторизации. Например, если в таблице имя пользователя не заполнено, то можно при помощи данной кнопки обновить информацию в данном поле (поле заполнится).

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

Появится таблица со списком договоров:
Появление/обновление списка договоров

Внимание: если список договоров претерпел какие-либо изменения (после действий с организацией/пользователем, повторного подписания оферты и т. д.), то в Мультибанке (Транзит 2.0) не забудьте обновить список договоров по кнопке .

Идентификатор клиента в модуле Сбербанк

В разделе Адаптеры на вкладке Адаптер Сбербанка в таблице Учетные данные организации есть возможность создавать идентификатор клиента. Доступно создание более одного идентификатора клиента.
Учетные данные организации

Для создания следует:

  1. Нажать на кнопку Добавить
  2. В модальном окне заполнить поля (значком * помечены обязательные для заполнения поля):
    • Идентификатор клиента* - текстовое поле, заполняется вручную, допускается ввод любых символов;
    • Секретный код клиента* - текстовое поле, заполняется вручную, допускается ввод любых символов;
    • Описание* - текстовое поле, указывается дополнительная информация об идентификаторе клиента;
    • Ручное заполнение ClientScope - чекбокс, определяющий как заполняется ClientScope:
      • Если чекбокс выбран, становится доступно поле Параметр, определяющий права доступа для access_token для указания атрибутов и операций, согласно требованиям Scope.
      • Если чекбокс не выбран, становится доступен выпадающий список Операции для выбора операций, атрибуты в таком случае не указываются. Если после выбора операций и сохранения настроек модуля выбрать чекбокс ручного заполнения, то поле Параметр, определяющий права... заполнится автоматически атрибутами и выбранными операциями.
    • Включить автообновление секретного кода клиента - чекбокс включает автоматическое обновление ключа каждые 30 дней. Если выключен, то срок действия ключа истечет через 40 дней, связь со Сбербанком будет недоступна. В таком случае будет необходимо оформить новый код.
  3. Нажать на кнопку Сохранить.
Создание идентификатора клиента

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

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

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

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

В разделе Банковские модули, в модуле Сбербанк, созданные идентификтаторы отображаются в таблице Таблица кодов авторизации на вкладке Расширенные настройки. Для отображения добавленного идентификатора клиента следует нажать на кнопку Обновить.
Таблица кодов авторизации

Сбербанк - получение нового кода авторизации (взамен старого)

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

  1. В настройках организации в поле Идентификатор организации необходимо вместо установленного кода Сбербанка выбрать из списка значение Не выбрано, далее нажать на кнопку Сохранить.
    Удаление идентификатора Сбербанка в настройках организации

  2. В разделе Банковские модули перейти к настройкам модуля Сбербанка, на вкладке Расширенные настройки в таблице кодов авторизации необходимо удалить код для искомой организации:
    Удаление кода авторизации в настройках модуля

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

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

  3. После выполнения п.2 в дополнительной вкладке браузера требуется войти в СББОЛ под токеном/логином Гендиректора организации, для которой необходимо получить новый код авторизации.

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

    Выбрать способ подписания оферты (Токен или СМС). Для способа СМС дополнительно выбирается адрес для подписи по СМС.
    Выбор способа подписания оферты

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

    Примечание: если при подписании оферты возникла ошибка, необходимо прислать скрин с текстом ошибки, логи Мультибанка (Транзит 2.0) и Сберадаптера на адрес технической поддержки transit-help@nsd.ru.

  5. Проверить появление кода авторизации в таблице в настройках искомого банковского модуля. Для этого необходимо перейти в Настройки:
    Переход в Настройки

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

  6. После успешного выполнения предыдущих шагов, необходимо перейти в настройки искомой организации, и в поле Идентификатор организации выбрать из списка новый код авторизации для Сбербанка, далее нажать на кнопку Сохранить.
    Установка нового идентификатора Сбербанка в настройках организации

  7. После выполнения всех настроек выше следует выполнить тестовый запрос выписки по любому счету этой Организации.

Настройка одновременного количества подключений для адаптеров Сбербанка и Райффайзенбанка

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

  • Количество одновременных подключений для отправки документов - отображает количество подключений к сервисам банков для отправки документов
  • Количество одновременных подключений для запросов статусов - отображает количество подключений к сервисам банков для запроса статусов
  • Период запроса статусов - отображает таблицу с полями:
    • Тип документа
    • 1 запрос
    • 2 запрос
    • 3 запрос
    • 4 запрос
    • Период
    • Время жизни
    • Действия
Раздел “Настройка запросов”

Для добавления записи в таблицу следует нажать на кнопку Добавить.

В модальном окне заполнить поля:

  • Тип документа - выпадающий список документов для выбора
  • 1 запрос - указывается количество минут после истечения которых отправляется первый запрос
  • 2 запрос - указывается количество минут после истечения которых отправляется второй запрос
  • 3 запрос - указывается количество минут после истечения которых отправляется третий запрос
  • 4 запрос - указывается количество минут после истечения которых отправляется четвертый запрос
  • Период - указывается количество минут после истечения которых отправляются следующие запросы
  • Время жизни - указывается количество дней повтора отправки запросов

Для добавления записи следует нажать на кнопку Сохранить.
Добавление записи

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

Возможные ошибки и их устранение

Ошибки Секретного кода клиента (Client secret)

Если не удается подписать Сбероферту и отправить документы в Сбербанк, вероятно дело в истекшем Client secret: по какой-то причине он не обновился автоматически.

Возможные причины ошибок Client secret:

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

    1. Задайте в СББОЛ новый код.
    2. В окне организации укажите новый код в поле Секретный код клиента.
    3. Также в окне организации включите чекбокс Включить автообновление секретного кода клиента.

  • Если Client secret запрашивается пользователем с ролью ЕИО, возможно в настройках модуля Сбербанка, в таблице кодов авторизации, отсутствует пользователь ЕИО, или его заблокировали в Сбербанке. Чтобы исправить:

    1. Задайте в СББОЛ новый код.
    2. В окне организации укажите новый код в поле Секретный код клиента.
    3. Подпишите оферту пользователем ЕИО. Если подписать оферту не получилось, обратитесь в Сбербанк.

  • Если client secret запрашивается через доступ к сервису ЕИО: в настройке Ручное заполнение ClientScope адаптера Сбербанка была выбрана опция Запрос на выпуск сертификата для ЕИО. Возможно, опция отключена, чтобы исправить:

    1. Включите опцию.
    2. Задайте в СББОЛ новый код.
    3. В окне организации укажите новый код в поле Секретный код клиента.
    4. Переподпишите оферту всеми пользователями организации.

Ошибки сертификата TLS SSL

Если при отправке документов в Сбербанк возникает ошибка с упоминанием TLS, вероятно дело в сертификате TLS SSL.

Возможные причины ошибок сертификата TLS:

  • Не добавлен файл сертификата. Если сертификат не добавлен, то в адаптере Сбербанка под настройкой Файл сертификата для TLS подключения будет находиться кнопка Выбрать для выбора сертификата. Чтобы исправить:

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

  • Добавлен неверный файл сертификата. Название загруженного файла невозможно увидеть, поэтому можно сразу попробовать исправить. Чтобы исправить:

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

  • Истек срок действия TLS-сертификата. Срок действия можно посмотреть в локальном хранилище сертификатов. Чтобы исправить:

    1. Выпустите новый сертификат в СББОЛ.
    2. Скачайте новый сертификат в СББОЛ и загрузите с помощью кнопки Выбрать под полем Файл сертификата для TLS подключения.
    3. Укажите пароль сертификата в поле Пароль к TLS-сертификату, в настройках адаптера Сбербанка.

  • Proxy-сервер блокирует TLS-соединение. При этом, если отключить proxy-сервер, соединение восстанавливается.
    Чтобы исправить, настройте соединение со Сбербанком минуя proxy-сервер.

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

Дополнительная информация и документы

В разделах ниже представлена дополнительная информация, которая может быть полезна при работе с сервисом API Оркестратор, и другие инструкции.

Логи и перезагрузка

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

Бывают ситуации когда возникшая проблема может быть решена перезагрузкой маршрутизатора и/или адаптеров. Для этого в подразделах предусмотрена кнопка перезагрузки:
Перезагрузка маршрутизатора/Адаптера

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

Мониторинг

В разделе Мониторинг административной панели отображаются последние значения метрик. Здесь же отображены индикаторы доступности к компонентам (Терминал, маршрутизатора и Адаптеры) и к сервисам (доступ к БД, к папкам Файловому шлюзу, скриптам Python):

  • красный индикатор свидетельствует о недоступности/ошибке;
  • зеленый индикатор свидетельствует о доступности/корректной работе;
  • серый индикатор может свидетельствовать о том, что компоненты (маршрутизатор или адаптеры) не были сконфигурированы;

По кнопке Скачать данные мониторинга на компьютер пользователя загружается 7z архив. Архив предназначен для передачи в НРД, таким образом анализ содержимого архива пользователями не предусмотрен.

Подробное описание сервиса Мониторинга можно найти в разделе Мониторинг.

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

Инструкцию по отправке документов с вложением в Сбербанк можно скачать по ссылке ниже:

Скачать инструкцию по отправке документов с вложением в Сбербанк

Установка PostgreSQL

Инструкцию по установке PostgreSQL можно скачать по ссылке ниже:

Скачать инструкцию по установке PostgreSQL