При подключении торгового оборудования, в частности контрольно-кассовой техники (ККТ) АТОЛ, технические специалисты часто сталкиваются со следующей проблемой. После установки пакета драйверов от производителя в системе 1С при попытке настройки или проверки оборудования возникает предупреждение: «Установка драйвера АТОЛ:ККТ с передачей данных в ОФД 9.х не завершена». При попытке обойти проблему ручными методами нередко появляется более серьезная системная ошибка: «Не определен тип: AddIn.ATOL_KKT_1C83_V9».
В этой статье мы подробно разберем, почему возникают эти ошибки, проанализируем неэффективные методы борьбы с ними и рассмотрим правильный, проверенный на практике алгоритм интеграции торгового оборудования АТОЛ 9.х с платформой 1С:Предприятие 8.3.
Очень часто у системных администраторов возникает соблазн решить проблему «в лоб» — скопировать библиотеки драйвера (например, файлы из папки Drivers9) напрямую в каталог установленной платформы 1С (путь вида C:\Program Files\1cv8\8.3.XX.XXXX\bin\). Рассмотрим подробнее, почему этот подход не работает и только усугубляет ситуацию:
bin, платформа не сможет ее автоматически инициализировать и зарегистрировать в реестре операционной системы под нужным программным идентификатором (ProgID).bin уникальна для каждого установленного релиза платформы 1С. При первом же обновлении технологической платформы 1С создаст новую директорию, а скопированные файлы останутся в старой папке, из-за чего интеграция полностью сломается.bin и кэшированными библиотеками.Выяснив причину неработоспособности ручного копирования, перейдем к правильной методике настройки.
Для того чтобы система 1С корректно распознала и установила драйвер, необходимо задействовать штатный механизм работы с внешними компонентами. Разберем этот процесс по шагам.
Шаг 1. Подготовка дистрибутива драйвера.
Прежде всего, на компьютере должен быть установлен официальный пакет драйверов торгового оборудования (ДТО) АТОЛ версии 9.х. После стандартной установки файлы интеграции с 1С сохраняются в локальном каталоге. Нам потребуется готовый ZIP-архив с компонентой. Обычно он находится по следующему пути:
C:\Program Files (x86)\ATOL\Drivers9\KKT\1Cv83\ATOL_KKT_9.zip (для 32-битных систем путь начнется с C:\Program Files\...).
Убедимся, что этот файл присутствует на диске.
Шаг 2. Загрузка драйвера в информационную базу 1С.
Запустим конфигурацию 1С (например, «Управление торговлей», «Розница» или «Управление нашей фирмой») в режиме «Тонкий клиент» или «Толстый клиент» под пользователем с полными правами (Администратор). Далее выполним следующие действия:
ККТ с передачей данных.ATOL_KKT_9.zip.Шаг 3. Исключение конфликта версий (Переименование).
Это критически важный нюанс, о котором часто забывают. В конфигурациях 1С уже может быть предустановлен встроенный макет драйвера АТОЛ. Чтобы система не путала старую встроенную версию с нашей новой загруженной компонентой, в поле Наименование обязательно введем измененное имя, например: АТОЛ:ККТ с передачей данных в ОФД 9.х (Кастомный). После этого нажмем кнопку Записать и закрыть (сохранить изменения).
Шаг 4. Установка компоненты на рабочем месте.
Выделим в списке вновь созданный драйвер, зайдем в меню Функции и выберем пункт Установить драйвер. Система распакует архив и зарегистрирует библиотеку в операционной системе текущего пользователя.
Шаг 5. Подключение и настройка ККТ.
Теперь перейдем к созданию экземпляра оборудования. Создадим новое подключаемое оборудование, выберем созданный нами на Шаге 3 кастомный драйвер. Нажмем кнопку Настроить. Система выполнит тест связи, после чего мы сможем указать порт подключения, модель кассы и параметры ОФД.
Если после выполнения всех шагов при открытии формы настройки все равно появляется ошибка Не определен тип: AddIn.ATOL_KKT_1C83_V9, это означает, что платформа 1С по-прежнему не может инициализировать COM/Native-объект внешней компоненты. Проанализируем ключевые причины этой проблемы и способы их устранения.
Это самая распространенная причина ошибки. Системные администраторы часто смотрят на разрядность операционной системы (например, Windows 10 x64) и устанавливают 64-битную версию драйверов АТОЛ. Однако разрядность драйвера АТОЛ должна строго соответствовать разрядности запущенного клиента 1С, а не операционной системы.
Если на компьютере установлен стандартный 32-битный клиент 1С (даже на 64-битной Windows), платформа сможет работать только с 32-битными библиотеками (DLL). Если вы загрузили в 1С 64-битный драйвер АТОЛ, 32-битная платформа 1С выдаст ошибку неопределенного типа, так как не сможет загрузить чужеродный бинарный код.
Решение: Проверьте разрядность запущенного приложения 1С (меню Справка -> О программе). Если клиент 32-битный (x86), удалите установленный пакет ДТО АТОЛ x64, скачайте и установите строго 32-битную версию драйверов АТОЛ 9.х.
Платформа 1С сохраняет ранее использовавшиеся версии драйверов во временных папках пользователя Windows. Если там зависла старая или поврежденная библиотека, система будет пытаться обращаться к ней, игнорируя новые настройки.
Решение (очистка кэша компонент):
C:\Users\<Имя_Пользователя>\AppData\Roaming\1C\1cv8\ExtCompT\ExtCompT. В ней хранятся кэшированные динамические библиотеки (DLL).C:\Users\<Имя_Пользователя>\AppData\Local\Temp\.Внешние компоненты АТОЛ написаны на языке C++ и требуют для своей работы наличия в операционной системе определенных версий пакетов распространяемого кода Visual C++ Redistributable (обычно версий 2013, 2015-2019 годов). Если этих библиотек в Windows нет, операционная система заблокирует загрузку DLL-файла драйвера, а 1С выдаст ошибку неопределенного типа.
Решение: Скачайте с официального сайта Microsoft и установите пакеты Visual C++ Redistributable (как x86, так и x64 версий) для актуальных годов выпуска. После установки перезагрузите компьютер.
Для первой регистрации внешней компоненты в реестре операционной системы платформе 1С могут потребоваться повышенные привилегии в системе. Если у текущего пользователя Windows ограничены права, процесс регистрации завершится ошибкой.
Решение: Запустите ярлык 1С один раз нажатием правой кнопки мыши и выбором пункта Запуск от имени администратора. Перейдите в настройки торгового оборудования, выполните установку и тест драйвера. После успешной регистрации компоненты последующие запуски 1С можно осуществлять в обычном пользовательском режиме.
Рассматривая проблемы настройки драйверов АТОЛ серии 9.х, важно понимать их дальнейшую техническую перспективу. Разработчик (компания АТОЛ) официально прекратил поддержку и развитие 9-й версии драйверов (DTO 9). В свою очередь, фирма «1С» в современных релизах своих конфигураций полностью исключила поддержку ККТ на базе драйверов 9.х.
Работа на устаревших драйверах 9.х не позволит вам использовать современные требования законодательства РФ в сфере торговли, такие как:
Поэтому настоятельно рекомендуется запланировать обновление конфигурации 1С и платформы, полное удаление старых драйверов АТОЛ 9.х через панель управления Windows и переход на современную и стабильную 10-ю версию драйверов (DTO 10), работающую на Платформе АТОЛ 5.0.