Фінансовий операційний шар для e-commerce: CRM ↔ Нова Пошта ↔ NovaPay

Що це таке

Кастомний «фінансовий операційний шар», що зв'язує CRM, Нову Пошту та NovaPay у єдине джерело правди для e-commerce на післяплаті (COD). Він виключає ручну звірку та приховані фінансові втрати й розгортається на вашій власній інфраструктурі (Docker) — це ваш актив, а не чергова підписка.

Проблема: приховані збитки післяплати

• Час — 100+ ТТН щодня перевіряються вручну; звірка реєстрів у бухгалтера займає 2–3 дні.
• Гроші — плаваюча комісія NovaPay (2% + 20 грн) рахується «приблизно», що створює невидимий касовий розрив.
• Дані — продажі закриваються «наосліп», і це ламає розрахунок ROI маркетингу.

Рішення: єдине джерело правди

Core Orchestrator стає єдиним центром між CRM, Новою Поштою та NovaPay. Щоночі система парсить реєстри NovaPay і зіставляє їх із замовленнями за наскрізним ключем: номер ТТН (Колонка 9), точна сума утриманої винагороди (Колонка 5) та operation_uid (Колонка 13). Унікальний operation_uid забезпечує 100% ідемпотентність — абсолютний захист від подвійного нарахування комісії. Угоди закриваються строго за StatusCode 9 (факт отримання посилки), а не за фактом оплати на карту, — тож ніякого ризику фроду і чисті дані продажів.

Було / стало: матриця трансформації

Економіка впровадження

Розрахунок на базі 200 COD-замовлень на день (оборот 1–3 млн грн/міс):

• 2–3 FTE — оптимізація штату: бухгалтери й менеджери звільняються від рутини на користь аналітики.
• 15–30k ₴/міс — пряма економія за рахунок виявлення розбіжностей і точного обліку комісій.
• 100% — прозорість маркетингу: продаж фіксується виключно за фактом вручення (Status 9).

Архітектура та надійність

Event-Driven ядро. Система побудована на подіях (наприклад, ParcelDelivered), що дозволяє легко писати кастомні слухачі без зміни ядра. Стек: PHP, PostgreSQL, Redis, Docker.

Безпека. Секрети зберігаються поза репозиторієм; авто-ротація Refresh Token і генерація заголовків x-sign (RSA SHA-256) для NovaPay.

Відмовостійкість. Черги Redis і захист від таймаутів API Нової Пошти через Exponential Backoff Retries.

Обробка виключень. Unmatched UI для зв'язування втрачених платежів у кілька кліків, повний журнал аудиту всіх API-запитів і Force Close для ручного контролю критичних операцій.

Режим Dry-Run. APP_DRY_RUN=true проганяє повний цикл на реальних даних без запису в CRM — ви бачите фінансовий результат і точність матчингу ще до бойового запуску.

Мульти-ФОП. Гнучка таблиця merchant_profiles (окремі ключі Нової Пошти, NovaPay і CRM на кожного мерчанта) та розумний роутинг платежів за розрахунковими рахунками (IBAN).

Підписка проти власного активу

Інтеграція та масштабування

Фреймворк написаний через абстрактні інтерфейси (CrmAdapterInterface). Базовий MVP включає готову інтеграцію з SalesDrive, а шар адаптерів дозволяє підключити KeyCRM, KeepinCRM, 1C/BAS чи будь-яку самописну систему за лічені дні. Розгортання базового ядра — близько 15 хвилин через docker-compose.

Дорожня карта

• BI & Аналітика — дашборди відсотка викупу по регіонах і відділеннях логістики.
• Управління поверненнями — автоматична генерація зворотних ТТН та облік комісії за повернення.
• ML-Скоринг — предиктивна оцінка ризику невикупу за історією клієнта для превентивного запиту передоплати.