Як викликати

Меню Сервіс → Інтеграції → група Банки → картка банку (ПриватБанк, Монобанк, Ощадбанк) → шестерня → вікно «Підключення — <банк>».

Налаштування доступне адміністратору компанії на платних тарифах.

Описання

Що дає інтеграція

Підключення банку дає LEX.Торгівлі доступ до виписок по ваших рахунках. Рухи по рахунку автоматично потрапляють у модуль Синхронізація (Грошові кошти → Синхронізація), де їх видно в оригінальному вигляді, з датою, сумою, контрагентом і призначенням, і звідки з них створюються документи обліку. Вручну вводити платіжки з банку більше не потрібно.

Одне підключення — один банк; усередині нього можна вказати кілька рахунків компанії. На картці банку видно перелік підключених рахунків з IBAN.


Що потрібно заздалегідь

  • Платний тариф (Trader або E-Commerce).
  • Рахунки компанії заведені в Довідники → Рахунки з правильним IBAN: саме з цього довідника вибираються рахунки для підключення.
  • Дані доступу до API банку:
    • ПриватБанк — ID мерчанта і Пароль мерчанта: Приват24 для бізнесу → Налаштування → Автоклієнт.
    • Монобанк — особистий X-Token з api.monobank.ua.
    • Ощадбанк — Client ID і Client Secret видає банк при підключенні Corporate API. Обмін виписками з Ощадбанком готується, картка поки для майбутнього підключення.

Як підключити

  1. Відкрийте Сервіс → Інтеграції, у групі Банки натисніть шестерню на картці банку.
  2. Впишіть Назву підключення (наприклад, «ПриватБанк») і поставте Активність.
  3. Заповніть дані доступу: для ПриватБанку — ID мерчанта і Пароль мерчанта, для Монобанку — X-Token.
  4. У блоці Рахунки цього підключення виберіть рахунок зі списку і натисніть Додати. Повторіть для кожного рахунку цього банку. Рахунок, уже підключений до іншого банку, у списку показаний сірим.
  5. Натисніть Зберегти. На картці банку з’явиться зелена позначка і перелік рахунків.

Вікно «Підключення — ПриватБанк»: назва підключення, Активність, ID мерчанта, Пароль мерчанта, блок Рахунки цього підключення

Ключ доступу зберігається зашифрованим і не показується повторно: при відкритті вікна поле порожнє з підказкою «збережено». Щоб замінити ключ, просто впишіть новий.


Що далі

  • Виписки з’являються у Грошові кошти → Синхронізація: вкладка «Стан» показує кожен рахунок як окреме джерело, час останнього запуску і кількість записів; вкладка «Записи» — самі рухи; вкладка «Журнал» — історію запусків.
  • Дані підтягуються за розкладом кожні 10–15 хвилин, можна натиснути «Синхронізувати зараз». Монобанк дозволяє один запит на хвилину, тому історія читається частинами.
  • Окремий рахунок усередині підключення можна тимчасово вимкнути перемикачем у списку, не видаляючи його.
  • Кнопка Відключити у вікні (з підтвердженням «Відключити цей банк?») видаляє підключення разом із ключем; уже отримані записи в Синхронізації лишаються.

Модуль Синхронізація вмикається для компанії за запитом до підтримки.


Приклад налаштування

ФОП Іваненко має поточний рахунок у ПриватБанку і картковий у Монобанку. У Довідники → Рахунки обидва вже заведені з IBAN.

  1. У Приват24 для бізнесу → Налаштування → Автоклієнт створено доступ: ID мерчанта 412583 і пароль.
  2. Сервіс → Інтеграції → Банки → ПриватБанк: Назва підключення — «ПриватБанк», Активність — так, ID мерчанта — 412583, Пароль мерчанта — вставлено; Рахунки цього підключення — вибрано «Поточний UA36 3052 99…», Додати; Зберегти.
  3. На api.monobank.ua отримано особистий токен. Банки → Монобанк: Назва — «Монобанк», Активність — так, X-Token — вставлено, рахунок «Картка mono UA21 3220 01…», Додати, Зберегти.
  4. Через 15 хвилин у Грошові кошти → Синхронізація обидва рахунки показані як джерела з позначкою підключення, у вкладці «Записи» з’явились перші надходження й списання.

Повідомлення системи і що з ними робити

  • «Назву підключення не заповнено» — впишіть назву.
  • «Ключ доступу не заповнено» — для нового підключення пароль мерчанта чи токен обов’язковий; при редагуванні порожнє поле означає «не змінювати».
  • «Додайте хоча б один рахунок.» — виберіть рахунок у блоці «Рахунки цього підключення».
  • «Рахунок недоступний для підключення.» — це не власний рахунок компанії або він уже підключений до іншого банку.
  • У Синхронізації джерело з позначкою «немає підключення» або текст «Ключ доступу не заповнено у Сервіс → Інтеграції → Банки» — перевірте, що підключення активне і ключ збережено.

Важливо

Ключі API дають доступ до виписок, але не до платежів. Усе одно поводьтеся з ними як із паролем: якщо ключ міг потрапити до сторонніх, перевипустіть його в банку і замініть тут. Один рахунок не може бути підключений до двох банків одночасно.

Форма

Вікно «Підключення — <банк>»:

  • Назва підключення — як підключення називатиметься в LEX.Торгівлі.
  • Активність — увімкнути обмін.
  • Поля доступу залежать від банку: ID мерчанта + Пароль мерчанта (ПриватБанк), X-Token (Монобанк), Client ID + Client Secret (Ощадбанк).
  • Рахунки цього підключення — список доданих рахунків з IBAN і перемикачем активності кожного; випадаючий список власних рахунків із Довідники → Рахунки і кнопка Додати.

Кнопки: Зберегти, Скасувати, Відключити — з підтвердженням «Відключити цей банк?».