¶ Для чого потрібен емулятор?
Емулятор або емуляція класичного РРО може бути корисною у випадку коли фронт система (облікова система чи програма фактично в якій працює касир) уже вміє працювати з класичним РРО, проте не вміє або не може, наприклад з технічних причин, працювати з ПРРО використовуючи API.
Робота з ПРРО за допомогою емулятора буде зручна та підходить у випадку:
- Якщо фронт система уже вміє працювати з РРО і є бажання та потреба швидко перейти з використання РРО на використання ПРРО.
- Якщо пряма інтеграція з ПРРО за допомогою API затратна.
- Якщо виконати пряму інтеграцію не можливо або складно з точки зору фронт системи.
¶ Схема роботи
Схема роботи з ПРРО додатково використовуючи емулятор буде наступна:
Пояснення до схеми:
Процес фіскалізації майже аналогічний стандартній схемі роботи з ПРРО за виключенням того що в схемі для спілкування з фронт системою (облікова система, касова програма або СРМ) з'являється модуль що заміняє собою протокол РРО.
Для фіскалізації чеку модуль емуляції всередині Device Manager, згідно з протоколом РРО, отримує команди в потрібному порядку (відкриття чеку, додавання в чек товарів, оплата тощо). Як тільки всі потрібні дані були отримані - відбувається фіскалізація чеку.
Після успішної фіскалізації чеку емулятор, передає фронт системі що чек проведено успішно.
Друк чеків та інших нефіскальних документів можна здійснювати на будь який чековий принтер, який підключено в Device Manager.
¶ Функціональність та наявні обмеження.
В даному розділі описані основні можливості та наявні обмеження при роботі через емулятор.
-
Робота з емулятором можлива лише у випадку якщо ваша система може працювати з РРО Datecs по протоколу Krypton (версія 5.03 або вище). Емуляція інших протоколів РРО наразі не підтримується.
-
Наразі робота через емулятор не можлива на Android. Підтримуються лише Windows та Linux.
-
За потреби є можливість на одному пристрої (пк) налаштувати до 10 кас одночасно з увімкненим режимом емуляції. Всі каси можуть працювати одночасно. В такому разі на кожну касу потрібна своя пара COM портів або окремий Ehternet порт (при роботі по мережі).
-
При роботі через емулятор підтримуються лише наступні операції з касою:
- Відкриття зміни (нульовий чек);
- Внесення/видача готівки;
- Чеки на продаж/повернення;
- Видача готівки держателям ЕПЗ;
- X-звіт;
- Закриття зміни.
Формування інших, доступних на РРО, звітів та чеків наразі не підтримується.
-
При роботі через емулятор не можлива відправка чеків у вайбер/смс чи на пошту через Вчасно.Каса.
-
Найважливішим моментом налаштування роботи через емулятор є співставлення кодів податкових груп і форм оплат з поточними налаштуваннями фронт системи. Обов'язково кореткно налаштуйте співвідношення для уникнення можливих проблем з тим що товари в чеку з некореткною податковою групою та чек оплачений не тією, що очікувалось, формою оплати.
¶ Налаштування роботи
Для того щоб налаштувати роботу через режим емуляції потрібно:
- Встановити Device Manager.
- Додати в Device Manager ПРРО (один або кілька, за потреби) та принтер (або кілька принтерів, якщо використовується більше як 1 каса)
- Увімкнути режим емуляції та встановити налаштування.
- Підключити емулятор як звичайний РРО до вашої системи.
Нижче деталі по кожному із пунктів
¶ Встановлення та налаштування Device Manager.
Для початку роботи обов'язково потрібно пройти етапи встановлення та налаштування Device Manager що включає в себе встановлення застосунку, налаштування доступів(якщо є мережеві обмеження), створення ПРРО, створення принтера.
Інструкції покроково як виконується налаштування:
- Перейти до розділу 1: Встановлення застосунку.
- Перейти до розділу 2: Доступи для роботи додатку.
- Перейти до розділу 3: Створити ПРРО.
- Перейти до розділу 4: Підключення та налаштування принтерів.
Додатково при додаванні ПРРО або в налаштуваннях (якщо каса була уже додана) потрібно увімкнути Автоматичне відкриття зміни з проведенням першого чеку.
Це потрібно для того щоб відкривалась зміна автоматично з першим чеком. Налаштування можна не вмикати, тоді відкриття зміни буде працювати лише через "Нульовий чек". Увімкнення налаштування не блокує можливість відкривати зміну нульовим чеком.
¶ Увімкнення та налаштування режиму емуляції
-
Налаштування режиму емуляції здійснюється через сторінку налаштуваннь ПРРО
-
У пункті "Режим емуляціїї" перемикаємо на увімкнено. На цьому етапі застосуються старндартні налаштування і буде змога їх відкоригувати перед запуском і початком роботи, тому далі переходимо до налаштувань
Які налаштування потрібно обов'язково зробити:
- Обрати інтерфейс підключення до облікової системи.
- Обрати потрібний принтер чеків (із створених в Device Manager).
- Налаштувати співвідношення форм оплат і податкових груп згідно тих кодів які використовуються у фронт системі.
- За потреби відключити автоматичне округлення готівки у чеках згідно правил НБУ.
Повідомляємо що відключення округлення готівки в чеках є порушенням постанови НБУ №25 Про оптимізацію обігу монет дрібних номіналів. У разі відключення округлення сервіс Вчасно.Каса не несе відповідальності за можливі штрафи пов'язані з правилами округленням монет дрібних номіналів у чеках та звітах.
¶ Інтерфейс підключення
Емулятор може приймати/передавати дані з/до фронт системи по мережі або за допомогою віртуального com порту. Відповідно налаштування в першому і другому режимі відрізняються.
Рекомендовано налаштовувати підключення через мережу (Ethernet), якщо такий спосіб підтримується фронт системою, так як цей спосіб значно простіше в налаштуванні і не портебує встановлення додаткового пз.
-
У пункті
Тип з'єднанняобираєтеEthernet -
У вас з'явиться поле де потрібно ввести порт. За замовчуванням 4141. Можна вказати будь який вільний порт в системі або залишити стандартний після чого натиснути
Дії/Зберегти.
Приклад налаштування:
Готово
Windows
Debian LinuxДля Windows потрібне додаткове програмне забезпечення для створення віртуальних портів.
Це може бути будь яке програмне забезпечення яке вміє створювати зв'язану пару COM портів.
Приклад налаштування через
com0com
- Завантажуєте дану програму та виконуєте її встановлення.
- Після встановлення після натиснення на кнопку "Finish" відкриється вікно налаштування.
Потрібно ввести пару портів яка буде використовуватись. Пари портів можна редагувати на власний розсуд. Якщо у вашої фронт системи є можливість надсилати запит тільки наCOM2, то один із COM-портів має бутиCOM2, а другий - будь-який вільний на комп'ютері, наприкладCOM1.
Після встановлення пари портів виставляємо галкуuse Ports classпісля чого тиснемоApply
В резульаті, по прикладу вище, буде створено 2 пов'язані портиCOM1таCOM2. Вікно налаштувань com0com можна закривати, більше воно не знадобиться
Іноді може виникнути ситуація що після натиснення на use Ports class у полях для введення зникнути назви портів без можливості їх змінити. Така проблема виникає із за відсутності драйверу.
у такому випадку встановити необхідний драйвер можна через налаштування Windows.
Переходимо до налаштувань, обираємо Windows Update далі Додаткові параметри і Необов'язкові оновлення та інсталюємо драйвер.
Після успішної інсталяції ви побачите на сторінці Windows Update наступну інформацію.
Якщо помилка повторюється і драйвера немає, перезавантажте ваш комп'ютер.
Для Linux створити порти можна через socat. В систему можна додати сервіс який буде "піднімати" ці порти при старті системи.
Як це зробити?
- Для початку потрібно встановити socat якщо його немає у вас в системі
Для Ubuntu можна виконати наступну команду для встановлення:
apt install socat
- Далі рекомендовано створити sh файл наприклад з назвою
socat.shз наступним вмістом:
# Creating socat.service
echo "[Unit]
Description=Socat Virtual COM Ports
Before=edm.service
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/socat -d -d pty,link=/dev/ttyS5 pty,link=/dev/ttyS6
[Install]
WantedBy=multi-user.target" | sudo tee /etc/systemd/system/socat.service > /dev/null
sudo chmod +x /etc/systemd/system/socat.service
sudo systemctl start socat.service
sudo systemctl enable socat.service
- Прописуємо права sh скрипту на виконання
sudo chmod +x install_socat.sh
- Запускаємо
sudo ./install_socat.sh
- По завершенню буде створено сервіс який буде запускатись перед Device Manager(це важливо, про це далі) сервіс створить 2 пов'язані порти
/dev/ttyS5та/dev/ttyS6.
Після того як пара портів була створена можна повернутись до налаштувань
У пункті Тип з'єднання обираєте COM
У вас з'явиться 3 поля:
Порт - сюди потрібно вказати порт до якого підключиться емулятор. Один порт із пари раніше створених.
Додаткових порт Linux - вказується другий порт із пари до якого буде підключатись фронт система. Вказуєте лише якщо емулятор і облікова система працюють на Linux. Потрібно для надання емулятором прав на порт щоб не було проблем із підключенням облікової системи із за відсутності прав.
Швидкість COM порту - дане поле можна залишити за замовчуванням 9600 так як зазвичай швидкість не емулюється.
Приклад налаштування для Windows
Приклад налаштування для Linux
¶ Вибір принтеру
У пункті Обрати принтер потрібно вказати який принтер буде використовуватись для друку чеків на цій касі.
За потреби налаштування можна змінити в будь який час.
¶ Співвідношення форм оплат і податкових груп
- Найважливішим моментом налаштування роботи через емулятор є співставлення кодів податкових груп і форм оплат з поточними налаштуваннями фронт системи.
Вам потрібно перевірити які коди мають конкретні податкові групи та види оплат які ви використовуєте в роботі.
У Вчасно.Каса для всіх компаній за замовчуванням одразу доступні наступні податкові групи та форми (засоби) оплат.
Потрібно встановити яким із податкових груп і типів оплат зазначених у Вчасно.Каса відповідають ці ж групи у вашій системі.
Наприклад ви використовуєте в роботі 3 податкові групи:
ПДВ 20% у вашій системі має код 0 - в ПРРО це код 1
ПДВ 20% + Акциз 5% у вашій системі має код 1 - в ПРРО це код 3
ПДВ 7% у вашій системі має код 2 - в ПРРО це код 4
Та 2 форми (засоби) оплати:
Готівка у вашій системі має код 0 - в ПРРО це код 0
Картка у вашій системі має код 1 - в ПРРО це код 2
Як видно з прикладу вище більшість кодів не збігаються, тому потрібно поставити співвідношення.
Зліва в таблиці код вашої системи, а справа код в ПРРО.
Ті коди які не будете використовувати - можна залишити без змін.
Приклад:
Тепер коли з облікової системи буде додаватись товар з кодом податкової групи 1 на ПРРО цей товар буде мати групу з кодом 3, тобто ПДВ 20% + Акциз 5%
Те ж стосується оплат в чеку.
Після виставлення всіх налаштувань необхідно запустити режим емуляції. Це одноразова дія при першому налащтуванні, після перезапуску пристрою він буде запускатись автоматично.
На цьому налаштування завершено.
¶ Підключення до фронт системи
Для підключення до касової програми потрібно обрати кореткну модель РРО та вказати інтерфейс для підключення.
Обираєте РРО Datecs на протоколі Krypton
Інтерфейс підключення згідно того який ви налаштували в емуляторі.
Якщо COM - тоді, наприклад емулятор підключений до одного із пари портів, наприклад COM1 (Windows) чи /dev/ttyS5 (Linux) у вашій системі обираєте другий порт, тобто COM2 (Windows) чи /dev/ttyS6 (Linux) згідно прикладу.
Якщо по мережі (Ethernet) - як IP адресу вказуєте localhost, тобто 127.0.0.1. а порт - згідно налаштування яке обрано в емуляторі (за замовчуванням це 4141).
Після налаштувань можна пробувати відкрити зміну та провести чеки чи інші операції з касою для перевірки роботи.
У разі виникнення будь яких питання стосовно роботи чи налаштування, можете звернутись до служби турботи Вчасно.Каса.
¶ Перехід з старої версії емулятора
Якщо у вас використовується 2 окремі застосунки: Device Manager та Datecs Emulator вам потрібно перейти на нову версію режиму емуляції вбудовану в сам Device Manager.
Для цього необхідно виконати кілька кроків:
- Закрити зміну (якщо відкрита) по вашій касі та оновити Device Manager до версії 7.0 або вище;
- Видалити застосунок Datecs Emulator з системи
- В налаштуваннях ПРРО увімкнути "Режим eмуляції" та натиснути на "Налаштування".
- Далі у пункті
ДіїобратиПеренести налаштування. Якщо застосунок Datecs Emulator було встановлено на цьому ж пристрої, у вікні що відкрилось залишаємо всі поля порожніми і натискаємоПочати перенесення.
Якщо ви переносите налаштування з іншого пристрою потрібно у першому пункті вказати повний шлях до файлу DatecsEmulator.s3db, а у другому пункті вказати шлях до файлу DatecsEmulator.ini.
Шлях вказується у форматі: C:\Users\user\Downloads\DatecsEmulator.ini (для Windows) або /tmp/DatecsEmulator.ini (для Linux)
- Після успішного перенесення натискаєте
Дії/Зберегти і запустити.
Готово, перенесення завершено. У касовій програмі нічого не потрібно змінювати, можна запускати, відкривати зміну та формувати чеки.