Совместимость проверяют по сочетанию модели, платформы, прошивки ККТ и версии драйвера. Ограничения бывают с обеих сторон: старый драйвер не поддерживает новые функции, а новый может прекратить поддержку старой платформы. Например, поддержка платформы 2.5 прекращена с ДТО 10.10.3.0. Так что «взять самый свежий» — не стратегия: старший номер совместимости не обещает.
Таблица API ниже показывает зафиксированные упоминания в комплектной истории, а не доказанную первую доступную реализацию. Более ранние записи найдены для LIBFPTR_DT_DEVICE_UPTIME в 10.10.3.0, parseMarkingCode() и LIBFPTR_DT_SCRIPTS_INFO в 10.5.0.0. Доступность конкретного метода проверяйте по документации своей версии.
Если функция не появилась, проверьте все условия её поддержки: модель, прошивку, библиотеку в приложении, лицензию и параметры вызова. Сам факт обновления утилиты не определяет причину.
Все данные ниже собраны из официального файла истории версий, который поставляется вместе с дистрибутивом драйвера, и из заголовочного файла версии 10.10.9.0.
| Что проверяем | Источник и граница вывода |
|---|---|
| Добавление модели | Комплектная история ДТО 10.10.9.0, записи с датами ниже: подтверждает упоминание поддержки, а не все функции модели. |
| Метод/константа API | Заголовок и руководство ДТО 10.10.9.0; контракт и параметры нужной версии. |
| Функция ККТ | Руководство конкретной модели и примечание к прошивке; неподтверждённое сочетание не считать испытанным. |
| Кассовое ПО, лицензия, ФФД | Требования приложения, прочитанные реквизиты ККТ и лицензии соответствующей операции. |
| ЕСМ | Отдельный комплект: инструкция Windows 2.1 от 27.07.2026; номера общей ветки недостаточно. |
Платформа прошивки: жёсткие границы
Это первое, что нужно проверить. Здесь не «работает хуже», а «не подключится вообще».
| Платформа ККТ | Какой драйвер подходит |
|---|---|
| 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.3.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.3.0 (есть запись в истории) | Версии 5.X; сверить доступность запроса |
| Печать итогов регистрации | 10.5.1.0 | Версии 5.X |
Три верхние строки — это ровно тот случай, ради которого таблица и написана. В релизе 10.10.9.0 добавили четыре новые возможности, и три из них не работают на прошивках 5.17.xx и более ранних. Драйвер обновится, версия в заголовке окна сменится, а функций не будет.
В каких выпусках история упоминает функции API
Таблица помогает искать изменения в истории релизов. По ней нельзя понять, когда метод появился впервые: одни и те же возможности упоминаются в нескольких записях. Проверьте контракт нужной версии перед интеграцией.
| Возможность | Метод или константа | С версии | Дата |
|---|---|---|---|
| Статистика каналов связи | 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.5.0.0 | 11.06.2019 |
| Настройка часовой зоны для уведомлений | 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.3.0 | 26.04.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.5.0.0 | 11.06.2019 |
Оговорка: таблица построена по строкам «Добавлен…» из официальной истории. Если возможности в ней нет, это не значит, что её нет в драйвере — значит, её появление не было отмечено отдельной строкой релиза.
Модели ККТ: с какой версии поддерживаются
| Модель | Поддержка с версии | Дата |
|---|---|---|
| АТОЛ 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 |
Модель есть в списке поддерживаемых — с любой свежей версией драйвера она от этого работать не начнёт. Проверяйте платформу и прошивку конкретного аппарата: например, для платформы 2.5 поддержка прекращена с ДТО 10.10.3.0. Одна таблица говорит, когда модель появилась, другая — что умеет платформа. Смотреть нужно обе.
Вехи по требованиям
| Что | С какой версии | Дата |
|---|---|---|
| Поддержка ФФД 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 в эти таблицы не входят, и это не упущение: в официальной истории релизов их нет вовсе. Это отдельные версии с компонентами ЕСМ, необходимыми для работы ТС ПИоТ.
Обычный ДТО умеет операции маркировки, но интеграции с ЕСМ в нём нет. Для связки ТС ПИоТ нужен согласованный специальный комплект; и обычный релиз со старшим номером его не заменяет.
Как этим пользоваться
Идите сверху вниз. Сначала платформа прошивки — она задаёт коридор возможных версий драйвера. Потом версия ПО ККТ — она определяет, какие функции вообще доступны. И только потом версия драйвера.
Для функции из таблицы отдельно подтвердите прошивку и модель по её документации. Запись «не поддерживается до 5.17.xx включительно» не означает, что любая следующая прошивка любой модели автоматически подходит.
Проверьте релизную лицензию. Прошивка не поднимется выше той версии, которую допускает записанная в кассу релизная лицензия. Как её посмотреть — в статье про ошибки лицензий ККТ.
Перед изменением версии сохраните параметры и пакет для возврата. Порядок установки и нужно ли что-то удалять — смотрите в инструкции своего комплекта. Сносить все прежние библиотеки требуется не всегда.
Полная хронология релизов с описанием каждого — в истории версий ДТО 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.