Изменения

Модуль интеграции с фискальным регистратором (печати кассовых чеков состоит из файлов) предназначен для обеспечения возможности взаимодействия системы MeaSoft с фискальными регистраторами. Он представляет собой [http:CheckServiceExe.exe - Исполняемый файл службыCheckServiceExe//ru.ini - Конфигурационный файлCheckServiceExewikipedia.log - Файл журналаorg/wiki/Службы_Windows службу Windows], которая подключается к БД системы и к фискальному регистратору. Если его нет - он создается при запуске службы

MeaSoft поддерживает неограниченное количество регистраторов, в том числе и зарегистрированных на одно юридическое лицо. Чтобы подключить несколько регистраторов, установите соответствующее количество модулей интеграции с ФР. Модуль печати кассовых чеков состоит из следующих файлов:* CheckServiceExe.exe — исполняемый файл службы;* CheckServiceExe.ini — конфигурационный файл;* CheckServiceExe.log — файл журнала. Если его нет, создается при запуске службы. = Применение = Чековая служба нужна, если:* установлена касса Штрих-М — для печати чеков в офисной системе и мобильном приложении курьера.:При закрытии заказа курьером в мобильном приложении для печати чеков нужен [[Настройка модуля автоматизации|модуль автоматизации]], который будет отправлять чеки, поскольку прямой связи мобильного приложения с Штрих-М нет; * установлена касса LIFE PAY — для ручной печати чека из офисного приложения. Для печати чека через LIFE PAY и Штрих-Нано-Ф при закрытии заказа курьером в мобильном приложении чековая служба не нужна. '''Примечание'''. Касса Штрих-М работает с чековой службой только при подключении через COM-порт или USB и одновременно передает данные в ОФД. При подключении через USB на компьютере настраивается виртуальный COM-порт. =Установка чековой службы=  # Скопируйте файл CheckServiceExe.exe в любую папку на компьютере:#* для кассы Штрих-М — на тот компьютер, к которому физически подключена касса;#* для кассы LIFE PAY – на любой компьютер, потому что у LIFE PAY облачная фискализация.# Создайте ярлык для файла CheckServiceExe.exe.# В свойствах ярлыка на вкладке '''Ярлык''' в поле '''Объект''' после имени файла добавьте <code>/install</code>:[[Файл:Установка чековой службы.png|none]]# Сохраните и запустите ярлык от имени администратора. В результате служба появится в списке служб. Для просмотра списка в контекстном меню '''Мой компьютер''' выберите '''Управление''' > '''Службы'''.# В папке с чековой службой создайте INI-файл или загрузите шаблоны: [https://courierexe.ru/download/checkservice/lifepay/CheckServiceExe.ini LIFE PAY], [https://courierexe.ru/download/checkservice/shtrih/CheckServiceExe.ini Штрих-М].# Откройте INI-файл, укажите [[#Настройка чековой службы |параметры]] для своей базы и сохраните изменения.# В контекстном меню элемента '''Мой компьютер''' выберите '''Управление''' > '''Службы''', убедитесь, что режим запуска службы установлен в положение «Автоматически», и запустите чековую службу. Если установка и настройка прошли успешно, то первый чек будет сразу распечатан на кассе.  Если чек не печатается, смотрите причины в файле логов чековой службы CheckServiceExe.log. Он находится в папке чековой службы. Подробнее см. раздел «[[Устранение неполадок]]». Можно установить несколько независимых экземпляров службы на одну систему, переименовав exe-файл. Название службы в Windows, файлы настроек и логов будут иметь соответствующие имена. =Настройка чековой службы =Откройте файл CheckServiceExe.ini любым текстовым редактором, например, [http://ru.wikipedia.org/wiki/Блокнот_(программа) блокнотом]. В разделе <nowiki>[COMMON]</nowiki> измените или добавьте следующие параметры: {|class="wikitable" style="width: 80%C1;" "background-color:#ffffff;"!style="width: 20%EB;"|Параметр!style="width: 40%EE;"| Штрих-М!style="width: 40%EA%ED%EE%F2_;"| LIFE PAY|-|<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>Третье значение — по умолчанию пустое, но можно указать путь к АПИ лайфпей (%EF%F0%EE%E3%F0%E0%EC%EC%E0тикет 76001) блокнотом. Укажите путь https://sapi.life-pay.ru/cloud-print/ - для ФФД 1.05 И 1.1 и путь https://sapi.life-pay.ru/cloud-print-ffd1_2/ для ФФД 1.2. <br>Четвертое значение — агентский признак, если есть.|-|<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.|-|<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>|-|<code>ServerName</code><br>Имя или IP-адрес сервера, на котором находится БД MeaSoft. Сервер должен быть доступен по сети с компьютера, к которому подключена касса.|colspan="2" |Пример: <code>ServerName=srv01 </code> <br> Обязательный параметр.|-|<code>DatabaseName</code><br>Имя базы данных (по умолчанию «courier»)|colspan="2" |Пример: <code>DataBaseName=courier</code> <br>Обязательный параметр.|-|<code>UserName</code><br>Имя пользователя базы данных|colspan="2" |Пример: <code>UserName=check</code> <br>Обязательный параметр. Пользователя check нужно создать для определения запросов чековой службы, для этого обратитесь в техподдержку.|-|<code>Password</code><br>Пароль пользователя базы данных|colspan="2" |Пример: <code>Password=password </code> <br>Обязательный параметр.|-|<code>DBPort</code><br>Порт базы данных|colspan="2" |Пример: <code>DBPort =3306 </code> <br>Обязательный параметр. По умолчанию 3306. Проверить порт можно в любом ярлыке офисной программы.|-|<code>Device</code>|1 — ФР Штрих-М (по умолчанию), <br> 2 — чековый принтер Штрих-М (протокол Epson ESC/P)|3 — сервис фискализации LIFE PAY <br> 9 - WebKassa|-|<code>AgentFlags</code><br>Флаги тега 1057 для передачи в разделе кассу при агентском чеке|colspan="2" | Пример: <code>AgentFlags=4</code><br>Обязательный параметр, если курьерская служба — платежный агент. Чтобы не передавать признаки платежного агента (если в кассе нет этого признака), укажите 0. Если параметр не указан, передается значение по умолчанию 4. <spoiler text="Возможные значения">* 1 — банковский платежный агент,* 2 — банковский платежный субагент,* 4 — платежный агент,* 8 — платежный субагент,* 16 — поверенный,* 32 — комиссионер,* 64 — агент.</spoiler>|-|<code>PrintKurier</code>|colspan="2" |1 — печать ФИО курьера на чеке.|-|<code>PrintSeller</code>|colspan="2"|1 — печать заказчика на чеке.<br> Если включено, печатается юр. наименование, ИНН и телефон клиента.<nowikibr>В [COMMON[Клиенты и партнеры#Реквизиты|карточке клиента]]на вкладке '''Реквизиты''' должно быть заполнено поле '''Полное название'''.<br> Этот параметр никак не связан с тегами фискального документа 1225 и 1226 и просто выводит текстом на бумагу дополнительный текст там, где это возможно.|-|<code>PrintCashier</nowikicode><br>Печатать имя кассира на чеке (тег 1021). По умолчанию 1.|colspan=" Вы найдете 2" |1 — кассир берется из строки чека,<br>0 — не печатается,<br> другое число — код нужного сотрудника.<br>Можно писать подзапрос вида <code>if(если a.cl=1, 5, 6)</code>.|-|<code>EmailPriority</code>|colspan="2" |1 — отправка чека по e-mail приоритетнее, чем SMS.|-|<code>AddStr</code>|colspan="2" | Пользовательская строка, которая печатается на всех чеках.|-|} = Настройка ФР Штрих-М =[[Файл:ShtrihTableList.png|thumb|100px|right]]'''Внимание.''' Для использования программы «Тест драйвера» нужно остановить службу «CheckService». === Обрезка чека ===Обрезка чеков настраивается в таблице 1 фискального регистратора, параметр «Отрезка чека». Установите значение 1 чтобы ФР полностью отрезал каждый чек, или 2, чтобы он частично надрезал, чтобы чеки все-равно были лентой. Наша система не найдете посылает на ККМ команду обрезки чека во избежание двойной обрезки. === Отчет по секциям ===[[Файл:ShtrihZReportSect.png|thumb|100px|right]]В системе предусмотрено разнесение различных фискальных операций по секциям фискального регистратора. По-умолчанию суточные отчеты (X и Z-отчеты) отображают общие суммы по всем секциям. В ФР есть возможность сделать разбивку этих отчетов по секциям. Для этого в таблице 1 фискального регистратора, параметр «Тип суточного отчета» установите в значение 1. === Проверка корректности регистрации в ОФД ===<gallery style="float: right" mode="nolines">Номер фиск документа.pngЧитаем отчет регистрации.png</gallery>Для удовлетворения большинства потребностей наших клиентов в правильной фискализации в соответствии с 54-ФЗ, необходимо иметь [[Оборудование#Фискальный регистратор|ФР]] с фискальным накопителем (ФН) поддерживающие версию фискальный документ (ФД) версии 1.05. Так же необходимо зарегистрировать ФР в ОФД с признаком агента (тег 1057), так как курьерские службы обычно выступают в качестве платежного агента. Для соблюдения всех этих требований нужно обратиться в организацию, обслуживающую ваш фискальный регистратор с соответствующей просьбой. В некоторых случаях для поддержки может понадобиться перепрошивка ФР, замена ФН, перерегистрация в ОФД.После этих операций, можно убедиться, что все признаки, нас интересующие, установлены корректно. Для этого сначала нужно узнать номер документа фискализации. В программе «Тест драйвера» слева откроем раздел «11. ФН», в закладках «Фискализация ФН», нажмем кнопку «Запрос итогов фискализации» (см. скрин-шот). В результирующем отчете видим номер фискального документа о фискализации.Затем идем на закладку «Данные», Вводим номер документа, ставим галку «Показ. номера тегов», и нажимаем «Прочитать документ». В результирующем тексте убеждаемся в использовании версии ФД 1.05 — теги 1209 «Версия ФФД» и 1189 «Версия ФФД ККМ» должны иметь значения 2, тег 1057 «Призн. плат. агента» — должен быть, вероятно, 4 (это регистр битов, значение «4» соответствует установленному биту 2 «Платежный агент»). '''Внимание'''. Данные фискального документа хранятся в фискальном накопителе 30 дней, после этого срока посмотреть документ регистрации (перерегистрации) в ФН будет невозможно. === Подключение логирования драйвером Штрих-М ===Чековая служба предусматривает включение логирования формирования чека средствами драйвера Штирх- их М. Для этого в файле параметров конфигурации необходимо указать в секции[COMMON] для переменной LogShtrih значение "T" или "1". Отключить логирование указать "F" или "0". Путь по которому сохраняется лог, можно посмотреть в настройках драйвера Штрих-М: “Дополнительные параметры” -> Ставим галочку “Вести лог” и указываем путь к файл лога.  === Проверка корректности передачи тегов в ОФД ===<gallery style="float: right" mode="nolines">Shtrih LastDoc.pngShtrih check tags.png</gallery>Убедиться в корректности передаваемых в ОФД значений тегов можно следующим образом: Сначала узнаем номер фискального документа — его можно добавитьпосмотреть в чеке (как бумажном, так и электронном) следующие параметры, или в приложении «Тест драйвера» в разделе «11. ФН», в закладках «Состояние ФН», нажмем кнопку «Запрос статуса ФН» и посмотрим «Номер последнего ФД» (см. скрин-шот). Далее на закладке «Данные» введем этот номер в поле «№Док.», и нажмем «Прочитать документ». В результирующем тексте убеждаемся в отправке тегов 1008, 1057, 1073, 1171, 1215 и прочих (см. скрин-шот). Теги 1225 и 1226 (Наименование и ИНН поставщика) поддерживаются Штрих-М в прошивке от 24.10.2018 и версией чековой службы от 19.03.2019 К сожалению, эти передаваемые данные далеко не всегда отображаются в бумажном и/или электронном чеках, это зависит от самого ФР и/или ОФД соответственно. Однако по данной инструкции мы можем убедиться, что со своей стороны передали все данные, необходимые для соответствия 54-ФЗ. = Удаление службы=Для корректного удаления службы запустите исполняемый файл CheckServiceExe.exe с параметром командной строки <code>/uninstall</code>. = Примечания =Поскольку при запуске служба открывает подключение к фискальному регистратору, и использует его все время своей работы, другие программы (например «Тест драйвера» и т. д.) при попытке подключения выдадут ошибку «Невозможно открыть порт, он используется другим приложением». Чтобы избежать этого, остановите службу модуля на время использования других программ. = Устранение неполадок =1. В случае сбоя работы кассы ошибку можно посмотреть в файле CheckServiceExe.log 2. Для включения логирования от драйвера Штрих-М в чековой надо установить флаг fDriver.LogOn:= true. По умолчанию false 3. Ошибки условно можно разделить на 3 категории:

!ПараметрОшибка!ОписаниеСимптомы!Возможные причины!Способы устранения

|ServerNameНет связи с сервером|Имя/адрес Касса не печатает, в логе сообщения вида «Unknown MySQL server host ''» или «Can’t connect to MySQL server on…».|Неверно настроено подключение к серверу, не работает сервер, сеть.|Проверить настройки подключения в файле CheckServiceExe.ini, проверить доступность серверас этого компьютера.

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

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

|PasswordОшибка при формировании отчета без гашения (X-отчет)|Пароль пользователя базы данныхКасса печатает X-отчет бесконечно по кругу. В протоколе работы чековой службы выдается сообщение «Команда не поддерживается в данном режиме код: 115, Режим: 6, Подрежим: 0».|В кассовом аппарате не установлены дата и время.|Необходимо через драйвер ФР установить текущую дату и время, затем cохранить настройку. В остальных случаях — обратиться в службу поддержки 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%|Мобильное приложение

|DBPortАвторизация. Тег <code>login</code>|Порт базы данных (по|Общий номер телефона<br><br>Его можно указать в ini-умолчанию файле чековой службы или 2- 3306м параметром в поле '''Cерийный номер''' в карточке ФР в программе.<br>Чекопечатающее устройство (ЧПУ)в этом случае не предполагается, а авторизация нужна.||Мобильный телефон курьера<br><br>По этому параметру LIFE PAY определяет, на какой чековый принтер отправлять копию чека.

|CashRegisterИмя кассира. Тег <code>cashier_name</code>|Код фискального регистратора |Параметр <code>PrintCashier</code> в базе данныхini-файле<br><br>Если включено, передается ФИО сотрудника, инициировавшего печать.<br>Офисные сотрудники обычно официально трудоустроены, поэтому поле заполняется.||Не указывается<br><br>В большинстве случаев курьеры не оформлены официально, показывать налоговой их не нужно.

|PortРежим печати чека. Тег <code>mode</code>.|Номер COM-порта фискального регистратора|-Печать на бумаге на ФР и отправка SMS или по электронной почте<br><br>В офисе предполагается, что это самовывоз — покупатель стоит перед вами, и вы пробиваете чек и сразу из ФР его отдаете покупателю|Param|Дополнительные параметры фискального регистратораОтправка SMS или по электронной почте<br><br>Когда курьер доставляет заказ, он печатает бумажный чек на ЧПУ. Бумажные чеки в отсутствие ЧПУ в офисе [[#Печать чеков в офисном приложении|не печатаются]]. Фискализировать чек, не отправляя его ни на бумагу, ни на ФР, ни по почте/SMS, невозможно, это аппаратно не позволяет делать ФР. Можно на уровне ОФД отключить SMS, если они не нужны, и вам достаточно бумажного чека из ЧПУ.