Академический Документы
Профессиональный Документы
Культура Документы
(044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
1
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
ОГЛАВЛЕНИЕ
ОГЛАВЛЕНИЕ............................................................................................................................................... 2
Введение....................................................................................................................................................... 3
Установка Универсального драйвера в системе Windows........................................................................5
Порядок работы с драйвером...................................................................................................................... 7
Создание объекта в системе Windows....................................................................................................... 7
Инициализация работы................................................................................................................................ 7
Завершение работы..................................................................................................................................... 7
Фискальный чек продажи и возврата.......................................................................................................... 7
Не фискальный чек (чек комментариев)..................................................................................................... 7
Х-отчет.......................................................................................................................................................... 8
Z-отчет.......................................................................................................................................................... 8
Отчеты за период......................................................................................................................................... 8
Печать копии чека........................................................................................................................................ 8
Служебный ввод/вывод............................................................................................................................... 8
Свойства и обработка ошибок..................................................................................................................... 8
Эмулятор фискального регистратора......................................................................................................... 9
Инициализация........................................................................................................................................... 11
Продажа/возврат товара........................................................................................................................... 14
Печать отчетов........................................................................................................................................... 26
Вывод на дисплей покупателя.................................................................................................................. 29
Приложение................................................................................................................................................ 30
Универсальные коды ошибок фискальных регистраторов.....................................................................30
Код ошибки - значение свойства LastError...............................................................................................30
Текст ошибки – значение свойства LastErrorText....................................................................................30
Расширенные коды ошибок регистраторов с протоколом Datecs (Экселлио).......................................32
Расширенные коды ошибок регистраторов с протоколом Криптон........................................................33
Расширенные коды ошибок регистраторов с протоколом Мария..........................................................36
Расширенные коды ошибок регистраторов с протоколом ИКС..............................................................40
Расширенные коды ошибок фискальных регистраторов с протоколом Юнисистем.............................41
Перечень изменений версий ПО «Универсальный драйвер РРО»........................................................44
2
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Введение
3
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Основные преимущества:
1. Кроссплатформенная работа драйвера на Windows 7 (и выше) и Linux (x86, arm) системах.
2. Универсальность работы с поддерживаемыми моделями фискальных регистраторов.
3. Быстрое и легкое подключение неограниченного количества регистраторов к одному ПК.
4. Простой переход на любую поддерживаемую модель регистратора.
5. Работа с регистраторами в терминальном режиме.
6. Самостоятельное управление кодами артикулов и программированием артикулов.
7. Самостоятельный контроль параметров артикулов.
8. Универсальная обработка ошибок регистраторов.
9. Протоколирование работы драйвера и регистратора;
10. Низкоуровневое управление регистратором с помощью специализированных интерфейсов.
11. Наличие встроенного эмулятора фискального регистратора.
4
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
5
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
6
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Инициализация работы
Для начала работы с библиотекой необходимо вызвать функцию start с указанием конкретного типа фискального
регистратора. Затем выполнить функцию openPort с указанием имени последовательного СОМ-порта и скорости
подключения к фискальному регистратору. Для фискальных регистраторов с типом подключения TCP/IP необходимо
использовать функцию openPortEx. При выполнении команды происходит обращение к фискальному регистратору и
поэтому он ОБЯЗАТЕЛЬНО должен быть включен и подключен к ПК или сети.
Завершение работы
Для завершения работы с фискальным регистратором необходимо дождаться завершения последней функции, а затем
последовательно вызвать функции closePort и stop. Завершение работы приводит к отключению последовательного
порта, к которому подключен фискальный регистратор, или закрытие TCP/IP соединения при сетевом подключении.
Чек продажи
Открыть фискальный чек вызовом функции beginFiscalReceipt с указанием типа чека “чек продаж” и именем
кассира.
Выполнить необходимое количество продаж, снабдив их необходимым количеством комментариев, используя для
этого функции printRecItem и printText.
Выполнить один или несколько раз (для комбинированной формы оплаты) функции printRecTotal или
printRecTotalEx (printRecTotalCard) таким образом, чтобы полностью покрыть сумму по чеку
(возможно со сдачей) или указывая сумму равную нулю для оплаты всей суммы указанным типом оплат.
Выполнить функцию закрытия чека endFiscalReceipt.
Чек возврата
Отличие чека возврата от чека продажи заключается только в указании типа чека “чек возврата” в функции
beginFiscalReceipt. Остальные вызовы функций полностью соответствуют чеку продажи.
Не фискальный чек (чек комментариев)
Для получения нефискального чека необходимо выполнить следующее:
7
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Х-отчет
Для печати Х-отчета достаточно вызвать функцию printXReport.
Z-отчет
Для печати Z-отчета достаточно вызвать функцию printZReport.
Отчеты за период
Для печати периодических отчетов достаточно вызвать функцию printPeriodicReport с указанием типа отчета
и необходимыми параметрами.
Служебный ввод/вывод
Для служебного внесения/вынесения денег достаточно выполнить функцию printRecCash.
8
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Windows: LastError Целое число, Универсальный для всех регистраторов код последней
только для чтения ошибки. Код равен нулю в случае успешного
Linux: int getLastError() (Read-only) выполнения функции. Коды ошибок: Приложение
Windows: LastErrorEx Целое число, Коды ошибок конкретной модели фискального
только для чтения регистратора. Содержит код из расширенной таблицы
Linux: int getLastErrorEx() (Read-only) кодов или ноль в случае успешного выполнения
функции. Коды ошибок: Приложение
Windows: LastErrorText Строка, только Содержит текст последней ошибки (на русском языке)
для чтения (Read- универсальный для всех моделей фискальных
Linux: char* only) регистраторов. Пустая строка в случае успешного
getLastErrorText() выполнения.
Windows: LastErrorExText Строка, только Содержит текст последней ошибки (на русском языке)
для чтения (Read- для конкретной модели фискального регистратора.
Linux: char* only) Пустая строка в случае успешного выполнения.
getLastErrorExText()
Windows: SmenNum Целое число, Номер смены фискального регистратора (номер Z-
только для чтения отчета). Т.к. для получения номера выполняются
Linux: int getSmenNum() (Read-only) функции чтения данных из регистратора, свойство
актуально только при подключенном регистраторе, при
ошибке получения данных содержит нулевое значение.
При ошибке чтения номера могут быть перезаписаны
коды и описание последних ошибок.
Windows: SN Строка, только Заводской номер фискального регистратора. Свойство
для чтения (Read- доступно после успешного подключения к фискальному
Linux: getSN() only) регистратору.
Windows: CASH Вещественное Сумма наличности в кассе. Т.к. для получения суммы
число, только для выполняются функции чтения данных из регистратора,
Linux: double getCASH() чтения (Read- свойство актуально только при подключенном
only) регистраторе, при ошибке получения данных содержит
нулевое значение. При ошибке чтения номера могут
быть перезаписаны коды и описание последних ошибок.
Windows: LastReceiptNum Целое число, Номер последнего фискального чека. Т.к. для получения
только для чтения номера выполняются функции чтения данных из
Linux: int (Read-only) регистратора, свойство актуально только при
getLastReceiptNum() подключенном регистраторе, при ошибке получения
данных содержит нулевое значение. При ошибке чтения
номера могут быть перезаписаны коды и описание
последних ошибок.
Windows: Строка, только Содержит низкоуровневые данные, полученные после
LOWLEVELDATA для чтения (Read- выполнения функции lowLevelCommand.
only)
Linux: int
getLowLevelData()
Все функции работы с фискальным регистратором возвращают результат выполнения. Результат логического типа:
Windows: VARIANT_BOOL, Linux: bool. Результат может принимать значение Истина (True) в случае успеха
или Ложь (False) в случае ошибки. Для детального анализа ошибки можно анализировать свойство LastError, которое
содержит код результата выполнения последней функции. Таблица кодов универсальная для всех моделей фискальных
регистраторов и представлена в Приложении.
Эмулятор фискального регистратора
Универсальный драйвер содержит встроенный эмулятор фискального регистратора.
Данный эмулятор предназначен для тестирования подключения учетных программ к
регистраторам, с использованием данного Универсального драйвера, без физического
наличия регистратора. Эмулятор также позволяет выполнять печать чеков на любые
стандартные принтера, подключенные к операционной системе. Эмулятор содержит
встроенный эмулятор дисплея покупателя (табло).
За основу взят внешний вид чека популярных регистраторов с протоколом Datecs
(Datecs 3530T, Экселлио и т.п.). Внешний вид и содержимое чека могут отличаться на
9
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
других моделях регистраторов. Также регистраторы могут иметь свои особенности печати, расчета скидок, поддержки
команд и отчетов. Детальная информация об этих особенностях описана в руководстве пользователя и протоколе
взаимодействия регистратора с ПК и предоставляется производителем регистраторов.
Порядок работы с эмулятором полностью соответствует порядку работы с реальным регистратором. Окно
эмулятора автоматически открывается при выполнении функции start с необходимым параметром. При выполнении
функции stop окно эмулятора будет закрыто, это необходимо учитывать при работе с эмулятором.
Кнопка предназначена для включения режима генерации произвольных ошибок фискального регистратора. Уровень
частоты ошибок выставляется ползунком настроек.
Клавиши предназначены для прокрутки длинных чеков. Возможно использование колесика мышки или
клавиш управления курсором.
10
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Инициализация
Windows: VARIANT_BOOL start(LONG PrinterModel)
Linux: void start(PrinterModelType PrinterModel)
Назначение: Функция предназначена для начала работы драйвера фискальных регистраторов.
Параметры:
PrinterModel – целое число, тип фискального регистратора. Может принимать значения:
Значение Модели фискальных регистраторов
0 Все регистраторы в протоколе «Датекс»
Datecs FP3530T
ЕКСЕЛЛІО FPU-550
ЕКСЕЛЛІО FPU-550ES
ЕКСЕЛЛІО FP-280
ЕКСЕЛЛІО FPU-260
ЕКСЕЛЛІО LP-1000
ЕКСЕЛЛІО FP-700
ЕКСЕЛЛІО FP-2000
ЕКСЕЛЛІО FPР-350
KBM FP-S651
KBM FP-СMP10
1 Все регистраторы в протоколе «Криптон»
Datecs FP3530T
Datecs FP-3141T
Datecs FP-T260
Datecs CMP-10
Datecs CMP-10M
Datecs FP–Т88
Datecs FP–320
Datecs FP–101 SMART
Datecs FP-7197
2 Мария 301МТМ
Мария-304Т
Мария-304Т1
Мария-304Т2
3 IKС-483 LT
IKС-Е260Т
ІКС E-810T
ІКС-С651Т
ІКС-А8800
ІКС-E07
MG-T808TL
MG N707TS (RS-232)
MG-Р777TL (RS-232)
MG-T787TL (RS-232)
FR90.XM (RS-232)
ФР7
4 MIНI-ФП4
MIНI-ФП6
5 MINI-Т 400ME
MINI-Т 51.01
MINI-Т 61.01
МІНІ-ФП54.01
МІНІ-ФП81.01
МІНІ-ФП82.01
ВІКІНГ-Р10
11
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
ВІКІНГ-Р20
ВІКІНГ-Р21
6 MG N707TS (TCP/IP)
MG-Р777TL (TCP/IP)
MG-T787TL (TCP/IP)
FR90.XM (TCP/IP)
7 LeoCAS -200
LeoCAS -201
100 ЭМУЛЯТОР ФИСКАЛЬНОГО РЕГИСТРАТОРА
Возвращаемое значение:
Windows: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла ошибка.
Linux: Нет
Значение Скорость
1 4800 бод
2 9600 бод
3 19200 бод
4 38400 бод
5 57600 бод
6 115200 бод
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
12
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Примечание:
13
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Продажа/возврат товара
Windows: VARIANT_BOOL beginFiscalReceipt(LONG Type, BSTR cashierName)
Linux: bool beginFiscalReceipt(CheckType Type, char* cashierName)
Назначение: Функция предназначена для открытия фискального чека продажи или возврата.
Параметры:
Type – целое число, тип фискального чека. Может принимать значения: 0 – чек продажи, 1 – чек возврата.
cashierName – Имя кассира, будет отпечатано непосредственно перед содержимым чека.
Windows: BSTR строка, Linux: строка char в кодировке Windows-1251
Количество символов в имени зависит от модели фискального регистратора, лишние символы автоматически
удаляются.
Длина имени кассира Модели регистраторов
9 символов Мария 301МТМ (версии до Т7)
15 символов IKС-483 LT
IKС-Е260Т
ІКС E-810T
ІКС-С651Т
ІКС-А8800
MG-T808TL
MG N707TS (RS-232)
MG-Р777TL (RS-232)
MG-T787TL (RS-232)
ФР7
MIНI-ФП4
MIНI-ФП6
36 символов Мария 301МТМ
Мария-304Т
Мария-304Т1
Мария-304Т2
24 символа Datecs FP3530T (протокол Датекс)
DATECS FP–101 SMART
ЕКСЕЛЛІО FPU-550
ЕКСЕЛЛІО FPU-550ES
ЕКСЕЛЛІО FPU-260
ЕКСЕЛЛІО LP-1000
ЕКСЕЛЛІО FP-700
ЕКСЕЛЛІО FP-2000
ЕКСЕЛЛІО FPР-350
KBM FP-S651
KBM FP-СMP10
MINI-Т 400ME
MINI-Т 51.01
MINI-Т 61.01
МІНІ-ФП54.01
МІНІ-ФП81.01
МІНІ-ФП82.01
1024 символа Datecs FP3530T (протокол Криптон)
(печать в виде комментария) Datecs FP-3141T
Datecs FP-T260
Datecs CMP-10
Datecs FP–Т88
Datecs FP–320
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
15
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Linux:bool printRecItem(char* name, double price, double qty, TaxType tax, double
SumDis, double PerDis)
Назначение: Функция предназначена для продажи/возврата товара в фискальном чеке. Функция автоматически
генерирует код товара и при необходимости программирует товар в фискальный регистратор. Также функция
автоматически следит за изменениями параметров: наименование, цена, налоговая группа, делимость товара.
При изменении этих параметров уже проданных товаров, функция автоматически (при необходимости)
программирует товар с необходимыми характеристиками. Функция позволяет продавать один и тот же товар по разной
цене в одном чеке, даже если этого не поддерживает модель фискального регистратора.
Все артикулы сохраняются в локальной базе данных для каждого фискального регистратора отдельно и находятся
в каталоге с установленным драйвером. Имя файла содержит заводской номер фискального регистратора, например:
ИП00000007 или 5000002268. Обнуление артикулов из базы данных происходит при снятии Z-отчета непосредственно из
данного драйвера. При необходимости можно удалить соответствующий файл артикулов фискального регистратора
вручную, выполнять удаление файла допускается только после выполнения Z-отчета.
Для нормальной работы драйвера с новым фискальным регистратором необходимо чтобы фискальный регистратор
был обнулен (выполнен Z-отчет). В противном случае могут возникнуть проблемы связанные с продажей или
программированием товаров. При переполнении памяти фискального регистратора (для программирования товаров)
дальнейшая работа возможна только для продажи уже ранее проданных и запрограммированных товаров с
установленными характеристиками. Для продажи новых товаров или товаров с другими характеристиками необходимо
выполнить обнуление фискального регистратора с помощью функции printZReport.
Параметры:
name – Наименование товара. Количество символов зависит от модели и версии регистратора. Лишние
символы удаляются автоматически. Допускается передача значения кода УКТЗЕД в наименовании товара. Код УКТЗЕД
должен передаваться до наименования товара и отделятся от самого наименования символом #. Пример: 123456#Пиво.
Если модель и версия РРО поддерживают печать кода УКТЗЕД, значение будет напечатано в отдельной специальной
строке, иначе – значение будет напечатано в наименовании товара. Также можно использовать специальную функцию
для передачи кода УКТЗЕД - setU.
Windows: BSTR строка, Linux: строка char в кодировке Windows-1251
ІКС-А8800
MG-T808TL
MG N707TS (RS-232)
MG-Р777TL (RS-232)
MG-T787TL (RS-232)
ФР7
Datecs FP3530T (протокол Криптон)
Datecs FP-3141T
Datecs FP-T260
Datecs CMP-10
Datecs FP–Т88
Datecs FP–320
128 символов Мария 301МТМ
Мария-304Т
Мария-304Т1
Мария-304Т2
В режиме работы артикульной группы «Регистрация новых по бухгалтерским кодам»
price – вещественное число, цена товара за единицу. Количество знаков дробной части - 2. Некоторые модели
поддерживают 3 знака в дробной части, что не рекомендуется.
qty – вещественно число, количество товара. Количество знаков дробной части – 3. Некоторые модели могут
содержать ограничение максимального количества целого и дробного товара.
tax – целое число, налоговая группа товара. Соответствует налоговой группе запрограммированной в
фискальный регистратор. Количество ставок зависит от моделей фискального регистратора. Перед использованием
ставка должна быть запрограммирована в фискальном регистраторе сервисным центром. Номер налоговой группы
соответствует буквенному обозначению налоговой группы фискального регистратора – А, Б, В….З соответственно
1,2,3…8. Рекомендуется использование специальных значений налоговых ставок, при использовании которых драйвер
автоматически использует необходимую налоговую ставку конкретной модели фискального регистратора
(запрограммированную по умолчанию). При нестандартных настройках фискального регистратора необходимо
самостоятельно задавать соответствующие значения ставки 1,2,3…8.
Использование акцизного сбора на алкоголь, сигареты и др.: Для продажи товаров с использованием акцизного сбора
необходимо обратится в центр сервисного обслуживания фискальных регистраторов для программирования РРО. Для
каждой модели РРО производителем описана своя методика программирования акциза и размера ставки акциза. При
продаже товара с акцизом необходимо передавать параметр tax в соответствии с налоговой ставкой указанной
сервисным центром.
SumDisc – вещественное число, суммовая скидка на позицию. Положительное число обозначает надбавку,
отрицательное – скидку.
PerDisc – вещественное число, процентная скидка на позицию. Положительное число обозначает надбавку,
отрицательное – скидку.
17
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Одновременно разрешено использование только одного типа скидки, в противном случае произвольный тип будет
проигнорирован драйвером.
Данные виды скидок поддерживают все модели фискальных регистраторов. При отсутствии поддержки, например
процентной скидки, драйвер автоматически пересчитывает процентную скидку в суммовую скидку. Все значения
округляются до 2 десятичных знаков. Принципы и алгоритмы расчета скидок, округлений могут отличаться для разных
моделей. Подробное описание алгоритмов расчета скидок доступно в документации к фискальному регистратору.
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
В зависимости от модели и версии регистратора количество отпечатанных символов в строке может отличаться.
18
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
ЕКСЕЛЛІО FP-2000
ЕКСЕЛЛІО FPР-350
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
MIНI-ФП4 - - - -
MIНI-ФП6 - + + -
MINI-Т 400ME
MINI-Т 51.01
MINI-Т 61.01
+ + + -
МІНІ-ФП54.01
МІНІ-ФП81.01
МІНІ-ФП82.01
Таблица 1
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
20
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
банковской картой используется параметр rrn. Если модель и версия РРО поддерживают печать RRN – номер будет
отпечатан в чеке, иначе параметр будет проигнорирован.
При оплате чека типом оплаты «Наличные» происходит автоматическое округление чека до 10 копеек по
правилам математики. Округление выполняется только на тех моделях и версиях РРО, которые поддерживают данную
функциональную возможность. Округление для всех безналичных типов не выполняется. Также выполняется округление
наличных сумм, полученных от покупателя.
Параметры:
sum – вещественное число, сумма оплаты в гривнах указанным типом оплат. Может принимать значение
равное нулю. В таком случае происходит оплата на всю неоплаченную сумму чека указанным типом оплаты.
type – целое число, тип оплаты чека. Стандартным типом для всех регистраторов является тип оплаты
«наличные». В зависимости от модели, название и количество типов оплат могут отличаться. Некоторые модели
поддерживают установку названия безналичных типов оплаты. Подробная информация представлена в документации к
фискальному регистратору.
rrn – RRN
код транзакции оплаты картой.
Windows: BSTR строка, Linux: строка char в кодировке Windows-1251
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
Таблица 1
22
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Назначение: Функция предназначена для печати «нулевого чека». Данный чек по текущему законодательству не
является обязательным. Чек предназначен для проверки фискального регистратора – проверки печатающего устройства,
проверки часов реального времени, проверки даты установленной в регистраторе, проверки шапки чека и т.п.
Параметры: Нет
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
24
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Печать отчетов
Windows: VARIANT_BOOL printXReport()
Linux: bool printXReport()
Назначение: Функция предназначена для печати дневного отчета без обнуления – Х-отчета. В отчете также выводится
информация о суммах и типах оплат, суммах продаж и возвратов, о суммах служебного вноса/выноса денег.
Параметры: Нет
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
25
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
begin – в зависимости от типа отчета дата начала периода или начальный номер Z-отчета. Windows: BSTR
строка, Linux: строка char в кодировке Windows-1251
end –в зависимости от типа отчета дата окончания периода или конечный номер Z-отчета. Windows: BSTR
строка, Linux: строка char в кодировке Windows-1251
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
Примеры:
1. Фискальный регистратор Мария 304Т. Печать Х-отчета, первый параметр всегда равен нулю, т.к. команда
передается в текстовом виде параметра text
lowLevelCommand(0, “ZREP1”);
2. Фискальный регистратор Мария 304Т. Печать копии чека, первый параметр всегда равен нулю, т.к. команда
передается в текстовом виде параметра text
lowLevelCommand(0, “COPY”);
3. Фискальный регистратор Экселлио FP 700. Открытие денежного ящика с импульсом 100 мс.
lowLevelCommand(106, “100”);
26
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
Возвращаемое значение: логического типа, ИСТИНА, если функция выполнена успешно, ЛОЖЬ – если возникла
ошибка.
27
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
28
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Приложение
Универсальные коды ошибок фискальных регистраторов
Код ошибки - значение свойства LastError
Текст ошибки – значение свойства LastErrorText
Код Текст ошибки Варианты устранения и рекомендации
ошибки
0 Отсутствие ошибки или какого-либо
другого информационного сообщения
от регистратора
1 Другая ошибка. Для детального анализа требуется проверить свойства
LastErrorEx и LastErrorExText или обратится к
разработчику.
2 Ошибка открытия или настройки СОМ 1. СОМ порт захвачен другим приложением.
порта. 2. Неисправен СОМ порт.
Закрыть другие приложения использующие порт, заменить
СОМ-порт, сбросить настройки СОМ-порта в значения «по
умолчанию»
3 Драйвер не лицензирован для работы с Приобрести программу у компании разработчика или ее
данным регистратором. дилеров.
4 Ошибка установки связи с 1. Не включено питание регистратора
регистратором. 2. Не подключен дисплей покупателя
3. Регистратор не готов к работе (не заправлена лента, не
запрограммирован для работы)
Устранить причины или обратиться в сервисный центр.
5 Ошибка получения ответа от 1. Неисправен кабель подключения или плохой контакт
фискального регистратора (таймаут). 2. Работа с регистратором в терминальном режиме
3. Работа с некачественными USB-COM адаптерами
Устранить неисправности, использовать проверенные USB-
СОМ адаптеры, улучшить качество линии передачи данных.
6 Ошибка программирования товара или 1. Снять Z-отчет с помощью данного драйвера
ошибка открытия базы товаров на 2. Проверить уровень доступа пользователя к ПК к
компьютере. каталогу драйвера, для успешного создания и
редактирования базы товаров.
7 Отсутствует кассовая лента. Заправить кассовую ленту, выполнить фиксацию принтеров.
8 Функция не поддерживается данной Не использовать неподдерживаемую функцию или проверить
моделью или запрещена в данном алгоритм работы с регистратором.
режиме работы.
9 Неверные параметры функции или Проверить параметры данных передаваемых в функцию.
синтаксическая ошибка.
10 Превышение продолжительности Выполнить Z-отчет с помощью данного драйвера.
смены или дальнейшее выполнение без
Z-отчета невозможно.
11 Ошибка часов реального времени или Обратится в сервисный центр для программирования даты или
дата и время не установлены. времени в фискальный регистратор.
12 Ошибка дисплея покупателя. 1.Индикатор не исправен
2.Индикатор не подключен
Подключить или заменить индикатор (дисплей) покупателя.
13 Ошибка фискальной памяти, память Обратится в сервисный центр
переполнена.
14 Ошибка принтера. Проверить готовность принтера и заправку ленты. При
необходимости обратится в сервисный центр для
проверки/ремонта принтера, автообрезчика, температуры
термоголовки.
15 Низкое напряжение питания. Подключить источник бесперебойного питания или фильтр.
Обратится в сервисный центр.
16 Недопустимое положение ключа для Установить ключ режимов в положение необходимое для
выполнения команды. выполнения данной команды.
29
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
30
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Дата/время не установлены
23 Ошибка установки фискального номера:
Заводской номер не задан
Дата/время не установлены
Открыт чек
Необходимо сделать Z-отчет
24 Ошибка установки налогового/идентификационного номера
25 Ошибка открытия нефискального чека. Фискальная память неформатирована
26 Ошибка открытия нефискального чека. Открыт фискальный чека
27 Ошибка открытия нефискального чека. Нефискальный чек уже открыт
28 Ошибка открытия нефискального чека. Дата и время не установлены
29 Ошибка выполнения итога чека.
30 Ошибка выполнения итога чека (Вычисленная сумма отрицательная. Оплата не совершается)
31 Сумма оплаты меньше суммы чека (Информационное сообщение)
32 Сумма оплаты больше суммы чека (Информационное сообщение)
33 Ошибка выполнения итога чека. Сумма по некоторой налоговой группе отрицательна.
34 Ошибка программирования/чтения артикула.
35 Ошибка выполнения операции служебного ввода/вывода.
36 Полученные данные содержат синтаксическую ошибку.
37 Код полученной команды неверен.
38 Механизм печатающего устройства неисправен.
39 Переполнение операции суммирования.
40 Команда не разрешена для текущего фискального режима принтера.
100 Фискальный регистратор не отвечает. (Таймаут ответа от регистратора)
31
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
34
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
35
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
37
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
38
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
39
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
10 Ошибка ввода
11 Необходимо снять Z1 отчет
12 Скидки/надбавки запрещены
13 Переполнение по чеку
14 Команда запрещена
15 Кассир не зарегистрирован
16 Отрицательная сумма
17 Количество товара отрицательное
18 Время смены исчерпано
19 Неверный тип оплаты
20 Неправильная или отсутствующая цена
21 Неверный параметр на входе команды
22 Товар находится в открытом чеке, редактировать нельзя
23 Некорректно запрограммированный товар
24 Неверный или отсутствующий штрихкод товара
27 Неверный или отсутствующий код товара
28 Товар не весовой (штучный)
29 ФП почти заполнена
30 ФП заполнена
31 Память инициализаций заполнена
32 Есть отложенная операция, оплата запрещена
33 Карточка клиента не принята
34 Не хватает денег на сдачу
35 Запрещена комбинированная оплата
36 Неправильный номер кассира
37 Места недостаточно
38 Нет места в Журнале
39 Нет места в базе товаров
40 Нет места в Архиве
41 Товар есть комплекс
42 Код не принадлежит комплексу
43 ЭККА занят и не может выполнить команду"
44 Необходимо выполнить Z1 отчет
45 Неправильный пароль кассира
46 Комплекс нельзя продать
47 Цена товара указана
48 Отмена запрещена
49 Продажа товара запрещена
50 Ошибка чтения ФП
51 Номер производителя неверен
52 Ошибка записи во флеш
54 Товар нельзя удалить
55 Нет данных в ФП
56 Неверный пароль налогового инспектора
57 Неверный пароль администратора
58 Неверный пароль старшего кассира
60 РРО заблокирован. Истекло время для передачи данных
61 РРО заблокирован. Персонализация не проведена
67 Ошибка работы с SAM
68 Есть неотправленные документы
69 Документы отсутствуют
40
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
70 Вал отсутствует
71 Нет питания 3.3В на плате клавиатуры
79 Дата сервисного обслуживания превышена
80 Ошибка записи в ФП
81 Ошибка часов реального времени, дата последнего Z1 отчета больше текущей
82 Ошибка данных в интерфейсе
83 Ошибка часов реального времени, дата/время последнего документа больше текущей
86 Отсутствует индикатор клиента
91 Напряжение питания превышает допустимое
92 Напряжение питания ниже допустимого
93 Критическое снижение напряжения питания
95 Температура термоголовки ниже допустимой
96 Температура термоголовки
97 Нет бумаги
41
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
42
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Версия 5.2
29.07.2021 Добавлена поддержка РРО MG N707TS версии MG-07.02; MG-07.03
29.07.2021 Добавлена поддержка РРО MG-Р777TL версия MG-77.02
29.07.2021 Добавлена поддержка РРО MG-T787TL версия MG-87.02
29.07.2021 Добавлена поддержка РРО FR90.XM версия 318.03
29.07.2021 Добавлена поддержка РРО FR90Т версия 315.03
29.07.2021 Добавлена поддержка РРО FR90М версия 315.03
29.07.2021 Добавлена поддержка РРО FR90Х версия 315.03
30.07.2021 Добавлена поддержка РРО MINI-T400ME версии 4101-9
Версия 5.1
27.07.2021 Добавлена поддержка РРО Датекс (протокол Криптон) версии 5.03
27.07.2021 Добавлена поддержка РРО ІКС-C651T версия MZ-12, ІКС E-810T версия ЕП-12, ІКС-E07 версия Е7-12
27.07.2021 Добавлена поддержка РРО Мария 304 - версии 6, 6M
27.07.2021 Добавлена поддержка РРО Экселлио - версии 4.00
27.07.2021 Добавлена поддержка РРО Мини-ФП - версии F3
27.07.2021 Добавлено автоматическое округление чеков при оплате наличными, округление вноса/выноса, печать акциза
(функция setA) ), символов ШК (функция setB), кода УКТЗЕД (функция setU), RRN номера транзакции (функция
printRecTotalEx).
Версия 5.0
14.08.2020 Добавлена поддержка РРО FR90.XM версии 318.02
14.08.2020 Добавлена поддержка РРО FR90M, FR90X версии 315.02.
14.08.2020 Добавлена поддержка РРО KBM FP-S651 версии 3.00UA.
14.08.2020 Добавлена поддержка РРО LeoCAS-200, LeoCAS-201 версии L201.05.
14.08.2020 Добавлена поддержка РРО MG N707TS версии MG-07.01.
14.08.2020 Добавлена поддержка РРО MG-T787TL версии MG-87.01.
14.08.2020 Добавлена поддержка РРО MG-Р777TL версии MG-77.01.
14.08.2020 Добавлена поддержка РРО Мария-304Т версий 304Т-5; 304Т-5M.
14.08.2020 Добавлена поддержка РРО Мария-304Т1, Мария-304Т2, Мария-304Т3 версии 304Т-5.
14.08.2020 Добавлена поддержка РРО DATECS СМР-10L версии 5.00.
14.08.2020 Добавлена поддержка РРО DATECS FP–320, DATECS FP–Т260, DATECS FP–Т88 версии 5.02.
14.08.2020 Исправлен механизм получения номера последнего чека для РРО с протоколом JSON (Хелп-Микро).
Версия 4.9
15.01.2018 Добавлена поддержка РРО Экселлио версий 3.0
14.08.2018 Добавлена поддержка версий 5101-3 и 6101-3 кассовых аппаратов MINI-T.
17.10.2018 Добавлена поддержка РРО FR90.XM версии 318.01.
17.10.2018 Добавлена поддержка РРО Datecs FP-101 версии 4.02.
Версия 4.8
30.03.2017 Добавлена поддержка РРО LeoCAS -200 версий L200.01; L200.02; L200.03; L200.04 (RS-232 и TCP/IP).
30.03.2017 Добавлена поддержка РРО LeoCAS -201 версий L201.01; L201.02; L201.04 (RS-232 и TCP/IP).
30.03.2017 Исправлена ошибка печати копий чеков из КЛЭФ для РРО Экселлио.
Версия 4.7
30.01.2017 Добавлена поддержка РРО MG-Р777TL версии MG-77.
30.01.2017 Добавлена поддержка РРО MG-T787TL версии MG-87.
Версия 4.6
12.01.2017 Добавлена функция printKSEFReceipt - печати копии чеков из КЛЭФ.
12.01.2017 Добавлена функция lowLevelCommand – печать низкоуровневых команд регистраторов.
12.01.2017 Добавлена поддержка протокола TCP/IP для РРО Мария.
12.01.2017 Добавлена поддержка протокола TCP/IP для РРО Юнисистем.
12.01.2017 Увеличено количество символов до 34 при печати комментариев для РРО с протоколом Датекс.
20.01.2017 Добавлена поддержка РРО ІКС-Е07 версии Е7-09.
43
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
Версия 4.5
18.02.2016 Добавлен встроенный эмулятор фискальных регистраторов.
Версия 4.4
23.11.2015 Добавлена поддержка РРО Экселлио с версией прошивки 2.00UA.
23.11.2015 Добавлена поддержка РРО DATECS FP–101 SMART с версией прошивки 4.02.
23.11.2015 Добавлена поддержка РРО KBM FP-S651 с версией прошивки 1.00UA.
24.11.2015 Добавлена поддержка РРО с новыми версиями МІНІ-ФП54.01 (5401F2), МІНІ-ФП81.01 (8101F2), МІНІ-
ФП82.01 (8201F2).
Версия 4.3
08.10.2015 Добавлена поддержка фискальных регистраторов IPOS.XM и MG N707TS с протоколом TCP/IP.
13.10.2015 Исправлена ошибка свойства получения номера последнего чека LastReceiptNum в открытом чеке для РРО
Мария.
Версия 4.2
16.06.2015 Добавлена поддержка РРО ІКС-С651Т версии MZ-11.
16.07.2015 Исправлена ошибка работы функции оплаты безналичным типом для РРО с протоколом Криптон для
операционных систем Linux.
06.08.2015 Исправлена ошибка чтения кода ошибки пакета NAC0 для регистраторов для РРО Юнисистем ( МІНІ-
ФП54.01, МІНІ-ФП81.01, МІНІ-ФП82.01 и др.). Соответствует расширенным кодам ошибок 1001-1008 в Приложении.
18.08.2015 Исправлена ошибка свойства чтения наличных в кассе CASH для РРО с протоколом ИКС-Техно.
Версия 4.1
10.07.2015 Исправлена ошибка автоматического определения весового товара, при дробной части количества товара
равной 0.001 для регистраторов с протоколом ИКС-Техно (ІКС, MG и др.).
10.07.2015 Доработано свойство CASH «сумма наличных в кассе» для РРО Экселлио, чек при получении суммы
наличности в кассе не печатается.
Версия 4.0
29.05.2015 В Универсальный драйвер интегрированы все другие драйвера АртСофт – ОЛЕ для Датекс, ОЛЕ для
Экселлио, ОЛЕ для Марии, ОЛЕ для ИКС, ОЛЕ для РРО Датекс с протоколом Криптон.
11.06.2015 Добавлена поддержка РРО ЕКСЕЛЛІО FPР-350.
16.06.2015 Добавлена поддержка РРО ІКС-С651Т версии MZ-09.
18.06.2015 Добавлена поддержка РРО MG N707TS версии MG-07.
24.06.2015 Добавлена поддержка РРО ІКС-А8800 версии MF-09.
02.07.2015 Добавлена поддержка РРО ІКС E-810T версии ЕП-11.
Версия 3.7
25.05.2015 Добавлена поддержка РРО DATECS СМР-10М, MINI-Т 400ME, MINI-Т 51.01, MINI-Т 61.01
Версия 3.6
07.04.2015 Добавлена функция печати штрих-кода (printBarCode)
07.04.2015 Добавлена поддержка фискального регистратора Екселліо FPU-550ES (версия 1.00 UA)
Версия 3.5
12.03.2015 Добавлена возможность продажи товара НДС 0% + Акциз 5% для РРО Мария.
12.03.2015 Исправлена ошибка оплаты чека безналичным типом на регистраторе Datecs 3530Т версии 5.20 в протоколе
Криптон.
19.03.2015 Добавлена поддержка РРО ІКС E-810T версии ЕП-09.
Версия 3.4
16.01.2015 Добавлена поддержка РРО ФР7 версий FR-08, FR-09.
11.02.2015 Добавлена возможность продажи товара НДС 20% +акциз 5% для РРО Мария.
Версия 3.3
28.11.2014 Новые возможности для РРО Юнисистем ( МІНІ-ФП54.01, МІНІ-ФП81.01, МІНІ-ФП82.01 и др.):
1. Реализовано программирование имени кассира для РРО стандартными средствами. Имя кассира печатается в
специально отведенном месте чека.
44
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
2. После печати Х-отчета автоматически печатается «Отчет состояния персонализации РРО и передачи данных».
После окончания печати происходит обрезка чека.
3. При закрытии чека производится автоматическая проверка полной оплаты чека. Неоплаченная сумма чека
автоматически закрывается наличным типом оплаты.
Версия 3.2
03.11.2014 Добавлена поддержка новых моделей РРО: ІКС-С651Т, ІКС-А8800
Версия 3.1
22.10.2014 Добавлено ожидание перезапуска РРО после выполнения Х и Z-отчетов для РРО Юнисистем ( МІНІ-ФП54.01,
МІНІ-ФП81.01, МІНІ-ФП82.01 и др.).
23.10.2014 Переделан механизм ожидания ответа от РРО Юнисистем ( МІНІ-ФП54.01, МІНІ-ФП81.01, МІНІ-ФП82.01 и
др.).
24.10.2014 Добавлена поддержка РРО Datecs FP-320.
Версия 3.0
04.07.2014 Адаптация драйвера для использования в системе Linux
04.07.2014 Исправлена работа нефискализированного РРО Экселлио FP2000
16.07.2014 Добавлена поддержка РРО Мини-ФП82.01.
11.08.2014 Добавлено описание функций Универсального драйвера для операционных систем Linux.
29.09.2014 Исправлена ошибка получения номера последнего чека для РРО ІКС E-810T и MG-T808TL
29.09.2014 Исправлено получение номера смены для РРО МІНІ-ФП54.01, МІНІ-ФП81.01, МІНІ-ФП82.01
Версия 2.9
10.04.2014 Модернизирован механизм работы с СОМ-портом.
10.04.2014 Модернизирован механизм протоколирования работы драйвера.
16.04.2014 Добавлены свойства SN «заводской номер регистратора» и CASH «сумма наличных в кассе».
Версия 2.8
11.03.2014 Модифицирован механизм лицензирования драйвера
Версия 2.7
07.02.2014 Добавлена поддержка РРО Экселлио FP-2000.
Версия 2.6
23.01.2014 Добавлена поддержка РРО ІКС E-810T и MG-T808TL.
Версия 2.5
06.12.2013 Добавлена поддержка РРО Мини-ФП54.01, Мини-ФП81.01.
13.12.2013 Доработана функция оплаты чека безналичными типами для Datecs FP-T88.
09.01.2014 Добавлена обрезка чека для Мини-ФП81.01
09.01.2014 Доработана функции установки времени для моделей ИКС и Мини-ФП4/ФП6.
Версия 2.4
12.11.2013 Добавлена поддержка РРО Мария версий D304T
19.11.2013 Добавлена поддержка РРО Datecs FP-T88
Версия 2.3
14.10.2013 В регистраторах с протоколом Криптон имя оператора печатается комментарием, вместо специальной
функции, т.к. возможность изменения имени работает только после Z-отчета.
24.10.2013 Добавлены функции для чтения и установки времени в фискальном регистраторе.
Версия 2.2
30.09.2013 Улучшена скорость закрытия чека в протоколе Криптон при сумме оплаты больше суммы чека.
Версия 2.1
45
Украина, 02094 г. Киев, ул.Красноткацкая, 16 "Б", тел. (044) 531-37-23
Веб-сайт: www.artsoft.ua E-mail: soft@artsoft.ua
01.08.2013 Исправлена ошибка печати полного периодического отчета по номерам в протоколе Криптон.
Версия 2.0
15.07.2013 Исправлена ошибка параметров суммовой/процентной скидки на чек для Датекс 3530Т/Экселлио.
Версия 1.9
12.07.2013 Добавлен механизм повторной отправки команды при таймауте для регистраторов в протоколе Криптон.
Версия 1.8
03.07.2013 Добавлен механизм повторной отправки команды при таймауте для регистраторов Datecs 3535T/Экселлио.
Версия 1.7
01.07.2013 Добавлена установка имени оператора при открытии чека в протоколе Криптон
26.06.2013 Исправлена ошибка формирования лога, протокол мог формироваться не в каталоге с библиотекой.
Версия 1.6
13.06.2013 Реализовано чтение/программирование времени в РРО с протоколом Криптон.
Версия 1.5
20.02.2013 Переделан механизм расчета суммы по строке для Марии.
Версия 1.4
19.02.2013 Исправлена ошибка оплаты чека Марии 301МТМ при указании суммы равной 0 и безналичном типе оплаты.
46