Подключение ККТ к Abonement

• АТОЛ. Платформа 5. Особенности подключения к ПО Абонемент
• Штрих-М. Передача тега 1163 (Маркировка ФФД 1.2) через Тест Драйвера
• Отключение печати бумажных чеков ПО Абонемент
• AtolCloud Подключение облачной фискализации
• Виртуальный ФР в Абонемент
• Возврат чека на ККТ Атол через ДТО
• ФФД 1.2
• Штрих-М (Shtrih-m) 09h: ФП - Некорректная длина команды [200]
• АТОЛ. Работа с маркированной продукцией. Честный Знак.
• ШТРИХ, Подключение к ПО Абонемент
• Штрих: Как распечатать чек с Агентскими реквизитами ФФД 1.2?
• ОФД: список настроек для регистрации касс
• Применение налоговых ставок НДС 5% и 7% с 01.01.2025 года.

АТОЛ. Платформа 5. Особенности подключения к ПО Абонемент

Настройка для работы ФР Атол на 5 платформе.

Необходима прошивка ФР, поддерживающая 5 платформу. (не ниже 5.8.1 на март 2023)

Настройки для работы с Честным знаком по ссылке

Установка и настройка:

1. Необходимые файлы в папке \exe Абонемента:

• URunPos (вер. 2.14.0.3 +)
• URunPos.ini
• BarCodeGen.dll
• fpRU_AtolDTO.dll (7.72.149 +)
• fptr10.dll  x86 (10.10.6.0 +)
• init.xml

2. Прописать в abonementmanager.ini в секции [pos]:

RunPosDllName=URunPos.dll

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

Пример:

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

;Обязательный параметр для данного драйвера!
DefaultTaxValue=-1

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

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

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

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

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

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

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

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

;Привязка наличного фискального типа оплаты к соответствующему типу оплаты ФР
CashSumTypeIndex = 0
;Привязка электронного фискального типа оплаты к соответствующему типу оплаты ФР
CardSum1TypeIndex = 1
;Привязка авансового фискального типа оплаты к соответствующему типу оплаты ФР
CardSum2TypeIndex = 2
;Привязка безналичного фискального типа оплаты к соответствующему типу оплаты ФР
CardSum3TypeIndex = 1
;Привязка типа оплаты Передача в кредит к соответствующему типу оплаты ФР
CardSum4TypeIndex = 3

;Тип оплаты
CashSumText = Наличными
CardSum1Text = Карта
CardSum2Text = Карта
CardSum3Text = Карта
CardSum4Text = Карта

;Штриховой код, за секцию отвечает 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%

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

Пример:

<xmlConfig>  
  <Parameters>  
    <LogLevel>5</LogLevel>               <!--уровень логирования [0...5]-->
    <LogRotateSize>5</LogRotateSize>     <!--максимальный размер лога в мегабайтах-->
    <LogRotateCount>5</LogRotateCount>   <!--максимальное количество файлов лога-->
    <MsgLanguage>ENG</MsgLanguage>
    <ConnectType>0</ConnectType>         <!--0- COM ; 1 - USB; 2 - TCP/IP ; 3 - BLUETHOOTH -->
    <COMnum>#</COMnum>                   <!--Номер COM порта, по которому подключен ФР -->
    <COMbaud>115200</COMbaud>
    <IPaddress>127.0.0.1</IPaddress>
    <IPport>1000</IPport>
    <BluetoothMAC></BluetoothMAC>
    <FNinstalled>1</FNinstalled>
    <UseFNserialN>0</UseFNserialN>
    <OFDunSendWarn>86400</OFDunSendWarn>  <!--(сек.) до вывода предупреждения о неотправленном чеке в ОФД-->
    <OFDunSendErr>0</OFDunSendErr>        <!--(сек.) до блокирования работы, если чек не отправлен в ОФД-->
    <OFDсhannelLib>1</OFDсhannelLib>      <!--использование библиотеки fptr.dll для связи с ОФД-->
  </Parameters>
</xmlConfig>

Коды налогов в ФР:

0 - none   - Без НДС     (тег 1105)
1 - vat0   - НДС 0%      (тег 1104)
2 - vat10  - НДС 10%     (тег 1103)
3 - vat18  - НДС 18%     (тег 1102)
4 - vat110 - НДС 10/110  (тег 1107)
5 - vat118 - НДС 18/118  (тег 1106)
6 - vat20  - НДС 20%      
7 - vat120 - НДС 20/120  

ВАЖНО! Применение налоговых ставок НДС 5% и 7% с 01.01.2025 года.

Внимание! Начиная с версии UrunPos.dll 2.13 вместо параметра TaxIndexDef код налога по умолчанию прописывается в секции [TranslateVATNumberToTaxIndex]  UrunPos.ini

;Код налога в Абонементе = код налога в ФР АТОЛ
[TranslateVATNumberToTaxIndex]
;Не облагается
0=0
;0%
1=1
;10%
2=2
;18% // ранее это была ставка 18%, которая теперь не актуальна
3=3
;10/110
4=4
;18/118 // ранее это была ставка 18/118, которая теперь не актуальна
5=5
;20%
6=6
;20/120
7=7
;5%
8=8
;5/105
9=9
;7%
10=10
;7/107
11=11

Возможные ошибки:

Неожиданное прерывание...

Причина/Решение:

Не установлен параметр 

• [Main] DefaultTaxValue=-1  в файле URunPos.ini 
  
  
• [pos] PosCreateOrderMode=1 в abonementmanager.ini

Не инициализирован ФР

• Переустановить драйвер на x32.  
• Добавить в папку EXE файлы fptr10.dll и fptr10_gui.dll из папки Program Files (x86)\ATOL\Drivers10\KKT\bin
• Убедиться, что в системе не осталась служба старого драйвера.
• Убедиться, что в параметрах киоска в Абонементе не прописан  *ini для старого драйвера.

Для актуальных версий обязательно учесть:

5.1. УНП формируется автоматически в БП/БЧ, если фискальный регистратор поддерживает функцию "CreateOrder"
  Новый УНП создается при регистрации платежа, при возвратах, при продаже услуг и абонементов в БП/БЧ.
  Эти УНП открываются при начале формирования чека и закрываются после печати фискального чека.
  Особый вид УНП - УНП долга. На фолио гостя может быть только одно открытое УНП долга 
  Долг - это наличие на фолио гостя неоплаченных услуг или абонементов.
  УНП долга открывается (создается, если нет открытого) :
    а) При регистрации услуг/абонементов по кнопке "Пречек"
    б) При оплате неоплаченных услуг
    в) При оплате неоплаченных абонементов
  В случаях а,б) после оплаты проверяется, остался ли долг. Если долга нет, то УНП закрывается
  УНП не является обязательным атрибутом чека.
  Несколько фискальных чеков могут иметь один УНП
5.2.
  Новый параметр в abonementmanager.ini
[pos]
PosCreateOrderMode - правило получения УНП
PosCreateOrderMode=0 - УНП выдает ФР
PosCreateOrderMode=1 - УНП генерируется программой в формате IDКиоска-IDПользователя-GetTickCount
При других значениях PosCreateOrderMode - УНП не генерируется

Штрих-М. Передача тега 1163 (Маркировка ФФД 1.2) через Тест Драйвера

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

 

Здесь описано что делать после того как подготовились к работе, завели позицию через Тест Драйвера ФР и теперь требуется передать тег 1163 с помощью его же.

 

Если установлен Тест Драйвера версии 5.17 и выше, то сканировать код можно сразу в окно во вкладке КТ2, если сканер в клавиатурном режиме и передает символ GS.

 

Убедитесь что включена печать тегов в Таблице 17 Поле 25

0 - не печатать

1 - печатать

 

Ниже описание на примере Тестового ОФД. Тестовый ОФД бракует все Коды Маркировки как выбывшие или несуществующие, поэтому в каждом бумажном чеке написано КМ?

 

Если связь с интернетом есть, то будет печататься [М-], так как тестовый ОФД сигнализирует о том, что все коды выбыли.

 

Если связи с интернетом нет, то будет печататься [М], так как аппарат не может ни подтвердить ни опровергнуть что код плохой

Пачка сигарет

Считываем код в notepad++

Вне зависимости настроен ли сканер на чтение символа-разделителя или нет, считается правильно, так как в коде пачки сигарет нет символов-разделителей.

У нас получится:

00000046217141je+ySKSABoAb54O

Где 00000046217141 - GTIN

je+ySKS - код идентификации экземпляра товара

ABoA - Максимальная Розничная Цена. Не участвует в старых требованиях

b54O - крипто-информация. 

Заводим позицию и переходим во вкладку привязывания кода маркировки к позиции.

 

Считываем сканером и сразу передаем в данное окошко:

Табак не проверяется ФН, так как имеет короткий криптохвост. Поэтому пишется "КМ данного типа не подлежит проверке в ФН" и "код маркировки не может быть проверен".

 

В ФН запишется так:

Обратите внимание, что признак предмета расчета у табака 2 - подакцизный товар

А на печать выйдет так:

Блок сигарет

Считываем код блока сигарет через notepad++

Если сканер настроен неверно, то у нас получится:

Если сканер настроен правильно, то у нас получится:

 

0104640030090839210001+n0800514500093zBLp

Где 04640030090839 - GTIN

0001+n0 - код идентификации экземпляра товара

145000 - Максимальная Розничная Цена за блок в не кодированном виде с копейками. 

zBLp 

 

Добавляем символ 

<0x1D> 

перед “8005” и шести знаков после “8005”:

0104640030090839210001+n0<0x1D>8005145000<0x1D>93zBLp

Код не подлежит проверке в ФН

В фн запишется так:

Распечатается так:

 

Обувь 

 

Считываем код коробки обуви через notepad++

Если сканер настроен неверно, то у нас получится:

Если сканер настроен правильно, то у нас получится:

У нас получится:

010290000000776521&d>V)0S>8fqDt91802392HUwL7ZRe79iU1uDW29owQD7VlDJa3Y5kDwEOwoD56cLGDMpYqjdID1dj+CCSmcrKLcnDlNDbMO4ZQLOTwTPaEg==

Где 02900000007765 - GTIN, а &d>V)0S>8fqDt - код идентификации экземпляра товара

Перед 91 и перед 92 ставим символ <0x1D>:

010290000000776521&d>V)0S>8fqDt<0x1D>918023<0x1D>92HUwL7ZRe79iU1uDW29owQD7VlDJa3Y5kDwEOwoD56cLGDMpYqjdID1dj+CCSmcrKLcnDlNDbMO4ZQLOTwTPaEg==

Код проверки подлежит проверке в ФН, но у данного экземпляра МГМ нет ключа проверки, возможно, потому что код старый (2019 год).

 

 

Еще пример:

010123456789012321soTr9,r!/bMc3r91005892pRJrcYZjki4XIC0ts7MMAE4xs18rlFDHLWypN/TaTckLbz919gqHTlIqi+ONEIOwxSRjBplVPfzIg4dPvFRxRg==

Добавляем разделители перед “91” и “92”:

010123456789012321soTr9,r!/bMc3r<0x1D>910058<0x1D>92pRJrcYZjki4XIC0ts7MMAE4xs18rlFDHLWypN/TaTckLbz919gqHTlIqi+ONEIOwxSRjBplVPfzIg4dPvFRxRg==

Данная категория товаров подлежит проверке в ФН.

В ФН запишется так:

Напечатается так:

Шины, Лекарства, Парфюм, Текстиль

Считываем код через notepad++

Если сканер настроен неверно, то у нас получится:

Если сканер настроен правильно, то у нас получится:

 

У нас получится:

010641944025951221s40h&'LFSH_pY91TEST92dGVzdKk/OuKnAGLc70iJZ784IB9k5tgsGdvmX4hN+mQ=

Где 06419440259512 - GTIN, а s40h&'LFSH_pY - код идентификации экземпляра товара

 

Перед 91 и перед 92 ставим символ <0x1D>:

010641944025951221s40h&'LFSH_pY<0x1D>91TEST<0x1D>92dGVzdKk/OuKnAGLc70iJZ784IB9k5tgsGdvmX4hN+mQ=

 

Код проверки не подлежит проверке в ФН, так 44 символьные коды проверки не подлежат проверке в ФН

 

Еще примеры:

Одежда:

Шины:

Лекарства:

Фототовары

Считываем код через notepad++

Если сканер настроен неверно, то у нас получится:

Если сканер настроен правильно, то у нас получится:

010290000005737121oUbNp4ImG7'3xa.R'X:W91TEST92dGVzdOmMebPKZi7YvQhSZnNuz4pbVmlMw/vkk3TktoA=

Где 

02900000057371 - GTIN,

oUbNp4ImG7'3xa.R'X:W - код идентификации экземпляра товара

 

Добавляем символ разделитель <0x1D>:

010290000005737121oUbNp4ImG7'3xa.R'X:W<0x1D>91TEST<0x1D>92dGVzdOmMebPKZi7YvQhSZnNuz4pbVmlMw/vkk3TktoA=

 

Фототовары не подлежат проверке в ФН. ОФД тестовый, поэтому проверка на сервере ОИСМ провалена.

Распечатается так:

В ФН запишется так:

 

Молочная продукция

Считываем код через notepad++

Если сканер настроен неверно, то у нас получится:

Если сканер настроен правильно, то у нас получится:

 

0104603745968015215YJF"Z93NGv1

 

Где 

02900000057371 - GTIN,

5YJF"Z - код идентификации экземпляра товара

NGv1 - крипто-информация

 

Перед 93 ставим символ разделитель <0x1D>:

0104603745968015215YJF"Z<0x1D>93NGv1

 

Молочная продукция не подлежит проверке в ФН.

 

В ФН запишется так:

Распечатается так:

Так как ОФД Тестовый, то код не прошел онлайн-проверку и распечаталась [М-]КМ?

 

Средства защиты

                   Берем постановление и копируем любой из кодов.

Можно также сгенерировать его в EAN-13  и считать сканером:

2400001225606

Передаем как есть:

Так как это не является маркированной продукцией, то проверки в ФН не проводится и буквы [М] напечатано не будет.

В ФН запишется так:

Про символ GS, он же <0x1D>

Это является обычным управляющим символом в кодировке ASCII, а точнее символом-разделителем.

Чтобы его ввести, нужно включить NUM на клавиатуре, зажать клавишу ALT и нажать на Num-паде 0, потом 2, потом 9, а затем отпустить клавишу ALT.

Виден он будет только в notepad++:

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

Он уже зашифрован в QR-код, однако сканера по умолчанию не настроены на передачу после считывания управляющих символов.

Например в сканерах наших партнеров VMC для его считывания нужно включить опцию тут:

И сохранить настройки в сканер.

 

На сайте Честного Знака проверка сканера работает плохо:

https://честныйзнак.рф/barcode/

 

Нужно проверять с помощью notepad++

Запустите программу и считайте марку.

Сканер к маркировке готов:

Присутствует символ-разделитель

 

Сканер к маркировке не готов:

Нет символов-разделителей. Нужно обращаться в техническую поддержку по сканерам и запрашивать как настраивать его для работы с маркировкой.

 

Для некоторых сканеров уже заготовлены настроечные коды, которые нужно считать, на сайте честного знака:

https://честныйзнак.рф/barcode/

https://xn--80ajghhoc2aj1c8b.xn--p1ai/barcode/

выберите категорию товаров и внизу будет список сканеров с документацией на них:

 

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

Называться он может:

Вывод с помощью alt-кодов

 

Выполните поиск по инструкции к сканеру:

Acsii

Alt

и найдите нужную настройку.

 

Если взять и скопировать значение с символами-разделителями из notepad++ и вставить в Тест Драйвера, то тот его примет без ошибок и без необходимости вручную вставлять символ <0x1D>:

 

Всего примерно три способа передать невидимые символы и этот символ-разделитель:

 

Первый и самый правильный - использовать сканер в интерфейсе rs232 или usb-com. В данном случае данные из datamatrix-кода передаются в кассовую программу ровно как они есть без всякой обработки. В том числе спецсимвол передается в явном виде 1d hex.

 

При использовании клавиатурного интерфейса начинаются проблемы. Просто потому, что на клавиатуре нет клавиши 1d.  Есть два обхода : заменять этот код на комбинацию обычных кнопок. Или передавать не коды клавиш, а alt-коды.

Отключение печати бумажных чеков ПО Абонемент

Печать чека только для клиента без телефона/почты.

(!) Печать банковских слипов отключается через службу поддержки банка.

В uRunPos.ini на рабочем месте настройка "Не печатать бумажный чек, если возможно".
Если эта настройка установлена, и у плательщика заполнен номер телефона или E-Mail, то Абонемент будет передавать признак "Не печатать бумажный чек".
Не печатать бумажный чек можно только в том случае, если у плательщика корректно заданы "Номер телефона" или "E-Mail".
В противном случае будет ошибка печати чека.

"Номер телефона" или "E-Mail" могут быть внесены как в анкете клиента, так и в окне оплаты.

Реализовано в URunPos.dll версии 2.7.0.2
Настройка вносится строго в файл urunpos.ini !!! (даже если он разделен на несколько ФР):
В секции [CustomProp] появилась настройка ElectronicCheckDesirable (Не печатать бумажный чек, если возможно).

URunPos.ini:

[CustomProp]
; 1 - Не печатать бумажный чек, если задан телефон или E-Mail плательщика. 0 - печатать бумажный чек всегда (по умолчанию)
ElectronicCheckDesirable=1

[ReplacePhonePrefix]
;Если номер начинается на 810 , то он заменится на +
810=+

;Если номер начинается на 8 , то он заменится на +7
8=+7

;Если номер начинается на 9 , то он заменится на +79
9=+79

 

Предыдущее исправление, для вариантов написания номеров телефонов:

Секция [ReplacePhonePrefix] в ini-файле драйвера ФР
ФР требует корректный номер телефона. Корректный номер телефона начинается с "+".
Секция позволяет преобразовать номер телефона к корректному виду

Пример:

[ReplacePhonePrefix]
810=+ Если номер начинается на 810 , то он заменится на +
8=+7 Если номер начинается на 8 , то он заменится на +7
9=+79 Если номер начинается на 9 , то он заменится на +79

Если в секции нет параметров, то преобразование осуществляется по принципу, как в примере.
Если в результате преобразований номер будет без ведущего "+", то "+" будет установлен первым символом.

Настройка Абонемент:
Обновления 124
1. Настройки
1.1. Общие параметры
1.1.1. Услуги и платежи
1.1.1.1. Упорядочены параметры, относящиеся к фискальным регистраторам
1.1.1.1.1. Создана группа "Фискальный регистратор (ФР)"
1.1.1.1.1.1. Новый параметр "ФР может отправлять чеки по E-Mail". Для целей ФЗ-54 и отправки клиентам содержимого чека на E-Mail, используя ФР и ОФД (оператор фискальных данных)
1.1.1.1.1.2. Новый параметр "ФР может отправлять чеки по SMS". Для целей ФЗ-54 и отправки клиентам содержимого чека на телефон, используя ФР и ОФД (оператор фискальных данных)

1.1.2 Вкладка Гость - Поля Формат телефоны.

Вписать:

!#9\(999\)000-00-00;0;_

(!) Не вписывайте форматы вида "+70000000000", "+7_________" и т.д., иначе при отсутствии номера в соответствующем поле в окне оплаты - чек не напечатается и не отправится.

 

ВНИМАНИЕ! Данная функция отключит печать чеков/отчетов полностью:

В таблице Штриха (таблица 17, строка 7, значение 2) можно отменить печать бумажных чеков и формировать их только электронно. 

 

Проверено на версиях:

Для АТОЛА (прошивка 7651, платформа - 5):

fpRU_AtolDTO.dll - 7.62.71.0
fptr10.dll - 10.9.2.3
URunPos.dll - 2.9.0.9

Для Штриха: 

Версия ПО : C.3
Сборка ПО : 45864
Дата ПО : 20.12.2021
Драйвер ККТ х64 5.16.0.877
fpShtr54.dll 7.62.127.0
URunPos.dll 2.9.0.9

AtolCloud Подключение облачной фискализации

https://atol.online/

Сервис АТОЛ Онлайн фискализирует запросы, которые поступают из внешней системы пользователя ККТ.

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

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

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

ФФД 1.2   API V5

Лицензия - Проект 5 Модуль 1. Абонемент модуль Интерфейс Атол-онлайн (CloudKassir) ПО

Добавили возможность работать с  новыми ставками НДС (5% и 7%) для соответствия актуальным требованиям законодательства.
Описание протокола: API V5 ФФД 1.2

• Connecter -  1.76 и выше
• URunPos.dll - 2.14.0.3
• fpCloudAtol.dll - 1.5.0.5

...\FullVersion\_INTERFACE\POS\fpCloudAtol

Все dll должны быть размещены в папке Connecter.

Настройки

В настройках ПО Абонемент должен быть включен "Контроль ФФД" и Отправка чеков по телефону/email. В карточках услуг должны быть проставлены коды налогов и СНО, Признак предмета расчета.  У клиентов должны быть указаны телефон/email.

connecter.ini

Секция [pos] 

RunPosDllName=Urunpos.dll

Секция [defaults]

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

DefaultPayCode=901
STDKIOSKCODE=1

UrunPos.ini

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

[TranslateTaxRateIndexToVat]
;Код налога в карточке услуги = Код налога в системе CloudAtol
0=none
1=vat0
2=vat10
3=vat18
4=vat20
5=vat110
6=vat118
7=vat120
8=vat5
9=vat105
10=vat7
11=vat107

[TranslateTaxTypeToSno]
;Код СНО в карточке услуги  = sno в системе cloudAtol
0=osn
1=usn_income
2=usn_income_outcome
3=envd
4=esn
5=patent

fpCloudAtol.ini

Секция [BILL] заполняется автоматически при продажах. Секции налогов и СНО те же, что в  UrunPos.ini

[BILL]
LastDocNumber=
LastReceipt=
LastReceiptNumber=

[TranslateTaxRateIndexToVat]
;Код налога в карточке услуги = Код налога в системе CloudAtol
0=none
1=vat0
2=vat10
3=vat18
4=vat20
5=vat110
6=vat118
7=vat120
8=vat5
9=vat105
10=vat7
11=vat107

[TranslateTaxTypeToSno]
;Код СНО в карточке услуги  = sno в системе cloudAtol
0=osn
1=usn_income
2=usn_income_outcome
3=envd
4=esn
5=patent

urunpos_frxml_CloudAtol.xml

Ваши регистрационные данные Атол Онлайн.

Company_INN _ _ _ _ _ _ _ _ — ИНН
API_URL https://online.atol.ru/possystem/v5/ — Адрес API
API_GROUP _ _ _ _ _ _ — Группа
API_Login _ _ _ _ _ _ — Логин доступа к API
Company_PaymentAddress — _ _ _ _ _ _ — Платежный адрес вашей компании
API_Password _ _ _ _ _ _ — Пароль доступа к API

DurationWaitProcessed -  максимальное время ожидания фискализации чека, сек.

Пароль в xml  файле хранится в зашифрованном виде. Что бы его зашифровать необходимо при первом запуске вместо <API_Password>Ваш пароль</API_Password> добавить параметр                                      <NewPassword>Ваш пароль</NewPassword>

При первом запуске пароль зашифруется, а параметр "NewPassword" удалится.

Пример для подключения к тестовой среде API V5 Атол Онлайн:

<xmlConfig ProtocolVersion="46">
	<Parameters>
		<Company_INN>5544332219</Company_INN>
		<API_URL>https://testonline.atol.ru/possystem/v5/</API_URL>
		<API_GROUP>v5-online-atol-ru_5179</API_GROUP>
		<API_Login>v5-online-atol-ru</API_Login>
		<DurationWaitProcessed>360</DurationWaitProcessed>
		<Company_PaymentAddress>https://v5.online.atol.ru</Company_PaymentAddress>
		<API_Password>Oqc4SLOy8E8=</API_Password>
	</Parameters>
</xmlConfig>

Проверить корректность подключения можно в testConnecter.exe. Пример запроса для внесение аванса:

<?xml version="1.0" encoding="windows-1251"?>
<REQUEST TRANSFORMSCHEMA="">
    <FUNCNAME>FOLIO_PAYMENT</FUNCNAME>
    <PARAMETERS>
        <GUEST>1003</GUEST>
        <COST>100</COST>
        <INFO>test connecter</INFO>
        <ADVANCENAME>Advance</ADVANCENAME>
        <PAYCODE>901</PAYCODE>
        <PHONE1>+7_______</PHONE1>           - введите корректный номер
        <EMAIL>__________</EMAIL>            - введите корректный email
        </PARAMETERS>
</REQUEST>

ФФД 1.05 (без новых налоговых ставок НДС) API V4

Описание протокола:  API V4 ФФД 1.05

• Connecter -  1.76
• URunPos.dll - 2.9.0.9
• fpCloudAtol.dll - 1.4.0.4

connecter.ini

Секция [pos] 

RunPosDllName=Urunpos.dll

Секция [defaults]

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

DefaultPayCode=901
STDKIOSKCODE=1

UrunPos.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

fpCloudAtol.ini

Секция [BILL] заполняется автоматически при продажах.

[BILL]
LastDocNumber=
LastReceipt=
LastReceiptNumber=

urunpos_frxml_CloudAtol.xml

Ваши регистрационные данные Атол Онлайн.

Company_INN _ _ _ _ _ _ _ _ — ИНН
API_URL https://online.atol.ru/possystem/v4/ — Адрес API
API_GROUP _ _ _ _ _ _ — Группа
API_Login _ _ _ _ _ _ — Логин доступа к API
Company_PaymentAddress — _ _ _ _ _ _ — Платежный адрес вашей компании
API_Password _ _ _ _ _ _ — Пароль доступа к API

DurationWaitProcessed -  максимальное время ожидания фискализации чека, сек.

Пароль в xml  файле хранится в зашифрованном виде. Что бы его зашифровать необходимо при первом запуске вместо <API_Password>Ваш пароль</API_Password> добавить параметр                                      <NewPassword>Ваш пароль</NewPassword>

При первом запуске пароль зашифруется, а параметр "NewPassword" удалится.

Пример для подключения к тестовой среде API V4 Атол Онлайн:

<xmlConfig ProtocolVersion="46">
	<Parameters>
		<Company_INN>5544332219</Company_INN>
		<API_URL>https://testonline.atol.ru/possystem/v4/</API_URL>
        <API_GROUP>v4-online-atol-ru_4179</API_GROUP>
		<API_Login>v4-online-atol-ru</API_Login>
		<API_Password>sbwby37V1DjS8oPeOLklKw==</API_Password>
		<DurationWaitProcessed>300</DurationWaitProcessed>
		<NPassword>iGFFuihss</NPassword>
	</Parameters>
</xmlConfig>

Ошибки

1. В случае ошибки токена с кодом "11", происходит повторный запрос токена и повторно отправляется команда
2. В случае ошибки с кодом "34"("Состояние чека не найдено. Попробуйте позднее."), отправляется повторный запрос через таймаут

https://online.atol.ru/files/ffd/test_sreda.txt

Адрес тестовой среды (ФФД 1.05):
https://testonline.atol.ru/possystem/v4/

Тестовые данные:
∙ Компания: АТОЛ
∙ ИНН: 5544332219
∙ Адрес расчетов: https://v4.online.atol.ru
∙ Код группы: v4-online-atol-ru_4179
∙ Логин: v4-online-atol-ru
∙ Пароль: iGFFuihss

Проверка чека в Первый ОФД
https://consumer.1-ofd-test.ru/v1?fn=9999078902010421&fp=2680485228&i=1545
где
fn=Номер ФН - "fn_number"
fp=ФПД - "fiscal_document_attribute"
i=Номер ФД - "fiscal_document_number"

-------------------------------------------------------------------------------------------

Адрес тестовой среды (ФФД 1.2):
https://testonline.atol.ru/possystem/v5/

Тестовые данные:
∙ Компания: АТОЛ
∙ ИНН: 5544332219
∙ Адрес расчетов: https://v5.online.atol.ru
∙ Код группы: v5-online-atol-ru_5179
∙ Логин: v5-online-atol-ru
∙ Пароль: zUr0OxfI

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

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

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

              2) 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

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

Возврат чека на ККТ Атол через ДТО

Осуществлять возврат лучше всего в отдельной смене.

Если смена открыта - закрыть смену и открыть для проведения возврата.

При закрытии смены может произойти инкасация (зависит от настроек Параметры KKT - Основные), сооветственно наличности для осуществления возврата в кассе может не оказаться ( при оплате наличными ). 

После осуществления возврата - обязательно закрыть смену (Z-отчет).

Выполнять в последовательности, представленной на скрине:

После проделанных действий - проверить правильность на чеке (если производилось удаленно - запросить фото чеков и Z-отчета). 

ФФД 1.2

Штрих-М.
Для работы с ФФД 1.2 необходимо проставить:
В карточке услуги:
 - Код налога ФР
 - СНО
 - ППР
В Платежах и услугах:
 - Использовать СНО
 - Контролировать ФФД

Штрих-М (Shtrih-m) 09h: ФП - Некорректная длина команды [200]

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

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

Также необходимо знать: если у ВАС имеется ФН на 36 мес + СНО ОСН , то реализация продажи товара невозможна.

Дополнительная информация по ссылкам:
https://kkmspb.ru/kontrolno-kassovaya-tehnika-online/fiskalny-nakopitely/first-problem-with-FH36-FN15.php
https://kontur.ru/ofd/news/6143

АТОЛ. Работа с маркированной продукцией. Честный Знак.

С 6 августа 2021 года ввден новый формат фискальных документов — ФФД 1.2. На него должны перейти те, кто продает обязательные к маркировке товары, учитываемые в системе «Честный ЗНАК».

Зачем нужен этот новый формат и как на него перейти? Приказ ФНС от 14.09.20 № ЕД-7-20/662@

Требуется:

• URunPos (вер. не ниже 2.14.0.3)
  
• fpRU_AtolDTO.dll (вер. не ниже 7.72.122.0)
• Драйвер АТОЛ (fptr10.dll вер. не ниже 10.10.5.0)
• Прошивка 5.8.12

Настройки для разрешительного режима по ссылке

Прочие инструкции для работы с "Честным знаком":

• Настройка кодов и сканера
• Разрешительный режим
• "Честный знак" и GTIN из RK7 в Абонемент
• Модуль работы с маркированной продукцией "Честный Знак"

Настройка параметров работы с ИСМ.

Драйвер АТОЛ - Параметры ККТ - Таблица 26.

• При регистрации ККТ необходимо заполнить дополнительные реквизиты.
  Адрес и Порт ИСМ. Ввести URL- или IP-адрес сервера ИСМ (0..64 символа) и последовательный номер порта, через который будет осуществляться обмен данными с ИСМ.
  Информация предоставляется ИСМ. Эти данные необходимо уточнить у оператора ОФД.
• Адрес и Порт ОКП. Ввести адрес сервера для выполнения обновления ключей проверки и последовательный номер TCP-порта, через который будет осуществляться обмен данными.
  Информация предоставляется ОКП.

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

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

После того, как кассир пробьёт маркированный товар, касса отправит данные в «Честный знак», и при печати на чеке появится одно из следующих обозначений:

• [М+] — товар проверен и успешно отправлен в «Честный знак».
• [М-] — товар не прошёл проверку в системе «Честный знак» и его нельзя продать.
• [М] — товар не прошёл проверку и не был передан в «Честный знак», необходимо пробить товар повторно (возможно, не было связи с интернетом или касса работала в автономном режиме)

Провести проверку связи ИСМ. В случае ошибок - обращаться в ЦТО

АТОЛ Центр загрузок

Честныйзнак.рф_Атол_Инструкция

ШТРИХ, Подключение к ПО Абонемент

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

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

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

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

;Штриховой код, за секцию отвечает 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%

;Оплата картой 2 Аванс
CardSum2TypeIndex = 14

ВАЖНО

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

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

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

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

init.xml

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

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

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

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

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

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

Штрих: Как распечатать чек с Агентскими реквизитами ФФД 1.2?

Руководство по пробитию чека на кассе Штрих по Агентской схеме через Тест Драйвера ККТ

• заполните следующие поля:

1. впишите наименование товара/услуги;
2. впишите цену товара/услуги;
3. впишите количество товаров/услуг;
4. выберите Тип позиции (Приход, Расход...);
5. выберите Признак способа расчета из выпадающего списка (Полный расчет);
6. выберите Признак предмета расчета из выпадающего списка (Товар, Услуга);
7. выберите Налог из выпадающего списка;
8. выберите Отдел (По умолчанию нулевой отдел);
9. нажмите кнопку Открыть чек;
10. нажмите кнопку Добавить позицию v2 (если нажать кнопку "Добавить позицию v2);
11. нажмите на вкладку Агент вверху;

 

Дальше введите только ваши актуальные данные:

1. выберите пункт Передавать теги в составе позиции;
2. поставьте галочку напротив вида вашей агентской деятельности;
3. нажмите кнопку Передать признак агента;
   
   
4. введите телефон оператора перевода;
5. введите оператора плат. агента;
6. введите телефон плат. агента;
7. введите телефон оператора по приему платежей;
8. введите наименование оператора перевода;
9. введите адрес оператора перевода;
10. введите ИНН оператора перевода;
11. нажмите кнопку Передать данные агента;
    
    
12. введите ИНН поставщика;
13. нажмите кнопку Передать ИНН поставщика;
    
    
14. введите телефон поставщика;
15. введите наименование поставщика;
16. нажмите кнопку Передать данные поставщика;
17. нажмите на вкладку Операции ФН вверху;

1. введите сумму в поле Наличные или Безналичные;
2. выберите вашу систему налогообложения из выпадающего списка;
3. нажмите на кнопку Закрытие чека расширенное v2.

• ожидайте печать чека и проверьте данные на распечатанном чеке.

ОФД: список настроек для регистрации касс

Список всех ОФД с настройками для подключения и регистрации касс

Рабочие сервера

Тестовые сервера

Данные адресов серверов обновления ключей проверки ФН

Применение налоговых ставок НДС 5% и 7% с 01.01.2025 года.

С 01.01.2025 будут увеличены ставки налога на прибыль организаций

Уточнение по порядку применения налоговых ставок 5%-7%  с 01.01.2025 года в программном обеспечении ПО Абонемент.

Согласно документу «Методические рекомендации по НДС для УСН», опубликованным ФНС (https://data.nalog.ru/html/sites/www.new.nalog.ru/files/about_fts/docs/15318056.pdf), а именно в п. 26 рекомендаций, указан следующий порядок действий:
« ...26. Порядок применения чеков ККТ налогоплательщиками УСН, которые обязаны исчислять и уплачивать НДС в бюджет с 01.01.2025 С 01.01.2025 налогоплательщики УСН, которые обязаны исчислять и уплачивать НДС в бюджет, осуществляющие расчеты с применением ККТ и выбравшие уплату НДС по специальной ставке (5% или 7%), должны перейти на указание новых ставок НДС в кассовых чеках в соответствии с изменениями, вносимыми в Приказ ФНС России от 14.09.2020 № ЕД-7-20/662@. Однако, если разработчики ККТ к 01.01.2025 не предоставят обновленную прошивку ККТ, поддерживающую указание в кассовом чеке специальных ставок по НДС, то пользователи таких ККТ могут временно продолжить формировать кассовые чеки по прежним правилам с использованием реквизитов «сумма расчета по чеку без НДС» (тег 1105) и «сумма расчетов без НДС» (тег 1183) до выхода соответствующего обновления. При этом сумма расчета должна включать в себя НДС по специальным ставкам (5% или 7%). После появления обновленной прошивки ККТ, поддерживающей специальные ставки НДС, пользователям необходимо начать формировать кассовые чеки с указанием новых ставок НДС.».

Изменения в настройках ПО Абонемент на 25.12.2024

abonementmanager.ini

[pos]
PosCreateOrderMode=1
;0 - УНП выдает ФР
;1 - УНП генерируется программой в формате IDКиоска-IDПользователя-GetTickCount
;При других значениях PosCreateOrderMode - УНП не генерируется

С версии fpRU_AtolDTO.dll  -  7.72.149 данный параметр не требуется.

АТОЛ Основные настройки

Прошивка модуля ККТ -  версия 5.15

Драйвер (fptr10)-  версия 10.10.6.0 x32

URunPos.dll  -  2.14.0.3

fpRU_AtolDTO.dll  -  7.72.149

ВАЖНО! При проведении возвратов операций, совершенных со старой библиотекой fpRU_AtolDTO.dll  до версии  7.72.147 может возникнуть ошибка.

UPD. Вышла новая версия fpRU_AtolDTO.7.72.149.0.  -  Ошибка исправлена.

Новое сопоставление кодов налога в ФР

 0 - НДС не облагается 
 1 - НДС 0%
 2 - НДС 10%
 3 - НДС 20% // ранее это была ставка 18%, которая теперь не актуальна
 4 - НДС 10/110
 5 - НДС 20/120 // ранее это была ставка 18/118, которая теперь не актуальна
 6 - НДС 20%
 7 - НДС 20/120
 8 - НДС 5%
 9 - НДС 5/105
10 - НДС 7%
11 - НДС 7/107

Внимание! Начиная с версии UrunPos.dll 2.13 вместо параметра TaxIndexDef код налога по умолчанию прописывается в секции [TranslateVATNumberToTaxIndex]

Пример АТОЛ:

;Код налога в Абонементе = код налога в ФР АТОЛ
[TranslateVATNumberToTaxIndex]
;НДС не облагается 
0=0

;НДС 0%
1=1
;НДС 10%
2=2
;НДС 20% // ранее это была ставка 18%, которая теперь не актуальна
3=3
;НДС 10/110
4=4
;НДС 20/120 // ранее это была ставка 18/118, которая теперь не актуальна
5=5
;НДС 20%
6=6
;20/120
7=7
;НДС 5%
8=8
;НДС 5/105
9=9
;НДС 7%
10=10
;НДС 7/107
11=11

ШТРИХ

Прошивка модуля ККТ -  версия С.3 от 08.01.2025 (ФФД 1.2) или С.1 от 10.01.2025 (ФФД 1.05) https://doc.shtrih-m.ru/

Драйвер -  версия DrvFR_5.18_1062_x32

URunPos.dll  -  2.14.0.3

fpShtr54.dll  -  7.72.199

Номера налоговых групп:
  1 - НДС 18%
  2 - НДС 10%
  3 - НДС 0%
  4 - БЕЗ НДС
  5 - НДС 18/118
  6 - НДС 10/110
  7 - НДС 5%
  8 - НДС 7%
  9 - НДС 5/105
 10 - НДС 7/107

Пример ШТРИХ

;Код налога в Абонементе = код налога в ФР ШТРИХ
[TranslateVATNumberToTaxIndex]
;По умолчанию
0=0 

;НДС 20%
1=1
;НДС 10%
2=2
;НДС 0%
3=3
;БЕЗ НДС
4=4
;НДС 20/120
5=5
;НДС 10/110
6=6
;НДС 5%
7=7
;НДС 7%
8=8
;НДС 5/105
9=9
;НДС 7/107
10=10

Если на объекте используется и Атол, и Штрих: Если в карточке услуги уже проставлен "Код налога ФР - 8" (Атол 5%), то в ini-файле Штриха сопоставляете его с нужным вам кодом из таблицы Штриха -  8=7 для 5%. 

Для 5/105 и 7/107 соответствующие коды выставляются в карточке Платежа.

Для отображения ставки НДС в отчетах FReport необходимо в карточке услуги установить параметр «НДС - TAX5», предварительно добавив его в справочник.