Универсальный файл запроса requesta.txt.
Формат универсального файла запроса:
1 строка: команда
2 строка: пустая (игнорируется)
3 строка: параметры команды
Параметры разделяются запятыми, пробелы игнорируются.
Логические параметры имеют формат: Y,T,1 = TRUE, N,F,0 =FALSE
Текстовый параметр (последовательность символов) должен маркироваться цитатой (например «Ala»)
Команды операций:
1. Команда: CLOSE SHIFT – закрыть смену
Параметры:
1.1. Номер кассира, которому закрывается смена (цифровой параметр, 0 - 255, обязателен).
1.2. Показывает должен ли совпадать номер кассира закрываемой смены с кассиром открытой смены (логический параметр, опциональный, по умолчанию ложь).
1.3. Показывает должен ли фискальный день закрыться после выполнения закрытия смены (логический опциональный параметр, по умолчанию ложь).
2. Команда: CLOSE FISCAL DAY - закрытие фискального дня
Параметры:
2.1. Номер кассира, которому нужно закрыть смену (цифровой
параметр 0 - 255, опциональный, по умолчанию нуль).
Примечание.
- Команда CLOSEFISCALDAY команда будет выполнена только в случае, если закрыта смена на POS-системе.
- Команды CLOSEFISCALDAY и CLOSESHIFT будут выполнены, если только кассир вышел из программы в меню.
3. Команда: REGISТЕRSUMMARY - общая регистрация счетов и документов.
Параметры:
3.1. Номер регистрационного файла (register.dat). Цифровой параметр (1,2) – обязателен:
3.1.1. – главный регистрационный файл (в двухпринтерной системе привилегированный регистратор).
3.1.2. – дополнительный регистрационный файл (в двухпринетрной системе регистратор собственник).
3.2. Начало периода суммирования дата и время в формате YYYYMMDD – обязательный параметр.
3.3. Конец периода суммирования – дата и время в формате YYYYMMDD – обязательный параметр.
3.4. 0 – выполнено корректно.
3.5. 1 – команда выполнена некорректно.
3.6. 1000-другая ошибка.
3.7. 10101-неправильная дата.
3.8. 10102 – запрос, который нельзя реализовать (запрос для отчета на второй register.dat в однопринтерной системе).
3.9. 10103 – ошибка открытия или чтения регистрационного файла.
Таблица 24. Структура файла sumreg.a.
4. Команда: ACTIVATE VIRTUAL SCREEN - удаленный просмотр экрана или дисплея оператора, также называемый виртуальным экраном. Команда без параметров.
Когда команда выполняется приложением, в течение времени равного 10*3* ImportTimeout секунд, нужно создать в индивидуальной директории (например, SP01) пустой файл с именем screenl.flg (или screen2.flg для 2x20 display) открытый в эксклюзивном режиме. По прошествию некоторого времени (около 1-3 * ImportTimeout секунд) появится файл screenl.vsc (или screen2.vsc) и будет включать представление экрана и его параметры в определенном формате. Он будет обновляться в цикле сообщений, когда другие сообщения не будут управляться («idle» время используется).
Когда Вы закончите удаление файла screenl.flg (l-3 * ImportTimeout
секунд), приложение закончит процесс отсылки и удаления screenl.vsc файла. Есть возможность активировать просмотр только когда приложение в окне продажи, главного меню или скринсейвере (условия идентичны для каждого). Через какое-то время (В [TEST] секции скрытые параметры добавлены:
параметр TestVirtualScreenActivationMode (N) [ ]
параметр определяет путь активации экрана управления предварительным просмотром
«0» - по запросу A, «1» - всегда активен.
параметр TestVirtualScreenTimeoutMultiplier (N) [ ]
множитель ImportTimeout для интервала тестирования начала\конца
просмотра экрана.
5. Команда: MESSAGE –позволяет послать сообщение кассиру.
Параметры:
5.1. Текст сообщения включенный между ""
5.2. Количество секунд, после которых сообщение будет автоматически закрыто.
Когда операция запроса завершается, создается файл answer.a. Этот файл включает копию файла requesta.txt с первыми тремя строками и в четвертой код ошибки.
Если команда выполнена корректно, файл sumreg.a, который содержит строки (сейчас пять) в формате:
6. Команда: FISCAL REPORT - периодический фискальный отчет.
Параметры:
1. Тип отчета: «0» - суммарный, «1» - детальный (требуется числовой параметр)
2. Начало периода – дата в формате YYYYMMDD (обязательный параметр)
3. Конец периода - дата в формате YYYYMMDD (обязательный параметр)
Примечание.
Команда FISCALREPORT выполнится только, если фискальное изменение в POS-системе закрыто и ни один кассир не залогирован в программе (а в программном меню).
Возможные коды ошибок команды FISCALREPORT
«0» – OK;
«1» – неверные параметры запроса (неправильный формат, выход за
пределы);
«10000» – различные ошибки;
«10002» – кассир не разлогирован;
«10004» – ошибка;
«10005» – операция не может быть выполнена;
«10007» – не может быть выполнена, нефискальная библиотека;
«10008» – открыта фискальная смена;
«10999» – неопознанная команда (эта версия программы не обрабатывает эту команду);
«10101» – неверные данные.
После окончания операции обращения к файлу answer.a создается файл, в первых трех строчках которого содержится копия requesta.txt и код ошибки в четвертой.
Пример requesta.txt:
FISCAL_REPORT
0,19990630,20000101
––– Конец файла –––
Пример answer.a:
FISCAL_REPORT
0,19990630,20000101
––– Конец файла –––