Универсальный файл запроса 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

––– Конец файла –––