Почему возникают ошибки при обращении к драйверу ККТ из 1С и как их исправить?

Многие разработчики 1С сталкиваются с ситуацией, когда код для работы с контрольно-кассовой техникой (ККТ) идеально работает на локальной файловой базе или на компьютере разработчика, но «отказывается взлетать» при переносе в рабочую клиент-серверную среду. Типичные симптомы: объект драйвера успешно создается, методы типа ПолучитьРевизиюИнтерфейса отрабатывают, но при попытке подключения (Подключить) система возвращает Ложь, а методы получения описания выдают пустые строки.

В этой статье мы подробно разберем, почему так происходит, проанализируем архитектурные ограничения платформы 1С:Предприятие и рассмотрим несколько вариантов решения проблемы: от простых правок контекста до настройки полноценной автоматической очереди печати.

Разбор основной причины: конфликт контекстов «Клиент — Сервер»

Проанализируем ситуацию, описанную в теме. Разработчик пытается запустить пробитие чеков через регламентное задание. Это означает, что код выполняется в контексте НаСервере от имени системного пользователя (например, USR1CV8). В то же время сама касса физически подключена к компьютеру бухгалтера (клиентское рабочее место).

Почему сервер «не видит» кассу?

1. Изоляция сессий: Сервер 1С — это отдельный процесс, работающий в нулевой сессии Windows или под Linux. Он не имеет доступа к USB-портам или COM-портам удаленного компьютера пользователя.
2. Отсутствие драйверов на сервере: Часто компоненты драйвера (например, АТОЛ 10) устанавливаются только на клиентских местах. При выполнении серверного кода система пытается найти драйвер в контексте сервера. Если его там нет или он не зарегистрирован, работа будет невозможна.
3. Разрядность процессов: Это критически важный момент. Сервер 1С чаще всего 64-битный (x64). Если на сервере установлена 32-битная (x86) компонента драйвера ККТ, серверный процесс не сможет корректно инициализировать объект, даже если создание самого COM-объекта или внешней компоненты формально прошло успешно.

Вариант 1: Перенос кода на сторону клиента (Интерактивный метод)

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

Рассмотрим пример правильного вызова:

&НаКлиенте
Процедура ПробитьЧекНаКлиенте(ДанныеЧека)
    // Объект драйвера должен создаваться именно здесь
    Результат = ПодключитьВнешнююКомпоненту("ОбщийМакет.ДрайверАТОЛ10", "Atol_KKT_10", ТипВнешнейКомпоненты.Native);
    Если Результат Тогда
        Драйвер = Новый ("AddIn.Atol_KKT_10.Atol64"); // Пример для 10-го драйвера
        // Теперь мы можем обращаться к портам локального ПК
        ПараметрыПодключения = "Port=USB;Model=67;"; 
        Драйвер.УстановитьПараметры(ПараметрыПодключения);
        Драйвер.Подключить();
    КонецЕсли;
КонецПроцедуры

Этот способ решает проблему «видимости» оборудования, так как код выполняется в том же сеансе ОС, где подключена касса. Однако, как справедливо замечено в обсуждении, это не позволит использовать регламентные задания.

Вариант 2: Использование сетевого интерфейса ККТ (TCP/IP)

Современные модели АТОЛ (особенно с драйвером 10-й версии) поддерживают работу по сети. Если касса подключена к локальной сети через Ethernet или Wi-Fi, или настроена служба EthernetOverUSB, сервер 1С может обращаться к ней напрямую по IP-адресу.

Разберем этот вариант по шагам:

1. Выясняем IP-адрес кассы в локальной сети.
2. Убеждаемся, что сервер 1С «пингует» этот адрес (нет блокировок брандмауэром).
3. На сервере 1С устанавливаем драйвер ККТ той же разрядности, что и сервер (x64).
4. В коде регламентного задания указываем параметры подключения через TCP/IP.

Пример настройки параметров для сервера:

// Код выполняется НаСервере
Драйвер.УстановитьСвойство("LibraryPath", "C:\Atol\Drivers10\KKT\bin\");
Драйвер.УстановитьСвойство("Model", 67); // Код модели
Драйвер.УстановитьСвойство("ConnectionType", 1); // 1 - это TCP/IP
Драйвер.УстановитьСвойство("IPAddress", "192.168.1.150");
Драйвер.УстановитьСвойство("IPPort", 5555);
Результат = Драйвер.Connect();

В этом случае серверу не нужно «знать» о компьютере бухгалтера — он общается напрямую с «железом» по сети.

Вариант 3: Веб-сервер драйвера АТОЛ

Если модель кассы не поддерживает сетевой интерфейс напрямую, можно воспользоваться решением «Веб-сервер АТОЛ». На компьютере бухгалтера (где касса подключена по USB) запускается специальная служба, которая превращает локальный драйвер в HTTP-сервис.

Как это работает:

1. Сервер 1С формирует задание на печать чека в формате JSON.
2. Сервер отправляет HTTP-запрос (POST) на адрес компьютера бухгалтера (например, http://192.168.1.10:16732/tasks).
3. Локальная служба АТОЛ принимает запрос и физически печатает чек.

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

Вариант 4: Механизм «Очередь печати» в БПО

Если вы работаете в современной конфигурации (БП 3.0, УТ 11, Розница 2.3), рекомендуется использовать штатный механизм Библиотеки подключаемого оборудования (БПО). Вместо того чтобы пытаться пробить чек мгновенно из фонового задания, мы можем использовать асинхронный подход.

Проанализируем алгоритм:

1. Регламентное задание на сервере анализирует данные и создает документы «Чек ККМ» или записывает данные в специальный регистр сведений (Очередь чеков).
2. На клиентском компьютере, к которому подключена касса, открыт сеанс 1С. В этом сеансе работает обработчик ожидания (или специальная форма «Очередь печати»).
3. Клиентское приложение периодически проверяет регистр: «А нет ли для моей кассы новых заданий?».
4. Обнаружив задание, клиентское приложение НаКлиенте вызывает драйвер и пробивает чек.

Этот метод считается «золотым стандартом» в 1С, так как он сохраняет все преимущества клиент-серверной архитектуры и не требует сложной сетевой настройки оборудования.

Важные технические нюансы

Разберем дополнительные факторы, которые могут блокировать работу драйвера даже при правильном контексте:

• Права службы 1С: Служба USR1CV8 по умолчанию имеет очень ограниченные права. Она может не иметь прав на чтение файлов драйвера в папке Program Files или на запись логов в системные папки. Проверьте настройки прав доступа к папкам драйвера.
• Логирование: Если логи драйвера не пишутся — значит, компонента либо не загрузилась, либо у процесса нет прав на запись в файл лога. В 10-м драйвере АТОЛ путь к логам можно настроить явно через метод set_LogFile().
• Инициализация: Метод ПолучитьОписание возвращает пустую строку, если драйвер не нашел свои конфигурационные файлы. При работе на сервере убедитесь, что все необходимые dll и xml файлы драйвера находятся в путях поиска системы или явно указаны в настройках компоненты.

Подводя итог: если ваша задача — полная автоматизация без участия пользователя, выбирайте Вариант 2 (TCP/IP) или Вариант 3 (Веб-сервер). Если же допустимо наличие запущенного сеанса 1С на компьютере с кассой — используйте Вариант 4 (Очередь печати БПО). Простое перемещение серверного кода в регламентное задание без изменения способа связи с кассой работать в клиент-серверном режиме не будет.