Драйвер используется для подключения к кассе фискальных регистраторов, работающих по протоколу Штрих-М.

Настройка ФР

Настройка фискального регистратора осуществляется через менеджер оборудования. 

Для подключения ФР в списке драйверов выберите ФР Штрих-М и сохраните его в списке устройств.

Параметры подключения ФР

• Номер ФР - номер устройства.
  
• Порт - порт, к которому подключается устройство. Порт может быть выбран из списка или задан вручную.
• Скорость - предпочтительная скорость подключения ФР. Скорость подключения может быть выбрана из списка или задана вручную. 
• Пароль доступа - пароль оператора для выполнения команд фискального регистратора. Пароль доступа используется для связи ФР с кассой.

• Сигнал - включение подачи звукового сигнала ФР. Сигнал срабатывает только при условии, если это разрешено настройками кассовой программы. Подробнее о подаче звукового сигнала можно прочитать в разделе "Добавление товара".

  Модели ФР 22 Retail-01K не поддерживает подачу звукового сигнала.

• Сравнение счетчиков - настройка для запрета получения счетчиков ФР. Данные счетчиков используются для дополнительного контроля успешности выполнения кассовых операций.
• Пароль ЦТО - пароль ЦТО для выполнения операций в ФР.
• Отрезчик - использование отрезчика. При включении отрезчика чековая лента будет отрезаться после завершения печати копий документов, отчетов и т.д.
  

• Отрез при закрытии - отрезка бумаги после закрытия чека. Отрезчик срабатывает по команде программы.

  В настройках ФР должна быть отключена автоматическая отрезка чека после закрытия.
• Учитывать размер шрифта при печати - при включении данной настройки ширина ленты будет пересчитываться для каждого шрифта. Настройка используется для корректной печати на ФР MSTAR TSP 700 II.
• Таймаут ожидания ответа - таймаут ожидания ответа от ФР Штрих при добавлении товарной позиции в ФР.
• Таймаут ожидания выполнения команды ФР - таймаут ожидания ответа от ФР Штрих при выполнении любой команды.
• Таймаут печати QR-кода - таймаут ожидания между последовательной печатью QR-кодов.

Подключение по протоколу TCP

Модели ФР Штрих, оборудованные ФН, могут быть подключены к кассе через USB порт и использовать протокол TCP для передачи данных от кассовой программы в ККМ. Для обмена данными необходимо настроить протокол RNDIS.

Для подключения ФР по протоколу TCP необходимо:

1. Посмотреть параметры ФР:
   • в строках 16.3.1-16.6.1 IP адрес ФР,
   • в строке 21.4.1 порт TCP сервера ФР.
2. При подключении ФР к кассе через менеджер оборудования в качестве порта указать TCP:
   
   • Хост - IP адрес ФР,
   • Порт - порт TCP сервера ФР.

Поддерживаемые шрифты

Драйвер Штрих-М поддерживает печать документов следующими шрифтами:

• Normal
• Enlarge
• Compressed
• DoubleWidth
• Smallert
• DoubleHeigth
• Underlined

ФР MSTAR TSP700II использует при печати другие шрифты, поэтому в программе настроено соответствие шрифтов драйвера и принтера:

Связь ФН с ОФД

Протокол RNDIS представляет собой сетевой интерфейс, предназначенный для передачи данных от ККМ в кассовую программу по USB подключению с целью дальнейшей передачи данных в ОФД.

Передача данных от ККМ осуществляется по двум каналам:

• через последовательный интерфейс или TCP передаются данные для кассовой программы,
• по USB передаются данные для ОФД.  

Подготовка к настройке обмена данными

Перед настройкой обмена данными с ОФД через RNDIS необходимо:

1. Просмотреть настройки ККМ, выполнив команду:

   /linuxcash/cash/bin/frinit -gp on

   В результате выполнения команды в файл /linuxcash/logs/current/frinit.log будут выведены таблицы с существующими параметрами ФР.
   В таблице 16 заданы сетевые настройки:

2. • В строках 16.3.1 - 16.6.1 указывается ip-адрес ФР (указывается в качестве хоста при подключении ФР через менеджер оборудования).
   • В строках 16.7.1 - 16.10.1 указывается адрес шлюза сети ФР.
   • В строках 16.11.1 - 16.14.1 указывается маска сети ФР.
   • В строках 16.15.1 - 16.18.1 указывается адрес DNS-сервера (DNS кассы)
   В таблице 19 заданы параметры ОФД:
   
   • В строке 19.1.1 указывается адрес сервера ОФД. 
   • В строке 19.2.1 указывается порт сервера ОФД.
   • В строке 19.3.1 указывается таймаут чтения ответа.
   В таблице 21 задан статус активности RNDIS:
   • В строке 21.4.1 указывается порт подключения ФР (указывается в качестве порта при подключении ФР через менеджер оборудования).
   • В строке 21.9.1 указан статус активности RNDIS, который может принимать значения:
   1. • 0 - выключен,
      • 1 - включен.

3. Просмотреть параметры сети, к которой подключена касса.

   ВАЖНО!

   Настройки сети в кассовой программе не должны совпадать с настройками сети ФР, т.к. обмен данными ККМ-касса и ККМ-ОФД должен выполняться в разных интерфейсах.

Настройка передачи данных

Для настройки передачи данных от ККМ в ОФД по usb-кабелю необходимо:

1. Запрограммировать параметры таблиц 16, 19, 21 в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini в секции [HW.FR.commons.params].

   В большинстве случаев для передачи данных могут быть использованы параметры по умолчанию и не требуется их дополнительного программирования.

2. Установить пакет artix-rndis, выполнив команду:

   aptitude install artix-rndis

   Вместе с пакетом artix-rndis автоматически устанавливается пакет iptables, который используется для настройки маршрутизации пакетов с интерфейса ФР на интерфейс кассы.

3. В конфигурационном файле /opt/RNDIS/conf.ini указать:

   1. Для подключения одного ФР - настройки шлюза, которые запрограммированы в ФР (строки 16.7.1 - 16.10.1):

      Пример настройки для одного ФР

      ...
      # Настройки интерфейса без привязки к MAC адресу
      # IP адрес устройства
      ADDRESS=192.168.137.1
      # Маска сети
      MASK=255.255.255.0 
      ...

   2. Для подключения от двух до десяти ФР - настройки шлюза, а также MAC-адрес каждого из ФР:

      Пример настройки от двух до десяти ФР

      ...
      # Настройки интерфейсов с привязкой к MAC адресу 
      # MAC адрес устройства
      MAC1=00:60:37:ac:8c:90
      # IP адрес устройства
      ADDRESS1=192.168.137.1
      # Маска сети
      MASK1=255.255.255.0
      # MAC адрес устройства
      MAC2=00:60:37:4a:25:03
      # IP адрес устройства
      ADDRESS2=192.168.138.1
      # Маска сети
      MASK2=255.255.255.0
      ...

      Посмотреть MAC-адрес подключенных ФР можно в логе rndis.log, который находится в директории /linuxcash/logs/current/:

      Пример MAC-адреса в логе

      ...
      2018-07-03 15:05:48.131 - Подключен RNDIS интерфейс RNDIS16, MAC=00:60:37:ac:8c:90
      ...

4. Для вступления в силу запрограммированных параметров необходимо выключить и включить ФР.

Доступность сетевого интерфейса RNDIS

Статус сетевого интерфейса RNDIS проверяется с периодичностью в 10 минут. При отсутствии связи с ФР программа переподключает сетевой интерфейс. Данные проверки записываются в файл /linuxcash/logs/current/rndis.log. Переподключить сетевой интерфейс вручную можно путем перезагрузки кассы. 

Проверка потоварных счетчиков в ФР

При пробитии большого количества данных на ФР Штрих могут возникать ситуации, в которых при добавлении позиции ФР не отвечает, команда добавления позиции отправляется повторно и в результате позиция задваивается. Проверка потоварных счетчиков в ФР Штрих активируется в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/fr.ini.

[HW.FR]

; Проверка потоварных счетчиков на ФР.
; Если ФР поддерживает проверку счетчиков и включена настройка, то после
; добавления всех позиций в ФР будет происходить проверка на кол-во товаров в программе и ФР
; По умолчанию выключено
;checkPositionCounters = false

Добавление товарных позиций в ФР осуществляется при закрытии кассового чека в программе.

При закрытии чека позиции из программы объединяются по отделам и в ФР на каждый отдел добавляется отдельная позиция. Если у товара не указан отдел, указан отдел с №0 или не настроено соотнесение отделов, то в ФР такие позиции записываются в отдел №1. 

 При закрытии чека кассовая программа сравнивает счетчики в программе и в ФР.

• При совпадении счетчиков чек в ФР закрывается. 
• Если счетчики расходятся, то чек в ФР аннулируется, на экран кассира выводится ошибка "Ошибка ФР: Ошибка регистрации позиции". Чек необходимо закрыть повторно.

Прошивка ФР

Кассовое ПО Artix позволяет выполнять прошивку ФР Штрих.

Для прошивки ФР необходимо:

1. Разместить файл прошивки в директорию /linuxcash/cash/conf/frupgrade/. Файл прошивки может носит название upd_app_for_old_frs.bin или upd_app.bin в зависимости от ФР. Необходимый файл будет выбран автоматически.
2. Перезапустить кассовую программу.

На время прошивки таблицы ФР записываются в файл /linuxcash/cash/data/tmp/frparams.<номер_фр>.<хэш_прошивки>. В случае, если в процессе прошивки ФР оборудование было выключено, то при повторном включении прошивка будет продолжена с того места, на котором была завершена.

Статус прошивки для всех ФР записывается в файле /linuxcash/cash/data/tmp/frupgrade.status. Возможные статусы:

• paramsStored параметры ФР были сохранены в файл,
• firmwareLoaded прошивка была загружена в ФР,
• upgradeFinished обновление было полностью выполнено.

{
 "000987654321" :  {
  "firmware" : "32be5c4599e1a66849f365cb13e81e3154de45ef",
  "state" : "paramsStored" 
 },
 "00012356789" :  {
  "firmware" : "43be5c4599e1a66849f365cb13e81e315aab5f8a",
  "state" : "firmwareLoaded" 
 }
}

Системы налогообложения для ФР Штрих

Перерегистрация ККТ с заменой системы налогообложения (СНО)

Для перерегистрации ККТ с заменой СНО необходимо:

1. Создать директорию /linuxcash/cash/conf/sno/.

2. Поместить в директорию json-файл:

   {
   "producer": "shtrihm",
   "registerFrom": "31.12.2020 01:59:59",
   "taxSystem": ["OSN"]
   }

   , где:

   • producer - наименование производителя, необязательное поле;

   • registerFrom - дата, начиная с которой будет произведена перерегистрация ФР, необязательное поле;

   • taxSystem - список систем налогообложения в строковом виде, обязательное поле. Возможные значения:

     • "OSN" - Общая (ОСН);
     • "USN1" - Упрощенная, доход (УСН1);
     • "USN2" - Упрощенная, доход минус расход (УСН2);
     • "ENVD" - Единый налог на вмененный доход (ЕНВД);
     • "ESHN" - Единый сельскохозяйственный налог (ЕСХН);

     • "PATENT" - Патентная система налогообложения (ПАТЕНТ).

       Может быть указано несколько СНО:

       "taxSystem": ["ENVD", "OSN"]

При вызове frinit будет выполнена проверка наличия json-файла в директории /linuxcash/cash/conf/sno/, далее будет осуществлена перерегистрация KKT с установкой СНО.

При наличии нескольких json-файлов загружается первый попавшийся.