ЕСМ и Frontol: настройка проверки маркировки через Mark Unit

Frontol работает с маркировкой через отдельный сервис — Frontol Mark Unit. Чтобы проверка шла через ТС ПИоТ, настроить нужно оба, и порядок здесь имеет значение.

Разберём цепочку целиком, включая переключатель, который по умолчанию выключен и из-за которого связка тихо не работает.

Минимальные версии

КомпонентВерсия
Драйвер ККТ АТОЛ (x32)10.10.8.24 или выше
Frontol6.28.0 или выше
Frontol Mark Unit4.4.5 или выше
ЕСМ и Контроллер ЛМ ЧЗ1.6 или выше

Обратите внимание на разрядность драйвера: для Frontol нужна 32-разрядная сборка. Разрядность драйвера определяется не только системой, но и разрядностью кассового ПО.

Плюс общие требования: касса на ФФД 1.2 и включённый признак «Торговля маркированными товарами».

Шаг 1. Переключатель в Mark Unit

С этого стоит начать, потому что дальше о нём легко забыть.

Установщик драйвера ККТ АТОЛ с отмеченным компонентом «Интеграционные компоненты для ЕСМ»
Для Frontol нужна 32-разрядная сборка драйвера и обязательно с этим компонентом

Откройте интерфейс Frontol Mark Unit: «Сервис» → «Настройки» → блок «Настройка подключения к ГИС МТ «Честный знак»».

Включите режим «Использовать ЕСМ». По умолчанию он выключен.

Пока переключатель снят, всё остальное можно настроить безупречно, и связка всё равно не заработает: Mark Unit будет ходить в систему маркировки мимо модуля. Внешне это выглядит как «настроили, но ТС ПИоТ не используется» — без ошибок и без объяснений.

Шаг 2. Настройка кассы в Frontol.Администратор

Запустите FrontolAdmin.exe либо откройте приложение кассира и выберите пункт «Настройка».

Путь: «Настройки» → «Системные» → «РМ и оборудование» → «Рабочие места» → «ККМ» → «Устройства». Выберите кассу, на которой будут регистрироваться маркированные товары.

Заполните:

  • Подключение — «Драйвер ККТ АТОЛ v.10»;
  • Адрес ЕСМ — IP компьютера, где установлен модуль. Если он там же, где Frontol и Mark Unit, оставьте 127.0.0.1;
  • Порт ЕСМ51401.

Затем нажмите «Свойства» и убедитесь, что порт GRPC драйвера равен 4041. Выполните проверку связи с кассой.

Два порта в одном экране — источник постоянной путаницы. 51401 — это порт, по которому Frontol обращается к API проверки кодов. 4041 — порт, по которому модуль обращается к драйверу. Значения не взаимозаменяемы.

Если при проверке появляется ошибка регистрации на сервере, убедитесь, что служба «ATOL: Fptr grpc service» работает. При необходимости запустите её вручную.

Сохраните настройки.

Шаг 3. Режим регистрации «Каждая позиция»

Обязательное условие, которое лежит не там, где его ищут.

«Настройки» → «Системные» → «РМ и оборудование» → «Рабочие места» → «ККМ» → «Регистрация в ККМ» → режим «Каждая позиция».

Другие режимы группируют позиции, а проверка кода маркировки выполняется для каждой единицы товара отдельно. Без этого режима связка работать корректно не будет.

Настроенную кассу не забудьте привязать к рабочему месту: «Настройки» → «Системные РМ и оборудование» → «Рабочие места».

Шаг 4. Подключение к Mark Unit

Путь: «Маркировка» → «Справочники ЕГАИС» → «Организации».

  • Режим работы с маркированной продукцией — обязательно «Онлайн-проверка в разрешительном режиме». Другие значения не дадут работать разрешительному режиму.
  • Веб-адрес Frontol Mark Unit — протокол http, порт 8000.
  • Автоматический вход в Frontol Mark Unit — поднимите флаг, чтобы данные кассы подтянулись сами. Иначе впишите логин и пароль пользователя Mark Unit с ролью «Касса»; она настраивается в самом Mark Unit.

Если Mark Unit на отдельном сервере

Схема меняется, и это неочевидная её часть.

Модуль ЕСМ устанавливается на тот компьютер, где стоит Frontol Mark Unit — не на кассовое место.

При этом в настройках ККМ в Frontol.Администратор поле «Адрес ЕСМ» должно содержать IP того компьютера, где установлен сам Frontol.

Узнать адрес: Win + R, команда cmd, затем ipconfig. Нужен IPv4-адрес используемого сетевого адаптера.

Если проверка падает с ошибкой сертификата

Сообщение про недоверие к сертификату безопасности лечится установкой файлов gismt и ca из папки %ProgramData%\ESP\ESM\um в доверенные корневые центры сертификации, с выбором хранилища «Локальный компьютер». Пошаговый порядок.

Сертификаты появляются в папке только после регистрации модуля.

Порядок проверки, если не заработало

Список выстроен по частоте, а не по порядку настройки:

  1. Включён ли режим «Использовать ЕСМ» в Mark Unit? Проверяется первым делом.
  2. Стоит ли режим «Каждая позиция» в настройках регистрации?
  3. Тот ли порт в поле «Порт ЕСМ» — 51401, а не 4041?
  4. Работает ли служба «ATOL: Fptr grpc service»?
  5. Та ли разрядность драйвера — для Frontol нужна 32-разрядная?
  6. Проходит ли проверка связи с кассой в свойствах драйвера?

Если дошли до конца и всё в порядке, смотрите код ошибки: разбор кодов ЕСМ объясняет, почему нумерация модуля не совпадает с драйверной.

Частые вопросы

Настроили всё, ошибок нет, но проверка не идёт. Классический признак выключенного режима «Использовать ЕСМ» в Mark Unit. Ошибок при этом действительно не будет.

Можно ли обойтись без Mark Unit? Нет, работа Frontol с маркировкой построена через него.

Почему для Frontol нужна 32-разрядная сборка драйвера? Разрядность драйвера должна соответствовать разрядности кассового ПО, а не только операционной системы.

Обновлять Frontol и модуль вместе? Драйвер — обязательно вместе с модулем, они выходят синхронно. Frontol обновляется по своему графику, но версия не должна опускаться ниже 6.28.0.

Где посмотреть логи, если ничего не помогает? Логи модуля выгружаются кнопкой «Сохранить логи» в его окне; пути к остальным собраны в статье про логи драйвера.

Коротко

Цепочка настраивается в четыре шага: включить «Использовать ЕСМ» в Mark Unit (по умолчанию выключен — это главная ловушка), задать в Frontol.Администратор подключение «Драйвер ККТ АТОЛ v.10» с портом ЕСМ 51401 и портом GRPC 4041, выставить режим регистрации «Каждая позиция», подключить Mark Unit по http на порту 8000 с режимом «Онлайн-проверка в разрешительном режиме». Версии: Frontol от 6.28.0, Mark Unit от 4.4.5, драйвер 32-разрядный от 10.10.8.24. Если Mark Unit на отдельном сервере, модуль ставится рядом с ним, а в адресе ЕСМ указывается IP машины с Frontol.


Материал носит информационный характер. Сайт atoldriver.ru не является представительством компании АТОЛ, АТОЛ Frontol или АО «ЕСП» и не оказывает услуг по обслуживанию оборудования.