Настройки Укрсиббанк Бизнес
Подключение компании к «Укрсиббанк Бизнес»: с какими данными ERPJS входит в банк, с какого счёта идут платежи и каким ключом они подписываются. Когда настройка заполнена, платёж поставщику уходит в банк прямо из окна платежа — пунктом меню «Отправить в Укрсиббанк», без выгрузки файла в клиент-банк. Настройка одна на компанию. Пока в ней нет Client ID, Client Secret и ключа подписи, в банк ничего не уходит.
Где искать: Модули → Укрсиббанк → Настройки → Настройки Укрсиббанк Бизнес
Разбор на примере
В демонстрационной компании поля пустые: банк не подключён, поэтому секрет и ключ — «Не задано». В окне шесть полей:
- Client ID и Client Secret — идентификатор и секрет приложения компании, которые выдаёт банк. Client ID не секрет: он идёт в адрес входа в банк. Client Secret хранится зашифрованным и обратно в окно не возвращается (подробности ниже);
- IBAN плательщика — счёт компании, с которого пойдут платежи. Пусто — берётся «Р/сч» из информации о компании;
- Песочница банка — тестовый режим банка вместо рабочего: платежи уходят, но деньги не двигаются. Удобно, чтобы проверить подключение. По умолчанию выключено;
- Ключ подписи и кнопка «Создать ключ» — закрытый ключ, которым ERPJS подписывает каждый платёж. Его создаёт сервер, в окне он показывается только маской;
- Открытый ключ для банка — пара к ключу подписи. Его копируют отсюда и загружают в кабинет «Укрсиббанк Бизнес». Править поле нельзя: его заполняет кнопка.
Модуль есть только в украинской версии ERPJS: в версии для Кении его пункта меню, настройки и пунктов меню окна платежа нет совсем.
Подключение: четыре шага
- Зарегистрируйте в «Укрсиббанк Бизнес» приложение компании и адрес возврата после входа: адрес вашей базы ERPJS плюс
openserver/ukrsibbank/OAuth2— например,https://s.erpjs.biz/<база>/openserver/ukrsibbank/OAuth2. Другой адрес банк не примет, и вход в банк не завершится. - Введите Client ID и Client Secret, которые выдал банк, и сохраните настройку.
- Нажмите «Создать ключ». Сервер создаёт пару ключей: закрытый остаётся в ERPJS зашифрованным и наружу не выходит никогда — банк получает только подписи, — а открытый появляется в поле «Открытый ключ для банка». Кнопка работает только для сохранённой настройки, иначе — «Сначала сохраните настройки Укрсиббанк Бизнес».
- Загрузите открытый ключ в кабинет банка.
Остаётся дать право людям, которые будут отправлять платежи: действие роли «Может отправлять платежи в банк» в ролях. Это действие открывает только его собственная строка в роли — строка действий с пустым «для» его не включает. Без права отправка отказывает: «Нет права отправлять платежи в банк (действие роли «Может отправлять платежи в банк»)». То же право нужно, чтобы снимать отметки «Платеж отправлен».
Секрет и ключ показываются маской
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 (переслали, открыли в другом браузере).
Куда смотреть дальше
- Платежи поставщикам — документ, из которого платежи уходят в банк.
- Контакты — реквизиты получателя, закладка «Реквизиты».
- Роли — действие «Может отправлять платежи в банк».
- Информация о компании — «Р/сч», когда IBAN плательщика не задан.