Щоранку бухгалтер відкриває три вікна: Monobank для ФОП, Privat24 для бізнес-рахунку, кабінет Ukrgasbank. У кожному — експорт виписки, скачування файлу, відкриття Odoo, імпорт через майстер, повторити. Кілька годин рутини щомісяця на одній лише операції «занести виписки в систему». А потім ще звірка, ще шукати чому суми не збігаються, ще «де поділась ота транзакція». Якщо ви маєте API-доступ до своїх банків — цю рутину можна закрити повністю.
Чому API краще за файлові імпорти
Файлові імпорти (DBF, XLS, CSV) — це щоденний marginal cost: хтось має зайти в клієнт-банк, скачати, перетягнути в Odoo. API закриває це повністю. Три конкретні переваги:
- No-touch щоденність. Cron-задача в Odoo сама опитує банк раз на день (або частіше) і додає нові транзакції в журнал. Бухгалтеру лишається тільки звіряти, а не збирати дані.
- Історичний backfill за один прогін. При першому підключенні модуль може стягнути транзакції за попередні місяці без ручного збирання купи файлів — корисно, якщо ви тільки переходите на Odoo чи відновлюєте пропущений період.
- Узгодженість між журналами. Якщо ви ведете 2-3 банки одночасно (типова картина для українського SMB: Mono для ФОП-операцій + Privat24 для основного бізнесу + Ukrgasbank для зарплатного або валютного рахунку) — кожен підключається в окремий журнал, дедуплікація працює окремо, але логіка матчингу контрагентів — спільна.
Економіка проста: вартість модуля на Apps Store швидко окупається за рахунок звільненого робочого часу бухгалтера від щоденної ручної рутини імпорту.
Monobank API — що робить модуль kw_bank_statement_monobank_api
Модуль Bank Statement Monobank підключається до офіційного персонального API Monobank. Цей API обслуговує і фізосіб, і ФОП-акаунти — для ФОП-користувачів Monobank використовується той самий API, що й для приватного кабінету.
Що відбувається після підключення:
- Ви генеруєте персональний токен на api.monobank.ua і вставляєте його у налаштування Odoo. Модуль автоматично знаходить усі прив'язані до токена рахунки — і гривневі, і валютні.
- Кожна транзакція потрапляє у рядок виписки з ім'ям контрагента, його IBAN та ЄДРПОУ (якщо банк передав цю інформацію), описом і коментарем.
- Якщо операція у іноземній валюті — модуль зберігає окремо суму у валюті операції та валюту, що дає змогу аналізувати валютну виручку без додаткових кроків.
- На рівні виписки фіксуються початковий і кінцевий баланси за період — це дає змогу звіряти виписку «на кінець дня» без додаткового звернення у банк.
Monobank має обмеження на частоту запитів — модуль самостійно дотримується дозволеного темпу і пакетує довгі періоди на менші шматки. Для щоденної свіжої синхронізації це непомітно; для першого backfill історії за рік — повільніше, але без помилок.
Privat24 API — що робить модуль kw_bank_statement_privat24_api
Модуль Bank Statement Privat24 працює з Autoclient API ПриватБанку — це бізнес-API для юридичних осіб і ФОП. Доступ генерується через кабінет Privat24 Business.
Як налаштовано підключення:
- У налаштуваннях Odoo ви вказуєте клієнтські реквізити Autoclient та IBAN рахунку, який цей журнал буде обслуговувати. Конкретний IBAN потрібно вказати явно — якщо у вас декілька ПриватБанківських рахунків, для кожного створюється окремий журнал з власними реквізитами.
- Модуль самостійно тягне всі транзакції за вказаний період — пагінація обробляється автоматично, користувачу не треба робити «продовжити завантаження».
- Початковий і кінцевий баланси дня записуються у виписку Odoo разом з транзакціями.
- Контрагент і IBAN розпізнаються залежно від напрямку транзакції — модуль обробляє цю особливість Privat24 коректно.
Якщо ваш бізнес — eCommerce і ви приймаєте платежі через LiqPay, рядки у виписці ПриватБанку приходять з технічним описом без імені платника й опису замовлення. Для цього є окремий доповнювальний модуль — див. розділ «Як почати».
Ukrgasbank API — що робить модуль kw_bank_statement_ukrgasbank_api
Модуль Bank Statement Ukrgasbank інтегрується з API «Мій Укргазбанк». Аутентифікація — через токен.
Як це працює:
- При підключенні модуль самостійно знаходить усі прив'язані бізнес-рахунки — їх назви, IBAN, валюту, тип. Окремо вказувати кожен рахунок не потрібно.
- Транзакції тягнуться разом з контрагентом, ЄДРПОУ, МФО та IBAN — модуль обирає правильне поле IBAN залежно від напрямку транзакції (дебет/кредит).
- Стандартний набір метаданих: дата операції, сума, опис призначення. Повторні імпорти не створюють дубльованих транзакцій у журналі.
Ukrgasbank — типовий вибір для українських компаній, що ведуть зарплатні проєкти або працюють із бюджетними коштами; підключення цього банку до Odoo через API закриває окрему категорію операційного навантаження.
Чи можна одночасно використовувати 2-3 банки
Так, і це типовий сценарій. Кожен банк підключається як окремий банківський журнал у бухгалтерії Odoo, з власними реквізитами і власним розкладом синхронізації. Журнали не конфліктують між собою: повторні імпорти не створюють дублів усередині кожного журналу. Партнерська база — спільна для всієї системи: контрагент розпізнається за ЄДРПОУ незалежно від того, через який банк прийшов платіж, тож звірка по дебіторці працює коректно.
Усі три API-модулі стоять на спільному ядрі — залежності встановлюються автоматично, логіка прив'язки контрагентів та реконсиліації спільна.
Якщо у вашому стеку є й банки без API (Аваль, ОТП, ПУМБ, Ощад, Кредобанк, iFOBS, iBank2UA, NovaPay, Privat24-роздріб) — їх можна додати через файлові імпорти з того ж самого suite. Повний огляд — у статті про 13 українських банків в Odoo.
Як почати
Усі три API-модулі опубліковані на Odoo Apps Store і підтримують Odoo 17.0, 18.0, 19.0. Для запуску потрібно:
- Згенерувати API credentials у банку. Monobank — особистий токен на api.monobank.ua; Privat24 — Autoclient ID + Token у Privat24 Business; Ukrgasbank — токен у кабінеті «Мій Укргазбанк».
- Встановити потрібний модуль з Bank Statement Monobank, Bank Statement Privat24 або Bank Statement Ukrgasbank. Залежності (
kw_bank_statement,kw_bank_statement_api) підтягуються автоматично. - Створити журнал у бухгалтерії, прив'язати credentials, увімкнути cron-синхронізацію.
- Опційно — для eCommerce-клієнтів з LiqPay-платежами через ПриватБанк — додати LiqPay-enricher для виписки, який доповнює рядок виписки даними замовлення.
Якщо потрібна допомога з налаштуванням, прив'язкою існуючих контрагентів або міграцією історичних виписок — KitWorks Systems працює з впровадженнями Odoo з 2015 року, 100+ активних клієнтів, 158 публічних модулів на Apps Store. Напишіть через контактну форму або подивіться повний каталог модулів.