Интеграции

Когда бэкенду нужны интеграции

Систем не одна — они должны общаться

Заявки из форм сами уходят в CRM

Клиент заполнил форму на сайте — данные в AmoCRM или Битрикс24. Менеджер видит сразу, ничего не теряется.

Заказы синхронизируются с 1С

Оформил заказ на сайте — 1С увидела, зарезервировала товар, сформировала счёт. Без ручного ввода.

Платежи приходят — статусы обновляются

Клиент оплатил картой — бэкенд получил webhook от ЮKassa или CloudPayments — обновил статус заказа.

Товары с маркетплейсов загружаются сами

Wildberries, Ozon, Яндекс.Маркет. Бэкенд стягивает остатки, цены, заказы. Не нужно заходить в 5 личных кабинетов.

Аналитика собирается из всех систем

CRM + 1С + сайт + коллтрекинг. Бэкенд агрегирует данные и отправляет в BI-систему. Отчёты в одном месте.

Одна учётная система — много внешних сервисов

ERP не общается напрямую с десятком внешних API. Бэкенд — прослойка, которая говорит с каждым на его языке.

Из чего состоит бэкенд-интеграция

7 компонентов, которые делают интеграцию надёжной

API клиент

Единый модуль для общения с внешним сервисом. Таймауты, ретраи, заголовки, аутентификация — в одном месте.

Очередь задач

Бэкенд принял запрос, положил в очередь, вернул 202 Accepted. Обработка идёт фоном, пользователь не ждёт.

Воркеры

Фоновые процессы, которые забирают задачи из очереди и выполняют. Масштабируются горизонтально.

Webhook-обработчики

Внешняя система стучится к нам? Эндпоинт принял, проверил подпись, положил в очередь, вернул 200.

State-машина

У интеграции есть статусы: created, processing, completed, failed, retry. Знаем, что происходит с каждой задачей.

Мониторинг и алерты

Очередь растёт? Задачи падают с ошибкой? Шлём алерт в Telegram / Slack / PagerDuty.

Dead Letter Queue

Неудачные задачи не теряются. Лежат в DLQ, ждут, пока инженер разберётся.

Какие интеграции мы настраиваем на бэкенде

CRM

AmoCRM, Битрикс24, Salesforce, Pipedrive. Отправляем заявки, тянем статусы сделок, синхронизируем контакты.

1С и ERP

1С:Предприятие, SAP, Oracle. Обмен товарами, остатками, ценами, заказами, контрагентами. Двусторонняя синхронизация

Платёжные системы

ЮKassa, CloudPayments, Тинькофф, Stripe, PayPal. Приём платежей, проверка статусов, обработка webhook, возвраты.

Маркетплейсы

Wildberries, Ozon, Яндекс.Маркет, Avito. Выгрузка товаров, синхронизация остатков, загрузка заказов, обновление цен.

Очереди и брокеры сообщений

Kafka, RabbitMQ, Redis Streams, SQS. Асинхронная обработка: email, отчёты, экспорт, нотификации. Не тормозим пользователя.

Аналитика и BI

Google Analytics, Yandex.Metrica, Metrica, Power BI, Tableau, Redash. Собираем данные из всех систем и отдаём в отчёты.

Интеграции — это не страшно, если делать правильно

Данные дублируются, теряются, не синхронизируются вовремя. CRM не знает об оплате, 1С не видит новый заказ, маркетплейс показывает не те остатки.
Расскажите, какие системы у вас есть и что с чем должно обмениваться. Мы спроектируем интеграции, где данные идут туда, куда нужно, без потерь и задержек.

Почему интеграции часто работают плохо

Как делают «для галочки»

Как делаем мы

Синхронный вызов API внутри запроса пользователя. Ждём 1С, клиент смотрит на спиннер

Отдали в очередь, ответили «приняли». Клиент не ждёт, интеграция идёт фоном

Повторный webhook создал дубль заказа

Идемпотентность по ID внешнего события. Дубль не проходит

API упал — задача потерялась. Клиент заплатил, а статус не обновился

Retry + Dead Letter Queue. Задача не теряется, обработается когда API вернётся

Нет мониторинга — узнаём о проблеме от клиента

Очереди, ошибки, ретраи — всё в Prometheus + Grafana. Алерт до жалобы

Токен доступа протух — интеграция встала

Автоматическое обновление токена. Перехватчик ловит 401, обновляет, повторяет запрос

Одна интеграция упала — всё легло

Circuit Breaker. Проблемный сервис изолирован. Остальные работают

Логи размазаны по 5 серверам. Непонятно, где упало

Централизованные логи + correlation ID. Весь путь запроса — по одному ID

Аудит и анализ систем

2–4 дня

Составляем список всех систем, которые нужно связать

Фиксируем направление данных (кто куда отправляет)

Смотрим, какие API есть у каждой системы (REST, SOAP, GraphQL, файловый обмен)

Выявляем ограничения (лимиты, квоты, timeout)

Результат:

схема интеграции со всеми системами и потоками данных

Выбор паттерна интеграции

1–2 дня

Синхронный запрос (REST/gRPC) — когда нужен мгновенный ответ

Асинхронный через очередь — когда можно подождать

Webhook — когда внешняя система стучится к нам

Периодический pull — если webhook не поддерживается

Файловый обмен (SFTP) — если API нет вообще

Результат:

утверждённая схема взаимодействия между каждой парой систем

Проектирование API контрактов

2–5 дней

Описываем эндпоинты, методы, форматы запросов/ответов

Проектируем модели данных для обмена

Фиксируем идемпотентность (какой ID использовать)

Определяем схему обработки ошибок

Результат:

OpenAPI / AsyncAPI спецификации, схемы данных

Разработка интеграционного слоя

5–15 дней

Пишем API клиенты для каждой внешней системы

Реализуем очереди и воркеров

Добавляем retry с экспоненциальной задержкой

Реализуем Circuit Breaker

Настраиваем Dead Letter Queue

Результат:

код интеграционного слоя, готовый к тестированию

Мониторинг и запуск

Добавляем метрики в Prometheus (размер очереди, количество ошибок, ретраев)

Рисуем дашборды в Grafana

Настраиваем алерты (очередь > 1000, ошибки > 5%)

Подключаем централизованные логи с correlation ID

Запускаем на прод, мониторим сутки

Расскажите, какие системы нужно связать

Пришлите список: какая CRM, какая 1С, какой платёжный шлюз, какие маркетплейсы, какие ещё системы.
Мы спроектируем интеграции так, чтобы данные шли туда, куда нужно, без дублей, без потерь, с контролем ошибок.