¶ Для чого потрібен емулятор?
Наразі доступний емулятор протоколів Krypton та Datecs.
Емулятор фізичного РРО потрібен у випадку коли фронт система(програма фактично в якій працює касир) уже вміє працювати з звичайним РРО, проте не вміє працювати з ПРРО використовуючи API.
Робота з ПРРО за допомогою емулятора буде зручна та підходить у випадку:
- Якщо фронт система уже вміє працювати з РРО і є бажання та потреба швидко перейти з використання РРО на використання ПРРО.
- Якщо пряма інтеграція з ПРРО за допомогою API затратна.
- Якщо виконати пряму інтеграцію не можливо або складно з точки зору фронт системи.
¶ Схема роботи
Схема роботи з ПРРО додатково використовуючи емулятор буде наступна:
Пояснення до схеми:
Процес фіскалізації майже аналогічний стандартній схемі роботи додатку з ПРРО за виключенням того що в схемі для спілкування з фронт системою з'являється емулятор.
Емулятор отримує по протоколу РРО інформацію в потрібному порядку(відкриття чеку, продаж товарів, оплати, тощо) і при закритті чеку(команди з боку фронт системи) йде відправка зібраних даних з емулятора на ПРРО що підключено в Device Manager.
Віповідно після успішної фіскалізації чеку емулятор отримує відповідь від Device Manager та, як результат, передає фронт системі номер документа, що означає що чек проведено.
За потреби емулятор може відправляти одразу на друк фіскалізований чек на принтер що підключено в Device Manager(функціонал налаштовується через емулятор).
¶ Налаштування роботи
Наразі доступний емулятор протоколів Krypton та Datecs.
¶ Підготовка Device Manager для роботи
Для початку роботи з емулятором обов'язково потрібно пройти етапи встановлення та налаштування додатку Device Manager.
Інструкції як саме виконується налаштування:
- Перейти до розділу 1. Встановлення додатку.
- Перейти до розділу 2. Доступи для роботи додатку.
- Перейти до розділу 3. Права в системі для роботи додатку.
- Перейти до розділу 4. Створити ПРРО.
¶ Налаштування Емулятора
¶ Інсталяційний пакет
¶ Встановлення та налаштування
-
Завантажуємо інсталяційний пакет емулятора та виконуємо встановлення.
-
Після успішного встановлення додаток буде запущено у вигляді сервісу. Вебсервер для налаштувань додатку працює на 5757 порті.
-
Налаштування ПРРО в емуляторі можна здійснювати через вебінтерфейс на сторінці
http://localhost:5757/dat/#Settingsабо черезDatecsEmulator.iniфайл.
Перше налаштування після встановлення рекомендовано здійснювати саме черезDatecsEmulator.iniфайл так як наразі через вебінтерфейс доступний не повний перелік налаштувань.
Повний шлях до файлу:C:\Program Files (x86)\DatecsEmulator\DatecsEmulator.ini
На даному етапі потрібно вказати потрібні значення для даних параметрів:
VchasnoIP
VchasnoDevice
VchasnoToken
TaxCodesAssociated
PaysCodesAssociated
- Наступний етап підключення до фронт системи. Емулятор може приймати/передавати дані з/до фронт системи за допомогою ethernet або віртуального com порту. Відповідно налаштування в першому і другому режимі відрізняються.
В DatecsEmulator.ini файлі потрібно вказати значення:
IsEmulCom=0
EmulEthernetPort=4141
Порт 4141 можна замінити на будь який інший.
Зберігаємо зміни в файлі, після чого потрібно перезапустити службу 'DatecsEmulator' щоб зчитались нові налаштування.
У фронт системі потрібно підключити модель ПРРО яка працює про потрібному протоколу(datecs/krypton) та переконатись що система вміє передавати дані та отримувати відповіді від РРО по ethernet.
Після чого у фронт системі вказується значення EmulEthernetPort.
Готово
Для роботи через віртуальний com порт потрібна праграма com0com для зв'язування com портів.
- Завантажуєте дану програму та виконуєте її встановлення.
- Після встановлення після натиснення на кнопку "Finish" відкриється вікно налаштування.
Потрібно ввести пару портів яка буде використовуватись. Пари портів можна редагувати на власний розсуд. Якщо у вашої фронт системи є можливість надсилати запит тільки на COM-порт №3, то один із COM-портів має бути №3, а другий - будь-який вільний на комп'ютері.
Після встановлення пари портів виставляємо галку "use Ports class" після чого тиснемо "Apply"
Програму com0com можна закривати.
Відповідно один із портів прописується в налаштуваннях фронт системи при підключенні РРО, а інший в файлDatecsEmulator.ini
Виставляємо налаштування:
IsEmulCom=1
EmulComName=COM2
EmulComSpeed=9600
При такому налаштування фронт система має віправляти запити на COM1.
Готово
- Після виконання всіх вищевказаних налаштувань потрібно в налаштуваннях ПРРО в додатку Device Manager встановити 'Автоматичне відкриття зміни з проведенням першого чеку' та натиснути зберегти, для того щоб відкривалась зміна автоматично. Якщо налаштування не буде встановлено можуть виникати помилки в роботі.
- На цьому етапі налаштування завершено, можна перевіряти роботу.
Для цього запускаєте фронт систему і пробуєте пройти весь пройти роботи касира, для того щоб перевпевнитись що все працює коерктно.
- Внесення готівки;
- Проведення чеку на продаж;
- Проведення чеку на повернення;
- Винесення готівки;
- x-звіт;
- Закриття зміни(z-звіт).
¶ Параметри
Параметри в DatecsEmulator.ini файлі
| Назва параметру | Функціональність | Допустимі значення | Додаткова інформація |
|---|---|---|---|
| IsEmulCom | Значення режиму роботи емулятора(com, ethernet) | 1 - com, 0 - ethernet | |
| EmulComName | Вибір COM порту для використання емулятором | Від "COM1" до "COM15" | Два COM порти мають бути зв'язані між собою. Фронт система використовує один, а емулятор інший. |
| EmulComSpeed | Швидкість com порту | Числове значення. 9600, 19200, 57600, 115200 | |
| EmulEthernetPort | Порт прийому даних емулятором по Ethernet | Числове значення | |
| IsPrint | Параметр друку на принтер | 1 - з друком, 0 - без друку | Принтер має бути підключено в Device Manager та вказано PrnDevice і PrnToken |
| IsWriteLog | Запис файлу логу | 1 - записувати(за замовчуванням), 0 - не записувати | Рекомендовано не змінювати даний параметр і залишити значення "1" |
| IsWriteMemo | Запис інформації | 1 - записувати(за замовчуванням), 0 - не записувати | Рекомендовано не змінювати даний параметр і залишити значення "1" |
| IsLocalDB_Enabled | Параметр використання локальної бази даних для товарів | 1 - увімкнено(за замовчуванням), 0 - вимкнено | Рекомендовано не змінювати даний параметр і залишити значення "1" |
| IsKryptonProt | Параметр вибору протоколу для роботи | 1 - протокол Krypton, 0 - протокол Datecs | Протокол Krypton є покращеною версією протоколу Datecs. Відповідно потрібно перед встановленням даного налаштування перевірити по якому протоколу вміє працювати фронт система. |
| IsDatecs_cmd_3Ah | 1 - увімкнено, 0 - вимкнено(за замовчуванням) | ||
| DatecsSerial | Серійний номер РРО. | текст | Не рекомендовано змінювати значення параметру. |
| IsDevResend | Пароль для сертифікату | текст | |
| IsExecuteOnly | 1 - увімкнено, 0 - вимкнено(за замовчуванням) | ||
| WebServerEnabled | Параметр роботи вебсерверу емулятора | 1 - увімкнено(за замовчуванням), 0 - вимкнено | Не рекомендовано змінювати значення номеру. |
| WebPort | Порт вебсерверу | числове значення(5757 за замовчуванням) | Порт вебсерверу для ручних налаштувань емулятора. Не плутати з EmulEthernetPort який використовується для роботі по ethernet. |
| VchasnoIP | IP адреса та порт пристрою де встановлено Device Manager | текст | Значення за замовчуванням localhost:3939 у випадку якщо device manager та емулятор встановлено на одному пристрої. |
| VchasnoDevice | Назва ПРРО в Device Manager | текст | Саме через це ПРРО, назву якого буде вказано в цьому параметрі буде відбуватись фіскалізація чеків. |
| PrnDevice | Назва принтеру в Device Manager | текст | |
| TaxCodesAssociated | Співвідношення податкових груп | текст, формат співвідношення через знак "/", наприклад 0,1,2,3,4,5,6,7,8/0,1,2,3,4,5,6,7,8 | |
| PaysCodesAssociated | Співвідношення типів оплат | текст, формат співвідношення через знак "/", наприклад 0,1,2,3,4/0,1,2,3,4 | |
| LogsPath | Шлях до файлу логів | текст | |
| DBPath | Шлях до файлу БД(не використовується) | текст |
¶ Список змін
В даному розділі вказано список змін в емуляторі з виходом нових версій.
¶ 1.8.0
- Зміна вебінтерфейсу на більш зрозумілий.
- Допрацювання даних що повертаютсья у відповідь по команді E2h для протоколу krypton
- Друк додаткової службової інформації(податкові групи, коди та букви) на принтер коли зміна закрита.
- Реалізація всіх типів знижок в чеку згідно протоколу krypton.
- Можливість отримати залишок готівки по касі якщо зміна закрита для krypton.
- Виправлення розривів зв'язку між емулятором та фронт системою у разі довготривалого виконання запитів.
- Коригування таймауту на з'єднання з ДМ для уникнення помилок.
¶ 1.7.0
- Відключення функціоналу відкриття зміни емулятором. Для коректної роботи в device manager починаючи з версії емулятора 1.7.0 потріно включити "Автоматичне відкриття зміни з проведенням першого чеку".
- Виправлення по роботі з даними для команди A0h для протоколу krypton.
- Розміщення qr-коду по середині чеку при друку довільного текстового документу.
- Можливість забороними редагувати(перезаписувати) товари з боку касової системи які записані в базі даних емулятора.
¶ 1.6.2 - hotfix
- Виправлення округлення суми в чеку для вагових товарів.
¶ 1.6.1 - hotfix
- Виправлення відкриття зміни по ПРРО при відкритті грошового ящику якщо зміна по ПРРО закрита. Зміна відкриватись не буде.
¶ 1.6.0 - release
- Передаємо акцизну марку як коментар до позиції по протоколу datecs.
- коригування роботи команди E2h для протоколу krypton, можливість роздрукувати останній проведений чек.
¶ 1.5.0 - release
- Виправлення помилки з подальшим підключенням до емулятора у випадку отримання емулятором некоректного пакету.
- Реалізація команди 46h для протоколу datecs. Повернення загальної суми внесення і винесення за зміну.
- Виправлення розрахунку решти при оплаті готівкою в чеку.
¶ 1.4.0 - release
- Виправлення зависання емулятора при запиті на незапущений/неробочий ДМ.
- Виправлення по синхронізації сум за день по протоколу krypton.
¶ 1.3.0 - release
- Додано можливість фіскалізувати через ПРРО чек видачі готівки тримачам ЕПЗ для протоколу krypton.
¶ 1.2.0 - release
- Допрацювання друку довільного тексту як службового нефіскальгого чеку на принтер по командам 60/61/65 для протоколу Krypton.
¶ 1.1.1 - hotfix
- Виправлення створення ini файлу при інсталяції додатку.
¶ 1.1.0 - release
- Допрацювання роботи по протоколу Krypton.
- Можливість роботи емулятора по Ethernet.
- Виправлення розрахунку оборотів.
- Зміна версії протоколу Krypton до 5.20.
- Корегування роботи з довготривалим опрацюванням даних для протоколу Krypton.