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

Инструкция по установке "РБ-Софт: ТС ПИоТ"

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

На кассовый компьютер ставится локальная программа. Она работает со своей ККТ и с локальным модулем «Честный ЗНАК». В ГИС МТ программа ходит через онлайн-службу ТС ПИоТ по адресу https://piot.rbsoft.ru.

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

1. Требования к установке

Требование Назначение
Windows, 32-разрядная установка Драйвер ККТ — 32-разрядная COM-библиотека. Программа ставится в C:\Program Files (x86)\PiotLocal
Права администратора Установщик создаёт службы Windows
Драйвер РР-Электро COM-сервер AddIn.DrvFR с командами ТС ПИоТ: режим ТС ПИоТ, шифрование и расшифрование блока ФН, журнал событий
ККТ с фискальным накопителем Касса включена и доступна драйверу. Взаимная аутентификация с ГИС МТ выполняется средствами ФН
Локальный модуль «Честный ЗНАК» Установлен отдельно, HTTP API версии 2. Обычно это http://127.0.0.1:5995, учётная запись admin
Доступ к https://piot.rbsoft.ru С кассового компьютера открывается порт 443. Онлайн-служба принимает TLS 1.2 и TLS 1.3
Лицензия ТС ПИоТ на эту ККТ Без действующей лицензии регистрация и проверка кодов не выполняются

Отдельно ставить .NET не нужно: PiotLocal.exe и PiotLocalAdmin.exe уже содержат среду выполнения.

2. Как настроить ККТ

Перед первым подключением в таблице настроек ККТ задают поле 68 «Предпочтительный режим ДТСПИОТ». От него зависит, увидит ли драйвер кассу и сможет ли фискальный накопитель шифровать обмен.

Значение Что делает касса
0 Режим не используется. Касса не ведёт журнал событий для ТС ПИоТ. Шифрование и расшифрование для драйвера не работают
1 Касса отвечает на втором виртуальном COM-порте. Так она работает в режимах Ethernet, Wi-Fi и PPP через UART
2 Касса открывает второй TCP-сокет. Его порт на 2 больше основного порта кассы

Для работы с программой поле 68 должно быть 1 или 2. При значении 0 экземпляр к обмену с ГИС МТ не готов: нет ни журнала, ни шифрования.

Дальше тот же способ указывают в карточке экземпляра.

COM, если в поле 68 стоит 1. В карточке выбирают тип подключения COM и указывают номер второго виртуального COM-порта (1 — это COM1) и скорость: 2400, 4800, 9600, 19200, 38400, 57600 или 115200. Если скорость не меняли, программа использует 9600.

TCP, если в поле 68 стоит 2. В карточке выбирают тип подключения TCP и указывают IP-адрес кассы и TCP-порт. Это порт второго сокета: основной порт кассы плюс 2.

3. Установка

  1. Запустить установщик Windows от имени администратора.
  2. Каталог по умолчанию оставить: C:\Program Files (x86)\PiotLocal.
  3. Дождаться окончания. Установщик останавливает прежние службы, если они были, копирует Server\PiotLocal.exe и Admin\PiotLocalAdmin.exe и один раз записывает идентификатор установки в HKLM\SOFTWARE\RBSOFT\PiotLocal\InstanceId. При удалении программы это значение не стирается.
  4. Установщик создаёт и запускает две службы с автозапуском:
  5. PiotLocal — «ТС ПИоТ», файл Server\PiotLocal.exe;
  6. PiotLocalAdmin — «ТС ПИоТ Админ», файл Admin\PiotLocalAdmin.exe --no-browser.

Ярлыки в меню «Пуск» не создаются. Окно администратора открывают в браузере.

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

Проверка Что должно получиться
http://127.0.0.1:5091/ Открывается интерфейс. В шапке «ТС ПИоТ» и версия 0.0.1.1030. Корень переходит на /devices
http://127.0.0.1:5090 Служба отвечает
Службы Windows PiotLocal и PiotLocalAdmin в состоянии «Работает»

Настройки экземпляров служба пишет в %ProgramData%\RBSOFT\Piot\Local. Журналы лежат в %ProgramData%\RBSOFT\Piot\Local\log и %ProgramData%\RBSOFT\Piot\Log\Admin.

4. Первый экземпляр

  1. Открыть http://127.0.0.1:5091/devices.
  2. Нажать «Добавить».
  3. На вкладке «Подключение» задать имя устройства латиницей, цифрами и символами _-.(), адрес экземпляра 127.0.0.1 и свободный порт. Первый порт, который предлагает программа, — 50000. Тип драйвера — RrElectro. Тип подключения и параметры кассы — как в разделе 2.
  4. На вкладке «Локальный модуль» проверить адрес модуля: обычно IP 127.0.0.1, порт 5995, логин admin. Указать часовой пояс точки продаж и, если он известен, код ФИАС.
  5. Сохранить карточку.
  6. На вкладке «Лицензия» убедиться, что лицензия этой ККТ действует.
  7. Запустить регистрацию экземпляра в ГИС МТ. Запрос уходит в онлайн-службу https://piot.rbsoft.ru, а служба регистрирует экземпляр на cdn01.am.crptech.ru:19100.
  8. Дождаться идентификатора tsp_id. На вкладке «Состояние» статус в ГИС МТ должен стать «Зарегистрирован».
  9. На вкладке «Локальный модуль» нажать «Инициализация». Программа по очереди открывает доверенный канал, активирует модуль, включает серый список и регистрирует в нём экземпляр. Статус модуля должен стать «готов к работе».
  10. В кассовом ПО указать HTTPS-адрес экземпляра, например https://127.0.0.1:50000. Сертификат самоподписанный, файл %ProgramData%\RBSOFT\Piot\Local\certs\instance-https.pfx, имя CN=PiotLocal Instance API.

Дальнейшая работа в интерфейсе описана в руководстве пользователя. Порты, службы и файлы настроек — в руководстве системного программиста.

5. Удаление

Удаление через «Программы и компоненты» останавливает и удаляет службы PiotLocal и PiotLocalAdmin. Идентификатор установки в реестре сохраняется. Каталог %ProgramData%\RBSOFT\Piot установщик не очищает: в нём остаются настройки экземпляров, кэш и журналы.

6. Онлайн-служба

Онлайн-служба ТС ПИоТ уже работает по адресу https://piot.rbsoft.ru. Локальная программа обращается к этому адресу сама.