Вітаємо в розділі документації додатку Device Manager
Скористайтесь змістом з лівого боку для швидкого переходу до потрібної вам інформації
¶ Коротко про програму
Device Manager кроссплатформенний застосунок для роботи з ПРРО (формування фіскальних чеків) та підключення POS-обладнання (прийом оплат від клієнтів через банківські термінали та дру чеків). Інтеграція з іншими системами для роботи з фіскальними чеками відбувається за допомогою протоколу HTTP REST API.
Сам застосунок працює в системі як web-сервер на власному порту.
Налаштування можна здійснювати як по API так і через вебінтерфейс.
Сам Device Manager слугує для:
-Забезпечення повної автономності роботи ПРРО у разі відсутності інтернет мережі чи проблем в роботі серверу ДПС чи АЦСК.
-Збереження і використання ключа ЕЦП для підпису чеків.
-Формування друкованих форм чеків та звітів для чекодруку.
-Підключення обладнання (чековий принтер, банківський термінал)
-Автоматичне закриття зміни по ПРРО у вказаний час.
¶ Підтримувані платформи
Завантажити версію для потрібної платформи
Windows x32 та x64
- мінімальна версія для стабільної роботи Windows 7 або Server 2008
Linux x64
- Debian based дистрибутиви Xubuntu/Lubuntu, Debian, Mint. Мінімальна версія для стабільної роботи Ubuntu 18.04+.
- Red hat enterprise based дистрибутиви(тільки x86_64) Centos, Fedora. Мінімальна версія для стабільної роботи Centos 7+ (версія ядра 3.10.0-1160 або вище).
- Arch Linux.
Є можливість роботи в docker контейнері
Android x32 та x64 розрядності (мінімальна версія для стабільної роботи Android 8+)
¶ Схема роботи ПРРО в додатку
Так як додаток приймає запити і повертає резулятат по REST API процес видачі фіскального чеку від отримання API запиту до моменту поверенння у відповідь зареєстрованого фіскального чеку виглядає наступним чином:
Пояснення до схеми: Фронт система фактично є робочим місцем касира будь то веб сайт чи окрема програма. Саме від цієї системи надходить запит з потрібними даними для фіскалізації чеку.
Додаток Device Manager(далі DM) після отримання запиту з даними в форматі json проводить перевірки коректності відправлених даних і формує xml файл з даними по чеку.
Якщо на цьому етапі було виявлено некоректність даних, наприклад сума по товарам не співпадає з загальною сумою в чеку, буде повернуто відповідну помилку у відповідь фронт системі.
Після формування xml файлу відбувається його підписання. Для цього DM віправляє запит в АЦСК на перевірку валідності ключа ЕЦП.
Якщо у вас на пристрої немає доступу до ресурсів потрібних для роботи підписання та фіскалізація не відбудеться. Які доступи по мережі потрібні додатку можна ознайомитись тут
Якщо підписання відбулось успішно наступним етапом чек відправляється до кабінету Вчасно.Каса який в свою чергу надсилає чек для рестрації у ДПС
Після отримання відповіді від податкової про успішну фіскалізацію чеку та фіскального номера чек записується в кабінеті та передається відповідь податкової в додаток DM, який в свою чергу також записує що чек було проведено та передає відповідь по API у фронт систему.
У випадку обриву зв'язку на будь якому етапі виходу в мережу чи при помилках від кабінету Вчасно.Каса/ДПС ПРРО має можливість працюати в режимі offline. Детальніше про offline режим тут.
Вищевказана схема забезпечує:
- Безперебійну роботу ПРРО у разі розриву чи проблем зі зв’язком на будь якому етапі передачі даних за допомогою режиму роботи offline, так як всі дані в даному режимі зберігаються локально на пристрої де встановлено додаток.
- Збереження всіх чеків виданих через додаток у хмарі(в кабінеті Вчасно.Каса)
¶ Як почати роботу
- Для початку рекомендуємо ознайомитись з інформацією яка описана в розділі Встановлення та підготовка додатку до роботи.
- На наступному етапі якщо ви тільки плануєте почати інтеграцію рекомендуємо переглянути опис API.
Якщо ви користуєтесь 1С чи системою іншого виробника за посиланням можна переглянути з якими системами Device Manager уже має готову інтеграцію та знайти інструкцію по підключенню.
- Налаштовуєте інтеграцію та по інструкції підключаєте для роботи тестову чи одразу фіскальну касу.
- У разі виникнення проблем в роботі чи під час налаштування додатку чи ПРРО перегляньте розділ Вирішення проблем в процесі налаштування/роботи.
- Підключаєте в додаток фіскальну касу по інструкції якщо до цього працювали з тестовою.
- Готово! Можна видавати чеки
¶ Список змін
Актуальна версія додатку за посиланням:
Changelog по версіям