Интеграции MES/WMS: 1С, API, ТСД, оборудование

Система не существует в изоляции. Она обменивается данными с 1С, внешними API, сканерами ТСД, промышленным оборудованием. Архитектура интеграций — отдельный слой, не встроенный в ядро. Добавление новой интеграции не затрагивает существующий код.

1С

REST API / HTTP-сервисы, обмен файлами (XML/JSON), прямое подключение к БД (ограниченно). Остатки, заказы, документы, справочники.

REST API

Внешние системы подключаются через REST API. OpenAPI-документация генерируется автоматически. Токены, роли, лимиты запросов.

ТСД и сканеры

Терминалы сбора данных со сканером штрихкодов/QR. Приёмка, размещение, комплектация, отгрузка, инвентаризация — с подтверждением сканированием.

Честный ЗНАК

Маркировка товаров, прослеживаемость. Интеграция с системой Честный ЗНАК для кодов маркировки и статусов.

ЭДО и ЭТРН

Электронный документооборот: УПД, ЭТРН, накладные. Передача документов между системами без ручного ввода.

Оборудование

Промышленное оборудование, весы, принтеры этикеток. Подключение через протоколы оборудования или промежуточные сервисы.

Интеграционный слой — отдельный модуль. Каждая интеграция — независимый адаптер с общим интерфейсом. Обмен может быть синхронным (REST API) или асинхронным (очереди задач, регламентные задания).

Синхронный обмен — запрос-ответ в реальном времени. Подходит для операций, где нужен мгновенный ответ (остатки, статусы).
Асинхронный обмен — постановка в очередь, обработка по расписанию. Подходит для пакетной передачи документов, выгрузок, синхронизации справочников.
Логирование — журнал всех обменов с расхождениями и ошибками. Уведомления при сбоях.
Повторы — автоматический повтор при временных сбоях внешней системы.

1С — двусторонний обмен остатками, заказами и документами (WMS РефГо, Людиновокабель)
ТСД — терминалы сбора данных со сканером (WMS РефГо, Людиновокабель)
Честный ЗНАК — маркировка продукции (АПК)
ЭТРН — электронные транспортные накладные (Личный кабинет РефГо)
REST API — внешний API для клиентов логистического оператора (Личный кабинет РефГо)

Разобрать ваши интеграции

Аудит — 30 минут. Оценим, какие интеграции нужны и как их реализовать.

Записаться на аудит

TL;DR

Интеграции реализованы как отдельный слой с REST API, журналом обмена, retry-логикой и идемпотентностью. Добавление новой интеграции не затрагивает ядро системы.

Проблема

Системы обмениваются данными с 1С, внешними API, ТСД, оборудованием. Сетевые сбои, таймауты, дубли запросов —常态. Без надёжного интеграционного слоя обмен становится хрупким и непрозрачным.

Контекст

80+ систем работают с 1С, REST API внешних сервисов, ТСД через WebSocket/HTTP. Заказчики требуют журнал обмена для аудита и возможности повторной отправки при сбое.

Решение

Каждая интеграция — отдельный модуль в интеграционном слое: (1) REST API для внешних вызовов; (2) журнал обмена (exchange_log) с статусом, retry-счётчиком и временем; (3) идемпотентность через Idempotency-Key; (4) retry с экспоненциальной задержкой; (5) аутентификация через API-key/JWT.

Компромиссы

Плюс: журнал обмена даёт прозрачность — видно, что отправлено, когда, с каким результатом.
Плюс: идемпотентность защищает от дублей при повторных запросах.
Плюс: retry-логика восстанавливается после сетевых сбоев без ручного вмешательства.
Плюс: новая интеграция — новый модуль, ядро не трогается.
Минус: журнал обмена растёт — нужна ротация/архивация.
Минус: идемпотентность требует хранения ключей — дополнительная таблица.
Минус: retry маскирует проблемы — плохая интеграция может «молча» ретраиться бесконечно.

Результат

Интеграции с 1С работают в production у 80+ клиентов. Журнал обмена используется для аудита и разбора инцидентов. Retry восстанавливает обмен после сетевых сбоев.

Ограничения

Журнал обмена требует ротации — при больших объёмах растёт размер БД.
Retry-логика должна иметь потолок попыток — иначе «молчащие» интеграции накапливают ошибки.
Идемпотентность работает только при корректной передаче Idempotency-Key со стороны 1С — не все интеграции это поддерживают.

Источники

Страница /solutions/1c-integration — детальное описание интеграции с 1С
Кейс: WMS для РефГо — интеграция с 1С, REST API, рост 50 → 1500+ заказов
Кейс: Личный кабинет РефГо — REST API, −80% звонков
Кейс: WMS для Людиновокабель — интеграция с 1С, ТСД

Интеграции

Типы интеграций

1С