Коды без официального разбора: справочник

Как проявляется

• Касса возвращает код, которого нет ни в одной инструкции
• Поиск по коду ошибки не даёт внятного ответа
• Ошибка возникает эпизодически и не привязана к конкретному товару
• Код виден только в логе модуля, а кассовая программа показывает общее сообщение

Вероятные причины

• •Внутренние ошибки модуля, не вынесенные в публичную документацию
• •Сбои на стороне серверов оператора или системы маркировки
• •Устаревшая версия модуля, драйвера ККТ или кассового ПО
• •Локальные проблемы окружения: службы, права, антивирус, VPN и прокси
• •Нестабильная связь, из-за которой запрос обрывается на полпути

Как исправить — по шагам

1. 1

   Сначала загляните в справочник — возможно, код уже известен

   Собрали расшифровки, которых нет в инструкциях. 2001 — неизвестный тип ошибки gRPC при подключении к ЛМ контроллеру: проверяйте доступность контроллера и его порт. 2030 — ошибка шифрования в фискальном накопителе при установке контролируемого канала; почти всегда идёт вместе с «Client is not found», разбор в отдельной статье. 2049 — не удалось подключиться к CDN-площадке оператора (обращение к внешнему адресу на порт 19101): смотрите сеть, прокси и антивирус. 2052 — операция прервана по превышению времени ожидания ответа: чаще всего медленный канал или занятая касса. 2055 — модуль не видит локальный модуль, хотя тот сообщает о готовности. 203 — ответ по коду товара, который модуль не может обработать штатно; переводит модуль в аварийный режим. 401 и 4010 — «not authorized» при инициализации: истёк или неверен токен. 404 — модуль не находит локальный модуль по указанному адресу. 410 — устаревшая версия API: обновляйте связку целиком, а не одну часть. 501 — ошибка разбора запроса, встречается при закрытии чека в отдельных версиях кассовых программ. 503 — сервис временно недоступен, обычно проходит сам. 12157 и 12175 — не коды модуля, а системные ошибки защищённого соединения Windows: смотрите сертификаты, дату и время, антивирус с проверкой HTTPS. −100 — ошибка чтения данных из драйвера ККТ, сторона кассы, а не модуля.

2. 2

   1. Отделите разовый сбой от системного

   Отсканируйте код повторно, затем другой маркированный товар, затем проверьте вторую кассу точки, если она есть. Разовый сбой на одном коде и системная проблема на всех кассах лечатся совершенно по-разному.

3. 3

   2. Пройдите универсальный порядок

   Перезапустите три службы модуля («ESM: Control Module», «ESM: Local Module Controller», «ESM: Orchestrator»), проверьте, что приложение ЕСМ не запущено дважды, что драйвер ККТ работает, а лицензия активна. Этот набор закрывает большую часть неописанных кодов.

4. 4

   3. Обновите модуль

   Разработчик регулярно чинит ошибки обмена: по данным «Честного знака», актуальная версия закрывает до 95 % возникающих сбоев. Скачайте свежую сборку в кабинете оператора и обновите модуль вместе с драйвером ККТ.

5. 5

   4. Исключите сеть и защиту

   Проверьте, не режет ли запросы антивирус, брандмауэр, VPN или прокси. Если IP кассы определяется как другая страна или дата-центр — это почти наверняка причина.

6. 6

   5. Соберите пакет для поддержки

   Если не помогло, обращение решается быстрее с полным набором: ИНН организации, модель и регистрационный номер ККТ, версия Windows, версии модуля и кассового ПО, адрес и порт подключения, точное время сбоя, скриншот ошибки и логи модуля за этот период. Или оставьте заявку — соберём и разберём это за вас, а при необходимости доведём обращение до оператора.