ТЕХНИЧЕСКАЯ ДОКУМЕНТАЦИЯ

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

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

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

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

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

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

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

  1. Инициализация устройства сохраненными в базе параметрами методом «УстановитьПараметр(SetParameter)».
  2. Подключение оборудования с помощью метода «Подключить(Open)» с текущими значениями параметров, установленными вызовами метода «УстановитьПараметр(SetParameter)». Метод «Подключить(Open)» возвращает идентификатор подключенного экземпляра устройства.
  3. Вызов обязательных функций и методов, специфичных для данного типа подключаемого оборудования, с использованием идентификатора подключенного экземпляра устройства.
  4. Получение кода ошибки и описания ошибки методом «ПолучитьОшибку(GetLastError)» в случае ее возникновения.
  5. Отключение устройства методом «Отключить(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)

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

Имя Тип Описание
Таблица параметров (см. Приложение: ТаблицаПараметров) 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)

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

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

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

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

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

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

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

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

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

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

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

Имя Тип Описание
ИДУстройства (DeviceID) STRING [IN] Идентификатор устройства
ТаблицаПараметровККТ (см. Приложение: ТаблицаПараметровККТ 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] ФИО кассира
ДанныеЧекаКоррекции (см. Приложение: ДанныеЧекаКоррекции) STRING [IN] XML структура - описание чека коррекции.
НомерЧека (CheckNumber) LONG [OUT] Номер фискального чека  (Номер фискального документа сформированный ФН)
НомерСмены (SessionNumber) LONG [OUT] Номер смены
ФискальныйПризнак (FiscalSign) STRING [OUT] Фискальный признак
АдресСайтаПроверки (AddressSiteInspections) STRING [OUT] Адрес сайта проверки

ПечатьТекста (PrintText)

Печать текстового документа (текстовый слип-чек, информационная квитанция)

Имя Тип Описание
ИДУстройства (DeviceID) STRING [IN] Идентификатор устройства
Данные документа (см: Приложение: Данные документа) 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 - Истекла
ПараметрыСостояния (см. Приложение: ПараметрыСостояния) STRING [OUT] XML структура - описание параметров состояния.

ОтчетОТекущемСостоянииРасчетов (ReportCurrentStatusOfSettlements)

Формирует отчет о текущем состоянии расчетов

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

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

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

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

ПолучитьШиринуСтроки (GetLineLength)

Получить ширину строки чека в символах.

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

Приложение

ТаблицаПараметров (TableParameters)

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
Name Да string Имя параметра, для которого создается поле ввода, не должно содержать пробелов и недопустимых символов (в соответствии с правилами формирования имен объектов “1С:Предприятия”) и быть уникальным в рамках таблицы параметров
Caption Да string Произвольная надпись перед полем ввода
Description Нет string Описание параметра. Справочная информация выводимая в выпадающей подсказке.
TypeValue Да string Одно из нижеуказанных типов данных:
“String“, “Number“, “Boolean”
FieldFormat Нет string Строка форматирования значения параметра
DefaultValue Нет string Значение параметра по умолчанию
ReadOnly Нет boolean Параметр только для просмотра
ChoiceList Нет list Содержит список доступных для выбора значений параметра
PageCaption Нет string Наименование закладки, по которому будут группироваться поля ввода
GroupCaption Нет string Наименование группы, по которому будут группироваться поля ввода

ТаблицаДействий (TableActions)

Секция Actions

Пользовательские действия.

Секция Action

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
Name Да string Имя действия, для которого создается пункт меню, не должно содержать пробелов и недопустимых символов (в соответствии с правилами формирования имен объектов “1С:Предприятия”) и быть уникальным в рамках таблицы параметров
Caption Да string Заголовок пункта меню

ТаблицаПараметровККТ (TableParametersKKT)

Секция Parameters

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
KKTNumber Нет* string Регистрационный номер ККТ
KKTSerialNumber Да string Заводской номер ККТ
Fiscal Да boolean Признак регистрации фискального накопителя
FFDVersionFN Нет* string Версия ФФД ФН (одно из следующих значений “1.0”,”1.0.5”,”1.1”)
FFDVersionKKT Нет* string Версия ФФД ККТ (одно из следующих значений “1.0”,”1.0.5”,”1.1”)
FNSerialNumber Да string Заводской номер ФН
DocumentNumber Нет* string Номер документа регистрация фискального накопителя
DateTime Нет* datetime Дата и время операции регистрации фискального накопителя
OrganizationName Нет* string Название организации
VATIN Нет* string ИНН организация
AddressSettle Нет* string Адрес проведения расчетов
TaxVariant Нет* string Коды системы налогообложения через разделитель “,”. Коды системы налогообложения приведены в таблице (Справка: Системы налогообложения)
OfflineMode Нет* boolean Признак автономного режима
DataEncryption Нет* boolean Признак шифрование данных
ServiceSign Нет* boolean Признак расчетов за услуги
BSOSing Нет* boolean Признак формирования АС БСО
CalcOnlineSign Нет* boolean Признак ККТ для расчетов только в Интернет
AutomaticMode Да boolean Признак автоматического режима
AutomaticNumber Нет* string Номер автомата для автоматического режима
OFDOrganizationName Нет* string Название организации ОФД
OFDVATIN Нет* string ИНН организации ОФД
  • Данные поля обязательны для фискализированных ФН.

ПараметрыФискализации

Секция Parameters

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
KKTNumber Да string Регистрационный номер ККТ
OrganizationName Да string Название организации
VATIN Да string ИНН организация
AddressSettle Да string Адрес проведения расчетов
TaxVariant Да string Коды системы налогообложения через разделитель “,”. Коды системы налогообложения приведены в таблице (Справка: Системы налогообложения)
TaxVarinat Да string Коды системы налогообложения через разделитель “,”. Коды системы налогообложения приведены в таблице (Справка: Системы налогообложения)
OfflineMode Да boolean Признак автономного режима
DataEncryption Да boolean Признак шифрование данных
ServiceSign Да boolean Признак расчетов за услуги
BSOSing Да boolean Признак формирования АС БСО
CalcOnlineSign Да boolean Признак ККТ для расчетов только в Интернет
AutomaticMode Да boolean Признак автоматического режима
AutomaticNumber Да string Номер автомата для автоматического режима
ReasonCode Нет* long Код причины перерегистрации (*указывается только для операции “Изменение параметров регистрации”)
(Коды приведены в таблице 15 форматов фискальных данных)
OFDOrganizationName Да string Название организации ОФД
OFDVATIN Да string ИНН организации ОФД
  • Данное поле обязательно при процедуре изменение параметров регистрации.

ДанныеЧекаКоррекции (CheckCorrectionPackage)

Секция Parameters

Формирование нового чека с заданным атрибутами

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
TaxVariant Да long Код системы налогообложения.
См. таблицу (Справка: Системы налогообложения
PaymentType Да long Тип расчета
1 - Приход
2 - Возврат прихода
3 - Расход
4 - Возврат расхода

Секция Payments

Параметры закрытия чека. Чек коррекции может быть оплачен только одним видом оплаты и без сдачи.

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
Cash Да decimal Сумма наличной оплаты
CashLessType1 Да decimal Cумма оплаты основной безналичной оплаты / банковской карты
CashLessType2 Да decimal Сумма оплаты вторым типом безналичной оплаты или предварительной оплаты (аванс)
CashLessType3 Да decimal Сумма оплаты кредитом / постоплатой

Данные чека

Секция Parameters

Формирование нового чека с заданным атрибутами. При формирование чека ККТ должен проверять, что передаваемый код системы налогообложения доступен для данного фискализированного ФН.

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
PaymentType Да long Тип расчета
1 - Приход
2 - Возврат прихода
3 - Расход
4 - Возврат расхода
TaxVariant Да long Код системы налогообложения.
См. таблицу (Справка: Системы налогообложения)
TaxVarinat Да long Код системы налогообложения.
См. таблицу (Справка: Системы налогообложения)
CustomerEmail Нет string Email покупателя
CustomerPhone Нет string Телефонный номер покупателя
SenderEmail Нет string Адрес электронной почты отправителя чека
AgentCompensation Нет string Вознаграждения агента
AgentPhone Нет string Телефон платежного агента
ReceivePaymentsOperatorPhone Нет string Телефон оператора по приему платежей
MoneyTransferOperatorPhone Нет string Телефон оператора перевода
MoneyTransferOperatorAddress Нет string Адрес оператора перевода
MoneyTransferOperatorVATIN Нет string ИНН оператора перевода
MoneyTransferOperatorName Нет string Наименование оператора перевода
BankAgentPhone Нет string Телефон банковского агента
BankSubagentPhone Нет string Телефон банковского субагента
BankAgentOperation Нет string Операция банковского агента
BankSubagentOperation Нет string Операция банковского субагента
BankAgentCompensation Нет string Вознаграждения банковского агента

Секция Positions

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

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
FiscalString Да FiscalString Регистрирует фискальную строку с переданными реквизитами.
При печати длинных фискальных строк необходимо делать перенос на следующую строку.
TextString Нет string Строка с произвольным текстом
Barcode Нет Barcode Печать штрихкода. Осуществляется с автоматическим размером с выравниванием по центру чека. Тип штрихкода может иметь одно из следующих значений: EAN8, EAN13, CODE39, QR. В случае, если модель устройства не поддерживает печать штрихкода, выдается ошибка.

Секция Payments

Параметры закрытия чека. Сумма всех видов оплат должна быть больше суммы открытого чека.

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
Cash Да decimal Сумма наличной оплаты
CashLessType1 Да decimal Cумма оплаты основной безналичной оплаты / банковской карты
CashLessType2 Да decimal Сумма оплаты вторым типом безналичной оплаты или предварительной оплаты (аванс)
CashLessType3 Да decimal Сумма оплаты кредитом / постоплатой

FiscalString

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
Name Да string Наименование товара
Quantity Да double Количество товара
Price Да double Цена единицы товара
Amount Да double Конечная сумма по позиции чека
Tax Да string Ставка НДС. Список значений:
“none” - БЕЗ НДС
“18” - НДС 18
“10” - НДС 10
“0” - НДС 0
“10/110” - расч. ставка 10/110
“18/118” - расч. ставка 18/118

ВходныеПараметры (InputParameters)

Секция Parameters

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
CashierName Да string ФИО и должность уполномоченного лица для проведения операции
CashierVATIN Да string ИНН уполномоченного лица для проведения операции

ВыходныеПараметры (OutputParameters)

Секция Parameters

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
NumberOfChecks Да long Количество кассовых чеков за смену
NumberOfDocuments Да long Количество общее ФД за смену
BacklogDocumentsCounter Да long Количество непереданных документов
BacklogDocumentFirstNumber Нет long Номер первого непереданного документа
BacklogDocumentFirstDateTime Нет datetime Дата и время первого из непереданных документов
UrgentReplacementFN Нет bool Признак необходимости срочной замены ФН
MemoryOverflowFN Нет bool Признак переполнения памяти ФН
ResourcesExhaustionFN Нет bool Признак исчерпания ресурса ФН
ResourcesFN Нет long Срок действия ключей фискального признака. Текущее значение реквизита определяется как остаток срока действия ключей в днях.
OFDTimeout Нет bool Признак того, что подтверждение оператора для переданного фискального документа отсутствует более двух дней. Для ФД с версией ФФД 1.0 более 5 дней.

ПараметрыСостояния (StatusParameters)

Секция Parameters

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
BacklogDocumentsCounter Да long Количество непереданных документов
BacklogDocumentFirstNumber Нет long Номер первого непереданного документа
BacklogDocumentFirstDateTime Нет datetime Дата и время первого из непереданных документов

Barcode

Наименование атрибута Обязательное наличие в структуре Типы данных Описание атрибута
BarcodeType Да string Строка, определяющая тип штрихкода
Barcode Да string Значение штрихкода

Справка

Системы налогообложения

Код Описание
0 Общая
1 Упрощенная (Доход)
2 Упрощенная (Доход минус Расход)
3 Единый налог на вмененный доход
4 Единый сельскохозяйственный налог
5 Патентная система налогообложения

Признаки способа расчета

Код Описание
1 Предоплата полная
2 Предоплата частичная
3 Аванс
4 Полный расчет
5 Частичный расчет и кредит
6 Передача в кредит
7 Оплата кредита

Признаки предмета расчета

Код Описание
1 Товар
2 Подакцизный товар
3 Работа
4 Услуга
5 Ставка азартной игры
6 Выигрыш азартной игры
7 Лотерейный билет
8 Выигрыш лотереи
9 Предоставление результатов интеллектуальной деятельности
10 Платеж, выплата
11 Агентское вознаграждение
12 Составной предмет расчета
13 Иной предмет расчета

Признаки агента по предмету расчета

Код Описание
0 Банковский платежный агент
1 Банковский платежный субагент
2 Платежный агент
3 Платежный субагент
4 Поверенный
5 Комиссионер
6 Агент