Плагин для работы с ПО IIKO: различия между версиями

Материал из CUSTOM KKT WIKI
Перейти к навигации Перейти к поиску
Нет описания правки
Нет описания правки
 
(не показано 40 промежуточных версий этого же участника)
Строка 1: Строка 1:
__TOC__
__TOC__
[[Файл:IIKO.png|альт=IIKO|мини|IIKO]]
[[Файл:IIKO.png|альт=IIKO|мини|IIKO]]
Плагин, необходимый для работы фискального устройством CUSTOM Q3X-Ф и ПО IIKO.
Плагин, необходимый для работы фискального устройства [[CUSTOM Q3X-Ф]] и ПО IIKO.


Плагин устанавливается в директорию: <code>C:\Program Files\iiko\iikoRMS\Front.Net\Plugins</code> и хранит логи в директории: <code>C:\Users\**USERNAME**\AppData\Roaming\iiko\CashServer\Logs</code>
Плагин устанавливается в директорию: <code>C:\Program Files\iiko\iikoRMS\Front.Net\Plugins</code> и хранит логи в директории: <code>C:\Users\**USERNAME**\AppData\Roaming\iiko\CashServer\Logs</code>
----


Последняя актуальная версия, доступная для скачивания:<gallery mode="nolines">
<youtube>https://www.youtube.com/watch?v=BBtbJK6b2gI</youtube>
Файл:Resto.Front.Api.PrinterCustom.V7.1.2.18-alpha.zip|alt=Resto.Front.Api.PrinterCustom.V7.1.2.18-alpha|Resto.Front.Api.PrinterCustom.V7.1.2.18-alpha
</gallery>


== Подготовка к работе ==
== Подготовка к работе ==
Для начала работы с ККТ CUSTOM Q3X-Ф, необходимо:
Для начала работы с ККТ [[CUSTOM Q3X-Ф]], необходимо:


* Подключить ККТ к ПК;
* Подключить ККТ к ПК;
Строка 19: Строка 16:
Убедиться, что на ККТ установлена актуальная версия ПО, для этого:
Убедиться, что на ККТ установлена актуальная версия ПО, для этого:


Запустить тестовую утилиту, подключиться к ККТ и в правом верхнем углу, в строке «ПО», будет показана версия ПО ККТ, как показано на рисунке 1.
Запустить [[Fiscal.RUSProtocolTEST|тестовую утилиту]], подключиться к ККТ и в правом верхнем углу, в строке «ПО», будет показана версия [[ПО ККТ]], как показано на рисунке 1.
[[Файл:Версия ПО ККТ.png|альт=Рисунок 1. Версия ПО ККТ.|без|обрамить|Рисунок 1. Версия ПО ККТ.]]
[[Файл:Версия ПО ККТ.png|альт=Рисунок 1. Версия ПО ККТ.|без|обрамить|Рисунок 1. Версия ПО ККТ.]]
<pre style="color: red">
<pre style="color: red">
Версия ККТ, должна быть не ниже 5.ХХ.ХХ, например 5.02.02 или выше!
Версия ПО ККТ, должна быть не ниже 5.ХХ.ХХ, например 5.02.00 или выше!
</pre>
</pre>
<pre style="color: red">
<pre style="color: red">
Строка 29: Строка 26:


== Настройка кассира ==
== Настройка кассира ==
tbd
Для того, чтобы настроить кассира для работы с ПО IIKO, необходимо перейти на вкладку «Настройки ККТ» нажать кнопку «[[Программирование кассира|Запрограммир. Кассиров]]», в появившемся окне, кассиру с ID 2, присвоить код «'''88'''», пароль «'''8888'''» и нажать «Сохранить», как показано на рисунке 2. Имя кассира может быть любым, значение имени измениться при авторизации пользователя в ПО IIKO.
[[Файл:Настройка кассира IIKO.png|альт=Рисунок 2. Настройка кассира IIKO.|без|обрамить|Рисунок 2. Настройка кассира IIKO.]]
 
== Настройка параметров чека ==
После настройки кассиров, в этой же вкладке «Настройки ККТ» нажать кнопку «Параметры чека» и в появившемся окне, установить следующие настройки:
 
* «Всегда печатать номер позиции»
 
* «Печать данных напротив QR-Code»
 
* «Сжатие строки продажи (1) (без ‘отдела’)»
* При необходимости отключить флаги отвечающие за печать дополнительных тегов. Например, «Не печатать тег #1162 – Код товарной номенклатуры». При снятом флаге, в чеке будет печататься код маркированной продукции, например, код маркировки сигарет.
 
* При необходимости можно включить настройки, для сокращения размера чека: «Сжатие тела чека, кроме строки Наименование», «Сжатие итогов чека (сумма/сдача)», «Сжатие текста QR-Code». Остальные параметры оставить по умолчанию, как указано на примере ниже.
 
После установки всех необходимых настроек, нажать кнопку «Сохранить», как показано на рисунке 3.[[Файл:Настройка параметров чека IIKO.png|альт=Рисунок 3. Настройка параметров чека.|без|обрамить|Рисунок 3. Настройка параметров чека.]]
 
== Настройка конфигурации чека ==
Далее необходимо настроить конфигурацию чека, для этого на вкладке «Настройки ККТ» нажать кнопку «[[Конфигурация чека|Конфигурация Чека]]», установить параметры, как показано на рисунке 4 и нажать кнопку «Сохранить».
[[Файл:Настройка конфигурации чека IIKO.png|альт=Рисунок 4. Настройка конфигурации чека.|без|обрамить|Рисунок 4. Настройка конфигурации чека.]]
 
== Настройка заголовка чека ==
При необходимости настроить Заголовок чека и Сообщение в конце чека. На вкладке «Настройки ККТ» кнопки «Запрограммир. Заголовок» и «Сообщение в конце чека». Можно настроить до 9 строк, которые будут печататься в начале и в конце чека.
[[Файл:Настройка заголовка чека IIKO.png|альт=Рисунок 5. Настройка заголовка чека.|без|обрамить|Рисунок 5. Настройка заголовка чека.]]
[[Файл:Настройка сообщения в конце чека IIKO.png|альт=Рисунок 6. Настройка сообщения в конце чека.|без|обрамить|Рисунок 6. Настройка сообщения в конце чека.]]
{| class="wikitable"
|+
! colspan="2" |'''Параметр «Стиль» меняет стиль шрифта'''
|-
|0
|''Стандартный стиль''
|-
|2
|''Шрифт двойной высоты''
|-
|3
|''Шрифт двойной ширины''
|-
|4
|''Шрифт двойной ширины и высоты''
|-
|5
|''Жирный шрифт''
|-
|6
|''Сжатие по ширине''
|-
|7
|''Сжатие по ширине + жирный''
|-
|8
|''Курсив''
|-
|9
|''Сжатие по высоте''
|-
|10
|''Сжатие по высоте + двойная ширина''
|-
|11
|''Сжатие по высоте + курсив''
|}
{| class="wikitable"
|+
! colspan="2" |'''Параметр «Шрифт» меняет размер шрифта'''
|-
|0
|''Шрифт по умолчанию, размер шрифта 3 (16 CPI, 44 символа в строке)''
|-
|1
|''Размер шрифта 1 (16 CPI, 57 символов в строке)''
|-
|2
|''Размер шрифта 2 (17 CPI, 48 символов в строке)''
|-
|3
|''Размер шрифта 3 (16 CPI, 44 символа в строке)''
|-
|4
|''Размер шрифта 4 (15 CPI, 41 символ в строке)''
|-
|5
|''Размер шрифта 5 (13 CPI, 36 символов в строке)''
|}
 
<pre style="color: red">
Параметр «стиль» оказывает влияние на длину строки, например, жирный шрифт и шрифт двойной ширины сокращают длину строки в два раза.
</pre>
 
== Настройка передачи данных в ОФД ==
ККТ [[CUSTOM Q3X-Ф]] может [[Настройка передачи данных в ОФД|передавать данные в ОФД]] как через [[Настройка Ethernet|Ethernet-соединение]], так и через виртуальный COM-порт, используя службу «[[MSer2Ofd|MSer2OFD]]».
== Передача данных через Ethernet ==
На вкладке «Общие» нажать кнопку «[[Настройка Ethernet|Параметры Ethernet]]» и настроить параметры соединения.
[[Файл:Настройка параметров Ethernet IIKO.png|alt=Рисунок 7. Настройка параметров Ethernet.|без|обрамить|Рисунок 7. Настройка параметров Ethernet.]]Для автоматического получения настроек по DHCP, необходимо включить флаг «Разрешить DHCP» и нажать кнопку «Сохранить», как показано на рисунке 7. При ручных настройках данный флаг необходимо отключить.
[[Файл:Настройка USB-Профиля CDCMTP IIKO.png|альт=Рисунок 8. Настройка USB-Профиля.|без|обрамить|Рисунок 8. Настройка USB-Профиля.]]
Убедиться, что в настройках [[Настройка USB профиля|USB профиля]] выбран параметр «CDCMTP», как показано на рисунке 8.
[[Файл:Настройка параметров ОФД IIKO.png|альт=Рисунок 9. Настройка параметров ОФД.|без|обрамить|Рисунок 9. Настройка параметров ОФД.]]
Настроить [[Параметры ОФД|параметры сервера ОФД]]. Ввести хост и порт сервера ОФД, если ККТ работает в режиме [[Обновление ПО ККТ до версии 5.ХХ.ХХ и переход на ФФД 1.2|ФФД 1.2]], тогда необходимо ввести хост и порт ОИСМ и АС ОКП, нажать кнопку «Сохранить», как показано на рисунке 9. Перезапустить ККТ по питанию.
 
== Передача данных через виртуальный COM-Порт ==
Переключить [[Настройка USB профиля|профиль USB]] в режим «CDCCDC2» (два виртуальных Ком-порта) и нажать кнопку «Сохранить», как показано на рисунке 10.
[[Файл:Передача данных через виртуальный COM-Порт IIKO.png|альт=Рисунок 10. Настройка USB-Профиля.|без|обрамить|Рисунок 10. Настройка USB-Профиля.]]
Далее необходимо перезапустить ККТ по питанию и убедиться, что в системе появилось два COM-порта ККТ:
 
* '''Q3xF RU Virtual COM''' - используется для управления ККТ;
 
* '''Q3xF RU OFD COM''' - используется для передачи данных в ОФД через службу «[[MSer2Ofd|MSer2OFD]]»;
 
[[Файл:Служба передачи данных MSer2Ofd.png|альт=Рисунок 11. Служба "MSer2Ofd".|без|обрамить|Рисунок 11. Служба "MSer2Ofd".]]
После этого, установить службу «[[MSer2Ofd|MSer2OFD]]» и убедиться что, служба выполняется и стартует автоматически, после загрузки ОС Windows, как показано на рисунке 11.
 
== Настройки IIKO ==
 
# Распаковать плагин в папку «Resto.Front.Api.PrinterCustom».
# Скопировать плагин в папку «…\iiko\RMS\iikoRMS\Front.Net\Plugins».
# Запустить iikoFront.
# Запустить iikoOffice.
# Перейти в раздел «Настройки оборудования» при добавлении ККТ выбрать «Custom Q3X-Ф».
# на вкладке «Дополнительные настройки» задать COM-порт, соответствующий “Virtual COM” ККТ, отметить флаг «Денежный ящик», если к ККТ подключен денежный ящик и выбрать ФФД по которому будет работать ККТ.
# Для печати в X/Z-отчетах данных о суммах в денежном ящике, отметить соответствующие пункты в настройках.
# Для создания расширенных логов в случае возникновения сбойных операций, в параметре «Уровень диагностики» выставить значение «5». По умолчанию, рекомендуемое значение «1».                             
# Параметры «Кол-во сообщений» и «Кол-во дней» отвечают за выдачу уведомлений о состоянии обмена с ОФД.
{| class="wikitable"
|+Таблица совместимости версий плагина и ПО IIKO
!Версия ПО IIKO       
!Версия плагина   
|-
|''8.1''
|    ''V8Preview2.2.0.1''
|-
|''8.2''
|    ''V8Preview3.2.0.1''
|-
|''8.3''
|    ''V8Preview4.2.0.8''
|}
<pre style="color: red">
При уровне диагностики больше «1» возможно снижение скорости обработки операций, не рекомендуется менять уровень диагностики, если не требуется отправка данных разработчику для решения проблемных операций!
</pre>
 
 
В этих параметрах настраивается пороговое значение для количества не переданных сообщений. Если по любым причинам ККТ [[Устранение проблем с передачей данных в ОФД|не передает данные в ОФД]], и количество неотправленных сообщений или количество дней превысит пороговое значение, указанное в настройках, в интерфейсе IIKO Front появится всплывающее сообщение:
[[Файл:Уведомление о неотправленных документах IIKO.png|альт=Рисунок 12. Уведомление о неотправленных документах IIKO.|без|обрамить|Рисунок 12. Уведомление о неотправленных документах IIKO.]]
Рекомендуемые настройки:  
 
* Количество сообщений – 150;
* Количество дней – 10;
[[Файл:Настройка параметров ККТ в ПО IIKO.png|альт=Рисунок 13. Настройка параметров ККТ в ПО IIKO.|без|обрамить|Рисунок 13. Настройка параметров ККТ в ПО IIKO.]]
На вкладке «Типы оплат и регистры» установить необходимые типы оплат
[[Файл:Настройка типов оплат ККТ в ПО IIKO.png|альт=Рисунок 14. Настройка типов оплат ККТ в ПО IIKO.|без|обрамить|Рисунок 14. Настройка типов оплат ККТ в ПО IIKO.]]
На вкладке «Налоговые категории» установить необходимые ставки НДС для заданных категорий
[[Файл:Настройка налоговых категорий в ПО IIKO.png|альт=Рисунок 15. Настройка налоговых категорий в ПО IIKO.|без|обрамить|Рисунок 15. Настройка налоговых категорий в ПО IIKO.]]
После настройки ККТ, можно протестировать печать, выбрав в меню «тестовая печать»
[[Файл:Печать промежуточного отчёта в ПО IIKO.png|альт=Рисунок 16. Печать промежуточного отчёта в ПО IIKO.|без|обрамить|Рисунок 16. Печать промежуточного отчёта в ПО IIKO.]]
ККТ распечатает промежуточный отчет (X-отчет)
{| class="wikitable"
|+
!https://link.customwiki.ru/IIKO
|}

Текущая версия от 15:32, 27 сентября 2024

IIKO
IIKO

Плагин, необходимый для работы фискального устройства CUSTOM Q3X-Ф и ПО IIKO.

Плагин устанавливается в директорию: C:\Program Files\iiko\iikoRMS\Front.Net\Plugins и хранит логи в директории: C:\Users\**USERNAME**\AppData\Roaming\iiko\CashServer\Logs

Подготовка к работе

Для начала работы с ККТ CUSTOM Q3X-Ф, необходимо:

Убедиться, что на ККТ установлена актуальная версия ПО, для этого:

Запустить тестовую утилиту, подключиться к ККТ и в правом верхнем углу, в строке «ПО», будет показана версия ПО ККТ, как показано на рисунке 1.

Рисунок 1. Версия ПО ККТ.
Рисунок 1. Версия ПО ККТ.
Версия ПО ККТ, должна быть не ниже 5.ХХ.ХХ, например 5.02.00 или выше!

Уточнить или запросить актуальную версию ПО ККТ, Вы можете, написав на электронную почту технической поддержки производителя ККТ CUSTOM!

Настройка кассира

Для того, чтобы настроить кассира для работы с ПО IIKO, необходимо перейти на вкладку «Настройки ККТ» нажать кнопку «Запрограммир. Кассиров», в появившемся окне, кассиру с ID 2, присвоить код «88», пароль «8888» и нажать «Сохранить», как показано на рисунке 2. Имя кассира может быть любым, значение имени измениться при авторизации пользователя в ПО IIKO.

Рисунок 2. Настройка кассира IIKO.
Рисунок 2. Настройка кассира IIKO.

Настройка параметров чека

После настройки кассиров, в этой же вкладке «Настройки ККТ» нажать кнопку «Параметры чека» и в появившемся окне, установить следующие настройки:

  • «Всегда печатать номер позиции»
  • «Печать данных напротив QR-Code»
  • «Сжатие строки продажи (1) (без ‘отдела’)»
  • При необходимости отключить флаги отвечающие за печать дополнительных тегов. Например, «Не печатать тег #1162 – Код товарной номенклатуры». При снятом флаге, в чеке будет печататься код маркированной продукции, например, код маркировки сигарет.
  • При необходимости можно включить настройки, для сокращения размера чека: «Сжатие тела чека, кроме строки Наименование», «Сжатие итогов чека (сумма/сдача)», «Сжатие текста QR-Code». Остальные параметры оставить по умолчанию, как указано на примере ниже.

После установки всех необходимых настроек, нажать кнопку «Сохранить», как показано на рисунке 3.

Рисунок 3. Настройка параметров чека.
Рисунок 3. Настройка параметров чека.

Настройка конфигурации чека

Далее необходимо настроить конфигурацию чека, для этого на вкладке «Настройки ККТ» нажать кнопку «Конфигурация Чека», установить параметры, как показано на рисунке 4 и нажать кнопку «Сохранить».

Рисунок 4. Настройка конфигурации чека.
Рисунок 4. Настройка конфигурации чека.

Настройка заголовка чека

При необходимости настроить Заголовок чека и Сообщение в конце чека. На вкладке «Настройки ККТ» кнопки «Запрограммир. Заголовок» и «Сообщение в конце чека». Можно настроить до 9 строк, которые будут печататься в начале и в конце чека.

Рисунок 5. Настройка заголовка чека.
Рисунок 5. Настройка заголовка чека.
Рисунок 6. Настройка сообщения в конце чека.
Рисунок 6. Настройка сообщения в конце чека.
Параметр «Стиль» меняет стиль шрифта
0 Стандартный стиль
2 Шрифт двойной высоты
3 Шрифт двойной ширины
4 Шрифт двойной ширины и высоты
5 Жирный шрифт
6 Сжатие по ширине
7 Сжатие по ширине + жирный
8 Курсив
9 Сжатие по высоте
10 Сжатие по высоте + двойная ширина
11 Сжатие по высоте + курсив
Параметр «Шрифт» меняет размер шрифта
0 Шрифт по умолчанию, размер шрифта 3 (16 CPI, 44 символа в строке)
1 Размер шрифта 1 (16 CPI, 57 символов в строке)
2 Размер шрифта 2 (17 CPI, 48 символов в строке)
3 Размер шрифта 3 (16 CPI, 44 символа в строке)
4 Размер шрифта 4 (15 CPI, 41 символ в строке)
5 Размер шрифта 5 (13 CPI, 36 символов в строке) 
Параметр «стиль» оказывает влияние на длину строки, например, жирный шрифт и шрифт двойной ширины сокращают длину строки в два раза.

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

ККТ CUSTOM Q3X-Ф может передавать данные в ОФД как через Ethernet-соединение, так и через виртуальный COM-порт, используя службу «MSer2OFD».

Передача данных через Ethernet

На вкладке «Общие» нажать кнопку «Параметры Ethernet» и настроить параметры соединения.

Рисунок 7. Настройка параметров Ethernet.
Рисунок 7. Настройка параметров Ethernet.

Для автоматического получения настроек по DHCP, необходимо включить флаг «Разрешить DHCP» и нажать кнопку «Сохранить», как показано на рисунке 7. При ручных настройках данный флаг необходимо отключить.

Рисунок 8. Настройка USB-Профиля.
Рисунок 8. Настройка USB-Профиля.

Убедиться, что в настройках USB профиля выбран параметр «CDCMTP», как показано на рисунке 8.

Рисунок 9. Настройка параметров ОФД.
Рисунок 9. Настройка параметров ОФД.

Настроить параметры сервера ОФД. Ввести хост и порт сервера ОФД, если ККТ работает в режиме ФФД 1.2, тогда необходимо ввести хост и порт ОИСМ и АС ОКП, нажать кнопку «Сохранить», как показано на рисунке 9. Перезапустить ККТ по питанию.

Передача данных через виртуальный COM-Порт

Переключить профиль USB в режим «CDCCDC2» (два виртуальных Ком-порта) и нажать кнопку «Сохранить», как показано на рисунке 10.

Рисунок 10. Настройка USB-Профиля.
Рисунок 10. Настройка USB-Профиля.

Далее необходимо перезапустить ККТ по питанию и убедиться, что в системе появилось два COM-порта ККТ:

  • Q3xF RU Virtual COM - используется для управления ККТ;
  • Q3xF RU OFD COM - используется для передачи данных в ОФД через службу «MSer2OFD»;
Рисунок 11. Служба "MSer2Ofd".
Рисунок 11. Служба "MSer2Ofd".

После этого, установить службу «MSer2OFD» и убедиться что, служба выполняется и стартует автоматически, после загрузки ОС Windows, как показано на рисунке 11.

Настройки IIKO

  1. Распаковать плагин в папку «Resto.Front.Api.PrinterCustom».
  2. Скопировать плагин в папку «…\iiko\RMS\iikoRMS\Front.Net\Plugins».
  3. Запустить iikoFront.
  4. Запустить iikoOffice.
  5. Перейти в раздел «Настройки оборудования» при добавлении ККТ выбрать «Custom Q3X-Ф».
  6. на вкладке «Дополнительные настройки» задать COM-порт, соответствующий “Virtual COM” ККТ, отметить флаг «Денежный ящик», если к ККТ подключен денежный ящик и выбрать ФФД по которому будет работать ККТ.
  7. Для печати в X/Z-отчетах данных о суммах в денежном ящике, отметить соответствующие пункты в настройках.
  8. Для создания расширенных логов в случае возникновения сбойных операций, в параметре «Уровень диагностики» выставить значение «5». По умолчанию, рекомендуемое значение «1».
  9. Параметры «Кол-во сообщений» и «Кол-во дней» отвечают за выдачу уведомлений о состоянии обмена с ОФД.
Таблица совместимости версий плагина и ПО IIKO
Версия ПО IIKO Версия плагина
8.1 V8Preview2.2.0.1
8.2 V8Preview3.2.0.1
8.3 V8Preview4.2.0.8 
При уровне диагностики больше «1» возможно снижение скорости обработки операций, не рекомендуется менять уровень диагностики, если не требуется отправка данных разработчику для решения проблемных операций!


В этих параметрах настраивается пороговое значение для количества не переданных сообщений. Если по любым причинам ККТ не передает данные в ОФД, и количество неотправленных сообщений или количество дней превысит пороговое значение, указанное в настройках, в интерфейсе IIKO Front появится всплывающее сообщение:

Рисунок 12. Уведомление о неотправленных документах IIKO.
Рисунок 12. Уведомление о неотправленных документах IIKO.

Рекомендуемые настройки:  

  • Количество сообщений – 150;
  • Количество дней – 10;
Рисунок 13. Настройка параметров ККТ в ПО IIKO.
Рисунок 13. Настройка параметров ККТ в ПО IIKO.

На вкладке «Типы оплат и регистры» установить необходимые типы оплат

Рисунок 14. Настройка типов оплат ККТ в ПО IIKO.
Рисунок 14. Настройка типов оплат ККТ в ПО IIKO.

На вкладке «Налоговые категории» установить необходимые ставки НДС для заданных категорий

Рисунок 15. Настройка налоговых категорий в ПО IIKO.
Рисунок 15. Настройка налоговых категорий в ПО IIKO.

После настройки ККТ, можно протестировать печать, выбрав в меню «тестовая печать»

Рисунок 16. Печать промежуточного отчёта в ПО IIKO.
Рисунок 16. Печать промежуточного отчёта в ПО IIKO.

ККТ распечатает промежуточный отчет (X-отчет)

https://link.customwiki.ru/IIKO
Источник — http://customwiki.ru/index.php?title=Плагин_для_работы_с_ПО_IIKO&oldid=1031