MOD-INT-1C — Интеграция с 1С
Лицензия: Платный
Модуль соединяет контур с базой 1С и держит зеркало её данных. Подключение описывает тип конфигурации, адрес публикации и протокол; учётные данные шифруются в контуре и наружу не возвращаются. Обмен идёт асинхронными заданиями с ретраями и экспоненциальной задержкой: склады, номенклатура и остатки синхронизируются идемпотентно по ключу пакета, а конфликты артикулов пишутся в журнал расхождений, а не перезаписываются молча. Читающие ответы несут ссылку на источник 1С и момент актуальности; запись в 1С, изменение маппинга и разрешение расхождения требуют явного подтверждения. Собственных блоков холста модуль не отдаёт — это транспортный модуль, UI строится из пресетов холстов.
Возможности
- Подключения к 1С: типы конфигураций ut, bp, erp, retail; протоколы http-сервис, OData, файл, EnterpriseData
- Учётные данные шифруются AES-256-GCM в контуре и не выдаются наружу; проверка подключения без имитации
- Синхронизация складов и доставка структуры в MOD-WAREHOUSE; режимы полный и дельта
- Синхронизация номенклатуры с мастер-каталогом MOD-PRODUCTS; конфликты артикулов — в журнал расхождений
- Остатки по складам: зеркало с идемпотентной доставкой в MOD-WAREHOUSE по идентификатору пакета
- Документы в обе стороны: импорт статуса из 1С и запись с проведением в 1С с подтверждением
- Маппинг номенклатуры и складов: внешний идентификатор 1С против внутреннего; массовое изменение с подтверждением
- Задания обмена: идемпотентность по ключу пакета, ретраи с экспоненциальной задержкой, cron-расписание, статус и журнал
- Журнал расхождений с ручным разрешением; правило по умолчанию — 1С мастер данных остатков
- Сводка здоровья обмена: отставание, последний успех, упавшие задания, число расхождений
Основные MCP-инструменты
| Инструмент | Назначение |
|---|---|
int1c__describe_entities | Метаданные сущностей модуля без данных; зашифрованные учётные данные помечены как секрет |
int1c__describe_blocks | Блоки холста модуля — явно пустой список: транспортный модуль без собственных блоков |
int1c__get_roles | Ролевая модель модуля и право-флаги на подключение, обмен, маппинг, документы и задания |
int1c__get_canvas_presets | Готовые холсты: здоровье синхронизации, остатки по складам, карточка номенклатуры, маппинг и расхождения, визарды подключения и маппинга |
int1c__subscribe_events | Каналы живых событий обмена с 1С и путь SSE-потока |
int1c__connection.test | Проверить подключение к 1С: доступность, версия, задержка |
int1c__connection.configure | Настроить или изменить подключение к 1С (требует подтверждения) |
int1c__warehouse.list | Список складов 1С со статусом маппинга на MOD-WAREHOUSE |
int1c__warehouse.sync | Запустить синхронизацию структуры складов из 1С |
int1c__nomenclature.sync | Синхронизировать номенклатуру 1С с мастер-каталогом MOD-PRODUCTS |
int1c__stock.sync | Обновить остатки из 1С с идемпотентной доставкой в MOD-WAREHOUSE |
int1c__stock.get | Остатки номенклатура на склад: количество, резерв, доступно, источник и момент актуальности |
int1c__document.sync | Синхронизировать документ в 1С или из 1С; запись в 1С требует подтверждения |
int1c__mapping.get | Правила и состояние маппинга: внешний идентификатор 1С против внутреннего |
int1c__mapping.update | Изменить или перезаписать маппинг массово (требует подтверждения) |
int1c__job.run | Запустить или перезапустить задание обмена, опционально по cron-расписанию |
int1c__job.status | Статус и журнал задания обмена: попытки, ошибки, расхождения, источники |
int1c__discrepancy.list | Список расхождений: ожидалось, факт, источник, решение |
int1c__discrepancy.resolve | Разрешить расхождение вручную (требует подтверждения) |
int1c__report.sync_health | Сводка здоровья обмена: отставание, последний успех, упавшие задания, расхождения |
Блоки холста
Модуль не объявляет собственных блоков холста: describe_blocks возвращает пустой список, UI строится на пресетах get_canvas_presets.