Підключення банку за API

Для чого ця сторінка

Тут налаштовується пряме зʼєднання з банком: операції за рахунком приходять самі кілька разів на день і одразу стають документами надходжень і списань, а підготовлені списання можна надіслати в банк на підпис без файлу. Підключаються ПриватБанк (Приват24 для бізнесу, «Автоклієнт»), ПУМБ (інтернет-банк ІКБ) і Монобанк для юридичних осіб. Сторінка — у меню «Гроші» → «Налаштування» → «Підключення до банку (API)».

Що на сторінці

Заголовок і пояснення

• «— організація —» — для якої організації показувати і створювати підключення. Поки ви не обрали її тут вручну, діє організація за замовчуванням із шапки.
• «+ додати підключення» — відкриває форму нового підключення. Неактивна, доки не обрано організацію.

Під заголовком — коротке пояснення: коли підтягується виписка, що відбувається з розпізнаними і нерозпізнаними операціями, де надіслати платежі. Результат кожної дії (перевірки, синхронізації, збереження) показується смужкою над таблицею: зелена — успіх, червона — помилка; «×» її закриває.

Форма нового підключення

Спільні поля для всіх банків:

• «Банк» — один із трьох варіантів: «ПриватБанк (Приват24 Автоклієнт)», «ПУМБ (ІКБ REST API)», «Монобанк — юрособи (токен компанії)».
• «Назва» — як підключення називатиметься в таблиці. Порожнє поле — назва банку.
• «Днів назад» — за скільки днів забрати операції при першій синхронізації (від 1 до 90, за замовчуванням 3).

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

ПриватБанк. Одне поле «Token Автоклієнта». Під ним підказка, де його взяти: Приват24 для бізнесу → Меню → Інтеграція (Автоклієнт) → Підключити API → скопіюйте токен.

ПУМБ. Чотири поля, усі обовʼязкові:

• «client_id (settings.txt)» і «client_secret (settings.txt)» — ідентифікатор і секрет із файлу налаштувань, який видає банк для інтеграції;
• «Логін ІКБ» і «Пароль ІКБ» — логін і пароль користувача інтернет-банку ІКБ.

Монобанк — юрособи. Одне поле «Токен компанії» з підказкою: веб-кабінет web.monobank.ua → оберіть компанію → розділ токенів.

Унизу форми нагадування, що операції з банку створюватимуться документами, а розпізнавання й автопроведення увімкнені (змінити — у «налаштуваннях» після збереження), і кнопки «зберегти» та «скасувати». Після збереження зʼявиться «Підключення збережено. Натисніть «перевірити».»

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

Таблиця підключень

Колонка	Що показує
«Банк»	банк і спосіб підключення
«Назва»	назва підключення
«Реквізити»	замасковані ключі (останні символи), у ПУМБ — ще логін ІКБ
«Остання синхронізація»	дата і час останнього звернення до банку і його результат; червоним — помилка, помаранчевим — частково (є зауваги); «помилок поспіль: N», якщо банк кілька разів відмовив. Другий рядок — коли наступна синхронізація і що підключення робить: «розпізнавати і проводити», «розпізнавати, не проводити» або «усе у «нерозпізнані»»; у призупиненого — «призупинено». Наведіть мишу на дату — побачите текст останньої помилки

Без організації таблиця каже «Оберіть організацію.», без підключень — «Підключень немає — додайте ПриватБанк, ПУМБ або Монобанк.».

Кнопки в кожному рядку:

• «перевірити» — пробне звернення до банку. ПриватБанк: перелік рахунків організації в цьому банку із залишками; якщо той самий IBAN заведено в довіднику кількома картками — попередження, на яку картку йде виписка. ПУМБ: перелік рахунків, які бачить ІКБ. Монобанк: рахунки, які бачить токен; ті, що не заведені в організації, позначені «— не заведено в організації», і кількість рахунків, за якими піде виписка.
• «отримати виписку» — відкриває сторінку «Імпорт виписки» з джерелом «API банку»: ви обираєте період і розбираєте операції в таблиці перед створенням документів (див. «Імпорт виписки»).
• «синхронізувати зараз» — той самий прохід, що за розкладом, але одразу: забрати нові операції і створити документи за налаштуваннями підключення. Результат: «Синхронізовано: отримано …, нових …, створено …, проведено …, на перевірку …» або «Синхронізація з помилкою: …». Працює і на призупиненому підключенні.
• «налаштування» — відкриває вікно налаштувань (нижче).
• «вимкнути» / «увімкнути» — пауза. Призупинене підключення не тягне виписку за розкладом і при відкритті сторінок банку, документи не створюються.
• «журнал» — показує під таблицею «Журнал синхронізацій» (повторне натискання ховає).
• «✕» — видалити підключення (система перепитає). Уже створені документи лишаються.

Вікно «Налаштування — <назва>»

Поле	Що робить
«Розпізнавати автоматично»	для кожної операції шукати контрагента (ЄДРПОУ, IBAN, правила розпізнавання), вид операції і підставу. Розпізнане стає звичайним документом, нерозпізнане — чернеткою у вкладці «нерозпізнані» надходжень чи списань. Вимкнено — усі операції йдуть у «нерозпізнані», ви розбираєте їх самі
«Проводити розпізнані»	розпізнані операції одразу проводити — і при синхронізації, і як основна дія на сторінці «отримати виписку». Вимкнено — документи створюються чернетками. Галочка неактивна, коли розпізнавання вимкнено
«Днів назад при першій синхронізації»	1–90 днів. Далі кожна синхронізація бере період від останньої вдалої з перекриттям в один день

Нижче — коли наступна синхронізація за розкладом і коли була остання вдала. Кнопки «скасувати» і «зберегти».

Журнал синхронізацій

Останні проходи підключення: «Початок», «Хто» («розклад», «відкриття» — при відкритті сторінок банку, «вручну»), «Період», «Отримано» (операцій від банку), «Нових» (яких ще не було), «Створено» (документів), «Проведено», «Підтв. чернеток» (ваших збережених списань, які підтвердила виписка), «На перевірку» (пішли в «нерозпізнані»), «Помилка» — текст відмови банку або заувага проходу. Якщо синхронізацій не було — «Синхронізацій ще не було.».

Які банки підключаються

Банк	Що потрібно	Виписки	Платежі на підпис
ПриватБанк	токен Автоклієнта з Приват24 для бізнесу	так	так
ПУМБ	client_id і client_secret від банку, логін і пароль ІКБ	так	так
Монобанк — юрособи	токен компанії з веб-кабінету	так	так

Рахунки ФОП у Монобанку поки не підключаються — виписку за ними завантажуйте файлом на сторінці «Імпорт виписки» (формат «Монобанк — виписка CSV» підставиться сам). Інші банки — Сенс Банк, Райффайзен, Укрсиббанк, ОТП, Ощадбанк та інші — напряму не підключаються, лише файлом виписки.

Виписка йде лише за рахунками, заведеними в картці організації (вкладка «Банк»): за всіма рахунками цієї організації в банку підключення. Один рахунок — одна картка. Якщо той самий IBAN заведено двома картками (одна перенесена з 1С, другу створили вручну), виписка йде на одну з них — на основну, а якщо основної серед них немає, то на ту, де останні банківські документи. Обʼєднайте картки: картка організації, вкладка «Банк», кнопка «обʼєднати картки».

Виписка через підключення — у гривні. Якщо той самий IBAN заведено картками в різних валютах (мультивалютний рахунок), виписка йде на гривневу картку.

Як працювати

1. Отримайте ключ у кабінеті банку: токен Автоклієнта (Приват24), реквізити ІКБ від банку (ПУМБ) або токен компанії (Монобанк).
2. Перевірте, що рахунок цього банку заведено в картці організації (вкладка «Банк»).
3. На сторінці оберіть організацію, натисніть «+ додати підключення», оберіть банк, вставте ключ, за потреби змініть «Днів назад» і натисніть «зберегти».
4. Натисніть «перевірити» — переконайтесь, що банк бачить ваші рахунки.
5. Відкрийте «налаштування», якщо не хочете, щоб розпізнані операції проводились самі, і зніміть «Проводити розпізнані».
6. Далі виписка приходить сама. Перевіряйте вкладку «нерозпізнані» на сторінках «Банк: надходження» і «Банк: списання» — там операції, які система не розпізнала.

Що робить підключення автоматично

• Коли. У робочі дні за розкладом — орієнтовно о 07:30, 11:00, 14:30 і 18:00 за Києвом (у кожного підключення свій невеликий зсув, щоб не звертатись до банку всім одночасно). Ще — коли ви відкриваєте «Банк: надходження» або «Банк: списання» з обраною організацією, а остання синхронізація була давніше ніж 10 хвилин тому, і за кнопкою «синхронізувати зараз». Після помилки система повторює спробу раніше за наступний слот.
• За який період. Перший раз — «Днів назад»; далі — від останньої вдалої синхронізації з перекриттям в один день, але не більше ніж 90 днів назад.
• Дублів не буде. Операція, яку вже забрали раніше (банк дає їй номер), вдруге документом не стає — навіть при перекритті періодів.
• Ваші збережені списання. Якщо операція банку збігається з вашою збереженою чернеткою списання, документ не створюється заново — виписка підтверджує вашу чернетку.
• Монобанк. Платіж, надісланий на підпис і скасований у банку без підпису, при наступній синхронізації повертається у «збережені», а в журналі зʼявляється заувага — його можна надіслати ще раз. Монобанк дозволяє один запит виписки на хвилину для одного токена: якщо рахунків кілька, частина підтягнеться за кілька хвилин.

Надіслати збережені списання в банк на підпис можна на сторінці «Банк: списання», вкладка «збережені», кнопка «надіслати через API (N)» — вона є, коли в організації є увімкнене підключення. Підписує платіж уповноважена особа в кабінеті банку: система ключів підпису не має.

Хто і коли міняв налаштування — у «Журнал аудиту», обʼєкт «Підключення банку»: створення, зміна режимів (що було і що стало), пауза, заміна ключа, видалення. Сам ключ у журнал не потрапляє.

Що змінюється в обліку

Сама сторінка проводок не робить. Їх роблять створені документи надходжень і списань — так само, як при завантаженні файлу. Чернетки (нерозпізнані або з вимкненим «Проводити розпізнані») залишків не змінюють, доки ви їх не проведете.

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

Виписка не приходить.

• Ключ недійсний або відкликаний — у «Остання синхронізація» помилка. Створіть новий ключ у банку, видаліть підключення «✕» і додайте нове з новим ключем.
• У організації немає рахунків цього банку — помилка «У організації немає рахунків цього банку (перевірте IBAN у картці організації, вкладка «Банк»)».
• Монобанк: токен не бачить рахунку організації — токен іншої компанії або IBAN введено з помилкою. «перевірити» покаже, які рахунки бачить токен.
• Підключення призупинено — у рядку «призупинено», натисніть «увімкнути».
• Розклад ще не настав — дивіться «наступна: …» або натисніть «синхронізувати зараз».
• Банк тимчасово обмежив звернення — система зачекає і повторить сама.
• Той самий IBAN заведено двома картками — документи шукайте на основній картці.

Операції отримано, а документів не бачу. Нерозпізнане (а при вимкненому «Розпізнавати автоматично» — усе) лежить у вкладці «нерозпізнані» на сторінках «Банк: надходження» і «Банк: списання». Там заповніть контрагента, вид операції і статтю руху коштів.

Документи проведені, хоча «Проводити розпізнані» вимкнено. Їх провів користувач кнопкою «створити і провести» на сторінці «Імпорт виписки» або у вкладці «нерозпізнані». Хто — видно в історії документа.

Як замінити ключ (токен, пароль ІКБ). Поля для зміни ключа на сторінці немає: видаліть підключення і створіть нове. Уже імпортовані операції вдруге не створяться.

Платіж не пішов у банк. Причину видно в повідомленні після «надіслати через API» на сторінці списань:

• у отримувача немає IBAN — додайте рахунок контрагенту;
• Монобанк: у отримувача немає ЄДРПОУ чи РНОКПП;
• платіж до бюджету, а в організації не заповнено ЄДРПОУ або РНОКПП;
• немає підключення для банку цього рахунку;
• списання вже проведене (сплачене) — його не надсилають.

Кнопки дають відмову «Недостатньо прав». Переглядати сторінку можна з правом на перегляд банківських документів, а створювати, перевіряти, синхронізувати і змінювати підключення — лише з правом «Банківські платежі».