Изменения

Модуль интеграции с фискальным регистратором (печати кассовых чеков) предназначен для обеспечения возможности взаимодействия системы "Курьерская служба 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<code>AgentFlags</code><br>Флаги тега 1057 для передачи в кассу при агентском чеке|1 - Печать заказчика на чекеcolspan="2" | Пример: <code>AgentFlags=4</code><br>Обязательный параметр, если курьерская служба — платежный агент. Чтобы не передавать признаки платежного агента (если в кассе нет этого признака), укажите 0. Если включенопараметр не указан, печатается юрпередается значение по умолчанию 4. наименование<spoiler text="Возможные значения">* 1 — банковский платежный агент, ИНН и телефон клиента* 2 — банковский платежный субагент,* 4 — платежный агент,* 8 — платежный субагент,* 16 — поверенный,* 32 — комиссионер,* 64 — агент.</spoiler>

|AddStr<code>PrintKurier</code>|Пользовательская строка, которая печатается colspan="2" |1 — печать ФИО курьера на всех чекахчеке.

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

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

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

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

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

Например=== Обрезка чека ===Обрезка чеков настраивается в таблице 1 фискального регистратора, параметр «Отрезка чека». Установите значение 1 чтобы установить для модуля настройки подключения к ФР параметры: Пароль доступа - 30полностью отрезал каждый чек, или 2, чтобы он частично надрезал, скорость порта чтобы чеки все- 4800 необходимо указать строку:равно были лентой. Наша система не посылает на ККМ команду обрезки чека во избежание двойной обрезки.

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

== Обрезка чека ==При желании'''Внимание'''. Данные фискального документа хранятся в фискальном накопителе 30 дней, в программе "Тест драйвера" Вы можете открыть раздел "Таблицы" и настроить после этого срока посмотреть документ регистрации (полную или частичнуюперерегистрации) автоматическую обрезку чека. Наша система не посылает на ККМ команду обрезки чека во избежание двойной обрезкив ФН будет невозможно.

== Отчет по секциям =Проверка корректности передачи тегов в ОФД ===<gallery style="float: right" mode="nolines">Shtrih LastDoc.pngShtrih check tags.png</gallery>Убедиться в корректности передаваемых в ОФД значений тегов можно следующим образом: Сначала узнаем номер фискального документа — его можно посмотреть в чеке (как бумажном, так и электронном), или в приложении «Тест драйвера» в разделе «11. ФН», в закладках «Состояние ФН», нажмем кнопку «Запрос статуса ФН» и посмотрим «Номер последнего ФД» (см. скрин-шот). Далее на закладке «Данные» введем этот номер в поле «№Док.», и нажмем «Прочитать документ». В результирующем тексте убеждаемся в отправке тегов 1008, 1057, 1073, 1171, 1215 и прочих (см. скрин-шот).

Для того, чтобы включить отчет по секциям, необходимо:1Теги 1225 и 1226 (Наименование и ИНН поставщика) поддерживаются Штрих-М в прошивке от 24. Остановить чековую службу10.2018 и версией чековой службы от 19.03.2019

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

3= Удаление службы=Для корректного удаления службы запустите исполняемый файл CheckServiceExe. Выбрать пункт '''“07. Параметры устройства”'''. Открыть вкладку '''“Таблицы”'''exe с параметром командной строки <code>/uninstall</code>.

[[Файл:Kassa1= Устранение неполадок =1.png|650px]]В случае сбоя работы кассы ошибку можно посмотреть в файле CheckServiceExe.log

4. Нажать на кнопку '''“Редактирование таблиц”'''. Откроется окно '''“Таблицы”'''.  [[Файл:Kassa2.png|650px]]   5. Далее необходимо либо дважды нажать на пункт № 1 – '''“Тип и режим кассы”''', либо выделить пункт № 1 и нажать на кнопку '''“Открыть”'''. Откроется окно '''“Тип и режим кассы”'''. [[Файл:Kassa3.png|650px]]  6. Чтобы включить отчет по секциям, необходимо изменить поле '''“Тип суточного отчета”''' на '''1''', как на скриншоте выше.'''Важно: сохранение изменений происходит по нажатию клавиши “Enter”!!!'''  == Удаление ==Для корректного удаления службы запустите исполняемый файл "CheckServiceExe.exe" с параметром командной строки " /uninstall".  == Примечания == Поскольку при запуске служба открывает подключение к фискальному регистратору, и использует его все время своей работы, другие программы (например "Тест драйвера" и т.д.) при попытке подключения выдадут ошибку "Невозможно открыть порт, он используется другим приложением". Чтобы избежать этого, остановите службу модуля на время использования других программ. == Устранение неполадок == 1. В случае сбоя работы кассы ошибку можно посмотреть в файле CheckServiceExe.log 23. Ошибки условно можно разделить на 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, если они не нужны, и вам достаточно бумажного чека из ЧПУ.