Драйвер подключаемого оборудования ККТ Ревизия 2.0

> СерверККМ V4 > Интеграция с 1С > Драйверы для 1С > 1С: УПРАВЛЕНИЕ ТОРГОВЛЕЙ 11
Дата обновления: 14 сентября 2026 г. Дата публикации: 14 сентября 2026 г. Автор: Лаврентьев Степан

Обязательные функции и методы, связанные с использованием драйвера подключаемого оборудования в системе

фывфывфыв

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

Драйвер поддерживает два основных этапа работы с оборудованием в конфигурации:
- Регистрация и настройка оборудования
- Использование оборудования пользователем в процессе работы

Регистрация и настройка оборудования
1. Получение описания драйвера вызовом метода «ПолучитьОписание(GetDescription)».
2. Получения доступных параметров для настройки драйвера методом «ПолучитьПараметры(GetParameters)».
3. Построение формы настройки драйвера на основании списка доступных параметров.
4. Сохранение параметров настройки драйвера в базе данных конфигурации.

Использование оборудования пользователем в процессе работы

Инициализация устройства сохраненными в базе параметрами методом «УстановитьПараметр(SetParameter)».
Подключение оборудования с помощью метода «Подключить(Open)» с текущими значениями параметров, установленными вызовами метода «УстановитьПараметр(SetParameter)». Метод «Подключить(Open)» возвращает идентификатор подключенного экземпляра устройства.
Вызов обязательных функций и методов, специфичных для данного типа подключаемого оборудования, с использованием идентификатора подключенного экземпляра устройства.
Получение кода ошибки и описания ошибки методом «ПолучитьОшибку(GetLastError)» в случае ее возникновения.
Отключение устройства методом «Отключить(Close)» по идентификатору подключенного экземпляра устройства.

Описание методов:

ПолучитьНомерВерсии (GetVersion)

Тип: STRING. Возвращает номер версии драйвера.

ПолучитьОписание (GetDescription)

Возвращает информацию о драйвере, такую как название и описание, поддерживаемый тип оборудования.

Имя	Тип	Описание
Наименование (Name)	STRING [OUT]	Наименование драйвера
Описание (Description)	STRING [OUT]	Описание драйвера
ТипОборудования (EquipmentType)	STRING [OUT]	Строка, определяющая тип оборудования
РевизияИнтерфейса (InterfaceRevision)	LONG [OUT]	Поддерживаемая версия требований для данного типа оборудования
ИнтеграционнаяБиблиотека (IntegrationLibrary)	BOOL [OUT]	Флаг возвращает, является ли компонент интеграционной библиотекой драйвера или самостоятельным драйвером
ОсновнойДрайверУстановлен (MainDriverInstalled)	BOOL [OUT]	Для интеграционной библиотеки возвращает флаг установки основной поставки драйвера
URLCкачивания (DownloadURL)	STRING [OUT]	Возвращает пустую строку или адрес страницы сайта производителя, по которому доступна ссылка для скачивания основной поставки драйвера или иная информация о драйвере. При возвращении пустой строки функционал установки основной поставки драйвера не активизируется.

ПолучитьОшибку (GetLastError)

Возвращает код и описание последней произошедшей ошибки.

Имя	Тип	Описание
ОписаниеОшибки (ErrorDescription)	STRING [OUT]	Описание ошибки

ПолучитьПараметры (GetParameters)

Возвращает список параметров настройки драйвера и их типы, значения по умолчанию и возможные значения.

Имя	Тип	Описание
[[Приложение#ТаблицаПараметров (TableParameters)\ТаблицаПараметров]]	STRING [OUT]	Список параметров

УстановитьПараметр (SetParameter)

Установка значения параметра по имени

Имя	Тип	Описание
Имя (Name)	STRING [IN]	Имя параметра
Значение (Value)	VARIANT [IN]	Значение параметра

Подключить (Open)

Подключает оборудование с текущими значениями параметров, установленных функцией «УстановитьПараметр». Возвращает идентификатор подключенного экземпляра устройства

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [OUT]	Идентификатор устройства

Отключить (Close)

Отключает оборудование

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства

ТестУстройства (DeviceTest)

Выполняет пробное подключение и опрос устройства с текущими значениями параметров, установленными функцией «УстановитьПараметр». При успешном выполнении подключения в описании возвращается информация об устройстве

Имя	Тип	Описание
Описание (Description)	STRING [OUT]	Описание результата выполнения теста
АктивированДемоРежим (DemoModeIsActivated)	STRING [OUT]	Возвращает описание ограничений демонстрационного режима при его наличии и пустой результат при его отсутствии. Пример: драйвер является платным, и для полноценной работы нужен ключ защиты.

ПолучитьДополнительныеДействия (GetAdditionalActions)

Получает список действий, которые будут отображаться как дополнительные пункты меню в форме настройки оборудования, доступной администратору. Если действий не предусмотрено, возвращает пустую строку.

Имя	Тип	Описание
[[Приложение#ТаблицаДействий (TableActions)\|ТаблицаДействий]]	STRING [OUT]	Список дополнительных действий

ВыполнитьДополнительноеДействие (DoAdditionalAction)

Команда на выполнение дополнительного действия с определенными именем

Имя	Тип	Описание
ИмяДействия (ActionName)	STRING [IN]	Имя действия

Требования к разработке драйверов для ККТ с функцией передачи в ОФД

При работе с ККТ с функцией передачи данных в ОФД поддерживаются следующие операции:

Получение данных из ККТ для регистрации фискального накопителя и последующей работы;
Операции с фискальным накопителем:
- Регистрация
- Изменение параметров регистрации
- Закрытие
Формирование документов открытия и закрытия смены;
Формирование фискальных чеков;
Формирование фискальных чеков коррекции;
Формирование фискальных отчетов о текущем состоянии расчетов;
Формирование нефискальных отчетов (отчет без гашения);
Получение текущего состояние ККТ;
Печать чеков внесения/выемки денежных средств;
Печать текстовых документов;
Открытие денежного ящика.
Описание методов:

ПолучитьПараметрыККТ (GetDataKKT)

Получение данных из ККТ для регистрации фискального накопителя и последующей работы

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
[[Приложение#ТаблицаПараметровККТ (TableParametersKKT) - проверить!\|ТаблицаПараметровККТ]]	STRING [OUT]	Регистрационные данные фискального накопителя
#### ОперацияФН (OperationFN)
Операция с фискальным накопителем. После проведения операции происходит печать отчета о проведении соответствующей операции.

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
ТипОперации (OperationType)	LONG [IN]	Тип операции: 1 - Регистрация 2 - Изменение параметров регистрации 3 - Закрытие ФН
Кассир	STRING [IN]	ФИО кассира
[[Приложение#ПараметрыФискализации\|ПараметрыФискализации]]	STRING [IN]	Данные для фискализации фискального накопителя
#### ОткрытьСмену (OpenShift)
Открывает новую смену и печатает на ККТ отчет об открытии смены.

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
Кассир (Cashier)	STRING [IN]	ФИО кассира
НомерСмены (SessionNumber)	LONG [OUT]	Номер смены
НомерДокумента(DocumentNumber)	LONG [OUT]	Номер отчета об открытии смены (номер фискального документа)
#### ЗакрытьСмену (CloseShift)
Закрывает открытую ранее смену и печатает на ККТ отчет о закрытии смены.

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
Кассир (Cashier)	STRING [IN]	ФИО кассира
НомерСмены (SessionNumber)	LONG [OUT]	Номер закрытой смены
НомерДокумента (DocumentNumber)	LONG [OUT]	Номер отчета о закрытии смены (номер фискального документа)
#### СформироватьЧек (ProcessCheck)
Формирование чека в пакетном режиме. Передается структура, описывающая тип открываемого чека, фискальные и текстовые строки, штрихкоды, которые будут напечатаны. Также передаются суммы оплат для закрытия чека.

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
Кассир (Cashier)	STRING [IN]	ФИО кассира
Электронно (Electronically)	BOOL [IN]	Формирование чека в только электроном виде. Печать чека не осуществляется.
[[Приложение#Данные чека\|ДанныеЧека]]	STRING [IN]	XML структура - описание чека.
НомерЧека (CheckNumber)	LONG [OUT]	Номер фискального чека
НомерСмены (SessionNumber)	LONG [OUT]	Номер открытой смены
ФискальныйПризнак (FiscalSign)	STRING [OUT]	Фискальный признак
АдресСайтаПроверки (АдресСайтаПроверки)	STRING [OUT]	Адрес сайта проверки
#### СформироватьЧекКоррекции (PrintReceiptCorrection)
Имя	Тип	Описание
---------------------------------------------------------------------------------------------------------------	--------------	-----------------------------------------------------------------------
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
Кассир (Cashier)	STRING [IN]	ФИО кассира
[[Приложение#ДанныеЧекаКоррекции (CheckCorrectionPackage)\|ДанныеЧекаКоррекции (CheckCorrectionPackage)]]	STRING [IN]	XML структура - описание чека коррекции.
НомерЧека (CheckNumber)	LONG [OUT]	Номер фискального чека (Номер фискального документа сформированный ФН)
НомерСмены (SessionNumber)	LONG [OUT]	Номер смены
ФискальныйПризнак (FiscalSign)	STRING [OUT]	Фискальный признак
AddressSiteInspections (АдресСайтаПроверки)	STRING [OUT]	Адрес сайта проверки
#### ПечатьТекста (PrintText)
Печать текстового документа (текстовый слип-чек, информационная квитанция)

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
[[Приложение#Данные документа (DocumentPackage)\|Данные документа (DocumentPackage)]]	STRING [IN]	XML структура - описание текстового документа.
#### НапечататьЧекВнесенияВыемки (CashInOutcome)
Печатает чек внесения/выемки (зависит от переданной суммы). Сумма >= 0 - внесение, Сумма < 0 - выемка.

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
Сумма (Amount)	DOUBLE [IN]	Сумма внесения /выемки
#### НапечататьОтчетБезГашения (PrintXReport)
Печатает на отчет за смену без закрытия кассовой смены

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
#### ПолучитьТекущееСостояние (GetCurrentStatus)
Получение текущего состояние ККТ.

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
НомерЧека (CheckNumber)	LONG [OUT]	Номер последнего пробитого фискального чека
НомерСмены (SessionNumber)	LONG [OUT]	Номер смены
СтатусСмены (SessionState)	LONG [OUT]	Состояние смены 1 - Закрыта 2 - Открыта 3 - Истекла
[[Приложение#ПараметрыСостояния (StatusParameters)\|ПараметрыСостояния (StatusParameters)]]	STRING [OUT]	XML структура - описание параметров состояния.
#### ОтчетОТекущемСостоянииРасчетов (ReportCurrentStatusOfSettlements)
Формирует отчет о текущем состоянии расчетов

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства

ОткрытьДенежныйЯщик (OpenCashDrawer)

Производит открытие денежного ящика, подключенного к фискальному регистратору.

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
#### ПолучитьШиринуСтроки (GetLineLength)
Получить ширину строки чека в символах.

Имя	Тип	Описание
ИДУстройства (DeviceID)	STRING [IN]	Идентификатор устройства
ШиринаСтроки (LineLength)	LONG [OUT]	Ширина строки в символахах