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

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

• Один агент — один склад. УТМ установлен локально на каждом рабочем месте; в облаке для этого склада создаётся запись агента с ключом доступа.
• Исходящие документы (запросы, накладные и т.д.) ставятся в очередь в 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 на этом складе.

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

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

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

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

Тест: кнопка Обновить остатки ставит в очередь запросы Р1 (QueryRests_v2, склад) и Р2 (QueryRestsShop_v2, зал). После ответа склада по каждой справке Б уходит Р3 (QueryRestBCode) — акцизные марки; УТМ обычно принимает не чаще одного такого запроса за ~10 минут. В таблице колонки Р1 / Р2 / Р3 / марки. FSRAR_ID — из карточки склада.

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

Возврат пива поставщику

Два независимых сценария. Агент УТМ тот же — документы уходят в очередь исходящих.

1. Списание с торгового зала

1. Вкладка Остатки → Обновить остатки → дождитесь ответов (в колонке Р2 должно быть количество).
2. Списать (зал) — отметьте позиции с остатком в зале, при необходимости уменьшите количество. Допускаются дробные значения (например 1.6 дал).
3. В УТМ уходит акт ActWriteOffShop_v2 с причиной «Иные цели» и примечанием «Возврат поставщику».

Подходит, когда нужно снять пиво с регистра 2 без исходящей ТТН поставщику. Локальная входящая накладная в журнале не нужна.

2. Исходящая ТТН возврата

1. Если приёмка была в другой программе — Перезапросить ТТН по номеру TTN-…. Дождитесь появления дубликата на вкладке «Накладные».
2. Не нажимайте «Принять» повторно: накладная уже принята во внешней системе. Повторный акт приёмки запрещён, если в журнале уже есть успешная квитанция.
3. Откройте накладную → Оформить возврат → отметьте позиции и количества, заполните все обязательные поля транспорта (смена собственности, тип перевозки, тип ТС, перевозчик, для авто — госномер, водитель, места погрузки и разгрузки) → отправка. Без этих полей ЕГАИС отклонит XML (XSD). Количество можно дробным (например 1.6 дал).
4. В УТМ уходит WayBill_v4 с типом WBReturnFromMe (без тега Supplier; в позиции — wb:Product с полями pref:*, namespace CommonV3 для F2RegId). После ответа ФСРАР квитанция привязывается к исходящей ТТН на вкладке Накладные → Исходящие (в т.ч. по TransportId, пока нет номера TTN-…). При успехе появится номер TTN-…; при отказе — статус «Отклонена» и текст ошибки из квитанции. Поставщик видит документ только после успешной регистрации.

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

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