Настройка модуля печати кассовых чеков

Модуль интеграции с фискальным регистратором (печати кассовых чеков) предназначен для обеспечения возможности взаимодействия системы "Курьерская служба 2008" с фискальными регистраторами. Он представляет собой службу Windows, которая подключается к БД системы, и к фискальному регистратору. Одна установка службы поддерживает один регистратор. При этом система в целом поддерживает неограниченное количество регистраторов, в том числе и зарегистрированных на одно юр. лицо, посредством установки необходимого количества модулей интеграции с ФР.

Модуль печати кассовых чеков состоит из файлов:

CheckServiceExe.exe - Исполняемый файл службы

CheckServiceExe.ini - Конфигурационный файл

CheckServiceExe.log - Файл журнала. Если его нет - он создается при запуске службы

Установка

Для установки модуля скопируйте файлы дистрибутива в папку на компьютере, к которому подключен фискальный регистратор. Запустите файл "CheckServiceExe.exe" с параметром командной строки " /install", от имени администратора. Если все хорошо, Вы увидите сообщение "Service installed successfully". Подсказка: для упрощения ввода командной строки можно создать ярлык для файла "CheckServiceExe.exe", и в его свойствах, в поле "Объект", дописать параметр, после чего запустить этот ярлык.

После установки убедитесь, что режим запуска службы установлен в положение "Автоматически", и запустите службу, используя окно "Службы" операционной системы.

Настройка

Откройте файл CheckServiceExe.ini любым текстовым редактором, например, блокнотом.

В файле, в разделе "[COMMON]", Вы найдете (если не найдете - их можно добавить) следующие параметры:

Параметры

Параметр	Описание
ServerName	Имя/адрес сервера
DatabaseName	Имя базы данных (по-умолчанию - "courier")
UserName	Имя пользователя базы данных
Password	Пароль пользователя базы данных
DBPort	Порт базы данных (по-умолчанию - 3306)
CashRegister	Код фискального регистратора в базе данных
Port	Номер COM-порта фискального регистратора
Param	Дополнительные параметры фискального регистратора.
PrintKurier	1 - Печать ФИО курьера на чеке.
PrintSeller	1 - Печать заказчика на чеке. Если включено, печатается юр. наименование, ИНН и телефон клиента. Чтобы это работало, необходимо, чтобы в карточке клиента было заполнено поле "Полное название", на вкладке "Реквизиты".
AddStr	Пользовательская строка, которая печатается на всех чеках.
Device	1 - ФР Штрих-М (по-умолчанию), 2 - Чековый принтер Штрих-М (протокол Epson ESC/P), 3 - Сервис фискализации Life-pay

Описание значений

CashRegister - Код фискального регистратора в базе данных. Чтобы узнать, выберите в главном меню системы пункт "Справочники" - "Фирмы", Откройте двойным щелчком карточку фирмы, на которую зарегистрирован фискальный регистратор, перейдите на закладку "Фискальные регистраторы". Вы увидите список фискальных регистраторов. При необходимости их можно создать здесь же.

Port - Номер COM-порта фискального регистратора. Если регистратор подключен через USB-порт, драйвер эмулятора порта все-равно создает виртуальный COM-порт, номер которого устанавливается в его свойствах (в Диспетчере устройств), а также номер порта меняется в зависимости от разъема USB, к которому подключено устройство!

Param - Дополнительные параметры.

• Для фискальных регистраторов Штрих-М, в данном параметре через запятую указываются: пароль пользователя ФР (по-умолчанию - "30" - пароль сис. администратора), а также скорость порта (по-умолчанию - "6").
• Для Life-pay через запятую указываются api-ключ и телефон-имя-пользователя.

Принимаемые значения параметра "Скорость порта":

Значение	Скорость (кбит/сек)
1	4800
2	9600
3	19200
4	38400
5	57600
6	115200

Значение параметра скорости должно совпадать с установленным режимом самого фискального регистратора. По-умолчанию, при покупке, он настроен на скорость 115200, однако, иногда этот параметр необходимо уменьшить для повышения стабильности работы регистратора. Также было замечено, что иногда эта настройка самого регистратора может спонтанно сбрасываться в положение 4800, т.о. изначальная конфигурация в этом режиме исключит вероятность отказа системы из-за спонтанного сброса настройки в ФР. Скорость работы в ФР можно задать кнопкой "Установить параметры" окна "Настройка свойств" программы "Тест драйвера ФР".

Например, чтобы установить для модуля настройки подключения к ФР параметры: Пароль доступа - 30, скорость порта - 4800 необходимо указать строку:

Param=30, 1

Обрезка чека

При желании, в программе "Тест драйвера" Вы можете открыть раздел "Таблицы" и настроить (полную или частичную) автоматическую обрезку чека. Наша система не посылает на ККМ команду обрезки чека во избежание двойной обрезки.

Отчет по секциям

Для того, чтобы включить отчет по секциям, необходимо:

1. Остановить чековую службу.

2. Открыть Тест драйвера ФР.

3. Выбрать пункт “07. Параметры устройства”. Открыть вкладку “Таблицы”.

650px

4. Нажать на кнопку “Редактирование таблиц”. Откроется окно “Таблицы”.

550px

5. Далее необходимо либо дважды нажать на пункт № 1 – “Тип и режим кассы”, либо выделить пункт № 1 и нажать на кнопку “Открыть”. Откроется окно “Тип и режим кассы”.

500px

6. Чтобы включить отчет по секциям, необходимо изменить поле “Тип суточного отчета” на 1, как на скриншоте выше. Важно: сохранение изменений происходит по нажатию клавиши “Enter”!!!

Удаление

Для корректного удаления службы запустите исполняемый файл "CheckServiceExe.exe" с параметром командной строки " /uninstall".

Примечания

Поскольку при запуске служба открывает подключение к фискальному регистратору, и использует его все время своей работы, другие программы (например "Тест драйвера" и т.д.) при попытке подключения выдадут ошибку "Невозможно открыть порт, он используется другим приложением". Чтобы избежать этого, остановите службу модуля на время использования других программ.

Устранение неполадок

1. В случае сбоя работы кассы ошибку можно посмотреть в файле CheckServiceExe.log

2. Ошибки условно можно разделить на 3 категории:

Ошибка	Симптомы	Возможные причины	Способы устранения
Нет связи с сервером	Касса не печатает, в логе сообщения вида "Unknown MySQL server host " или "Can't connect to MySQL server on...".	Неверно настроено подключение к серверу, не работает сервер, сеть.	Проверить настройки подключения в файле CheckServiceExe.ini, проверить доступность сервера с этого компьютера.
Нет связи с фискальным регистратором	Касса не печатает, в логе сообщения вида "Нет связи код: -1, Режим: 0, Подрежим: 0"	ФР Выключен, ФР подключен не к тому разъему, ФР Настроен не на ту скорость	Проверьте, что ФР включен, подключен к компьютеру, именно в тот порт, в котором он настраивался. Попробуйте отключить службу чеков, открыть программу "Тест драйвера", выполнить поиск оборудования. Если она находит ФР - сравнить настройки подключения, найденные тестом драйвера с тем, что прописано в CheckServiceExe.ini. В единичных случаях проблема может заключаться в драйвере переходника COM-USB, попробуйте удалить этот переходник в диспетчере устройств windows, и попросить его поискать устройства заново.
Не корректная работа фискального регистратора.	Касса печатает заголовок чека, потом ошибку, потом надпись "Чек аннулирован", и так бесконечно по кругу.	Аппаратная ошибка ФР, некорректный чек, сформированный системой.	Если текст ошибки, который печатается на чеке (он же сохраняется и в лог-файл) содержит информацию об ЭКЛЗ (например "ЭКЛЗ: Неверные дата или время код: 168, Режим: 3, Подрежим: 0") - нужно обратиться в компанию, с которой у вас заключен договор о поддержке кассы, сообщить им текст ошибки. В остальных случаях - обратиться в службу поддержки "Курьерская служба 2008" для выяснения причины и ее устранения.
Ошибка при формировании отчета без гашения (X-отчет)	Касса печатает X-отчет бесконечно по кругу. В протоколе работы чековой службы выдается сообщение "Команда не поддерживается в данном режиме код: 115, Режим: 6, Подрежим: 0".	В кассовом аппарате не установлены дата и время.	Необходимо через драйвер ФР установить текущую дату и время, затем cохранить настройку. В остальных случаях - обратиться в службу поддержки "Курьерская служба 2008" для выяснения причины и ее устранения.