Изменения

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

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

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

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

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

После установки убедитесь, что режим запуска службы установлен в положение "Автоматически"«Автоматически», и запустите службу, используя окно "Службы" «Службы» операционной системы. Можно установить несколько независимых экземпляров службы на одну систему, переименовав exe-файл. Название службы в Windows, файлы настроек и логов будут иметь соответствующие имена.

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

!text-align:left;"|Параметр!Описание

|Имя базы данных (по-умолчанию - "courier"«courier»)

|Порт базы данных (по-умолчанию - 3306)

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

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

|1 - Печать 1 — печать ФИО курьера на чеке.

|1 - Печать 1 — печать заказчика на чеке. Если включено, печатается юр. наименование, ИНН и телефон клиента. Чтобы это работало, необходимо, чтобы в карточке клиента было должно быть заполнено поле '''"Полное название"''', на вкладке '''"Реквизиты"'''. Этот параметр никак не связан с тегами фискального документа 1225 и 1226 и просто выводит текстом на бумагу дополнительный текст там, где это возможно.|-|PrintCashier|1 — печать кассира на чеке (тег 1021). По умолчанию 1. 1 — кассир берется из строки чека, 0 — не печатается, другое число — код нужного сотрудника. Можно писать подзапрос вида if(a.cl=1, 5, 6).

|1 - Отправка 1 — отправка чека по e-mail приоритетнее , чем SMS.

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

'''CashRegister''' - Код фискального регистратора в базе данных. Чтобы узнать, выберите в главном меню системы пункт "Справочники" - "Фирмы", Откройте двойным щелчком карточку фирмы, на которую зарегистрирован фискальный регистратор, перейдите на закладку "Фискальные регистраторы". Вы увидите список фискальных регистраторов. При необходимости их можно создать здесь же. '''Port''' - Номер COM-порта фискального регистратора. Если регистратор подключен через [http://ru.wikipedia.org/wiki/USB USB-порт], драйвер эмулятора порта все-равно создает виртуальный COM-порт, номер которого устанавливается в его свойствах (в [http://ru.wikipedia.org/wiki/Диспетчер_устройств Диспетчере устройств]), а также номер порта меняется в зависимости от разъема USB, к которому подключено устройство! '''Param''' - Дополнительные  — дополнительные параметры. *Для фискальных регистраторов [http://www.shtrih-m.ru/ Штрих-М], в данном параметре через запятую указываются: пароль пользователя ФР (по-умолчанию - "'''30" - ''' — пароль сис. системного администратора), а также скорость порта (по-умолчанию - "'''6"'''). *Для Life-pay LIFE PAY через запятую указываются apiAPI-ключ и телефон-имя-пользователя. Если у ФР LIFE PAY в БД заполнено поле '''Серийный номер''', то значения приоритетно берутся оттуда.

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

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

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

'''Внимание.''' Для использования программы "Тест драйвера" «Тест драйвера» нужно остановить службу "CheckService"«CheckService».

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

В системе предусмотрено разнесение различных фискальных операция операций по секциям фискального регистратора. По-умолчанию суточные отчеты (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 дней, после этого срока посмотреть документ регистрации (перерегистрации) в ФН будет невозможно.

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

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

|Касса не печатает, в логе сообщения вида "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" 2008» для выяснения причины и ее устранения.

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

|Необходимо через драйвер ФР установить текущую дату и время, затем cохранить настройку. В остальных случаях - случаях — обратиться в службу поддержки "Курьерская «Курьерская служба 2008" 2008» для выяснения причины и ее устранения.|} = Печать чеков = === При предоплате ===Если продавец передаёт предоплаченный товар курьерской службе, чек на предоплату формирует продавец. Курьерская служба должна оформить чек на передачу товара, так как ККТ обязано использовать лицо, осуществляющее расчёты с покупателем (п. 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, если они не нужны, и вам достаточно бумажного чека из ЧПУ.