API ТС ПИоТ: запросы, проверка кода и интеграция кассового ПО
Практическое объяснение API ТС ПИоТ для разработчиков: сценарий проверки, статусы, ошибки и безопасная интеграция.
Задача API
API нужен кассовому ПО и интеграторам для передачи данных на проверку кода маркировки и получения результата. Конкретные endpoint, авторизация и формат запроса определяются текущей документацией решения.
Типовой сценарий
- Кассовое ПО получает код маркировки.
- Отправляет запрос на локальный компонент/сервис.
- ТС ПИоТ выполняет проверку по своей схеме взаимодействия.
- Касса получает результат и формирует чек по правилам конкретного сценария.
Обработка ошибок
Нельзя считать HTTP 200 безусловным успехом: некоторые сервисы возвращают асинхронный статус обработки. Поэтому интеграция должна уметь повторить запрос по UUID/идентификатору результата, когда это предусмотрено API.
Безопасность
Токены и пароли нельзя встраивать в открытый клиентский JavaScript или публиковать в Git. Храните секреты в защищённой конфигурации и ограничивайте доступ к локальному API.
Связанные материалы
Полный справочник ТС ПИоТ · совместимость · ошибки · файлы и драйверы.
Расширенное практическое руководство
Основная тема страницы — интеграция кассового ПО через API, статусы запросов, повторы, журналы и обработка запрета продажи. Для надёжного результата рассматривайте не отдельную программу, а всю цепочку: модель и прошивка ККТ, драйвер, кассовое ПО, ЕСМ, контроллер ЛМ ЧЗ, Regime, сеть и регистрационные данные.
Запишите версии, сделайте резервную копию и выберите одну тестовую кассу.
Меняйте по одному компоненту и сохраняйте журналы каждого этапа.
Проведите проверку разрешённого и запрещающего сценария, затем перезагрузите компьютер.
Компоненты и контрольные точки
| Уровень | Что проверить | Признак готовности |
|---|---|---|
| ККТ | Модель, прошивка, ФФД, ФН и регистрационные параметры. | Тест драйвера проходит без ошибок. |
| Драйвер | Версию, разрядность, порт и совместимость с программой. | ККТ доступна после перезапуска. |
| Кассовое ПО | Релиз, модуль маркировки и настройки ТС ПИоТ. | Программа распознаёт Data Matrix и получает статус. |
| ЕСМ и ЛМ ЧЗ | Службы, версии, локальные адреса и журналы. | Сервисы запущены автоматически и отвечают. |
| Сеть | DNS, HTTPS, прокси, брандмауэр и системное время. | Нет повторяющихся тайм-аутов и TLS-ошибок. |
Порядок выполнения
- Зафиксируйте исходную конфигурацию.
- Проверьте совместимость кассы и ПО.
- Скачайте проверенные версии в разделе файлов.
- Установите или обновите компоненты в рекомендованном порядке.
- Проверьте службы и локальный API.
- Настройте кассовую программу и драйвер.
- Выполните контрольный тест.
- Сохраните рабочую матрицу версий.
Диагностика и обслуживание
- сохраните точный текст и время ошибки;
- проверьте передачу полного Data Matrix;
- убедитесь, что порт не занят;
- сверьте 32/64-bit компонентов;
- проверьте дату и часовой пояс;
- изучите журнал первой ошибки;
- не отключайте антивирус полностью;
- после одного изменения повторите тот же тест;
- не обновляйте сразу все кассы сети;
- подготовьте возможность отката.
Справочники: коды ошибок, пошаговая диагностика, сеть и порты.
Частые вопросы
Можно ли выполнить работу самостоятельно?
Да, если известны точные версии и есть права администратора. Для рабочей точки обязательно подготовьте копию и откат.
Нужно ли обновлять все компоненты?
Только после проверки матрицы совместимости. Новейшая версия одного компонента может не подходить старому кассовому ПО.
Что проверять после перезагрузки?
Автозапуск служб, доступность локального API, связь с ККТ и тест маркированной позиции.
Когда обращаться в поддержку?
Когда ошибка воспроизводится после базовых проверок. Передайте версии, модель ККТ, время, скриншот и фрагмент журнала без секретов.