Локальный модуль Честный ЗНАК для офлайн-проверок: полная инструкция по установке и настройке

Локальный модуль Честный ЗНАК - это программный компонент, без которого розничная точка без стабильного интернета просто не имеет права продавать маркированный товар легально. Не преувеличение: в апреле 2026 года требование обязательной офлайн-проверки кодов маркировки распространяется уже на десятки товарных групп, и штрафы за нарушения измеряются сотнями тысяч рублей.

Разберём всё по порядку - от понимания, нужен ли вам этот модуль вообще, до тонкостей обновления без потери данных. Никакой воды: только рабочая схема для кассира, айтишника и владельца магазина одновременно.

Когда локальный модуль становится обязательным, а не опциональным

Есть распространённое заблуждение: «у нас интернет нормальный, нам это не нужно». Ошибка. Обязательность локального модуля определяется не качеством соединения, а требованиями законодательства для конкретных товарных групп и типов торговых точек.

Локальный модуль обязателен в следующих случаях:

Ситуация	Основание	С какой даты
Торговля в зоне нестабильного или отсутствующего интернета	Постановление Правительства РФ № 2463 (ред. 2024–2025)	Зависит от товарной группы
Продажа лекарственных препаратов	ФЗ № 61-ФЗ + требования МДЛП	С 2020 года
Продажа табака, сигарет, никотинсодержащей продукции	Приказ Минпромторга № 1956	С 2021 года
Молочная продукция (розница)	Постановление Правительства № 850	С сентября 2021 года
Обувь, лёгкая промышленность, шины	Отдельные ПП РФ по каждой группе	С 2021–2022 года
Пиво и слабоалкогольные напитки	ПП РФ № 1723 (ред. 2024)	С 2023–2024 года
Антисептики, БАД, медизделия	Расширение системы ЧЗ в 2024–2026	С 2024–2026 года

Практика показывает: проверяющие Роспотребнадзора и налоговые инспекторы в 2025–2026 годах стали фиксировать не только отсутствие маркировки на товаре, но и отсутствие корректно настроенного модуля проверки на кассе. Это отдельное основание для штрафа.

Чем локальный модуль отличается от онлайн-проверки через API

При онлайн-проверке касса в момент продажи отправляет запрос на сервер ГИС МТ (Честный ЗНАК) и получает ответ - валиден ли код. При потере соединения - продажа зависает или проходит без проверки (что уже нарушение). Локальный модуль хранит актуальную базу кодов прямо на устройстве или локальном сервере и отвечает мгновенно, без интернета.

Это принципиально разные архитектуры. Локальная база синхронизируется с ГИС МТ по расписанию (когда интернет есть), а в момент продажи работает автономно.

Где скачать официальный локальный модуль Честный ЗНАК

Никаких сторонних источников - только официальный портал оператора системы маркировки. Скачивание из неофициальных источников грозит не только некорректной работой, но и потенциальной утечкой данных о движении товара.

Официальный источник загрузки: честныйзнак.рф → раздел «Участникам» → «Документы и ПО» → «Локальный модуль проверки».

По состоянию на апрель 2026 года ЦРПТ (оператор системы) предоставляет следующие варианты локального модуля:

• LM для Windows - установочный пакет .msi, подходит для большинства кассовых систем на базе Windows 10/11
• LM для Linux - .deb и .rpm пакеты, актуально для касс на Ubuntu, Astra Linux, Alt Linux
• LM в виде Docker-контейнера - для интеграции в серверную инфраструктуру торговой сети
• Встроенный модуль в кассовом ПО - часть производителей ККТ (АТОЛ, Эвотор, МТС Касса) встраивают LM в своё ПО; в этом случае отдельная установка не требуется

Перед скачиванием - авторизация в личном кабинете ГИС МТ обязательна. Модуль привязывается к ИНН участника оборота.

Системные требования: что должно быть на машине до установки

Параметр	Минимум	Рекомендуется
ОС	Windows 10 / Ubuntu 20.04	Windows 11 / Ubuntu 22.04 / Astra Linux 1.7
RAM	2 ГБ	4 ГБ и выше
Место на диске	5 ГБ (для малой товарной группы)	20–50 ГБ (для полной базы)
Процессор	2 ядра, 1.8 ГГц	4 ядра, 2.5 ГГц
Интернет для синхронизации	1 Мбит/с	10 Мбит/с и выше
Java	JRE 11	JRE 17 (LTS)

Важный нюанс: для аптек и торговых сетей с большим ассортиментом лекарств или молочки объём локальной базы может достигать 30–60 ГБ. Это нужно учитывать при выборе оборудования заранее, а не после установки.

Пошаговая установка локального модуля на Windows

Разберём самый распространённый сценарий - касса на Windows 10/11, кассовое ПО типа 1С:Розница, ДАЛИОН, Frontol или встроенное ПО терминала. Процесс идентичен для большинства систем.

Шаг 1 - Подготовка: отключить антивирус и проверить порты

На этапе установки антивирусное ПО (особенно Kaspersky Endpoint Security и Dr.Web) блокирует создание служб и запись в системные директории. Временно отключите защиту или добавьте папку установки в исключения.

Локальный модуль по умолчанию использует порты 8080 (HTTP) и 8443 (HTTPS). Если эти порты заняты другим ПО - нужно изменить их в конфигурационном файле до первого запуска. Проверить занятость портов: netstat -ano | findstr :8080 в командной строке.

Шаг 2 - Запуск установщика и базовая конфигурация

• Запустите скачанный .msi файл от имени администратора
• Выберите директорию установки (рекомендуется не системный диск C:, а отдельный раздел)
• Укажите путь для хранения локальной базы - это критично для производительности
• Установите модуль как системную службу Windows (галочка в мастере установки) - это обеспечит автозапуск
• Завершите установку и не запускайте модуль вручную до настройки конфигурации

Шаг 3 - Конфигурационный файл: что менять обязательно

Файл конфигурации находится по пути установки, называется application.properties или config.yml (зависит от версии модуля). Ключевые параметры:

Параметр	Что указывать	Пример
server.port	Порт HTTP-сервера модуля	8080
inn	ИНН участника оборота	7701234567
token / api-key	Токен из личного кабинета ГИС МТ	Выдаётся в ЛК
db.path	Путь к локальной базе данных	D:/lm-data/
sync.schedule	Расписание синхронизации с ГИС МТ	0 3 * * * (в 3:00 каждую ночь)
product.group	Товарная группа для загрузки базы	milk, shoes, tobacco и др.

Токен API - самое частое место ошибки. Он генерируется в личном кабинете ГИС МТ в разделе «Профиль» → «API». Срок действия токена - 1 год, после чего требуется перевыпуск и обновление конфигурации. Напомните себе об этом заранее.

Шаг 4 - Первый запуск и начальная синхронизация базы

После настройки конфигурации - запустите службу через services.msc или командой net start lm-crpt. Откройте браузер и перейдите на http://localhost:8080 - должна появиться административная панель модуля.

Первая синхронизация занимает от 30 минут до нескольких часов в зависимости от товарной группы и скорости соединения. Не прерывайте процесс. Статус синхронизации отображается в веб-интерфейсе панели управления.

Подключение локального модуля к кассе: три рабочих схемы

Это место, где большинство ошибаются - пытаются найти «кнопку подключить» в интерфейсе кассы. Кнопки нет. Интеграция происходит через API-запросы от кассового ПО к локальному модулю.

Схема 1 - Модуль на той же машине, что и касса

Самый простой вариант для одиночной кассы. Кассовое ПО отправляет HTTP-запрос на http://127.0.0.1:8080/api/v3/true-api/codes/check (адрес локального модуля на той же машине). Ответ приходит за миллисекунды.

В настройках кассового ПО (1С, Frontol, ДАЛИОН) нужно указать адрес сервера проверки маркировки как localhost:8080 или 127.0.0.1:8080. Точное расположение настройки - в разделе «Маркировка» или «Оборудование» вашего кассового ПО.

Схема 2 - Модуль на выделенном сервере (для нескольких касс)

Оптимальная архитектура для магазина с 2+ кассами. Устанавливается один экземпляр модуля на сервер, все кассы обращаются к нему по локальной сети. Адрес вместо localhost - IP-адрес сервера в локальной сети, например 192.168.1.100:8080.

Преимущество: одна точка обновления, одна точка синхронизации с ГИС МТ. Риск: если сервер упал - все кассы теряют проверку одновременно. Нужен UPS и мониторинг доступности.

Схема 3 - Встроенный модуль в кассовом ПО производителя

Ряд производителей - АТОЛ, Эвотор, МТС Касса, Лайтбокс - уже интегрировали локальный модуль в своё кассовое ПО. В этом случае «подключение» - это активация функции в настройках кассы и привязка к личному кабинету ГИС МТ.

Проверьте документацию своего кассового ПО. Если поддержка есть - используйте встроенное решение: оно обновляется вместе с кассовым ПО автоматически и не требует отдельного администрирования.

Как правильно настроить расписание синхронизации

Синхронизация - не разовая операция. База кодов маркировки обновляется постоянно: коды вводятся в оборот, выводятся, перемещаются между участниками. Если ваша локальная база устаревает - вы начинаете блокировать валидные коды или пропускать невалидные.

Рекомендации по расписанию синхронизации:

• Ежедневная ночная синхронизация - базовый минимум, достаточен для большинства розничных точек
• Каждые 4–6 часов - для аптек и активно торгующих алкоголем точек, где оборот кодов высокий
• Каждый час - для крупных распределительных центров и оптовых складов (только при стабильном интернете)

Синхронизацию лучше ставить в ночные часы (2:00–5:00) - меньше нагрузка на канал, нет конфликтов с кассовыми операциями, сервер ГИС МТ менее загружен.

Что делать, если синхронизация зависла или завершилась с ошибкой

Типичные ошибки синхронизации и способы их устранения:

Ошибка	Причина	Решение
401 Unauthorized	Истёк токен API	Перевыпустить токен в ЛК ГИС МТ, обновить config
Connection timeout	Нет доступа к серверам ЧЗ	Проверить файрвол, разрешить домены *.crpt.ru, *.честныйзнак.рф
Disk full / IOException	Нет места на диске	Освободить место, перенести БД на другой раздел
Sync conflict	Прерванная предыдущая синхронизация	Удалить файл .lock в папке данных, перезапустить службу
Wrong product group	Неверно указана товарная группа в конфиге	Исправить параметр product.group, очистить базу, запустить заново

Логи синхронизации хранятся в папке /logs внутри директории модуля. Файл sync.log - первое место, куда смотреть при любой проблеме. Уровень детализации логов можно повысить в конфиге: параметр logging.level=DEBUG.

Обновление локального модуля: что нельзя делать «по-быстрому»

ЦРПТ периодически выпускает обновления локального модуля - в среднем раз в квартал, иногда чаще при критических изменениях в протоколе ГИС МТ. Работа на устаревшей версии чревата:

• Несовместимостью с обновлённым API ГИС МТ (коды перестают проверяться)
• Уязвимостями безопасности
• Ошибками в ответах (ложные негативы - блокировка валидных кодов)
• Отсутствием поддержки новых товарных групп

Правильный порядок обновления (без потери данных)

• 1. Резервное копирование конфигурации. Скопируйте application.properties / config.yml в безопасное место. Новый инсталлятор может перезаписать файл конфигурации по умолчанию.
• 2. Остановите службу модуля через services.msc или командой net stop lm-crpt перед установкой обновления.
• 3. Не удаляйте папку с данными базы. Папка БД (указана в параметре db.path) содержит закачанные коды. Если её удалить - придётся делать полную синхронизацию заново.
• 4. Запустите новый установщик в ту же директорию. Он обновит исполняемые файлы и библиотеки, не трогая данные.
• 5. Проверьте конфигурацию. Восстановите параметры из резервной копии, если установщик перезаписал config.
• 6. Запустите службу и проверьте веб-интерфейс. Убедитесь, что версия изменилась, синхронизация работает, тестовая проверка кода возвращает корректный ответ.

Как следить за выходом новых версий

Официальных push-уведомлений об обновлениях нет. Три рабочих способа не пропустить релиз:

• Подписка на новости раздела «Документы и ПО» на портале честныйзнак.рф
• Подписка на Telegram-канал ЦРПТ (официальный)
• Периодическая сверка версии в веб-интерфейсе модуля с версией на портале (раз в месяц)

Тестирование после установки: как убедиться, что всё работает

Установка завершена - это не значит, что всё готово к работе. Без тестирования вы не знаете, корректно ли отвечает модуль, правильно ли кассовое ПО интерпретирует ответы, нет ли конфликтов в логике проверки.

Базовый чек-лист проверки работоспособности:

• ✅ Веб-интерфейс открывается на localhost:8080
• ✅ Статус синхронизации - «Активна», дата последней синхронизации актуальна
• ✅ Тестовый запрос через API возвращает корректный JSON-ответ
• ✅ Кассовое ПО не выдаёт ошибку подключения к серверу проверки
• ✅ Сканирование заведомо валидного кода маркировки - успешная продажа
• ✅ Сканирование недействительного/несуществующего кода - блокировка продажи
• ✅ Отключение интернета на машине не прерывает проверку кодов (ключевое!)

Последний пункт - самый важный тест. Именно для него и устанавливается локальный модуль. Отключите интернет, попробуйте пробить маркированный товар - должно пройти без ошибок.

Частые ошибки при работе с локальным модулем - и как их избежать

«Поставили модуль, но касса всё равно лезет в интернет»

Это значит, что в кассовом ПО не переключён режим проверки с «онлайн через API ГИС МТ» на «локальный модуль». В настройках кассы должен быть явно указан адрес локального сервера. Проверьте раздел «Маркировка» → «Настройки сервера проверки».

«Модуль установлен, но не видит нашу товарную группу»

Каждая товарная группа (молоко, обувь, табак, лекарства) требует отдельной настройки и загрузки соответствующей базы. В параметре product.group конфигурационного файла нужно указать нужные группы. Если вы торгуете несколькими группами - перечислите все через запятую.

«База загрузилась, но коды не находятся»

Возможные причины: код действительно невалиден (нормальная ситуация), база загружена не полностью (смотреть процент покрытия в веб-интерфейсе), товарная группа кода не совпадает с загруженной базой, или код ещё не введён в оборот поставщиком.

«После обновления Windows модуль перестал запускаться»

Обновления Windows могут изменить конфигурацию Java Runtime или сбросить права на папку данных. Проверьте: запускается ли служба вручную, есть ли права на запись в папку БД у учётной записи службы, не изменился ли путь к Java после обновления.

FAQ - Частые вопросы о локальном модуле Честный ЗНАК

Нужен ли локальный модуль, если у нас постоянный интернет?

Зависит от товарной группы и требований законодательства. Для ряда групп (лекарства, табак) локальный модуль или эквивалентное решение обязательны вне зависимости от наличия интернета - это требование нормативных актов, а не техническая необходимость. Для других групп при стабильном интернете допускается онлайн-проверка через API ГИС МТ. Уточните требования для вашей товарной группы в актуальной редакции соответствующего постановления Правительства РФ.

Сколько стоит локальный модуль Честный ЗНАК?

Сам программный модуль от ЦРПТ предоставляется участникам оборота бесплатно - скачивается на официальном портале после авторизации. Платными могут быть: услуги по установке и настройке, кассовое ПО с встроенной поддержкой локального модуля, серверное оборудование при выделенной схеме.

Можно ли установить модуль на одну машину для нескольких магазинов?

Технически - нет, если магазины находятся в разных локальных сетях. Локальный модуль обслуживает кассы, имеющие к нему сетевой доступ. Для каждой изолированной торговой точки - свой экземпляр модуля. Если магазины объединены в VPN или единую сеть - возможна централизованная установка, но это требует проектирования сетевой инфраструктуры.

Как часто нужно обновлять локальный модуль?

ЦРПТ рекомендует обновляться при каждом новом релизе. Критические обновления, связанные со сменой версии API или протоколов безопасности, обязательны - работа на устаревшей версии после официального уведомления о переходе может привести к прекращению синхронизации. Ориентировочная частота релизов - 3–4 раза в год.

Что происходит с продажами, если синхронизация давно не проводилась?

Локальная база устаревает. Коды, введённые в оборот после последней синхронизации, не будут найдены в базе - модуль вернёт ошибку «код не найден». В зависимости от настроек кассового ПО это либо заблокирует продажу, либо продажа пройдёт без проверки (что является нарушением). Регулярная синхронизация - обязательное условие корректной работы.

Подходит ли один модуль для всех товарных групп сразу?

Один экземпляр модуля может обслуживать несколько товарных групп одновременно, если это указано в конфигурации. Но объём базы данных будет пропорционально больше. Например, одновременная загрузка баз для молока, обуви и табака потребует значительно больше места на диске и дольше синхронизируется. Оцените ресурсы заранее.

Что будет, если продать товар без проверки через локальный модуль?

Продажа маркированного товара без корректной проверки кода - нарушение законодательства. По статье 15.12 КоАП РФ штрафы для организаций составляют от 50 000 до 300 000 рублей. Кроме штрафа возможно изъятие товара. В 2025–2026 году практика проверок значительно ужесточилась - контрольные закупки с проверкой корректности маркировки стали стандартной практикой Роспотребнадзора.

Работает ли локальный модуль с кассами АТОЛ, Эвотор, МТС Касса?

Да. АТОЛ, Эвотор и МТС Касса поддерживают работу с локальным модулем ЦРПТ - как через встроенную интеграцию (у ряда моделей), так и через настройку адреса внешнего сервера проверки. Проверьте актуальную документацию вашей модели кассы и версии прошивки, так как поддержка добавлялась поэтапно.

Можно ли использовать локальный модуль без регистрации в системе Честный ЗНАК?

Нет. Модуль требует авторизации через личный кабинет ГИС МТ и привязки к ИНН участника оборота. Без регистрации в системе невозможно получить API-токен, который необходим для работы и синхронизации модуля. Регистрация в ГИС МТ обязательна для всех участников оборота маркированных товаров.

Нужно ли уведомлять налоговую или ЦРПТ об установке локального модуля?

Специального уведомления об установке локального модуля не требуется - он является частью технической инфраструктуры участника оборота. Однако сам факт торговли маркированными товарами требует регистрации в ГИС МТ и отражения операций в системе. Факт использования локального модуля фиксируется автоматически при синхронизации с серверами ЦРПТ.

Как проверить, что локальный модуль действительно работает в офлайн-режиме?

Самый простой способ: дождитесь завершения синхронизации, физически отключите интернет-кабель (или отключите Wi-Fi), попробуйте провести продажу маркированного товара через кассу. Если код проверился и продажа прошла - модуль работает корректно в офлайн-режиме. Если появилась ошибка - значит касса всё ещё пытается обратиться к удалённому API, а не к локальному модулю. Ищите проблему в настройках кассового ПО.

Главное правило при работе с локальным модулем

Локальный модуль - не разовая установка, а живой компонент инфраструктуры. Он требует регулярных обновлений, мониторинга синхронизации и периодического тестирования. Один раз настроить и забыть - значит рано или поздно столкнуться с ситуацией, когда касса блокирует продажи или пропускает невалидные коды.

Выстройте простой регламент: ответственный сотрудник раз в неделю проверяет статус синхронизации в веб-интерфейсе, раз в месяц сверяет версию модуля с актуальной на портале ЧЗ. Этого достаточно, чтобы система работала стабильно без сюрпризов во время налоговой проверки.

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