Изменения

Модуль интеграции с фискальным регистратором (печати кассовых чеков) предназначен для обеспечения возможности взаимодействия системы «Курьерская служба 2008» MeaSoft с фискальными регистраторами. Он представляет собой [http://ru.wikipedia.org/wiki/Службы_Windows службу Windows], которая подключается к БД системы, и к фискальному регистратору. Одна установка службы поддерживает один регистратор. При этом система в целом поддерживает неограниченное количество регистраторов, в том числе и зарегистрированных на одно юр. лицо, посредством установки необходимого количества модулей интеграции с ФР.

CheckServiceExeMeaSoft поддерживает неограниченное количество регистраторов, в том числе и зарегистрированных на одно юридическое лицо. Чтобы подключить несколько регистраторов, установите соответствующее количество модулей интеграции с ФР.exe — Исполняемый файл службы

Модуль печати кассовых чеков состоит из следующих файлов:* CheckServiceExe.exe — исполняемый файл службы;* CheckServiceExe.ini — Конфигурационный конфигурационный файл;* CheckServiceExe.log — файлжурнала. Если его нет, создается при запуске службы.

== Установка ==Для установки модуля скопируйте файлы дистрибутива печати чека через LIFE PAY и Штрих-Нано-Ф при закрытии заказа курьером в папку на компьютере, к которому подключен фискальный регистратормобильном приложении чековая служба не нужна. Запустите файл «CheckServiceExe.exe» с параметром командной строки « /install», от имени администратора(!). Если все хорошо, Вы увидите сообщение «Service installed successfully». ''Подсказка: для упрощения ввода командной строки можно создать ярлык для файла «CheckServiceExe.exe», и в его свойствах, в поле «Объект», дописать параметр, после чего запустить этот ярлык.''

После установки '''Примечание'''. Касса Штрих-М работает с чековой службой только при подключении через COM-порт или USB и одновременно передает данные в ОФД. При подключении через USB на компьютере настраивается виртуальный COM-порт. = Установка чековой службы= # Скопируйте файл CheckServiceExe.exe в любую папку на компьютере:#* для кассы Штрих-М — на тот компьютер, к которому физически подключена касса;#* для кассы LIFE PAY – на любой компьютер, потому что у LIFE PAY облачная фискализация.# Создайте ярлык для файла CheckServiceExe.exe.# В свойствах ярлыка на вкладке '''Ярлык''' в поле '''Объект''' после имени файла добавьте <code>/install</code>:[[Файл:Установка чековой службы.png|none]]# Сохраните и запустите ярлык от имени администратора. В результате служба появится в списке служб. Для просмотра списка в контекстном меню '''Мой компьютер''' выберите '''Управление''' > '''Службы'''.# В папке с чековой службой создайте INI-файл или загрузите шаблоны: .# Откройте INI-файл, укажите [[#Настройка чековой службы |параметры]] для своей базы и сохраните изменения.# В контекстном меню элемента '''Мой компьютер''' выберите '''Управление''' > '''Службы''', убедитесь, что режим запуска службы установлен в положение «Автоматически», и запустите чековую службу. Если установка и настройка прошли успешно, используя окно «Службы» операционной системыто первый чек будет сразу распечатан на кассе.  Если чек не печатается, смотрите причины в файле логов чековой службы CheckServiceExe.log. Он находится в папке чековой службы. Подробнее см. раздел «[[Устранение неполадок]]».

== Настройка =чековой службы =Откройте файл CheckServiceExe.ini любым текстовым редактором, например, [http://ru.wikipedia.org/wiki/Блокнот_(программа) блокнотом].

В файле, в разделе «<nowiki>[COMMON]</nowiki>», Вы найдете (если не найдете — их можно добавить) измените или добавьте следующие параметры:

{|class="wikitable" style== Параметры ==={|"width: 80%; "background-color:#ffffff;"!text-alignstyle="width:left20%;"|Параметр! Описаниеstyle="width: 40%;"|Штрих-М!style="width: 40%;"|ServerName|Имя/адрес сервера|-|DatabaseName|Имя базы данных (по умолчанию «courier»)LIFE PAY

|UserName<code>Param</code><br>Дополнительные параметры фискального регистратора|Имя Пример: <code>Param=30, 6</code><br>Обязательный параметр, значения указываются через запятую. <br>Первое значение — пароль пользователя базы данныхФР, по умолчанию 30. Второе значение — скорость работы ФР. Чтобы узнать скорость, используйте утилиту «Тест драйвера», которая поставляется с кассой: откройте утилиту, нажмите на кнопку '''Настройка свойств''' > '''Поиск оборудования'''. Отобразится подключенный ФР и его скорость работы.|Пример: <code>Param=91defdc4587fc189280772e2b2aa8d6f, 79030020076,,64</code><br>Необязательный параметр. Если значения указаны в [[Фирмы#Добавление фискального регистратора|фискальном регистраторе]], можно оставить строку в таком виде: <code>#Param=</code><br>Первое значение — 32-значный АПИ-ключ из ЛК LIFE PAY.<br>Второе значение — номер телефона без +, на который зарегистрирован ЛК LIFE PAY. <br>Третье значение — пустое.<br>Четвертое значение — агентский признак, если есть.

|Password<code>Port</code><br>Номер [http://ru.wikipedia.org/wiki/Последовательный_порт COM-порта] фискального регистратора. Если регистратор подключен через [http://ru.wikipedia.org/wiki/USB USB-порт], драйвер эмулятора порта все равно создает виртуальный COM-порт, номер которого устанавливается в его свойствах (в [http://ru.wikipedia.org/wiki/Диспетчер_устройств диспетчере устройств]), а также номер порта меняется в зависимости от разъема USB, к которому подключено устройство.|Пароль пользователя базы данныхПример: <code>Port=5</code><br>Обязательный параметр.|Пример: <code>Port=1 </code><br>Необязательный параметр, можно указывать значение 1.

|DBPort|Порт базы данных (по умолчанию 3306)|-|<code>CashRegister|</code><br><rspoiler text="Код фискального регистратора">Чтобы его узнать, выберите в главном меню системы пункт '''Справочники''' > '''Фирмы''', откройте карточку фирмы, на которую зарегистрирован фискальный регистратор, перейдите на закладку '''Устройства''', убедитесь, что в выпадающем списке выбрано значение '''Фискальные регистраторы'''. Вы увидите список В списке фискальных регистратороввы увидите код. При необходимости их можно создать здесь жеЕсли запись для регистратора еще не создана или вы планируете установить дополнительную кассу, добавьте новый ФР.</rspoiler> в базе данных. <br> <spoiler text="Что еще можно указать">Можно указывать наборы обслуживаемых ФР двумя способами:* через запятую или тире, или их комбинации указать несколько кодов;* условие SQL-запроса. Например «AND <code>AND cr.DeviceType=3» 3</code> для всех доступных ФР LIFE PAY.

Тогда они все будут обслуживаться одним объектом подключения к ФР. Что это значит: для Штрих-М у объекта открыт COM-порт при старте, и поменяться он не может. Все чеки пойдут в один ФР. Для LIFE PAY — PAY — в созданный объект передается поле '''Серийный номер''', откуда он берет авторизацию, т.о. чеки могут отправляться в различные аккаунты. Главное, что тип кассы у всех ФР должен быть один — один — служба не сможет переключиться например с LIFE PAY на ApiShip.</spoiler>|colspan="2" |Пример: <code>CashRegister=2 </code> <br> Обязательный параметр.

|Port|Номер [http://ru.wikipedia.org/wiki/Последовательный_порт COM-порта] фискального регистратора. Если регистратор подключен через [http://ru.wikipedia.org/wiki<code>ServerName</USB USB-порт], драйвер эмулятора порта все равно создает виртуальный COMcode><br>Имя или IP-портадрес сервера, номер которого устанавливается в его свойствах (в [http://ru.wikipediaна котором находится БД MeaSoft.org/wiki/Диспетчер_устройств диспетчере устройств]), а также номер порта меняется в зависимости от разъема USBСервер должен быть доступен по сети с компьютера, к которому подключено устройствоподключена касса.|colspan="2" |Пример: <code>ServerName=srv01 </code> <br> Обязательный параметр.

|Param<code>DatabaseName</code><br>Имя базы данных (по умолчанию «courier»)|Дополнительные параметры фискального регистратораcolspan="2" |Пример: <code>DataBaseName=courier</code> <br>Обязательный параметр.

|PrintKurier<code>UserName</code><br>Имя пользователя базы данных|1 — печать ФИО курьера на чекеcolspan="2" |Пример: <code>UserName=Office</code> <br>Обязательный параметр. Пользователя нужно создать, для этого обратитесь в техподдержку.

|PrintSeller<code>Password</code><br>Пароль пользователя базы данных|1 — печать заказчика на чеке. Если включено, печатается юр. наименование, ИНН и телефон клиента. Чтобы это работало, в карточке клиента должно быть заполнено поле '''Полное название''', на вкладке '''Реквизиты'''. Этот colspan="2" |Пример: <code>Password=password </code> <br>Обязательный параметр никак не связан с тегами фискального документа 1225 и 1226 и просто выводит текстом на бумагу дополнительный текст там, где это возможно.

|PrintCashier<code>DBPort</code><br>Порт базы данных|1 — печать кассира на чеке (тег 1021)colspan="2" |Пример: <code>DBPort =3306 </code> <br>Обязательный параметр. По умолчанию 1. 1 — кассир берется из строки чека, 0 — не печатается, другое число — код нужного сотрудника3306. Можно писать подзапрос вида if(a.cl=1, 5, 6)Проверить порт можно в любом ярлыке офисной программы.

|EmailPriority<code>Device</code>|1 — отправка чека 1 — ФР Штрих-М (по eумолчанию),<br> 2 — чековый принтер Штрих-mail приоритетнее, чем SMSМ (протокол Epson ESC/P)|3 — сервис фискализации LIFE PAY.

|AddStr|Пользовательская строка, которая печатается на всех чеках.|-|Device|1 — ФР Штрих-М (по умолчанию), 2 — чековый принтер Штрих-М (протокол Epson ESC<code>AgentFlags</P), 3 — сервис фискализации LIFE PAY.|-|AgentFlags|code><br>Флаги тега 1057 для передачи в кассу при агентском чеке|colspan="2" | Пример: <code>AgentFlags=4</code><br>Обязательный параметр, если курьерская служба — не платежный агент. По умолчанию — Чтобы не передавать признаки платежного агента (если в кассе нет этого признака), укажите 0. Если параметр не указан, передается значение по умолчанию 4. <spoiler text="Возможные значения">* 1 — 1 — банковский платежный агент,* 2 — 2 — банковский платежный субагент,* 4 — 4 — платежный агент,* 8 — 8 — платежный субагент,* 16 — 16 — поверенный,* 32 — 32 — комиссионер,* 64 — 64 — агент.

|1<code>PrintKurier</code>|4800colspan="2" |1 — печать ФИО курьера на чеке.

|<code>PrintSeller</code>|colspan="2" |1 — печать заказчика на чеке.<br> Если включено, печатается юр. наименование, ИНН и телефон клиента.<br>В [[Клиенты и партнеры#Реквизиты|9600карточке клиента]] на вкладке '''Реквизиты''' должно быть заполнено поле '''Полное название'''.<br> Этот параметр никак не связан с тегами фискального документа 1225 и 1226 и просто выводит текстом на бумагу дополнительный текст там, где это возможно.

|3<code>PrintCashier</code><br>Печатать имя кассира на чеке (тег 1021). По умолчанию 1.|19200colspan="2" |1 — кассир берется из строки чека,<br>0 — не печатается,<br> другое число — код нужного сотрудника.<br>Можно писать подзапрос вида if(a.cl=1, 5, 6).

|4<code>EmailPriority</code>|38400colspan="2" |1 — отправка чека по e-mail приоритетнее, чем SMS.

|5<code>AddStr</code>|57600colspan="2" | Пользовательская строка, которая печатается на всех чеках.

Значение параметра скорости должно совпадать с установленным режимом самого фискального регистратора. По умолчанию он настроен на скорость 115200, однако иногда этот параметр необходимо уменьшить для повышения стабильности работы регистратора. Также были случаи сброса скорости в положение 4800 пользователями, что возможно при включении ФР с зажатой кнопкой промотки чековой ленты (см. [http://courierexe.ru/download/ext_manual/Shtrih_user_manual.pdf руководство пользователя]). Таким образом, начальная настройка в этом режиме исключит вероятность отказа системы из-за ошибочного сброса настройки в ФР. Скорость работы в ФР можно задать кнопкой '''Установить параметры''' окна «Настройка свойств» программы «Тест драйвера ФР». Например, чтобы установить для модуля настройки подключения к ФР следующие параметры: пароль доступа — 30, скорость порта — 4800, укажите строку:  Param=30, 1 == Настройка ФР Штрих-М ==

'''Внимание!''' . Данные фискального документа хранятся в фискальном накопителе 30 дней, после этого срока посмотреть документ регистрации (перерегистрации) в ФН будет невозможно.

== Удаление =службы=Для корректного удаления службы запустите исполняемый файл «CheckServiceExeCheckServiceExe.exe» exe с параметром командной строки « <code>/uninstall»uninstall</code>. 

== Примечания ==

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

|ФР Выключен, ФР подключен не к тому разъему, ФР Настроен настроен не на ту скорость

|Не корректная Некорректная работа фискального регистратора.