Поддерживаемые драйвером старого образца:
"Старые" модели (не online):
"Новые" ФР (ФЗ-54 Online-касса):
* - АТОЛ работает по протоколу 2.4. Отправка данных по данному протоколу так же возможна, но требует специальных настроек со стороны ЦТО или Заказчика. В случае проблем можно обращаться в тех поддержку АТОЛ.
ФР поддерживаемые универсальным драйвером:
ФР ПРИМ 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
|
![]() |
В настоящий момент ПО «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)
Внимание! Эмуляция порта не поддерживается для моделей "ПТК".
Фискальный регистратор подключается в СОМ-порт или другой порт с эмуляцией серийного порта. Настройки 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. Этот параметр отвечает за печать отчета на секциям в нефискальном режиме средствами драйвера. Для программного обеспечения Абонемент не рекомендуется к использованию.
Фискальный регистратор подключается в СОМ-порт или другой порт с эмуляцией серийного порта.
Настройки 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
В настройках Абонемента нужно уснять флаг Пробивать нулевой чек. Приводит к появлению ошибок при открытии фискальной смены 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
Аналогично предыдущему примеру, необходимо подключить ФР и с помощью прилагающегося драйвера узнать параметры подключения устройства, после чего изменить файл 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
В связи с переходом (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
Пример
Для Группы услуг «Бар» и подгруппы услуг «Расходные товары» необходимо установить значение ППР — Товар.
Выбираю необходимые группы услуг, значение параметра ППР - > Выполнить.
Для выбранных групп услуг значение параметра ППР изменяется
Производители ФР Спарк, Штрих и Атол уже реализовали прошивки для автоматического изменения налоговой ставки при открытии первой смены 01.01.2019г.
Переход на новые значения ставки в ней реализован следующим образом: заранее в настройках ФР задается дата изменения налога (для Спарк 115-Ф, для Атол и Штрих - предопределено 01.01.2019г). При открытии смены указанного числа ставка налога автоматически меняется.
Таким образом, дополнительных операций с перенастройкой ФР в Shelter / Абонемент делать не потребуется.
В связи с тем, что "Федеральным законом № 303-ФЗ не предусмотрено какого-либо переходного периода", 01.01.2019 для перехода на НДС 20% потребуется:
1. Зайти в Настройки \ Справочники \ Налоги \ НДС.
Изменить карточку налога: Код (при необходимости), Наименование (при необходимости), Ставка (обязательно).

Рис.4
Для Заказчиков, которые находятся на договоре технической поддержки, предусмотрено автоматическое изменение данных параметров. За настройкой Вы можете обратиться в отдел Технической поддержки.
Важно! Услуги реализуемые по абонементам с датой «начала действия» до 01.01.2019, начисляются по изначальной цене с измененной ставкой в пользу НДС на основании федерального закона "О внесении изменений в отдельные законодательные акты Российской Федерации о налогах и сборах" от 03.08.2018 №303-ФЗ
На данный момент реализовано следующее решение, для автоматической замены ставки НДС:
В результате:
1. При появлении смены ночного аудита датированной 01.01.2019 проверяет наличие налога в справочнике с кодом «TAX18» и ставкой =18.
2. В случае наличия такого налога:
2.1. Изменяется наименование налога на «НДС 20% (бывш. Наименоваине)»;
2.2. Изменяется величина ставки с «18%» на «20%».
2.3. Последующее начисление услуг со ссылкой на ставку «НДС 20% (бывш. Наименоваине)» происходит по величине «20%».
В случае, если требуется изменить ставку после 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.rar | 747 байтов |
ФР -- фискальный регистратор.
УДФР -- универсальный драйвер фискального регистратора.
Универсальный драйвер фискального регистратора (ФР) позволяет использовать интерфейс взаимодействия Абонемент с драйверами ФР нижнего уровня поставляемыми 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
|
![]() |
ВАЖНО!
При обновлении Абонемент на версию 130 и выше, необходимо также обновить и драйвера фискальных регистраторов на актуальные. Иначе, информационное уведомление о количествах и сроках неотправленных в ОФД документов, будет всегда выводиться с некорректными данными как на рисунке выше.
ВАЖНО!
"Ошибка ФР: Исчерпан ресурс хранения ФН" означает, что в ФН присутствуют фискальные документы не отправленные в ОФД более 30 суток. В связи с чем ФН не позволяет производить регистрацию новых фискальных документов. Требуется обеспечить связь ФР с ОФД. Работа с ФР будет разблокирована, после отправки данных документов.
Для работы с ФР АТОЛ, требуется чтобы следующие файлы были перенесены в папку ехе:
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
В общем случае требуется только ввести данные для подключения к ФР:
Примечание. Работа с налогами в ФР АТОЛ
Для корректной работы с ФФД 1.05 и функционалом привнесённым в 135 версии Абонемент требуется:
Обновить URunPos.dll до версии 2.1.0.5, fpAtol54.dll до версии 7.47.162.0
На тестовом ФР Атол 22-Ф тип оплаты "Аванс (Предоплатой)" имел код 3, что соответствует значению по умолчанию:
Поэтому изменений в настройках не требуется.
Для работы с ФР Штрих, требуется чтобы следующие файлы были перенесены в папку ехе:
URunPos.dll (вер. не ниже 2.0.0.230), URunPos.ini, BarCodeGen.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
Примечание. Работа с налогами в ФР ШТРИХ
Для ФР ШТРИХ поддержана произвольная установка налога для услуги независимо от секции. (Подробнее про коды налогов см. соответствующую статью)
Т.е. обе настройки: "Код налога ФР" и "Кассовая секция" независимы и имеют силу для любой услуги и платежа.
Для корректной работы с ФФД 1.05 и функционалом привнесённым в 135 версии Абонемент требуется:
Обновить URunPos.dll до версии 2.1.0.5, fpShtr54.dll до версии 7.47.86.0
На тестовом ФР Ритейл-01Ф тип оплаты "Аванс (Предоплатой)" имел код 14, что не соответствует значению по умолчанию.
Соответственно, в fr.ini в секции [Main] необходимо прописать:
Для работы с ФР Спарк 115-Ф, требуется чтобы следующие файлы были перенесены в папку ехе:
URunPos.dll (вер. не ниже 2.0.0.230), URunPos.ini, BarCodeGen.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
Примечание. Работа с налогами и секциями в ФР СПАРК
ФР Спарк 115-Ф позволяет установку произвольного налога для каждой позиции чека. (Подробнее про коды налогов см. соответствующую статью)
Кассовые секции не используются.
Примечание. Работа на одном ФР СПАРК с нескольких рабочих мест
За счёт использования утилиты SparkSrv появляется возможность использовать один ФР Спарк с другого рабочего места, путём подключения к утилите по соответствующему адресу и порту.
Примечание. ФР СПАРК и нулевой чек
ФР СПАРК не позволяет пробитие нулевого чека. Необходимо отключить пробитие нулевого чека на всех киосках, к которым подключаются ФР СПАРК.
ВАЖНО
В ФР СПАРК ошибка "Ошибка ФР 54: Запрещено по программируемому флагу №5" означает, что флаг доступных к возврату типов платежей для данного платежа снят.
Для корректной работы с ФФД 1.05 и функционалом привнесённым в 135 версии Абонемент требуется:
Обновить URunPos.dll до версии 2.1.0.5, fpSpark54.dll до версии 7.46.42.0
На тестовом ФР СПАРК 115-Ф тип оплаты "Аванс (Предоплатой)" имел код 5, что не соответствует значению по умолчанию.
Соответственно, в fr.ini в секции [Main] необходимо прописать:
Корректная работа ФР ПРИМ 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
Примечание. Работа с налогами и секциями в ФР ПРИМ
ФР ПРИМ 08-Ф позволяет установку произвольного налога для каждой позиции чека. (Подробнее про коды налогов см. соответствующую статью)
Кассовые секции не используются.
Примечание. ФР ПРИМ и нулевой чек
ФР ПРИМ не позволяет пробитие нулевого чека. Необходимо отключить пробитие нулевого чека на всех киосках, к которым подключаются ФР ПРИМ.
Для работы с ФР Datecs DP 25, требуется чтобы следующие файлы были перенесены в папку ехе:
URunPos.dll (вер. не ниже 2.0.0.184), URunPos.ini, BarCodeGen.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
Примечание
Тестирование ФР Datecs DP 25 производилось сотрудником дилеров - Bogdan Romascu из «UCS-Romania».
С версии 2.0.0.201 urunpos.dll доступны параметры в urunpos.ini: CashDrawerNumber = 0 - Номер денежного ящика (как правило, 0 - ящик по умолчанию), OpenCashDrawerAfterEndFiscal = 1 - открывать ящик по команде из Абонемент (1 - открывать всегда, 0 - открывать только по кнопке "Открыть денежный ящик").
Работает независимо от версии Абонемента: открытие ящика при оплате наличными, при снятии Х и Z-отчёта.
С версии Абонемента 128 доступна кнопка в ночном аудите, для открытия денежного ящика по запросу - "Открыть денежный ящик".
С версии 128 Абонемента поддержана передача пользователя Абонемент в качестве кассира в фискальный документ для всех доступных кассовых операций.
Для работы с двумя ФР на 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.
После установки и настройки необходимо протестировать работу драйвера.
План тестирования:
В связи с ФЗ 54 при использовании онлайн модулей и мобильных приложений возникает законный вопрос - как быть с онлайн платежами? Кто и как должен формировать фискальный чек? Как предоставить чек покупателю?
Для онлайн модулей, процессинговые системы предлагают производить фискализацию их силами (передача содержимого чека поддержана в Абонемент Онлайн для Робокассы), но это не всегда удобно.
Для онлайн приложений, не все процессинговые системы предлагают фискализацию.
Для подобных случаев были созданы различные предложения для облачной фискализации - когда фискальный регистратор находится в датацентре и работает через веб-интерфейс 24/7 на различных заказчиков. Такие как Атол-Онлайн и CloudKassir (CloudPayments).
В таком случае схема взаимодействия при оплате будет выглядеть как указано на рис.1.
|
Рис.1 Схема работы при интеграции с облачным решением для фискализации |
То есть, при проведении платежа через Абонемент Онлайн/мобильное приложение, платёж проводится в два этапа:
1. Мобильное приложение/Абонемент Онлайн перенаправляет клиента в процессинг, где он производит платёж, информация о платеже возвращается в модуль.
2. Модуль отправляет запрос на регистрацию платежа в Абонемент через API (Connecter). Для завершения регистрации платежа, API запросит формирование чека для данной операции у облачного ФР. Только после успешной фискализации платёж (чек) будет зарегистрирован в Абонемент.
//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
Все данные заполняемые в 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 запросит формирование чека для данной операции у облачного ФР. Только после успешной фискализации платёж (чек) будет зарегистрирован в Абонемент.
//here lies copy paste from URunPos node
Данное решение настраивается через универсальный драйвер.
Для этого в connecter.ini необходимо в секцию [pos] добавить строку:
RunPosDllName=Urunpos.dll
Следующие файлы должны быть в папке с Connecter:
URunPos.dll (вер. не ниже 2.2.0.4), URunPos.ini, fpCloudAtol.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
Все данные заполняемые в xml могут быть получены в Атол-Онлайн.
Регистрация чека, в зависимости от нагруженности могут варьироваться от 1-2 секунд до 2-3 минут, в связи с чем значение параметра DurationWaitProcessed рекомендуется устанавливать не менее 300.
ВАЖНО!!!
Для решений облачной фискализации наличие email или телефона клиента в чеке является обязательным, соответственно, должны быть установлены параметры "Общие параметры" - "Услуги и платежи" - "ФР может отправлять чеки на Email / через SMS". Соответствуюющие поля клиента должны быть заполнены.
Интеграция защищёна лицензионным ключом Проект 5 модуль 1. Подробнее про лицензирование
ВАЖНО!!!
Для решений облачной фискализации наличие email или телефона клиента в чеке является обязательным, соответственно, должны быть установлены параметры "Общие параметры" - "Услуги и платежи" - "ФР может отправлять чеки на Email / через SMS". Соответствуюющие поля клиента должны быть заполнены.
Физическое подключение ФР к ПК:
Для подключения ФР АТОЛ 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Ф)
Есть 3 основных варианта интерфейса для подключения ФР к ОФД:
Перед покупкой\проведением доработки ККТ необходимо провести изучение торгового объекта заказчика и согласовать с ним вариант вида связи с ОФД.
Для того, чтобы регистрация ККТ прошла успешно, она должна быть полностью настроена для связи с ОФД и подключена к интернету. Рассмотрим настройку ККТ на примере RR-01Ф.
Независимо от способа связи с ОФД, в настройках ККТ нужно заранее указать адрес и порт ОФД:

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


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


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

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


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


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

(Рис.1 Схема подключения нескольких ФР к разным Юр. лицам)
В директории ..\exe\ проверьте наличие следующих файлов: shelter.hw.ini. Для Прим: Prim08TK.msg, sdmAzimuth.dll, AZIMUTH.DLL. Для Штрих: sdmShtrihMA11.dll, ShtrihMA11.RUS.Msg
Узнав параметры подключения используемых фискальных регистраторов, настраиваем 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
Обратимся к рисунку 2. В программе нажимаем кнопку "Настройки" (1), внутри - вкладка "Параметры" --> "Общие параметры" (2). Двойной клик по нужной организации (3), во всплывающем окне - вкладка "Услуги и платежи" - ставим галочку "Работать с несколькими юр.лицами (фискальные регистаторы)" (4)

(Рис.2 Включение опции в ПО Абонемент)
Теперь необходимо создать Юридические лица и киоски к ним. Возвращаемся в "Общие параметры". В разделе "Собственники" нажимаем кнопку "Добавить"
на панели меню (либо правой кнопкой нажимаем в пустое место раздела - "Добавить"). Создаём юр.лица и добавляем их в список двойным кликом. Для каждого юр.лица добавляем киоски, указываем название устройства, описанное в ini-файле (FiscReg1, FiscReg2, FiscReg3), и имя компьютера, к которому подсоединены фискальные регистраторы.
Также необходимо:
Для того, чтобы Абонемент обращался к виртуалному фискальному регистратору, требуется:
Проверить наличие 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
При данных настройках, Абонемент будет обращаться к виртуальному ФР.



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.
Ниже представлены примеры работы некоторых протестированных ФР с данными параметрами, при использовании универсального драйвера ФР.
Данный параметр используется в следующем случае:
Если в ФР не имеет налога с кодом 0. В таком случае, все услуги, у которых параметр "Код налога ФР" оставлен в значении по умолчанию (т.е. 0) будут при пробитии на ФР вызывать ошибку - неверный налог.
Чтобы избежать данной ситуации используется параметр TaxIndexDef - значение на которое подменяется код налога, если для услуги он оставлен в значении по умолчанию = 0.
Установка данного параметра также позволяет не перенастраивать все заведённые услуги, если на объекте используется только 1 значение налога. В таком случае параметр TaxIndexDef устанавливается в значение равное коду этого налога.
С версии 1.132 Абонемент в карточке услуги появился новый параметр - "СНО (Система налогооблажения)".
Данный параметр устанавливает, СНО который будет указан в чеке, для данной услуги.
СНО - параметр чека, что означает, что в одном чеке не могут быть позиции попадающие под разные СНО.
Таким образом, если в списке продаваемых услуг будут услуги с разными СНО, то будут распечатаны несколько чеков, с услугами сгрупиррованными по СНО.
Подробнее про особенности настройки ФР (для которых известно) для работы с несколькими СНО приведены ниже.
Для ФР ШТРИХ поддержана произвольная установка налога для услуги независимо от секции.
Т.е. настройки: "Код налога ФР" и "Кассовая секция", независимы и имеют силу для любой услуги и платежа.
Для ФР Штрих, налоги по умолчанию имеют следующие коды:
1 (А) – НДС 18%, 2 (Б) - НДС 10%, 3 (В) - НДС 0%, 4 (Г) - Без налога.
;Коды налогов ;1 = НДС 18% ;2 = НДС 10% ;3 = НДС 0% ;4 = Без налога
Также следует отметить, что количество секций ограничено и равно 16. Если установить секцию вне диапазона, при попытки пробития чека с такой позицией выйдет ошибка ФР и чек не будет зарегистрирован.
Для ФР АТОЛ поддержана произвольная установка налога для услуги.
При установленном параметре в 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-Ф позволяет установку произвольного налога для каждой позиции чека.
ФР не поддерживает кассовые секции, соответственно параметр «кассовая секция» не используется.
Для ФР ПРИМ, на котором производилось тестирование, коды налогов имели следующую привязку:
;Коды налогов ;0 = БЕЗ НДС ;1 = НДС 0% ;2 = НДС 10/110% ;3 = НДС 18/118% ;4 = НДС 10% ;5 = НДС 18%