Маркировка «Честный знак»: установка ЕСМ и адаптера HonestSign

Общие шаги для Shelter 2 (Pro) и Shelter Cloud: установка ТС ПИОТ (ЕСМ) и локального адаптера HonestSign на кассовое место. Настройка под конкретный продукт — в статьях Shelter 2 и Shelter Cloud.

Внутреннее устройство адаптера (эндпоинт, конфигурация, теги чека) — в статье Сервис HonestSign — проверка кодов маркировки.

Оглавление

Словарь

Как это устроено

Все компоненты ставятся на кассовый компьютер:

Сканер ─► Шелтер (Pro / Cloud)
            │ HTTP
            ▼
     адаптер HonestSign (localhost:1234)
            │ HTTPS
            ▼
     ЕСМ (localhost:51401) ─► ГИС МТ (онлайн-проверка)
            │
            ├──► ЛМ ЧЗ + Контроллер ЛМ ЧЗ (офлайн-проверка)
            │
            └──► агент ДККТ (драйвер ККТ) ─► фискальный регистратор

Шелтер напрямую ни в ЕСМ, ни в ГИС МТ не ходит — только через адаптер.

Что понадобится

• кассовый компьютер под Windows и права администратора на нём;
• архив дистрибутива ЕСМ — из личного кабинета АО «ЕСП»: lk.ao-esp.ru, вкладка ЕСМ (по ссылке открыт выбор ККТ АТОЛ под Windows — при другом вендоре ККТ выберите его на странице). Для скачивания нужен доступ к ЛК — он есть у пользователей ТС ПИОТ;
• ККТ, зарегистрированная на ФФД 1.2, с включённым признаком «Торговля маркированными товарами»;
• драйвер ККТ не ниже 10.10.8.23 (для АТОЛ);
• доступ в интернет до серверов ЦРПТ: ts-reg.crpt.ru:19100, cdnXX.crpt.ru:19101.

Для офлайн-продаж (когда интернета нет) дополнительно ставится ЛМ ЧЗ 2.0 с сайта «Честного знака»; в этом случае ЕСМ и Контроллер ЛМ ЧЗ должны быть не ниже версии 1.6.

Шаги ниже — по руководству АО «ЕСП» «ЕСМ + Атол (Win): Установка и настройка» v1.7 (для ККТ других вендоров у АО «ЕСП» есть аналогичные руководства).

Шаг 1. Установить драйвер ККТ (агент ДККТ)

1. Скачайте архив esmpack_windows_<версия>.zip из личного кабинета АО «ЕСП» (см. «Что понадобится») и распакуйте его.
2. В папке DKKT архива выберите инсталлятор драйвера нужной разрядности (под разрядность ОС или кассового ПО): файл вида KKT10-10.10.*.*-windows*-setup-signed.exe. Запустите: «Далее» → принять соглашение → папка по умолчанию → «Установить».
3. Компонент «Интеграционные компоненты для ЕСМ» обязателен — не снимайте галочку.
4. Ярлык ДККТ на рабочем столе — по желанию.

Шаг 2. Установить ЕСМ

1. Из того же архива запустите инсталлятор ЕСМ — файл вида esm_<версия>-windows-signed-setup.exe: «Далее» → принять соглашение → папка → выбор компонентов → «Установить».
2. Для офлайн-режима отметьте компонент «Контроллер ЛМ ЧЗ» (рекомендуется ставить вместе с ЕСМ).
3. Сам ЛМ ЧЗ (если нужен офлайн) скачивается отдельно с сайта «Честного знака» и ставится по их инструкции. Контроллер ЛМ ЧЗ должен стоять на том же компьютере, что и ЛМ ЧЗ.
4. В конце установки оставьте галочку «Запустить Единый Сервисный Модуль».

Шаг 3. Зарегистрировать ЕСМ и ККТ

1. Откройте «Тест драйвера ККТ» → вкладка «Свойства» → задайте «Порт сервера GRPC» 4041 → «Проверка связи». Закройте «Свойства», включите флаг «Включено» в правом верхнем углу теста драйвера.
2. Вкладка «Чек» → кнопка «Открыть смену». Тест драйвера не закрывайте и флаг «Включено» не снимайте.
3. В окне ЕСМ нажмите «Обновить список»: в блоке «Информация о кассе» появятся модель ККТ, заводской номер, номер ФН, РНМ, ИНН, смена.
4. Нажмите «Зарегистрировать» в блоке «ЕСМ»: ЕСМ запросит лицензию с серверов ЕСП и получит идентификатор регистрации экземпляра в ГИС МТ.
5. Дождитесь статусов (обновляются кнопкой «Обновить информацию»):
   • блок «ЕСМ», поле «Лицензия» — Активна до <дата>;
   • блок «ЛМ ЧЗ», поле «Статус» — Готов к работе;
   • блок «ГИС МТ», поле «Статус» — Стабильно.
6. Адрес ГИС МТ по умолчанию https://ts-reg.crpt.ru:19100 (кнопка «Настройки» внизу окна ЕСМ; менять не нужно).

Ошибки смотреть на вкладке «Уведомления» окна ЕСМ, логи — кнопка «Сохранить логи».

Шаг 4. Установить адаптер HonestSign

Shelter 2 (Pro): инсталлятор HonestSign-Setup-<версия>.exe с FTP ftp://ftp.shelter.ru/Shelter/Interfaces/HonestSign/ (self-contained — .NET ставить не нужно; нужны права администратора).

Shelter Cloud: адаптер отдельно не скачивается — он является плагином Шелтер Агента (ShelterNode) и ставится вместе с нодой. Одно кассовое рабочее место — одна касса.

В мастере установки (Pro) указать:

• порт адаптера — 1234, менять только если этот порт на кассовом компьютере уже занят другим приложением;
• адрес ЕСМ — https://localhost:51401, менять только если ЕСМ слушает другой порт.

Реквизиты ПМСР (client_info.id, client_info.token) зашиты в код адаптера — при установке не запрашиваются.

Инсталлятор кладёт файлы в C:\Program Files\HonestSign и регистрирует службу HonestSign с автозапуском. Тихая установка:

HonestSign-Setup-2.0.0.0.exe /Port=1234

Проверка после установки

1. Служба адаптера работает и слушает порт:

   sc query HonestSign                          -> RUNNING
   netstat -ano | findstr :1234                 -> LISTENING, PID от HonestSign.exe

2. Адаптер видит ЕСМ: в логе C:\Program Files\HonestSign\Logs\<дата>.log после старта службы — строка:

   Прогрев ЕСМ https://localhost:51401/api/v3/info за 155 мс, ответ получен: True

   ответ получен: False — ЕСМ не запущен или в адаптере указан не тот адрес (повторите шаги 2–3).

3. Дальше — настройка конкретного продукта:
   • Shelter 2 (Pro): база не ниже 161, shelter.exe + HonestSign.dll, сканер в [cardrider] — см. статью по Pro, раздел «Что установить на кассовое место»;
   • Shelter Cloud: hmsScaner и нода с плагином HonestSign (адаптер) — см. статью по Cloud.