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

Интеграция с ТС ПИоТ

> Сервер ККМ > СерверККМ V4
Дата обновления: 2 апреля 2026 г. Дата публикации: 4 марта 2026 г. Автор: Машковцев Тимур

Интеграция с ТС ПИоТ

Интеграция сервера ККМ 4 с техническими средствами получения информации о товаре (ТС ПИоТ) позволяет выполнять валидацию кодов маркировки перед продажей. Сервер выполняет запрос на проверку кодов маркировки из позиций чека в ТС ПИоТ, получает результаты валидации и, в случае обнаружения некорректного или запрещённого кода маркировки, блокирует реализацию такого товара. Это обеспечивает соблюдение требования законодательства и исключения продажи товаров с недействительной маркировкой.

1. Подготовка к интеграции

1.1. Необходимые условия

Для корректной работы интеграции каждая ККМ должна быть зарегистрирована в том экземпляре ТС ПИоТ, с которым планируется взаимодействие. Без выполнения этого условия проверка кодов маркировки через ТС ПИоТ будет заблокирована в сервере ККМ 4.

1.2. Подготовка сетевых параметров

Зафиксируйте IP-адрес (или DNS-имя) и порт(если есть), на котором ТС ПИоТ принимает входящие запросы. Эти параметры потребуются при настройке работы с ТС ПИоТ в сервере ККМ 4.

2. Включение проверки через ТС ПИоТ

2.1. Выбор ККМ

  1. Перейдите на вкладку со списком устройств.
  2. Выберите существующую ККМ, для которой требуется настроить проверку.

Выбор ККМ

2.2. Выбор режима проверки

  1. В настройках выбранной ККМ откройте вкладку «Маркировка».
  2. В разделе настроек режима проверки выберите «Проверка через ТС ПИоТ».
  3. Сохраните изменения.

Выбор режима проверки

2.3. Настройка параметров ТС ПИоТ

В разделе «ТС ПИоТ» укажите:

Параметр Описание
Адрес ТС ПИоТ IP‑адрес или DNS‑имя устройства ТС ПИоТ
Порт ТС ПИоТ Порт, на котором ТС ПИоТ принимает запросы

После заполнения полей сохраните настройки.

Настройка адреса и порта ТС ПИоТ

Описанный алгоритм настройки является идентичным для любых ККМ, независимо от модели кассы И производителя, процедура включения проверки и принцип взаимодействия с ТС ПИоТ остается единым для всех ККМ.

3. Принцип работы проверки через ТС ПИоТ

3.1. Валидация подключения

При сохранении настроек сервер СККМ4 выполняет проверку доступности ТС ПИоТ и совместимости данных:

  • Отправляется GET‑запрос http://<адрес>:<порт>/api/v2/info.
  • В ответе ожидаются серийный номер ККМ, серийный номер ФН и ИНН.
  • Если все три параметра совпадают с данными выбранной ККМ, сервер:
  • запоминает идентификатор ТС ПИоТ для этой ККМ;
  • сохраняет значение параметра codesCheckTimeout (время ожидания ответа);
  • разрешает проверку кодов через ТС ПИоТ для данной ККМ.
  • При несовпадении данных, недоступности ТС ПИоТ или ошибках запроса проверка блокируется до устранения причин.

3.2. Проверка кодов маркировки в чеке

При пробитии чека, содержащего коды маркировки:

  1. Сервер собирает все коды из строк чека.
  2. Формирует POST‑запрос http://<адрес>:<порт>/api/v2/codes/check с телом, содержащим массив кодов.
  3. Получает ответ с результатами проверки по каждому коду.
  4. Для каждого кода формируется итог:
  5. код корректен и разрешён к реализации;
  6. или возвращается конкретное сообщение об ошибке (неверная структура, криптография, блокировка, отсутствие в системе, выбытие из оборота).

3.3. Обработка офлайн‑режима

Если в ответе ТС ПИоТ для проверки указан признак isCheckedOffline = true, это означает, что проверка выполнена по офлайн‑правилам.
В этом случае решение о возможности продажи принимается на основе поля isBlocked:

  • isBlocked = true – продажа товара по этому коду не допускается;
  • isBlocked = false – ограничения офлайн‑режима не блокируют проведение чека.