ModernERP EAM / Рабочая инструкция
Синхронизация оборудования ModernERP ERP и EAM
Свяжите существующие карточки, проверьте изменения каталога и примените их без дублей и потери технической истории.
Редакция от 21 ноября 2026 года. Действия и ограничения сверены с исходниками EAM; установленная версия и права могут отличаться.
Перед началом
Кому нужен доступ
Администраторы ERP и EAM настраивают служебную учётную запись, scope и подключение. Производственная принадлежность и разрешённые компании задаются в ERP; обычная роль механика не управляет интеграцией.
Что подготовить
Установки ERP и EAM с совместимым контрактом, HTTPS-адрес, разрешённые компании, tenant и отдельный service token. Реальные токены хранятся вне репозитория; сначала используйте согласованный тестовый контур.
1. Подготовьте каталог в ERP
Проверьте цепочку Company → площадка → привязка участка → оборудование. Локальный администратор подтверждает принадлежность с причиной и аудитом. Непроверенные станки и цеха не экспортируются автоматически.
Проверьте результат: Экспортируемая структура соответствует организационному scope учётной записи, а не всему содержимому ERP.
2. Настройте подключение EAM
В «Интеграциях» создайте подключение ERP, задайте адрес и параметры привязки. Укажите секрет в EAM_PRO_TOKENS для конкретного connection UUID. Проверяйте установку и tenant; не используйте один connection для другого независимого источника.
Проверьте результат: Секрет не находится в карточке оборудования, JSON-аудите или публичном файле. Адрес и scope принадлежат нужной ERP.
3. Получите preview и сопоставьте карточки
Загрузите каталог через штатный интерфейс, изучите предварительный результат. Свяжите ранее созданные локальные карточки явно. Совпадение имени либо номера не означает согласие на автоматическое объединение.
Проверьте результат: Конфликты источника, номера, ownership и организации разобраны до commit. Preview не изменил оборудование.
4. Примените согласованный пакет
Подтвердите commit. Применение каталога, identities, аудит и checkpoint записываются согласованно. Если ревизия, настройки или данные изменились после preview, получите новый preview вместо повторов устаревшего пакета.
Проверьте результат: Структура и количество объектов ожидаемы; повтор того же snapshot/batch не создаёт дубли.
5. Соблюдайте владение полями
Производственные имя, номер и структура ERP-owned оборудования редактируются в ERP; EAM и CSV-импорт не обходят запрет. Техническое состояние, обслуживание и ремонтная история ведутся в EAM.
Проверьте результат: Обновление источника не затёрло локальные технические данные. Производственное имя не исправляется параллельно в двух системах.
6. Разберите исчезновение или возврат объекта
Исчезнувшая запись получает состояние missing без удаления карточки, смены технического статуса или автоматической архивации. Возврат того же source ID сохраняет локальный UUID. Отключение интеграции не снимает ownership.
Проверьте результат: История ремонтов остаётся связанной с тем же оборудованием; пропажу из источника не приняли за доказательство физического списания.
7. Настройте обеспечение ремонта отдельно от каталога
Чтение каталога не даёт права изменять склад. Для резервирования, выдачи и возврата администратор ERP явно разрешает склад, организацию, служебную учётную запись и валюту. Примените согласованные обновления обоих приложений и включите обработку очереди обеспечения.
Проверьте результат: Есть складское разрешение и доступные партии с ценой и согласованными остатками. Детальная настройка описана в инструкции «Материалы и стоимость ремонта».
Ограничения и ошибки
Одна установка ERP соответствует одному tenant EAM. Текущий каталог ограничен 5 000 суммарных записей, включая структуру, а не только машины. Это конкретная интеграция с ERP, не готовый универсальный коннектор 1С.
Если действие недоступно, проверьте роль, разрешения, принадлежность к участку и статус документа. При ошибке сохраните номер документа, время и текст сообщения; передайте их ответственному, прежде чем повторять изменяющую операцию.
Примеры и команды
Распределение ответственности
Схема объясняет владение данными. Никакие рабочие подключения этим примером не создаются.
Pro: компания → площадка → участок → оборудование
EAM: состояние → регламент → заявка → наряд → простой
Preview → явное сопоставление → commit → повтор без дублей