Как подключить онлайн-кассу АТОЛ по 54-ФЗ в нетиповой 1С:Управление торговлей 11.1?

Программист 1С v8.3 (Управляемые формы) 1С:Управление торговлей Торговля и дистрибуция
← На главную

При переходе на требования 54-ФЗ в сильно доработанных конфигурациях 1С:Управление торговлей 11.1 разработчики часто сталкиваются с проблемой: кассовый аппарат успешно проходит тест подключения через стандартный интерфейс драйвера, однако при попытке пробить чек или выполнить операции из Рабочего места кассира (РМК) команды не отрабатывают. Разберем причины такого поведения, архитектурные различия между старыми и новыми драйверами и пошаговый процесс адаптации конфигурации.

В чем причина несовместимости старых механизмов и онлайн-ККТ?

Проанализируем архитектуру работы с торговым оборудованием в старых и новых редакциях конфигураций:

  1. Смена типа оборудования: В ранних версиях 1С применялся тип оборудования «Фискальный регистратор». Обмен строился на поочередных (построчных) вызовах методов драйвера: открытие чека, последовательная регистрация каждой товарной позиции, регистрация скидок, итог и закрытие чека.
  2. Пакетная фискализация по 54-ФЗ: Для онлайн-касс в стандарте Библиотеки подключаемого оборудования (БПО) введен тип «ККТ с передачей данных». Вся информация о чеке упаковывается программой в единый XML-пакет с фискальными реквизитами (тегами ФФД) и передается устройству одной командой.
  3. Разница в драйверах: Новые драйверы (например, AddIn.ATOL_KKM_1C82_54FZ) не поддерживают устаревшие методы построчной регистрации, поэтому старые модули РМК не могут отправить команды на печать, несмотря на успешный тест связи.

Пошаговый перенос подсистемы БПО из УТ 11.3 в УТ 11.1

Для реализации полной поддержки онлайн-касс в доработанной конфигурации УТ 11.1 без глобального обновления конфигурации целесообразно выполнить бэкпортирование механизмов БПО из актуальной версии (например, УТ 11.3 или 11.4). Разберем шаги по интеграции:

  1. Перенос общих модулей: Необходимо перенести из конфигурации-донора клиентские и серверные модули обработки оборудования:
    • МенеджерОборудованияКлиент
    • МенеджерОборудованияСервер
    • ПодключаемоеОборудованиеУниверсальныйДрайверКлиент
    • ПодключаемоеОборудованиеУниверсальныйДрайверАсинхронноКлиент
  2. Обновление макетов драйверов: Добавим в справочник ДрайверыОборудования актуальный дистрибутив компоненты АТОЛ. Описание манифеста компоненты в XML выглядит следующим образом:
    
    <?xml version="1.0" encoding="UTF-8"?>
    <drivers>
        <component progid="AddIn.ATOL_KKM_1C82_54FZ" type="ККТ" name="АТОЛ: Драйвер ККМ (54ФЗ)"/>
    </drivers>
    <bundle xmlns="http://v8.1c.ru/8.2/addin/bundle">
        <component os="Windows" path="FprnM1C82_54FZ.dll" type="com" arch="i386" />
    </bundle>
    
  3. Перевод вызовов РМК на новый интерфейс: Заменим старые вызовы фискализации на пакетную передачу через процедуру:
    
    МенеджерОборудованияКлиент.НачатьФискализациюЧекаНаФискальномУстройстве(
        ОповещениеПриЗавершении,
        ИдентификаторУстройства,
        ПараметрыОперацииXML
    );
    
  4. Реализация формирования XML-пакета чека: В документе ЧекККМ формируем структуру чека, включающую реквизиты покупателя, систему налогообложения, признак способа расчета, признак предмета расчета, ставку НДС и перечень оплат (наличные, безналичные, предоплаты).

Частые вопросы при настройке онлайн-касс АТОЛ

Рассмотрим две распространенные проблемы, с которыми сталкиваются разработчики при запуске оборудования:

1. Почему не печатается QR-код на фискальном чеке?

Выясним механизм формирования QR-кода:

  1. Аппаратная генерация: Формирование и графическая печать QR-кода осуществляются на уровне прошивки ККТ и фискального накопителя. 1С передает только фискальные данные, картинка кода из 1С не отправляется.
  2. Фискализация устройства: На нефискализированном аппарате (или при работе в тестовом режиме без установленного тестового ФН) QR-код не генерируется.
  3. Настройки шаблона чека: Если аппарат уже фискализирован, но код отсутствует, откроем утилиту Тест драйвера ККТ от АТОЛ, перейдем в параметры устройства и проверим флаг печати QR-кода, а также выбранный шаблон чека (в компактных шаблонах вывод графики может быть принудительно отключен).

2. Как получить отчет без гашения (X-отчет)?

В стандартах 54-ФЗ отчет без гашения (X-отчет) не является обязательным фискальным документом и не передается оператору фискальных данных (ОФД). Поэтому в некоторых редакциях БПО стандартная команда могла отсутствовать в интерфейсе чека.

Для снятия X-отчета можно применить следующие подходы:

  1. Вызов сервисной команды БПО: Использовать специализированную команду драйвера через МенеджерОборудованияКлиент с передачей типа операции отчета без гашения.
  2. Прямое обращение к объекту драйвера: При необходимости вызова отчета в обход типовых механизмов можно обратиться напрямую к COM-объекту драйвера ККТ, переключить режим работы устройства в режим отчетов без гашения и вызвать соответствующий метод печати.

Особенности передачи данных в ОФД

Посмотрим на важный системный нюанс: при подключении кассового аппарата по интерфейсу USB для отправки чеков в ОФД должна быть запущена и настроена служба EthernetOverUSB (EoU). Данная служба транслирует сетевые пакеты через виртуальный COM-порт устройства. Без корректно настроенного EoU чеки будут печататься локально, но не будут отправляться оператору фискальных данных.

← На главную