«Тест драйвера ККТ»: разбор всех разделов и параметров

«Тест драйвера ККТ» — утилита АТОЛ для проверки соединения, чтения состояния и настройки кассы. Она идёт в комплекте ДТО. USB-драйвер устройства — это другое, одно вместо другого не подставишь.

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

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

Где скачать: выберите комплект ДТО для Windows, а при интеграции с ЕСМ — специальную сборку ТС ПИоТ. Установите утилиту из выбранного пакета и найдите «Тест драйвера ККТ» в меню «Пуск». Если ярлыка нет, проверьте состав установки и каталог KKT\Bin; имя приложения — fptr10_t.exe.

Главное окно утилиты «Тест драйвера ККТ»
Слева — разделы, в центре — рабочая область, справа — состояние кассы и быстрые действия

Где лежит утилита

Ниже пример пути x86-установки. При другом каталоге или архитектуре путь изменится:

C:\Program Files (x86)\ATOL\Drivers10\KKT\Bin\fptr10_t.exe

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

Выберите задачу

ЗадачаДействиеЧто меняется
Связь«Свойства → Проверка связи»; сверить модель и номерПроверка соединения; продажа не нужна.
ВерсииВерсия утилиты; отдельно сведения о ККТ и компоненте приложенияЧтение. Версии разных компонентов не обязаны совпадать.
Очередь ОФД«ФН → Статус информационного обмена с ОФД»; подробная проверкаЧтение количества и даты первого непереданного ФД.
СменаСначала прочитать состояние и длительностьОткрытие/закрытие смены — отдельные фискальные операции.
МаркировкаПроверить маршрут через ЕСМСтатус утилиты не заменяет проверку из кассовой программы.
Настройки«Параметры ККТ»: сначала считать и сохранить копиюПри сохранении записываются параметры кассы.
Чек, регистрация, ФНПерейти к профильной инструкции перед командойКоманды меняют фискальное состояние; для знакомства их не выполняют.

Правая панель: состояние и быстрые действия

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

Кнопка «Свойства» открывает настройки подключения. С неё начинается любая работа.

Галочка «Включено» — переключатель связи. Пока она не стоит, на любое действие утилита отвечает «Соединение не установлено», даже если проверка связи только что прошла успешно. На этом спотыкаются постоянно.

Ниже, после подключения, появляется живое состояние кассы:

  • время работы ККТ — сколько аппарат непрерывно включён;
  • ширина ленты в символах и точках;
  • состояние смены — открыта или закрыта;
  • состояние чека — открыт или закрыт.

Дальше идут поля «Кассир» и «ИНН кассира» с кнопкой «Регистрация кассира». Их заполняют перед фискальными операциями: эти данные попадают в чек как обязательные реквизиты. Подробнее — в статье про кассиров и ИНН в чеке.

Ниже — четыре кнопки, которые спасают в аварийных ситуациях:

КнопкаНазначение и границы
Статус документаЧтение результата операции: отдельно закрытие документа и завершение печати
ДопечататьВозобновление незавершённой печати; сначала проверить статус
Отменить документОперация над открытым документом; уже закрытый фискальный чек не отменяет
Сервисная информацияСохранение выбранных сведений в файл; проверить состав архива перед передачей
Фактические пути журналов ДТО
«Информация о логах» в ДТО АТОЛ 10.10.8.24, Windows 11. Пути относятся к текущему пользователю процесса. Это пути журналов текущего процесса ДТО, а не отдельной службы EoU.

Свойства: настройка подключения

Здесь три группы параметров.

Устройство. Модель ККТ — можно выбрать конкретную или оставить «Автоматически (АТОЛ)».

Параметры подключения. Канал связи (USB, COM/VCOM, TCP/IP, Bluetooth), номер порта, IP-адрес и порт, скорость обмена. Отдельно — «Способ связи ДККТ с ОФД/ИСМ»: этот параметр определяет, как драйвер участвует в обмене с оператором.

Как выбрать канал и что делать, если касса не отвечает, разобрано в статье про настройку связи с ККТ.

Свойства подключения с раскрытым списком COM-портов
Названия интерфейсов в показанном примере; нумерация proxy не заменяет проверку назначения и номера ККТ.

Дополнительно. Здесь прячется десяток настроек, о которых мало кто знает:

  • Автоматически восстанавливать связь с ККТ — драйвер сам переподключается при обрыве;
  • Инвертировать состояние денежного ящика — для ящиков с обратной логикой датчика;
  • Для проверки КМ использовать прямой доступ к ФН-М;
  • Автоматически передавать меру количества (тег 2108) на все позиции;
  • Тихая перезагрузка — касса перезапускается без звуковых сигналов;
  • Объединять позиции в ПФ — склейка одинаковых позиций в печатной форме;
  • Автоматическая синхронизация времени при открытии смены с настраиваемым пределом допустимого расхождения;
  • Часовая зона — используется при формировании уведомлений о маркировке;
  • Передавать наименование позиции (тег 1030) при оплате авансом.

Внизу окна — поле «Результат» и три кнопки: «Поиск» (автоопределение подключённой кассы), «Проверка связи» и «Параметры ККТ».

Параметры ККТ: что программируется в самой кассе

Это отдельное окно, и важно понимать разницу. Свойства — настройки драйвера на вашем компьютере. Параметры ККТ — то, что записывается в саму кассу и остаётся там независимо от компьютера.

Ниже пример разделов. Состав полей и доступность команд зависят от модели ККТ, прошивки и версии утилиты:

№РазделЧто внутри
1ОсновныеДенежный ящик, звуковые сигналы, ширина бумаги, СНО по умолчанию, учёт наличности
2Канал связиEthernet, Wi-Fi, Bluetooth, GSM, скорость, время ожидания интерфейсов
3ОплатыТипы оплат и их наименования
5ПечатьПараметры печати документов
6Настройки отчетовСостав и вид отчётов
7ШрифтЯркость печати ЧЛ, межстрочный интервал, компенсация промотки
8Пользователи и паролиИмя и ИНН кассира по умолчанию
9КлишеШапка и подвал чека
11Wi-FiПараметры беспроводной сети
13Настройки ТПМВключить отрезчик, приоритет качества печати, полный отрез
14НалогиНалоговые ставки
15ОФДАдрес и порт оператора, канал обмена, интервал ожидания квитанции
19ДиагностикаСлужебные параметры
26Работа с КМАдрес и порт ИСМ, адрес ОКП, повторы и тайм-ауты проверки кодов
27Название секцийНаименования отделов
Параметры ККТ с раскрытым разделом ОФД
Раздел «15 ОФД»: адрес, порт и канал обмена с оператором

«Импорт» и «Экспорт» позволяют сохранить параметры, но не являются безопасным клонированием кассы. Перед переносом сверяйте каждое поле: адреса, модельные настройки и регистрационные реквизиты другого аппарата нельзя копировать вслепую. Настройки соединения драйвера храните отдельно от параметров самой ККТ.

Сохранение раздельное: «Сохранить и выйти» записывает изменения в кассу, «Выйти без сохранения» — нет. Кнопку легко перепутать, поэтому проверяйте, что нажимаете.

Разделы левого меню

Информация о ККТ. Полсотни запросов о состоянии: заводской номер, версии, счётчики чеков и сумм, ресурс отрезчика и термоголовки, температура, MAC-адрес, состояние источника питания, пробег ленты. Что из этого зачем — в статье про счётчики кассы.

Регистрация ККТ. Реквизиты организации, система налогообложения, признаки работы (маркированные товары, подакцизный товар, автономный режим и прочие), версия ФФД, реквизиты ОФД и адрес ИСМ. Кнопки: «Считать», «Регистрация», «Перерегистрация», «Закрытие ФН», «Замена ФН». Порядок действий — в статье про регистрацию и перерегистрацию ККТ.

Чек. Формирование кассового чека: тип, позиции, оплата, маркировка, основание коррекции. Полный порядок — в статье про то, как пробить чек через драйвер.

Раздел «Чек» в утилите
Все поля позиции и кнопки открытия и закрытия чека на одном экране

Отчёты. X-отчёт, отчёт о закрытии смены, отчёт о состоянии расчётов, печать информации о ККТ, тест связи с ОФД, печать копии последнего документа и печать документа по номеру из ФН.

Внесения / выплаты. Служебное внесение и изъятие наличных из ящика.

Печать. Нефискальная печать: текст, штрихкоды, картинки.

Маркировка. Проверка кодов, состояние проверки в ФН и в ККТ, проверка связи с ИСМ, очистка буфера, состояние очереди отправки. Разбор отказов — в статье про ошибки маркировки.

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

Универсальные счётчики. Настройка и чтение пользовательских счётчиков.

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

Список типов данных в разделе ФН
Все запросы к накопителю собраны в одном выпадающем списке

Нижний уровень. Отправка произвольных команд протокола. Только для сервисных специалистов.

Сервисные. Дата и время, технологическое обнуление, перезагрузка, выключение, инициализация, управление каналом EthernetOverTransport.

ПО ККТ. Работа с прошивкой кассы.

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

Шаблоны ККТ. Загружаемые шаблоны чеков и отчётов.

Чтение данных. Введённые лицензии, документы из ФН, настройки, регистрационные данные.

БД документов, Работа с json, Скрипты драйвера. Инструменты для интеграции: формирование чеков заданиями в формате JSON и выполнение скриптов.

Лог. Журнал работы драйвера — первое, что просят в поддержке.

Чтение архива ФН, Чтение уведомлений ФН, Чтение документов ФН. Раньше это были отдельные утилиты FnArchiveReader и FnDocReader, но с версии драйвера 10.10.3.0 их убрали из дистрибутива, а функции перенесли сюда.

Дамп. Снятие дампа памяти для диагностики.

С чего начинать

Порядок один и тот же почти для любой задачи:

  1. «Свойства» → выбрать модель и канал связи → «Проверка связи». В поле «Результат» должны появиться модель и серийный номер.
  2. Закрыть окно свойств и поставить галочку «Включено».
  3. Убедиться, что в правой панели появилось состояние кассы.
  4. Дальше — в нужный раздел.

Если на первом шаге связи нет, дальше идти бесполезно: разбор причин собран в статье про отсутствие связи с ККТ.

Общая информация о реальной ККТ
ДТО АТОЛ 10.10.8.0, АТОЛ 25Ф: результат запроса общей информации, прошивка 5.15.102; номер устройства закрыт в исходнике.

Чего лучше не трогать

Утилита ничем не ограничивает пользователя, и часть кнопок делает необратимые вещи.

Технологическое обнуление сбрасывает счётчики и настройки кассы. Иногда это нужно, но не «посмотреть, что будет».

Закрытие ФН завершает работу накопителя. Обратного хода нет — только замена. Порядок описан в статье про ресурс ФН.

Регистрация и перерегистрация меняют фискальные данные кассы и требуют согласования с личным кабинетом ФНС.

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

Чтение состояния и выполнение операции — разные действия. Запросы состояния и чтение данных используют для диагностики. Изменение параметров записывает настройки в ККТ. Открытие и закрытие смены, регистрация и закрытие чека формируют фискальные документы. Кнопки печати и управления документом тоже выполняют операции, поэтому перед нажатием смотрите назначение команды.

Если печать прервалась, сначала проверьте отдельно, закрыт ли фискальный документ и завершена ли печать. В API ДТО 10 для этого используется checkDocumentClosed() с параметрами LIBFPTR_PARAM_DOCUMENT_CLOSED и LIBFPTR_PARAM_DOCUMENT_PRINTED. Уже закрытый ФД не отменяется кнопкой «Отменить документ»: восстановите печать, не оформляя ту же продажу повторно.

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

Утилита не запускается. Проверьте, установлен ли драйвер целиком, а не только USB-компонент: в урезанной установке утилиты нет.

Кнопки неактивны. Не стоит галочка «Включено» либо не настроено подключение.

Можно работать при запущенной кассовой программе? При прямом доступе к одному COM-порту его обычно занимает один процесс. Освободите соединение в штатном ПО перед диагностикой и верните после неё. В серверной схеме доступ распределяет сервер; возможность совместной работы зависит от транспорта, а не от одного факта запуска двух программ.

Где взять лог для поддержки? Раздел «Лог» плюс кнопка «Информация о логах» в правой панели.

Коротко

Работа начинается со «Свойств» и галочки «Включено». Свойства соединения относятся к драйверу на компьютере, параметры ККТ — к настройкам самой кассы. Для первого знакомства ограничьтесь читающими запросами. Перед операциями с чеком, сменой, регистрацией или ФН прочитайте соответствующую инструкцию: эти команды меняют состояние кассы, а часть из них необратима.


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