Академический Документы
Профессиональный Документы
Культура Документы
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
Продажа...................................................................................................................................................... 18
1
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Отчеты........................................................................................................................................................ 25
Дневной отчет без обнуления, Х - отчет (XReport)............................................................................. 25
Дневной отчет с обнулением, Z - отчет (ZReport)............................................................................... 25
Отчет налоговых ставок за период (PrintTaxReport)........................................................................... 25
Полный периодический отчет фискальной памяти по номерам Z - отчетов (PrintRepByNumFull) ..25
Полный периодический отчет фискальной памяти по датам Z - отчетов (PrintRepByDateFull) .....25
Краткий периодический отчет фискальной памяти по номерам Z - отчетов (PrintRepByNum) .......25
Краткий периодический отчет фискальной памяти по датам Z - отчетов (PrintRepByDate) ...........26
Отчет по артикулам(PrintRepByArt)...................................................................................................... 26
Отчет по операторам(PrintRepByOperator).......................................................................................... 26
Команды принтера..................................................................................................................................... 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
Отладка....................................................................................................................................................... 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 и др.
4
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
5
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
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. Фискальный чек
Для получения фискального чека необходимо выполнить следующее:
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
Аналогично OLE – сервер записывает код ошибки в свойство (переменную) с именем LastError, а текст
ошибки в свойство (переменную) LastErrorText.
Вы можете с помощью функции ShowError с параметром True (Истина) указать OLE – серверу о
необходимости отображения описания и кода ошибки в окне сообщений.
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()
Назначение: Функция предназначена для сохранения настроек и данных в энергонезависимую память:
Плотность печати
Высота штрих-кода
Длина импульса на открытие денежного ящика
Графический логотип
Заголовки чека
Программируемые типы оплат
Параметры: Нет
Возвращаемое значение: Нет
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) – выключить.
Возвращаемое значение: Нет
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 (Ложь) – отключить печать.
Возвращаемое значение: Нет
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
SetTaxType(int iType)
Назначение: Функция предназначена для установки режима продаж. Функция может быть выполнена при
изменении или установке налогового номера (для регистратора Datecs FP3530T) или после снятия Z-отчета (для
регистратора Экселлио).
Параметры:
iType – целое число, может принимать значения: 0 – обычный режим, 1 – режим продаж наложенного типа.
Возвращаемое значение: Нет
SetSerialNum(BSTR SerialNumber)
Назначение: Функция предназначена для программирования заводского номера аппарата. Выполняется только
после форматирования фискальной памяти.
Параметры:
SerialNumber - BSTR строка, заводской номер 10 символов, 2 буквы и 8 цифр.
Возвращаемое значение: Нет
SetFiscalNumber(BSTR FN)
Назначение: Функция предназначена для программирования фискального номера регистратора.
Параметры:
FN - BSTR строка, фискальный номер, строка из 10 цифр.
Возвращаемое значение: Нет
15
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
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 символов
для Экселлио.
Возвращаемое значение: Нет
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
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 - сервером»)
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
Параметры:
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 одновременно неравными нулю – возникает
ошибка "Неверные параметры функции".
Возвращаемое значение: Нет
Параметры:
iArtNum – целое число, номер артикула запрограммированного в фискальный регистратор. Может
принимать значение от 1 до 999999999 (для Eкселліо FPU-550).
dQnty – вещественное число, количество для продажи.
dPrice – вещественное число, новая цена товара.
dPercentDisc – вещественное число, процент скидки или надбавки на товар/услугу в процентном
значении. Если значение отрицательное – осуществляется скидка, если положительное – надбавка. Может принимать
значения от –99 до 99. Общие суммы по скидкам и надбавкам печатаются в дневном отчете. Если нет необходимости
осуществлять скидку/надбавку – значение dPercentDisc необходимо передавать равным нулю.
dSumDisc – вещественное число, процент скидки или надбавки на товар/услугу в суммовом значении.
Если значение отрицательное – осуществляется скидка, если положительное – надбавка. Если нет необходимости
осуществлять скидку/надбавку – значение dSumDisc необходимо передавать равным нулю.
Внимание: при указании dPercentDisc и dSumDisc одновременно неравными нулю – возникает
ошибка "Неверные параметры функции".
Возвращаемое значение: Нет
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
21
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23, 428-72-70
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
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
CancelReceipt()
Назначение: Функция предназначена для аннулирования текущего открытого фискального чека или чека возврата.
Функция не выполнится, если чек не открыт или если была сделана полная или частичная оплата по чеку.
Возвращаемое значение: Нет
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) Если в фискальном регистраторе запрограммированы пароли отличные от принятых по
умолчанию – необходимо выполнить самостоятельно указанную выше последовательность, используя пароли,
запрограммированные в фискальный регистратор.
Параметры: Нет
Возвращаемое значение: Нет
Назначение: Функция предназначена для печати процентной скидки на группу товара. Группа товара задается при
программировании артикула функцией SetArticle. Данная функция предназначена для использования только с
регистратором Экселлио.
Параметры:
Grp – целое число, группа товара. Может принимать значения от 1 до 99.
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».
Возвращаемое значение: Нет
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
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
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
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.
Возвращаемое значение: Нет
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()
Назначение: Функция предназначена для вывода звукового сигнала фискальным регистратором.
Возвращаемое значение: Нет
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