Вы находитесь на странице: 1из 34

www.artsoft.

ua

Описание OLE сервера для фискальных


регистраторов Экселлио

Редакция: 11 ноября 2019 года

Киев 1999 – 2019


Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

ОГЛАВЛЕНИЕ
Введение....................................................................................................................................................... 3
Установка OLE драйвера............................................................................................................................. 4
Порядок работы с OLE – сервером............................................................................................................. 6
1. Создание объекта..................................................................................................................... 6
2. Инициализация работы ........................................................................................................... 7
3. Завершение работы.................................................................................................................. 7
4. Фискальный чек......................................................................................................................... 7
5. Не фискальный чек (чек комментариев)................................................................................. 7
6. Чек возврата.............................................................................................................................. 7
7. Х-отчет....................................................................................................................................... 7
8. Z-отчет....................................................................................................................................... 7
9. Отчеты за период...................................................................................................................... 7
10. Печать копии чека..................................................................................................................... 8
11. Служебный ввод/вывод............................................................................................................ 8
12. Отладка OLE – сервера............................................................................................................ 8
13. Возвращаемые значения функций библиотеки...................................................................... 8
14. Коды ошибок OLE – сервера.................................................................................................... 8
15. Значения переключателей на фискальном регистраторе..................................................... 9
16. Работа регистратора Экселлио в терминальном режиме с 1С:Предприятие ...................... 9

Инициализация........................................................................................................................................... 11
Открытие СОМ порта фискального регистратора (OpenPort)............................................................ 11
Закрытие СОМ порта фискального регистратора (ClosePort)........................................................... 11
Запись текущих настроек в энергонезависимую FLASH-память (SaveSettings)............................... 11
Установка высоты штрих-кода (SetBarcodeHeight)............................................................................. 11
Установка контрастности печати (SetPrintDensity).............................................................................. 12
Включение/выключение автоматического открытия денежного ящика (EnableAutoOpenDrawer) . .12
Установка названий дополнительных типов оплат (SetTaxName).................................................... 12
Программирование заголовков чека (SetHeaderFooter)..................................................................... 12
Чтение заголовков чека (GetHeader)................................................................................................... 12
Включение/выключение автообрезки чека (EnableCutCheck)............................................................ 12
Включение/выключение уменьшеного шрифта контрольной ленты (EnableSmallFont).................13
Включение/выключение печати логотипа на чеке (EnableLogo)........................................................ 13
Установка даты и времени в фискальном регистраторе (SetDateTime) ........................................... 13
Фискализация фискального регистратора (Fiscalise)......................................................................... 13
Установка десятичной точки, налоговых групп и ставок налогов (SetMulDecCurRF)……….…........13
Установка режима продаж (SetTaxType)……….…....................................................................... .......14
Установка заводского номера фискального регистратора (SetSerialNum)……….….......................14
Установка фискального номера регистратора (SetFiscalNumber)……….….............................. .......14
Установка налогового/идентификационного номера (SetTaxNumber)……….…..............................14
Программирование паролей операторов (SetOperatorPassword)……….….............................. .......14
Программирование имен операторов (SetOperatorName)……….….......................................... .......15
Обнуление сумм по операторам (ClearOperator)……….…......................................................... .......15
Установка пароля администратора (SetAdminPassword)……….…............................................ .......15
Удаление пароля оператора (ClearOperatorPassword)……….…............................................... .......15

Программирование артикулов и получение информации об артикулах................................................ 16


Получение информации об артикулах (GetArticlesInfo)...................................................................... 16
Программирование артикула (SetArticle)............................................................................................. 16
Удаление артикула/артикулов (DelArticle)........................................................................................... 16
Чтение артикула (GetArticle)................................................................................................................. 16
Чтение первого артикула (GetFirstArticle)............................................................................................ 17
Чтение следующего артикула (GetNextArticle).................................................................................... 17
Изменение цены артикула (ChangeArticlePrice).................................................................................. 17
Получение информации о первом свободном артикуле (GetFirstFreeArticle)................................... 18
Получение информации о последнем свободном артикуле (GetLastFreeArticle)............................. 18

Продажа...................................................................................................................................................... 18

1
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Открыть не фискальный чек (OpenNonfiscalReceipt).......................................................................... 18


Печать не фискального текста (PrintNonfiscalText)............................................................................. 18
Закрыть не фискальный чек (CloseNonfiscalReceipt).......................................................................... 18
Открыть фискальный чек (OpenFiscalReceipt).................................................................................... 18
Регистрация продажи (RegistrItem)...................................................................................................... 19
Регистрация продажи с изменением цены (RegistrItemEx)................................................................ 20
Регистрация продажи и отображение на индикатор клиента продажи (RegistrAndDisplayItem) .....20
Регистрация продажи, изменение цены и отображение на индикатор (RegistrAndDisplayItem Ex). 20
Печать фискального текста (PrintFiscalText)....................................................................................... 20
Подитог, скидка/надбавка на чек (SubTotal)........................................................................................ 20
Оплата чека (Total)................................................................................................................................ 21
Оплата чека и закрытие фискального чека (TotalEx)......................................................................... 21
Печать штрих-кода (PrintBarCode)....................................................................................................... 22
Печать разделительной линии (PrintLine)........................................................................................... 22
Закрытие фискального чека (CloseFiscalReceipt)............................................................................... 22
Отмена чека (CancelReceipt)................................................................................................................ 22
Открыть возвратный чек (OpenReturnReceipt).................................................................................... 23
Печать копии чека (MakeReceiptCopy)................................................................................................. 23
Печать нулевого чека (PrintNullCheck)................................................................................................. 23
Печать суммовой скидки на группу товара (AbsDiscGrp)................................................................... 23
Печать процентной скидки на группу товара (PerDiscGrp)................................................................. 23
Печать суммовой скидки на налоговую группу товара ( AbsDiscTax)................................................ 24
Печать процентной скидки на налоговую группу товара (PerDiscTax).............................................. 24

Отчеты........................................................................................................................................................ 25
Дневной отчет без обнуления, Х - отчет (XReport)............................................................................. 25
Дневной отчет с обнулением, Z - отчет (ZReport)............................................................................... 25
Отчет налоговых ставок за период (PrintTaxReport)........................................................................... 25
Полный периодический отчет фискальной памяти по номерам Z - отчетов (PrintRepByNumFull) ..25
Полный периодический отчет фискальной памяти по датам Z - отчетов (PrintRepByDateFull) .....25
Краткий периодический отчет фискальной памяти по номерам Z - отчетов (PrintRepByNum) .......25
Краткий периодический отчет фискальной памяти по датам Z - отчетов (PrintRepByDate) ...........26
Отчет по артикулам(PrintRepByArt)...................................................................................................... 26
Отчет по операторам(PrintRepByOperator).......................................................................................... 26

Передача информации в прикладную программу................................................................................... 27


Получить дату и время (GetDateTime)................................................................................................. 27
Получить информации о суммах фискальных или возвратных чеков (LastFiscalClosure) ..............27
Получить суммы с момента последнего Z - отчета (GetCurrentSums).............................................. 27
Получить суммы коррекций за день (GetCorectSums)........................................................................ 27
Получить размер фискальной памяти (GetFreeClosures).................................................................. 28
Получить статус фискального регистратора (GetStatus).................................................................... 28
Получить состояние фискальной транзакции (GetFiscalClosureStatus)............................................ 28
Получить диагностическую информацию (GetDiagnosticInfo)............................................................ 28
Получить налоговые ставки регистратора (GetCurrentTaxRates)...................................................... 29
Получить налоговый номер регистратора (GetTaxNumber)............................................................... 29
Получить информацию о чеке (GetReceiptInfo)................................................................................... 29
Получить информацию о дневных суммах (GetDayInfo).................................................................... 29
Получить суммы накопленные по оператору (GetOperatorInfo)......................................................... 29
Получить номер последнего чека (GetLastReceiptNum)..................................................................... 30
Получить информацию о фискальности/нефискальности регистратора (isFiscalised).................... 30
Получить продолжительность смены (GetSmenLen).......................................................................... 30
Получить дату последнего Z-отчета (GetLastClosureDate)................................................................ 30

Команды принтера..................................................................................................................................... 31
Прогон ленты фискальный принтером (AdvancePaper)..................................................................... 31
Прогон ленты фискальный принтером расширеный(AdvancePaperEx)............................................ 31
Отрезать чек (CutReceipt)..................................................................................................................... 31

Дисплей....................................................................................................................................................... 31
Очистка дисплея (ClearDisplay)............................................................................................................ 31
Вывод текста в нижний ряд (DisplayTextLL)........................................................................................ 31

2
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Вывод текста в верхний ряд (DisplayTextUL)...................................................................................... 31


Вывод даты и времени (DisplayDateTime)........................................................................................... 31
Непосредственный вывод на дисплей (DisplayFreeText)................................................................... 31

Отладка....................................................................................................................................................... 32
Включить отображение ошибок OLE-сервером (ShowError).............................................................. 32
Включить запись отладочной информации в текстовый лог-файл (Debugger) ................................ 32

Другие......................................................................................................................................................... 33
Открыть денежный ящик (OpenDrawer)............................................................................................... 33
Открыть денежный ящик с регулируемой длинной импульса (OpenDrawerEx)................................ 33
Служебный ввод/вывод денег (InOut).................................................................................................. 33
Печать диагностической информации (PrintDiagnosticInfo)............................................................... 33
Звуковой сигнал (Sound)....................................................................................................................... 33
Звуковой сигнал произвольный (SoundEx).......................................................................................... 33
Чтение статуса модема (GetLastDPAExchangeTime)......................................................................... 33

3
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Введение

Библиотека ArtSoft Exellio FPU-550 OLE – предназначена для работы прикладных программ
с фискальными регистраторами Экселлио FPU-550, Экселлио FPU-260, Экселлио LP1000,
Экселлио FP700, Экселлио FP2000 и Datecs FP3530T в операционных системах MS Windows 98 /
ME / NT / 2000 / XP / 2003 / Vista.
Данный COM сервер разработан с использованием среды разработки Microsoft Visual Studio
2005 на языке программирования C++, что обеспечивает максимальное быстродействие драйвера,
а также его минимальный объем. OLE сервер может использоваться с любыми языками
программирования и средствами разработки, поддерживающими технологию COM. Например: 1C
7.7, 1C 8.0, Delphi, Visual C++, Visual Basic Script (VBS), Visual Basic for Applications (VBA), Visual
Basic, CBuilder и др.

Установка OLE драйвера


Для установки драйвера необходимо запустить файл инсталляции ArtSoftFPU-550OLE.exe.

Для продолжения инсталляции нажмите клавишу


«Далее», для отказа от инсталляции клавишу
«Отмена».

Внимательно прочтите Лицензионное Соглашение.


Для продолжения установки выберите «Я принимаю
условия соглашения». В случае с несогласием с
соглашением выберите «Я не принимаю условия
соглашения», дальнейшая установка будет
прекращена.

4
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Выберите каталог для установки драйвера. По


умолчанию драйвер устанавливается в папку C:\
Program Files\ArtSoft\ExellioFPU-550. Нажмите
клавишу «Далее».

Выберите папку, в меню «Пуск», в которой будут


созданы ярлыки и нажмите «Далее». (По
умолчанию ярлыки создаются в папке ArtSoft\
ArtSoft Exellio FPU-550 OLE)

Для продолжения установки нажмите «Установить».


Для прерывания установки нажмите «Отмена». Для
изменения пути установки программы и пути для
ярлыков нажмите «Назад».

Для завершения установки драйвера нажмите


«Завершить».

5
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Порядок работы с OLE – сервером


Внимание!!! OLE-сервер имеет защиту от несанкционированного использования.
Защита заключается в привязке драйвера к заводскому номеру фискального
регистратора. Один инсталляционный файл может содержать неограниченное
количество лицензий.

Для приобретения программы обращайтесь:


Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Отличительные особенности работы с регистраторами Datecs и Экселлио

Функциональность моделей Экселлио и Датекс принципиально не отличается, главное отличие


только в максимальном количестве программируемых артикулов. Регистраторы Экселлио имеют
обратную совместимость с регистратором Datecs FP3530T при работе с данным OLE сервером, т.е.
все функции доступные для Datecs FP3530T аналогично будут работать и с регистраторами
Экселлио. Такая совместимость поможет без проблем перейти на регистраторы Экселлио. В
драйвере добавлены новые функции, которые могут использоваться только с регистраторами
Экселлио, такие функции выделены красным цветом, как и некоторые особенности работы
функций для разных моделей регистраторов.
Список новых функций, добавленных в регистраторах Экселлио:
Запись текущих настроек в энергонезависимую FLASH-память (SaveSettings)
Установка высоты штрих-кода (SetBarcodeHeight)
Установка контрастности печати (SetPrintDensity)
Включение/выключение автоматического открытия денежного ящика (EnableAutoOpenDrawer)
Установка названий дополнительных типов оплат (SetTaxName)
Получение информации о первом свободном артикуле (GetFirstFreeArticle)
Получение информации о последнем свободном артикуле (GetLastFreeArticle)
Регистрация продажи с изменением цены (RegistrItemEx)
Оплата чека и закрытие фискального чека (TotalEx)
Печать штрих-кода (PrintBarCode)
Печать разделительной линии (PrintLine)
Печать суммовой скидки на группу товара (AbsDiscGrp)
Печать процентной скидки на группу товара (PerDiscGrp)
Печать суммовой скидки на налоговую группу товара ( AbsDiscTax)
Печать процентной скидки на налоговую группу товара (PerDiscTax)
Отчет по артикулам(PrintRepByArt)
Отчет по операторам(PrintRepByOperator)
Получить продолжительность смены (GetSmenLen)
Получить дату последнего Z-отчета (GetLastClosureDate)
Прогон ленты фискальный принтером расширеный(AdvancePaperEx)
Звуковой сигнал произвольный (SoundEx)

1. Создание объекта
Имя объекта для создания в клиентском приложении ArtSoft.ExellioFPU-550
Пример для Visual Basic: fp = CreateObject("ArtSoft.ExellioFPU-550")
Пример для 1С:Предприятие 7.7: fp = СоздатьОбъект("ArtSoft.ExellioFPU-550");

2. Инициализация работы
Для начала работы с библиотекой необходимо вызвать функцию OpenPort. При выполнении команды происходит
обращение к фискальному регистратору и поэтому он ОБЯЗАТЕЛЬНО должен быть включен. Выполнение функции
6
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

приводит к открытию последовательного порта. Функция не выполняется если последовательный порт уже открыт
другой программой или если фискальный регистратор не включен.

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

4. Фискальный чек
Для получения фискального чека необходимо выполнить следующее:

 Запрограммировать артикул в фискальный регистратор с помощью функции SetArticle. Также вы можете


изменить цену на уже запрограммированный артикул с помощью функции ChangeArticlePrice. Для
фискального регистратора Экселлио FPU-550 допустимо использовать функцию ChangeArticlePrice прямо
в открытом фискальном чеке.
 Открыть фискальный чек вызовом функции OpenFiscalReceipt.
 Выполнить необходимое количество продаж, снабдив их необходимым количеством комментариев, используя для
этого функции RegisterItem или RegistrAndDisplayItem и PrintFiscalText. Для фискального
регистратора Экселлио FPU-550 удобно использовать функцию RegistrItemEx, которая отображает на
дисплей товар и позволяет продавать его по свободной цене.
 Выполнить функцию SubTotal для уточнения накопленной суммы по чеку, а также для осуществления
скидки/надбавки на весь чек.
 Выполнить один или несколько раз (для комбинированной формы оплаты) функции Total таким образом, чтобы
полностью покрыть сумму по чеку (возможно со сдачей). Для фискального регистратора Экселлио FPU-550
можно использовать функцию TotalEx, которая позволит при полной оплате чека не использовать функцию
CloseFiscalReceipt.
 Выполнить функцию закрытия чека CloseFiscalReceipt.

5. Не фискальный чек (чек комментариев)


Для получения нефискального чека необходимо выполнить следующее:

 Открыть не фискальный чек функцией OpenNonfiscalReceipt.


 Напечатать необходимое количество комментариев функцией PrintNonfiscalText.
 Закрыть нефискальный чек функцией CloseNonfiscalReceipt.

6. Чек возврата
 Для печати возвратного чека необходимо выполнить все действия, описанные в п.4 используя вместо функции
открытия фискального чека (OpenFiscalReceipt) функцию открытия чека возврата
(OpenReturnReceipt).

7. Х-отчет
 Для печати Х-отчета достаточно вызвать функцию XReport.

8. Z-отчет
 Для печати Z-отчета достаточно вызвать функцию ZReport.

9. Отчеты за период
Для печати периодических отчетов достаточно вызвать одну из функций:
 PrintRepByNumFull – полный отчет по номерам Z-отчетов
 PrintRepByDateFull – полный отчет по датам Z-отчетов
7
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

 PrintRepByNum – краткий отчет по номерам Z-отчетов


 PrintRepByDate – краткий отчет по датам Z-отчетов
10. Печать копии чека
 Для печати копии чека достаточно вызвать функцию MakeReceiptCopy.

11. Служебный ввод/вывод


 Для служебного внесения/вынесения денег достаточно выполнить функцию InOut.

12. Отладка OLE – сервера


 Для включения ведения log-файла отладки вызовите функцию Debugger с входным параметром True, для
остановки отладки вызовите функцию Debuggerс параметром False.

13. Возвращаемые значения функций библиотеки


Выходные параметры функций OLE сервера записываются в так называемые свойства (переменные) OLE – сервера и
имеют имена s1… s10. Тип данных этих свойств – BSTR строка. Информация, которая содержится в этих свойствах,
зависит от конкретной функции OLE сервера и детально описана в каждой функции отдельно.

Пример для Visual Basic:


Dim fp As Object
fp = CreateObject("ArtSoft.ExellioFPU-550")
fp.OpenPort 1, 115200

‘ Вызываем функцию чтения 1-ой строки заголовка чека


fp.GetHeader 1
‘ Строка заголовка будет помещена в переменную s1
d = fp.s1

 Аналогично OLE – сервер записывает код ошибки в свойство (переменную) с именем LastError, а текст
ошибки в свойство (переменную) LastErrorText.
 Вы можете с помощью функции ShowError с параметром True (Истина) указать OLE – серверу о
необходимости отображения описания и кода ошибки в окне сообщений.

14. Коды ошибок OLE – сервера:

0 Отсутствие ошибки или какого-либо другого информационного сообщения от регистратора


-1 Неверные параметры функции
1 Невозможно открыть COM порт
2 Ошибка настройки буферов COM порта
3 Ошибка настройки маски COM порта
4 Невозможно получить состояние COM порта
5 Неверная скорость СОМ порта, будет установлена 19200 бод
6 Невозможно установить таймауты COM порта
7 Ошибка установки связи с фискальным регистратором
8 Отсутствует лицензия на данный фискальный регистратор
10 Дата и время не установлены
11 Индикатор клиента не подключен
12 Закончилась чековая или контрольная лента
13 Ошибка фискализации. Таблица налоговых номеров исчерпана
14 Ошибка фискализации. Не задан фискальный номер
15 Ошибка фискализации. Неверен заводской номер или другие данные
16 Ошибка фискализации. Открыт чек
17 Ошибка фискализации. Не обнулены суммы за день. Сделайте Z-отчет
18 Ошибка фискализации. Не заданы налоговые ставки
19 Ошибка фискализации. Налоговый номер состоит из нулей
20 Ошибка фискализации. Отсутствует чековая или контрольная лента
8
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

21 Ошибка фискализации. Дата и время не установлены


22 Ошибка установки заводского номера:
 Неформатирована фискальная память
 Заводской номер уже задан
 Дата/время не установлены
23 Ошибка установки фискального номера:
 Заводской номер не задан
 Дата/время не установлены
 Открыт чек
 Необходимо сделать Z-отчет
24 Ошибка установки налогового/идентификационного номера
25 Ошибка открытия нефискального чека. Фискальная память неформатирована
26 Ошибка открытия нефискального чека. Открыт фискальный чека
27 Ошибка открытия нефискального чека. Нефискальный чек уже открыт
28 Ошибка открытия нефискального чека. Дата и время не установлены
29 Ошибка выполнения итога чека.
30 Ошибка выполнения итога чека (Вычисленная сумма отрицательная. Оплата не совершается)
31 Сумма оплаты меньше суммы чека (Информационное сообщение)
32 Сумма оплаты больше суммы чека (Информационное сообщение)
33 Ошибка выполнения итога чека. Сумма по некоторой налоговой группе отрицательна.
34 Ошибка программирования/чтения артикула.
35 Ошибка выполнения операции служебного ввода/вывода.
36 Полученные данные содержат синтаксическую ошибку.
37 Код полученной команды неверен.
38 Механизм печатающего устройства неисправен.
39 Переполнение операции суммирования.
40 Команда не разрешена для текущего фискального режима принтера.
100 Фискальный регистратор не отвечает. (Таймаут ответа от регистратора)

15. Значения переключателей на фискальном регистраторе

SW1…SW8 – переключатели на нижней крышке фискального регистратора.


Sw1 и Sw2 скорость передачи данных по СОМ порту:

Переключатель Sw1 Переключатель Sw2 Скорость


OFF (выключен) OFF (выключен) 9600 бод
ON (включен) OFF (выключен) 19200 бод
OFF (выключен) ON (включен) 57600 бод
ON (включен) ON (включен) 115200 бод

Sw3 OFF: Автообрезка запрещена.


ON: Автообрезка разрешена.
Sw4 OFF: Ограниченный доступ к индикатору клиента внутри открытого чека
ON: Полный доступ к индикатору клиента из программы
Sw5 OFF: Кодовая страница Windows 1251
ON: Кодовая страница MS-DOS
Sw6 Кодовая страница для отображения на индикатор клиента
Sw7 OFF: Обычный шрифт контрольной ленты
ON: Уменьшенный шрифт контрольной ленты
Sw8 Не используется в Datecs FP3530T, в Экселлио:
OFF: Обычный шрифт чековой ленты
ON: Уменьшенный шрифт чековой ленты

16. Работа регистратора Экселлио в терминальном режиме с 1С:Предприятие.

Для работы фискального регистратора с программой 1С:Предприятие в терминальном режиме предусмотрена


функция

9
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

SetReadTimeout(long lMsec)
Назначение: Функция предназначена для установки максимального времени ожидания прихода блоков
информации от регистратора к ПК (т.е. для установки межбайтного таймаута). Данную функцию необходимо
вызывать после создания объекта и перед открытием COM-порта.
Параметры:
long lMsec – целое число, время таймаута в миллисекундах. По умолчанию 1000 мс (1 секунда), при плохих
коммуникациях рекомендуется увеличивать (до 3500 мс и более). Рекомендуется подбирать экспериментальным
путем.

10
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Инициализация
OpenPort(int iPortNumber, int iBaudRate)
Назначение: Функция предназначена для открытия СОМ порта, к которому подключен фискальный регистратор.
Эту функцию следует вызывать первой для начала работы OLE сервера с фискальным регистратором. Фискальный
регистратор в момент вызова функции ОБЯЗАТЕЛЬНО должен быть включен, иначе СОМ порт открыт не будет.
Параметры:
iPortNumber – целое число, номер СОМ порта, к которому подключен фискальный регистратор. Может
принимать значения 1 - 255.
iBaudRate – целое число, скорость СОМ порта, к которому подключен фискальный регистратор. Может
принимать значения 9600, 19200, 57600, 115200 бод. Если указанное значение не отвечает стандартным значениям,
открытие СОМ порта происходит на скорости по умолчанию (19200 бод). Фискальный регистратор Экселлио FPU-260
может функционировать только на скорости 19200.
В фискальном регистраторе необходимо установить соответствующую скорость с помощью переключателей, которые
находятся на нижней крышке фискального регистратора. Это необходимо делать при выключенном аппарате.
Положение переключателей скорости:
Переключатель Sw1 и Sw2 определяют скорость работы СОМ порта:
Переключатель Переключатель Скорость
Sw1 Sw2
OFF (выключен) OFF (выключен) 9600 бод
ON (включен) OFF (выключен) 19200 бод
OFF (выключен) ON (включен) 57600 бод
ON (включен) ON (включен) 115200 бод
Возвращаемое значение: Нет

ClosePort()
Назначение: Функция предназначена для закрытия СОМ порта, открытого функцией OpenPort.
Возвращаемое значение: Нет

SaveSettings()
Назначение: Функция предназначена для сохранения настроек и данных в энергонезависимую память:
 Плотность печати
 Высота штрих-кода
 Длина импульса на открытие денежного ящика
 Графический логотип
 Заголовки чека
 Программируемые типы оплат

Команда запрещена, если открыт чек.


При сбросе памяти RAM принтер считывает настройки с флэш-памяти.

Данная функция предназначена для использования только с регистратором Экселли.

Параметры: Нет
Возвращаемое значение: Нет

SetBarcodeHeight(int Height)
Назначение: Функция предназначена установки высоты штрих-кода в пикселях (0.125 мм), который
печатается функцией PrintBarCode(). Данная функция предназначена для использования только с регистратором
Экселлио.

Параметры:
Height – целое число, высота штрих-кода. Может принимать значение от 24 (3 мм) до 240 (30 мм).
Возвращаемое значение: Нет

SetPrintDensity(int Density)
11
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Назначение: Функция предназначена установки контрастности печати. Данная функция предназначена для
использования только с регистратором Экселлио.

Параметры:
Density– целое число, контрастность. Может принимать значения:
1.
Сильно бледное
2.
Бледное
3.
Нормальное
4.
Контрастное
5.
Сильно контрастное
Возвращаемое значение: Нет

EnableAutoOpenDrawer(VARIANT_BOOL bEnabled)
Назначение: Функция предназначена для разрешения или запрета автоматического открытия денежного ящика по
командам Total() или InOut(). Данная функция предназначена для использования только с регистратором Экселлио.
Параметры:
bEnabled – логическое значение, включить/выключить открытие ящика. Может принимать значения: True
(Истина или цифровое значение -1) – включить автооткрытие, False (Ложь или цифровое значение 0) – выключить.
Возвращаемое значение: Нет

SetTaxName(int Tax, BSTR Name)


Назначение: Функция предназначена для установки наименований дополнительных типов оплат. Выбор типа
оплат осуществляется с помощью функции Total(). Данная функция предназначена для использования только с
регистратором Экселлио.
Параметры:
Tax– целое число, номер дополнительного типа оплаты. Может принимать значение от 1 до 4.
Name– BSTR строка, наименование типа оплат (до 24 символов).
Возвращаемое значение: Нет

SetHeaderFooter(int iLine, BSTR Text)


Назначение: Функция предназначена для установки заголовка чека и рекламной информации в чеке.
Параметры:
iLine – целое число, номер ряда в чеке. Может принимать значения: от 1 до 6 – для заголовка чека, 7-8 – для
рекламной информации в конце чека.
Text – BSTR строка, соответствующий текст для строки заголовка или рекламного текста (до 36 символов).
Возвращаемое значение: Нет

GetHeader(int iLine)
Назначение: Функция предназначена для чтения заголовка чека и рекламной информации чека.
Параметры:
iLine – целое число, номер ряда в чеке. Может принимать значения: от 1 до 6 – для заголовка чека, 7-8 – для
рекламной информации в конце чека.
Возвращаемое значение: Нет
Выходной параметр: Прочитанный из фискального регистратора заголовок чека содержится в свойстве s1.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

EnableCutCheck(VARIANT_BOOL bEnabled)
Назначение: Функция предназначена для разрешения или запрета автоматического отрезания чека. Действует до
выключения регистратора, после включения по умолчанию параметр устанавливается в соответствии с 3-им
выключателем, который находится снизу регистратора.
Параметры:
bEnabled – логическое значение, включить/выключить автообрезку. Может принимать значения: True
(Истина) – включить автообрезку, False (Ложь) – выключить.
12
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Возвращаемое значение: Нет

EnableSmallFont(VARIANT_BOOL bEnabled)
Назначение: Функция предназначена для разрешения или запрета использования уменьшенного шрифта на
контрольной ленте. Действует до выключения регистратора, после включения по умолчанию параметр
устанавливается в соответствии с 7-ым выключателем, который находится внизу регистратора.
Параметры:
bEnabled – логическое значение, включить/выключить уменьшенный шрифт. Может принимать значения:
True (Истина) – уменьшенный шрифт, False (Ложь) – нормальный шрифт.
Возвращаемое значение: Нет

EnableLogo(VARIANT_BOOL bEnabled)
Назначение: Функция предназначена для разрешения или запрета печати логотипа завода изготовителя
регистратора.
bEnabled – логическое значение, включить/выключить печать логотипа. Может принимать значения: True
(Истина) – включить печать логотипа, False (Ложь) – отключить печать.
Возвращаемое значение: Нет

SetDateTime(BSTR Date, BSTR Time)


Назначение: Функция предназначена для установки даты и времени в фискальном регистраторе. Данная команда
не будет выполнена фискальным регистратором, если указана дата, предшествующая дате последнего Z-отчета.
Величина года должна быть до 2089. Изменение даты допускается только после аварийного обнуления ОЗУ
фискального регистратора. Изменение времени допускается только после снятия Z-отчета.
Параметры:
Date – BSTR строка, определяющая дату в формате ДДММГГ
Time – BSTR строка, определяющая время в формате ЧЧ:ММ
Возвращаемое значение: Нет

Fiscalise(BSTR Pass, BSTR SerNum, BSTR TaxNum, int iTaxNumType)


Назначение: Функция предназначена для фискализации фискального регистратора. Если до выполнения функции
фискальный номер не был задан, то необходимо предварительно выполнить функцию SetTaxNumber. После
проведения фискализации невозможно фискальный регистратор вновь перевести в учебный режим.
Параметры:
Pass – BSTR строка, пароль (оператор 14) от 4 до 8 цифр. По умолчанию равен строке «0000».
SerNum – BSTR строка, заводской номер фискального регистратора (например: «ДО06000100»).
TaxNum – BSTR строка, строка из 12 цифр, содержащая налоговый/идентификационный номер.
iTaxNumType – целое число, тип налогового номера. 0 – ПН, 1 – IД.
Возвращаемое значение: Нет

SetMulDecCurRF(BSTR Pass, int iDec, BSTR TaxEnable, double dTaxA, double dTaxB,
double dTaxC, double dTaxD)
Назначение: Функция предназначена для установки десятичной точки, используемых налоговых групп и ставок
налогов
Параметры:
Pass – BSTR строка, пароль (оператор 14), строка от 4 до 8 цифр. По умолчанию равен строке «0000».
iDec – целое число, место десятичной точки. Для Украины значение равно 2.
TaxEnable – BSTR строка, четыре символа, каждый из которых имеет значение 0 – запрещен налог или 1 –
разрешен налог. Первый символ соответствует налогу А, второй – Б, третий – В, четвертый Г. Пример: разрешить
налоги А, Б, В, Г – «1111».
dTaxA – вещественное число, размер налоговой ставки А. Принимает значения от 0 до 99.99
dTaxB – вещественное число, размер налоговой ставки Б. Принимает значения от 0 до 99.99
13
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

dTaxC – вещественное число, размер налоговой ставки В. Принимает значения от 0 до 99.99


dTaxD – вещественное число, размер налоговой ставки Г. Принимает значения от 0 до 99.99
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – десятичная запятая;
s2 – разрешенные налоги (см. TaxEnable);
s3 – налог А;
s4 – налог Б;
s5 – налог В;
s6 – налог Г.

(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

SetTaxType(int iType)
Назначение: Функция предназначена для установки режима продаж. Функция может быть выполнена при
изменении или установке налогового номера (для регистратора Datecs FP3530T) или после снятия Z-отчета (для
регистратора Экселлио).
Параметры:
iType – целое число, может принимать значения: 0 – обычный режим, 1 – режим продаж наложенного типа.
Возвращаемое значение: Нет

SetSerialNum(BSTR SerialNumber)
Назначение: Функция предназначена для программирования заводского номера аппарата. Выполняется только
после форматирования фискальной памяти.
Параметры:
SerialNumber - BSTR строка, заводской номер 10 символов, 2 буквы и 8 цифр.
Возвращаемое значение: Нет

SetFiscalNumber(BSTR FN)
Назначение: Функция предназначена для программирования фискального номера регистратора.
Параметры:
FN - BSTR строка, фискальный номер, строка из 10 цифр.
Возвращаемое значение: Нет

SetTaxNumber(BSTR TaxNumber, int iType)


Назначение: Функция предназначена для установки налогового/идентификационного номера. Данная функция
используется только для учебного режима фискального регистратора. После назначения номера необходимо
использовать функцию Fiscalise.
Параметры:
TaxNumber - BSTR строка, строка из 12 цифр, содержащая налоговый/идентификационный номер.
iType – целое число, тип налогового номера. Может принимать значения: 0 – ПН, 1 - IД
Возвращаемое значение: Нет

SetOperatorPassword(int iOperNum, BSTR OldPass, BSTR NewPass)


Назначение: Функция предназначена для программирования паролей любого из 16 операторов фискального
регистратора. Вслед за инициализацией и обнулением оперативной памяти значения паролей операторов равны строке
0000. Указанный пароль используется в команде открытия фискального чека и др. Если при выполнении команды
открытия фискального чека были совершены три попытки (подряд) неверного ввода пароля, то фискальный
регистратор блокируется и прекращает работу вплоть до выключения и затем включения его вновь.
Параметры:
iOperNum – целое число, номер оператора. Может принимать значения от 1 до 16
OldPass – BSTR строка, старый пароль оператора – от 4 до 8 цифр
14
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

NewPass – BSTR строка, новый пароль оператора – от 4 до 8 цифр


Возвращаемое значение: Нет

SetOperatorName(int iOperatorNum, BSTR Password, BSTR Name)


Назначение: Функция предназначена для программирования имени любого из 16 операторов фискального
регистратора. Вслед за инициализацией и обнулением оперативной памяти значения паролей операторов равны строке
0000. Имя оператора печатается при открытии фискального чека. Если при выполнении этой команды уже был ранее
открыт фискальный чек или был указан неверный пароль, то команда не выполняется.
Параметры:
iOperatorNum – целое число, номер оператора. Может принимать значения от 1 до 16
Password – BSTR строка, пароль оператора, строка от 4 до 8 цифр
Name – BSTR строка, имя оператора (24 символов включительно).
Возвращаемое значение: Нет

ClearOperator(int iOperNum, BSTR Pass)


Назначение: Функция предназначена для обнуления информации о суммах накопленных при продажах для
данного оператора. Если при выполнении этой команды уже был ранее открыт фискальный чек или был указан
неверный пароль, то команда не выполняется.
Параметры:
iOperNum – целое число, номер оператора. Может принимать значения от 1 до 16
Pass – BSTR строка, пароль оператора, строка от 4 до 8 цифр
Возвращаемое значение: Нет

SetAdminPassword(BSTR OldPass, BSTR NewPass)


Назначение: Функция предназначена для программирования пароля администратора, с помощью которого можно
обнулять пароли любого из 16 операторов. По умолчанию запрограммированный пароль администратора – строка
«12345678».
Параметры:
OldPass – BSTR строка, старый пароль администратора, строка до 8 цифр. По умолчанию равен строке
«12345678».
NewPass – BSTR строка, новый пароль администратора, строка до 8 цифр.
Возвращаемое значение: Нет

ClearOperatorPassword(int iOperNum, BSTR AdmPass);


Назначение: Функция предназначена для обнуления паролей конкретного оператора администратором.
Параметры:
iOperNum – целое число, номер оператора. Может принимать значение от 1 до 16.
AdmPass – BSTR строка, пароль администратора, строка из 8 цифр. По умолчанию равен «12345678».
Возвращаемое значение: Нет

15
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Программирование артикулов и получение информации об


артикулах
GetArticlesInfo()
Назначение: Функция предназначена для получения информации из фискального регистратора об общем
количестве артикулов, максимальной длине имени артикула, количестве запрограммированных артикулов.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – максимальная длина артикула (размещаемая в одной строке);
s2 – всего доступных для программирования артикулов;
s3 – запрограммировано артикулов.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

SetArticle(int iCode, int iTax, int iGrp, double dPrice, BSTR Pass, BSTR Name)
Назначение: Функция предназначена для программирования артикулов в фискальный регистратор. Невозможно
запрограммировать артикул, если артикул с таким же значением кода товара iCode имеет не нулевой оборот, т.е.
уже продавался в течение дня.
Параметры:
iCode – целое число, номер артикула.
Может принимать значение от 1 до 14800 (для Datecs FP3530T) и от 1 до 999999999 (для Экселлио).
Внимание: Значение номера артикула не связано с максимальным объемом памяти в 28140 артикулов для
Экселлио FPU-550 и 59200 для Экселлио FPU-260, это разные понятия.
iTax – целое число, налоговая группа. Может принимать значения для Datecs FP3530T от 1 до 5 (А …Д -
соответственно). Для РРО Экселлио может принимать значения от 1 до 7. Группы от 1 до 4 – стандартные
программируемые налоговые группы. Группа 5 (Д) является специальной группой для товаров без налогообложения.
Группы 6 и 7 (соответственно М и Н) для РРО Экселлио являются специализированными для использования сборов.
iGrp – целое число, группа товара. Может принимать значение от 1 до 99.
dPrice – вещественное число, цена за единицу товара. Может принимать значение от 0.01 до 9999999.99
Pass – BSTR строка, пароль для программирования (оператор 14). По умолчанию пароль равен строке
«0000».
Name – BSTR строка, наименование артикула длиной до 48 символов для Datecs FP3530T и до 36 символов
для Экселлио.
Возвращаемое значение: Нет

DelArticle(BSTR Pass, int iCode)


Назначение: Функция предназначена для удаления артикула с указанным номером или всех артикулов с нулевыми
оборотами по продаже. Функция выполняется успешно только в том случае, если оборот по продажам, данного
артикула, равен нулю.
Параметры:
Pass – BSTR строка, пароль для программирования (оператор 14). По умолчанию равен строке «0000».
iCode – целое число, номер артикула. Может принимать значение от 1 до 14800 (для Datecs FP3530T) и от 1
до 999999999 (для Экселлио). Если параметр iCode равен 0, удаляются все артикулы с нулевыми оборотами по
продаже.
Возвращаемое значение: Нет

GetArticle(int iCode)
Назначение: Функция предназначена для чтения информации об артикуле, запрограммированном в фискальный
регистратор.
Параметры:
iCode – целое число, номер артикула. Может принимать значение от 1 до 14800 (для Datecs FP3530T) и от 1
до 999999999 (для Экселлио), но не более чем в ответе функции GetArticlesInfo.

16
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Возвращаемое значение: Нет


Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – результат выполнения функции («P» – успешно, «F» - ошибка);
s2 – номер артикула (код);
s3 – налоговая группа;
s4 – товарная группа;
s5 – цена артикула;
s6 – проданное количество;
s7 – стоимость проданного товара;
s8 – проданное количество в пределах чека;
s9 – стоимость проданного товара в пределах чека;
s10 – наименование артикула.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetFirstArticle()
Назначение: Функция предназначена для чтения информации об первом запрограммированном артикуле.
Возвращает информацию такого же типа, как и GetArticle. Способ использования – первой выполняется функция
GetFirstArticle, а затем выполняется многократно функция GetNextArticle до возвращения ошибки
выполнения.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – результат выполнения функции;
s2 – номер артикула (код);
s3 – налоговая группа;
s4 – товарная группа;
s5 – цена артикула;
s6 – проданное количество;
s7 – стоимость проданного товара;
s8 – проданное количество в пределах чека;
s9 – стоимость проданного товара в пределах чека;
s10 – наименование артикула.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetNextArticle()
Назначение: Функция предназначена для чтения информации о следующем запрограммированном артикуле.
Возвращает информацию такого же типа, как и GetArticle.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – результат выполнения функции;
s2 – номер артикула (код);
s3 – налоговая группа;
s4 – товарная группа;
s5 – цена артикула;
s6 – проданное количество;
s7 – стоимость проданного товара;
s8 – проданное количество в пределах чека;
s9 – стоимость проданного товара в пределах чека;
s10 – наименование артикула.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

ChangeArticlePrice(BSTR Pass, int iCode, double dPrice)


Назначение: Функция предназначена для изменения цены запрограммированного артикула. Изменение цены
невозможно, если уже открыт фискальный чек. Для регистраторов Экселлио допустимо изменение цены в открытом
фискальном чеке.
Параметры:
17
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Pass – BSTR строка, пароль для программирования (оператор 14). По умолчанию пароль равен строке
«0000».
iCode – целое число, номер артикула. Может принимать значение от 1 до 14800 (для Datecs FP3530T) и от 1
до 999999999 (для Экселлио).
dPrice – вещественное число, новая цена за единицу товара.
Возвращаемое значение: Нет

GetFirstFreeArticle()
Назначение: Функция предназначена для получения первого свободного (незапрограммированного) артикула.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах.
s1 – результат выполнения функции;
s2 – номер артикула (код);

GetLastFreeArticle()
Назначение: Функция предназначена для получения последнего свободного (незапрограммированного) артикула.
Данная функция предназначена для использования только с регистратором Экселлио.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах.
s1 – результат выполнения функции;
s2 – номер артикула (код);

Продажа
OpenNonfiscalReceipt()
Назначение: Функция предназначена для открытия нефискального чека (чека комментариев). Команда не
выполняется, если уже открыт нефискальный или фискальный чек.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – счетчик всех нефискальных чеков от последнего Z - отчета;
s2 – счетчик всех фискальных чеков от последнего Z – отчета;
s3 – счетчик всех возвратных чеков от последнего Z – отчета.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

PrintNonfiscalText(BSTR text)
Назначение: Функция предназначена для печати нефискального текста в нефискальном чеке.
Параметры:
text - BSTR строка, тестовая информация длиной до 1024 символов. В одной строке печатается 34 символа.
Возвращаемое значение: Нет

CloseNonfiscalReceipt()
Назначение: Функция предназначена для закрытия нефискального чека.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – счетчик всех нефискальных чеков от последнего Z - отчета;
s2 – счетчик всех фискальных чеков от последнего Z – отчета;
18
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

s3 – счетчик всех возвратных чеков от последнего Z – отчета.


(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

OpenFiscalReceipt(int iOperator, BSTR Password, int iPlaceNumber)


Назначение: Функция предназначена для открытия фискального чека.
Команда не выполняется если:
 уже был открыт фискальный или нефискальный чек
 переполнен счетчик чеков
 фискальная память переполнена
 фискальная память повреждена
 ошибка в параметрах команды
 заголовок чека содержит менее двух рядов
 неверно задан пароль оператора (при троекратном неправильном задании пароля фискальный регистратор
блокируется, пока не будет проведено его выключение и затем включение)
 дата и время не установлены
 не подключен индикатор покупателя
Параметры:
iOperator – целое число, номер оператора. Может принимать значения от 1 до 16.
Password - BSTR строка, пароль оператора, номер которого задан iOperator – строка от 4 до 6 цифр. По
умолчанию равен строке «0000».
iPlaceNumber – целое число, номер кассового места. Может принимать значение от 1 до 65535.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – счетчик всех нефискальных чеков от последнего Z - отчета;
s2 – счетчик всех фискальных чеков от последнего Z – отчета;
s3 – счетчик всех возвратных чеков от последнего Z – отчета.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

RegistrItem(int iArtNum, double dQnty, double dPercentDisc, double dSumDisc)


Назначение: Функция предназначена для регистрации продажи товара в фискальном чеке, а также осуществления
скидки или надбавки на товар. По данной функции из таблицы артикулов (в фискальном регистраторе) извлекается
информация о названии артикула, его цене, налоговой группе. Имя артикула печатается в одной строке с ценой и
кодом налоговой группы. Цена товара добавляется к соответствующим регистрам оперативной памяти.
Скидка/надбавка печатается в отдельной строке.
Функция не будет выполнена успешно если:
 Не открыт фискальный чек
 Нет запрограммированного артикула с указанным в функции номером
 Переполнено количество продаж в одном чеке (500)
 Функция Total уже была выполнена
 Сумма по какой-либо налоговой группе может стать отрицательной в результате выполнения функции
 Сумма для конкретного артикула в пределах чека может стать отрицательной
 Сумма скидок/надбавок приведет к общей отрицательной сумме по чеку
 Не подключен дисплей покупателя

Параметры:
iArtNum – целое число, номер артикула запрограммированного в фискальный регистратор. Может
принимать значение от 1 до 14800 (для Datecs FP3530T) и от 1 до 999999999 (для Экселлио).
dQnty – вещественное число, количество для продажи. Произведение количества на цену не должно
превышать 9 знаков (2 после запятой).
dPercentDisc – вещественное число, процент скидки или надбавки на товар/услугу в процентном
значении. Если значение отрицательное – осуществляется скидка, если положительное – надбавка. Может принимать
значения от –99 до 99. Общие суммы по скидкам и надбавкам печатаются в дневном отчете. Если нет необходимости
осуществлять скидку/надбавку – значение dPercentDisc необходимо передавать равным нулю.

19
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

dSumDisc – вещественное число, процент скидки или надбавки на товар/услугу в суммовом значении.
Если значение отрицательное – осуществляется скидка, если положительное – надбавка. Если нет необходимости
осуществлять скидку/надбавку – значение dSumDisc необходимо передавать равным нулю.
Внимание: при указании dPercentDisc и dSumDisc одновременно неравными нулю – возникает
ошибка "Неверные параметры функции".
Возвращаемое значение: Нет

RegistrItemEx(int iArtNum, double dQnty, double dPrice, double dPercentDisc, double


dSumDisc)
Назначение: Функция предназначена для регистрации продажи товара в фискальном чеке, а также осуществления
скидки или надбавки на товар. Данная функция предназначена для использования только с регистратором Экселлио.
Внимание: Основное отличие от функций RegistrItem и RegistrAndDisplayItem – возможность указывать
новую цену товара без предварительного программирования ее с помощью ChangeArticlePrice.

Параметры:
iArtNum – целое число, номер артикула запрограммированного в фискальный регистратор. Может
принимать значение от 1 до 999999999 (для Eкселліо FPU-550).
dQnty – вещественное число, количество для продажи.
dPrice – вещественное число, новая цена товара.
dPercentDisc – вещественное число, процент скидки или надбавки на товар/услугу в процентном
значении. Если значение отрицательное – осуществляется скидка, если положительное – надбавка. Может принимать
значения от –99 до 99. Общие суммы по скидкам и надбавкам печатаются в дневном отчете. Если нет необходимости
осуществлять скидку/надбавку – значение dPercentDisc необходимо передавать равным нулю.
dSumDisc – вещественное число, процент скидки или надбавки на товар/услугу в суммовом значении.
Если значение отрицательное – осуществляется скидка, если положительное – надбавка. Если нет необходимости
осуществлять скидку/надбавку – значение dSumDisc необходимо передавать равным нулю.
Внимание: при указании dPercentDisc и dSumDisc одновременно неравными нулю – возникает
ошибка "Неверные параметры функции".
Возвращаемое значение: Нет

RegistrAndDisplayItem(int iArtNum, double dQnty, double dPercentDisc, double


dSumDisc)
Назначение: Функция предназначена для регистрации и отображения на индикатор клиента продажи товара в
фискальном чеке, а также осуществления скидки или надбавки на товар.
Параметры: аналогичны функции RegistrItem
Возвращаемое значение: Нет

RegistrAndDisplayItemEx(int iArtNum, double dQnty, double dPrice, double


dPercentDisc, double dSumDisc)
Назначение: Функция предназначена для регистрации товара с возможностью изменения цены и отображения на
индикатор клиента продажи товара в фискальном чеке, а также осуществления скидки или надбавки на товар. Данная
функция предназначена для использования только с регистратором Экселлио.
Параметры: аналогичны функции RegistrItemEx
Возвращаемое значение: Нет

PrintFiscalText(BSTR text)
Назначение: Функция предназначена для печати фискального текста в фискальном чеке.
Параметры:
text - BSTR строка, текстовая информация длиной до 1024 символов. В одной строке чека печатается 24
символа для Datecs FP3530T и 34 символа для Экселлио.
Возвращаемое значение: Нет
20
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

SubTotal(double dPercentDisc, double dSumDisc)


Назначение: Функция предназначена для выполнения подитога по фискальному чека, а также для выполнения
скидки/надбавки на всю сумму, накопленную в настоящий момент по всему чеку.
Параметры:
dPercentDisc – вещественное число, процент скидки или надбавки на товар/услугу в процентном
значении. Если значение отрицательное – осуществляется скидка, если положительное – надбавка. Может принимать
значения от –99 до 99. Общие суммы по скидкам и надбавкам печатаются в дневном отчете. Если нет необходимости
осуществлять скидку/надбавку – значение dPercentDisc необходимо передавать равным нулю.
dSumDisc – вещественное число, скидка или надбавка на товар/услугу в суммовом значении. Если
значение отрицательное – осуществляется скидка, если положительное – надбавка. Если нет необходимости
осуществлять скидку/надбавку – значение dSumDisc необходимо передавать равным нулю.
Внимание: при указании dPercentDisc и dSumDisc одновременно неравными нулю – возникает ошибка
"Неверные параметры функции".
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – подсумма на текущий момент фискального чека;
s2 – сумма налогов по налоговой группе А;
s3 – сумма налогов по налоговой группе Б;
s4 – сумма налогов по налоговой группе В;
s5 – сумма налогов по налоговой группе Г;
s6 – сумма налогов по налоговой группе Д;
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

Total(BSTR Text, int iPayMode, double dSum)


Назначение: Функция предназначена для оплаты текущего фискального чека. Допускается несколько таких
команд, например, для использования различных вид оплаты.
Параметры:
Text – BSTR строка, текстовый комментарий длиной до 48 символов.
iPayMode – целое число, тип оплаты. Типы оплат 5-8 используются только с регистратором Экселлио.
Может принимать значения:
 1 – оплата наличными;
 2 – оплата в кредит;
 3 – оплата чеком;
 4 – оплата с помощью платежной карты;
 5 – Программируемый тип оплаты 1;
 6 – Программируемый тип оплаты 2;
 7 – Программируемый тип оплаты 3;
 8 – Программируемый тип оплаты 4.
dSum – вещественное число, сумма, которая вносится клиентом. Если сумма, полученная от клиента,
превышает сумму чека, то будет насчитана сдача. Может принимать нулевое значение, тогда оплата будет
произведена на всю не оплаченную сумму чека указанным типом оплаты.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – результат выполнения функции; (Соответствует кодам ошибок 29…33)
s2 – зависит от предыдущего параметра:
Если s1 равен строке “F” – ошибка
Если s1 равен строке “E” – вычисленная сумма отрицательна. Оплата не совершается.
Если s1 равен строке “D” – сумма оплаты меньше суммы чека (остаток в s2)
Если s1 равен строке “R” – сумма оплаты больше суммы чека (остаток в s2)
Если s1 равен строке “I” – сумма по некоторой налоговой группе отрицательна (текущая подсумма в s2).
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

21
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

TotalEx(BSTR Text, int iPayMode, double dSum)


Назначение: Функция предназначена для оплаты текущего фискального чека. Допускается несколько таких
команд, например, для использования различных вид оплаты. Данная функция предназначена для использования
только с регистратором Экселлио.
Внимание: Единственное отличие от функции Total – при сумме оплаты чека равной или большей суммы чека, чек
закрывается автоматически, т.е. нет необходимости в вызове функции CloseFiscalReceipt.
Параметры: аналогичны функции Total
Возвращаемое значение: Нет
Выходные параметры: аналогичны функции Total

PrintBarCode(int Type, BSTR Text)


Назначение: Функция предназначена для печати штрих-кода в чеке. Высота штрих-кода задается функцией.
Данная функция предназначена для использования только с регистратором Экселлио. Штрих-код печатается
центрированным.
Параметры:
Type – целое число, тип штрих-кода. Может принимать значения:
1. EAN8
2. EAN13
3. Code 128
4. ITF (Interleaved 2 of 5).
5. ITF (Interleaved 2 of 5).
6. QR
Text – строка, данные штрих-кода:
1. Для EAN8 – 7 или 8 символов, только цифры. В любом случае контрольная сумма рассчитывается
автоматически.
2. Для EAN13 – 12 или 13 символов, только цифры. В любом случае контрольная сумма рассчитывается
автоматически.
3. Для Code 128 – от 22 или 42 символов, цифры и буквы. Контрольная сумма рассчитывается
автоматически.
4. Для ITF (Interleaved 2 of 5) – только цифры.
5. Для ITF (Interleaved 2 of 5) – только цифры. Контрольная сумма рассчитывается и печатается автоматически.

Возвращаемое значение: Нет


Выходные параметры: Нет

PrintLine(int Type)
Назначение: Функция предназначена для печати разделительной строки в чеке. Данная функция предназначена
для использования только с регистратором Экселлио.
Параметры:
Type – целое число, тип строки. Может принимать значения:
1 - 36 символов «–»
2 - 36 символов «=»
3 – 18 символов «–» с интервалом
Возвращаемое значение: Нет
Выходные параметры: Нет

CloseFiscalReceipt()
Назначение: Функция предназначена для закрытия фискального чека или чека возврата. Команда не выполняется,
если фискальный чек не был полностью оплачен с помощью команды Total.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – счетчик всех нефискальных чеков от последнего Z - отчета;
s2 – счетчик всех фискальных чеков от последнего Z – отчета;
22
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

s3 – счетчик всех возвратных чеков от последнего Z – отчета.


(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

CancelReceipt()
Назначение: Функция предназначена для аннулирования текущего открытого фискального чека или чека возврата.
Функция не выполнится, если чек не открыт или если была сделана полная или частичная оплата по чеку.
Возвращаемое значение: Нет

OpenReturnReceipt(int iOperator, BSTR Pass, int iPlaceNum)


Назначение: Функция предназначена для открытия чека возврата.
Параметры: идентичны функции OpenFiscalReceipt
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – счетчик всех нефискальных чеков от последнего Z - отчета;
s2 – счетчик всех фискальных чеков от последнего Z – отчета;
s3 – счетчик всех возвратных чеков от последнего Z – отчета.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

MakeReceiptCopy(int iCount)
Назначение: Функция предназначена для печати копии последнего чека.
Параметры:
iCount – целое число, количество копий последнего чека. Может принимать значение 1 или 2.
Возвращаемое значение: Нет

PrintNullCheck()
Назначение: Функция предназначена для печати нулевого чека, для проверки работоспособности фискального
регистратора. Функция автоматически выполняет следующие действия:
1. Открывает фискальный чек (см. функцию OpenFiscalReceipt)
2. Выполняет печать фискального текста «НУЛЬОВИЙ ЧЕК» (см. функцию PrintFiscalText)
3. Выполняет подитог с нулевыми параметрами (см. функцию SubTotal)
4. Выполняет оплату наличными чека на сумму 0 грн (см. функцию Total)
5. Выполняет закрытие фискального чека (см. функцию CloseFiscalReceipt)
Внимание! PrintNullCheck открывает чек с параметрами: iOperator=1,
Функция
Password=”0000”, iPlaceNumber=1. (См. подробное описание функции Открытие фискального чека
OpenFiscalReceipt) Если в фискальном регистраторе запрограммированы пароли отличные от принятых по
умолчанию – необходимо выполнить самостоятельно указанную выше последовательность, используя пароли,
запрограммированные в фискальный регистратор.
Параметры: Нет
Возвращаемое значение: Нет

AbsDiscGrp(int Grp, double Dis)


Назначение: Функция предназначена для печати абсолютной (суммовой) скидки на группу товара. Группа товара
задается при программировании артикула функцией SetArticle. Данная функция предназначена для использования
только с регистратором Экселлио.
Параметры:
Grp – целое число, группа товара. Может принимать значения от 1 до 99.
Dis – вещественное число, сумма скидки. Если сумма отрицательная – осуществляется надбавка.
Возвращаемое значение: Нет

PerDiscGrp(int Grp, double Dis)


23
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Назначение: Функция предназначена для печати процентной скидки на группу товара. Группа товара задается при
программировании артикула функцией SetArticle. Данная функция предназначена для использования только с
регистратором Экселлио.
Параметры:
Grp – целое число, группа товара. Может принимать значения от 1 до 99.
Dis – вещественное число, процент скидки. Может принимать значения от –99 до 99. Если значение меньше
нуля – осуществляется надбавка.
Возвращаемое значение: Нет

AbsDiscTax(int Grp, double Dis)


Назначение: Функция предназначена для печати абсолютной (суммовой) скидки на товар с определенной
налоговой группой. Налоговая группа товара задается при программировании артикула функцией SetArticle.
Данная функция предназначена для использования только с регистратором Экселлио.
Параметры:
Grp – целое число, налоговая группа товара. Может принимать значения от 1 до 5.
Dis – вещественное число, сумма скидки. Если сумма отрицательная – осуществляется надбавка.
Возвращаемое значение: Нет

PerDiscTax(int Grp, double Dis)


Назначение: Функция предназначена для печати процентной скидки на товар с определенной налоговой группой.
Налоговая группа товара задается при программировании артикула функцией SetArticle. Данная функция
предназначена для использования только с регистратором Экселлио.
Параметры:
Grp – целое число, налоговая группа товара. Может принимать значения от 1 до 5.
Dis – вещественное число, процент скидки. Может принимать значения от –99 до 99. Если значение меньше
нуля – осуществляется надбавка.
Возвращаемое значение: Нет

24
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Отчеты
XReport(BSTR Pass)
Назначение: Функция предназначена для печати дневного отчета фискального регистратора без обнуления (Х -
отчет). В отчете также выводится информация о служебном вносе/выносе денег.
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию равен строке «0000».
Возвращаемое значение: Нет

ZReport(BSTR Pass)
Назначение: Функция предназначена для печати фискального отчета (Z - отчета) с обнулением оперативной
памяти и занесением сумм в фискальную память. В отчете также выводится информация о служебном вводе/выводе
денег.
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию равен строке «0000».
Возвращаемое значение: Нет

PrintTaxReport(BSTR Pass, BSTR BegDate, BSTR EndDate)


Назначение: Функция предназначена для печати отчета налоговых ставок за период
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию пароль равен строке «0000».
BegDate – BSTR строка, начальная дата отчета в формате ДДММГГ.
EndDate – BSTR строка, конечная дата отчета в формате ДДММГГ.
Возвращаемое значение: Нет

PrintRepByNumFull(BSTR Pass, int iBegNum, int iEndNum)


Назначение: Функция предназначена для печати полного периодического отчета из фискальной памяти по
номерам Z - отчетов.
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию равен строке «0000».
iBegNum – целое число, начальный номер Z - отчета.
iEndNum – целое число, конечный номер Z - отчета.
Возвращаемое значение: Нет

PrintRepByDateFull(BSTR Pass, BSTR BegDate, BSTR EndDate)


Назначение: Функция предназначена для печати полного периодического отчета из фискальной памяти по
номерам диапазону дат.
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию равен строке «0000».
BegDate – BSTR строка, конечная дата Z отчета, в формате ДДММГГ.
EndDate – BSTR строка, конечная дата Z отчета, в формате ДДММГГ.
Возвращаемое значение: Нет

PrintRepByNum(BSTR Pass, int iBegNum, int iEndNum)


Назначение: Функция предназначена для печати сокращенного периодического отчета из фискальной памяти по
номерам Z - отчетов.
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию пароль равен строке «0000».
iBegNum – целое число, начальный номер Z - отчета.
25
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

iEndNum – целое число, конечный номер Z - отчета.


Возвращаемое значение: Нет

PrintRepByDate(BSTR Pass, BSTR BegDate, BSTR EndDate)


Назначение: Функция предназначена для печати сокращенного периодического отчета из фискальной памяти по
номерам диапазону дат.
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию равен строке «0000».
BegDate – BSTR строка, конечная дата Z отчета, в формате ДДММГГ.
EndDate – BSTR строка, конечная дата Z отчета, в формате ДДММГГ.
Возвращаемое значение: Нет

PrintRepByArt(BSTR Pass, int iType)


Назначение: Функция предназначена для печати различных отчетов по артикулам.
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию равен строке «0000».
iType – целое число, тип отчета. Может принимать значения:
1 – отчет реализованных товаров
2 – отчет запрограммированных товаров
3 – отчет по товарным группам
Возвращаемое значение: Нет

PrintRepByOperator(BSTR Pass)
Назначение: Функция предназначена для печати отчета по операторам. В отчете распечатывается служебная
информация по операторам: продажи, скидки, надбавки, коррекции.
Параметры:
Pass – BSTR строка, пароль для отчета (оператор 15). По умолчанию равен строке «0000».
Возвращаемое значение: Нет

26
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Передача информации в прикладную программу

GetDateTime()
Назначение: Функция предназначена для чтения даты и времени из фискального регистратора.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – дата и время в формате DD-MM-YY HH:MM:SS;
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

LastFiscalClosure(int iParam)
Назначение: С помощью этой функции фискальный регистратор возвращает информацию о последнем Z-отчете.
Данные можно получить как о суммах по чекам продаж, так и о суммах по чекам возврата.
Параметры:
iParam – целое число, параметр функции. Может принимать значения: 0 – функция возвращает
информацию о суммах фискальных чеков, 1 – функция возвращает информацию о суммах возвратных чеков.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – номер последнего дневного отчета;
s2 – Сумма по налоговой группе А;
s3 – Сумма по налоговой группе Б;
s4 – Сумма по налоговой группе В;
s5 – Сумма по налоговой группе Г;
s6 – Сумма по налоговой группе Д.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetCurrentSums(int iParam)
Назначение: С помощью этой функции фискальный регистратор печатает суммы от последнего дневного отчета до
текущего момента времени.
Параметры:
iParam – целое число, параметр функции.
Может принимать значения:
0 – функция возвращает информацию о продажах за день (от последнего Z – отчета)
1 – функция возвращает информацию о возвратах за день (от последнего Z – отчета)
2 – функция возвращает информацию о налогах по продажам за день (от последнего Z – отчета)
3 – функция возвращает информацию о налогах по возвратам за день (от последнего Z – отчета)
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – Сумма по налоговой группе А;
s2 – Сумма по налоговой группе Б;
s3 – Сумма по налоговой группе В;
s4 – Сумма по налоговой группе Г;
s5 – Сумма по налоговой группе Д.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetCorectSums()
Назначение: С помощью этой функции вычисляются и возвращаются фискальным регистратором суммы
коррекций, насчитанные от последнего Z – отчета до момента выполнения функции.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – Сумма всех продаж;
s2 – Сумма по внутричековым коррекциям;
s3 – Сумма оплат по кредиту;
27
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

s4 – Счетчик всех нефискальных чеков от последнего Z - отчета;


s5 – Счетчик всех фискальных чеков от последнего Z - отчета;
s6 – Счетчик всех возвратных чеков от последнего Z - отчета;
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetFreeClosures()
Назначение: С помощью этой функции можно получить размер свободной фискальной памяти регистратора.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – размер свободной фискальной памяти;
s2 – повторяет предыдущий параметр;
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetStatus(VARIANT_BOOL bWait)
Назначение: Функция предназначена для чтения статуса фискального регистратора. Подробнее см. «Протокол
обмена фискального регистратора Датекс FP3530T».
Параметры:
BWait – логический тип,
принимает значения:
True (Истина) – фискальный принтер вначале допечатывает содержимое буфера печати,
False (Ложь) – фискальный принтер не допечатывает буфер печати перед возвратом результата.
Возвращаемое значение: Нет

GetFiscalClosureStatus(VARIANT_BOOL bCurrent)
Назначение: Функция возвращает состояние фискальной транзакции фискального регистратора.
Параметры:
bCurrent – логический тип,
принимает значения:
True (Истина) – возвращается информация о суммах оплат в последнем чеке
False (Ложь) – не возвращается информация о суммах оплат в последнем чеке (свойство s4)
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – 1 – открыт фискальный или нефискальный чек, 0 – нет открытого чека;
s2 – количество артикулов проданных в чеке;
s3 – сумма по чеку;
s4 – сумма, которую заплатил клиент в последнем чеке.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetDiagnosticInfo(VARIANT_BOOL bCalcCRC)
Назначение: Функция возвращает диагностическую информацию фискального регистратора.
Параметры:
bCalcCRC – логический тип,
принимает значения:
True (Истина) – вычислять контрольную сумму фискальной памяти
False (Ложь) – не вычислять контрольную сумму фискальной памяти
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – версия программного обеспечения;
s2 – контрольная сумма программного обеспечения;
s3 – состояние переключателей фискального регистратора (0 – выкл., 1 – вкл.);
s4 – код страны;
s5 – заводской номер фискального регистратора;
s6 – фискальный номер.

28
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetCurrentTaxRates()
Назначение: Функция возвращает текущие налоговые ставки фискального регистратора.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – ставка налоговой группы А;
s2 – ставка налоговой группы Б;
s3 – ставка налоговой группы В;
s4 – ставка налоговой группы Г.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetTaxNumber()
Назначение: Функция возвращает налоговый/идентификационный номер и тип номера (ПН или IД).
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – налоговый номер;
s2 – тип номера (0 – ПН, 1 – IД).
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetReceiptInfo()
Назначение: Функция возвращает информацию о чеке.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – 0 - продажа с отрицательным знаком невозможна, 1 – возможна. Фактически означает была ли сделана хоть одна
оплата по данному чеку;
s2 – общая сумма по налоговой группе А;
s3 – общая сумма по налоговой группе Б;
s4 – общая сумма по налоговой группе В;
s5 – общая сумма по налоговой группе Г;
s6 – общая сумма по налоговой группе Д;
s7 – 1 – открыт расширенный чек.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetDayInfo()
Назначение: Функция возвращает информацию о распределении сумм за день по способам оплаты.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – Счетчик наличных платежей;
s2 – Счетчик оплаты в кредит;
s3 – Счетчик оплаты по дебетной карте;
s4 – Счетчик оплаты по чеку;
s5 – Номер последнего дневного Z - отчета;
s6 – Номер следующего фискального чека от последнего Z - отчета;
s7 – Глобальный счетчик чеков.
Для фискального регистратора Экселлио доступны также свойства:
s8 – Программируемый тип оплаты 1
s9 – Программируемый тип оплаты 2
s10 – Программируемый тип оплаты 3
s11 – Программируемый тип оплаты 4

(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

29
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

GetOperatorInfo(int iOperNum)
Назначение: Функция возвращает информацию о суммах накопленных для указанного оператора.
Параметры:
iOperNum – целое число, номер оператора от 1 до 16.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – Номер оператора (от 1 до 16);
s2 – Счетчик чеков;
s3 – Количество продаж и сумма продаж;
s4 – Количество скидок и сумма скидок;
s5 – Количество надбавок и сумма надбавок;
s6 – Количество чеков возврата и сумма чеков возврата;
s7 – Имя оператора.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetLastReceiptNum()
Назначение: Функция возвращает номер последнего закрытого чека
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – Номер последнего закрытого чека.
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

int isFiscalised()
Назначение: Функция читает информацию из фискального регистратора о том зафискализирован он или нет.
Возвращаемое значение: возвращаемое значение целого типа, может принимать значения:
1 – фискальный регистратор фискализирован
0 – фискальный регистратор не фискализирован

GetSmenLen()
Назначение: Функция читает продолжительность смены. Данная функция предназначена для использования только
с регистратором Экселлио.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – Может принимать значения:
Z – нет чеков за день
P – продолжительность смены менее 24 часов
F – продолжительность смены более 24 часов
s2 – продолжительность смены в минутах (до 1440 мин)
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

GetLastClosureDate()
Назначение: Функция предназначена для чтения даты последнего Z-отчета. Данная функция предназначена для
использования только с регистратором Экселлио.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – дата последнего Z-отчета в формате ДД-MM-ГГГГ
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

30
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Команды принтера
AdvancePaper(int Lines)
Назначение: Функция предназначена для прогона ленты принтером фискального регистратора.
Назначение:
Lines – целое число,количество строк для прогона ленты. Может принимать значение от 1 до 99.
Возвращаемое значение: Нет

AdvancePaperEx(int Lines, int Type)


Назначение: Функция предназначена для прогона ленты принтером фискального регистратора. Данная
функция предназначена для использования только с регистратором Экселлио.
Назначение:
iLines – целое число, количество строк для прогона ленты. Может принимать значение от 1 до 99.
Type – целое число, определяет тип ленты. Может принимать значение от 0 до 3.
0.
Нет эффекта
1.
Продвижение чековой ленты
2.
Продвижение контрольной ленты
3.
Продвижение чековой и контрольной ленты.
Возвращаемое значение: Нет

CutReceipt()
Назначение: Функция предназначена для отрезки чека.
Возвращаемое значение: Нет

Дисплей
ClearDisplay()
Назначение: Функция предназначена для очистки дисплея.
Возвращаемое значение: Нет

DisplayTextLL(BSTR text)
Назначение: Команда предназначена для вывода информации в нижний ряд дисплея.
Параметры:
text – BSTR строка, текстовая информация длиной до 20 символов.
Возвращаемое значение: Нет

DisplayTextUL(BSTR text)
Назначение: Функция предназначена для вывода информации в верхний ряд дисплея.
Параметры:
text – BSTR строка, текстовая информация длиной до 20 символов.
Возвращаемое значение: Нет

DisplayDateTime()
Назначение: Функция предназначена для вывода даты и времени, установленных в регистраторе, на дисплей.
Возвращаемое значение: Нет

DisplayFreeText(BSTR text)
Назначение: Функция предназначена для непосредственного вывода на дисплей.
Параметры:
text – BSTR строка, текстовая информация длиной до 40 символов.
Возвращаемое значение: Нет

31
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Отладка
ShowError(VARIANT_BOOL bShow)
Назначение: Функция предназначена для отображения ошибок, возникающих в процессе работы, самим OLE-
сервером.
Параметры:
bShow – логический тип, принимает значения:
True (Истина) – отображать ошибки в виде окна сообщений
False (Ложь) – не отображать ошибки
Возвращаемое значение: Нет

Другие
OpenDrawer()
Назначение: Функция предназначена для открытия денежного ящика.
Возвращаемое значение: Нет

OpenDrawerEx(int iMsc)
Назначение: Функция предназначена для открытия денежного ящика. Функция автоматически вызывается после
закрытия чека, служебного внесения/вынесения денег, Х-отчета, Z-отчета.
Параметры:
iMsc– целое число, длина импульса в миллисекундах (5 - 150).
Возвращаемое значение: Нет

InOut(double dSum)
Назначение: Функция предназначена для служебного ввода/вывода денег. (Например: внос разменной монеты,
служебный вынос при инкассации). Команда не выполняется, если сумма служебного вывода денег превышает сумму
выторга с момента последнего Z отчета вместе с суммой служебного внесения.
Функция не выполняется:
 При выплате суммы большей, чем денежная наличность в кассе,
 При вызове функции в незавершенном фискальном или служебном чеке.
Параметры:
DSum – вещественное число, если сумма положительная – выполняется служебное внесение денег, если
отрицательная – вынесение.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – Наличность в фискальном регистраторе;
s2 – Общая сумма всех служебно внесенных сумм в фискальный регистратор за день;
s3 – Общая сумма всех служебно выплаченных сумм за день;
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

PrintDiagnosticInfo()
Назначение: Функция предназначена для печати диагностической информации фискального регистратора.
Возвращаемое значение: Нет

Sound()
Назначение: Функция предназначена для вывода звукового сигнала фискальным регистратором.
Возвращаемое значение: Нет

SoundEx(int Hz, int Ms)


Назначение: Функция предназначена для вывода звукового сигнала фискальным регистратором с произвольной
частотой и длительностью.
Параметры:
32
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua

Hz – целое число, частота звука в Гц. Может принимать значение от 100 до 5000.
Ms – целое число, продолжительность звукового сигнала в миллисекундах. Может принимать значение от 50
до 2000.
Возвращаемое значение: Нет

GetLastDPAExchangeTime()
Назначение: Функция предназначена для чтения статуса модема. Функция доступна только для версий
регистраторов с модемом для передачи данных в налоговую инспекцию.
Возвращаемое значение: Нет
Выходные параметры: Прочитанные из фискального регистратора с помощью этой функции данные будут
записаны в свойствах:
s1 – результат выполнения функции;
s2 – Дата и время последнего успешного соединения с сервером (Пример: 26:04:13 15:05:10)
s3 – Периодичность соединения с сервером (Пример: 3600)
s4 – Номер последнего переданного пакета данных
s5 – Номер последнего непереданного пакета данных
s6 – Статус ошибки.
Может принимать значения:
«OK» – Модем работает в штатном режиме.
«MAX_72H» – Нет связи с сервером 72 часа, регистратор заблокирован «MAX_EXC» – Получено более 3 телеграмм
исключительных состояний. Обратитесь в ЦСО.
«ERR_CON» – Последний сеанс связи был не успешный
(Подробнее о свойствах см. п.13 «Порядок работы с OLE - сервером»)

33

Вам также может понравиться