Почему маркировка отваливается на кассе: шесть правил кассового узла

Установка прошла, регистрация прошла, первые чеки с маркировкой ушли. А через неделю касса начинает отказывать — то посреди дня, то через раз, и без всякой видимой причины.

В инструкции разработчика ЕСМ есть шесть условий работы кассового узла. Это полезный порядок проверки, но без статистики нельзя утверждать, что он объясняет почти все отказы.

СимптомПроверить / сохранить
После остановки программы пропадает проверкаРаботу драйвера в течение смены, время остановки и журнал ЕСМ
Плавающий 407Источник кода, параллельные запросы, состояние позиции до повтора
514 / нет офлайн-путиКонтроллер и ЛМ на одном хосте; ready и последнюю синхронизацию
Не подключается ЛМРоль порта: контроллер 50063, прямой API ЛМ 5995
Сбой после обновленияВерсии и пути реально загруженных компонентов, требования комплекта
Проверка слишком долгаяВремя каждого этапа и общий таймаут клиента до увеличения лимитов

1. Драйвер — только из состава дистрибутива

Для описанной интеграции нужен специальный комплект драйвера с компонентами ЕСМ. Совместимость другой поставки нужно подтверждать отдельно: старший номер обычного ДТО тут не аргумент.

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

На практике это означает две вещи. Во-первых, нужна особая сборка с интеграционными компонентами: в обычном ДТО их нет, и добавить отдельно нельзя. Во-вторых, обновляя модуль, обновляйте и драйвер из того же дистрибутива, а не «самый свежий, какой нашёлся».

Установщик драйвера ККТ АТОЛ с отмеченным компонентом «Интеграционные компоненты для ЕСМ»
Правило первое начинается здесь: без компонента «Интеграционные компоненты для ЕСМ» связка не соберётся

Какую ошибку объясняет: модуль не видит кассу; проверка кодов не запускается вовсе.

2. Драйвер запущен всю смену

Речь об активном экземпляре драйвера в кассовом ПО, а не о постоянно открытом «Тесте драйвера». Утилита может занять порт и помешать штатной программе.

Экземпляр драйвера должен быть запущен при открытии смены, до первого фискального документа, и оставаться активным до её закрытия.

Остановка посреди смены разрывает аутентифицированный сеанс связи с кассой. Канал приходится инициализировать заново, а пока это не произошло, модуль не может получить данные кассы и корректно проверить товар.

И вот что делает эту ошибку особенно неприятной: пользователю она показывается как ошибка лицензии или как блокировка продажи маркированной продукции. Человек идёт проверять лицензию, а лицензия в порядке.

Какую ошибку объясняет: 403 «отсутствует активная лицензия» при действующей лицензии.

Проверить стоит настройки кассовой программы: некоторые останавливают драйвер между операциями ради экономии ресурсов. В связке с маркировкой такое поведение недопустимо.

3. Проверять коды последовательно

Проверка кода идёт двумя маршрутами — через ТС ПИоТ и через ОИСМ. Соблазн запустить оба сразу понятен: должно быть быстрее.

На деле параллельные вызовы увеличивают долю ответов ОИСМ, которые не успевают вернуться до фискализации. И дают плавающую ошибку: в момент проверки фискальный накопитель оказывается занят другим процессом.

Рекомендуемая схема — последовательная. Сначала ТС ПИоТ, дождаться ответа, затем ОИСМ. Можно и наоборот, но строго по очереди.

Последовательность исключает одновременное обращение к занятому ресурсу. Быстрее от этого не станет: время складывается из обоих путей проверки и их таймаутов.

Перед повтором неудавшейся проверки прочитайте состояние позиции и документа. Не повторяйте уже завершённый расчёт. Задержка между запросами сама по себе не устраняет причину конкурирующих обращений.

4. Контроллер — рядом с локальным модулем

Контроллер ЛМ ЧЗ должен быть установлен на том же компьютере, где размещён локальный модуль «Честного знака». Установка на отдельной машине нарушает регламент взаимодействия и не поддерживается.

Здесь же два дополнительных требования, которые легко упустить:

Не менять порт контроллера. В интерфейсе ЕСМ он должен неизменно оставаться 50063. Соседний 5995 — это порт самого локального модуля, и вписывать его в настройки модуля нельзя. Разбор этой пары — частая причина потерянного вечера.

Проверьте процессы, их версии, пути и владельцев портов. Отличите нужные экземпляры от оставшихся после обновления; не завершайте все контроллеры по одному совпадению имени процесса.

Какую ошибку объясняет: 514 в части офлайн-проверки, «нет связи с ЛМ ЧЗ», статус «не отконфигурирован».

5. Держать актуальные версии

Каждый релиз подхватывает обновления протокола ЦРПТ и добавляет поддержку новых схем работы. Протокол меняется на стороне системы маркировки, и старая сборка рано или поздно перестаёт с ней договариваться.

На странице загрузки размещён комплект 1.6.4.0. Требования к минимальным версиям смотрите в инструкции выбранной ОС и интеграции; а выложенная где-то копия не обязательно самая свежая.

Отдельно про порядок: перед обновлением ЛМ ЧЗ до версии 2.0 сначала обновляют компоненты ЕСМ до 1.6. В обратном порядке ТС ПИоТ может не обнаружить новый локальный модуль. И если контроллер живёт на отдельной машине, его обновляют вручную.

Какую ошибку объясняет: сбои после обновления одного компонента без другого; необъяснимые отказы на старых сборках.

ЕСМ: лицензия, статус ЛМ и кнопка логов
ЕСМ 1.6.3.2-prod: статус ЛМ «Готов к работе», версия ЛМ 2.6.1-7 и кнопка «Сохранить логи». Поле последней синхронизации ЛМ на снимке пустое; дата внизу относится к ГИС МТ.

6. Не блокировать адреса ЦРПТ и сервисной платформы

Блокировка сетевых ресурсов межсетевым экраном даёт целый набор закономерных ошибок, каждая из которых выглядит как неисправность модуля.

Нужен доступ к регистрационному узлу системы маркировки, к сети раздачи ЦРПТ и к двум адресам сервисной платформы, откуда приходит лицензия. Полный перечень для белого списка собран в статье про установку модуля.

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

Какую ошибку объясняет: лицензия не приходит; регистрация не завершается; проверки не проходят ни разу.

Как этим пользоваться

Пройдите список и сопоставьте результат с журналом конкретного сбоя. Порядок ниже не является статистикой частоты причин.

  1. Не останавливает ли кассовая программа драйвер между операциями?
  2. Не идут ли проверки параллельно двумя маршрутами?
  3. Тот ли драйвер стоит и та ли у него версия?
  4. Где контроллер и какой порт указан в настройках?
  5. Если проблема появилась после обновления, сравните фактический состав комплекта с его требованиями. Совпадение номеров ЕСМ и ДТО не является критерием совместимости.
  6. Что с доступом к сети?

Начните с активности драйвера и порядка проверок, затем проверьте комплект версий, контроллер и сеть. Причину подтверждайте журналом и повторной проверкой после исправления.

Частые вопросы

Касса работала, затем появились отказы. Сопоставьте время первого сбоя с обновлениями, изменениями сети, лицензий и состояния ЛМ. Версию о причине проверяйте по журналам; без статистики нельзя назвать один вариант самым частым.

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

Можно ли поставить контроллер на сервер, а ЛМ ЧЗ на кассу? Нет. Они размещаются вместе, это требование регламента.

Обязательно ли обновляться, если всё работает? Пока работает — нет. Но протокол ЦРПТ меняется, и запас по версии стоит держать заранее, а не в день, когда всё встало.

Коротко

Проверьте согласованный комплект, активность драйвера в кассовом ПО на протяжении смены, последовательность обращений, размещение контроллера рядом с ЛМ и сетевой доступ. Единичную ошибку внешнего узла можно считать отработанной только после успешного завершения проверки.


Материал носит информационный характер. Сайт atoldriver.ru не является представительством компании АТОЛ или АО «ЕСП» и не оказывает услуг по обслуживанию оборудования.