Подключение фискальных регистраторов

Список поддерживаемых фискальных регистраторов:

Поддерживаемые драйвером старого образца:

"Старые" модели (не online):

  1. АТОЛ:
  • FPrint 22k (ПТК)
  • FPrint 55k (ПТК)
  • FPrint 77k (ПТК)
  • FPrint 5200K 
  • FPrint 03k
  • FPrint 02k 
  • FPrint 11 ПТК
  • АТОЛ 30Ф
  1. ШТРИХ:
  • Retail-01K (01Ф)
  • ФР-К 
  • ФР-Ф 
  • ПТК 
  • мини
  1. AMC100F
  2. DATECS FP3530t
  3. ПРИМ
  4. Старт 200К

"Новые" ФР (ФЗ-54 Online-касса):

  • Retail-01K (Ритейл-01Ф) протокол Штриха (#93237)
  • FPrint-22ПТК (#93598)
  • АТОЛ 55Ф (FPrint55k (ПТК))
  • АТОЛ 30Ф *
  • АТОЛ 77Ф (он же FPrint-77ПТК)

* - АТОЛ работает по протоколу 2.4. Отправка данных по данному протоколу так же возможна, но требует специальных настроек со стороны ЦТО или Заказчика. В случае проблем можно обращаться в тех поддержку АТОЛ.

 

ФР поддерживаемые универсальным драйвером:

  1. АТОЛ:
  • FPrint 22k (ПТК)
  • Атол 22Ф
  • Атол 30Ф
  • FPrint 55k (ПТК)
  • Атол 55Ф
  • FPrint 77k (ПТК)
  • Атол 77Ф
  • FPrint 5200K 
  • FPrint 03k
  • FPrint 02k 
  • FPrint 11 ПТК
  1. ШТРИХ:
  • Retail-01K (01Ф)
  • ФР-К 
  • ФР-Ф 
  • ПТК 
  • мини
  • ...
  • РР-02Ф
  • «MSTAR-TK»
  • и прочие ФР, работающие по протоколу штриха

       ФР ПРИМ 08-Ф

       ФР СПАРК 115-Ф

       ФР DATECS DP 25

Технические требования.

Машина, к которой производится подключение, должна иметь COM-порт (Serial-порт \ серийный порт \ RS-232), либо установленные драйвера для имитации такого подключения через USB. Для подключения двух и более фискальных регистраторов (ФР) машина быть оборудована необходимым количеством COM-портов. В случае отсутствия необходимого количества COM портов можно использовать переходники PCI на RS-232 и USB на RS-232 (см. Рекомендуемые переходники USB на RS-232 и PCI на RS-232.doc)


ВАЖНО!
В Абонемент, каждое рабочее место, на котором регистрируются платежи должно быть настроено как отдельный киоск. Особенно в случае, если к данному рабочему месту подключён ФР.
 
В противном случае велика вероятность получить ошибку вида:
lock conflict on no wait transaction
deadlock
update conflicts with concurrent update
concurrent transaction number is 71234666
At procedure 'SP_BILL_CREATE' line: 101, col:41
 
Данная ошибка может возникать, в случае, если 2 или более рабочих места настроены на работу как один киоск Абонемент. В таком случае, при одновременном открытии чека на данных рабочих местах возникнет ошибка.

В настоящий момент ПО «Abonementmanager» гарантирует поддержку фискальных регистраторов «Штрих» (в т.ч. Retail-01K), «Прим» (в т.ч. «Старт 200К»), «Меркурий», «Атол» (FPrint), "Мария", "Спарк" и некоторые другие. Самые последние версии драйвера для работы с ПО Абонемент находятся в сборке Fullversion последней версии, в папке /exe/. Для уточнения, поддерживается ли Ваш ФР в случае, если его нет в нижеприведённом списке, обратитесь в техническую поддержку.

  ; FiscReg = SPARK     
  ; FiscReg = MARIA301  
  ; FiscReg = GEG 
  ; FiscReg = MERCURY
  ; FiscReg = SHTRIHM   ; АТОЛ FPrint 22k (ПТК), 55k (ПТК), 5200K, 03k, 02k, 11 ПТК
  ; FiscReg = SHTRIHM-FZ54 ; АТОЛ (онлайн 54ФЗ) 22Ф, 55Ф, 77Ф.
  ; FiscReg = SHTRIHMA  ; ШТРИХ, Retail-01K, ФР-К, ФР-Ф, ПТК, мини
  ; FiscReg = AMC100F
  ; FiscReg = DATECFP3530
  ; FiscReg = AZIMUTH   ; ПРИМ , Старт 200К

Структурная схема взаимодействия ФР и ПО Абонемент.

(Рис.1 - Структурная схема взаимодействия ФР и ПО абонемент.)

Пояснение: sdmXX.dll - драйвер для определенного фискального регистратора, где ХХ - имя определенного ФР (например: sdmShtrihMA11.dll, sdmSPARK617TF.dll, sdmShtrihM21.dll (sdmShtrihM21Old.dll) или sdmShtrihM21FZ54.dll)

Пример: ShtrihMA11 (Штрих Retail-01K / ФР-К / ФР-Ф / ПТК / мини) 

Внимание! Эмуляция порта не поддерживается для моделей "ПТК".

Фискальный регистратор подключается в СОМ-порт или другой порт с эмуляцией серийного порта. Настройки COM-порта можно узнать в программе «Тест Драйвера», данная программа находится на диске в комплекте оборудования:

 

На рабочем месте (компьютере, к которому физически подключен ФР) необходимо убедиться в наличии файлов sdmShtrihMA11.dll ShtrihMA11.RUS.Msg (файл ошибок) в папке ..\exe\. Файл shelter.hw.ini, находящийся в этой же папке, должен быть настроен следующим образом:

[BOOT]
  shtrih = sdmShtrihMA11.dll

[hardware]
   FiscReg = SHTRIHMA
[FiscReg.ShtrihMA]
; ФР Штрих.
; Подставляем параметры из Теста Драйвера
  COMPORT = 5
  COMPORTPARAMS=baud=4800 parity=n data=8 stop=1 rts=on dtr=on

  ; Печать отчета по секциям перед X,Z-отчетами
  PrintSectionReport = 0
  ; Если в чеке иероглифы - попробовать поменять значение (0/1)  
  ToOEM      = 1
  MaxLine    = 24
  PassWord   = 30
  SEPassword = 0
  MsgFile    = ShtrihMA11.RUS.Msg
  MsgSection = Errors

Настройка ФР Штрих для работы по секциям.

Через программу Тест драйвера FR подключиться к фискальному регистратору, зайти в Настройки свойств / Таблицы / Тип и режим кассы. далее в зависимотсти от модели Штриха или в 35 поле Сокращенный отчет с гашением установить 0, или в 30 поле Тип суточного отчета установить 1. Эту операцию можно сделать независимо закрыта или открыта смены фискального регистратора. После такой настройки, перед стандартным Z отчетом будет печататься отчет по секциям и отчет по налогам.

Проверить что в настройках shelter.hw.ini параметр  PrintSectionReport = 0. Этот параметр отвечает за печать отчета на секциям в нефискальном режиме средствами драйвера. Для программного обеспечения Абонемент не рекомендуется к использованию.

 

 

Пример: ShtrihM21 (Атол FPrint 22k (ПТК) / 55k (ПТК) / 5200K / 03k / 02k / 11 ПТК / 30Ф) 

Фискальный регистратор подключается в СОМ-порт или другой порт с эмуляцией серийного порта.

Настройки COM-порта можно узнать в настройках драйвера (можно взять с официального саита Атол):

 

Из поля "Найденные устройства" подставляем данные в Shelter.hw.ini:

[BOOT]
  atol = sdmShtrihM21.dll

[hardware]
   FiscReg = SHTRIHM

[FiscReg.SHTRIHM]
; ФР АТОЛ (FPrint 22k, FPrint55k, FPrint 5200K)
; Версия. Обычно 22, Если не заводится - попробовать поставить 21  
  Version = 22
; Подставляем параметры из Теста Драйвера
  COMPORT = 6
  COMPORTPARAMS=baud=115200 parity=n data=8 stop=1 rts=on dtr=on
; Если в чеке иероглифы - попробовать поменять значение (0/1)
  ToOEM      = 1
  MaxLine    = 24
  PassWord   = 30
  SEPassword = 0
  MsgFile    = ShtrihM21.RUS.msg
  MsgSection = Errors 

Пример: ShtrihM21FZ54 (АТОЛ (онлайн 54ФЗ) 22Ф/ 55Ф (FPrint55k (ПТК))/ 77Ф (FPrint-77ПТК)) 

В настройках Абонемента нужно уснять флаг Пробивать нулевой чек. Приводит к появлению ошибок при открытии фискальной смены Access Violation ... in module "user32.dll".

Фискальный регистратор подключается в СОМ-порт или другой порт с эмуляцией серийного порта.

Настройки COM-порта можно узнать в настройках драйвера (можно взять с официального саита Атол, рекоммеднуемая версия не ниже 9.9.1), аналогично предыдущему примеру. Также необходимо перевести ФР в протокол АТОЛ 2.4. согласно инструкции.

Из поля "Найденные устройства" подставляем данные в Shelter.hw.ini:

[BOOT]
  atol54fz = sdmShtrihM21FZ54.dll

[hardware]
   FiscReg = SHTRIHM-FZ54

[FiscReg.SHTRIHM-FZ54]
; ФР АТОЛ (онлайн 54ФЗ) 22Ф, 55Ф, 77Ф.

; Версия. Обычно 22, Если не заводится - попробовать поставить 21  
  Version = 22
; Подставляем параметры из Теста Драйвера
  COMPORT = 6
  COMPORTPARAMS=baud=115200 parity=n data=8 stop=1 rts=on dtr=on
; Если в чеке иероглифы - попробовать поменять значение (0/1)
  ToOEM      = 1
  MaxLine    = 24
  PassWord   = 30
  SEPassword = 0
  MsgFile    = ShtrihM21.RUS.msg
  MsgSection = Errors 

; - через какое количества чеков вывести сообщение ОФД
;CountCheckForShowStatusOFD = 5
;- не будет выводится информация о непереданных чеках
;CountCheckForShowStatusOFD = 0

; Использовать таблицу кассиров для печати на чеках. (В тестовом режиме, к использованиюю не рекомендуется)
; Таблица кассиров настраивается самостоятельно, ограничение на кол-во кассиров 28
; Код кассира в Абонементе (к сожалению - пока логин) = пароль в таблице кассиров в ФР Атол
; isUseCasherPwdTable = 0
 

Пример: PRIM («Старт 200К»).

Аналогично предыдущему примеру, необходимо подключить ФР и с помощью прилагающегося драйвера узнать параметры подключения устройства, после чего изменить файл shelter.hw.ini. Обратите внимание, что в секциях [Boot] и [hardware] должна быть только одна строка, а остальные необходимо закомментировать. 

[BOOT]
  Prim= %exepath%\sdmAzimuth.dll

[hardware]
   FiscReg = AZIMUTH

[FiscReg.AZIMUTH]
  ; ФР Прим (ПРИМ-08ТК; СТАРТ 200К)
  ; Подставляем параметры подключения
  COMPORT = 1
  COMPORTPARAMS=baud=9600 parity=e data=8 stop=1
  
  ; Если в чеке иероглифы - попробовать поменять значение (0/1)
  ToOEM   = 0

  MsgFile    = Prim08TK.msg
  MsgSection = Errors

Переход на ФФД 1.0.5 с 01.01.2019 и НДС 20%

 

ФФД 1.0.5

 

В связи с переходом (01.01.2019г) на ФФД 1.05 в фискальных документах (чеках) появляются следующие новые реквизиты:

Для всего чека:

ИНН кассира (обязателен для определённых видов организаций);

Место расчёта (если не было указано при регистрации ККТ);

Для позиций чека:

Признак предмета расчёта

  • Товар
  • Услуга
  • Платёж
  • и т.д.

Признак способа расчёта

  • Полный расчёт – при передаче товара (оказании услуги)
  • Аванс – при отложенной передаче товара (оказании услуги), принятии платежа
  • и др.

Также, параллельно с окончанием работы ФФД 1.0, и, следовательно, переходом на ФФД 1.05 происходит переход ставки НДС с 18% на НДС 20%

 

Абонемент версии  ≤ 134

Абонемент может работать на версиях < 135 c фискальными регистраторами, использующими ФФД 1.05

Но не управляет указанными выше реквизитами. Данные реквизиты остаются в значениях по умолчанию:

ИНН кассира – не заполняется;

Место расчёта – заполняется при фискализации;

Для позиций чека:

Признак предмета расчёта – подставляется значение по умолчанию - ТОВАР;

Признак способа расчёта – подставляется значение по умолчанию – Полный расчёт.

 

Абонемент версии  ≥ 135

В Абонемент с версии 135 поддержана работа с новыми реквизитами, введёнными в ФФД 1.05 . То есть появляется возможность заполнения реквизитов «ИНН кассира», «Признак предмета расчёта», а также использование «Признак способа расчёта» согласно настройкам.

ИНН кассира – заполняется в карточке клиента кассира, передаётся на ФР;

Место расчёта – заполняется при фискализации, не передаётся из программы; (Т.к. часть фискальных регистраторов не позволяют оставить поле незаполненным при фискализации)

Для позиций чека:

Признак предмета расчёта – заполняется в карточке услуги в справочнике услуг, передаётся на ФР;

Признак способа расчёта – подставляется автоматически согласно проводимой операции, передаётся на ФР.

Для назначения ППР в карточке услуги разработан плагин, позволяющий устанавливать значения ППР для групп услуг

 

Плагин "Назначение ППР в справочнике услуг"

Для настройки плагина необходимо в файле .\exe\frf\frf.ini прописать:

  [PLUGINS_MAIN]
  plgSetOfdPPR=Установить ППР

Разместить файлы:

  .\exe\DLL\getDlgFromREP.dll

  .\exe\frf\plgSetOfdPPR.ini

  .\exe\frf\plgSetOfdPPR.fr3

 

Расположение плагина

Доп функции - > Плагины - >  Установить ППР (Рис. 1)

Рис. 1

 

Группы услуг - >  Выбрать группы услуг, для которых необходимо изменить значение ППР (Рис. 2)

Рис. 2

 

Значение ППР - > Из справочника выбрать необходимое значение Признака Предмета Расчёта (Рис. 3)

Рис. 3

 

Пример

Для Группы услуг «Бар» и подгруппы услуг «Расходные товары» необходимо установить значение ППР — Товар.

Выбираю необходимые группы услуг, значение параметра ППР - > Выполнить.

Для выбранных групп услуг значение параметра ППР изменяется

 

 

Переход на НДС 20%

 

ФР

Производители ФР Спарк, Штрих и Атол уже реализовали прошивки для автоматического изменения налоговой ставки при открытии первой смены 01.01.2019г.

Переход на новые значения ставки в ней реализован следующим образом: заранее в настройках ФР задается дата изменения налога (для Спарк 115-Ф, для  Атол и Штрих - предопределено 01.01.2019г). При открытии смены указанного числа ставка налога автоматически меняется.

Таким образом, дополнительных операций с перенастройкой ФР в Shelter / Абонемент делать не потребуется.

 

Абонемент

В связи с тем, что "Федеральным законом № 303-ФЗ не предусмотрено какого-либо переходного периода", 01.01.2019 для перехода на НДС 20% потребуется: 
1. Зайти в Настройки \ Справочники \ Налоги \ НДС. 
Изменить карточку налога: Код (при необходимости), Наименование (при необходимости), Ставка (обязательно).

Рис.4

Для Заказчиков, которые находятся на договоре технической поддержки, предусмотрено автоматическое изменение данных параметров. За настройкой Вы можете обратиться в отдел Технической поддержки.

Важно! Услуги реализуемые по абонементам с датой «начала действия» до 01.01.2019, начисляются по изначальной цене с измененной ставкой в пользу НДС на основании федерального закона "О внесении изменений в отдельные законодательные акты Российской Федерации о налогах и сборах" от 03.08.2018 №303-ФЗ

 

На данный момент реализовано следующее решение, для автоматической замены ставки НДС:

  • На БД применяется скрипт xx_vat_20.sql

В результате:

1. При появлении смены ночного аудита датированной 01.01.2019 проверяет наличие налога в справочнике с кодом «TAX18» и ставкой =18. 

2. В случае наличия такого налога:

2.1. Изменяется наименование налога на «НДС 20% (бывш. Наименоваине)»;

2.2. Изменяется величина ставки с «18%» на «20%».

2.3. Последующее начисление услуг со ссылкой на ставку «НДС 20% (бывш. Наименоваине)» происходит по величине «20%».

 

В случае, если требуется изменить ставку после 01.01.2019, а скрипт не был применён заранее

  • можно поправить справочник НДС в ручном режиме

ИЛИ

  • Применить по порядку xx_vat_20.sql и xx_late_vat_20.sql   Тогда, в момент применения xx_late_vat_20.sql произойдёт изменение справочника как указано выше для случая автоматического применения 01.01.2019

 

При тестировании 135 версии, ошибки в интерфейсе программы в связи с автоматической сменой ставки - не выявлены.

Результат тестирования отчётов: проверялись отчеты выделяющие сумму и ставку НДС.

1. Работают верно:

1.1. Отчет по реализации услуг за период. форма отчета ad_ServisePeriod.fr3

1.2. Отчет по реализации услуг за период. форма отчета ad_ServisePeriod2.fr3

1.3. Отчет по услугам

2. Работают верно после применения процедур (SPR_CHECK_PARSING_COMBOPAY.sql, SPR_PAYMENTS_INFO.sql)

2.1. Чеки кассовой смены

2.2. Куб. Чеки кассовой смены

2.3. Куб. Чеки кассовой смены. Детализация по платежам.

3.  Работают не верно

3.1. Отчет по реализации услуг за период.  Ставка рассчитывается в момент построения отчета. Данный отчет будет доработан.

 

 

Моменты, вызывающие вопросы:

Момент 1.

Оплатили бронь гостиницы/услугу/абонемент с НДС 18%, а потом оказалось необходимым вернуть предоплату, но уже в период действия НДС 20%

В ПО Shelter / Абонемент возврат будет произведён с фискальной налоговой ставкой 20%, поскольку ставка НДС 18% перестаёт существовать.

Момент 2.

Если оплата услуги будет производиться 2-мя частями – предоплата с НДС 18% и окончательный расчет при НДС 20%?

Если в ПО Shelter / Абонемент оказанная услуга уже начислена фолио со старым налогом (до 1.1.2019) и установлен параметр "использовать налоговую схему", (В большенстве случаев эта галочка не стоит. и поэтому ставка НДС в базе Абонемент не выделяется), а оплата этой оказанной услуги будет осуществляться в новом периоде (после 1.1.2019), то у данной услуги в программе Shelter / Абонемент расчет налога произойдет по старой налоговой ставке. А в фискальном чеке уже будет указан налог по новой ставке.

Для исключения такой возможности можно предложить 2 варианта решения:

1) не иметь неоплаченных услуг к 1.1. 2019

2) скриптом пересчитать сумму налога у неоплаченных услуг. Заказчики, находящиеся на договоре ТП смогут получить необходимые консультации в ТП Shelter / Абонемент.

 

ВложениеРазмер
20_vat.rar747 байтов

Универсальный драйвер ФР (УДФР) в Абонемент

 

 

Принятые сокращения

ФР -- фискальный регистратор.

УДФР -- универсальный драйвер фискального регистратора.

Введение

Универсальный драйвер фискального регистратора (ФР) позволяет использовать интерфейс взаимодействия Абонемент с драйверами ФР нижнего уровня поставляемыми R-keeper. Таким образом, позволяя объединить усилия и минимизировать количество ошибок, при разработке драйверов.

!!!ВАЖНО!!!
При подключении фискального регистратора необходимо использовать не urunpos.ini (fr.ini) из поставки, содержащий все возможные параметры, а основывать конфигурационный файл на приведенном примере для конкретного ФР.

Список поддерживаемых ФР аналогичен R-keeper 7.

 

На данный момент протестирована корректность работы следующих семейств ФР:

ФР АТОЛ54 работающие согласно 54 ФЗ

ФР АТОЛ не поддерживающие 54 ФЗ

ФР ШТРИХ поддерживающие 54 ФЗ

ФР ШТРИХ не поддерживающие 54 ФЗ

ФР СПАРК (115-Ф) поддерживающий 54 ФЗ

ФР ПРИМ (08-Ф) поддерживающий 54 ФЗ

ФР DATECS DP 25

 

Настройка

Для того, чтобы использовать универсальный драйвер ФР, необходимо:

1.      Подложить URunPos.dll (вер. не ниже 2.0.0.210)URunPos.ini и BarCodeGen.dll  в папку exe абонемента. (файлы можно найти в поставке Абонемент версии 134 и выше, по пути: *\_INTERFACE\POS\)

2.      В abonementmanager.ini прописать, в секции [Pos]:

RunPosDllName=URunPos.dll

3.      Скопировать соответствующие используемому ФР dll и init.xml (файл параметров драйвера) из _INTERFACE\POS\DRIVERS\RK_FiscReg

4.      В URunPos.ini внести в поля «DriverName»  и «ParamXMLFile» имена файла dll и параметров драйвера ФР.

5.      Настроить init.xml для подключённого ФР.

6.      Изменить остальные настройки URunPos.ini, если требуется.

 

Также с версии URunPos.dll 2.0.0.230 и выше поддержан следующий метод подключения:
Файл urunpos.ini содержит строки:

	[MERGE]
	fr=fr.ini
	fr2=fr2.ini

В таком случае, настройки УДФР описанные в статье прописываются в указанных fr.ini и fr2.ini.

При таком подключении фискальным регистратором по умолчанию будет являться первый незакомментированный параметр в секции [MERGE] urunpos.ini.

В случае использования нескольких ФР на одном рабочем месте, в соответствующий параметр киоска вносится fr или fr2, соответственно. (Названия парметров и файлов могут быть произвольными и приведены как пример)

 


ВАЖНО!
В Абонемент, каждое рабочее место, на котором регистрируются платежи должно быть настроено как отдельный киоск. Особенно в случае, если к данному рабочему месту подключён ФР.
 
В противном случае велика вероятность получить ошибку вида:
lock conflict on no wait transaction
deadlock
update conflicts with concurrent update
concurrent transaction number is 71234666
At procedure 'SP_BILL_CREATE' line: 101, col:41
 
Данная ошибка может возникать, в случае, если 2 или более рабочих места настроены на работу как один киоск Абонемент. В таком случае, при одновременном открытии чека на данных рабочих местах возникнет ошибка.

ВАЖНО!

При обновлении Абонемент на версию 130 и выше, необходимо также обновить и драйвера фискальных регистраторов на актуальные. Иначе, информационное уведомление о количествах и сроках неотправленных в ОФД документов, будет всегда выводиться с некорректными данными как на рисунке выше.


ВАЖНО!

"Ошибка ФР: Исчерпан ресурс хранения ФН" означает, что в ФН присутствуют фискальные документы не отправленные в ОФД более 30 суток. В связи с чем ФН не позволяет производить регистрацию новых фискальных документов. Требуется обеспечить связь ФР с ОФД. Работа с ФР будет разблокирована, после отправки данных документов.


 

Примеры настроек драйвера для различных ФР:

АТОЛ 54 ФЗ (22Ф, 77Ф, 55Ф, 25Ф, Fprint 22 ПТК, …)

Для работы с ФР АТОЛ, требуется чтобы следующие файлы были перенесены в папку ехе:

URunPos.dll (вер. не ниже 2.0.0.230)URunPos.ini, BarCodeGen.dll, fpAtol54.dll (вер. 7.13.81.0 и выше) и соответствующий init.xml

 

Также требуется перевести ФР в протокол АТОЛ 2.4. согласно инструкции.

 

Настройки файлов конфигурации:

URunPos.ini

[Main]
;Драйвер ФР R_keeper
DriverName = fpAtol54.dll
;ХМL настроек драйвера ФР R_keeper
ParamXMLFile = init.xml

;Номер документа (-1 = брать из ФР)
DocNumber =-1

;Текст заголовка
TextHeader =

;Код налога по умолчанию
TaxIndexDef = 4

;Корректировка номера последнего документа +- LastDocNumberAdjustment
LastDocNumberAdjustment = 0

;Добавлять скидки на каждую позицию
AddItemDiscount = 0

;Номер ящика (для Атол - должен быть = 1)
CashDrawerNumber = 1
;Открывать ящик после оплаты
OpenCashDrawerAfterEndFiscal = 1

;Пауза перед отправкой данных на печать (мс)
FRSleep = 10

;Показывать предупреждение если данные не отправлены в ОФД определённое количество дней
OFDWarningDays = 15

;Штриховой код, за секцию отвечает BarCodeGen.dll
[Barcode]
;ширина минимального элемента в точках для Type?QRCode
Width = 2
;высота в точках
Height = 100
;Тип = "EAN-13"|"Code-39"|"Code-128"|"QRCode"
Type = Code-39
;Позиция текста "No"|"Top"|"Bottom"|"Top&Bottom"
;для Type?QRCode
TextPosition = Bottom
;Уровень коррекции "7%"|"15%"|"25%"|"30%"
;необязательный, начиная с 12 версии, только для Type=QRCode
CorrectionLevel = 15%

init.xml

<xmlConfig>
  <parameters>  
    <loglevel>3</loglevel><!--Параметры логирования-->
    <logrotatesize>1</logrotatesize><!--Параметры логирования-->
    <logrotatecount>1</logrotatecount><!--Параметры логирования-->
    <logdestination>1</logdestination><!--Параметры логирования-->
    <msglanguage>ENG</msglanguage><!--Язык сообщений-->
    <portname>COM1</portname><!--Название COM-порта для подключения-->
    <portconfiguration>baud=9600</portconfiguration><!--Скорость сообщения по COM-порту-->
    <cashierpassword>28</cashierpassword><!--Пароль использумого кассира в ФР-->
    <adminpassword>29</adminpassword><!--Пароль администратора в ФР-->
    <sysadminpassw>30</sysadminpassw><!--Пароль сис.администратора в ФР-->
    <invertdraweropened>0</invertdraweropened><!--Инвертировать сигнал открытия денежного ящика-->
    <communicatpassw>0</communicatpassw><!--Пароль доступа ФР-->
    <usesectionas>Direct</usesectionas><!--Что использовать в качестве id налога-->
    <paperwidth>0</paperwidth><!--Ширина бумаги (в символах). 0 - запрашивать у ФР. Если печать идёт не на всю ширину, нужно задать жёстко (например 40 для широкой ленты)-->
    <ofdstatusunsendwarningtime>86400</ofdstatusunsendwarningtime><!--Время с первого неотправленного документа в ОФД до выведения предупреждающего сообщения (в секундах) (0 - никогда)-->
    <ofdstatusunsenderrortime>1296000</ofdstatusunsenderrortime><!--Время с первого неотправленного документа в ОФД до выведения сообщения об ошибке (в секундах) (0 - никогда)-->
  </parameters>
</xmlConfig>

 

В общем случае требуется только ввести данные для подключения к ФР:

    <portname>COM1</portname><!--Название COM-порта для подключения-->
    <portconfiguration>baud=9600</portconfiguration><!--Скорость сообщения по COM-порту-->

 

 

Примечание. Работа с налогами в ФР АТОЛ

Cм. соответствующую статью

 

Изменения в связи с ФФД 1.05

Для корректной работы с ФФД 1.05 и функционалом привнесённым в 135 версии Абонемент требуется:

Обновить URunPos.dll до версии 2.1.0.5, fpAtol54.dll до версии 7.47.162.0

На тестовом ФР Атол 22-Ф тип оплаты "Аванс (Предоплатой)" имел код 3, что соответствует значению по умолчанию:

CardSum2TypeIndex = 3

Поэтому изменений в настройках не требуется.

 

ШТРИХ 54 ФЗ ( Штрих М-02Ф, Ритейл 01Ф, РР-02Ф, «MSTAR-TK», …)

Для работы с ФР Штрих, требуется чтобы следующие файлы были перенесены в папку ехе:

URunPos.dll (вер. не ниже 2.0.0.230)URunPos.iniBarCodeGen.dll, fpShtr54.dll (вер. не ниже v.7.32.33.0) и соответствующий init.xml

 

В последнее время, после обновления ФР семейства ШТРИХ-М, стала часто встречаться ошибка вида (в логах драйвера нижнего уровня fpShtr54.dll):

[ERR] FR error: Ошибка 09h: ФП - Некорректная длина команды

Появление указанной ошибки в логе работы драйвера нижнего уровня сигнализирует о наличии несовместимости версии ФН и используемой СНО.

По данным вопросам заказчикам необходимо обращаться в ЦТОс которым у них заключен договор для выявления причины установки несовместимой версии ФН.

 

Настройки файлов конфигурации:

 

URunPos.ini

[Main]
;Драйвер ФР R_keeper
DriverName = fpShtr54.dll
;ХМL настроек драйвера ФР R_keeper
ParamXMLFile = init.xml

;Номер документа (-1 = брать из ФР)
DocNumber =-1

;Текст заголовка
TextHeader =

;Код налога по умолчанию
TaxIndexDef = 4

;Корректировка номера последнего документа +- LastDocNumberAdjustment
LastDocNumberAdjustment = 0

;Добавлять скидки на каждую позицию
AddItemDiscount = 0

;Номер ящика (для Штрих - должен быть = 0)
CashDrawerNumber = 0
;Открывать ящик после оплаты
OpenCashDrawerAfterEndFiscal = 1

;Пауза перед отправкой данных на печать (мс) для штрихов до 54 ФЗ
;(иначе неправильно происходит печать нефискальных документов --
;особенность драйвера нижнего уровня)
FRSleep = 100

;Показывать предупреждение если данные не отправлены в ОФД определённое количество дней
OFDWarningDays = 15

; Оплата - АВАНС = 14
CardSum2TypeIndex = 14

;Штриховой код, за секцию отвечает BarCodeGen.dll
[Barcode]
;ширина минимального элемента в точках для Type?QRCode
Width = 2
;высота в точках
Height = 100
;Тип = "EAN-13"|"Code-39"|"Code-128"|"QRCode"
Type = Code-39
;Позиция текста "No"|"Top"|"Bottom"|"Top&Bottom"
;для Type?QRCode
TextPosition = Bottom
;Уровень коррекции "7%"|"15%"|"25%"|"30%"
;необязательный, начиная с 12 версии, только для Type=QRCode
CorrectionLevel = 15%

 

 

ВАЖНО

Для ФР Штрих обязательно необходимо установить параметр:


;Код налога по умолчанию
TaxIndexDef = 4 (либо "2","3","4", но не "0" - значение вне диапазона)

Иначе, в случае, если код налога для услуги или платежа оставлен в значении по умолчанию =0, возникнет ошибка ФР, мешающая работе в программе;

Не касается кассовой секции.

 

init.xml

<xmlConfig>
    <Parameters>
        <LogLevel>3</LogLevel><!--Параметры логирования-->
        <LogRotateSize>1</LogRotateSize><!--Параметры логирования-->
        <LogRotateCount>1</LogRotateCount><!--Параметры логирования-->
        <MsgLanguage>RUS</MsgLanguage><!--Язык сообщений ФР-->
        <Protocol>0</Protocol><!--Используемый протокол: 0 = old (стандартный), 1 = alternative (протокол ККТ 2.0)-->  
       <PhysicLayer>0</PhysicLayer><!--Communivate via COM port = 0, Communivate via TCP/IP (Ethernet / WiFi) = 1-->  
       <COMnum>1</COMnum><!--Номер СОМ-порта, в случае работы по СОМ-порту-->  
       <COMbaud>115200</COMbaud><!--Скорость СОМ, в случае работы по СОМ-порту--->  
       <TCPaddress>192.168.1.100</TCPaddress><!--Адрес ФР, в случае работы по ТСР-->  
       <TCPport>12345</TCPport><!--Порт для связи с ФР, в случае работы по ТСР-->  
       <PasswOperat>1</PasswOperat><!--Пароль для действий кассира-->  
       <PasswAdmin>30</PasswAdmin><!--Пароль для действий администратора-->  
       <PassBefCut>5</PassBefCut><!--Количество пустых строк перед отрезкой-->  
       <DoubleWFont>4</DoubleWFont><!--Параметры шрифтов-->  
       <DoubleHFont>1</DoubleHFont><!--Параметры шрифтов-->  
       <LineLength>40</LineLength><!--Длина строки для нефискальной информации-->  
       <BoldLineLength>0</BoldLineLength><!--Длина строки полужирным шрифтом для нефискальной информации (в Абонемент не используется)-->  
       <OFDStatusUnsendWarningTime>86400</OFDStatusUnsendWarningTime><!--Время с первого неотправленного документа в ОФД до выведения предупреждающего сообщения (в секундах) (0 - никогда)-->  
       <OFDStatusUnsendErrorTime>1296000</OFDStatusUnsendErrorTime><!--Время с первого неотправленного документа в ОФД до выведения сообщения об ошибке (в секундах) (0 - никогда)-->  
   </Parameters>
</xmlConfig>

 

Примечание. Работа с налогами в ФР ШТРИХ

Для ФР ШТРИХ поддержана произвольная установка налога для услуги независимо от секции. (Подробнее про коды налогов см. соответствующую статью)

Т.е. обе настройки: "Код налога ФР" и "Кассовая секция" независимы и имеют силу для любой услуги и платежа.

 

Изменения в связи с ФФД 1.05

Для корректной работы с ФФД 1.05 и функционалом привнесённым в 135 версии Абонемент требуется:

Обновить URunPos.dll до версии 2.1.0.5, fpShtr54.dll до версии 7.47.86.0

На тестовом ФР Ритейл-01Ф тип оплаты "Аванс (Предоплатой)" имел код 14, что не соответствует значению по умолчанию.

Соответственно, в fr.ini в секции [Main] необходимо прописать:

CardSum2TypeIndex = 14

 

 

ККТ Спарк 115-Ф

Для работы с ФР Спарк 115-Ф, требуется чтобы следующие файлы были перенесены в папку ехе:

URunPos.dll (вер. не ниже 2.0.0.230)URunPos.iniBarCodeGen.dll, fpSpark54.dll  и соответствующий init.xml

Помимо этого, на компьютере должна быть настроена и запушена утилита SparkSrv. (Данная утилита позволяет по одному интерфейсу отправлять данные в ОФД из ФР и общаться с ФР из ПО).

Настройки файлов конфигурации:

 

URunPos.ini

[Main]
;Драйвер ФР R_keeper
DriverName = fpSpark54.dll
;ХМL настроек драйвера ФР R_keeper
ParamXMLFile = init.xml

;Номер документа, -1 - брать из ФР
DocNumber = -1

;Текст заголовка чека (!!! оставить пустым для СПАРК)
TextHeader =
;Печатать логотип в чеке (!!! не печатать для СПАРК - возникает ошибка при попытке печати чека возврата прихода "Нев. команда регистрации аннулирования [200]")
IsPrintLogo=0

;Код налога по умолчанию
TaxIndexDef = 0
;Коды налогов
;0 = НДС НЕ ОБЛ.
;1 = НДС 18/118
;2 = НДС 10/110
;3 = НДС 0
;4 = НДС 18 - не работает с Абонемент
;5 = НДС 10 - не работает с Абонемент

;Добавлять скидки на каждую позицию
AddItemDiscount = 0

;Номер ящика
CashDrawerNumber = 0
;Открывать ящик после оплаты
OpenCashDrawerAfterEndFiscal = 1

;Показывать предупреждение если данные не отправлены в ОФД определённое количество дней
OFDWarningDays = 15

;Коды типов оплат:
;Оплата =8 - наличные
CashSumTypeIndex = 8
;Оплата =1 Электронные
CardSum1TypeIndex = 1
;Оплата =5 АВАНС
CardSum2TypeIndex = 5

;Оплата =7 - "запрещено"

;Пауза перед отправкой данных на печать (мс) для штрихов до 54 ФЗ
FRSleep = 10

;Штриховой код, за секцию отвечает BarCodeGen.dll
[Barcode]
;ширина минимального элемента в точках для Type?QRCode
Width = 2
;высота в точках
Height = 100
;Тип = "EAN-13"|"Code-39"|"Code-128"|"QRCode"
Type = Code-39
;Позиция текста "No"|"Top"|"Bottom"|"Top&Bottom"
;для Type?QRCode
TextPosition = Bottom
;Уровень коррекции "7%"|"15%"|"25%"|"30%"
;необязательный, начиная с 12 версии, только для Type=QRCode
CorrectionLevel = 15%

 

ВАЖНО

Обратите внимание на следующее:

;Код налога по умолчанию
TaxIndexDef = 0

;Коды налогов
;0 = НДС НЕ ОБЛ.
;1 = НДС 18/118
;2 = НДС 10/110
;3 = НДС 0
;4 = НДС 18 - не работает с Абонемент
;5 = НДС 10 - не работает с Абонемент

В случае ФР Спарк 115-Ф, на котором производилось тестирование, налоги были установлены указанным образом. Необходимо это учитывать, при заполнении карточек услуг и платежей.

Также необходимо обратить внимание на следующее:

;Коды типов оплат:
;Оплата =8 Наличные
;Оплата =1 Электронные
;Оплата =2 карта-2
;Оплата =3 карта-3
;Оплата =4 карта-4
;Оплата =5 ТАР
;Оплата =6 ЧЕК
;Оплата =7 - "запрещено"

На тестируемом ФР код платежа «Наличные» был равен 8, соответственно, а «Электронные» равный 1. В таком случае, необходимо установить:

CashSumTypeIndex = 8
CardSum1TypeIndex = 1

init.xml

<?xml version="1.0" encoding="utf-8"?>  
<xmlConfig>  
  <Parameters>  
    <LogLevel>5</LogLevel><!--Параметры логирования-->  
    <LogRotateSize>1</LogRotateSize><!--Параметры логирования-->  
    <LogRotateCount>5</LogRotateCount><!--Параметры логирования-->  
    <MsgLanguage>ENG</MsgLanguage><!—Язык сообщений ФР-->  
    <PasswKKT>111111</PasswKKT><!—Пароль доступа ФР-->  
    <PasswCachier>11111</PasswCachier><!—Пароль кассира-->  
    <TCPaddress>127.0.0.1</TCPaddress><!—Сетевой адрес, на котором запущена SparkServ -->  
    <TCPport>7200</TCPport><!—Порт на котором запущена SparkServ-->  
    <PhysicalLayer>TCP</PhysicalLayer><!—Параметр не имеет силы-->  
    <COMnum>9</COMnum><!—Параметр не имеет силы-->  
    <COMspeed>57600</COMspeed><!—Параметр не имеет силы-->  
    <OFDStatusUnsendWarningTime>0</OFDStatusUnsendWarningTime><!--Время с первого неотправленного документа в ОФД до выведения предупреждающего сообщения (в секундах) (0 - никогда)-->  
    <OFDStatusUnsendErrorTime>2592000</OFDStatusUnsendErrorTime><!--Время с первого неотправленного документа в ОФД до выведения сообщения об ошибке (в секундах) (0 - никогда)-->  
  </Parameters>  
</xmlConfig>  
 

Примечание. Работа с налогами и секциями в ФР СПАРК

ФР Спарк 115-Ф позволяет установку произвольного налога для каждой позиции чека. (Подробнее про коды налогов см. соответствующую статью)

Кассовые секции не используются.

Примечание. Работа на одном ФР СПАРК  с нескольких рабочих мест

За счёт использования утилиты SparkSrv появляется возможность использовать один ФР Спарк с другого рабочего места, путём подключения к утилите по соответствующему адресу и порту.

Примечание. ФР СПАРК и нулевой чек

ФР СПАРК не позволяет пробитие нулевого чека. Необходимо отключить пробитие нулевого чека на всех киосках, к которым подключаются ФР СПАРК.

ВАЖНО

В ФР СПАРК ошибка "Ошибка ФР 54: Запрещено по программируемому флагу №5" означает, что флаг доступных к возврату типов платежей для данного платежа снят.

 

Изменения в связи с ФФД 1.05

Для корректной работы с ФФД 1.05 и функционалом привнесённым в 135 версии Абонемент требуется:

Обновить URunPos.dll до версии 2.1.0.5, fpSpark54.dll до версии 7.46.42.0

На тестовом ФР СПАРК 115-Ф тип оплаты "Аванс (Предоплатой)" имел код 5, что не соответствует значению по умолчанию.

Соответственно, в fr.ini в секции [Main] необходимо прописать:

CardSum2TypeIndex = 5

 

ККТ ПРИМ 08-Ф

Корректная работа ФР ПРИМ 08-Ф с Абонемент протестирована на версии Абонемент 1.129, и версии URunPos.dll (2.0.0.230).

Для работы с ФР ПРИМ 08-Ф, требуется чтобы следующие файлы были перенесены в папку ехе:
URunPos.dll (вер. не ниже 2.0.0.230), URunPos.ini, BarCodeGen.dll, fpRUS_PRIM08F.dll (вер. не ниже v.7.33.21.0)  и соответствующий init.xml и fr.ini (согласно новому способу подключения)
Настройки файлов конфигурации:

 

prim.ini  (бывший urunpos.ini)

[Main]
;Драйвер ФР R_keeper
DriverName = fpRUS_PRIM08F.dll
;ХМL настроек драйвера ФР R_keeper
ParamXMLFile = init.xml

;Номер документа (-1 = брать из ФР)
DocNumber = -1

;Текст заголовка чека
TextHeader =
;Код налога по умолчанию
TaxIndexDef = 0
;Коды налогов
;0 = Без НДС
;1 = НДС 0%
;2 = НДС 10/110%
;3 = НДС 18/118%
;4 = НДС 10%
;5 = НДС 18%

;Добавлять скидки на каждую позицию
AddItemDiscount = 0

;Показывать предупреждение если данные не отправлены в ОФД определённое количество дней
OFDWarningDays = 15

;Коды типов оплат:
;Оплата =0 - наличные
CashSumTypeIndex = 0
;Оплата =1 Электронные
CardSum1TypeIndex = 1

;Пауза перед отправкой данных на печать (мс) для штрихов до 54 ФЗ
FRSleep = 10

;Штриховой код, за секцию отвечает BarCodeGen.dll
[Barcode]
;ширина минимального элемента в точках для Type?QRCode
Width = 2
;высота в точках
Height = 100
;Тип = "EAN-13"|"Code-39"|"Code-128"|"QRCode"
Type = Code-39
;Позиция текста "No"|"Top"|"Bottom"|"Top&Bottom"
;для Type?QRCode
TextPosition = Bottom
;Уровень коррекции "7%"|"15%"|"25%"|"30%"
;необязательный, начиная с 12 версии, только для Type=QRCode
CorrectionLevel = 15%

ВАЖНО

Обратите внимание на следующие отрывки:

;Код налога по умолчанию
TaxIndexDef = 0
;Коды налогов
;0 = Без НДС
;1 = НДС 0%
;2 = НДС 10/110%
;3 = НДС 18/118%
;4 = НДС 10%
;5 = НДС 18%

В случае ФР ПРИМ 08-Ф, на котором производилось тестирование, налоги были установлены указанным образом. Необходимо это учитывать, при заполнении карточек услуг и платежей.

Также необходимо обратить внимание на следующий отрывок:

;Коды типов оплат:
;Оплата =0 - наличные
CashSumTypeIndex = 0
;Оплата =1 Электронные
CardSum1TypeIndex = 1

На тестируемом ФР код платежа «Наличные» был равен 0, а код платежа «Электронные» был равным 1. В таком случае, для корректной работы, необходимо установить CashSumTypeIndex и CardSum1TypeIndex как указано.

 

init.xml

<DriverParameters>
 <Parameter Name="LogLevel" IntegerValue="5" Desctiption="Log level: 0 - error only, ..., 5 - all"/>
 <Parameter Name="MsgLanguage" StringValue="RUS" Desctiption="Language of messages, the string matches with the extension of the localisation file, for example: ENG, RUS etc"/>
 
 <Parameter Name="COMnum" IntegerValue="1" Desctiption="COM-port number, 1..255" />
 <Parameter Name="BaudRate" IntegerValue="9600" Desctiption="COMport baudrate: 9600, 19200, 38400, 57600 or 115200"/>
 
 <Parameter Name="Password" StringValue="AERF" Desctiption="Password for sending" />
 <Parameter Name="DrawerInv" IntegerValue="0" Desctiption="Is inverted signal from drawer opened state: 0 - No, 1 - Yes" />
 
 <Parameter Name="OFDunSendErr" IntegerValue="86400" Desctiption="OFD unsending hours for error, 0 - not implemented" />
 <Parameter Name="OFDunSendWrn" IntegerValue="0" Desctiption="OFD unsending hours for warning, 0 - not implemented" />
 
 <UseFnSerial>0</UseFnSerial>
</DriverParameters>

 

Примечание. Работа с налогами и секциями в ФР ПРИМ

ФР ПРИМ 08-Ф позволяет установку произвольного налога для каждой позиции чека. (Подробнее про коды налогов см. соответствующую статью)
Кассовые секции не используются.

 

Примечание. ФР ПРИМ и нулевой чек

ФР ПРИМ не позволяет пробитие нулевого чека. Необходимо отключить пробитие нулевого чека на всех киосках, к которым подключаются ФР ПРИМ.

 

 

DATECS DP 25

Для работы с ФР Datecs DP 25, требуется чтобы следующие файлы были перенесены в папку ехе:

URunPos.dll (вер. не ниже 2.0.0.184)URunPos.iniBarCodeGen.dll, fpROU_DP25.dll и соответствующий init.xml

Настройки файлов конфигурации:

URunPos.ini

[Main]
;Драйвер ФР R_keeper
DriverName = fpROU_DP25.dll
;ХМL настроек драйвера ФР R_keeper
ParamXMLFile = init.xml
;ИНН
INN = 1234567890
;Номер документа
DocNumber = 1
;Имя продавца
Seller = Seller
;Код объекта
ObjCode = 0
;Название объекта
ObjName = Abonement
;ID оператора (кассира)
OperatorId = 0
;Код оператора (кассира)
OperatorCode = 0
;Имя оператора (кассира)
OperatorName = Abonement
;ID станции (кассы)
StationId = 0
;Код станции (кассы)
StationCode = 0
;Название станции (кассы)
StationName = Abonement
;Текст заголовка
TextHeader = 
;Код налога по умолчанию
TaxIndexDef = 0
;Пауза перед отправкой данных на печать (мс)
FRSleep = 10
;Тип оплаты
CashSumText = Cash
CardSum1Text = Card
CardSum2Text = Card_2
CardSum3Text = Card_3
CardSum4Text = Card_4
;Коды типов оплат:
;Оплата наличными
CashSumTypeIndex = 0
;Оплата картой 1
CardSum1TypeIndex = 1
;Оплата картой 2
CardSum2TypeIndex = 2
;Оплата картой 3
CardSum3TypeIndex = 3
;Оплата картой 4
CardSum4TypeIndex = 4

;Штриховой код
[Barcode]
;ширина минимального элемента в точках для Type?QRCode
Width = 2
;высота в точках
Height = 100
;Тип = "EAN-13"|"Code-39"|"Code-128"|"QRCode"
Type = Code-39
;Позиция текста "No"|"Top"|"Bottom"|"Top&Bottom"
;для Type?QRCode
TextPosition = Bottom
;Уровень коррекции "7%"|"15%"|"25%"|"30%"
;необязательный, начиная с 12 версии, только для Type=QRCode
CorrectionLevel = 15%

 

ВАЖНО

Для ФР Datecs обязательно необходимо установить параметр:

;Код налога по умолчанию
TaxIndexDef = 0

Так как в ФР код первого налога  = 0;

Также необходимо присутствие следующей секции:

;Коды типов оплат:
;Оплата наличными
CashSumTypeIndex = 0
;Оплата картой 1
CardSum1TypeIndex = 1
;Оплата картой 2
CardSum2TypeIndex = 2
;Оплата картой 3
CardSum3TypeIndex = 3
;Оплата картой 4
CardSum4TypeIndex = 4

Поскольку коды типов оплат в ФР Datecs также как и коды налогов начинаются с  =0.

Также стоит установить следующие параметры (передаваемые названия типов оплаты):

;Тип оплаты
CashSumText = Cash
CardSum1Text = Card
…

Иначе передаются значения по умолчанию в неподдерживаемой аппаратом кириллице.

init.xml

<DriverParameters>  
    <Parameter Name="LogLevel" IntegerValue="5" Desctiption="Log level: 0 - error only, ..., 5 - all"/><!--Параметры логирования-->  
    <Parameter Name="MsgLanguage" StringValue="ENG" Desctiption="Language of messages, the string matches with the extension of the localisation file, for example: ENG, RUS etc"/><!—Язык сообщений ФР-->  
    <Parameter Name="COMnum" IntegerValue="11" Desctiption="COM-port number, 1..255" /><!--Номер СОМ-порта -->  
    <Parameter Name="BaudRate" IntegerValue="0" Desctiption="COMport baudrate: 0 - auto, 1200, 2400, 4800, 9600, 19200, 38400, 57600 or 115200"/><!—Скорость сообщения по СОМ-порту -->  
    <Parameter Name="OperCode" IntegerValue="1" Desctiption="Operator code: 1..16" /><!--Код кассира-->  
    <Parameter Name="OperPassword" StringValue="1" Desctiption="Operator password" /><!--Пароль кассира-->  
</DriverParameters>  

 

Примечание

Тестирование ФР Datecs DP 25 производилось сотрудником дилеров - Bogdan Romascu из «UCS-Romania».

 

TO DO: Больше примеров

 

Работа УДФР с денежными ящиками

С версии 2.0.0.201 urunpos.dll доступны параметры в urunpos.ini: CashDrawerNumber = 0 - Номер денежного ящика (как правило, 0 - ящик по умолчанию), OpenCashDrawerAfterEndFiscal = 1 - открывать ящик по команде из Абонемент (1 - открывать всегда, 0 - открывать только по кнопке "Открыть денежный ящик").

Работает независимо от версии Абонемента: открытие ящика при оплате наличными, при снятии Х и Z-отчёта.

С версии Абонемента 128 доступна кнопка в ночном аудите, для открытия денежного ящика по запросу - "Открыть денежный ящик".

 

Работа УДФР с передачей пользователя Абонемент в качестве кассира в чек

С версии 128 Абонемента поддержана передача пользователя Абонемент в качестве кассира в фискальный документ для всех доступных кассовых операций.

 

Работа с двумя и более фискальными регистраторами, подключёнными к 1 рабочему месту

Для работы с двумя ФР на 1 рабочем месте, требуется:

Наличие в папке ехе Абонемента файлов: URunPos.dll, URunPos.ini и BarCodeGen.dll, а также dll соответствующих подключённым ФР.

Настройки универсального драйвера для каждого ФР задаются в отдельных ini файлах (например: atol1.ini и shtrih2.ini), аналогичным настройкам приведённым в данной статье.

В URunPos.ini  в таком случае, будет иметь следуюющее содержание:

[MERGE]
atol=atol1.ini
shtrih=shtrih2.ini

Соответственно в atol1.ini и в shtrih2.ini , как минимум параметры ParamXMLFile  должны различаться, т.е. необходимо наличие 2 файлов (например init_1.xml и init_2.xml), где будут указаны настройки соединения с конкретными ФР.

В настройках соответствующих киосков в настройках в Абонементе необходимо в поле «название устройства в ini файле» прописать названия параметров прописанных в urunpos.ini (В данном примере это - atol и shtrih)

 

Работа с одним фискальным регистратором на нескольких рабочих местах

 

Решение для работы с нескольких рабочих мест Абонемент на 1 ФР, поддерживаемом универсальным драйвером, описано  в отдельной статье.

 

Также, способ подключения ФР Спарк 115-Ф позволяет использовать 1 ФР на нескольких рабочих местах, без использования вышеобозначенного решения. (См. раздел СПАРК 115-Ф)

 

Печать логотипа в фискальных и нефискальных документах

С версии URunPos.dll  2.0.1.17 поддержана принудительная печать логотипа в фискальных и нефискальных документах распечатываемых из Абонемент.

Для этого требуется загрузить изображение в память ФР. 

Прописать следующие параметры в секции [Main] файла конфигурации (fr.ini):

[Main]
; Печатать логотип в фискальных документах
IsPrintLogo = 1
; Печатать логотип в нефискальных документах
IsUnfiscalPrintLogo = 1
; Идентификатор логотипа в ФР
LogoName = 1

Применимость к фискальным регистраторам:

Спарк 115-Ф - Не применимо. Графика загружается только в клише ФР и печатается для всех документов независимо от команды.

Атол (22-Ф) - изображение загружается через утилиту теста драйвера в меню программирование. Указываемое в ini файле LogoName = ID картинки в тесте драйвера -1.

Штрих 54ФЗ (Ритейл-01Ф) - изображение загружается через тест драйвера. Указываемое в ini файле LogoName = <номер первой строки для печати>-<номер последней строки для печати> (Например "LogoName = 1-200" - напечатать первые 200 строк изображения загруженного в фр).

С другими семействами ФР не тестировалось.

 

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

Если ФР подключён через универсальный драйвер, то:

Помимо проверки shelter.hw.ini на незакомментированность соответствующих виртуальному фискальнику строк,

также требуется закомментировать строку

RunPosDllName=URunPos.dll

В секции [Pos] в abonementmanager.ini

 

В случае универсального драйвера в shelter.hw.ini изменения вносится вообще не должны.

Т.е. в идеальном случае, на новых объектах изначально работающих на универсальном драйвере будет достаточно править 1 строку в abonementmanager.ini.

 

Тестирование драйвера ФР

После установки и настройки необходимо протестировать работу драйвера.

План тестирования: 

  1. Изъятие (с копейками и без). 
  2. Печать штрихового кода. 
  3. Z-отчет. 
  4. Возврат (с копейками и без). 
  5. Продажа, используя безналичную оплату (с копейками и без) (печать слипа в двух копиях) интеграция со Сбербанком (в качестве названий услуг/товаров использовать еще и символы: ",',<,>/,\) (продажа со скидкой и без: AddItemDiscount = 1/0) (с отправкой чека по e-mail и СМС и без). 
  6. Закрытие смены. 
  7. Открытие смены. 
  8. Печать нулевого чека. 
  9. Продажа, используя наличную оплату (с копейками и без, со сдачей и без) (в качестве названий услуг/товаров использовать еще и символы: ",',<,>/,\) (продажа со скидкой и без: AddItemDiscount = 1/0) (с отправкой чека по e-mail и СМС и без). 
  10. Продажа, используя комбинированную оплату (с копейками и без) (в качестве названий услуг/товаров использовать еще и символы: ",',<,>/,\) (продажа со скидкой и без: AddItemDiscount = 1/0) (с отправкой чека по e-mail и СМС и без). 
  11. Х-отчет. 
  12. Печать текстовой информации (использовать еще и символы: ",',<,>/,\). 
  13. Внесение (с копейками и без). 
  14. Печать на разных ФР. (Если к 1 рабочему месту подключены 2 или более ФР). 

CloudKassir (CloudPayments)

 

Зачем

В связи с ФЗ 54 при использовании онлайн модулей и мобильных приложений возникает законный вопрос - как быть с онлайн платежами? Кто и как должен формировать фискальный чек? Как предоставить чек покупателю?

Для онлайн модулей, процессинговые системы предлагают производить фискализацию их силами (передача содержимого чека поддержана в Абонемент Онлайн для Робокассы), но это не всегда удобно.

Для онлайн приложений, не все процессинговые системы предлагают фискализацию.

Для подобных случаев были созданы различные предложения для облачной фискализации - когда фискальный регистратор находится в датацентре и работает через веб-интерфейс 24/7 на различных заказчиков. Такие как Атол-Онлайн и CloudKassir (CloudPayments).

 

Как

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

Рис.1 Схема работы при интеграции с облачным решением для фискализации

То есть, при проведении платежа через Абонемент Онлайн/мобильное приложение, платёж проводится в два этапа:

1. Мобильное приложение/Абонемент Онлайн перенаправляет клиента в процессинг, где он производит платёж, информация о платеже возвращается в модуль.

2. Модуль отправляет запрос на регистрацию платежа в Абонемент через API (Connecter). Для завершения регистрации платежа, API запросит формирование чека для данной операции у облачного ФР. Только после успешной фискализации платёж (чек) будет зарегистрирован в Абонемент.

 

Версии используемые при тестировании 

  • Абонемент  - 1.136
  • Connecter -  1.66.0.39
  • URunPos.dll - 2.2.0.4
  • fpCloudPayments.dll - 1.4.0.4

 

Как настраивается

//here lies copy paste from URunPos node

Данное решение настраивается через универсальный драйвер.

Для этого в connecter.ini необходимо в секцию [pos] добавить строку:

RunPosDllName=Urunpos.dll

 

Следующие файлы должны быть в папке с Connecter:

URunPos.dll (вер. не ниже 2.2.0.4), URunPos.ini, fpCloudPayments.dll (вер. не ниже v.1.4.0.4) и urunpos_frxml_CloudPayments.xml

 

Настройки файлов конфигурации:

URunPos.ini (fr.ini или urunpos_CloudPayments.ini) 

[Main]
;Драйвер ФР R_keeper
DriverName = fpCloudPayments.dll
;ХМL настроек драйвера ФР R_keeper
ParamXMLFile = urunpos_frxml_CloudPayments.xml

;Код налога по умолчанию 
TaxIndexDef=6 
;Налоги передаваемые в чек 
;Налог с кодом 1 
RateValue1 =0 
;Налог с кодом 2 
RateValue2 =1000 
;Налог с кодом 3 
RateValue3 =2000 
;Налог с кодом 4 
RateValue4 =11000 
;Налог с кодом 5 
RateValue5 =12000 
;Налог с кодом 6 
RateValue6 =-1 

DocNumber = -1

Где ставки налогов могут принимать предопределённые значения из следующего списка:

RateValue= Передаваемый налог
0 НДС 0%
1000 НДС 10%
2000 НДС 20%
11000 НДС 10/110%
12000 НДС 20/120%
-1 Без НДС

 

Данная гибкость настройки позволяет настроить для онлайн фискализатора ставки налогов так же, как и в реальных фискальных регистраторах, используемых на объекте. Например, в приведённом выше примере ini файла, налоги установлены так же, как и в фискальных регистраторах Атол. Подробнее про работу универсального драйвера с налоговыми ставками можно узнать в статье.

 

init.xml

<xmlConfig ProtocolVersion="46">
   <Parameters>
                <Company_INN>5544338819</Company_INN><!--ИНН компании, предоставленный в CloudKassir-->
                <API_URL>https://api.cloudpayments.ru/kkt/</API_URL><!--Адрес API CloudKassir-->
                <API_Login>pk_5acd6950f73ffe9d9f41eb6ad6fca</API_Login><!--API логин-->
                <API_Password>ohJnB2JNBgUwgNq7q0BOdA44Brbp7hQn07isSCfiYk8=</API_Password><!--Зашифрованный пароль API (заполняется автоматически)-->
                <DurationWaitProcessed>300</DurationWaitProcessed><!--Время ожидания подтверждения фискализации после успешного принятия команды CloudKassir`ом (в секундах)-->
                <NewPassword>exDDtrop4</NewPassword><!--Установить новый пароль (автоматически зашифруется при запуске connecter)-->
   </Parameters>
</xmlConfig>

 

Все данные заполняемые в xml могут быть получены в CloudKassir (CloudPayments).

Регистрация чека, в зависимости от нагруженности могут варьироваться от 1-2 секунд до 2-3 минут, в связи с чем значение параметра DurationWaitProcessed рекомендуется устанавливать не менее 300.

 

ВАЖНО!!!

Для решений облачной фискализации наличие email или телефона клиента в чеке является обязательным, соответственно, должны быть установлены параметры "Общие параметры" - "Услуги и платежи" - "ФР может отправлять чеки на Email / через SMS". Соответствуюющие поля клиента должны быть заполнены.

 

Лицензирование

Интеграция защищёна лицензионным ключом Проект 1 модуль 8. Подробнее про лицензирование

Атол-Онлайн

 

 

Зачем

В связи с ФЗ 54 при использовании онлайн модулей и мобильных приложений возникает законный вопрос - как быть с онлайн платежами? Кто и как должен формировать фискальный чек? Как предоставить чек покупателю?

Для онлайн модулей, процессинговые системы предлагают производить фискализацию их силами (передача содержимого чека поддержана в Абонемент Онлайн для Робокассы), но это не всегда удобно.

Для онлайн приложений, не все процессинговые системы предлагают фискализацию.

Для подобных случаев были созданы различные предложения для облачной фискализации - когда фискальный регистратор находится в датацентре и работает через веб-интерфейс 24/7 на различных заказчиков. Такие как Атол-Онлайн и CloudKassir.

 

Как

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

Рис.1 Схема работы при интеграции с облачным решением для фискализации

То есть, при проведении платежа через Абонемент Онлайн/мобильное приложение, платёж проводится в два этапа:

1. Мобильное приложение/Абонемент Онлайн перенаправляет клиента в процессинг, где он производит платёж, информация о платеже возвращается в модуль.

2. Модуль отправляет запрос на регистрацию платежа в Абонемент через API (Connecter). Для завершения регистрации платежа, API запросит формирование чека для данной операции у облачного ФР. Только после успешной фискализации платёж (чек) будет зарегистрирован в Абонемент.

 

Версии используемые при тестировании 

  • Абонемент  - 1.136
  • Connecter -  1.66.0.39
  • URunPos.dll - 2.2.0.4
  • fpCloudAtol.dll - 1.3.0.10

 

Как настраивается

//here lies copy paste from URunPos node

Данное решение настраивается через универсальный драйвер.

Для этого в connecter.ini необходимо в секцию [pos] добавить строку:

RunPosDllName=Urunpos.dll

 

Следующие файлы должны быть в папке с Connecter:

URunPos.dll (вер. не ниже 2.2.0.4)URunPos.inifpCloudAtol.dll (вер. не ниже v.1.3.0.10) и urunpos_frxml_CloudAtol.xml

 

Настройки файлов конфигурации:

URunPos.ini (fr.ini или urunpos_CloudAtol.ini) 

[Main]
;Драйвер ФР R_keeper
DriverName = fpCloudAtol.dll
;ХМL настроек драйвера ФР R_keeper
ParamXMLFile = urunpos_frxml_CloudAtol.xml

;Код налога по умолчанию
TaxIndexDef=6

;Налоги передаваемые в чек
;Налог с кодом 1
RateValue1 =0
;Налог с кодом 2
RateValue2 =1000
;Налог с кодом 3
RateValue3 =2000
;Налог с кодом 4
RateValue4 =11000
;Налог с кодом 5
RateValue5 =12000
;Налог с кодом 6
RateValue6 =-1

DocNumber = -1

Где ставки налогов могут принимать предопределённые значения из следующего списка:

RateValue= Передаваемый налог
0 НДС 0%
1000 НДС 10%
2000 НДС 20%
11000 НДС 10/110%
12000 НДС 20/120%
-1 Без НДС

 

Данная гибкость настройки позволяет настроить для онлайн фискализатора ставки налогов так же, как и в реальных фискальных регистраторах, используемых на объекте. Например, в приведённом выше примере ini файла, налоги установлены так же, как и в фискальных регистраторах Атол. Подробнее про работу универсального драйвера с налоговыми ставками можно узнать в статье.

 

init.xml

<xmlConfig ProtocolVersion="46">
   <Parameters>
                <Company_INN>5544338819</Company_INN><!--ИНН компании, предоставленный в Атол-Онлайн-->
                <API_URL>https://online.atol.ru/possystem/v4/</API_URL><!--Адрес API Атол-Онлайн-->
                <API_GROUP>fit-club_4181</API_GROUP><!--API идентификатор компании в Атол-Онлайн-->
                <API_Login>fit-club</API_Login><!--API логин-->
                <API_Password>sbwby81V1DjS8oPeOLklKw==</API_Password><!--Зашифрованный пароль API (заполняется автоматически)-->
                <DurationWaitProcessed>300</DurationWaitProcessed><!--Время ожидания подтверждения фискализации после успешного принятия команды Атолом (в секундах)-->
                <NewPassword>exDDtrop4</NewPassword><!--Установить новый пароль (автоматически зашифруется при запуске connecter)-->
                <Company_PaymentAddress>https://fit-club.ru</Company_PaymentAddress><!--Адрес расчёта, предоставленный в Атол-Онлайн-->
   </Parameters>
</xmlConfig>

 

Все данные заполняемые в xml могут быть получены в Атол-Онлайн.

Регистрация чека, в зависимости от нагруженности могут варьироваться от 1-2 секунд до 2-3 минут, в связи с чем значение параметра DurationWaitProcessed рекомендуется устанавливать не менее 300.

ВАЖНО!!!

Для решений облачной фискализации наличие email или телефона клиента в чеке является обязательным, соответственно, должны быть установлены параметры "Общие параметры" - "Услуги и платежи" - "ФР может отправлять чеки на Email / через SMS". Соответствуюющие поля клиента должны быть заполнены.

 

 

Лицензирование

Интеграция защищёна лицензионным ключом Проект 5 модуль 1. Подробнее про лицензирование

ВАЖНО!!!

Для решений облачной фискализации наличие email или телефона клиента в чеке является обязательным, соответственно, должны быть установлены параметры "Общие параметры" - "Услуги и платежи" - "ФР может отправлять чеки на Email / через SMS". Соответствуюющие поля клиента должны быть заполнены.

Интеграция Абонемент с онлайн-кассами ФЗ-54

Всего есть 3 протокола для ФЗ 54:
Штрих - поддерживаем
АТОЛ - поддерживаем
СПАРК - НЕ работает. Поддержка в Абонемент появится только когда будет поддержан универсальный драйвер ФР.
------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 
В 125 версии Абонемент исправлена критическая ошибка. При оплате платежными картами не поднималась форма "Оплата". В 124 отправка работала только для Наличных платежей.
 
------------------------------------------------------------------------------------------------------------------------------------------------------------------------
В связи с изменениями в законодательстве проводятся доработки программного обеспечения и реализуется поддержка нового оборудования.
По состоянию на 30.01.2017 программное обеспечение Абонемент версия 124 поддерживает ряд наиболее распространённых ККМ, реализующих возможности нового закона:
  • Атол 22 (FPrint-22ПТК)
  • Атол 55Ф (он же FPrint-55ПТК)
  • Атол 77Ф (он же FPrint-77ПТК)
  • АТОЛ 30Ф (работает по протоколу АТОЛ 2.4, но не отправляет данные в ОФД - невозможно использовать, пока нами не будет поддержан протокол 3.0)
  • Retail-01K доработанный (Ритейл-01Ф) протокол Штриха
По мере добавления поддержки других ККМ данный список будет расширяться. Для клиентов ПО Абонемент миграция на новую систему регистрации платежей реализована максимально прозрачно, за короткие сроки и без существенных изменений в логике работы с программой и ККТ.
Нашими специалистами осуществляется мониторинг требований законодательства о применении ККТ, и проводятся оперативные доработки в случае изменений порядка работы программ с ККМ и ОФД.
 
В 124 версии уже доработано:
  • Добавлена поддержка новых моделей ФР, отвечающих требованиям 54-ФЗ
  • Доработан алгоритм формирования фискальных документов, реализующий требования 54-ФЗ
  • Появилась возможность указывать в ПО Абонемент телефон\e-mail покупателя, на который средствами ОФД должен быть отправлен электронный чек, добавлены настройки, отвечающие за включение режима работы ПО Абонемент в соответсвии с требованиями 54-ФЗ. Настройки / Общие параметры / услуги и платежи /  ФР может отправлять чеки по E-Mail (SMS).
  • Реализована и протестированна отправка в ОФД телефона\e-mail покупателя при использовании следующих функций: продажа с оплатой наличными,  возврат продажи. При возврате оплаты  по чеку, в котором был указан телефон\e-mail покупателя, отправка на указанные покупателем данные электронной копии чека о возврате производится автоматически, без необходимости повторно вносить эту информацию.
  • В 124 версии добавлен sdmShtrihMA11_54FZ.dlll для работы с Retail-01K (штрих)
------------------------------------------------------------------------------------------------------------------------------------------------------------------------
В 123 версии Абонемент появились следующие возможности:
  • Разработан алгоритм формирования фискальных документов, реализующий требования 54-ФЗ
  • Добавлена поддержка новых моделей ФР, отвечающих требованиям 54-ФЗ
  • Началась разработка и тестирование функции отправки чека на телефон\e-mail покупателя.
Более подробно по подключению в данной статье
 
Для подключения АТОЛ, необходимо войти в сервисный режим и сделать следующее:
  • Настроить для ФР канал обмена "USB"
  • Настроить на ФР протокол 2.4

Физическое подключение ФР к ПК:

  • Атол FPrint-22ПТК -  Пользователь может выбрать наиболее удобный способ подключения к персональному компьютеру (через RS-232C, USB-порт или Ethernet), а выход в интернет может быть обеспечен с помощью Ethernet, Wi-Fi, 2G, 3G (Wi-FI, 2G и 3G модули продаются дополнительно). Для подключения через COM-порт компьютер должен иметь оный, либо же должна быть приобретена дополнительная плата с выводом такого разъёма. 
  • Атол FPrint-55ПТК - по умолчанию настроен на работу через RS-232 (СОМ-порт), но можно изменить режим на подключение через usb.
  • ШТРИХ Ретейл 01К - подключаем через СОМ порт как обычно,  провод ETHERNET включаем в ПК или в роутер/свитч. Через драйвер  (внутри таблицы)  настраиваем IP-адрес принтера или он может получить адрес через DHCP. USB подключение можно использовать вместо провода ethernet , видится как сетевая карта и обязательно задаем статический IP-адреc. Необходимо избежать дублирования ip-адресов и подсетей .

Подключение АТОЛ Fprint55-ПТК

Для подключения ФР АТОЛ FPRINT-55ПТК и совместимости с нашим драйвером для работы с ФЗ-54 - sdmShtrihM21.dll (минимальная версия - 1.4.0.1) (sdmShtrihM21FZ54.dll - с версии 1.5.0.1), необходимо, используя сервисный режим, произвести следующие настройки Фискального Регистратора: канал обмена - USB, протокол обмена - Атол 2.4  

Начиная с версии тест драйвера 9.9.1, появилась возможность менять протокол обмена не используя сервисное меню, через Параметры ККТ  - Протокол обмена.

Выдержка из инструкции АТОЛ

"Сервисный режим предназначен для настройки подключения изделия по одному из поддерживаемых ККТ интерфейсов (RS-232 или USB), выбора протокола обмена и для включения либо выключения автоотрезчика. Для входа в сервисный режим нужно включить ККТ с нажатой кнопкой промотки ЧЛ, дождаться четвёртого звукового сигнала (для Атол 22Ф дождаться 5-го звукового сигнала) и отпустить кнопку промотки ЧЛ. ККТ войдёт в сервисный режим и выведет на печать документ, в котором представлен перечень возможных действий: выход из сервисного режима, выбор канала обмена, управление работой автоотрезчика и выбор протокола обмена. После этого ККТ ожидает выбора действия, который осуществляется путём нажатия на кнопку промотки ЧЛ – один, два, три или четыре раза (в зависимости от выбора) и отпускания её. При нажатии кнопки промотки ККТ воспроизводит звуковой сигнал. Возможные действия описаны ниже (см. рисунок)"

Подключение Retail-01K (Ритейл-01Ф) для связи с ОФД

Данная статья актуальна только для Retail-01K (Ритейл-01Ф)

 

Есть 3 основных варианта интерфейса для подключения ФР к ОФД:

  • Wi-Fi
  • Ethernet
  • USB (RNDIS-режим)

Перед покупкой\проведением доработки ККТ необходимо провести изучение торгового объекта заказчика и согласовать с ним вариант вида связи с ОФД.

Далее нужно получить электронную подпись (ЭЦП), подключить кассовый аппарат к ОФД и зарегистрировать кассовый аппарат в ФНС. Электронная подпись нужна для регистрации кассового аппарата в ФНС. ЭЦП можно получить в удостоверяющим центре, аккредитованным Минкомсвязи.
 
Чтобы подключится к ОФД, нужно заключить с ним договор на обработку фискальных данных. Узнать актуальный список авторизованных ОФД можно на сайте ФНС, к примеру - Москва. К этому моменту, соответственно, нужно получить ЭЦП, подготовить кассу и кассовое ПО нового образца, организовать канал связи для ККТ.
 
 
Зарегистрировать онлайн-кассу можно не выходя из магазина, онлайн. Это преимущество, которое дает новое законодательство. Заявленный срок регистрации – 1 день. Для регистрации новых касс НЕ требуется личное присутствие в ФНС и НЕ требуется договор с ЦТО и, соответственно, его представитель для регистрации также не требуется. 
Для регистрации нужно:
 
  1. В личном кабинете налогоплательщика (на сайте ФНС) отправить запрос на регистрацию ККТ, подписанный ЭЦП (или КЭП, что одно и тоже)
  2. ФНС сверяет данные о ККТ и фискальном накопителе с реестром и, если все в порядке, регистрирует ККТ
  3. Регистрационный номер передается в фискальный накопитель, который, в свою очередь, отправляет в ФНС отчет о фискализации.
  4. После этого ФНС «выдает» карточку регистрации, которую можно «получить» в личном кабинете на сайте ФНС.

Для того, чтобы регистрация ККТ прошла успешно, она должна быть полностью настроена для связи с ОФД и подключена к интернету. Рассмотрим настройку ККТ на примере RR-01Ф.

Независимо от способа связи с ОФД, в настройках ККТ нужно заранее указать адрес и порт ОФД:

После чего переходим к настройке канала связи.

Настройка ККТ для передачи данных. Подключение по USB (протокол RNDIS)

Передача данных с использованием протокола RNDIS осуществляется при физическом подключении через USB. Для того, чтобы ККТ работала и передавала данные на сервер ОФД с использованием протокола RNDIS в таблице №21 «Сетевые интерфейсы», в поле №9 "RNDIS" необходимо установить значение «1» ( по умолчанию значение: «0»). Для того, что бы настройки вступили в силу ККТ нужно перезагрузить. Значения таблицы приведены на рисунке.
 
 
После того, как в системе появится адаптер RNDIS нужно проверить, установлены ли драйверы для него. На некоторых системах, например Windows Embedded, эти драйвера автоматически не устанавливаются. Нужно скачать драйвера в сети Internet и установить.
 
По умолчанию ККТ имеет статический IP адрес. Все сетевые адреса находятся в таблице №16 "Сетевой адрес". Значения таблицы приведены на рисунке. Поле №1 "Static ip" задает статический (значение «1») или динамический (значение «0») IP адрес. Также необходимо в таблице ККТ задать адрес основного DNS сервера. Адрес сервера ОФД может быть задан в виде URL, поэтому нужна настройка DNS сервера.

Адаптер RNDIS в операционной системе можно настроить так, как показано на рисунке.

Для того, чтобы ККТ смог передавать данные на сервер ОФД через основное сетевое соединение нужно разрешить на основном сетевом адаптере передавать данные из других подсетей. Для этого нужно установить флажок, как показано на рисунке. 

Для подключения к ККТ используя драйвер ФР можно использовать параметры, приведенные на рисунке.

Примечание

Ип-адреса адаптеров в случае RNDIS-интерфейса должны полностью различаться, иначе связь с ФР по сети через Тестдрайвер есть, а данные в ОФД не отправляются. Т.е. если в локальной сети, предоставляющей интернет, используется адресное простарнство 192.168.*.*, то адрес ФР необходимо выставить к примеру 172.31.*.*

Настройка ККТ для передачи данных. Подключение по Wi-Fi

Если устройство модернизации (или ККТ) оборудовано модулем Wi-Fi, то в таблице №21 «Сетевые интерфейсы», поле №5 «Наличие Wi-Fi» по умолчанию будет запрограммировано значение «1». 

Для организации обмена данными с сервером ОФД с использованием интерфейса Wi-Fi нужно запрограммировать поля №№6-8 таблицы №21 следующим образом:
- В поле №6 «Использовать Wi-Fi» введите значение «1» (включить использование Wi-Fi);
- В поле №7 «Wifi ssid» введите имя точки доступа, посредством которой будет производиться передача фискальных данных;
- В поле №8 «Wifi passphrase» введите пароль для подключения к выбранной точке доступа. 
В завершение настроек ККТ следует настроить таблицу №22 «Сетевой адрес WiFi». В данном случае предусмотрено два режима работы:
- с использованием DHCP, когда IP-адрес присваивается автоматически из списка свободных IP-адресов;
- с использованием статического IP-адреса, когда параметры сетевого подключения к Wi-Fi вводятся в ручную.

Значение поля №2 «Статус dhcp» равное «10» говорит о том, что IP-адрес присвоен.

 

Настройка ККТ для передачи данных. Подключение по Ethernet

Для передачи данных с использованием Ethernet необходимо подключить ККТ к локальной сети предприятия. Далее следует проверить таблицу №21 «Сетевые интерфейсы». При необходимости привести их в соответствии с рисунком.

В завершение настроек ККТ следует настроить таблицу №16 «Сетевой адрес». В данном случае предусмотрено два режима работы:
- с использованием DHCP, когда IP-адрес присваивается автоматически из списка свободных IP-адресов (рис. 1);
- с использованием статического IP-адреса, когда параметры сетевого подключения вводятся в ручную (рис. 2).

Значение поля №2 «Статус dhcp» равное «10» говорит о том, что IP-адрес присвоен.

Подключение 1 ФР на несколько рабочих мест через УДФР

 

 

Данный способ позволяет использовать 1 фискальный регистратор (далее ФР) на нескольких рабочих местах Абонемент.

Общая схема работы представлена на рис.1.

Рис.1 Общая схема работы связки

 

Сборку можно найти с версии 129 Абонемента  по адресу \FullversionVerххх\HW\Uxml-rpc\ , где находятся 3 папки: Server, Client, UCS.
Папки Server и Client устанавливается на компьютере, к которому физически подключен ФР.
Папка UCS настраивается на компьютерах, где запускается ПО Абонемент.

 

Содержимое папок

Server:

 
sxrServerProxy.exe Приложение – сервер сообщения
sxrsrv.ini  Файл настроек сервера сообщения

Client:


 

sxrFRClient2.exe Приложение – клиент сообщения с ФР
sxrfrClient.ini Файл настроек клиента
URunPosRemote.dll  Библиотека-посредник для подключения универсального драйвера

UCS:


 

sdmTcpRpcFiscReg.dll             Библиотека связи с сервером сообщения (старого образца)
TcprpcFR.ini Файл настроек связи

 

Серверная часть

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

Рекомендуется разворачивать на том же ПК, к которому подключён ФР, для упрощения обслуживания связки.

 

Настройки sxrsrv.ini:

[SERVER]
  ;Порт, по которому будет происходить сообщение
  Port =7790
  ;Автоматически стартовать при запуске
  Autostart = 1
  ;Автоматически скрывать в трей при запуске
  Autohide = 1

 

Клиент ФР

Данная часть разворачивается непосредственно на ПК, к которому подключён ФР.

Приложение отвечает за работу с ФР, передавая команды, приходящие с рабочих мест.

У данного клиента должен быть уникальный код, для корректной маршрутизации команд с рабочих мест. Этот же код будет использован, при настройке рабочих мест.

В поставку утилиты не входит универсальный драйвер. Требуется настроить УДФР в папке Client так же как под клиентом Абонемент, добавив все необходимые файлы.

В URunPos.ini (или fr.ini, в зависимости от настройки) необходимо добавить:

[database]
; Адрес БД Абонемент
      dbname=127.0.0.1/3080:D:\_UCS\_FITNESS\IBDATA\FITNESS.FDB
      dbuser = ucs
      DBPassword = oQKH8n0BFUE=

[Main]
; Для корректной обработки ошибок при отсутствии ошибок
NoErrors = Empty

В противном случае, будут наблюдаться ошибки при снятии X- и Z-отчётов.

 

Настройки sxrfrClient.ini:

[SERVER]
  ;IP адрес сервера, где запущен sxrServerProxy
  Host = 127.0.0.1
  ;Порт общения с сервером sxrServerProxy
  Port = 7790
  ;Код данного клиента ФР (должен быть уникальным)
  ClientName = UCS_FR

  ;Адрес библиотеки-посредника
  DLL = C:\_UCS\_FITNESS\xml-rpc2\Client\URunPosRemote.dll

  ;Спрятать в трей при запуске
  AutoHide = 1
  ;Автозапуск сервера при открытии приложения
  AutoStart = 1

;Параметры логирования
[log]
  log.level=10
  log.debuglevel=10
  name=.\log\client.log
  ByMonthes=1
  ByDays=1
  BYHOURS=1

 

Настройки ПО Абонемент

На рабочих местах используется драйвер старого образца для удалённого ФР.

Т.е. Используется старая библиотека RunPos.dll к которой подключается sdmTcpRpcFiscReg.dll.

Для этого требуется скопировать содержимое папки UCS в папку exe на рабочем месте.

Для этого требуется чтобы runpos.ini имел следующий вид:

[MERGE]
HW = TcprpcFR.ini

[log]
level=10
debuglevel=10

Настройки TcprpcFR.ini

[BOOT]
;Подключаемая DLL
FiscReg = %exepath%\sdmTcpRpcFiscReg.dll

[HARDWARE]
    FiscReg = TcpRpcFR 

;Секция настроек подключения к клиентскому приложению
[FiscReg.TcpRpcFR] 
  ;IP адрес сервера, где запущен sxrServerProxy
   Host  = 127.0.0.1 
  ;Порт общения с сервером sxrServerProxy
   Port  = 7790 
  ;Идентификационное имя данного рабочего места (должно быть уникально)
   ClientName = Client_UCS_1
  ;Код клиента, к которому производится подключение
   ProxyFRClient = UCS_FR

Подключение 2-х и более фискальных регистраторов

 

 

 

 

Данная инструкция применяется в случае установки 2-х и более фискальных регистраторов для 2-х и более юридических лиц. Данная инструкция неактуальна для 1-го юридического лица и является продолжением статьи "Подключение фискального регистратора", которая содержит всю основную информацию по данному вопросу.

Пример: подключение 3-х устройств (2 устройства Штрих-ФР-К + 1 устройство ПРИМ 08ТК).

Продажа производиться от 3-х юридических лиц  (Орг1, Орг2, Орг3) на одном рабочем месте.

(Рис.1 Схема подключения нескольких ФР к разным Юр. лицам)

В директории ..\exe\ проверьте наличие следующих файлов: shelter.hw.ini. Для Прим: Prim08TK.msg, sdmAzimuth.dll, AZIMUTH.DLL. Для Штрих: sdmShtrihMA11.dll, ShtrihMA11.RUS.Msg

Узнав параметры подключения используемых фискальных регистраторов, настраиваем shelter.hw.ini.

SHTRIHMA, AZIMUTH – формат записи должно быть неизменен, этот параметр жестко связан с исполняемыми DLL
FiscReg1…3 – Это внутренние названия фискальных регистраторов, которые будут использованы при настройке Abonementmanager

Пример настройки файла shelter.hw.ini

[BOOT]
  DLL_LOAD3= sdmShtrihMA11.dll
  DLL_LOAD4= sdmAzimuth.dll  

 [hardware]
  FiscReg1 = SHTRIHMA
  FiscReg2 = SHTRIHMA
  FiscReg3 = AZIMUTH

;------------------------------------------------------------------------------------------------------------ShtrihMA1
[FiscReg1.SHTRIHMA]
; Печать отчета по секциям перед X,Z-отчетами
  PrintSectionReport = 1
  COMPORT = 1
  COMPORTPARAMS=baud=115200 parity=n data=8 stop=1 rts=on dtr=on
  ToOEM      = 1
  MaxLine    = 24
  PassWord   = 30
  SEPassword = 0
  MsgFile    = ShtrihMA11.RUS.Msg
  MsgSection = Errors

;------------------------------------------------------------------------------------------------------------ShtrihMA2
[FiscReg2.SHTRIHMA]
; Печать отчета по секциям перед X,Z-отчетами
  PrintSectionReport = 1
  COMPORT =2
  COMPORTPARAMS=baud=19200 parity=n data=8 stop=1 rts=on dtr=on
  ToOEM      = 1
  MaxLine    = 24
  PassWord   = 30
  SEPassword = 0
  MsgFile    = ShtrihMA11.RUS.Msg
  MsgSection = Errors

;------------------------------------------------------------------------------------------------------------AZIMUTH3
[FiscReg3.AZIMUTH]
  COMPORT = 3
  COMPORTPARAMS=baud=9600 parity=e data=8 stop=1
  ToOEM   = 0
  MsgFile    = Prim08TK.msg
  MsgSection = Errors

Настройка ПО «Abonementmanager»

Обратимся к рисунку 2. В программе нажимаем кнопку "Настройки" (1), внутри - вкладка "Параметры" --> "Общие параметры" (2). Двойной клик по нужной организации (3), во всплывающем окне - вкладка "Услуги и платежи" - ставим галочку "Работать с несколькими юр.лицами (фискальные регистаторы)" (4)

(Рис.2 Включение опции в ПО Абонемент)

Теперь необходимо создать Юридические лица и киоски к ним. Возвращаемся в "Общие параметры". В разделе "Собственники" нажимаем кнопку "Добавить"  на панели меню (либо правой кнопкой нажимаем в пустое место раздела - "Добавить"). Создаём юр.лица и добавляем их в список двойным кликом. Для каждого юр.лица добавляем киоски, указываем название устройства, описанное в ini-файле (FiscReg1, FiscReg2, FiscReg3), и имя компьютера, к которому подсоединены фискальные регистраторы.

Также необходимо:

  1. Завести нужное кол-во организаций-собственников;
  2. Определить для организаций-собственников киоски;
  3. Настроить услуги. В карточке услуги определить организацию-собственника;

 

Виртуальный ФР в Абонемент

Для того, чтобы Абонемент обращался к виртуалному фискальному регистратору, требуется:

 

Проверить наличие RunPos.dll, sdmVirtFiscReg.dll из поставки в папке \exe\

 

shelter.hw.ini должен быть заполнен следующим образом (данные строки должны быть единственными незакомментированными):

[BOOT]
  VirtFisc = sdmVirtFiscReg.dll

[hardware]
   FiscReg = VirtFiscReg

[FiscReg.VirtFiscReg]
  MsgFile = FiscReg.rus.msg 
  MsgSection = Errors
  ProhibitAll = 0

 

С версии Абонемент 127, также требуется проверить остутствие или закомментировать в abonementmanager.ini строку, если использовался универсальный драйвер ФР:

;RunPosDllName=URunPos.dll

 

При данных настройках, Абонемент будет обращаться к виртуальному ФР.

Печать кассира на ФР АТОЛ

 
В новых драйверах внедрили данную функцию, но с некоторыми ограничениями. (С версии драйверов: sdmShtrihM21Old.dll (1.5.0.1), sdmShtrihM21FZ54.dll (1.5.0.1) от 12.04.2017 и последующих) (Планируются к поставке с версии 1.126 Абонемента)
В связи с этим, требуется дополнительная настройка.
 
 
Для настройки корректного внесения кассиров в чеки, требуется:
 
1. Чтобы в Абонементе логины кассиров имели значения строго от 1 до 28 (иначе на данный момент не реализуемо).
 
2. В соответствии с тем, как кассиры настроены в Абонементе, добавить кассиров в таблицу кассиров в ФР.  Для этого:
 
    2.1. Для этого понадобится ПО от Атола "Драйверы_торгового_оборудования_9_9_2" (от 22.05.2017, версии ниже некорректно работают с таблицей кассиров и не работают с новыми ФР настроенными на протокол 2.4)
 
    2.2. После распаковки, необходимо запустить nt-x86-mingw\fptr_t.exe (Тест драйвера). В нём через кнопку "Свойства" в правой панели, настроить подключение к ФР.
 
   
 
    2.3. Подключаться можно в обоих протоколах (АТОЛ 2 и АТОЛ 3), в зависимости от того, на какой, в данный момент, настроен ФР. (Для работы в ПО Абонемент ФР должен быть в режиме связи по АТОЛ 2.4)
 
    2.4. Далее, в свойствах, после установки связи с ФР, нажмите кнопку "Параметры ККТ".
 
   
 
    2.5. Во всплывшем окне найдите секцию "Кассиры". В данной секции пропишите кассиров в поля, не изменяя пароли, в соответствии с их логинами (от 1 до 28) в Абонементе.
   Не изменяйте кассиров 29 и 30.
 
   
 
    2.6. После завершения изменения таблицы, закрывайте окно по кнопке "ОК".
 
 
3. В shelter.hw.ini в секцию данного ФР требуется добавить
 
  isUseCasherPwdTable = 1

 

Пример:

[FiscReg.SHTRIHM]

  Version = 22
  COMPORT = 1
  COMPORTPARAMS=baud=115200 parity=n data=8 stop=1 rts=on dtr=on
  ; Если в чяеке иероглифы - попробовать поменять значение (0/1)
  ToOEM      = 1
  MaxLine    = 24
  PassWord   = 30
  SEPassword = 0
  MsgFile    = ShtrihM21.RUS.msg
  MsgSection = Errors


  ;использовать таблицу кассиров для печати на чеках.
  ;Таблица кассиров настраивается самостоятельно, ограничение на кол-во кассиров 28,
  ;Код кассира в Абонементе = пароль в таблице кассиров в фискальниках Атол
  isUseCasherPwdTable = 1

;--------------------------------------------------------
[FiscReg.SHTRIHM-FZ54]
  Version = 22
  COMPORT = 7
  COMPORTPARAMS=baud=115200 parity=n data=8 stop=1 rts=on dtr=on

  ToOEM      = 1
  MaxLine    = 24
  PassWord   = 30
  SEPassword = 0
  MsgFile    = ShtrihM21.RUS.msg
  MsgSection = Errors

  isUseCasherPwdTable = 1
;--------------------------------------------------------
 
 
После завершения данной настройки, на чеках в качестве кассира будет печататься строка, указанная в таблице, в строке соответствующей логину пользователя, если логин имеет числовое значение от 1 до 28.
Иначе на чеке будет печататься СИС.Администратор.
 
Например:

Работа Абонемент с налоговыми ставками, кассовыми секциями и СНО с различными ФР

 

При работе Абонемент с фискальными регистраторами, для каждой пробитой в чеке позиции передаются (помимо стоимости и наименования) два параметра – код налога в ФР и код кассовой секции. (Параметры «Код налога ФР» и «Кассовая секция» услуги в справочнике услуг).

В общем случае, эти два параметра могут быть установлены независимо друг от друга.

В зависимости от протокола работы (семейства), ФР могут использовать оба эти параметра или только 1.

Ниже представлены примеры работы некоторых протестированных ФР с данными параметрами, при использовании универсального драйвера ФР.

 

Параметр TaxIndexDef УДФР

Данный параметр используется в следующем случае:

Если в ФР не имеет налога с кодом 0. В таком случае, все услуги, у которых параметр "Код налога ФР" оставлен в значении по умолчанию (т.е. 0) будут при пробитии на ФР вызывать ошибку - неверный налог.

Чтобы избежать данной ситуации используется параметр TaxIndexDef - значение на которое подменяется код налога, если для услуги он оставлен в значении по умолчанию = 0. 

Установка данного параметра также позволяет не перенастраивать все заведённые услуги, если на объекте используется только 1 значение налога. В таком случае параметр TaxIndexDef устанавливается в значение равное коду этого налога.

 

Работа с несколькими СНО

С версии 1.132 Абонемент в карточке услуги появился новый параметр - "СНО (Система налогооблажения)".

Данный параметр устанавливает, СНО который будет указан в чеке, для данной услуги.

СНО - параметр чека, что означает, что в одном чеке не могут быть позиции попадающие под разные СНО.

Таким образом, если в списке продаваемых услуг будут услуги с разными СНО, то будут распечатаны несколько чеков, с услугами сгрупиррованными по СНО.

Подробнее про особенности настройки ФР (для которых известно) для работы с несколькими СНО приведены ниже.

 

Работа с налогами и секциями в ФР ШТРИХ 54 ФЗ

Для ФР ШТРИХ поддержана произвольная установка налога для услуги независимо от секции.

Т.е. настройки: "Код налога ФР" и "Кассовая секция", независимы и имеют силу для любой услуги и платежа.

Для ФР Штрих, налоги по умолчанию имеют следующие коды:

1 (А) – НДС 18%, 2 (Б) - НДС 10%, 3 (В) - НДС 0%, 4 (Г) - Без налога.

;Коды налогов
;1 = НДС 18%
;2 = НДС 10%
;3 = НДС 0%
;4 = Без налога 

Также следует отметить, что количество секций ограничено и равно 16. Если установить секцию вне диапазона, при попытки пробития  чека с такой позицией выйдет ошибка ФР и чек не будет зарегистрирован.

 

Работа с налогами и секциями в ФР АТОЛ 54 ФЗ

Для ФР АТОЛ поддержана произвольная установка налога для услуги.

При установленном параметре в init.xml, следующим образом: <usesectionas>Direct</usesectionas> или <usesectionas>Auto</usesectionas>, оба параметра - "код налога ФР" и "кассовая секция" независимы и имеют силу. (С версии драйвера fpAtol54.dll v.7.39.153.0)

 Direct - id налогов не изменяются и передаются в ФР как в карточке услуги.

 Auto - id налогов изменяются и передаются в ФР так, чтобы для вызывающего ПО (Абонемент) id налогов были как в версиях прошивки ФР до появления ФФД 1.05, когда были изменены id налогов (см.ниже).

 

Иначе налоги используются в зависимости от используемой секции. (Настройка привязки налогов к конкретным секциям настраивается в ФР, в таблице "Секции")

В какую именно секцию зачислять ту или иную услугу, определяется или параметром "кассовая секция" (по умолчанию), или параметром "код налога ФР", в зависимости от настроек подключения.

 

В случае если параметр установлен как: <usesectionas>Department</usesectionas>, то налоги привязываются в зависимости от используемой секции. (Настройка привязки налогов к конкретным секциям настраивается в ФР, в таблице "Секции")

В какую именно секцию зачислять ту или иную услугу, определяется или параметром  "кассовая секция". Параметр "Код налога ФР" не используется.

 

Если в параметр установлен как: <usesectionas>TaxRateIndex</usesectionas>, то налоги привязываюются в зависимости от используемой секции.

В какую именно секцию зачислять ту или иную услугу, определяется или параметром  "код налога ФР". Параметр "кассовая секция" не используется.

 

Для АТОЛ 22Ф на котором производилось основная часть тестирования - секция по умолчанию - 01, налог по умолчанию для секции 01 = НДС 0%, 02 = НДС 10%, 03 = НДС 18%, 04 = Без НДС.

;Коды налогов 
;01 = НДС 0%
;02 = НДС 10%
;03 = НДС 18%
;04 = Без НДС

Также следует отметить, что количество секций ограничено и равно 16. Если установить секцию вне этого диапазона, при попытки пробития чека выйдет ошибка ФР и чек не будет зарегистрирован.

 

На прошивках устанавливаемых с начала 2018 года изменился порядок налогов в ФР АТОЛ

!!!Обязательно ознакомьтесь с информацией, приведённой в задаче 150489 касательно версий fpAtol54.dll v.7.39.153.0 и выше.

 

На прошивках, устанавливаемых в связи с повсеместным переходом на ФФД 1.05 таблица налогов изменена на следующую:

;Коды налогов (коды секций к которым прикреплены налоги)
;01 = НДС 0%
;02 = НДС 10%
;03 = НДС 18%
;04 = НДС 10/110
;05 = НДС 18/118
;06 = Без НДС

Если использовался один из изменивших id налогов, то необюходимо произвести соответствующие изменения в TaxIndexDef и/или "Код налога ФР"

 

Работа с несколькими СНО

В ФР АТОЛ для корректной работы с несколькими СНО требуется:

В параметрах ККТ через тест драйвера, в секции "Налоговые ставки" установить только одну галку "Использовать **** СНО". Причём какую именно - не принципиально, поскольку СНО будет определяться настройками в Абонемент.

Только в таком случае ФР будет регистрировать чеки на СНО передаваемое ПО Абонемент.

В противном случае, ФР будет возвращать расширенную ошибку "103h Некорректная СНО", даже если эта конкретная СНО в ФР разрешена, но разрешено настройками более одной СНО.

Рис.1 Ошибка при некорректной настройке ФР

 

 

Работа с налогами и секциями в ФР СПАРК

ФР Спарк 115-Ф позволяет установку произвольного налога для каждой позиции чека.

ФР не поддерживает кассовые секции, соответственно параметр «кассовая секция» не используется.

Для ФР СПАРК, на котором производилось тестирование, коды налогов имели следующую привязку:

;Коды налогов
;0 = НДС НЕ ОБЛ.
;1 = НДС 18%
;2 = НДС 10%
;3 = НДС 0%

 

Работа с налогами и секциями в ФР ПРИМ 08-Ф

 

ФР ПРИМ 08-Ф позволяет установку произвольного налога для каждой позиции чека.

ФР не поддерживает кассовые секции, соответственно параметр «кассовая секция» не используется.

Для ФР ПРИМ, на котором производилось тестирование, коды налогов имели следующую привязку:

;Коды налогов
;0 = БЕЗ НДС
;1 = НДС 0%
;2 = НДС 10/110%
;3 = НДС 18/118%
;4 = НДС 10%
;5 = НДС 18%