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