¶ ТС ПИоТ
Инструкция описывает взаимодействие ПМСР ClubIS с ТС ПИоТ (программный комплекс ЕСП — единая сервисная платформа) при продаже маркированного товара.
Установка, обновление и настройка модуля ЕСМ (ТС ПИоТ) выполняются по документации Единой сервисной платформы (ЕСП) — официального поставщика ТС ПИоТ (личный кабинет, загрузка ПО и инструкции). Модуль ставится на каждом кассовом компьютере отдельно от обновления ClubIS.
—
¶ Архитектура взаимодействия
┌─────────────────┐ HTTPS (локально) ┌──────────────────┐
│ ПМСР ClubIS │ ──────────────────────────► │ ТС ПИоТ (ЕСП) │
│ (Рецепция и │ https://127.0.0.1:51401 │ на том же ПК │
│ др. модули) │ └────────┬─────────┘
└─────────────────┘ │
▼
ЕСМ / локальный модуль ЧЗ,
ККТ (данные запрашиваются через ЕСП)
- ПМСР — программный модуль расчёта (в терминах интеграции: ClubIS, модули «Администратор», «Рецепция», «Менеджер»).
- ТС ПИоТ (ЕСП) — служба на том же компьютере, куда с кассы отправляются запросы проверки кодов маркировки.
- ЕСМ (единая система маркировки) и локальный модуль «Честный знак» настраиваются и обслуживаются со стороны ЕСП; ClubIS к ЕСМ напрямую не подключается — только через HTTP API ЕСП.
Используемые вызовы API ЕСП со стороны ClubIS:
| Метод | Адрес | Назначение |
|-------|--------|------------|
|POST|{адрес ЕСП}/api/v2/codes/check| Проверка кода маркировки при добавлении в чек |
|GET|{адрес ЕСП}/api/v2/info| Сведения о ТС ПИоТ, ККТ и локальном модуле ЧЗ |
В запросах передаётся блокclient_infoс идентификатором ПМСР (Id PMSR), версией ClubIS и токеном (хеш исполняемого файла модуля).
—
¶ Минимальные требования
¶ Версия ПМСР (ClubIS)
- Версия ClubIS не ниже
3.208.26099(формат пакета:3.<версия БД>.<сборка>). - На площадке установлены все патчи базы данных, в том числе
209_chestniy_znak_esp(в настройках «Честный знак» доступен провайдер «ЕСП (Единая сервисная платформа)»). - Для работы на кассе: модуль «Рецепция»; для общих настроек — «Администратор»; для возврата пробитых позиций — «Менеджер».
¶ ТС ПИоТ (ЕСП)
- ЕСП установлен и запущен на каждом рабочем месте, с которого выполняется проверка маркировки.
- По умолчанию ЕСП принимает запросы по адресу
https://127.0.0.1:51401(протокол HTTPS, хост 127.0.0.1, порт 51401). Другие IP/порт в штатной схеме не используются. - Взаимодействие ClubIS с ЕСП — по протоколу API v2 (
/api/v2/codes/check/api/v2/info`). - Версия ПО ТС ПИоТ на стенде уточняется при приёмочных испытаниях (в ClubIS не хранится); перед тестами убедитесь, что ЕСП установлен по инструкции поставщика ТС ПИоТ.
¶ Оборудование на кассе (ККТ)
- Считыватель штрих-/DataMatrix-кодов или ручной ввод CIS / DataMatrix в чеке.
- ККТ: любая модель АТОЛ из перечня, сертифицированного для работы с ПИоТ (конкретную модель выбирают на площадке).
- ОС ККТ (прошивка): не ниже 5.17.0 (рекомендуется 5.17.10 и выше).
- Драйвер ККТ (ДТО 10): не ниже 10.10.8.23, установка строго 32-битная (даже на 64-битной ОС Windows).
¶ Архитектура развёртывания
| Компонент | Где работает |
|---|---|
| ClubIS (ПМСР) | Сервер БД + рабочие места (клиентские модули) |
| ТС ПИоТ (ЕСП) | Локально на каждом кассовом ПК (не на сервере БД) |
| PostgreSQL | Сервер площадки (общая БД ClubIS) |
—
¶ Что обновлять и как
¶ ClubIS (ПМСР)
- Обновление — по инструкции Обновление для Windows.
- После обновления: версия не ниже
3.208.26099, на базе данных применены все патчи (для интеграции с ЕСП обязателен209_chestniy_znak_esp). - Файлы конфигурации ЕСП вручную в каталог ClubIS не копируются.
¶ ТС ПИоТ (ЕСП)
- Устанавливается и обновляется отдельно по инструкции разработчика ТС ПИоТ на каждом кассовом компьютере.
- ClubIS не обновляет ЕСП; при смене версии ЕСП следуйте документации поставщика ТС ПИоТ.
¶ Локальные переопределения на кассе
- При включении «Изменить локально провайдера…» в «Рецепции» параметры (в т.ч. адрес ЕСП) сохраняются в локальных настройках этого ПК, а не в общей БД.
—
¶ Настройка интеграции с ЕСМ в ПМСР
Под «настройкой до ЕСМ» в 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(редактирование в этом модуле отключено — используется локальный ЕСП на каждой кассе). - Нажмите «Сохранить».
После сохранения настройки действуют для всех рабочих мест, если на кассе не включено локальное переопределение.
¶ 2. Локальное переопределение на конкретной кассе («Рецепция»)
Если на одном ПК нужен другой адрес ЕСП (тесты, нестандартная схема):
- «Рецепция» → «Настройки» → «Основное» → «Честный знак».
- Включите «Изменить локально провайдера Честного знака» (в «Администраторе» этот флажок недоступен).
- Выберите провайдера «ЕСП» и при необходимости измените поле HTTP(s) адрес ЕСП с портом (формат:
https://хост:порт, напримерhttps://127.0.0.1:51401). - «Сохранить».
—
¶ Проверка настройки работы ПМСР с ЕСМ (через ЕСП)
¶ 1. Проверка доступности ЕСП
На кассовом ПК, где установлена «Рецепция» и ЕСП:
- Убедитесь, что служба ТС ПИоТ (ЕСП) запущена.
- При необходимости проверьте ответ (с учётом самоподписанного сертификата может потребоваться игнорирование проверки SSL):
- запрос
GETкhttps://127.0.0.1:51401/api/v2/info.
- запрос
¶ 2. Запрос сведений из ClubIS
- «Администратор» → «Интеграции» → «Честный знак».
- Для юридического лица с провайдером ЕСП нажмите «Запросить информацию о ККТ».
- В ответе должны отобразиться, в частности:
- идентификатор ТС ПИоТ;
- заводской номер ККТ, заводской номер ФН, ИНН ККТ;
- при наличии — данные локального модуля «Честный знак» (версия, статус, адрес ЛМ).
При ошибке связи проверьте запуск ЕСП и адресhttps://127.0.0.1:51401на этом же компьютере.
¶ 3. Проверка в продаже (сценарий тестирования)
- «Рецепция» → клиент «ESP ESP ESP» (тестовый) → «Чек» (
Alt+6). - Отсканируйте или введите тестовый код маркировки.
- Убедитесь, что позиция добавлена в чек без ошибки проверки.
Вход для тестов: логинesp, пароль пустой (см. Вход в модули).
—
¶ Работа с ККТ
В рамках интеграции с ТС ПИоТ ClubIS использует фискальный регистратор АТОЛ, подключённый через драйвер ДТО 10 (32-bit) и выбранный в модуле «Рецепция». Сведения о ККТ (заводской номер ККТ, заводской номер ФН, ИНН) ПМСР получает через ЕСП (кнопка «Запросить информацию о ККТ» в «Администраторе»), а не запросом напрямую к драйверу при проверке маркировки.
¶ Требования к ККТ (для отчёта и эксплуатации)
| Параметр | Значение |
|---|---|
| Производитель / линейка | АТОЛ, модель из списка сертифицированных для работы с ПИоТ |
| Прошивка (ОС ККТ) | ≥ 5.17.0 (рекомендуется ≥ 5.17.10) |
| Драйвер | ДТО 10, версия ≥ 10.10.8.23, только 32-bit |
Перед испытаниями проверьте версии прошивки и драйвера в утилитах АТОЛ; при несоответствии обновите по регламенту производителя ККТ.
¶ Настройка ККТ в ClubIS
- «Рецепция» → «Настройки» → «Оборудование» → «Фискальные регистраторы».
- Откройте нужное юридическое лицо.
- На вкладке «Основное» выберите подключённый фискальный регистратор АТОЛ (через ДТО 10).
- Сохраните настройки.
¶ Проверка связи ККТ с ТС ПИоТ
- «Администратор» → «Интеграции» → «Честный знак» → провайдер ЕСП.
- Нажмите «Запросить информацию о ККТ».
- В ответе должны быть заполнены идентификатор ТС ПИоТ, ЗН ККТ, ЗН ФН, ИНН ККТ — эти значения и указывают в отчёте о сертификации для конкретного стенда.
—
¶ Когда использовать (кратко)
Используйте эту инструкцию, если на кассе продаётся маркированный товар и проверка кода выполняется через ТС ПИоТ (ЕСП).
¶ Что нужно подготовить
- Доступ в модуль «Администратор».
- Доступ в модуль «Рецепция».
- Настроенное оборудование (сканер и фискальный регистратор).
- Тестовый клиент и тестовый код маркировки для проверки сценария продажи.
¶ Удаление маркированной позиции
- Если позиция ещё не пробита по кассе — удалите её из чека в «Рецепции».
- Если позиция уже пробита — удаление из чека недоступно; оформите возврат в модуле «Менеджер».
- «Менеджер» → клиент → вкладка «Чеки».
- Выберите позицию → «Отменить» → подтвердите.
¶ Настройка оборудования
¶ Считыватель
- «Рецепция» → «Настройки» → «Оборудование» → «Считыватели карт».
- «Добавить» → выберите подключённый считыватель.
¶ Если считывателя нет
В окне чека в поле «Штрих-код» вставьте:
- CIS, или
- полный DataMatrix в текстовом виде.
Важно: вставляйте DataMatrix без управляющего символа\u001D.
¶ Фискальный регистратор
См. раздел Работа с ККТ.
¶ Вход в модули
Для тестовой площадки: логин esp, пароль пустой.
¶ Частые ошибки и нюансы
| Симптом | Возможная причина | Что сделать |
|---|---|---|
| Нет провайдера «ЕСП» в настройках | Не применён патч БД 209_chestniy_znak_esp |
Обновить БД площадки через модуль обновления |
| «Ответ HTTP не 200» при проверке | ЕСП не запущен, неверный адрес, сеть/SSL | Проверить службу ЕСП на этом ПК; адрес https://127.0.0.1:51401 |
| Проверка идёт «на другой машине» | Ожидание ЕСП на сервере БД | ЕСП должен работать на кассовом ПК, IP 127.0.0.1 |
| Ошибка при ручном вводе DataMatrix | Вставлен символ GS (\u001D) |
Вводить код обычным текстом, без служебных символов |
| Нельзя удалить позицию из чека | Чек уже пробит по ККТ | Возврат только через «Менеджер» |
| Локальные настройки не совпадают с админом | Включено «Изменить локально…» в «Рецепции» | Снять флажок или выровнять адрес ЕСП и провайдера |
| Пустой ответ «Запросить информацию о ККТ» | ЕСП недоступен или не связан с ККТ/ЛМ | Запустить ЕСП; проверить конфигурацию ТС ПИоТ по документации поставщика |
| Таймаут проверки (до 15 с) | Долгий ответ ЕСП/ЕСМ | Проверить сеть, нагрузку, состояние локального модуля ЧЗ в ответе /api/v2/info |
| Ошибки ККТ / нет ЗН в ответе ЕСП | Устаревшая прошивка АТОЛ, 64-bit ДТО 10, ККТ не в списке ПИоТ | Прошивка ≥ 5.17.0 (лучше 5.17.10+), драйвер ≥ 10.10.8.23 только 32-bit, модель из сертифицированного перечня |
¶ Типовые проверки после настройки
- Позиция с маркировкой корректно добавляется в чек.
- Проверка кода проходит без ошибки.
- Для пробитой позиции выполняется возврат, а не удаление из чека.
- На рабочем месте применяются ожидаемые (общие или локальные) настройки «Честный знак».