Middleware для інтеграції 1С-Бітрікс: розробка та впровадження

Сайт на Бітрікс24, облікова система 1С, CRM та складський комплекс — кожна пара систем тягне за собою окрему інтеграцію. Шість двосторонніх зв'язків, шість точок відмови. Зміна API в одній системі ламає інші. Кожне ручне виправлення такої помилки коштує 20–40 тис. грн. Ми не раз стикалися з такими сценаріями і знаємо, як радикально спростити архітектуру.

Middleware — універсальний шар-посередник, який приймає дані з будь-якого джерела, трансформує за заданими правилами та доставляє в цільову систему. Обидві системи знають тільки middleware, не знають одна про одну. Це радикально скорочує кількість точок відмови та робить кожну інтеграцію незалежною.

Як middleware вирішує проблему жорсткої зв'язності?

Middleware — це шина подій, через яку проходять всі повідомлення. Замість зв'язків «кожна з кожною» ви отримуєте одну точку входу для всіх систем. Наш досвід: понад 50 інтеграційних проектів, середнє скорочення точок відмови на 70%. Економія на супроводі — 200–300 тис. грн на рік.

Коли потрібен middleware і чому він кращий за пряму інтеграцію?

Пряма інтеграція — це жорстке зчеплення: змінили схему в 1С — треба переписувати конектор в Бітріксі. Middleware ізолює зміни: достатньо оновити конектор тільки до тієї системи, яка змінилася. Час на доопрацювання скорочується в 3–5 разів. Middleware необхідний при трьох і більше системах, складних трансформаціях, необхідності буферизації та повного аудиту обмінів.

Архітектура та реалізація middleware

Варіант 1. PHP-middleware всередині Бітрікса — окремий модуль в /local/modules/, приймає запити по HTTP, трансформує, проксіює. Мінус: прив'язаний до інфраструктури Бітрікса.

Варіант 2. Незалежний мікросервіс (Node.js, Python FastAPI, Go) — живе окремо, Бітрікс — одне з джерел/отримувачів. Плюс: масштабується незалежно, не їсть ресурси PHP.

Варіант 3. iPaaS-платформи — Make (Integromat), n8n, Apache Camel. Візуальна побудова трансформацій без коду. Підходить для не-розробників, але обмежений у складних трансформаціях.

PHP-middleware: структура та контракти

// Центральный маршрутизатор middleware class IntegrationBus { private array $handlers = []; public function register(string $eventType, callable $handler): void { $this->handlers[$eventType][] = $handler; } public function dispatch(string $eventType, array $payload): array { $results = []; foreach ($this->handlers[$eventType] ?? [] as $handler) { try { $results[] = $handler($payload); } catch (\Throwable $e) { $this->logError($eventType, $payload, $e); $results[] = ['error' => $e->getMessage()]; } } return $results; } } // Регистрация обработчиков в init.php $bus = IntegrationBus::getInstance(); // Заказ с сайта → в CRM и в учётную систему $bus->register('order.created', [CrmConnector::class, 'handleNewOrder']); $bus->register('order.created', [AccountingConnector::class, 'createInvoice']); $bus->register('order.created', [WarehouseConnector::class, 'reserveGoods']); 

Трансформація даних (маппінг)

Трансформація — найскладніша частина middleware. Використовуємо паттерн Pipeline:

class TransformationPipeline { private array $pipes = []; public function pipe(callable $transformation): self { $this->pipes[] = $transformation; return $this; } public function process(array $data): array { return array_reduce( $this->pipes, fn($carry, $pipe) => $pipe($carry), $data ); } } // Пример: заказ Битрикс → формат SAP $pipeline = (new TransformationPipeline()) ->pipe(fn($d) => normalizeCustomerData($d)) // нормализация клиента ->pipe(fn($d) => enrichWithFiasData($d)) // добавляем ФИАС по адресу ->pipe(fn($d) => convertCurrencyFields($d)) // конвертация валюты ->pipe(fn($d) => mapStatusCodes($d, 'bitrix2sap')) // маппинг статусов ->pipe(fn($d) => validateSapSchema($d)); // валидация схемы SAP 

Аудит та відтворюваність

Кожне повідомлення логується до і після трансформації:

-- Таблица аудита CREATE TABLE integration_audit ( id BIGSERIAL PRIMARY KEY, event_type VARCHAR(100), source_system VARCHAR(50), target_system VARCHAR(50), payload_in JSONB, payload_out JSONB, status VARCHAR(20), -- success, error, retry error_msg TEXT, duration_ms INT, created_at TIMESTAMP DEFAULT NOW() ); 

При помилці в downstream-системі — відтворюємо операцію за ID запису аудиту без повторного запиту до джерела.

Кейс із практики: виробниче підприємство

Що входить в роботу з розробки middleware?

На кожному проекті ми надаємо повний набір результатів:

• Архітектурна документація та опис контрактів
• Вихідний код middleware з коментарями
• Доступи до репозиторію та сервера розробки
• Інструкції з розгортання та налаштування
• Навчання вашої команди роботі з middleware
• Підтримка протягом 6 місяців після здачі

Процес, терміни та вартість розробки

Ми працюємо в декілька етапів:

1. Аналітика — інтерв'ю з командами, вивчення API систем. Результат: схема даних, контракти.
2. Проектування — вибір архітектури (PHP, мікросервіс, iPaaS). Результат: архітектурна документація.
3. Розробка ядра — шина подій, pipeline трансформацій, аудит. Результат: робочий middleware.
4. Конектори — по одному на кожну систему (1С, Бітрікс, CRM та ін.). Результат: документовані конектори.
5. Тестування — інтеграційні тести, навантажувальне тестування. Результат: протокол тестів.
6. Деплой та супровід — налаштування моніторингу, оповіщень, бекапів. Результат: SLA, гарантія 6 місяців на код.

Орієнтовні терміни розробки:

Точна оцінка — після безкоштовного аудиту вашої інфраструктури. Отримайте консультацію по вашому проекту — наші інженери допоможуть визначити, чи потрібен вам middleware, та підберуть оптимальне рішення. Зв'яжіться з нами для аудиту.

Замовте аудит інтеграцій вже сьогодні — ми проаналізуємо вашу поточну архітектуру та запропонуємо варіанти.

Наша команда — сертифіковані спеціалісти Бітрікс з 10+ річним досвідом. Визначення middleware згідно з Wikipedia