Драйвер контрольно-кассовой техники v.10
Перечисления | Функции
Работа с ФН

Методы для работы с фискальным накопителем Подробнее...

Перечисления

enum  libfptr_fn_type { LIBFPTR_FNT_DEBUG = 0, LIBFPTR_FNT_RELEASE, LIBFPTR_FNT_UNKNOWN }
 Тип фискального накопителя Подробнее...
 
enum  libfptr_fn_state {
  LIBFPTR_FNS_INITIAL = 0, LIBFPTR_FNS_CONFIGURED = 1, LIBFPTR_FNS_FISCAL_MODE = 3, LIBFPTR_FNS_POSTFISCAL_MODE = 7,
  LIBFPTR_FNS_ACCESS_ARCHIVE = 15
}
 Состояние фискального накопителя Подробнее...
 
enum  libfptr_fn_data_type {
  LIBFPTR_FNDT_TAG_VALUE, LIBFPTR_FNDT_OFD_EXCHANGE_STATUS, LIBFPTR_FNDT_FN_INFO, LIBFPTR_FNDT_LAST_REGISTRATION,
  LIBFPTR_FNDT_LAST_RECEIPT, LIBFPTR_FNDT_LAST_DOCUMENT, LIBFPTR_FNDT_SHIFT, LIBFPTR_FNDT_FFD_VERSIONS,
  LIBFPTR_FNDT_VALIDITY, LIBFPTR_FNDT_REG_INFO, LIBFPTR_FNDT_DOCUMENTS_COUNT_IN_SHIFT, LIBFPTR_FNDT_ERRORS,
  LIBFPTR_FNDT_TICKET_BY_DOC_NUMBER, LIBFPTR_FNDT_DOCUMENT_BY_NUMBER
}
 Тип данных ФН Подробнее...
 
enum  libfptr_ffd_version { LIBFPTR_FFD_UNKNOWN = 0, LIBFPTR_FFD_1_0 = 100, LIBFPTR_FFD_1_0_5 = 105, LIBFPTR_FFD_1_1 = 110 }
 Версия ФФД Подробнее...
 
enum  libfptr_taxation_type {
  LIBFPTR_TT_DEFAULT = 0x00, LIBFPTR_TT_OSN = 0x01, LIBFPTR_TT_USN_INCOME = 0x02, LIBFPTR_TT_USN_INCOME_OUTCOME = 0x04,
  LIBFPTR_TT_ENVD = 0x08, LIBFPTR_TT_ESN = 0x10, LIBFPTR_TT_PATENT = 0x20
}
 Система налогообложения Подробнее...
 
enum  libfptr_fn_operation_type { LIBFPTR_FNOP_REGISTRATION = 0, LIBFPTR_FNOP_CHANGE_FN, LIBFPTR_FNOP_CHANGE_PARAMETERS, LIBFPTR_FNOP_CLOSE_ARCHIVE }
 Тип операции ФН Подробнее...
 
enum  libfptr_agent_type {
  LIBFPTR_AT_NONE = 0x00, LIBFPTR_AT_BANK_PAYING_AGENT = 0x01, LIBFPTR_AT_BANK_PAYING_SUBAGENT = 0x02, LIBFPTR_AT_PAYING_AGENT = 0x04,
  LIBFPTR_AT_PAYING_SUBAGENT = 0x08, LIBFPTR_AT_ATTORNEY = 0x10, LIBFPTR_AT_COMMISSION_AGENT = 0x20, LIBFPTR_AT_ANOTHER = 0x40
}
 Виды агентов (реквизит 1057) Подробнее...
 
enum  libfptr_fn_document_type {
  LIBFPTR_FN_DOC_REGISTRATION = 1, LIBFPTR_FN_DOC_OPEN_SHIFT = 2, LIBFPTR_FN_DOC_RECEIPT = 3, LIBFPTR_FN_DOC_BSO = 4,
  LIBFPTR_FN_DOC_CLOSE_SHIFT = 5, LIBFPTR_FN_DOC_CLOSE_FN = 6, LIBFPTR_FN_DOC_OPERATOR_CONFIRMATION = 7, LIBFPTR_FN_DOC_REREGISTRATION = 11,
  LIBFPTR_FN_DOC_EXCHANGE_STATUS = 21, LIBFPTR_FN_DOC_CORRECTION = 31, LIBFPTR_FN_DOC_BSO_CORRECTION = 41
}
 Тип документа из ФН Подробнее...
 

Функции

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_fn_operation (libfptr_handle handle)
 Выполняет операцию ФН Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_fn_query_data (libfptr_handle handle)
 Запрашивает информацию из фискального накопителя Подробнее...
 
DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_fn_write_attributes (libfptr_handle handle)
 Записывает набор реквизитов в ККТ Подробнее...
 

Подробное описание

Методы для работы с фискальным накопителем

Перечисления

◆ libfptr_agent_type

Виды агентов (реквизит 1057)

,

Элементы перечислений
LIBFPTR_AT_NONE 

Не агент

LIBFPTR_AT_BANK_PAYING_AGENT 

Банковский платежный агент

LIBFPTR_AT_BANK_PAYING_SUBAGENT 

Банковский платежный субагент

LIBFPTR_AT_PAYING_AGENT 

Платежный агент

LIBFPTR_AT_PAYING_SUBAGENT 

Платежный субагент

LIBFPTR_AT_ATTORNEY 

Поверенный

LIBFPTR_AT_COMMISSION_AGENT 

Комиссионер

LIBFPTR_AT_ANOTHER 

Другой тип агента

См. определение в файле libfptr10.h строка 1639

◆ libfptr_ffd_version

Версия ФФД

Список возможных значений для параметров LIBFPTR_PARAM_FFD_VERSION, LIBFPTR_PARAM_DEVICE_FFD_VERSION, LIBFPTR_PARAM_FN_FFD_VERSION, LIBFPTR_PARAM_DEVICE_MIN_FFD_VERSION, LIBFPTR_PARAM_DEVICE_MAX_FFD_VERSION

Элементы перечислений
LIBFPTR_FFD_UNKNOWN 

Неизвестно

LIBFPTR_FFD_1_0 

ФФД 1.0.

LIBFPTR_FFD_1_0_5 

ФФД 1.0.5.

LIBFPTR_FFD_1_1 

ФФД 1.1.

См. определение в файле libfptr10.h строка 1559

◆ libfptr_fn_data_type

Тип данных ФН

Список возможных значений для параметра LIBFPTR_PARAM_FN_DATA_TYPE

Элементы перечислений
LIBFPTR_FNDT_TAG_VALUE 

Значение реквизита регистрации

LIBFPTR_FNDT_OFD_EXCHANGE_STATUS 

Статус информационного обмена с ОФД

LIBFPTR_FNDT_FN_INFO 

Информация об ФН

LIBFPTR_FNDT_LAST_REGISTRATION 

Информация о последней регистрации/перерегистрации

LIBFPTR_FNDT_LAST_RECEIPT 

Информация о последнем чеке

LIBFPTR_FNDT_LAST_DOCUMENT 

Информация о последнем документе

LIBFPTR_FNDT_SHIFT 

Информация о смене

LIBFPTR_FNDT_FFD_VERSIONS 

Информация о версиях ФФД

LIBFPTR_FNDT_VALIDITY 

Срок действия ФН

LIBFPTR_FNDT_REG_INFO 

Регистрационные данные

LIBFPTR_FNDT_DOCUMENTS_COUNT_IN_SHIFT 

Количество ФД за смену

LIBFPTR_FNDT_ERRORS 

Ошибки ФН / ОФД / сети

LIBFPTR_FNDT_TICKET_BY_DOC_NUMBER 

Квитанция ОФД по номеру документа

LIBFPTR_FNDT_DOCUMENT_BY_NUMBER 

Информация о документе по номеру

См. определение в файле libfptr10.h строка 1516

◆ libfptr_fn_document_type

Тип документа из ФН

Список возможных значений для LIBFPTR_PARAM_FN_DOCUMENT_TYPE

Элементы перечислений
LIBFPTR_FN_DOC_REGISTRATION 

Отчет о регистрации

LIBFPTR_FN_DOC_OPEN_SHIFT 

Отчет об открытии смены

LIBFPTR_FN_DOC_RECEIPT 

Кассовый чек

LIBFPTR_FN_DOC_BSO 

Бланк строгой отчетности

LIBFPTR_FN_DOC_CLOSE_SHIFT 

Отчет о закрытии смены

LIBFPTR_FN_DOC_CLOSE_FN 

Отчет о закрытии фискального накопителя

LIBFPTR_FN_DOC_OPERATOR_CONFIRMATION 

Подтверждение оператора

LIBFPTR_FN_DOC_REREGISTRATION 

Отчет об изменении параметров регистрации

LIBFPTR_FN_DOC_EXCHANGE_STATUS 

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

LIBFPTR_FN_DOC_CORRECTION 

Кассовый чек коррекции

LIBFPTR_FN_DOC_BSO_CORRECTION 

Бланк строгой отчетности коррекции

См. определение в файле libfptr10.h строка 1734

◆ libfptr_fn_operation_type

Тип операции ФН

Список возможных значений для параметра LIBFPTR_PARAM_FN_OPERATION_TYPE

Элементы перечислений
LIBFPTR_FNOP_REGISTRATION 

Регистрация ФН

LIBFPTR_FNOP_CHANGE_FN 

Замена ФН (перерегистрация)

LIBFPTR_FNOP_CHANGE_PARAMETERS 

Смена параметров (перерегистрация)

LIBFPTR_FNOP_CLOSE_ARCHIVE 

Закрытие архива ФН

См. определение в файле libfptr10.h строка 1622

◆ libfptr_fn_state

Состояние фискального накопителя

Список возможных значений для параметра LIBFPTR_PARAM_FN_STATE

Элементы перечислений
LIBFPTR_FNS_INITIAL 

Настройка ФН

LIBFPTR_FNS_CONFIGURED 

Готовность к активации

LIBFPTR_FNS_FISCAL_MODE 

Фискальный режим

LIBFPTR_FNS_POSTFISCAL_MODE 

Постфискальный режим

LIBFPTR_FNS_ACCESS_ARCHIVE 

Доступ к архиву ФН

См. определение в файле libfptr10.h строка 1253

◆ libfptr_fn_type

Тип фискального накопителя

Список возможных значений для параметра LIBFPTR_PARAM_FN_TYPE

Элементы перечислений
LIBFPTR_FNT_DEBUG 

Отладочная версия

LIBFPTR_FNT_RELEASE 

Боевая версия

LIBFPTR_FNT_UNKNOWN 

Неизвестная версия

См. определение в файле libfptr10.h строка 1236

◆ libfptr_taxation_type

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

,

Элементы перечислений
LIBFPTR_TT_DEFAULT 

По умолчанию

LIBFPTR_TT_OSN 

Общая

LIBFPTR_TT_USN_INCOME 

Упрощенная Доход

LIBFPTR_TT_USN_INCOME_OUTCOME 

Упрощенная Доход минус Расход

LIBFPTR_TT_ENVD 

ЕНВД

LIBFPTR_TT_ESN 

Единый сельскохозяйственный налог

LIBFPTR_TT_PATENT 

Панентная

См. определение в файле libfptr10.h строка 1576

Функции

◆ libfptr_fn_operation()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_fn_operation ( libfptr_handle  handle)

Выполняет операцию ФН

Общие параметры
Название Описание Тип параметра
Входные параметры
LIBFPTR_PARAM_FN_OPERATION_TYPE Тип операции ФН int (libfptr_fn_operation_type)
Реквизиты для регистрации/перегистрации ККТ
1001 Автоматический режим bool
1002 Автономный режим bool
1009 Адрес (место) расчетов string
1017 ИНН ОФД string
1018 ИНН пользователя string
1036 Номер автомата string
1037 Регистрационный номер ККТ string
1046 Наименование ОФД string
1048 Наименование пользователя string
1056 Признак шифрования bool
1057 Признак платежного агента int
1060 Адрес сайта ФНС string
1062 Системы налогообложения int
1101 Код причины перерегистрации int
1108 Признак расчетов в Интернете bool
1110 Признак АС БСО bool
1117 E-mail организации string
1109 Признак услуги bool
1126 Признак проведения лотереи bool
1187 Место расчетов string
1193 Признак проведения азартных игр bool
1205 Причина измененения параметров ККТ int
1207 Признак подакцизного товара bool
1209 Версия ФФД int (libfptr_ffd_version)
1221 Признак установки принтера в автомате bool
Предупреждения
Требует проверки результата закрытия документа - libfptr_check_document_closed().

Пример использования:

libfptr_set_param_bool(handle, 1001, false);
libfptr_set_param_bool(handle, 1002, false);
libfptr_set_param_bool(handle, 1056, false);
libfptr_set_param_bool(handle, 1108, true);
libfptr_set_param_bool(handle, 1109, false);
libfptr_set_param_bool(handle, 1221, false);
libfptr_set_param_int(handle, 1057, 0x01 | 0x04 | 0x10);
libfptr_set_param_int(handle, 1062, 0x01 | 0x20);
libfptr_set_param_int(handle, 1101, 4);
libfptr_set_param_str(handle, 1009, L"Улица свободы, 42");
libfptr_set_param_str(handle, 1017, L"123456789012");
libfptr_set_param_str(handle, 1018, L"135792468001");
libfptr_set_param_str(handle, 1036, L"513");
libfptr_set_param_str(handle, 1037, L"12345678900987654321");
libfptr_set_param_str(handle, 1046, L"ОФД \"ОФД\"");
libfptr_set_param_str(handle, 1048, L"Иванов Иван Иванович");
libfptr_set_param_str(handle, 1187, L"Улица свободы, 42");
if (libfptr_fn_operation(handle) < 0)
{
// Обработка ошибки
return;
}
Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_fn_query_data()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_fn_query_data ( libfptr_handle  handle)

Запрашивает информацию из фискального накопителя

Все входные параметры являются обязательными.

Общие параметры
Тип данных (LIBFPTR_PARAM_FN_DATA_TYPE) Описание Входные параметры Выходные параметры
НазваниеОписаниеТип параметраНазваниеОписание

Тип параметра

LIBFPTR_FNDT_TAG_VALUE Значение реквизита регистрации
LIBFPTR_PARAM_TAG_NUMBER Номер реквизита int
LIBFPTR_PARAM_TAG_VALUE Значение реквизита

Зависит от номера реквизита (см. ниже описание LIBFPTR_FNDT_REG_INFO)

LIBFPTR_FNDT_OFD_EXCHANGE_STATUS Статус информационного обмена
LIBFPTR_PARAM_OFD_EXCHANGE_STATUS Статус информационного обмена int
Битовое поле:
Бит 0 – транспортное соединение установлено
Бит 1 – есть сообщение для передачи в ОФД
Бит 2 – ожидание ответного сообщения (квитанции) от ОФД
Бит 3 – есть команда от ОФД
Бит 4 – изменились настройки соединения с ОФД
Бит 5 – ожидание ответа на команду от ОФД
LIBFPTR_PARAM_DOCUMENTS_COUNT Количество непереданных документов int
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер первого непереданного документа int
LIBFPTR_PARAM_DATE_TIME Дата и время первого непереданного документа datetime
LIBFPTR_PARAM_OFD_MESSAGE_READ Производится чтение сообщения для ОФД

bool

LIBFPTR_FNDT_FN_INFO Информация об ФН
LIBFPTR_PARAM_SERIAL_NUMBER Серийный номер string
LIBFPTR_PARAM_FN_VERSION Версия string
LIBFPTR_PARAM_FN_TYPE Тип ФН int (libfptr_fn_type)
LIBFPTR_PARAM_FN_STATE Состояние ФН int (libfptr_fn_state)
LIBFPTR_PARAM_FN_NEED_REPLACEMENT Требуется срочная замена ФН bool
LIBFPTR_PARAM_FN_RESOURCE_EXHAUSTED Исчерпан ресурс ФН bool
LIBFPTR_PARAM_FN_MEMORY_OVERFLOW Память ФН переполнена bool
LIBFPTR_PARAM_FN_OFD_TIMEOUT Превышено время ожидания ответа от ОФД bool
LIBFPTR_PARAM_FN_CRITICAL_ERROR Критическая ошибка ФН

bool

LIBFPTR_FNDT_LAST_REGISTRATION Информация о последней регистрации/перерегистрации
LIBFPTR_PARAM_DATE_TIME Дата и время datetime
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер фискального документа int
LIBFPTR_PARAM_REGISTRATIONS_COUNT Номер перерегистрации

int

LIBFPTR_FNDT_LAST_RECEIPT Информация о последнем чеке
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер фискального документа чека int
LIBFPTR_PARAM_FISCAL_SIGN Фискальный признак документа чека string
LIBFPTR_PARAM_RECEIPT_SUM Сумма, р. double
LIBFPTR_PARAM_RECEIPT_TYPE Тип чека int (libfptr_receipt_type)
LIBFPTR_PARAM_DATE_TIME Дата и время

datetime

LIBFPTR_FNDT_LAST_DOCUMENT Информация о последнем документе
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер фискального документа int
LIBFPTR_PARAM_FISCAL_SIGN Фискальный признак документаstring
LIBFPTR_PARAM_DATE_TIME Дата и время

datetime

LIBFPTR_FNDT_SHIFT Информация о смене
LIBFPTR_PARAM_RECEIPT_NUMBER Кол-во чеков за смену (номер последнего чека) int
LIBFPTR_PARAM_SHIFT_NUMBER Номер смены

int

LIBFPTR_FNDT_FFD_VERSIONS Информация о версиях ФФД
LIBFPTR_PARAM_DEVICE_FFD_VERSION Версия ФФД ККТ int (libfptr_ffd_version)
LIBFPTR_PARAM_FN_FFD_VERSION Версия ФФД ФН int (libfptr_ffd_version)
LIBFPTR_PARAM_FFD_VERSION Версия ФФД int (libfptr_ffd_version)
LIBFPTR_PARAM_DEVICE_MIN_FFD_VERSION Минимальная версия ФФД ККТ int (libfptr_ffd_version)
LIBFPTR_PARAM_DEVICE_MAX_FFD_VERSION Максимальная версия ФФД ККТ

int (libfptr_ffd_version)

LIBFPTR_FNDT_VALIDITY Срок действия
LIBFPTR_PARAM_DATE_TIME Срок действия datetime
LIBFPTR_PARAM_REGISTRATIONS_REMAIN Осталось перерегистраций int
LIBFPTR_PARAM_REGISTRATIONS_COUNT Сделано перерегистраций

int

LIBFPTR_FNDT_REG_INFO Регистрационные данные
1001 Признак автоматического режима bool
1002 Признак автономного режима bool
1009 Адрес расчетов string
1017 ИНН ОФД string
1018 ИНН организации string
1036 Номер автомата string
1037 Регистрационный номер ККТ string
1046 Наименование ОФД string
1048 Название организации string
1056 Признак шифрования bool
1057 Признак агента int
1060 Адрес сайта ФНС string
1062 Системы налогообложения int
1108 Признак ККТ для расчетов только в Интернет bool
1109 Признак расчетов за услуги bool
1110 Признак АС БСО bool
Битовое поле, соответствует libfptr_taxation_type
1117 E-mail организации string
1126 Признак проведения лотереи bool
1187 Место расчетов string
1193 Признак проведения азартных игр bool
1207 Признак подакцизного товара bool
1209 Версия ФФД int (libfptr_ffd_version)
1221 Признак установки принтера в автомате

bool

LIBFPTR_FNDT_DOCUMENTS_COUNT_IN_SHIFT Количество ФД за смену (значение имеет смысл только после закрытия смены) LIBFPTR_PARAM_DOCUMENTS_COUNT Количество ФД

int

LIBFPTR_FNDT_ERRORS Ошибки ФН / ОФД / сети
LIBFPTR_PARAM_NETWORK_ERROR Код ошибки сети int
LIBFPTR_PARAM_NETWORK_ERROR_TEXT Описание ошибки сети string
LIBFPTR_PARAM_OFD_ERROR Код ошибки ОФД int
LIBFPTR_PARAM_OFD_ERROR_TEXT Описание ошибки ОФД string
LIBFPTR_PARAM_FN_ERROR Код ошибки ФН int
LIBFPTR_PARAM_FN_ERROR_TEXT Описание ошибки ФН string
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер ФД, на котором произошла ошибка int
LIBFPTR_PARAM_COMMAND_CODE Код команды ФН, на которой произошла ошибка

int

LIBFPTR_FNDT_TICKET_BY_DOC_NUMBER Квитанция ОФД по номеру документа
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер ФД int LIBFPTR_PARAM_DATE_TIME Дата и время квитанции из ОФД (UTC) datetime
LIBFPTR_PARAM_OFD_FISCAL_SIGN Фискальный признак ОФД bytearray
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер ФД

int

LIBFPTR_FNDT_DOCUMENT_BY_NUMBER Информация о документе по номеру
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер ФД int LIBFPTR_PARAM_DATE_TIME Дата и время ФД datetime
LIBFPTR_PARAM_DOCUMENT_NUMBER Номер ФД int
LIBFPTR_PARAM_FISCAL_SIGN Фискальный признак документа чека string
LIBFPTR_PARAM_HAS_OFD_TICKET Флаг подтверждения от ОФД

bool

Пример использования:

if (libfptr_fn_query_data(handle) < 0)
{
// Обработка ошибки
return;
}
// Получение результатов запроса
bool hasTicket = (libfptr_get_param_bool(handle, LIBFPTR_PARAM_HAS_OFD_TICKET) != 0);
// ...
Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех

◆ libfptr_fn_write_attributes()

DTOX_SHARED_EXPORT int DTOX_SHARED_CCA libfptr_fn_write_attributes ( libfptr_handle  handle)

Записывает набор реквизитов в ККТ

Входными параметрами метода является набор произвольных реквизитов, которые будут переданы в ККТ.

Пример использования:

// Адрес сайта ФНС
libfptr_set_param_str(handle, 1060, L"www.nalog.ru");
// Адрес электронной почты отправителя чека
libfptr_set_param_str(handle, 1075, L"sender@company.ru");
{
// Обработка ошибки
return;
}
Аргументы
handleДескриптор
Возвращаемые значения
-1Ошибка
0Успех