ТЕХНИЧЕСКАЯ ДОКУМЕНТАЦИЯ

Руководство пользователя

> ТС ПИоТ
Дата обновления: 30 октября 2026 г.

Руководство пользователя

Кассир в обычной продаже эту программу не открывает: кассовое ПО само обращается к экземпляру ТС ПИоТ.

Версия работает только на тестовом контуре ГИС МТ. Регистрация идёт на cdn01.am.crptech.ru:19100. После регистрации используются площадки https://cdn01.am.crptech.ru:19101, https://cdn02.am.crptech.ru:19101 и https://cdn03.am.crptech.ru:19101. Связь с контуром проходит через https://piot.rbsoft.ru.

1. Как открыть программу

После установки службы уже запущены. В браузере на этом же компьютере открыть:

http://127.0.0.1:5091/devices

В шапке слева — название продукта и номер версии.

Внизу окна — контактная информация: телефон 8-800-2000-999, почта support@rbsoft.ru, сайт www.rbsoft.ru.

Слева два раздела: «ТС ПИоТ» и «Журнал событий».

Список экземпляров

Таблица экземпляров показывает имя, драйвер, адрес API, статус, лицензию и примечание. Зелёный статус «Готов» означает, что экземпляр поднят. Адрес вида https://127.0.0.1:50000 — это адрес, который указывают в кассовом ПО.

2. Создать экземпляр

  1. Нажать «Добавить».
  2. Заполнить вкладку «Подключение».
  3. Нажать «Сохранить».

Имя устройства обязательно. Допустимы латиница, цифры и символы _-.(). Пример подсказки в поле: KKT-1.

Поля подключения:

Поле Что указать
IP адрес экземпляра 127.0.0.1, если кассовое ПО на этом же ПК
Порт экземпляра Свободный порт. Первый предлагаемый — 50000
Тип драйвера ККМ RrElectro
Тип подключения COM или TCP — тот же режим, что в поле 68 ККТ «Предпочтительный режим ДТСПИОТ»
Номер COM-порта и скорость Для режима COM: второй виртуальный COM-порт и его скорость
IP адрес ККТ и TCP-порт Для режима TCP: адрес кассы и порт второго сокета, на 2 больше основного порта кассы

Карточка, вкладка «Подключение»

Кнопка «Удалить» убирает экземпляр. «Отменить регистрацию» снимает экземпляр с учёта в ГИС МТ. Пока регистрация не выполнена, эта кнопка не нужна.

3. Указать локальный модуль «Честный ЗНАК»

Вкладка «Локальный модуль». Модуль должен быть уже установлен на компьютере.

Поле Значение по умолчанию
IP адрес 127.0.0.1
Порт 5995
Логин admin
Пароль пароль модуля, по умолчанию admin
ФИАС точки продаж идентификатор адреса точки, если он есть
Часовой пояс (tz) смещение, которое модуль ждёт в протоколе. На стенде указано 3

Программа работает с ЛМ ЧЗ по HTTP API версии 2. Номер сборки модуля программа не задаёт сама: она читает его из модуля. На стенде модуль сообщил версию 2.6.1-7.

Карточка, вкладка «Локальный модуль»

Кнопку «Инициализация» нажимают после того, как экземпляр уже зарегистрирован в ГИС МТ и есть tsp_id. «Обновить статус» перечитывает GET /api/v2/status, не стирая настройки.

4. Зарегистрировать экземпляр в ГИС МТ

Регистрация нужна один раз на связку «этот компьютер + эта ККТ + этот ФН».

Перед регистрацией:

  • касса включена и открывается драйвером;
  • лицензия на эту ККТ действительна;
  • с компьютера открывается https://piot.rbsoft.ru.

Дальше в карточке экземпляра запускается инициализация. Программа через онлайн-службу ТС ПИоТ обращается на cdn01.am.crptech.ru:19100, передаёт заводской номер ФН и ждёт идентификатор tsp_id и адреса площадок CDN. Это может занять несколько минут: программа опрашивает состояние регистрации, пока контур не завершит её.

Когда регистрация прошла, на вкладке «Состояние» поле «Статус в ГИС МТ» становится «Зарегистрирован», а «Идентификатор ТС ПИоТ» заполнен.

Смена ФН у уже зарегистрированного экземпляра выполняется отдельной операцией смены ФН, а не повторным созданием карточки.

5. Прочитать состояние

Вкладка «Состояние» только показывает данные, поля здесь не редактируются.

Карточка, вкладка «Состояние»

На ней видно:

  • идентификатор экземпляра в ГИС МТ и статус регистрации;
  • драйвер, модель ККТ, заводской и регистрационный номера, номер ФН, ИНН, смена;
  • статус ЛМ ЧЗ, его версию, идентификатор экземпляра модуля и время последней синхронизации.

На стенде 30.10.2026: драйвер «РР-Электро 7.0.37», модель «РР-02Ф», ЛМ ЧЗ «готов к работе», версия «2.6.1-7».

Вкладка «Лицензия» показывает серийный номер лицензии, тип, организацию, срок действия и срок обновлений. Пока лицензия недействительна, проверка кодов не выполняется.

6. Журнал событий

Раздел «Журнал событий» — http://127.0.0.1:5091/kkt-logs.

Журнал событий

Вверху выбирается устройство. В таблице — время, тип операции и состояние («Успех» или ошибка). Сюда попадают события эксплуатации, которые программа снимает с ККТ и готовит к передаче в ГИС МТ: проверка кода, чек, смена, пользователь, настройка канала.

Если строк нет, экземпляр ещё не работал с кассой либо журнал ККТ пуст.

7. Как это выглядит для кассы

Кассовое ПО настраивают на адрес экземпляра из колонки «Адрес», например https://127.0.0.1:50000. Сертификат самоподписанный. Кассовое ПО должно доверять ему либо отключить проверку имени только для этого локального адреса — по правилам самого кассового ПО.

Касса вызывает:

  • GET /api/v1/info, /api/v2/info или /api/v3/info — кто обслуживает кассу (идентификатор ТС ПИоТ, номера ККТ и ФН, таймаут проверки, состояние ЛМ ЧЗ);
  • POST /api/v1/codes/check, /api/v2/codes/check или /api/v3/codes/check — можно ли продавать переданные коды.

Пользователь ТС ПИоТ (ФИО кассира) передаётся в поле client_info.user_name, если кассовое ПО его знает. Вход пользователя фиксируется отдельным запросом к локальной службе и затем уходит в журнал ГИС МТ.

Если площадка ГИС МТ не ответила, а ЛМ ЧЗ в состоянии «готов к работе», касса получает ответ модуля. В таком ответе признак офлайн-проверки установлен. Кассир действует по правилам кассового ПО: программа уже подставила разрешённый или запрещённый результат.

Аварийный режим, который прислала площадка в конфигурации, отключает проверку допустимости продажи. Тогда касса получает код 203 и текст о том, что проверки отключены.

8. Если что-то не работает

Что видно Что сделать
Страница http://127.0.0.1:5091 не открывается Проверить, что служба «ТС ПИоТ Админ» запущена
В списке нет экземпляра или статус не «Готов» Открыть карточку, проверить IP и порт, сохранить снова. Убедиться, что служба «ТС ПИоТ» запущена
Инициализация пишет, что нет связи с PiotWeb Проверить доступ к https://piot.rbsoft.ru/healthz . Должен вернуться ответ Healthy
«Сначала инициализируйте ТС ПИоТ» при работе с ЛМ Сначала регистрация в ГИС МТ, потом кнопка «Инициализация» на вкладке модуля
«ЛМ ЧЗ недоступен» Проверить, что модуль слушает 127.0.0.1:5995, логин и пароль совпадают
Лицензия недействительна Активировать лицензию на вкладке «Лицензия» для этой ККТ
Касса не соединяется с драйвером Проверить IP и TCP-порт кассы и что установлен драйвер РР-Электро с командами ТС ПИоТ. Служба должна быть 32-разрядной: драйвер поставляется как 32-разрядная COM-библиотека

Поддержка производителя: support@rbsoft.ru, 8-800-2000-999.