Подключение 1С 8.3 к ЕГАИС через УТМ: от токена до первой входящей накладной
Содержание
Чтобы загрузить ЕГАИС в 1С 8.3, нужны три вещи: аппаратный ключ (токен) с КЭП и RSA-ключом, установленный на компьютере Универсальный транспортный модуль (УТМ) и адрес этого УТМ, прописанный в настройках 1С. Обычный адрес — http://localhost:8080, если 1С и УТМ стоят на одном компьютере. После этого 1С сама забирает из УТМ входящие накладные и отправляет ответы.
Сама 1С с серверами ЕГАИС напрямую не общается. Посредник — УТМ: он шифрует и подписывает документы ключом с токена. Поэтому порядок всегда один: сначала токен и ключи, потом УТМ, и только затем настройка в 1С. Если начать с 1С, обмен не заработает, сколько ни проверяй настройки программы.
Подготовка токена, КЭП и RSA-ключа
УТМ работает только с аппаратным носителем. Файловый ключ из реестра или с флешки не подойдёт. Подходят носители, которые хранят ГОСТ-ключ и умеют держать RSA-ключ: Рутокен ЭЦП 2.0 / 3.0 и JaCarta SE (связка ГОСТ + PKI).
На токене должны оказаться два ключа:
- 🔐 ГОСТ-ключ (КЭП) — квалифицированная подпись руководителя организации или ИП. Для юрлиц её выпускает удостоверяющий центр ФНС.
- 🔑 RSA-ключ — транспортный ключ для защищённого канала с ЕГАИС. Его генерируют в личном кабинете ЕГАИС отдельно на каждое место деятельности (каждый КПП).
Как получить RSA-ключ
- Вставьте токен в компьютер, на котором будет работать УТМ.
- Зайдите на сайт
egais.ruи откройте вход в личный кабинет. - Пройдите проверку условий доступа: сайт проверит браузер, плагин «ФСРАР-Крипто» и драйвер носителя. Всё, что подсвечено как ошибка, установите по ссылкам на той же странице.
- Введите PIN-код ГОСТ-ключа и войдите по КЭП.
- В кабинете откройте получение ключа, выберите место деятельности (КПП и адрес) и запишите RSA-ключ на токен. Понадобится PIN-код PKI-части носителя.
Заводские PIN-коды, если их не меняли: Рутокен — 12345678; JaCarta SE — PKI 11111111, ГОСТ 0987654321. После трёх-десяти неверных попыток (зависит от модели) PIN блокируется, и разблокировать его можно только PIN-кодом администратора.
Один токен — одно место деятельности. Если у организации два магазина с разными КПП, нужны два RSA-ключа, а на практике — два токена и два УТМ. Один УТМ обслуживает одно место деятельности.
Установка Универсального транспортного модуля
Дистрибутив УТМ скачивают в том же личном кабинете ЕГАИС, после записи RSA-ключа. Брать установщик с посторонних сайтов не стоит: версия может быть старой, а файл — изменённым.
Порядок установки на Windows
- Не вынимайте токен. Закройте браузер, чтобы он не держал носитель.
- Запустите установщик от имени администратора.
- Оставьте каталог по умолчанию — обычно
C:\UTM. Путь без пробелов и кириллицы избавляет от лишних проблем. - Установщик сам проверит носитель, найдёт RSA-ключ и привяжет УТМ к идентификатору организации (ФСРАР ID).
- После установки в службах Windows появятся службы транспортного модуля. Проверьте, что они запущены и тип запуска — «Автоматически».
УТМ поставляется со своей средой Java, отдельно её ставить не нужно. Компьютер должен быть включён всё рабочее время: пока УТМ выключен, накладные копятся на сервере ЕГАИС, а чеки в рознице не уходят.
Где ставить УТМ, если 1С на сервере
| Схема | Адрес УТМ в 1С | Что учесть |
|---|---|---|
| 1С и УТМ на одном ПК | http://localhost:8080 | Самый простой вариант для одного магазина |
| УТМ на кассовом ПК, 1С на другом | http://192.168.1.25:8080 (IP компьютера с УТМ) | Откройте порт 8080 в брандмауэре на ПК с УТМ, IP закрепите |
| Несколько КПП | Отдельный УТМ на каждый КПП, у каждого свой адрес | В 1С заводится столько подключений, сколько УТМ |
| 1С в облаке или на удалённом сервере | IP или имя ПК с УТМ, доступное из сервера 1С | Нужен VPN или проброс порта; токен остаётся у вас в офисе |
Если 1С работает в клиент-серверном варианте, запросы к УТМ могут уходить с сервера 1С, а не с компьютера пользователя. Тогда localhost укажет на сам сервер, где УТМ нет. Пропишите реальный IP компьютера с УТМ.
Проверка связи: что показывает страница УТМ
Откройте в браузере на компьютере с УТМ адрес http://localhost:8080. Должна загрузиться домашняя страница модуля. На ней смотрите:
- 🆔 ФСРАР ID — двенадцатизначный идентификатор организации в ЕГАИС. Он понадобится в 1С.
- 📅 Сроки сертификатов RSA и ГОСТ — оба должны быть действующими. Просроченный RSA-ключ останавливает обмен целиком.
- 🌐 Статус соединения с ЕГАИС — признак, что модуль видит сервер.
- 🔢 Версия УТМ — нужна при обращении в поддержку.
Если страница не открывается вовсе, служба не запущена или ещё стартует: после перезагрузки компьютера модулю нужно одна-две минуты.
Проверьте и доступ со стороны 1С. На компьютере или сервере, где работает 1С, откройте http://<адрес УТМ>:8080. Не открылось — проблема в сети или брандмауэре, а не в программе 1С.
Входящие документы, которые УТМ уже получил, видны по адресу http://localhost:8080/opt/out. Это список ссылок на XML-файлы. 1С читает их отсюда и после обработки удаляет из УТМ. Если список растёт, а в 1С ничего не появляется, программа не доходит до модуля.
Настройка обмена с ЕГАИС в 1С 8.3
Логика одна во всех типовых конфигурациях: включить учёт алкогольной продукции, завести организацию ЕГАИС с ФСРАР ID и указать адрес УТМ. Отличаются только пути.
| Конфигурация | Где включить ЕГАИС | Где задать подключение к УТМ |
|---|---|---|
| Бухгалтерия предприятия 3.0 | Главное → Функциональность, вкладка «Торговля» | Настройки обмена с ЕГАИС в разделе Администрирование |
| Управление торговлей 11, Розница 2.3 | НСИ и администрирование, настройки интеграции с ЕГАИС | Там же, в настройках обмена с ЕГАИС |
Быстрее всего найти нужную форму поиском по меню: начните вводить «ЕГАИС» в строке поиска интерфейса, и 1С покажет все связанные команды.
Шаги настройки
- Включите функциональность. Поставьте флажок учёта алкогольной продукции и обмена с ЕГАИС. После этого в разделах появятся документы ЕГАИС.
- Заведите организацию ЕГАИС. В классификаторе организаций ЕГАИС создайте элемент для своего места деятельности: укажите ФСРАР ID со страницы УТМ, ИНН, КПП и сопоставьте с организацией и складом (магазином) в 1С.
- Пропишите УТМ. В настройках обмена укажите адрес и порт модуля — например,
localhostи8080— и свяжите подключение с организацией ЕГАИС. - Настройте расписание. Включите регламентное задание обмена с ЕГАИС, чтобы 1С забирала документы сама. В файловой базе задания выполняются, только пока запущен хотя бы один сеанс 1С.
- Проверьте пользователя. Тому, кто принимает накладные, нужны права на документы ЕГАИС. В типовых профилях групп доступа есть отдельные роли для работы с ЕГАИС.
Не уверены, правильно ли указан адрес, — нажмите в настройке команду проверки подключения, если она есть в вашем релизе, или запросите из 1С любой справочник (см. следующий раздел). Ответ пришёл — связь в порядке.
Первичная загрузка: остатки, справочники, накладные
Сразу после подключения база пустая: 1С не знает ни ваших остатков в ЕГАИС, ни поставщиков. Заполняют её запросами через УТМ.
Что запросить в первую очередь
- Остатки. Отправьте запрос остатков. Для розницы их два: на складе (регистр 1) и в торговом зале (регистр 2). Ответ придёт в течение нескольких минут, иногда дольше — зависит от загрузки ЕГАИС.
- Организации. Запросите данные поставщиков по ИНН. Ответ ляжет в классификатор организаций ЕГАИС — дальше 1С будет узнавать их в накладных.
- Алкогольную продукцию. Справочник продукции ЕГАИС пополняется из накладных и ответов на запросы. Каждую позицию сопоставьте с номенклатурой 1С один раз — при следующих поставках сопоставление подставится само.
Входящие накладные
После обмена входящие ТТН появятся в списке входящих документов ЕГАИС. Дальше обычный цикл:
- проверить количество и позиции против фактической поставки;
- при расхождениях — оформить акт расхождений, при полном совпадении — подтвердить накладную;
- на основании ТТН создать поступление товаров в учётной части 1С.
На ответ по накладной есть срок, установленный правилами ЕГАИС. Если поставщик выгрузил ТТН, а УТМ неделю был выключен, накладная может быть подтверждена автоматически без вашей проверки. Держите модуль включённым.
Ошибки при загрузке ЕГАИС и что с ними делать
Большинство сбоев сводится к трём местам: токен, служба УТМ, сетевой путь от 1С к модулю. Ищите по симптому.
Если не помогло
- 🔁 Перезагрузите компьютер с УТМ целиком, а не только службы: так освобождается токен, который мог «зависнуть».
- 🧪 Попробуйте токен на другом компьютере: если личный кабинет ЕГАИС тоже не видит ключ, проблема в носителе.
- 📄 Посмотрите последние записи журналов УТМ — там обычно прямым текстом указано, на чём модуль споткнулся.
- 📨 Обратитесь в техподдержку ЕГАИС с ФСРАР ID, версией УТМ и фрагментом журнала. Если сбой на стороне 1С — к своему обслуживающему партнёру с текстом ошибки из 1С.
Обслуживание и обновление УТМ
Подключить ЕГАИС один раз недостаточно. У модуля есть регулярные задачи, и о большинстве узнают, только когда обмен встаёт.
Обновление версии
УТМ обновляется сам: за это отвечает отдельная служба обновления, ей нужен доступ в интернет. Если в организации прокси или жёсткий брандмауэр, автообновление может не пройти, и модуль останется на старой версии. Тогда:
- Скачайте свежий дистрибутив в личном кабинете ЕГАИС.
- Предупредите кассиров и кладовщиков: на время обновления обмен и продажа алкоголя через ЕГАИС остановятся.
- Остановите службы УТМ и выполните установку поверх. Токен должен быть вставлен.
- Откройте
http://localhost:8080и убедитесь, что номер версии изменился, а сертификаты на месте.
Не удаляйте каталог УТМ вручную, пока в /opt/out есть необработанные документы — сначала дайте 1С их забрать.
Регулярные проверки
| Что проверять | Как часто | Почему |
|---|---|---|
| Срок RSA- и ГОСТ-сертификатов на странице УТМ | Раз в месяц | Просрочка останавливает обмен целиком |
| Версию УТМ | После уведомлений ЕГАИС об обновлении | Старые версии отключают |
Очередь /opt/out | Раз в неделю | Растущая очередь — признак, что 1С не забирает документы |
| Место на диске с УТМ | Раз в квартал | Журналы и база модуля растут |
| Расхождение остатков 1С и ЕГАИС | Раз в месяц, повторным запросом остатков | Расхождения потом приходится закрывать актами |
Отдельно продумайте замену компьютера с УТМ. Новый ПК готовят заранее: ставят драйвер токена, переносят ключ, устанавливают модуль и только потом выключают старый. В 1С после переезда меняется лишь адрес УТМ, если поменялся IP.
Частые вопросы
Можно ли работать с ЕГАИС в 1С без УТМ?
Нужен ли УТМ, если я только продаю пиво?
Можно ли поставить УТМ на виртуальную машину или сервер?
Сколько стоит подключение?
Что будет, если поменять КПП или адрес магазина?
Источники
- Федеральный закон от 22.11.1995 № 171-ФЗ «О государственном регулировании производства и оборота этилового спирта, алкогольной и спиртосодержащей продукции»