Фаза 5 з 9
Integration — інтеграції з банками, ЄРПН, Прозоро, M.E.Doc
Підключити Odoo до зовнішніх систем: банк-клієнт, М.Е.Doc для ЄРПН, Прозоро.МО для оборонних замовлень, HR-системи.
Передумови
- Кастомний модуль l10n_ua_pn з фази Customization
- Договори з банком на API-доступ (ПриватБанк/Райффайзен/Універсал)
- Активний договір з М.Е.Doc або FREDO
- Якщо defense — реєстрація в Прозоро.МО з API-ключем
Покрокові завдання 22
- Замовлення API-ключів у банку (ПриватБанк / Райффайзен / Універсал)
Починайте якомога раніше: банк видає ключі 2-4 тижні.
- Налаштування bank journal'ів в Odoo для кожного банку
- Інтеграційний модуль для імпорту банківських виписок (формат BG3 або JSON API)
- Автоматичний reconciliation на основі призначення платежу і суми
Шукати збіги: партнер + сума + дата ± 3 дні. Точність 80%+ — норма.
- Налаштування М.Е.Doc API для надсилання ПН в ЄРПН
- Webhook setup: М.Е.Doc → Odoo для отримання статусу реєстрації ПН
- Якщо власний бридж: дозвіл на доступ до ДПС API (ключ ЕЦП)
- Інтеграція з Прозоро.МО (Prozorro DMO) для оборонних закупівель
- Імпорт переможних протоколів з Прозоро.МО → sale.order в Odoo
- Інтеграція з Прозоро.Маркет (civilian Prozorro) якщо є цивільні держконтракти
- Email notifications: підтвердження замовлення, статус ПН, нагадування про оплату
- SMS notifications для критичних подій (бажано через Vonage або український шлюз)
- Інтеграція з 1ДФ-програмами (Liga, FREDO) для подачі звітності
Якщо клієнт залишає 1ДФ-програму для звітів — Odoo має експортувати дані.
- Інтеграція з HR-системою (якщо окрема — Kadr або BAS Зарплата)
Зарплатний журнал з HR імпортується в Odoo як journal entry.
- Інтеграція з електронним підписом (M.E.Doc Цифровий підпис, або CryptoLib)
- Defense: інтеграція з захищеним каналом передачі даних МО (якщо потрібно)
Окремий VPN або фізичний канал. Деталі — у відомстві.
- Логування всіх запитів і відповідей від зовнішніх API (audit trail)
Зберігати щонайменше 1095 днів (3 роки) — за стандартним строком зберігання.
- Моніторинг доступності інтеграцій (Sentry / Prometheus / health checks)
- Retry і dead-letter queue для невдалих надсилань ПН
- Integration test report — кожна інтеграція з тестовим сценарієм
- Runbook: що робити, коли інтеграція впала (банк/М.Е.Doc/Прозоро)
- Демо інтеграцій бухгалтеру і IT, signoff
Контекст: чому ця фаза критична
Без інтеграцій Odoo — це красива оболонка з ручним вводом. Бухгалтер, який вручну забиває кожну банківську виписку, — це не Odoo, це Excel у GUI. Реальна цінність системи з’являється, коли вона сама забирає виписку, реєструє ПН і повідомляє про переможні протоколи.
Тиждень 1: банки і ЄРПН
Найкритичніші інтеграції. Банки найповільніше видають ключі, тому подавайте запит ще на фазі Discovery. М.Е.Doc — швидше, але потребує тестового періоду.
Тиждень 2: Прозоро, HR, нотифікації
Якщо клієнт працює з держзакупівлями — Прозоро обов’язковий. Для оборонки — Прозоро.МО з окремим API-доступом. HR-інтеграція — це типово зарплатний журнал раз на місяць.
Тиждень 3: моніторинг, retry, документація
Інтеграції падають. Питання не «чи», а «коли». Тому моніторинг, retry, dead-letter queue — обов’язкові. Runbook на 3-5 сторінок — це те, що бухгалтер відкриє о 23
у п’ятницю, коли ПН не реєструється.Пастка: не покладайтеся на те, що «банк сам надішле виписку через webhook». Частина банків в Україні не має webhook — лише polling раз на годину. Тому потрібен fallback.
Пастка: ПН надіслана, але не зареєстрована — це штраф, який уже наближається. Webhook від М.Е.Doc зі статусом «Зареєстровано» має бути найважливішим алертом у системі. Минуло 24 години без статусу — про це має дізнатися людина.
Пастка для defense: Прозоро.МО — це окрема платформа, не плутати з цивільним Прозоро. Запит API-ключа подається через МО, обробка — місяць+.
Результати фази (deliverables)
- Bank integration з автоматичною reconciliation
- ЄРПН-bridge модуль (М.Е.Doc або FREDO)
- Prozorro adapter (якщо є оборонні контракти)
- Integration test report з кожною інтеграцією
- Runbook з усунення збоїв інтеграцій