ModernERP EAM / Рабочая инструкция

Материалы и подтверждённая стоимость ремонта EAM + ERP

Потребность наряда, резерв, выдача, расход и возврат материалов через ERP. Проверка прямых затрат на материалы и труд, доставка и права доступа.

Редакция от 21 ноября 2026 года. Действия и ограничения сверены с исходниками EAM; установленная версия и права могут отличаться.

Перед началом

Кому нужен доступ

Главный механик или администратор задаёт политику затрат и управляет повтором неуспешных команд. Планировочные роли ведут потребность, резерв и выдачу до начала; исполнитель фиксирует расход в своём разрешённом наряде. Администратор ERP явно разрешает склад.

Что подготовить

Согласованные обновления EAM и ERP, импортированная связь организации с ERP, scoped подключение и разрешённый склад. Нужны реальные партии с закупочной ценой, входящими движениями и согласованным физическим остатком. Один Stock без партии не подходит.

1. Включите связку и складское разрешение

Установите обновления обоих приложений штатным процессом: EAM Version20261121175015 и ERP Version20261121175141. Настройте каталог ERP → EAM. В ERP выдайте явное разрешение на склад, компанию, служебную учётную запись и валюту; пример команды ниже. Запустите обработку app:eam:supply:deliver по расписанию.

Проверьте результат: Компания входит в scope аккаунта. Склад связан с одной компанией, учётной записью и валютой; обычный read-only каталог не даёт складских прав.

2. Задайте валюту и ставку труда

В карточке наряда откройте «Обеспечение и стоимость ремонта». До начала работ задайте валюту и внутреннюю стоимость часа. Нулевая ставка требует явного значения. При наличии потребностей валюту менять нельзя; после начала нельзя менять и ставку.

Проверьте результат: Политика сохранена. Поддерживаются RUB, USD и EUR без конвертации; каждая новая запись труда сохраняет собственный снимок ставки.

3. Создайте потребность из партии ERP

Выберите разрешённую партию и количество до начала наряда. Разные партии оформляются отдельными строками: не более 100 строк на наряд. Количество поддерживает три знака после точки. Интерфейс показывает первые 200 партий; API каталога поддерживает offset и точечный выбор batchId.

Проверьте результат: Организация, склад, партия и валюта соответствуют ремонту. Доступ к чужим партиям не получен через подстановку ID.

4. Зарезервируйте и получите материал

Нажмите «Резервировать» и дождитесь подтверждения ERP. Резерв не уменьшает физический остаток. При shortage пополните запас или освободите резерв в ERP и повторите резерв новой командой. «Выдать» повторно проверяет наличие, уменьшает остаток и создаёт движение OUT.

Проверьте результат: Только подтверждение ERP переводит строку в reserved или issued. Pending и shortage не считаются выдачей; автоматически закупка не создаётся.

5. Выполните работу и урегулируйте расход

Начать управляемый наряд можно после выдачи всех действующих потребностей. Исполнитель регистрирует минуты труда. В in_progress укажите фактический расход каждой выданной строки: выданное минус израсходованное возвращается в тот же склад и партию движением IN. До начала можно снять резерв либо полностью вернуть выдачу для отмены наряда.

Проверьте результат: После подтверждения строка settled. Нет независимого ручного дублирования материалов; резерв и неиспользованная выдача не остались зависшими.

6. Проверьте подтверждённые прямые затраты

Материалы считаются по подтверждённому потреблению и цене партии, зафиксированной при выдаче; последующее изменение цены партии итог не переоценивает. Труд = минуты × ставка часа / 60. Денежные суммы округляются до двух знаков отдельно на строку материала и запись труда.

Проверьте результат: Пример: выдано 2 по 250,50 ₽; расход 1,5, возврат 0,5. Материалы 375,75 ₽ + 30 минут по 1200 ₽/час = 600 ₽ труда; итог 975,75 ₽. Это учебный сценарий, не показатель экономии.

7. Завершите и закройте наряд

Завершение требует урегулированных строк. Закрытие дополнительно требует подтверждённых зарегистрированных затрат, результата и соблюдения правил чек-листа. Старые ручные материалы и труд без снимка ставки показаны отдельно и не объявляются подтверждёнными автоматически.

Проверьте результат: Наряд закрыт после проверенного ответа ERP. В подтверждённый итог не включены неподтверждённые старые записи.

8. Разберите сбой доставки без повторного списания

Очередь повторяет доставку с задержкой; после восьми попыток команда получает failed. Главный механик или администратор может повторить её. Если ERP выполнил команду, но ответ потерялся, прежний commandId возвращает сохранённую квитанцию без нового движения. Отключённое подключение сохраняет pending и запрещает отправку.

Проверьте результат: Пока ответ не получен, EAM не продвигает складской факт. Между приложениями нет распределённой транзакции; ошибочный ответ не считается подтверждением.

Ограничения и ошибки

Только прямые затраты ремонта: без накладных расходов, НДС, зарплатных и бухгалтерских проводок, подрядчиков и полной калькуляции. Нет автозакупки, дополнительных потребностей после начала, замены партии, частичных выдач и нескольких возвратов одной строки. Резерв и выдача выполняются целиком для строки, частичный расход — при окончательном урегулировании. Standalone EAM поддерживает труд по ставке, материалы ERP требуют ERP. Старые наряды без политики затрат продолжают прежний процесс. Нагрузочный benchmark новой складской цепочки не проводился.

Если действие недоступно, проверьте роль, разрешения, принадлежность к участку и статус документа. При ошибке сохраните номер документа, время и текст сообщения; передайте их ответственному, прежде чем повторять изменяющую операцию.

Экраны интерфейса

Иллюстрации показывают отдельные экраны. Доступные действия сверяйте с вашей ролью и установленной версией; скриншоты не подтверждают выполнение всего сценария.

Обеспечение и стоимость закрытого наряда
Реальный интерфейс · учебные данныеРеальный интерфейс на изолированном учебном контуре EAM + ERP. Резерв, выдача, расход и возврат выполнены через API приложений: материалы 375,75 ₽, труд 600 ₽, подтверждённый итог 975,75 ₽. Данные вымышленные.Нажмите, чтобы открыть оригинал.

Примеры и команды

Явное разрешение склада в ERP

Административная операция в ERP. Замените идентификаторы; компания должна входить в scope аккаунта. Владение складом и валюта неизменяемы; --disable отключает разрешение. Незавершённую выдачу урегулируйте до отключения.

php bin/console app:eam:supply:grant \
  --account=ERP_CONNECTOR_ACCOUNT_UUID --company=ERP_COMPANY_ID \
  --warehouse=ERP_WAREHOUSE_ID --currency=RUB \
  --reason='Склад запчастей для согласованного контура ремонта'

Обработка очереди обеспечения в EAM

Настройте периодический запуск от пользователя приложения. Подключение и секрет берутся из сохранённой scoped конфигурации, а не из тела входящего запроса.

php bin/console app:eam:supply:deliver --limit=100

Чтение состояния и подтверждённых затрат

Учебный домен. Подставьте ID разрешённого наряда. Получите текущую version перед следующим действием; подтверждение ERP также увеличивает её.

curl --fail-with-body \
  -H "Authorization: Bearer $EAM_API_TOKEN" \
  -H "X-Tenant-ID: $EAM_TENANT_ID" \
  "https://eam.example.org/api/eam/v1/work-orders/$EAM_WORK_ORDER_ID/resources"

API обеспечения наряда

Метод и путь после /api/eam/v1/work-orders/{id}НазначениеПроверка
GET /resourcesПотребности, доставка, стоимость и versionДоступ к наряду
GET /supply-catalog?offset=0До 200 разрешённых партийСвязь организации и разрешение склада
PUT /cost-policyversion, currency, hourlyRate, reasonГлавный механик / администратор, до начала
POST /resourcesversion, batchId, quantity, reasonПланировочная роль, до начала
POST /resources/{requirementId}/{action}reserve / release / issue / return / settle / retryАктуальная version, reason; quantity для расхода settle
202 / 409Команда ожидает подтверждения / конфликтПеречитать состояние, не создавать повторную выдачу