Перейти до змісту

Налаштування Укрсиббанк Бізнес

Підключення компанії до «Укрсиббанк Бізнес»: з якими даними ERPJS входить у банк, з якого рахунку йдуть платежі і яким ключем вони підписуються. Коли налаштування заповнене, платіж постачальнику йде в банк просто з вікна платежу — пунктом меню «Відправити в Укрсиббанк», без вивантаження файла в клієнт-банк. Налаштування одне на компанію. Поки в ньому немає Client ID, Client Secret і ключа підпису, у банк нічого не йде.

Де шукати: Модулі → Укрсиббанк → Налаштування → Налаштування Укрсиббанк Бізнес

Розбір на прикладі

Налаштування Укрсиббанк Бізнес

У демонстраційній компанії поля порожні: банк не підключено, тож секрет і ключ — «Не задано». Вікно має шість полів:

  • Client ID і Client Secret — ідентифікатор і секрет застосунку компанії, які видає банк. Client ID не секрет: він іде в адресу входу в банк. Client Secret зберігається зашифрованим і назад у вікно не повертається (подробиці нижче);
  • IBAN платника — рахунок компанії, з якого підуть платежі. Порожньо — береться «Р/р» з інформації про компанію;
  • Пісочниця банку — тестовий режим банку замість робочого: платежі йдуть, але гроші не рухаються. Зручно, щоб перевірити підключення. За замовчуванням вимкнено;
  • Ключ підпису і кнопка «Створити ключ» — закритий ключ, яким ERPJS підписує кожен платіж. Його створює сервер, у вікні він показується лише маскою;
  • Відкритий ключ для банку — пара до ключа підпису. Його копіюють звідси й завантажують у кабінет «Укрсиббанк Бізнес». Правити поле не можна: його заповнює кнопка.

Модуль є лише в українській версії ERPJS: у версії для Кенії його пункту меню, налаштування й пунктів меню вікна платежу немає зовсім.

Підключення: чотири кроки

  1. Зареєструйте в «Укрсиббанк Бізнес» застосунок компанії і адресу повернення після входу: адреса вашої бази ERPJS плюс openserver/ukrsibbank/OAuth2 — наприклад, https://s.erpjs.biz/<база>/openserver/ukrsibbank/OAuth2. Іншу адресу банк не прийме, і вхід у банк не завершиться.
  2. Введіть Client ID і Client Secret, які видав банк, і збережіть налаштування.
  3. Натисніть «Створити ключ». Сервер створює пару ключів: закритий лишається в ERPJS зашифрованим і назовні не виходить ніколи — банк отримує лише підписи, — а відкритий з'являється в полі «Відкритий ключ для банку». Кнопка працює лише для збереженого налаштування, інакше — «Спершу збережіть налаштування Укрсиббанк Бізнес».
  4. Завантажте відкритий ключ у кабінет банку.

Лишається дати право людям, які відправлятимуть платежі: дія ролі «Може відправляти платежі в банк» у ролях. Цю дію відкриває лише її власний рядок у ролі — рядок дій із порожнім «для» її не вмикає. Без права відправка відмовляє: «Немає права відправляти платежі в банк (дія ролі «Може відправляти платежі в банк»)». Те саме право потрібне, щоб знімати позначки «Платіж відправлено».

Секрет і ключ показуються маскою

Client Secret і ключ підпису — поля лише для запису. Задане значення вікно показує маскою, а не текстом; не задане — порожнім полем з підказкою «Не задано».

  • Не чіпали поле — при збереженні лишається збережене значення.
  • Набрали нове — воно замінить старе.
  • Очистили маску — значення буде видалено при збереженні; поле попереджає підказкою «Секрет буде видалено при збереженні».

Через API та MCP ці значення не читаються. Записуючи налаштування через API, порожнє значення лишає збережене, а - стирає його.

Пісочниця і робочий режим — різні адреси банку. Якщо секрет уже збережено, а ви вмикаєте чи вимикаєте «Пісочницю банку», Client Secret треба набрати знову, інакше збереження відмовить: «Збережений пароль іде лише на збережений сервер. Для іншого сервера введіть пароль». Збережений секрет іде лише на ту адресу банку, з якою його зберегли.

Заміна ключа

Коли ключ уже є, кнопка називається «Замінити ключ» і спершу питає: «Замінити ключ підпису? Доки ви не завантажите новий відкритий ключ в Укрсиббанк, банк не прийматиме підписаних ним платежів». Закрили вікно питання — ключ лишається колишнім. Підтвердили — у полі «Відкритий ключ для банку» новий ключ; завантажте його в банк, перш ніж відправляти платежі.

Як платіж іде в банк

У платежі постачальнику — збереженому, інакше «Будь ласка, збережіть документ!» — пункт меню «Відправити в Укрсиббанк».

Перша відправка — вхід у банк. ERPJS відповідає «Увійдіть в Укрсиббанк, потім відправте платіж ще раз» з кнопкою «Увійти в Укрсиббанк». Кнопка відкриває сторінку банку в новому вікні; після входу вікно закривається само, а ERPJS повідомляє «Ви увійшли в Укрсиббанк. Відправте платіж ще раз». Вхід у кожного користувача свій. Посилання входу діє 10 хвилин і лише з того вікна ERPJS, з якого вхід почали. Увійти знову доведеться після перезапуску сервера ERPJS (оновлення), після зміни Client ID чи режиму пісочниці і коли банк перестав приймати вхід.

Повторна відправка — рядки йдуть у банк. Ідуть рядки без позначки «Платіж відправлено»: один рядок — окремим документом, кілька — групою. Звідки банк отримує дані:

У банку Звідки в ERPJS
сума «Сума банку» рядка
призначення платежу «Призначення платежу» рядка (закладка D)
рахунок платника «IBAN платника» цього налаштування, інакше «Р/р» компанії
отримувач контакт рядка, закладка «Реквізити»: «IBAN код», «ЄДРПОУ» (немає — «ІПН»), назва, банк
вид платежу «Вид платежу в банк» контакту: Сплата, Зарплата чи Податок

Для податку банк отримує ще «Код виду сплати» контакту, а коли в рядку немає призначення — «Додаткова інформація запису» контакту. Поля «Інформація про податкове повідомлення (рішення)» і «Тип бюджетного платежу» в картці контакту зберігаються, але в банк поки не йдуть.

Прийняті банком рядки отримують позначку «Платіж відправлено» (закладка D рядків), а вікно показує «Відправлено в банк, рядки: 1, 2». Рядок, який банк не прийняв, — окремим рядком повідомлення з причиною; його позначки немає, і його можна відправити знову. Рядок, про який банк у відповіді на групу не повідомив, — «Банк не повідомив про цей рядок: перевірте в Укрсиббанк Бізнес, перш ніж відправляти знову»: банк міг його прийняти, тож сам удруге він не піде (нижче).

Позначка «Платіж відправлено» і повтор

Рядок, що вже пішов у банк, удруге не піде: «Усі рядки цього платежу вже відправлено в банк». Його не можна змінити, перемістити чи видалити, а платіж із ним — видалити: «Рядок 1 відправлено в Укрсиббанк: платіж не можна видалити. Щоб видалити, спершу зніміть позначки». Так рахунок постачальника не лишиться відкритим, якщо банк платіж уже провів.

Якщо банк не відповів чи зв'язок обірвався, платіж міг створитися: «Банк не підтвердив платіж, і його могло бути створено. Перевірте в Укрсиббанк Бізнес, перш ніж відправляти знову». Такі рядки теж не підуть удруге самі: наступна відправка скаже «Рядки 1, 2 відправлено в банк, але результат невідомий. Перевірте їх в Укрсиббанк Бізнес; щоб відправити знову, зніміть позначки».

Пункт меню «Зняти позначки «Платіж відправлено»» — коли в банку перевірили, що платежу немає. Відповідь — «Позначки знято, рядків: 2». Рядок, який саме зараз відправляється (чи пішов у банк менше двох хвилин тому), позначки не втрачає: «Саме зараз відправляються в банк, рядки: 3». Якщо знімати більше нічого — відмова «Рядки 3 саме зараз відправляються в банк. Зачекайте дві хвилини й спробуйте знову». Зняті позначки дозволяють відправити гроші ще раз, тому знімати їх може лише той, хто має право відправки.

Типові ситуації

«Заповніть налаштування Укрсиббанк Бізнес: Client ID, Client Secret і ключ підпису». Бракує одного з трьох. Ключ підпису створіть кнопкою «Створити ключ» і завантажте відкритий ключ у банк.

«Рядок 2: в Укрсиббанк ідуть лише платежі в гривнях, валюта рядка — USD». З ERPJS у банк ідуть лише гривневі платежі (валюта банку рядка — гривня або порожня при гривні базовою валютою). Валютний платіж передайте в банк іншим шляхом, наприклад через клієнт-банк.

«Рядок 1 (контакт 00012): заповніть IBAN отримувача, Призначення платежу». У контакта постачальника бракує реквізитів (закладка «Реквізити») або в рядку платежу немає призначення (закладка D). Заповніть і відправте знову.

Банк відхиляє всі платежі. Перевірте, що відкритий ключ із цього налаштування завантажено в банк — після «Замінити ключ» його треба завантажити заново, — що «IBAN платника» правильний і що «Пісочниця банку» вимкнена на робочій базі: у пісочниці гроші не рухаються.

Вхід у банк не завершується. Адреса повернення, зареєстрована в банку, не збігається з адресою вашої бази ERPJS — перевірте її (крок 1 підключення). Сторінка «Поверніться до вікна ERPJS, з якого почали вхід, і почніть його там знову» означає, що посилання входу відкрили не з ERPJS (переслали, відкрили в іншому браузері).

Куди дивитися далі