У совместимости драйвера АТОЛ две границы, и обе снизу. Первая — версия самого драйвера: старый не умеет того, что появилось позже. Вторая — версия прошивки кассы: даже свежий драйвер не сделает того, что не поддерживает железо.
Отсюда самая частая ошибка: человек обновляет драйвер, функция не появляется, и он решает, что обновление не встало. На самом деле упёрлось в прошивку.
Все данные ниже собраны из официального файла истории версий, который поставляется вместе с дистрибутивом драйвера, и из заголовочного файла версии 10.10.9.0.
Платформа прошивки: жёсткие границы
Это первое, что нужно проверить. Здесь не «работает хуже», а «не подключится вообще».
| Платформа ККТ | Какой драйвер подходит |
|---|---|
| 2.5 | ДТО 10 до версии 10.10.2.0 включительно. Начиная с 10.10.3.0 поддержка прекращена |
| 5.x | Только ДТО 10. Восьмая версия драйвера с платформой 5 не работает |
Поддержку Платформы 2.5 убрали в релизе 10.10.3.0 от 26 апреля 2024 года — это прямая запись в официальной истории, а не наблюдение.
Практический вывод: если касса на платформе 2.5 и её пока не обновляют, драйвер новее 10.10.2.0 ставить нельзя. При попытке подключения появится ошибка «[11] Не поддерживается в данной версии». Разбор ситуации — в статье про отсутствие связи с ККТ.
Адаптация под версии ПО ККТ
Каждый раз, когда выходила заметная версия прошивки, драйвер под неё адаптировали. Если у вас свежая прошивка, а драйвер старее указанного — возможны сбои.
| Версия ПО ККТ | Драйвер, адаптированный под неё | Дата |
|---|---|---|
| 5.7.3 | 10.6.3.0 | 12.03.2020 |
| 5.7.20 | 10.8.1.0 | 20.02.2021 |
| 5.8.30 | 10.9.3.1 | 07.06.2022 |
| 5.8.100 | 10.9.4.0 | 14.11.2022 |
| 5.17.0 и новее | 10.10.9.0 — рекомендованная связка | 30.06.2026 |
Функции, которым мало обновить драйвер
Самая полезная таблица на этой странице. Здесь собраны возможности, которые прямо помечены в официальной истории как зависящие от версии прошивки.
| Функция | Нужен драйвер | Нужна прошивка |
|---|---|---|
| Запрос статистики канала связи | 10.10.9.0 | Новее 5.17.xx |
| Печать отчёта статистики канала связи | 10.10.9.0 | Новее 5.17.xx |
| Запрос состояния печатающего устройства | 10.10.9.0 | Новее 5.17.xx |
| Запрос времени работы ККТ | 10.10.5.0 | Версии 5.X |
| Печать итогов регистрации | 10.5.1.0 | Версии 5.X |
Три верхние строки — это ровно тот случай, ради которого таблица и написана. В релизе 10.10.9.0 добавили четыре новые возможности, и три из них не работают на прошивках 5.17.xx и более ранних. Драйвер обновится, версия в заголовке окна сменится, а функций не будет.
С какой версии драйвера доступна функция
Таблица для тех, кто пишет интеграцию. Указана версия, в которой возможность была добавлена по официальной истории релизов.
| Возможность | Метод или константа | С версии | Дата |
|---|---|---|---|
| Статистика каналов связи | LIBFPTR_DT_COMMUNICATION_CHANNEL_STAT | 10.10.9.0 | 30.06.2026 |
| Состояние печатающего устройства | LIBFPTR_DT_PRINTER_STATUS | 10.10.9.0 | 30.06.2026 |
| Исполнение блока управления | LIBFPTR_PARAM_UNIT_VARIANT | 10.10.9.0 | 30.06.2026 |
| Наименование позиции при авансе | LIBFPTR_SETTING_USE_COMMODITY_NAME_FOR_ADVANCE | 10.10.8.0 | 09.12.2025 |
| Информация о загруженных шаблонах | LIBFPTR_DT_SCRIPTS_INFO | 10.10.8.0 | 09.12.2025 |
| Настройка часовой зоны для уведомлений | LIBFPTR_SETTING_TIME_ZONE | 10.10.7.0 | 30.06.2025 |
| Считывание всех лицензий с номером | LIBFPTR_DT_LICENSE_ACTIVATED | 10.10.7.0 | 30.06.2025 |
| Статус уведомлений из ФН | LIBFPTR_FNDT_NOTIFICATION_STATUS | 10.10.6.0 | 18.12.2024 |
| Контроль размера чека | LIBFPTR_PARAM_RECEIPT_SIZE | 10.10.6.0 | 18.12.2024 |
| Пробег чековой ленты | LIBFPTR_DT_RECEIPT_TAPE_PATH_LENGTH | 10.10.5.0 | 18.09.2024 |
| Время работы ККТ | LIBFPTR_DT_DEVICE_UPTIME | 10.10.5.0 | 18.09.2024 |
| Очистка таблицы проверенных КМ | clearMarkingCodeValidationResult() | 10.10.3.0 | 26.04.2024 |
| Реквизит пользователя в уведомлении о КМ | тег 1084 в writeSalesNotice() | 10.10.3.0 | 26.04.2024 |
| Форма фискального документа у позиции | LIBFPTR_PARAM_REGISTRATION_POSITION_FORM | 10.10.1.0 | 28.11.2023 |
| Признаки вендинга и общепита | LIBFPTR_PARAM_VENDING, LIBFPTR_PARAM_CATERING | 10.10.1.0 | 28.11.2023 |
| Поиск документа в журнале | findDocumentInJournal() | 10.10.0.0 | 28.06.2023 |
| Проверка доступности свойства | isParamAvailable() | 10.10.0.0 | 28.06.2023 |
| Проверка КМ без отправки на сервер | LIBFPTR_PARAM_MARKING_NOT_SEND_TO_SERVER | 10.9.5.0 | 31.03.2023 |
| Признак регистрации кассира | LIBFPTR_PARAM_OPERATOR_REGISTERED | 10.9.5.0 | 31.03.2023 |
| Флаги разрешённых операций | LIBFPTR_DT_AVAILABLE_OPERATIONS | 10.9.5.0 | 31.03.2023 |
| Сменные итоги по секциям | LIBFPTR_DT_DEPARTMENT_SUM | 10.9.4.0 | 14.11.2022 |
| Занятое место в ФН под документ | LIBFPTR_FNDT_RECEIPT_SIZE | 10.9.4.0 | 14.11.2022 |
| Температура кристалла микроконтроллера | LIBFPTR_DT_MCU_TEMPERATURE | 10.9.4.0 | 14.11.2022 |
| Форматированная печать текста | LIBFPTR_PARAM_FORMAT_TEXT | 10.9.4.0 | 14.11.2022 |
| Внесение и выплата без печати квитанции | LIBFPTR_PARAM_DOCUMENT_ELECTRONICALLY | 10.9.3.1 | 07.06.2022 |
| Тихая перезагрузка | LIBFPTR_SETTING_SILENT_REBOOT | 10.9.3.1 | 07.06.2022 |
| Запрос URI ОКП | LIBFPTR_FNDT_FN_INFO | 10.9.2.6 | 15.03.2022 |
| Последний успешный ОКП | LIBFPTR_PARAM_LAST_SUCCESSFUL_OKP | 10.9.2.0 | 27.01.2022 |
| Адрес модуля и сегмента | LIBFPTR_DT_MODULE_ADDRESS | 10.9.2.0 | 27.01.2022 |
| Проверка сервера маркировки | pingMarkingServer() | 10.9.2.0 | 27.01.2022 |
| Печать текста рядом с QR-кодом | параметр методов печати | 10.9.2.0 | 27.01.2022 |
| Информация о микроконтроллере | LIBFPTR_DT_MCU_INFO | 10.9.0.0 | 22.07.2021 |
| Тип документа в статусе | LIBFPTR_PARAM_DOCUMENT_TYPE | 10.9.0.0 | 22.07.2021 |
| Количество ФД за смену | LIBFPTR_FNDT_DOCUMENTS_COUNT_IN_SHIFT | 10.8.1.0 | 20.02.2021 |
| Инвертирование состояния денежного ящика | LIBFPTR_SETTING_INVERT_CASH_DRAWER_STATUS | 10.6.0.0 | 15.10.2019 |
| Разбор кода маркировки | parseMarkingCode() | 10.6.2.0 | 30.01.2020 |
Оговорка: таблица построена по строкам «Добавлен…» из официальной истории. Если возможности в ней нет, это не значит, что её нет в драйвере — значит, её появление не было отмечено отдельной строкой релиза.
Модели ККТ: с какой версии поддерживаются
| Модель | Поддержка с версии | Дата |
|---|---|---|
| АТОЛ 20 v2 Ф | 10.10.9.0 | 30.06.2026 |
| АТОЛ 2Ф | 10.10.7.0 | 30.06.2025 |
| АТОЛ 35Ф | 10.10.3.5 | 01.07.2024 |
| АТОЛ СТБ 6 | 10.10.3.0 | 26.04.2024 |
| АТОЛ 42 ФА | 10.9.4.0 | 14.11.2022 |
| АТОЛ ПТ-5Ф | 10.9.3.1 | 07.06.2022 |
| АТОЛ 22 v2 Ф | 10.8.1.0 | 20.02.2021 |
Модели, появившиеся раньше, поддерживаются всеми актуальными версиями драйвера — ограничение здесь скорее сверху, со стороны платформы прошивки.
Вехи по требованиям
| Что | С какой версии | Дата |
|---|---|---|
| Поддержка ФФД 1.2 в драйвере | 10.9.0.0 | 22.07.2021 |
| ФФД 1.2 при работе с 1С | 10.9.0.4 | 27.08.2021 |
| ФФД 1.2 в веб-сервере, JPOS и OPOS | 10.9.1.0 | 29.10.2021 |
| Автоматическая подача меры количества (тег 2108) | 10.9.0.5 | 22.09.2021 |
| Обновлённая система лицензирования ПО ККТ | 10.10.0.0 | 28.06.2023 |
| Ставка НДС 22 % и расчётная 22/122 | 10.10.8.0 | 09.12.2025 |
Отдельно про маркировку
Сборки 10.10.8.23 и 10.10.8.24 в эти таблицы не входят, и это не упущение: в официальной истории релизов их нет вовсе. Это отдельные версии с компонентами ЕСМ, необходимыми для работы ТС ПИоТ.
Из этого следует правило, которое экономит много времени: более новая версия не заменяет сборку с ЕСМ. Обычный 10.10.9.0 компонентов маркировки не содержит, и поставить «что посвежее» вместо дистрибутива с ЕСМ не получится.
Как этим пользоваться
Идите сверху вниз. Сначала платформа прошивки — она задаёт коридор возможных версий драйвера. Потом версия ПО ККТ — она определяет, какие функции вообще доступны. И только потом версия драйвера.
При планировании обновления смотрите обе границы. Если нужна функция из третьей таблицы, обновления драйвера мало: понадобится и прошивка, а её обновляют через сервисный центр.
Проверьте релизную лицензию. Прошивка не поднимется выше той версии, которую допускает записанная в кассу релизная лицензия. Как её посмотреть — в статье про ошибки лицензий ККТ.
Перед сменой версии удалите старую полностью. Установка поверх — самая частая причина того, что касса перестаёт определяться: в системе остаются библиотеки от предыдущей версии, и обращения к кассе уходят не туда.
Полная хронология релизов с описанием каждого — в истории версий ДТО 10.
Частые вопросы
Драйвер обновил, функция не появилась. Смотрите третью таблицу: скорее всего, функция требует ещё и обновления прошивки кассы.
Какая версия драйвера самая безопасная? Та, что адаптирована под вашу прошивку. Гнаться за последней смысла нет: новые возможности всё равно упрутся в возможности кассы.
Можно поставить старый драйвер на новую кассу? Можно, но с ограничениями. Касса на платформе 5 не будет работать с ДТО 8 вовсе, а с ранними версиями ДТО 10 — с оговорками по функциям.
Где посмотреть версию прошивки? В отчёте «Информация о ККТ» или через драйвер. Версия драйвера видна в заголовке окна «Тест драйвера ККТ».
Коротко
Проверяйте две границы, а не одну. Платформа 2.5 не работает с драйверами от 10.10.3.0, платформа 5 не работает с ДТО 8. Три функции из релиза 10.10.9.0 требуют прошивки новее 5.17.xx — обновление драйвера само по себе их не включит. Поддержка ФФД 1.2 появилась в 10.9.0.0, ставка НДС 22 % — в 10.10.8.0. А сборки с компонентами ЕСМ для маркировки живут вне общей нумерации, и новая версия их не заменяет.
Материал носит информационный характер. Сайт atoldriver.ru не является представительством компании АТОЛ. Данные приведены по официальному файлу истории версий и заголовочному файлу из дистрибутива драйвера 10.10.9.0.