1. На главную
2. Инструкция
3. Часть 3. Знакомство с интерфейсом администраторов
4. Раздел - Настройки
5. Подраздел Модули
6. Модуль интеграции с банковским счетом - часть 2

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

Е-поселок поддерживает внесение данных о совершенных межбанковских платежах на расчетный счет организации с использованием ручного внесения банковских операций, с помощью ручной загрузки выписок kl_to_1c.txt, с помощью перехвата направляемые ежедневно email сообщений банков с выписками (Сбербанк, платная услуга 199 руб в мес по состоянию на октябрь 2024г.). Теперь становится доступна автоматическая бесплатаная интеграция с АПИ банков.

Т-банк

В настоящий момент доступно автоматическое получение выписок от Т-Банка (Тинькофф банк) посредством API. Для использования сервиса администрации поселка необходимо обратиться в банк, получить там т.н. ключ - token . Подробная пошаговая инструкция на сайте банка: вам необходимо выпустить token, при регистрации необходимо указать ip адреса, используемые роботами е-поселок. Для получения информации о Ваших ip адресах, зайдите в раздел Настройки - Модули Управление модулем интеграции с банковским счетом - часть 2. В описании модуля указаны справочные данные и IP адреса.
Вам необходимо получение token только для получения выписок без управления счетом. Выпуск сертификата не нужен.

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

Сбербанк

 С 15 июля 2024 года сервис API Сбер стал бесплатным. (требуется получение clientId, clientsecret, сертификат, пароль от сертификата, значение scope - инструкция ниже, понадобится минут 10). Модель работы Сбера такова, что вы по сути создаете нового пользователя-клиента, которого наделяете правами на ограниченный доступ к получению выписок и далее выгружаете его реквизиты доступа в е-поселок и подтверждаете авторизацию разовым входом с вводом кода из смс. В целом все не сложно, но все-таки некоторые сложности "в первый раз" бывают. Начните получение данных с входа в личный кабинет Сбера (юрлица) и поиска в меню банк-клиента опции подключения СберAPI.  Вы подаете заявку, далее с вами связывается менеджер или у вас активируется раздел, где уже имеются все необходимые данные.

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

• 1. Войдите в Интернет-банк Сбербизнес https://www.sberbank.com/ru/s_m_business с использованием учетной записи руководителя (максимальные права, право подписи первого лица). Используйте браузер, работающий с сертификатами МинЦифры! Если нужно - используйте Token для авторизации - это зависит от того способа авторизации, который вам привычен. 
• 2. В меню внизу откройте пункт Все продукты и Услуги, на открывшейся странице перейдите на вкладку Сбербанк API и выберите сервис Sber API. Подайте заявку на подключение. Эти действия подробно описаны на сайте Сбера здесь.
• 3. Добавление ответственного лица, указание наименования подключаемого сервиса остается на ваше усмотрение (необязательно). Указание ссылки для перенаправления не требуется.
• 4. После подписания заявления кодом из СМС в меню Все продукты и Услуги Сбера вам станет доступен кабинет Сбер API. Перейдите в него. Возможно, генерация пройдет не сразу. Некоторые поселки сообщали об ожидании до 5 дней, другие говорили о том, что активация занимает 5 секунд. Вероятно, есть какие-то скрытые причины на стороне Сбера.
• 5. Банк создаст clientId, clientsecret. Запишите их! Если вы забудете clientsecret его нужно будет создать заново. Если в clientsecret содержится большое количество спец-символов (!?%$#"` и др.) могут быть сложности с первичной активацией из-за специфики ограничений в моделях безопасности. Может помочь создание нового clientsecret, эта процедура не ограничена на стороне Сбера. Как сменить ClientSecret. Иногда у Сбера плохое настроение и он обрывает сессию авторизации или сбоит при обновлении ClientSecret. Приходится обновлять значение ClientSecret вручную.
• 6. Ниже сгенерируйте сертификат и установите пароль. Для пароля желательно использовать латинские символы и цифры без спецсимволов. Большого смысла в данном пароле нет. Загрузите сертификат на компьютер. Как сгенерировать сертификат на сайте Сбера.
• 7. Настроятельно рекомендуем  вам создать нового пользователя. Если вы используете токен для входа, - это практически обязательно, поскольку несмотря на инструкции, пользователям с входом по token в нашем присутствии не удалось на следующем этапе авторизоваться в Сбере. Ошибка это или нет - неясно.
  • Зайдите в меню Моя организация, откройте список пользователей и создайте нового. Нет проблем, если пользователь с данным ФИО уже есть. Уникальный нужен только номер телефона. При создании придется указать некоторое количество данных о пользователе. Установите роль пользователя - Бенефициар. Это пользователь, который может получать выписки, но не может распоряжаться счетом и создавать платежки и тем более их подписывать. Как раз то, что нужно роботу е-поселок!
  • Вылогируйтесь из Сбера и залогируйтесь заново с данными только что созданного пользователя. Возможно придется сменить или установить имя пользователя и постоянный пароль. Он нам понадобится далее.
• 8. Перейдите в Е-поселок, в Управление модулем интеграции с банковским счетом - часть 2 выберите интеграцию со Сбером, укажите все данные, прикрепите файл с сертификатом. Убедитесь, что в браузере разрешено открытие всплывающих окон.  Если нет - то при нажатии сохранения окно не откроется. Если не открывается, ищите в яндексе, как отключить блокированное в вашем браузере открытие всплывающих окон: это настройки вашего компьютера и вашего браузера.
• 9. На всплывающем окне вам нужно ввесли логин и пароль пользователя Сбера, созданного в п. 7. Если все хорошо, то после ввода пароля и авторизации - окно закроется и в описании подключения интеграции будет надпись о том, что модуль активен. Если все плохо, то появится информация об ошибке, которую сообщает сервер Сбера. Ошибка может быть закодирована или на английском - можете прислать ее в техподдержку, мы поможем перевести. Обычно ошибка связана или с неправильным кодом clientid, clientsecret или недействительным сертификатом. Если сомневаетесь - воспользуйтесь личным кабинетом СберАПИ и сгенерируйте новый clientsecret и сертификат. Старый можно удалить или он удалится сам.
• 10. В теории авторизация не должна "отваливаться". Е-поселок сам будет обновлять все ключи и коды доступа, поддерживая их актуальность. Какие-то ключи у Сбера действуют 2 минуты, какие-то 1 час, какие-то 30 дней. Об их актуализации позаботится наш сервер. Если произойдет что-то непредвиденное, на первой странице в разделе Задачи и напоминания появится сообщение о том, что интеграция нарушилась и требуется повторный ввод данных. В таком случае нужно зайти в SberAPI кабинет, заново создать clientsecret и повторно ввести все данные в е-поселок. Сертификат в Сбере должен быть бессрочным и менять его не требуется кроме случаев, когда он утрачен.
• 11. Если вы хотите отключить интеграцию - просто отключите ее в разделе Интеграция с банковским счетом. Также,если вы удалите или отзовете сертификаты или clientsecret в личном кабинете сбера, интеграция "подвиснет" и через 5 попыток (5-10 часов) отключится.
   

Альфа-банк

Подключение интеграции с Альфа-банком описано в инструкции банка. https://developers.alfabank.ru/products/alfa-api/documentation/articles/connection/articles/instruction/instruction  В случае затруднений, обращайтесь в тех-поддержку е-поселок или Альфа-банк.

Пошагово подключение выглядит следующим образом.

    1. Подпишите договор и получите ClientID и значение Scope. 
    2. Направьте на почту alfa_api@alfabank.ru письмо с темой "Завершенное тестирование".  Вам включат "боевой" режим для вашего ClientID.
    3. Получите или выпустите TLS-сертификат (см инструкцию Альфа-банка)  , это может быть немножно сложно. В случае затруднений обратитесь в поддержку Альфа-банка.  В итоге нам необходимо контейнер в формате pfx или p12 (одно и тоже), который защищен паролем.  Создавать или генерировать clientsecret не нужно, после внесения данных в е-поселок наш сервер запросит его автоматически.
    4. Перейдите в Е-поселок, в Управление модулем интеграции с банковским счетом - часть 2 выберите интеграцию с Альфа-банком, укажите все данные, прикрепите файл с сертификатом. Убедитесь, что в браузере разрешено открытие всплывающих окон.  Если нет - то при нажатии сохранения окно не откроется. Если не открывается, ищите в яндексе, как отключить блокированное в вашем браузере открытие всплывающих окон: это настройки вашего компьютера и вашего браузера.
    5. На всплывающем окне вам нужно ввесли логин и пароль пользователя Альфа-банка. Возможно, придет смс или потребуются какие-то согласия. Если все хорошо, то после ввода пароля и авторизации - окно закроется и в описании подключения интеграции будет надпись о том, что модуль активен. Если все плохо, то появится информация об ошибке, которую сообщает сервер Альфабанка. Ошибка может быть закодирована или на английском - можете прислать ее в техподдержку, мы поможем перевести. Обычно ошибка связана или с неправильным кодом clientid или недействительным сертификатом.
    6. В теории авторизация не должна "отваливаться". Е-поселок сам будет обновлять все ключи и коды доступа, поддерживая их актуальность. Какие-то ключи у Альфы действуют 1 минуту, какие-то 1 час, какие-то 30 дней. Об их актуализации позаботится наш сервер. Если произойдет что-то непредвиденное, на первой странице в разделе Задачи и напоминания появится сообщение о том, что интеграция нарушилась и требуется повторный ввод данных. В таком случае нужно зайти в Модули и повторить сохранение параметров настройки. Система переактивирует соединение.
    7.  Сертификат действует 1 год. Далее его придется обновлять и подгружать новый.
 

Если у вас другой банк и у него есть API и условия его использования вас устраивают - пожалуйста, напишите в техподдержку е-поселок.