Финансовый операционный слой для 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-Скоринг — предиктивная оценка риска невыкупа по истории клиента для превентивного запроса предоплаты.