ТОВ чи ПП з рахунком Monobank Business рідко обходиться одним суб-рахунком: гривня, долар, євро — кожен зі своєю випискою, яку бухгалтер має вручну звантажити й розкидати по журналах. При активному обороті це стає окремою щоденною задачею: заглянути в банк раз на день вже не вистачає. Модуль Bank Statement Monobank Business закриває її через офіційний корпоративний API Monobank: рахунки компанії підтягуються автоматично, без ручного пошуку кожного IBAN. Нижче — чим цей API відрізняється від персонального, який бухгалтери часто плутають, і що конкретно з'являється в журналі Odoo.
Чим корпоративний API відрізняється від персонального
Monobank має два окремі API, і плутанина між ними — типова помилка на етапі вибору модуля:
api.monobank.ua/personal— для фізичних осіб і ФОП, токен береться безпосередньо в застосунку Monobank. Цьому відповідає модульkw_bank_statement_monobank_api.corp-api.monobank.ua/ext/v1— для юридичних осіб (ТОВ, ПП та інших зареєстрованих компаній), x-token видає сам банк на запит компанії, а не власник картки. Цьому відповідає модульkw_bank_statement_monobank_corp_api.
Другий модуль технічно спирається на перший — спільне ядро розпізнавання й обробки виписок, різниця лише в тому, з чийого імені й за яким токеном іде запит до банку.
Автовиявлення рахунків — головна практична різниця
На відміну від Autoclient API ПриватБанку, де IBAN потрібно прописувати вручну, корпоративний API Monobank сам визначає всі рахунки, зареєстровані під юрособою:
/ext/v1/accounts— список усіх суб-рахунків компанії (UAH, USD, EUR та інші валюти з кодом за ISO 4217, IBAN кожного);/ext/v1/statements— історія операцій по кожному з цих рахунків.
Це означає: не потрібно заздалегідь знати повний перелік IBAN компанії — досить одного x-token, і модуль сам розкладе транзакції по правильних журналах.
Що зберігається в журналі Odoo
У кожен рядок виписки потрапляють не тільки сума й дата, а й дані, потрібні для звірки з актами та накладними без додаткового пошуку:
- сирова сума й валюта операції;
- опис платежу так, як він прийшов від банку;
- назва контрагента-юрособи;
- IBAN контрагента;
- ЄДРПОУ контрагента.
Останні два пункти працюють практично: саме по ЄДРПОУ й IBAN Odoo автоматично зіставляє платіж з існуючим партнером у базі, тож бухгалтеру не потрібно шукати контрагента вручну за назвою, яка в банківському описі часто скорочена чи з помилками.
Що варто знати заздалегідь
X-token для корпоративного API — це не той токен, який власник картки отримує в застосунку Monobank за хвилину. Його видає банк окремо, на запит компанії через Monobank Business, і процес узгодження може зайняти час — це варто врахувати в плануванні впровадження, а не з'ясовувати в останній день. Якщо у компанії частина рахунків — на юрособу, а частина операцій веде ФОП-власник, знадобляться обидва модулі: kw_bank_statement_monobank_corp_api для компанії і kw_bank_statement_monobank_api для персонального рахунку, кожен зі своїм токеном.
Зверніться напряму — без зайвих формальностей
Monobank — один із трьох банків з прямим API-підключенням до Odoo в лінійці KitWorks, поруч з ПриватБанком і Укргазбанком (детальніше в огляді трьох банківських API). Для банків без публічного API є шлях через DBF/XLS-імпорт. Модуль Bank Statement Monobank Business і супутні виписки Monobank з курсом валют доступні в каталозі KitWorks. Якщо потрібно розібратись, який саме токен запитувати в банку під вашу структуру рахунків — напишіть нам.
