Кратко о проекте
Логика страницы: сначала суть в трёх фокусах — определение, функции и цель. Ниже — визуальные материалы и детальные блоки с контентом.
Единая точка адаптеров к внешним сервисам без размножения ключей и форматов по модулям.
Обеспечивает вызовы провайдеров, ретраи и журнал для разборов инцидентов.
Экосистема без шлюза превращается в зоопарк SDK и непредсказуемые сбои при смене контрагента.
Суть проекта
INTEGRATIONS (8098) — единый шлюз внешних систем: ЭДО (СБИС, Контур и др. по проектной модели из integrations2026), банки, кассовое оборудование, маркетплейсы, службы доставки и прочие контуры, которые нельзя «вшить» в каждый модуль отдельно без хаоса ключей и форматов. Принцип платформы: нет дублирования клиентов биллинга, уведомлений и webhook-валидаторов — только через modouls/_shared и согласованные контракты.
Стек / технологии
- Сервис:
integrations-backend, порт 8098. - Протоколы: REST, SOAP, файловые шлюзы — по провайдеру; подпись запросов HMAC — по канону безопасности.
- Хранилище: PostgreSQL + секреты в env/vault по политике деплоя.
Фишки и возможности
- Единая точка конфигурации — учётные данные и ротация секретов на сервере, не в репозитории.
- Адаптеры провайдеров — смена интеграции без переписывания Orders/Shop целиком.
- Очереди и ретраи — устойчивость к временным сбоям API контрагентов.
- Связка с DOCUMENTS / FINANCE / DELIVERY — сквозные сценарии «заказ → документ → оплата → отгрузка».
- Наблюдаемость — журнал вызовов и ошибок для поддержки.
Тонкости и сложные моменты
- Каждый внешний сервис имеет своё SLA; платформа минимизирует технический долг, но не гарантирует аптайм банка или ЭДО.
- Новый провайдер — отдельный проект адаптера с тестовым контуром и правовым согласованием.
Полная документация (раскрыть)
Внешние интеграции — INTEGRATIONS
1) Краткое описание
INTEGRATIONS (8098) — единый шлюз внешних систем: ЭДО (СБИС, Контур и др. по проектной модели из integrations2026), банки, кассовое оборудование, маркетплейсы, службы доставки и прочие контуры, которые нельзя «вшить» в каждый модуль отдельно без хаоса ключей и форматов.
Принцип платформы: нет дублирования клиентов биллинга, уведомлений и webhook-валидаторов — только через modouls/_shared и согласованные контракты.
2) Полный охват потребностей пользователя
Зачем компании «полный» шлюз интеграций
- Один раз настроили банк/ЭДО/маркетплейс — все модули (Orders, Finance, Documents, Delivery) используют согласованные адаптеры.
- Смена провайдера не ломает весь Shop: меняется адаптер и конфигурация, а не бизнес-логика заказа.
- Безопасность — секреты не расползаются по репозиториям и клиентским приложениям.
Полный объём по ответственности модуля
INTEGRATIONS закрывает техническую связность с внешним миром. Не закрывает переговоры с банком, лицензии ЭДО и коммерческие условия контрагентов — это вне кода.
Типичные сценарии
ЭДО с контрагентом, загрузка выписок, вызов API службы доставки, обмен с маркетплейсом — каждый сценарий оформляется как адаптер + мониторинг ошибок + ретраи.
Главные фишки
- Единая точка конфигурации — учётные данные и ротация секретов на сервере, не в репозитории.
- Адаптеры провайдеров — смена интеграции без переписывания Orders/Shop целиком.
- Очереди и ретраи — устойчивость к временным сбоям API контрагентов.
- Связка с DOCUMENTS / FINANCE / DELIVERY — сквозные сценарии «заказ → документ → оплата → отгрузка».
- Наблюдаемость — журнал вызовов и ошибок для поддержки.
Технологический стек
- Сервис:
integrations-backend, порт 8098. - Протоколы: REST, SOAP, файловые шлюзы — по провайдеру; подпись запросов HMAC — по канону безопасности.
- Хранилище: PostgreSQL + секреты в env/vault по политике деплоя.
Допущения и важные оговорки
- Каждый внешний сервис имеет своё SLA; платформа минимизирует технический долг, но не гарантирует аптайм банка или ЭДО.
- Новый провайдер — отдельный проект адаптера с тестовым контуром и правовым согласованием.
Оценка стоимости
Один крупный адаптер (например, маркетплейс или банк) «под ключ»
- Ориентир: 3–12 млн ₽
- Сроки: 3–9 месяцев
Платформа интеграций как постоянно развиваемый контур
- Ориентир: 6–20 млн ₽/год на команду и сертификации
Сопровождение
- Ориентир: 150–650 тыс ₽/мес
Оценка стоимости
- **Ориентир**: **3–12 млн ₽**
- **Ориентир**: **6–20 млн ₽/год** на команду и сертификации
- **Ориентир**: **150–650 тыс ₽/мес**