Найдорожчі помилки в бізнес-системах рідко видно на екрані. Сайт працює, кнопка «Оплатити» натискається, клієнт отримує лист. А потім з’ясовується, що платіж пройшов, але замовлення в CRM не створилося. Або створилося двічі. Або залишки на складі в ERP оновилися через годину, і за цей час продали товар, якого вже немає. Менеджери звіряють таблиці вручну, а власник не довіряє жодній цифрі.
Інтеграції між сайтом, CRM, ERP, обліковою системою і платіжними провайдерами - одна з основних частин моєї роботи. Нижче розповідаю, як я їх проєктую, щоб дані сходилися, а збій одного сервісу не ламав увесь процес.
Типові проблеми, з якими приходять замовники
| Симптом | Справжня причина |
|---|---|
| Дублікати угод і клієнтів у CRM | Немає ідемпотентності: повторний вебхук або повторне натискання створює новий запис |
| Платіж є, замовлення немає | Обробка вебхука впала, а повторної спроби і звірки не існує |
| Залишки не збігаються | Дві системи вважають себе джерелом правди і перезаписують одна одну |
| Інтеграція «іноді» не працює | Ліміти API, таймаути, помилки без логування і без сповіщень |
| Ніхто не знає, що зламалося | Немає журналу подій і моніторингу, лише скарги клієнтів |
Усі ці проблеми вирішуються не «ще одним скриптом», а архітектурою інтеграції.
Спочатку - хто джерело правди
Перше питання в кожному проєкті: яка система головна для кожної сутності. Клієнти можуть жити в CRM, товари і залишки в ERP, ціни в обліковій системі, статус оплати у платіжного провайдера. Коли це записано явно, зникає більшість конфліктів: кожна система пише лише свої дані і читає чужі.
Далі описую контракт обміну: які поля, у якому форматі, як мапляться статуси між системами, що робити з полями, яких немає з іншого боку. Це нудна частина, але саме вона заощаджує тижні налагодження. Про те, чому схема даних - це контракт, я писав окремо: https://zavada.dev/ua/blog/sql-is-the-contract.
Надійна доставка подій
Між системами я майже ніколи не роблю прямих синхронних викликів у момент дії користувача. Замість цього:
Вхідні вебхуки спочатку перевіряються (підпис, джерело), зберігаються в базу і лише потім обробляються. Якщо обробка впала, подія не втрачається.
Вихідні зміни йдуть через патерн outbox: запис у базу і подія для відправки зберігаються в одній транзакції, а окремий воркер відправляє їх у CRM чи ERP з повторними спробами і паузами між ними.
Кожна операція має ключ ідемпотентності. Повторний вебхук від платіжної системи або повторна відправка після таймауту не створює другий платіж чи другу угоду.
Черги розвантажують систему під піками і дозволяють поважати ліміти API зовнішніх сервісів, а події, які не вдалося обробити після кількох спроб, потрапляють в окрему чергу для розбору, а не зникають.
Платежі: окремий рівень відповідальності
З платежами помилка коштує грошей, тому тут додаткові правила. Статус оплати ніколи не береться з браузера клієнта, лише з серверного вебхука або запиту до провайдера. Суми зберігаються в мінімальних одиницях, без float. Повернення, часткові оплати, підписки і чарджбеки описані як окремі стани, а не винятки.
Обов’язкова щоденна звірка: система порівнює свої транзакції з виписками провайдера і підсвічує розбіжності. Це ловить ті рідкісні випадки, коли вебхук не прийшов зовсім. Детальніше про безпеку платіжних систем, зокрема з криптовалютами, у статті https://zavada.dev/ua/blog/payment-platform-security-fiat-crypto-2026.
З чим я інтегрую
| Тип | Приклади |
|---|---|
| CRM | HubSpot, Salesforce, Pipedrive, KeyCRM, Bitrix24, власні CRM |
| ERP і облік | Odoo, BAS, SAP Business One, Microsoft Dynamics, складські системи |
| Платежі | Stripe, PayPal, LiqPay, WayForPay, Monobank, криптоплатежі |
| Логістика | Нова пошта, Укрпошта, Meest, міжнародні перевізники |
| Інше | Google Sheets, телефонія, email-маркетинг, маркетплейси, банківські API |
Якщо в системи немає нормального API, працюємо через вивантаження файлів, проміжну базу або обережний парсинг, але завжди з журналом і звіркою.
Моніторинг і підтримка
Інтеграція без моніторингу ламається тихо. Тому кожна з них має журнал подій, у якому видно, що, коли і куди відправлено, і з яким результатом. Сповіщення приходять, коли росте черга помилок, падає частка успішних синхронізацій або зовнішній API змінив відповідь. Є адмін-екран, де менеджер може побачити застряглу подію і повторити її, не звертаючись до розробника.
Як проходить проєкт
1. Розбір процесів: шлях замовлення від сайту до відвантаження і оплати, всі системи, хто де працює.
2. Схема даних, джерела правди і контракт обміну, узгоджені з командою.
3. Реалізація по одному потоку за раз з тестовим середовищем і звіркою на реальних даних.
4. Запуск з паралельною роботою старого процесу, моніторинг, потім супровід.
Обсяг і вартість залежать від кількості систем, якості їхніх API і складності бізнес-правил, тому ціну я називаю після брифу і розбору процесів, з письмовим планом і етапами.
Висновок
Хороша інтеграція непомітна: замовлення, оплати і залишки просто сходяться, а коли щось ламається, про це знають раніше за клієнта. Для цього потрібні явні джерела правди, надійна доставка подій, ідемпотентність, звірка і моніторинг.
Якщо у вас дані розходяться між сайтом, CRM, ERP і платежами, або ви плануєте складну систему з такими інтеграціями, подивіться, як я працюю над вебзастосунками: https://zavada.dev/ua/web-apps. Опишіть свої системи у формі заявки: https://zavada.dev/ua/contacts?service=web-apps
Шукаєте розробника надовго?
Можу почати вже зараз і працювати з вами місяцями й роками, а не два тижні. Напишіть мені, обговоримо проєкт, вимоги й наступні кроки.