Коды ошибок ТС ПИоТ: причины и способы устранения
Справочник ошибок ТС ПИоТ и типовых ответов API: состояние запроса, сеть, авторизация, маркировка и локальный сервис.
StateCheckNotFound
Один из встречающихся сценариев — запрос принят, но результат проверки ещё не готов. В таком случае сервис может вернуть статус ожидания. Правильное действие — повторить запрос позже в соответствии с API, а не создавать новый запрос бесконечно.
Ошибки сети
Проверьте доступность локального сервиса, DNS, интернет, прокси и брандмауэр. Для локального API сначала проверяйте localhost, затем внешний доступ.
Ошибки авторизации
Сверьте токен, учётные данные, срок действия и место хранения секретов. Не копируйте токены из старых скриншотов: они могли быть отозваны.
Ошибка проверки маркировки
Проверьте сам код Data Matrix, карточку товара, наличие товара в системе маркировки и корректность данных в чеке. Ошибка в чеке не всегда означает ошибку ТС ПИоТ.
Диагностический алгоритм
- Сохранить точный текст/код ошибки.
- Зафиксировать время возникновения.
- Проверить службу.
- Проверить сеть.
- Проверить драйвер ККТ.
- Сравнить версии ПО.
- Повторить тест одним контролируемым сценарием.
Официальный перечень ответов API Эвотора можно использовать как пример формата: список ошибок.
Связанные материалы
Полный справочник ТС ПИоТ · совместимость · ошибки · файлы и драйверы.