Опис модуля
Монобанк: імпорт банківських виписок
Модуль Монобанк: імпорт банківських виписок забезпечує пряму інтеграцію між Монобанк та Odoo 18 (Community та Enterprise).
Він автоматично імпортує банківські виписки у стандартні моделі Odoo: account.bank.statement та account.bank.statement.line.
Способи імпорту
Імпорт виписок може виконуватися:
- Вручну — користувачем із форми банківського журналу або дашборду журналу;
- Автоматично — за допомогою планувальника (cron), який створюється для кожного банківського журналу Монобанку.
Основне завдання
Основне завдання модуля — завантажити дані Монобанку в Odoo з автоматичним уникненням дублювання транзакцій.
Далі їх опрацьовують (узгоджують, звіряють із документами, імпортують через файли тощо) стандартні модулі Odoo або модулі OCA.
Встановлення та активація
Встановлення модуля
- Перейдіть у меню Додатки (Apps).
- Знайдіть модуль Монобанк: імпорт банківських виписок.
- Натисніть Встановити (Install).
Примітка
Якщо модуль Accounting [account] ще не встановлений — він буде встановлений автоматично.
Права доступу
Користувачі, які належать до групи Accounting > Administrator можуть налаштовувати інтеграцію з Монобанк:
- Заповнювати поля Монобанку в Журналі;
- Запускати імпорт вручну;
- Керувати планувальниками (при наявності технічного доступу).
Наступні кроки
Після встановлення модуля перейдіть до Налаштування для конфігурації інтеграції з Монобанк.
Налаштування
Налаштування журналу Монобанку
Крок 1: Створення або відкриття журналу
- Створіть або відкрийте банківський журнал (Тип журналу = Банк (Bank)).
- Вкажіть номер банківського рахунку.
- На вкладці Записи в журналі знайдіть поле Банківська виписка.
- Оберіть Monobank API.
- З'явиться нова вкладка Monobank.
Примітка
Якщо пізніше вибрати інший варіант Банківська виписка — вкладка Monobank приховається.
Крок 2: Налаштування вкладки Monobank
У вкладці Monobank заповніть такі поля:
API-токен Monobank
Щоб заповнити це поле:
- Перейдіть за посиланням https://api.monobank.ua/.
- Активуйте токен та скопіюйте його.
- Вставте токен у поле API-токен Monobank.
Період імпорту (дні)
Тут вказується за скільки останніх днів завантажувати виписки.
Значення за замовчуванням: 1 день.
Крок 3: Збереження та створення планувальника
Після збереження Журналу із заповненим токеном створюється cron (планувальник), який виконується щоденно.
Важливо
Якщо Monobank перестає бути джерелом Банківська виписка → cron автоматично видаляється.
Перевірка з'єднання
Перевірте чи правильно внесені дані для з'єднання з Монобанк:
- Натисніть кнопку Перевірити з'єднання.
- Якщо дані правильні, у правому верхньому кутку система відобразить повідомлення:
Завантаження виписок вручну
Спосіб 1: З дашборду журналів
Перейдіть у меню Accounting/Invoicing → Дашборди журналів → натисніть Імпорт виписок.
Спосіб 2: З форми журналу
Відкрийте банківський журнал та перейдіть на закладку Monobank → натисніть Імпорт виписок.
Вибір періоду імпорту
З'явиться вікно з полем Дата. Ви можете:
- Залишити значення за замовчуванням:
- Дата початку = поточна дата − кількість днів вказана у полі "Період імпорту (дні)"
- Дата кінця = поточна дата
- Або встановити власний період завантаження виписок.
Результат імпорту
Після натискання Імпорт виписок процес завантаження почнеться.
Після завершення імпорту:
- У правому верхньому кутку система відобразить повідомлення про успішний імпорт;
- На дашборді банківського журналу відобразиться кількість завантажених транзакцій.
Усунення несправностей
Типові проблеми та рішення
Проблема: Помилка з'єднання з Monobank API
Симптоми: При натисканні кнопки "Перевірити з'єднання" з'являється помилка.
Можливі причини:
- Невірний API токен
- Токен не активований
- Токен прострочений
Рішення:
- Перейдіть на https://api.monobank.ua/
- Перевірте статус токену
- За потреби активуйте новий токен
- Скопіюйте та вставте токен у поле "API-токен Monobank"
- Збережіть журнал та повторіть перевірку з'єднання
Проблема: Вкладка Monobank не з'являється
Симптоми: Після вибору Monobank API у полі Банківська виписка вкладка не з'являється.
Можливі причини:
- Модуль не встановлений
- Тип журналу не "Банк"
Рішення:
- Перевірте, що модуль Монобанк: імпорт банківських виписок встановлений
- Переконайтеся, що тип журналу = "Банк" (Bank)
- Оновіть сторінку та повторіть вибір
Проблема: Дублікати транзакцій
Симптоми: Одні й ті ж транзакції імпортуються повторно.
Рішення: Модуль автоматично уникає дублювання транзакцій. Якщо проблема виникає:
- Перевірте чи однаковий номер рахунку в журналі та в Monobank
- Зверніться до технічної підтримки
Проблема: Помилка "API limitation" при імпорті
Симптоми: При імпорті виписок з'являється помилка про обмеження API.
Можливі причини:
- Обраний період перевищує 31 день
- Занадто часті запити до API (Monobank дозволяє лише 1 запит на 60 секунд)
Рішення:
- Оберіть період імпорту не більше 31 дня
- Зачекайте щонайменше 60 секунд перед повторним імпортом
- При імпорті кількох рахунків витримуйте паузу 60 секунд між кожним рахунком
Обмеження Monobank API
Monobank API має суворі обмеження на частоту запитів:
- 1 запит на 60 секунд на один токен
- Максимальний період: 31 день за один запит
- Історичні дані: Доступні за останні 12 місяців
Якщо потрібно імпортувати довший період, розділіть його на частини по 31 день і чекайте 60 секунд між кожним запитом на імпорт.
Контакти підтримки
Якщо проблема не вирішується:
- Веб-сайт: https://bjetpro.com/
- Email: support@bjetpro.com