Изменения

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

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

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

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

После установки убедитесь, что режим запуска службы установлен '''Примечание'''. Касса Штрих-М работает с чековой службой только при подключении через COM-порт или USB и одновременно передает данные в положение "Автоматически", и запустите службу, используя окно "Службы" операционной системыОФД. При подключении через USB на компьютере настраивается виртуальный COM-порт.

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

# Скопируйте файл CheckServiceExe.exe в любую папку на компьютере:#* для кассы Штрих-М — на тот компьютер, к которому физически подключена касса;#* для кассы LIFE PAY – на любой компьютер, потому что у LIFE PAY облачная фискализация.# Создайте ярлык для файла CheckServiceExe.exe.# В файле, свойствах ярлыка на вкладке '''Ярлык''' в разделе "поле '''Объект''' после имени файла добавьте <code>/install<nowiki/code>:[COMMON[Файл:Установка чековой службы.png|none]<]# Сохраните и запустите ярлык от имени администратора. В результате служба появится в списке служб. Для просмотра списка в контекстном меню '''Мой компьютер''' выберите '''Управление''' > '''Службы'''.# В папке с чековой службой создайте INI-файл или загрузите шаблоны: [https://courierexe.ru/download/checkservice/lifepay/nowiki>"CheckServiceExe.ini LIFE PAY], Вы найдете (если не найдете [https://courierexe.ru/download/checkservice/shtrih/CheckServiceExe.ini Штрих- их можно добавить) следующие М].# Откройте INI-файл, укажите [[#Настройка чековой службы |параметры:]] для своей базы и сохраните изменения.# В контекстном меню элемента '''Мой компьютер''' выберите '''Управление''' > '''Службы''', убедитесь, что режим запуска службы установлен в положение «Автоматически», и запустите чековую службу. Если установка и настройка прошли успешно, то первый чек будет сразу распечатан на кассе.

Можно установить несколько независимых экземпляров службы на одну систему, переименовав exe-файл. Название службы в Windows, файлы настроек и логов будут иметь соответствующие имена. = Настройка чековой службы =Откройте файл CheckServiceExe.ini любым текстовым редактором, например [http://ru.wikipedia.org/wiki/Блокнот_(программа) блокнотом]. В разделе <nowiki>[COMMON]</nowiki> измените или добавьте следующие параметры: {|class="wikitable" style="width: 80%;" "background-color:#ffffff;"!style="width: 20%;"|Параметр!Описаниеstyle="width: 40%;"| Штрих-М!style="width: 40%;"| LIFE PAY

|ServerName<code>Param</code><br>Дополнительные параметры фискального регистратора|Пример: <code>Param=30, 6</code><br>Обязательный параметр, значения указываются через запятую. <br>Первое значение — пароль пользователя ФР, по умолчанию 30. Второе значение — скорость работы ФР. Чтобы узнать скорость, используйте утилиту «Тест драйвера», которая поставляется с кассой: откройте утилиту, нажмите на кнопку '''Настройка свойств''' > '''Поиск оборудования'''. Отобразится подключенный ФР и его <spoiler text="скорость работы">Принимаемые значения параметра '''Скорость порта''':<br>1 — 4800 кбит/с,<br> 2 — 9600 кбит/с,<br> 3 — 19200 кбит/с,<br> 4 — 38400 кбит/с,<br> 5 — 57600 кбит/с,<br> 6 — 115200 кбит/с.<br>Значение параметра скорости должно совпадать с установленным режимом самого фискального регистратора. По умолчанию он настроен на скорость 115200, однако иногда этот параметр необходимо уменьшить для повышения стабильности работы регистратора. Также были случаи сброса скорости в положение 4800 пользователями, что возможно при включении ФР с зажатой кнопкой промотки чековой ленты (см. [http://courierexe.ru/download/ext_manual/Shtrih_user_manual.pdf руководство пользователя]). Таким образом, начальная настройка в этом режиме исключит вероятность отказа системы из-за ошибочного сброса настройки в ФР. Скорость работы в ФР можно задать в утилите «Тест драйвера» в окне «Настройка свойств» кнопкой '''Установить параметры'''.<br>Например, чтобы установить для модуля настройки подключения к ФР следующие параметры: пароль доступа — 30, скорость порта — 4800, укажите строку: <br> Param=30, 1</spoiler>.|ИмяПример: <code>Param=91defdc4556fc182680982e1b2am8d6f, 79011111111,,64</code><br>Необязательный параметр. Если значения указаны в [[Фирмы#Добавление фискального регистратора|фискальном регистраторе]], можно оставить строку в таком виде: <code>#Param=</code><br>Первое значение — 32-значный АПИ-ключ из ЛК LIFE PAY.<br>Второе значение — номер телефона без +, на который зарегистрирован ЛК LIFE PAY. <br>Третье значение — по умолчанию пустое, но можно указать путь к АПИ лайфпей (тикет 76001). Укажите путь https://sapi.life-pay.ru/cloud-print/ - для ФФД 1.05 И 1.1 и путь https://sapi.life-pay.ru/cloud-print-ffd1_2/адрес серверадля ФФД 1.2. <br>Четвертое значение — агентский признак, если есть.

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

|UserName<code>CashRegister</code><br><rspoiler text="Код фискального регистратора">Чтобы его узнать, выберите в главном меню системы пункт '''Справочники''' > '''Фирмы''', откройте карточку фирмы, на которую зарегистрирован фискальный регистратор, перейдите на закладку '''Устройства''', убедитесь, что в выпадающем списке выбрано значение '''Фискальные регистраторы'''. В списке фискальных регистраторов вы увидите код. Если запись для регистратора еще не создана или вы планируете установить дополнительную кассу, добавьте новый ФР.</rspoiler> в базе данных.|Имя пользователя базы данныхcolspan="2" |Пример: <code>CashRegister=2 </code> <br> Обязательный параметр.<br> <spoiler text="Что еще можно указать">Можно указывать наборы обслуживаемых ФР двумя способами:* через запятую или тире или их комбинации указать несколько кодов;* условие SQL-запроса. Например <code>AND cr.DeviceType=3</code> для всех доступных ФР LIFE PAY. Тогда они все будут обслуживаться одним объектом подключения к ФР. Что это значит: для Штрих-М у объекта открыт COM-порт при старте, и поменяться он не может. Все чеки пойдут в один ФР. Для LIFE PAY — в созданный объект передается поле '''Серийный номер''', откуда он берет авторизацию, т.о. чеки могут отправляться в различные аккаунты. Главное, что тип кассы у всех ФР должен быть один — служба не сможет переключиться например с LIFE PAY на ApiShip.</spoiler>

|Password<code>ServerName</code><br>Имя или IP-адрес сервера, на котором находится БД MeaSoft. Сервер должен быть доступен по сети с компьютера, к которому подключена касса.|Пароль пользователя базы данныхcolspan="2" |Пример: <code>ServerName=srv01 </code> <br> Обязательный параметр.

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

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

|Port<code>Password</code><br>Пароль пользователя базы данных|Номер [httpcolspan="2" |Пример:<code>Password=password <//ru.wikipediacode> <br>Обязательный параметр.org/wiki/Последовательный_порт COM-порта] фискального регистратора

|Param<code>DBPort</code><br>Порт базы данных|Дополнительные параметры фискального регистратораcolspan="2" |Пример: <code>DBPort =3306 </code> <br>Обязательный параметр. По умолчанию 3306. Проверить порт можно в любом ярлыке офисной программы.

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

|PrintSeller|1 - Печать заказчика на <code>AgentFlags</code><br>Флаги тега 1057 для передачи в кассу при агентском чеке. Если включено, печатается юр. наименование, ИНН и телефон клиента.|-|AddStr|Пользовательская строка, которая печатается на всех чеках.|-|Device|1 - ФР Штрих-М (по-умолчанию), 2 - Чековый принтер Штрих-М (протокол Epson ESC/P)|} === Описание значений ==colspan='''CashRegister''' - Код фискального регистратора в базе данных. Чтобы узнать, выберите в главном меню системы пункт "Справочники2" - "Фирмы", Откройте двойным щелчком карточку фирмы, на которую зарегистрирован фискальный регистратор, перейдите на закладку "Фискальные регистраторы". Вы увидите список фискальных регистраторов. При необходимости их можно создать здесь же. '''Port''' - Номер COM-порта фискального регистратора. Если регистратор подключен через [http| Пример: <code>AgentFlags=4<//rucode><br>Обязательный параметр, если курьерская служба — платежный агент.wikipedia.org/wiki/USB USB-порт], драйвер эмулятора порта все-равно создает виртуальный COM-порт, номер которого устанавливается в его свойствах Чтобы не передавать признаки платежного агента (если в [http://ru.wikipedia.org/wiki/Диспетчер_устройств Диспетчере устройств]кассе нет этого признака), а также номер порта меняется в зависимости от разъема USB, к которому подключено устройство! '''Param''' - Дополнительные параметрыукажите 0. Для фискальных регистраторов [http://www.shtrih-m.ru/ Штрих-М], на данный момент, единственных, поддерживаемых системойЕсли параметр не указан, в данном параметре через запятую указываются: пароль пользователя ФР (передается значение по-умолчанию - 4. <spoiler text="30Возможные значения" - пароль сис. администратора)>* 1 — банковский платежный агент,* 2 — банковский платежный субагент, а также скорость порта (по-умолчанию - "6"). * 4 — платежный агент,Принимаемые значения параметра "Скорость порта":* 8 — платежный субагент,* 16 — поверенный,{|* 32 — комиссионер,!Значение* 64 — агент.!Скорость (кбит</сек)spoiler>

|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>Можно писать подзапрос вида <code>if(a.cl=1, 5, 6)</code>.

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

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

Значение параметра скорости должно совпадать с установленным режимом самого = Настройка ФР Штрих-М =[[Файл:ShtrihTableList.png|thumb|100px|right]]'''Внимание.''' Для использования программы «Тест драйвера» нужно остановить службу «CheckService». === Обрезка чека ===Обрезка чеков настраивается в таблице 1 фискального регистратора, параметр «Отрезка чека». По-умолчаниюУстановите значение 1 чтобы ФР полностью отрезал каждый чек, при покупкеили 2, чтобы он настроен на скорость 115200, однако, иногда этот параметр необходимо уменьшить для повышения стабильности работы регистратора. Также было замечено, что иногда эта настройка самого регистратора может спонтанно сбрасываться в положение 4800частично надрезал, т.о. изначальная конфигурация в этом режиме исключит вероятность отказа системы изчтобы чеки все-за спонтанного сброса настройки в ФРравно были лентой. Скорость работы в ФР можно задать кнопкой "Установить параметры" окна "Настройка свойств" программы "Тест драйвера ФР"Наша система не посылает на ККМ команду обрезки чека во избежание двойной обрезки.

Например, чтобы установить для модуля настройки подключения к ФР параметры=== Отчет по секциям ===[[Файл: Пароль доступа ShtrihZReportSect.png|thumb|100px|right]]В системе предусмотрено разнесение различных фискальных операций по секциям фискального регистратора. По-умолчанию суточные отчеты (X и Z- 30отчеты) отображают общие суммы по всем секциям. В ФР есть возможность сделать разбивку этих отчетов по секциям. Для этого в таблице 1 фискального регистратора, скорость порта - 4800 необходимо указать строку:параметр «Тип суточного отчета» установите в значение 1.

Param=30== Проверка корректности регистрации в ОФД ===<gallery style="float: right" mode="nolines">Номер фиск документа.pngЧитаем отчет регистрации.png</gallery>Для удовлетворения большинства потребностей наших клиентов в правильной фискализации в соответствии с 54-ФЗ, необходимо иметь [[Оборудование#Фискальный регистратор|ФР]] с фискальным накопителем (ФН) поддерживающие версию фискальный документ (ФД) версии 1.05. Так же необходимо зарегистрировать ФР в ОФД с признаком агента (тег 1057), так как курьерские службы обычно выступают в качестве платежного агента. Для соблюдения всех этих требований нужно обратиться в организацию, обслуживающую ваш фискальный регистратор с соответствующей просьбой. В некоторых случаях для поддержки может понадобиться перепрошивка ФР, замена ФН, перерегистрация в ОФД.После этих операций, можно убедиться, что все признаки, нас интересующие, установлены корректно. Для этого сначала нужно узнать номер документа фискализации. В программе «Тест драйвера» слева откроем раздел «11. ФН», в закладках «Фискализация ФН», нажмем кнопку «Запрос итогов фискализации» (см. скрин-шот). В результирующем отчете видим номер фискального документа о фискализации.Затем идем на закладку «Данные», Вводим номер документа, ставим галку «Показ. номера тегов», и нажимаем «Прочитать документ». В результирующем тексте убеждаемся в использовании версии ФД 1.05 — теги 1209 «Версия ФФД» и 1189 «Версия ФФД ККМ» должны иметь значения 2, тег 1057 «Призн. плат. агента» — должен быть, вероятно, 4 (это регистр битов, значение «4» соответствует установленному биту 2 «Платежный агент»).

== Удаление = Подключение логирования драйвером Штрих-М ===Чековая служба предусматривает включение логирования формирования чека средствами драйвера Штирх-М. Для корректного удаления службы запустите исполняемый файл этого в файле параметров конфигурации необходимо указать в секции[COMMON] для переменной LogShtrih значение "T" или "1"CheckServiceExe.exeОтключить логирование указать " с параметром командной строки F" /uninstallили "0". Путь по которому сохраняется лог, можно посмотреть в настройках драйвера Штрих-М: “Дополнительные параметры” -> Ставим галочку “Вести лог” и указываем путь к файл лога.

Поскольку при запуске служба открывает подключение к фискальному регистраторуК сожалению, эти передаваемые данные далеко не всегда отображаются в бумажном и использует его все время своей работы/или электронном чеках, другие программы (например "Тест драйвера" это зависит от самого ФР и т.д/или ОФД соответственно.) при попытке подключения выдадут ошибку "Невозможно открыть портОднако по данной инструкции мы можем убедиться, он используется другим приложением". Чтобы избежать этогочто со своей стороны передали все данные, остановите службу модуля на время использования других программнеобходимые для соответствия 54-ФЗ.

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

2. Для включения логирования от драйвера Штрих-М в чековой надо установить флаг fDriver.LogOn:= true. По умолчанию false 3. Ошибки условно можно разделить на 3 категории:

|Касса не печатает, в логе сообщения вида "Unknown «Unknown MySQL server host ''" » или "Can't «Can’t connect to MySQL server on..."on…».

|Касса не печатает, в логе сообщения вида "Нет «Нет связи код: -1−1, Режим: 0, Подрежим: 0"0»|ФР Выключен, ФР подключен не к тому разъему, ФР Настроен настроен не на ту скорость|Проверьте, что ФР включен, подключен к компьютеру, именно в тот порт, в котором он настраивался. Попробуйте отключить службу чеков, открыть программу "Тест драйвера"«Тест драйвера», выполнить поиск оборудования. Если она находит ФР - ФР — сравнить настройки подключения, найденные тестом драйвера с тем, что прописано в CheckServiceExe.ini. В единичных случаях проблема может заключаться в драйвере переходника COM-USB, попробуйте удалить этот переходник в диспетчере устройств windows, и попросить его поискать устройства заново.

|Не корректная Некорректная работа фискального регистратора.|Касса печатает заголовок чека, потом ошибку, потом надпись "Чек аннулирован"«Чек аннулирован», и так бесконечно по кругу.

|Если текст ошибки, который печатается на чеке (он же сохраняется и в лог-файл) содержит информацию об [http://ru.wikipedia.org/wiki/ЭКЛЗ ЭКЛЗ] (например "ЭКЛЗ«ЭКЛЗ: Неверные дата или время код: 168, Режим: 3, Подрежим: 0"0») -  — нужно обратиться в компанию, с которой у вас заключен договор о поддержке кассы, сообщить им текст ошибки. В остальных случаях - случаях — обратиться в службу поддержки "Курьерская служба 2008" MeaSoft для выяснения причины и ее устранения.

|Касса печатает X-отчет бесконечно по кругу. В протоколе работы чековой службы выдается сообщение "Команда «Команда не поддерживается в данном режиме код: 115, Режим: 6, Подрежим: 0"0».

|Необходимо через драйвер ФР установить текущую дату и время, затем cохранить настройку. В остальных случаях - случаях — обратиться в службу поддержки "Курьерская служба 2008" MeaSoft для выяснения причины и ее устранения.|} 4. [https://docs.google.com/spreadsheets/d/19Mn5syH70XwFdg6Pe2fhYM17SNHGuOJDvQEQXHxSz54/edit#gid=0 Список ошибок протокола Штрих и их решение] = Печать чеков = === При предоплате ===Если продавец передаёт предоплаченный товар курьерской службе, чек на предоплату формирует продавец. Курьерская служба должна оформить чек на передачу товара, так как ККТ обязано использовать лицо, осуществляющее расчёты с покупателем (п. 1 ст. 4.3 54-ФЗ). Поскольку передача заказа в зачёт предоплаты относится к расчётам и этим занимается курьер, пробить кассовый чек должен именно он. В таком случае покупатель получает два чека: первый чек выдаётся, когда клиент вносит предоплату, а второй чек — когда он получает товар. Подробнее см. [https://astral.ru/articles/ofd/12791 в статье]. === В офисном приложении ===Чековая служба не запрашивает печать бумажного чека, если заказ доставлен курьером: бумажный чек тратит бумагу, и если бумага закончится, то печать чеков остановится. А эту бумагу курьер все равно получателю отдать не сможет. Если клиент находится перед вами, в офисе, то чек печатается — соблюдается одно из условий:* вы отмечаете доставленным отправление, у которого выбрана доставка в пункт выдачи, совпадающий с текущим ответственным филиалом;* вы принимаете оплату за доставку заказа от заказчика, в этом случае вы вносите платеж на вкладке '''Заказы''' в карточке заказа. === LIFE PAY: отличия между чеками в офисном и мобильном приложении ==={|class="wikitable" align="none" style="width: 80%; background-color:#ffffff;!style="width: 20%|Отличие!style="width: 40%|Офисное приложение!style="width: 40%|Мобильное приложение|-|Авторизация. Тег <code>login</code>||Общий номер телефона<br><br>Его можно указать в ini-файле чековой службы или 2-м параметром в поле '''Cерийный номер''' в карточке ФР в программе.<br>Чекопечатающее устройство (ЧПУ) в этом случае не предполагается, а авторизация нужна.||Мобильный телефон курьера<br><br>По этому параметру LIFE PAY определяет, на какой чековый принтер отправлять копию чека.|-|Имя кассира. Тег <code>cashier_name</code>||Параметр <code>PrintCashier</code> в ini-файле<br><br>Если включено, передается ФИО сотрудника, инициировавшего печать.<br>Офисные сотрудники обычно официально трудоустроены, поэтому поле заполняется.||Не указывается<br><br>В большинстве случаев курьеры не оформлены официально, показывать налоговой их не нужно.|-| Режим печати чека. Тег <code>mode</code>.||Печать на бумаге на ФР и отправка SMS или по электронной почте<br><br>В офисе предполагается, что это самовывоз — покупатель стоит перед вами, и вы пробиваете чек и сразу из ФР его отдаете покупателю||Отправка SMS или по электронной почте<br><br>Когда курьер доставляет заказ, он печатает бумажный чек на ЧПУ. Бумажные чеки в отсутствие ЧПУ в офисе [[#Печать чеков в офисном приложении|не печатаются]]. Фискализировать чек, не отправляя его ни на бумагу, ни на ФР, ни по почте/SMS, невозможно, это аппаратно не позволяет делать ФР. Можно на уровне ОФД отключить SMS, если они не нужны, и вам достаточно бумажного чека из ЧПУ.