Что такое локальный модуль Честного знака и для чего он нужен бизнесу

Локальный модуль Честного знака – это программный компонент, который устанавливается на сервер или рабочую станцию предприятия и обеспечивает взаимодействие внутренних учётных систем (например, 1С, SAP, «Парус») с государственной системой мониторинга товаров «Честный знак». В отличие от облачного API, локальный модуль работает в изолированной среде, что даёт бизнесу полный контроль над транзакциями, снижает задержки при большом потоке документооборота и исключает зависимость от внешних серверов оператора.

Для каких задач используется локальный модуль:

• Автоматическая отправка УПД (универсальных передаточных документов) в систему маркировки;
• Получение и подтверждение кодов маркировки (DataMatrix, КИЗ, КИТУ);
• Формирование заказов на эмиссию кодов для новых партий товара;
• Работа с отчётами о нанесении, выбытии и обороте маркированной продукции;
• Интеграция с ККТ для передачи фискальных данных с кодами маркировки.

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

Маркировка «Честный знак» обязательна для многих категорий товаров: табачная и никотиносодержащая продукция, обувь, лекарства, шубы, шины, фотоаппараты, молочная продукция, упакованная вода и другие. Настройка локального модуля – ключевой этап внедрения системы обязательной маркировки на предприятии.

Пошаговая инструкция: как установить и инициализировать локальный модуль Честного знака

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

Шаг 1. Проверка системных требований

Перед тем как установить локальный модуль, убедитесь, что ваш сервер или компьютер соответствует минимальным требованиям:

• Операционная система: Windows Server 2012/2016/2019/2022, Windows 10/11 Pro/Enterprise, Linux (CentOS 7, Ubuntu 18.04+);
• Процессор: 2 ядра, 2 ГГц;
• ОЗУ: от 4 ГБ (рекомендуется 8 ГБ для активного документооборота);
• Свободное место на диске: не менее 20 ГБ;
• Сетевое подключение: стабильный интернет с доступом к порталу «Честный знак» (честныйзнак.рф) и к серверам ФНС для ККТ;
• Установленный .NET Framework 4.7.2 или выше (для Windows) / Mono (для Linux);
• Учётная запись оператора с правами администратора.

Если вы планируете интегрировать модуль с 1С, потребуется версия платформы не ниже 8.3.10 и установленные расширения для работы с HTTP-сервисами.

Шаг 2. Загрузка дистрибутива с портала «Честный знак»

Дистрибутив локального модуля доступен в разделе «Интеграция» личного кабинета на портале ЧЗ. Для скачивания нужна активная учётная запись с ролью «Администратор» или «Технический специалист». Размер установщика – около 150 МБ. Обратите внимание, что существуют версии для Windows и Linux – выбирайте согласно вашей ОС.

Шаг 3. Установка локального модуля

Запустите установочный файл от имени администратора. Процесс установки типовой:

1. Примите лицензионное соглашение;
2. Укажите путь для установки (по умолчанию C:\Program Files\ChestnyZnak\LocalModule);
3. Выберите режим установки: «Сервер» (для многопользовательской работы) или «Клиент» (для одного рабочего места);
4. Настройте порт для входящих соединений (по умолчанию 8080, но можно изменить во избежание конфликтов);
5. Укажите учётную запись службы (рекомендуется создать отдельную локальную учётную запись с минимальными привилегиями).

После завершения установки запустите службу «LocalModuleService» через консоль управления службами или перезагрузите сервер.

Шаг 4. Инициализация и подключение к личному кабинету

Как инициализировать локальный модуль Честного знака? Это критически важный этап, на котором модуль связывается с вашим личным кабинетом. Для этого потребуется:

1. Открыть веб-интерфейс управления модулем по адресу http://localhost:8080 (или ваш сервер:порт).
2. Ввести логин и пароль от учётной записи на портале «Честный знак» с правами администратора организации.
3. Загрузить сертификат усиленной квалифицированной электронной подписи (УКЭП) в формате .p12 или .pfx. Важно: компания «Мой знак» рекомендует использовать машиночитаемую доверенность (МЧД) для работы без передачи ЭЦП – это безопасно и упрощает администрирование.
4. Нажать «Инициализировать». Модуль проверит доступ к серверам ЧЗ и скачает актуальные справочники (типы товаров, причины выбытия и т.п.).
5. После успешной инициализации в интерфейсе появится статус «Работает» и информация об организации.

Если инициализация не удалась, проверьте настройки брандмауэра (должны быть открыты порты 443, 80, 8443), правильность сертификата и доступность DNS-имени «честныйзнак.рф».

Шаг 5. Интеграция с учётной системой

После инициализации необходимо настроить взаимодействие модуля с 1С, ERP или другим ПО. Обычно это делается через HTTP-запросы к локальному модулю (REST API). Для 1С потребуется создать HTTP-сервис (внешняя обработка «ЧестныйЗнак.epf») или использовать типовые конфигурации. Параметры подключения:

• URL: http://имя_сервера:порт/api/v3
• Логин и пароль (или токен) из настроек модуля;
• Идентификатор организации (GUID).

Подробные схемы API описаны в документации на портале ЧЗ. Рекомендуется провести тестовый обмен – отправить один документ и проверить его статус в личном кабинете.

Как проверить локальный модуль Честного знака и решить типовые проблемы

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

Проверка статуса через веб-интерфейс

Войдите в панель управления модулем (http://localhost:8080). На главной странице отображается статус подключения к ЧЗ, версия модуля, дата последней инициализации. Если статус «Работает» и нет ошибок в журнале – модуль готов к использованию.

Тестовый запрос

Выполните тестовый запрос к API. Например, GET-запрос на http://localhost:8080/api/v3/organizations должен вернуть JSON со списком организаций. Если ответ приходит без ошибок – REST API функционирует.

Проверка логов

Локальный модуль ведёт детальные логи. По умолчанию они находятся в папке установки в подкаталоге Logs. Ищите записи уровня Error или Warning. Типичные ошибки:

• «Не удалось установить соединение с сервером ЧЗ» – проверьте интернет и DNS;
• «Ошибка аутентификации» – возможно, истёк сертификат или неверный пароль;
• «Сертификат не найден» – убедитесь, что сертификат загружен в хранилище личного кабинета ЧЗ.

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

«Честный знак» регулярно обновляет протоколы работы. Рекомендуется проверять наличие новой версии модуля раз в месяц и устанавливать её вручную или через автоматическое обновление (если включено). Своевременное обновление предотвращает ошибки при отправке документов.

Когда стоит обратиться к специалистам

Если после выполнения всех шагов модуль не запускается или вы не уверены в корректности настроек, рекомендуется обратиться к профессионалам. Компания «Мой знак» (my-sign.ru) специализируется на внедрении систем маркировки «Честный знак» от регистрации до полной интеграции. Мы поможем настроить локальный модуль Честного знака, решим проблемы с инициализацией и проверим его работу. С нами вы можете не передавать ЭЦП – используется машиночитаемая доверенность в вашем личном кабинете, что безопасно и удобно. Стоимость формирования DataMatrix кодов – от 0,2 ₽ за штуку, настройка касс под маркировку – от 3 000 ₽. Мы работаем официально, с договором и закрывающими документами, закрепляем персонального менеджера.

Вывод

Настройка локального модуля Честного знака – процесс, состоящий из нескольких этапов: от проверки системных требований до инициализации и интеграции. При правильном выполнении вы получаете стабильную систему, которая автоматизирует обмен данными с государственной маркировкой, экономит время и снижает риск ошибок. Если возникают сложности, всегда можно обратиться к сертифицированному партнёру – компании «Мой знак», которая оказывает полный цикл услуг по подключению к «Честному знаку».