Коды ошибок ТС ПИоТ: полный справочник причин и решений
Ошибку важно искать по цепочке: сканер → кассовое ПО → локальный API → ЕСМ → ЛМ ЧЗ → сеть → система маркировки → драйвер → ККТ. Одинаковое сообщение на экране может иметь разные причины.
Ниже собраны типовые статусы API, сетевые и системные ошибки, проблемы проверки кода маркировки, драйверов АТОЛ и POSCenter, а также безопасный порядок диагностики.
Содержание
Что сделать сразу после появления ошибки
Сохраните сообщение полностью, включая код, время, название программы и состояние чека.
Переустановка удаляет полезные журналы и может добавить новую проблему к исходной.
Ошибка на одной кассе, всех кассах магазина или во всей сети — это разные направления поиска.
Вспомните обновление, замену ФН, прошивки, сертификата, антивируса или сетевых правил.
Повтор нужен для подтверждения, но бесконечные запросы могут привести к дубликатам и блокировке.
Для поддержки важен сам сценарий: товар, GTIN, Data Matrix и результат проверки.
На каком уровне возникает ошибка
Код обрезан, добавлены символы или неверная раскладка.
Не распознана маркировка или не вызван ТС ПИоТ.
Служба остановлена, занят порт или неверный адрес.
DNS, прокси, TLS, интернет или удалённый сервис.
Драйвер, прошивка, ФФД или состояние фискального регистратора.
Проверяйте уровни последовательно. Если сканер передаёт неполный код, переустановка ЕСМ не поможет. Если локальный API отвечает, но запрос наружу не проходит, искать нужно сеть или сертификаты.
StateCheckNotFound и ожидание результата
StateCheckNotFound обычно означает, что по идентификатору запроса пока не найден готовый результат проверки либо состояние уже недоступно. Это не всегда окончательный отказ продажи.
- Сохраните идентификатор исходного запроса.
- Подождите интервал, предусмотренный API или кассовой программой.
- Повторите получение состояния, а не создавайте бесконечно новые проверки.
- Проверьте, не перезапускался ли локальный сервис между запросами.
- Если ответ повторяется, изучите журналы и корректность идентификатора.
HTTP-коды и ответы API
Конкретный набор кодов зависит от метода и реализации. В документации проекта для CashDesk Service прямо встречаются 400, 401, 403 и 498; остальные коды ниже приведены как стандартные направления диагностики веб-сервисов.
| Код | Что означает | Что проверить |
|---|---|---|
| 400 | Некорректный запрос или обязательный параметр не передан. | JSON, типы полей, OS/platform, обязательные значения и кодировку. |
| 401 | Недействительные данные авторизации. | Токен, заголовок Authorization и правильность окружения. |
| 403 | Недостаточно прав или запрос запрещён политикой сервиса. | Роль пользователя, организацию, лицензию и доступ к методу. |
| 404 | Адрес, объект, состояние проверки или версия не найдены. | URL, идентификатор запроса, platform и наличие публикации. |
| 408 / timeout | Ответ не получен за допустимое время. | Сеть, прокси, нагрузку, DNS и интервалы повторов. |
| 409 | Конфликт состояния или повторная операция. | Дубликаты запросов и текущее состояние кода/документа. |
| 422 | Запрос понятен, но данные нельзя обработать. | Формат марки, GTIN, реквизиты товара и бизнес-правила. |
| 429 | Слишком много запросов. | Частоту повторов, очередь и ограничение клиента. |
| 498 | Токен просрочен, но может требовать обновления. | Refresh-процесс и часы системы; для публичных методов токен обычно не нужен. |
| 500 | Внутренняя ошибка сервиса. | Журнал сервера, воспроизводимость и корректность запроса. |
| 502 / 503 / 504 | Шлюз или зависимый сервис недоступен. | Статус внешнего сервиса, сеть и безопасный повтор позже. |
Сетевые ошибки, DNS и тайм-ауты
| Сообщение | Вероятная причина | Действие |
|---|---|---|
| Connection refused | На адресе и порту никто не слушает. | Запустить службу, проверить порт и адрес localhost. |
| Connection timed out | Пакеты блокируются или сервис не отвечает. | Проверить брандмауэр, прокси, маршрут и доступность узла. |
| Could not resolve host | Ошибка DNS. | Проверить DNS-серверы и разрешение имени. |
| SSL/TLS certificate error | Неверное время, устаревшие сертификаты или HTTPS-перехват. | Исправить часы, обновить корневые сертификаты, проверить антивирус. |
| Proxy authentication required | Прокси требует учётные данные. | Настроить системный и сервисный прокси по документации. |
| Network unreachable | Нет маршрута или отключён интерфейс. | Проверить шлюз, кабель, Wi-Fi/VPN и таблицу маршрутов. |
Разделяйте локальный обмен кассового ПО с ТС ПИоТ и внешний обмен сервиса с инфраструктурой маркировки. Подробнее: интернет, порты и брандмауэр.
Службы ЕСМ и ЛМ ЧЗ не запускаются
- Проверьте состояние служб в
services.msc. - Посмотрите тип запуска: автоматически или вручную.
- Откройте журнал событий Windows и найдите ошибку запуска.
- Убедитесь, что служебный порт не занят другим процессом.
- Проверьте права учётной записи службы и доступ к рабочей папке.
- Исключите конфликт старой и новой версии после обновления.
- Создайте точечные исключения антивируса, не отключая защиту полностью.
Для контроля используйте страницу службы Windows. Если служба запускается и сразу останавливается, ключевая причина обычно находится в её журнале, конфигурации или занятом порту.
Ошибки авторизации, регистрации и лицензии
Проблемы авторизации не ограничиваются неправильным паролем. Возможны неверная организация, отозванный токен, просроченная сессия, отсутствие роли, несовпадение зарегистрированной кассы или лицензии.
Не копируйте секрет из старого скриншота. Выпустите или обновите его штатным способом.
Проверьте организацию, пользователя, роль и доступ к конкретной кассе.
Сверьте регистрационные данные рабочего места и серийный номер.
Проверьте срок, количество касс, тариф и статус активации.
Большое расхождение времени ломает подписи, TLS и срок действия токена.
Тестовый токен не работает в продуктивном адресе и наоборот.
Ошибки проверки кода маркировки
Не каждое запрещающее сообщение означает сбой ТС ПИоТ. Сервис может корректно вернуть отрицательный результат из-за состояния самого кода или несоответствия товара.
| Ситуация | Что может означать | Действие кассира или специалиста |
|---|---|---|
| Код не найден | Код считан не полностью, отсутствует в системе или выбран неверный формат. | Повторно считать код, проверить сканер и карточку товара. |
| Товар уже выбыл | Код ранее продан, списан или выведен из оборота. | Не проводить продажу до выяснения статуса кода. |
| Продажа запрещена | Сработало правило разрешительного режима. | Показать покупателю корректное сообщение и отменить позицию. |
| GTIN не совпадает | Код маркировки не соответствует номенклатуре в чеке. | Проверить карточку товара, штрихкод и сопоставление GTIN. |
| Неверный формат Data Matrix | Сканер обрезал управляющие символы или программа изменила строку. | Проверить режим 2D-сканера и сырое значение в тестовом поле. |
| Нет результата проверки | Запрос выполняется, потерян идентификатор или истёк период ожидания. | Проверить логику повторного получения состояния. |
| Локальная проверка недоступна | ЛМ ЧЗ не запущен, база не обновлена или компонент не подключён. | Проверить службу Regime, контроллер и журналы. |
При отрицательном статусе не пытайтесь «обойти» проверку повторным созданием позиции. Сначала определите, является ли это технической ошибкой или корректным запретом.
Ошибки драйвера и состояния ККТ
Драйвер может успешно обнаруживать устройство, но не поддерживать необходимую операцию в текущей версии. Также важны прошивка, ФФД, открытая смена и состояние фискального накопителя.
- ККТ не найдена: проверьте USB/COM/Ethernet, порт, скорость и занятость устройства.
- Порт занят: закройте тест драйвера и другие программы, которые удерживают соединение.
- Смена закрыта или просрочена: проверьте кассовое состояние и выполните штатную операцию.
- Ошибка ФН: изучите состояние накопителя, срок и регистрационные данные.
- Неподдерживаемая команда: сверьте прошивку ККТ и версию драйвера.
- Разрядность не совпадает: 32-битное приложение может требовать соответствующую библиотеку даже на 64-битной Windows.
Для АТОЛ используйте инструкцию ДТО, для ШТРИХ/POSCenter — инструкцию драйвера. Актуальные сборки находятся на странице файлов.
Ошибки кассового и товароучётного ПО
Проверьте релиз конфигурации, БПО, подключаемое оборудование и сопоставление номенклатуры.
Проверьте версию Frontol, MarkUnit, драйвер ККТ и сценарий маркировки.
Проверьте приложение, версию ОС терминала, облачную регистрацию и связь.
Проверьте плагин, фронт-офис и правила работы общепита.
Проверьте кассовый модуль, рабочее место и поддерживаемую ККТ.
Логируйте запрос, ответ, статус, идентификатор и число повторов.
Если ошибка появляется только в одной программе, а тест драйвера и локального API проходит, наиболее вероятна проблема интеграции или настроек приложения.
Ошибки после обновления компонентов
Наиболее опасный сценарий — обновить один компонент, не проверив остальные. В текущем наборе файлов проекта указаны ЕСМ 1.6.3.2, ESM LM Controller 1.6.3.2, Regime 2.5.1-2, АТОЛ ДТО 10.10.8.24 и POSCenter 5.21.1.1277. Эти номера помогают сравнить среду, но не гарантируют совместимость любого ПО.
- Зафиксируйте версии до и после сбоя.
- Проверьте, не осталось ли двух версий службы или библиотеки.
- Сверьте разрядность компонентов.
- Перезапустите службы и компьютер.
- Проведите тест на одной кассе.
- Если проблема подтверждена, выполните контролируемый откат, а не случайную установку нескольких версий.
Матрица касс и программ: совместимость ТС ПИоТ.
Безопасные команды диагностики Windows
Запускайте PowerShell от имени администратора только когда это требуется. Названия служб и порты зависят от версии, поэтому сначала уточните их в документации.
Не публикуйте в открытом доступе токены, пароли, полные логи с персональными данными и секретные адреса внутренней сети.
Пошаговый алгоритм диагностики
Используйте один товар и одну кассу, сохраните точное время.
Считайте Data Matrix в текстовое поле и сравните полную строку.
Запустите тест связи драйвера, не оставляя тестовую программу подключённой.
ЕСМ и ЛМ ЧЗ должны работать и не завершаться после старта.
Убедитесь, что локальный адрес и порт доступны кассовой программе.
DNS, HTTPS, прокси, брандмауэр и системное время.
ККТ, прошивка, драйвер, кассовое ПО, ЕСМ и Regime.
Ищите первую ошибку по времени, а не десятки последующих следствий.
После одного изменения повторите тот же сценарий.
Что собрать для технической поддержки
- точную дату и время ошибки;
- полный текст, код и скриншот;
- название организации без публикации секретов;
- модель ККТ, прошивку и ФФД;
- версию и разрядность драйвера;
- название и релиз кассового ПО;
- версии ЕСМ, LM Controller и Regime;
- версию Windows и её разрядность;
- описание сети, прокси и антивируса;
- фрагмент журнала за несколько минут до и после ошибки;
- идентификатор запроса или correlation ID;
- результат воспроизведения на другом товаре или кассе.
Перед отправкой удалите токены, пароли, персональные данные и коммерчески чувствительную информацию.
Когда переустановка оправдана
Переустановка нужна после подтверждения повреждённых файлов, неудачного обновления или конфликта версий. До удаления сохраните конфигурацию, журналы и установщик предыдущего рабочего релиза.
Не используйте переустановку как первый шаг при сетевой ошибке, неправильном коде товара или несовместимой версии кассового ПО — в этих случаях она обычно не устраняет причину.
Частые вопросы
Можно ли просто перезапустить всё?
Перезапуск полезен как проверка, но сначала сохраните сообщение и журналы. Иначе временный эффект скроет причину.
Почему ошибка возникает только на одном товаре?
Вероятна проблема кода, GTIN, карточки номенклатуры или статуса экземпляра, а не всей установки.
Почему ошибка появилась после замены ФН?
Могли измениться регистрационные параметры, состояние кассы или привязка рабочего места. Сверьте данные и повторите регистрацию при необходимости.
Что означает тайм-аут?
Клиент не получил ответ вовремя. Причина может быть в локальной службе, внешней сети, прокси или перегрузке.
Нужно ли отключать антивирус?
Полностью отключать защиту не следует. Проверьте журнал блокировок и создайте точечные исключения для доверенных компонентов.
Где искать официальное описание конкретного кода?
В документации версии кассового ПО, API и производителя решения. Одинаковые тексты могут использоваться разными программами по-разному.
Связанные материалы
ТС ПИоТ не работает · сеть и порты · службы Windows · совместимость касс и ПО · актуальные файлы · вопросы сообщества.
Для форматов ответов API Эвотора можно использовать справочник ошибок маркировки. Всегда сопоставляйте описание с программой и версией, где появился код.