ЕГАИС — агент УТМ

Как это устроено

• Один агент — один склад. УТМ установлен локально на каждом рабочем месте; в облаке для этого склада создаётся запись агента с ключом доступа.
• Исходящие документы (запросы, накладные и т.д.) ставятся в очередь в ERP → агент забирает XML → отправляет в УТМ.
• Входящие ответы ФСРАР агент читает из УТМ → передаёт в облако → вы видите их в журнале ERP.
• Модуль доступен всем базам: откройте Интеграции → ЕГАИС — агент УТМ, настройте агент для нужного склада.

Раздел в программе: Интеграции → ЕГАИС. Откроется журнал обмена (накладные, квитанции, исходящие). Кнопка Настройка в журнале — tray-агент и параметры УТМ. Перед работой выберите нужный склад в шапке ERP.

Скачивание и установка агента

1. В окне «ЕГАИС — агент УТМ» нажмите Скачать MercwebEgaissAgent.exe.
2. Сохраните файл на компьютер, где установлен и запущен УТМ (обычно тот же ПК, что и касса/склад).
3. Запустите exe. При первом запуске откроется окно Настройки — блок конфигурации вы получите на следующем шаге в браузере.
4. По желанию включите Запускать вместе с Windows в настройках агента.

После настройки программа сворачивается в трей (иконка у часов). Двойной клик по иконке — окно с логом и статусом. Кнопка Свернуть снова прячет окно в трей; для выхода используйте пункт меню Выход.

Окно «Настройка» в журнале

В журнале ЕГАИС нажмите Настройка. Для текущего склада автоматически подготовлен один агент — в текстовом поле блок config_text для tray-программы. Скопируйте его целиком.

После настройки агент при каждом запуске сверяет свою версию с /download/egaiss-agent.json на сервере и при необходимости сам скачивает новый exe и перезапускается.

После настройки агент при каждом запуске сверяет свою версию с /download/egaiss-agent.json на сервере и при необходимости сам скачивает новый exe и перезапускается.

1. Скачайте MercwebEgaissAgent.exe по ссылке в окне.
2. Нажмите Копировать и в агенте на ПК: Настройки → Вставить из буфера → ОК.
3. В том же окне укажите FSRAR_ID и нажмите Сохранить — он попадёт в config_text агента. Хост и порт УТМ — в карточке склада (Касса → ЕГАИС).

Если агент ещё не был создан, он появится при первом открытии настроек — отдельная кнопка «Создать» не нужна.

Агент в ERP (устаревший способ)

Раньше агента создавали вручную. Сейчас достаточно открыть Настройку — config_text сформируется автоматически.

Параметры склада (УТМ и FSRAR_ID)

В карточке контрагента-склада: вкладка Касса → блок ЕГАИС (УТМ на этом складе):

• УТМ, хост — IP или имя машины с УТМ (часто 127.0.0.1).
• УТМ, порт — порт HTTP УТМ (часто 8080).
• FSRAR_ID организации — идентификатор организации в ЕГАИС (12 цифр).

Эти значения подставляются при создании агента и в тестовом запросе остатков. Их же получает касса при выгрузке прайса, если используется Mercury-POS на этом складе.

Открыть карточку: Справочники → Контрагенты → склад → вкладка Касса.

Журнал обмена

Как в десктопной Меркурий-ERP: слева разделы Накладные, Квитанции, Исходящие, Отправленные, Удалённые, Остатки. Сверху — панель действий (синхронизация, просмотр XML, открыть накладную). Двойной клик по строке открывает карточку документа с вкладками «Товары» и «Квитанции».

Настройка — отдельное окно: скачивание tray-агента и готовый config_text для текущего склада (один агент на склад).

Тест: кнопка Получить остатки ставит QueryRestsShop_v2 в очередь; агент отправит его при следующем цикле обмена. Используется FSRAR_ID из карточки склада (вкладка «Касса»).

Перезапросить ТТН — если входящую накладную случайно удалили из УТМ или журнала: введите регистрационный номер ЕГАИС (WBREGID, вид TTN-…). В очередь уходит QueryResendDoc, агент отправляет в УТМ, ФСРАР снова присылает накладную. Запрашивать может только грузополучатель; УТМ часто ограничивает частоту (примерно раз в 10 минут). Если в таблице выбрана строка накладной, номер подставляется автоматически.

Если не работает

• Убедитесь, что УТМ запущен и открывается в браузере по адресу http://127.0.0.1:8080/ (порт может отличаться).
• Проверьте, что агент запущен в трее на том же ПК, что и УТМ.
• Откройте окно агента — в логе смотрите сообщения [ERR]. Полный лог: файл agent.log в %AppData%\MercwebEgaiss\.
• Если secret утерян — создайте нового агента для склада и заново вставьте config в программу.
• Кнопки «ЕГАИС» нет — обновите страницу ERP или обратитесь в поддержку.