Универсальный транспортный модуль (УТМ), это программный шлюз, обеспечивающий защищенный обмен данными между информационной системой участника оборота алкогольной продукции и системой ЕГАИС (Единая государственная автоматизированная информационная система). Отправка запросов в УТМ — это ежедневная операция для учетных систем (1С, r_keeper, StoreHouse и др.), необходимая для получения остатков, проверки накладных, справочников и статусов документов.
В данной статье подробно рассмотрены способы формирования и отправки запросов, основные типы запросов, работа с ответами и типичные проблемы.
Предварительные требования
Перед отправкой любого запроса убедитесь, что выполнены следующие условия:
- УТМ запущен и работает. Проверьте статус службы (обычно доступен по адресу
http://localhost:8080илиhttp://IP_адреса_сервера:8080). - Действует сертификат ЭЦП. Ключевой носитель (РуТокен, eToken, JaCarta) должен быть вставлен в сервер, где установлен УТМ, и сертификат не должен быть просрочен или отозван.
- Настроена сеть. УТМ должен иметь доступ к интернету (порт 443) для связи с серверами ФСРАР. Настройте прокси/фаервол при необходимости.
- Зарегистрирован участник. В УТМ должен быть импортирован файл регистрации (reg.xml) или выполнена процедура регистрации через веб-интерфейс.
Основные способы отправки запросов
Через веб-интерфейс УТМ (ручной режим)
Это базовый способ для администраторов и тестирования.
- Откройте браузер и перейдите по адресу
http://localhost:8080. - Авторизуйтесь (по умолчанию логин/пароль могут отсутствовать или быть заданы в настройках).
- Перейдите в раздел «Запросы» или «Документы» (интерфейс может незначительно отличаться в версиях 2.x, 3;x, 4.x).
- Выберите тип запроса из выпадающего списка.
- Заполните обязательные параметры (Алкокод, ИНН, Код ЕГАИС накладной, Период, Серия/Номер марки и т.д.).
- Нажмите кнопку «Отправить» или «Сформировать запрос».
- Результат появится в журнале запросов. Ответ (XML-файл) можно скачать по ссылке в столбце «URL» или «Файл».
Из учетных систем (1С, r_keeper, StoreHouse Pro и др.)
Это основной рабочий режим. Учетная система выступает клиентом УТМ.
Пример настройки в r_keeper / StoreHouse Pro (на основе документации):
- Откройте окно «Запросы ЕГАИС».
- Заполните фильтр: поля «Юр. лицо» и «КПП» обязательны.
- Нажмите «Применить» для построения списка предыдущих ответов и активации кнопок новых запросов.
- Выберите нужный тип запроса (см. раздел 3) и нажмите кнопку отправки.
Важно: Ответы на запросы в ЕГАИС не хранятся в базе учетной системы постоянно. При выводе происходит прямое обращение к УТМ. В самом УТМ ответы хранятся сутки после оформления запроса, затем удаляются.
Программно через API (HTTP POST)
Для собственных разработок или интеграций. УТМ принимает XML-запросы по HTTP.
- Адрес:
http://localhost:8080/opt/out(для исходящих запросов) или специфические эндпоинты в зависимости от версии УТМ. - Метод: POST.
- Content-Type:
application/xmlилиtext/xml. - Тело запроса: XML в формате ФСРАР (например,
QueryRestsдля остатков).
Пример структуры запроса остатков (упрощенно):
<?xml version="1.0" encoding="UTF-8"?>
<QueryRests>
<Header>
<Version>1.0</Version>
<ClientId>ИНН_КПП</ClientId>
</Header>
<Body>
<Type>1</Type> <!-- 1 ౼ первый регистр, 2 ─ второй регистр -->
</Body>
</QueryRests>
Основные типы запросов и их назначение
Список доступных запросов зависит от версии УТМ и прав участника. Ниже приведены наиболее востребованные типы (согласно документации r_keeper/EGAIS):
| Тип запроса | Назначение | Ключевые параметры |
|---|---|---|
| Остатки 1-го регистра | Получение остатков на складе (производство/импорт/опт). Основа для акта постановки на баланс, акта передачи в зал, акта списания. | Период (опционально) |
| Остатки 2-го регистра | Остатки в торговом зале (розница). Для акта постановки на баланс в зале, возврата из зала на склад, списания из зала. | Период (опционально) |
| Запрос остатков штрихкодов (Справка Б) | Остатки марок маркируемой продукции (версия 3 накладных). | Алкокод / Идентификатор справки Б |
| Запрос порционных остатков штрихкодов | Остатки марок в разрезе объема (мл) для частично реализованной бутылки. | Алкокод / Идентификатор справки Б |
| Товар по коду ЕГАИС (Алкокод) | Получение полной информации о номенклатуре (наименование, крепость, объем, производитель). | Алкокод (19 знаков) |
| Товары корреспондента по ИНН | Список алкогольной продукции производителя/импортера. | ИНН корреспондента |
| Корреспонденты по ИНН | Список подразделений (КПП) контрагента по его ИНН. | ИНН корреспондента |
| Движение между регистрами | История перемещений конкретной позиции по алкокоду между регистрами 1 и 2. | Алкокод, Период |
| Повторный запрос неподтвержденных накладных | Получение списка всех входящих ТТН, которые не были подтверждены/отклонены. | — |
| Повторный запрос накладной по коду ЕГАИС | Получение конкретной накладной (подтвержденной или нет) по её идентификатору (UUID/РегНомер). | Код ЕГАИС накладной |
| Запрос Справки А | Информация по производству/импорту партии товара (первичный документ). | Номер/Дата Справки А |
| Запрос Справки Б | Подробная информация по конкретной поставке (электронная Справка Б). | Идентификатор Справки Б |
| Движение по справке Б | История движения конкретной поставки (кто, куда, когда перемещал). | Идентификатор Справки Б |
| Получение штрих-кода по серии и номеру марки | Получение кодов DPF417 (DataMatrix) для маркируемой продукции. | Тип продукции, Серия, Номер марки |
| Запрос на изменение версии | Информирование ЕГАИС о готовности обрабатывать накладные 2-й версии (исторический запрос, сейчас актуальна 3-я версия). | — |
Работа с ответами (Результатами)
После отправки запрос ставится в очередь УТМ. Обработка может занять от нескольких секунд до минут (зависит от нагрузки на ЕГАИС и объема данных).
Где искать ответ:
- В веб-интерфейсе УТМ: Раздел «Запросы» / «Исходящие» / «Входящие». Статус должен стать «Выполнен» или «Ошибка».
- В учетной системе: Окно «Запросы ЕГАИС» (обновите список кнопкой «Применить» или F5).
- Файловый обмен (для разработчиков): Ответы кладутся в папку
/opt/out(или настроенную папку обмена) в виде XML-файлов с префиксомreply_илиTicket_.
Структура ответа в журнале:
- Тип запроса — наименование (например, «Остатки 1-го регистра»).
- Параметры — что запрашивали (алкокод, ИНН, период).
- Дата, время, момент получения ответа от ЕГАИС.
- URL / Ссылка на XML — прямая ссылка для скачивания файла ответа.
Критически важно: Ответ в УТМ живет 24 часа. Необходимо успеть загрузить его в учетную систему (1С, r_keeper) за это время, иначе придется отправлять запрос повторно.
Типичные ошибки и их устранение
«Время ожидания истекло» / «Нет связи с УТМ»
- Проверьте, запущена ли служба UTM (в Windows: services.msc -> UTM; в Linux:
systemctl status utm). - Проверьте порт 8080 (или настроенный):
netstat -an | findstr 8080. - Антивирус/Фаервол блокирует локальные соединения (localhost). Добавьте исключение для Java-процессов УТМ.
- Если УТМ на другом сервере — проверьте сетевую доступность (ping, telnet IP 8080).
Ошибки криптографии (PKI, ГОСТ)
- Сертификат истек или отозван — обновите ЭЦП, перерегистрируйте УТМ.
- Не установлены корневые сертификаты УЦ ФСРАР (MinComSvyaz, ФСРАР) в хранилище «Доверенные корневые центры сертификации» на сервере УТМ.
- Проблемы с драйверами токена (РуТокен, eToken) — переустановите драйверы, проверьте в «Панели управления» -> «Криптография».
Ошибки формата XML / Валидации
- Неверная версия формата (пытаетесь отправить v2 вместо v3/v4). Обновите УТМ до актуальной версии (на 2026 г. это ветка 4.x).
- Ошибки в кодировке (должна быть UTF-8);
- Несуществующий Алкокод / ИНН / РегНомер — проверяйте справочники перед отправкой.
Пустой ответ или «Данные не найдены»
- По запрошенному периоду/алкокоду действительно нет движений.
- Запрос Справки Б/А по несуществующему идентификатору.
- Для остатков: проверьте, что организация имеет доступ к запрашиваемому регистру (КПП).
Лучшие практики и рекомендации
- Автоматизируйте опрос. Настройте в 1С/учетке регулярный опрос УТМ (каждые 15-30 мин) для забора входящих ТТН и ответов на запросы остатков.
- Логируйте всё. Ведите журнал отправленных запросов (ID запроса, время, параметры) для расследования споров с ЕГАИС.
- Используйте «Повторный запрос неподтвержденных накладных» ежедневно утром — это гарантирует, что ни одна входящая ТТН не потеряется.
- Обновляйте УТМ своевременно. ФСРАР регулярно выпускает обновления (поддержка новых форматов накладных, маркировки, изменения API). Устаревший УТМ перестанет принимать ответы.
- Резервное копирование. Бэкапьте папку
/utm(ключи, настройки, базу H2) перед обновлениями.
Отправка запросов в УТМ — это ключевой процесс обеспечения актуальности данных в ЕГАИС. Понимание типов запросов (остатки по регистрам, справки А/Б, накладные, маркировка), правил работы с ответами (срок хранения 1 сутки) и диагностики типичных сбоев (связь, криптография, версии форматов) позволяет строить надежную автоматизацию учета алкоголя.
Всегда используйте актуальную документацию ФСРАР и вашего ПО учета (1С, r_keeper, StoreHouse), так как форматы XML и API УТМ эволюционируют с каждым крупным обновлением законодательства.