ПриватБанк API в Odoo: автоматичне завантаження банківських виписок

Бухгалтер, який щодня заходить у Приват24 для бізнесу, качає виписку файлом і руками імпортує її в Odoo — витрачає на це, залежно від кількості рахунків, від 15 хвилин до години щодня. При кількох юрособах чи валютних рахунках час множиться, а ризик пропустити транзакцію чи задвоїти імпорт росте разом з обсягом. Модуль Bank Statement Privat24 закриває цю рутину через офіційний Autoclient API ПриватБанку: виписки самі підтягуються в потрібний журнал без файлів і без ручного копіювання. Нижче — як це працює технічно, що потрібно для підключення і кому ця автоматизація дійсно економить час.

Як працює Autoclient API ПриватБанку

Autoclient — окремий сервіс ПриватБанку для бізнес-клієнтів, який вмикається в кабінеті Приват24 для бізнесу: розділ «Облік і звітність» → «Інтеграції». Це не той самий публічний API, яким користуються платіжні агрегатори чи курси валют, — Autoclient призначений саме для вивантаження банківської виписки в облікові системи.

Модуль звертається до двох ендпоінтів окремо:

• /statements/transactions — власне список операцій, дати передаються у форматі ПриватБанку (ДД-ММ-РРРР), результат розбивається на сторінки по 100 записів через followId;
• /statements/balance — вхідний і вихідний залишок за період, щоб цифра в Odoo збігалася з банком з першого дня синхронізації, а не тільки після ручної звірки.

Авторизація відбувається через пару id + Token, які видає сам Autoclient при підключенні застосунку.

Що потрібно для підключення в Odoo

Три речі, без яких синхронізація не запуститься:

1. Активований Autoclient у Приват24 для бізнесу — саме там генеруються облікові дані для API, у самому Odoo їх не отримати.
2. IBAN рахунку заздалегідь відомий бухгалтеру. Autoclient API не має ендпоінту «показати всі мої рахунки» — тому IBAN потрібно вручну прописати як фільтр журналу перед першою синхронізацією.
3. Встановлений модуль kw_bank_statement_privat24_api, який працює поверх базового фреймворку виписок kw_bank_statement — того самого ядра, що обслуговує й інші банківські модулі KitWorks.

Що це дає бухгалтеру на практиці

Автоматичний імпорт виписки — це водночас кілька конкретних речей, які знімають типові ручні перевірки бухгалтера:

• Мультивалютність. Кожен валютний рахунок ведеться окремим журналом, курси і суми не плутаються між UAH/USD/EUR.
• Дедублікація. Повторний запуск синхронізації (наприклад, після збою мережі) не задвоює вже занесені транзакції — це контролює окреме поле унікального референсу імпорту.
• Автоматична пагінація. Великі періоди самі розбиваються на сторінки — бухгалтеру не потрібно вручну обмежувати діапазон дат, щоб уникнути обриву запиту.

Що варто знати заздалегідь

Тут чесність важливіша за красиву обіцянку. Autoclient API не enumerate-ить рахунки — тому помилка в IBAN на етапі налаштування означає порожню виписку, а не підказку від банку. Перша синхронізація може підтягнути історичні дані за кілька попередніх місяців — цю глибину варто узгодити заздалегідь, щоб не отримати дублі з уже занесеними вручну проведеннями. І ще одна деталь каталогу: виписки для бізнес-рахунку та для фізосіб/ФОП — це два різні продукти в Apps Store, бо й API-ендпоінти в ПриватБанку для них різні.

Зверніться напряму — без зайвих формальностей

Автоматизація виписок ПриватБанку — лише один із трьох API-банків, які KitWorks вже підключає до Odoo (разом з Monobank і Ukrgasbank — детальніше в огляді трьох банківських API). Якщо ваш банк API не надає — є шлях через DBF/XLS-імпорт для інших українських банків. Модуль Bank Statement Privat24 та виписки Приват24 для бізнесу доступні в каталозі KitWorks. Якщо потрібна допомога з підключенням Autoclient саме під вашу структуру рахунків — напишіть нам, розберемо конкретний кейс.