Инструкция описывает взаимодействие ПМСР ClubIS с ТС ПИоТ (программный комплекс ЕСП — единая сервисная платформа) при продаже маркированного товара.
Установка, обновление и настройка модуля ЕСМ (ТС ПИоТ) выполняются по документации Единой сервисной платформы (ЕСП) — официального поставщика ТС ПИоТ (личный кабинет, загрузка ПО и инструкции). Модуль ставится на каждом кассовом компьютере отдельно от обновления ClubIS.
—
¶ Архитектура взаимодействия
- ClubIS — модули Администратор, Рецепция, Менеджер.
- ТС ПИоТ (ЕСП) — служба на том же кассовом компьютере; ClubIS отправляет сюда запросы проверки кодов маркировки.
- ЕСМ и локальный модуль «Честный знак» настраиваются со стороны ЕСП; ClubIS к ним напрямую не подключается — только через ТС ПИоТ на кассе.
¶ Минимальные требования
¶ Версия ПМСР (ClubIS)
- Версия ClubIS не ниже
3.208.26099. - Программа и база данных обновлены; в настройках «Честный знак» доступен провайдер «ЕСП (Единая сервисная платформа)».
- Для работы на кассе: модуль «Рецепция»; для общих настроек — «Администратор»; для возврата пробитых позиций — «Менеджер».
¶ ТС ПИоТ (ЕСП)
- ЕСП установлен и запущен на каждом рабочем месте, с которого выполняется проверка маркировки.
- По умолчанию адрес ЕСП на кассовом ПК:
https://127.0.0.1:51401. В штатной схеме ЕСП работает на этом же компьютере, что и «Рецепция» (не на сервере базы данных). - ЕСП установлен по инструкции поставщика ТС ПИоТ.
- Актуальная версия модуля проверки (АО «ЕСП»): не ниже 1.6.3.2. В этой сборке доработано взаимодействие компонентов кассового узла и повышена стабильность. Если установлена более ранняя версия — обновите модуль по инструкции поставщика.
¶ Оборудование на кассе (ККТ)
- Считыватель штрих-/DataMatrix-кодов или ручной ввод CIS / DataMatrix в чеке.
- ККТ: любая модель АТОЛ из перечня, сертифицированного для работы с ПИоТ (конкретную модель выбирают на площадке).
- ОС ККТ (прошивка): не ниже 5.17.0 (рекомендуется 5.17.10 и выше).
- Драйвер ККТ (ДТО 10): не ниже 10.10.8.23, установка строго 32-битная (даже на 64-битной ОС Windows). При работе с ЕСМ устанавливайте драйвер из дистрибутива ЕСМ (см. Рекомендации ЕСМ).
- Касса подключена к ПМСР (ClubIS). Для канала ЕСМ нужна открытая смена на ККТ: её открывают вручную (Рецепция → операции с кассой) или ClubIS открывает её сам перед первой проверкой марки, если смена ещё закрыта (на кассе может напечататься служебный документ об открытии смены). Обычный чек без маркировки смена может открыться и при пробитии — для маркировки этого недостаточно: канал ЕСМ готовится только при уже открытой смене.
- Драйвер ККТ должен быть доступен ЕСМ для канала проверки марки. В ClubIS это обеспечивается так:
- опция «Держать драйвер в памяти до выхода из программы» — драйвер поднимается при запуске Рецепции / Менеджера и остаётся активным до выхода из модуля; или
- без этой опции ClubIS сам кратко поднимает драйвер при проверке марки и при пробитии чека с маркировкой, открывает смену при необходимости, ждёт готовности ТС ПИоТ и после операции отпускает драйвер (удобно, если одной ККТ пользуются несколько рабочих мест). Подробнее — Работа с ККТ.
¶ Архитектура развёртывания
| Компонент | Где работает |
|---|---|
| ClubIS (ПМСР) | Сервер БД + рабочие места (клиентские модули) |
| ТС ПИоТ (ЕСП) | Локально на каждом кассовом ПК (не на сервере БД) |
| База данных ClubIS | Сервер площадки |
—
¶ Рекомендации ЕСМ для стабильной работы кассы
Рекомендации поставщика ЕСМ для работы ПМСР с кассовым узлом. Соблюдение правил снижает сбои в течение смены и обращения в поддержку.
¶ 1. Драйвер ККТ — из дистрибутива ЕСМ
Для работы с кассой устанавливайте драйвер ККТ из дистрибутива ЕСМ (актуальный комплект — в личном кабинете партнёра поставщика ЕСМ / ЕСП).
Сторонние версии драйвера могут нарушить взаимодействие с ЕСМ. При обновлении ЕСМ драйвер обычно обновляется вместе с ним — используйте комплект из последнего дистрибутива.
Минимальные версии для сертифицированных моделей АТОЛ (прошивка, 32-bit ДТО 10) см. в разделе Оборудование на кассе (ККТ) выше; источник установки при работе через ЕСМ — дистрибутив ЕСМ, а не произвольная сборка с сайта производителя кассы.
¶ 2. Не останавливайте драйвер ККТ во время смены
Экземпляр драйвера должен быть запущен до формирования первого фискального документа и оставаться активным до закрытия смены.
Если остановить драйвер в середине смены, защищённое соединение с кассой разорвётся — для продолжения работы связь между компонентами нужно устанавливать заново.
В ClubIS для одного основного рабочего места с этой ККТ включайте постоянный режим («Держать драйвер в памяти до выхода из программы») — см. Работа с ККТ. Не закрывайте вручную утилиты драйвера и не «выгружайте» драйвер, пока смена на кассе открыта.
¶ 3. Проверяйте коды маркировки по очереди
Не отправляйте запросы в ТС ПИоТ и ОИСМ одновременно. При параллельной проверке ответ ОИСМ может прийти уже после фискализации.
Рекомендуемый порядок:
- проверка кода через ТС ПИоТ;
- после получения ответа — проверка в ОИСМ.
Проверка через ТС ПИоТ обычно быстрее, поэтому такой порядок ускоряет сценарий. Обратная последовательность допустима, но проверки в любом случае должны идти последовательно, не параллельно.
В штатной схеме ClubIS обращается к ЕСП (ТС ПИоТ); дальнейшие проверки со стороны ЕСМ выполняет платформа. Не дублируйте проверку кода сторонними утилитами параллельно с продажей в «Рецепции».
¶ 4. Контроллер ЛМ ЧЗ — на одном компьютере с локальным модулем
Контроллер ЛМ ЧЗ входит в дистрибутив ЕСМ и должен быть установлен на том же компьютере или сервере, где работает локальный модуль «Честный знак».
Размещение контроллера на другом устройстве не поддерживается. После обновления убедитесь, что на компьютере с ЛМ ЧЗ не осталось одновременно запущенных контроллеров от предыдущих версий.
—
¶ Что обновлять и как
¶ ClubIS (ПМСР)
- Обновление — по инструкции Обновление для Windows.
- После обновления: версия не ниже
3.208.26099, в настройках «Честный знак» есть провайдер «ЕСП». - Файлы конфигурации ЕСП вручную в каталог ClubIS не копируются.
¶ ТС ПИоТ (ЕСП)
- Устанавливается и обновляется отдельно по инструкции разработчика ТС ПИоТ на каждом кассовом компьютере.
- ClubIS не обновляет ЕСП; при смене версии ЕСП следуйте документации поставщика ТС ПИоТ.
- Рекомендуемая версия модуля: 1.6.3.2 и новее (АО «ЕСП»).
¶ Локальные переопределения на кассе
- При включении «Изменить локально провайдера…» в «Рецепции» параметры (в т.ч. адрес ЕСП) сохраняются в локальных настройках этого ПК, а не в общей БД.
—
¶ Настройка интеграции с ЕСМ в ПМСР
Под «настройкой до ЕСМ» в ClubIS понимается указание адреса ЕСП (ТС ПИоТ) на кассовом месте. ПМСР обращается к ЕСП; связь ЕСП с ЕСМ выполняется внутри ТС ПИоТ.
¶ Какие IP и порт указывать
| Параметр | Значение по умолчанию | Где задаётся |
|---|---|---|
| Протокол | HTTPS | В строке адреса целиком |
| IP | 127.0.0.1 | Только localhost — ЕСП на этом же ПК, что и «Рецепция» |
| Порт | 51401 | В строке адреса |
| Полный адрес | https://127.0.0.1:51401 |
См. ниже |
Важно: для каждой кассы запросы уходят на локальный ЕСП этой машины (127.0.0.1), а не на IP сервера ClubIS. Указание IP другого компьютера имеет смысл только при отдельной схеме развёртывания ЕСП и локальном переопределении в «Рецепции».
¶ 1. Общие настройки (модуль «Администратор»)
- Откройте модуль «Администратор».
- Раздел «Интеграции» → вкладка «Честный знак».
- Включите «Включить Честный знак».
- Для каждого юридического лица выберите провайдера «ЕСП (Единая сервисная платформа)».
- Адрес ЕСП в администраторе отображается как
https://127.0.0.1:51401(редактирование в этом модуле отключено — используется локальный ЕСП на каждой кассе). - Нажмите «Сохранить».
После сохранения настройки действуют для всех рабочих мест, если на кассе не включено локальное переопределение.
Токен старого API. Для провайдера «ЕСП» токен старого API не нужен, опция «Не добавлять маркированный товар в чек…» на кассе не действует. Если у всех юр. лиц выбран ЕСП, галка в Администратор → Интеграции → Честный знак скрывается и снимается. Если осталось юр. лицо со «Старое API», галка видна, но для ЕСП не используется.
¶ 2. Локальное переопределение на конкретной кассе («Рецепция»)
Если на одном ПК нужен другой адрес ЕСП (тесты, нестандартная схема):
- «Рецепция» → «Настройки» → «Основное» → «Честный знак».
- Включите «Изменить локально провайдера Честного знака» (в «Администраторе» этот флажок недоступен).
- Выберите провайдера «ЕСП» и при необходимости измените поле HTTP(s) адрес ЕСП с портом (формат:
https://хост:порт, напримерhttps://127.0.0.1:51401). - «Сохранить».
—
¶ Проверка настройки работы ПМСР с ЕСМ (через ЕСП)
¶ 1. Проверка доступности ЕСП
На кассовом ПК, где установлена «Рецепция» и ЕСП, убедитесь, что служба ТС ПИоТ (ЕСП) запущена.
¶ 2. Запрос сведений из ClubIS
- «Администратор» → «Интеграции» → «Честный знак».
- Для юридического лица с провайдером ЕСП нажмите «Запросить информацию о ККТ».
- В ответе должны отобразиться, в частности:
- идентификатор ТС ПИоТ;
- заводской номер ККТ, заводской номер ФН, ИНН ККТ;
- при наличии — данные локального модуля «Честный знак» (версия, статус, адрес ЛМ).
При ошибке связи проверьте запуск ЕСП и адресhttps://127.0.0.1:51401на этом же компьютере.
¶ 3. Проверка в продаже (сценарий тестирования)
- «Рецепция» → тестовый клиент → «Чек».
- Отсканируйте или введите тестовый код маркировки.
- Убедитесь, что позиция добавлена в чек без ошибки проверки.
¶ 4. Проверка в личном кабинете ЕСП
После нескольких продаж с маркировкой откройте личный кабинет ЕСП → раздел «Кассы» → нужная касса.
В карточке кассы, в блоке «Единый Сервисный Модуль (ТС ПИоТ)» → «Проверено марок за 24 часа», счётчик «Онлайн в ГИС МТ» должен увеличиваться — так видно, что проверки кодов уходят через ТС ПИоТ в онлайн-режим ГИС МТ.
—
¶ Работа с ККТ
В рамках интеграции с ТС ПИоТ ClubIS использует фискальный регистратор АТОЛ, подключённый через драйвер ДТО 10 (32-bit) и выбранный в модуле Рецепция. Сведения о ККТ (заводской номер ККТ, заводской номер ФН, ИНН) ПМСР получает через ЕСП (кнопка «Запросить информацию о ККТ» в Администраторе), а не запросом напрямую к драйверу при проверке маркировки.
Для корректной работы ЕСМ с ККТ:
- касса подключена к ПМСР, драйвер ККТ доступен ЕСМ в момент проверки марки и пробития чека с маркировкой;
- смена на ККТ открыта. Если смена закрыта, ClubIS при первой проверке марки (скан / добавление в чек) или перед пробитием маркированного чека открывает смену, затем ждёт готовности канала ТС ПИоТ (до нескольких секунд) и только после этого проверяет марку или бьёт чек. Так работает и постоянный, и временный режим драйвера;
- по рекомендации ЕСМ драйвер не останавливают до закрытия смены (см. Рекомендации ЕСМ).
Два режима работы с драйвером (АТОЛ и Штрих-М):
| Режим | Как включить | Когда удобен |
|---|---|---|
| Постоянный | В свойствах ФР — «Держать драйвер в памяти до выхода из программы», затем перезапуск модуля | Одно основное рабочее место с этой ККТ; соединение с кассой держится до выхода из модуля |
| Временный | Опцию не включать | Несколько Рецепций / Менеджеров или ПК делят одну ККТ. ClubIS сам поднимает драйвер на время проверки марки и пробития маркированного чека и отпускает его после операции |
Перед проверкой марки и пробитием маркированного чека возможна короткая пауза: ClubIS при необходимости открывает смену и дожидается, пока ТС ПИоТ установит канал с ККТ.
¶ Требования к ККТ (для отчёта и эксплуатации)
| Параметр | Значение |
|---|---|
| Производитель / линейка | АТОЛ, модель из списка сертифицированных для работы с ПИоТ |
| Прошивка (ОС ККТ) | ≥ 5.17.0 (рекомендуется ≥ 5.17.10) |
| Драйвер | ДТО 10, версия ≥ 10.10.8.23, только 32-bit |
Перед испытаниями проверьте версии прошивки и драйвера в утилитах АТОЛ; при несоответствии обновите по регламенту производителя ККТ.
¶ Настройка ККТ в ClubIS
- Рецепция → Настройки → Оборудование → Фискальные регистраторы.
- Откройте нужное юридическое лицо.
- На вкладке Основное выберите подключённый фискальный регистратор АТОЛ (через ДТО 10).
- На вкладке Дополнительно выберите режим драйвера (для АТОЛ и Штрих-М):
- постоянный — включите «Держать драйвер в памяти до выхода из программы», сохраните и перезапустите Рецепцию (или Менеджер);
- временный — оставьте опцию выключенной, если одной ККТ пользуются несколько рабочих мест. ClubIS поднимет драйвер сам при проверке марки и пробитии маркированного чека.
- Сохраните настройки. При постоянном режиме после перезапуска модуля внизу окна в строке состояния должна быть активная иконка кассы — драйвер подключён и держится в памяти. Если иконка серая — проверьте связь с ККТ и опцию выше. При временном режиме иконка может быть серой между операциями — это нормально.
Подробнее об остальных полях свойств ФР: Локальные настройки ФР.
¶ Проверка связи ККТ с ТС ПИоТ
- «Администратор» → «Интеграции» → «Честный знак» → провайдер ЕСП.
- Нажмите «Запросить информацию о ККТ».
- В ответе должны быть заполнены идентификатор ТС ПИоТ, ЗН ККТ, ЗН ФН, ИНН ККТ — эти значения и указывают в отчёте о сертификации для конкретного стенда.
—
¶ Когда использовать (кратко)
Используйте эту инструкцию, если на кассе продаётся маркированный товар и проверка кода выполняется через ТС ПИоТ (ЕСП).
¶ Что нужно подготовить
- Доступ в модуль «Администратор».
- Доступ в модуль «Рецепция».
- Настроенное оборудование (сканер и фискальный регистратор).
- Тестовый клиент и тестовый код маркировки для проверки сценария продажи.
¶ Удаление маркированной позиции
- Если позиция ещё не пробита по кассе — удалите её из чека в «Рецепции».
- Если позиция уже пробита — удаление из чека недоступно; оформите возврат в модуле «Менеджер».
- «Менеджер» → клиент → вкладка «Чеки».
- Выберите позицию → «Отменить» → подтвердите.
¶ Настройка оборудования
¶ Считыватель
- «Рецепция» → «Настройки» → «Оборудование» → «Считыватели карт».
- «Добавить» → выберите подключённый считыватель.
¶ Если считывателя нет
В окне чека в поле «Штрих-код» вставьте:
- CIS, или
- полный DataMatrix в текстовом виде.
Важно: вставляйте код обычным текстом, без служебных (невидимых) символов.
¶ Фискальный регистратор
См. раздел Работа с ККТ.
¶ Частые ошибки и нюансы
| Симптом | Возможная причина | Что сделать |
|---|---|---|
| Нет провайдера «ЕСП» в настройках | Не обновлены программа или база данных | Обновить ClubIS и базу данных через модуль обновления |
| Ошибка связи с ЕСП при проверке марки | ЕСП не запущен, неверный адрес или сеть | Проверить службу ЕСП на этом ПК; адрес https://127.0.0.1:51401 |
| Проверка идёт «на другой машине» | Ожидание ЕСП на сервере БД | ЕСП должен работать на кассовом ПК, IP 127.0.0.1 |
| Ошибка при ручном вводе кода маркировки | В код попали служебные (невидимые) символы | Вводить код обычным текстом, без служебных символов |
| Нельзя удалить позицию из чека | Чек уже пробит по ККТ | Возврат только через «Менеджер» |
| Локальные настройки не совпадают с админом | Включено «Изменить локально…» в «Рецепции» | Снять флажок или выровнять адрес ЕСП и провайдера |
| Пустой ответ «Запросить информацию о ККТ» | ЕСП недоступен или не связан с ККТ/ЛМ | Запустить ЕСП; проверить конфигурацию ТС ПИоТ по документации поставщика |
| Долгая проверка маркировки | Долгий ответ ЕСП или локального модуля «Честный знак» | Проверить сеть, нагрузку и состояние локального модуля ЧЗ |
| Ошибки ККТ / нет ЗН в ответе ЕСП | Устаревшая прошивка АТОЛ, 64-bit ДТО 10, ККТ не в списке ПИоТ | Прошивка ≥ 5.17.0 (лучше 5.17.10+), драйвер ≥ 10.10.8.23 только 32-bit, модель из сертифицированного перечня |
| Иконка кассы в строке состояния серая / проверка марки через ЕСМ нестабильна | При постоянном режиме драйвер не удержан; нет связи с ККТ; при временном — пауза до готовности ТС ПИоТ не завершилась | Постоянный режим: включить «Держать драйвер в памяти…», перезапустить Рецепцию, проверить кабель/порт. Временный: дождаться окончания паузы при скане/пробитии; убедиться, что ККТ свободна (не занята другим рабочим местом) |
| Первая продажа с маркой не проходит, без маркировки всё ок; смена не открывалась вручную | Канал ЕСМ ещё не готов: смена была закрыта, проверка марки началась до подъёма канала | Дождаться паузы при первом скане марки (ClubIS откроет смену и дождётся канала) или открыть смену вручную до продажи маркированного товара; проверить, что ЕСП запущен и драйвер доступен |
| Несколько рабочих мест «встают колом» на одной ККТ | На всех местах включён постоянный режим удержания драйвера | Оставить постоянный режим только на одном основном месте или выключить опцию на всех местах и пользоваться временным подъёмом драйвера при маркировке |
| Нестабильная связь ЕСМ с кассой после «перезапуска» драйвера в середине смены | Драйвер ККТ остановили при открытой смене | Не останавливать драйвер до закрытия смены; постоянный режим в ClubIS; переустановить связь по инструкции ЕСМ |
| Ошибки после обновления ЕСМ / «чужой» драйвер ККТ | Установлен драйвер не из дистрибутива ЕСМ | Переустановить драйвер ККТ из актуального дистрибутива ЕСМ (личный кабинет партнёра) |
| Сбои проверок маркировки при одновременных запросах | Параллельные проверки в ТС ПИоТ и ОИСМ | Проверять коды по очереди (сначала ТС ПИоТ, затем ОИСМ); не дублировать проверку сторонними утилитами во время продажи |
| Проблемы с локальным модулем ЧЗ после установки контроллера | Контроллер ЛМ ЧЗ на другом ПК или старый контроллер не удалён | Ставить контроллер на тот же ПК, что и ЛМ ЧЗ; закрыть/удалить контроллеры предыдущих версий |
¶ Типовые сообщения ТС ПИоТ
Ниже — краткая памятка по частым сообщениям модуля проверки. Развёрнутые сценарии (службы Windows, антивирус, брандмаэр, порты, прокси, состав данных для диагностики) — в материале сообщества маркировки: Стабильная работа с ТС ПИоТ и что делать, если что-то идёт не так.
| Сообщение / код | Смысл | Что проверить в ClubIS и на кассе |
|---|---|---|
| Нет связи с модулем; в ClubIS часто HTTP код ответа = 0; на стороне Windows может быть 12029 | ClubIS не достучался до ЕСП на кассовом ПК | Службы ЕСП запущены; адрес https://127.0.0.1:51401; исключения антивируса и брандмаэра; порт 51401; прокси не мешает локальным подключениям; ЕСП успел полностью загрузиться до первой проверки |
| 514 | Не получен ответ ни от системы маркировки, ни от ЛМ ЧЗ | Интернет и доступ к сервисам ЧЗ; ЛМ ЧЗ установлен, запущен и синхронизирован (статус ready); в ClubIS для юр. лица настроены оффлайн-проверка и API V2; база ЛМ обновлялась не реже чем раз в 10 дней |
| 500 | Внутренняя ошибка модуля | Повторить сканирование; при повторе — перезапустить службы ЕСП и убедиться, что драйвер ККТ доступен (постоянный или временный режим в ClubIS); зафиксировать время и логи |
| 403 | Нет активной лицензии ТС ПИоТ или модуль не видит драйвер ККТ | Лицензия в личном кабинете ЕСП; драйвер ККТ не остановлен в середине смены; опция «Держать драйвер в памяти…» или ожидание временного подъёма драйвера при проверке марки; открытая смена на ККТ |
| Код уже выведен из оборота | Товар нельзя продать по этому коду | Исключить позицию из чека; уточнить статус в «ЧестныйЗНАК.Бизнес» или личном кабинете; связаться с поставщиком |
Если первичная проверка по таблице не помогла, передайте в поддержку ClubIS и/или поставщика ТС ПИоТ: ИНН, модель и регистрационный номер ККТ, версии Windows / ЕСП / ClubIS, адрес и порт ЕСП из настроек, точное время ошибки, скриншот и журналы (логи) ClubIS и модуля проверки.
¶ Типовые проверки после настройки
- При постоянном режиме после запуска Рецепции в строке состояния активна иконка кассы.
- Первая проверка марки при закрытой смене проходит: ClubIS открывает смену (возможен служебный документ на ККТ), делает короткую паузу и добавляет позицию в чек.
- При временном режиме проверка марки и пробитие маркированного чека проходят (возможна короткая пауза перед операцией).
- Позиция с маркировкой корректно добавляется в чек.
- Проверка кода проходит без ошибки.
- Для пробитой позиции выполняется возврат, а не удаление из чека.
- На рабочем месте применяются ожидаемые (общие или локальные) настройки «Честный знак».
- В личном кабинете ЕСП (Кассы → карточка кассы) после проверок марок растёт счётчик «Онлайн в ГИС МТ».
¶ См. также
- Стабильная работа с ТС ПИоТ и что делать, если что-то идёт не так — памятка сообщества маркировки по типовым ситуациям на кассе
- Единая сервисная платформа (ЕСП) — документация и загрузка ТС ПИоТ
- Личный кабинет ЕСП — раздел Кассы, проверка статистики по кассе
- Маркировка
- Администратор → Справочники
- Настройка оборудования
- Подакцизный товар