¶ Важлива інформація перед початком оновлення
Додаток Device Manager завжди потрібно використовувати останньої версії!
Це потрібно для стабільної роботи застосунку та дотримання вимог податкової до роботи з фіскальними чеками. В нових версіях, не рахуючи нового функціоналу та актуалізації його для дотримання вимог законодавства, виправляються можливі некоректності в роботі та покращується стабільність роботи застосунку за будь яких умов.
Максимально допускається робота з версіями не старше 3-4 місяців з дати релізу.
Проте рекомендуємо оновлювати застосунок якумога раніше.
Всі зміни зроблені в кожному з релізів описані у Списку змін.
Якщо у вас виникають проблеми в роботі додатку і у вас не остання версія додатку майте на увазі що першочергово вам необіхідно буде оновити додаток.
Про оновлення додатку повідомляємо:
- Відправляємо Email на пошту за допомогою якої було виконано реєстрацію в кабінеті Вчасно.Каса.
- Пост в telegram каналі.
Для оновлення можна використати будь який із зазначених нижче способів, проте рекомендуємо налаштувати саме автооновлення для того щоб користуватись завжди актуальною версією.
Якщо у вас виникають помилки на будь якому з етапів оновлення перейдіть до інструкції:
¶ Оновлення додатку з інсталяційного файлу
Оновлення з інсталяційного файлу виконується стандартно, оберіть нижче потрібну платформу для перегляду детальнішої інформації.
Оновлення рекомендовано виконувати коли не проводяться чеки по касам та зміни по всім ПРРО в додатку закриті.
Категорично забороняється виконувати оновлення під час фіскалізації чеків в online чи offline режимі. Це може призвести до поломки бази даних або некоректності даних.
Windows
Linux
Android- Завантажуємо нову версію за посиланням для потрібної розрядності системи.
- Запускаємо інсталяційний файл з правами адміністратора. Для запуску з правами адміністратора потрібно виконати вхід в систему під обліковим записом адміністратора та запустити інсталятор або виконати команду через cmd:
msiexec /a {шлях до файлу встановлення} - Далі все аналогічно як і з встановленням. Натискаєте "Далі", ще раз "Далі" і "Встановити" і чекаєте завершення встановлення.
- Після встановлення натискаєте "Завершити".
На linux у випадку використання старої версії бажано видалити додаток та встановити повторно. Конфігураційний файл та база даних при цьому не видаляться, відповідно всі ваші дані по касам, чекам та налаштуванням будуть збережені.
- Завантажуємо нову версію за посиланням.
Якщо оновлення буде відбуватись через термінал, його потрібно відкрити на повний екран, інакше із за проблеми в роботі dpkg додаток не інсталюється повністю що призведе до подальшої некоректності в роботі.
- Видалення можна виконати через
dpkg
sudo dpkg -r edm - Для встановлення виконуємо команду
sudo dpkg -i {шлях до файлу} - Якщо встановлення пройшло успішно в терміналі буде наступна інформація про створення 2 сервісів:
Selecting previously unselected package edm.
(Reading database ... 206540 files and directories currently installed.)
Preparing to unpack DeviceManager_5.184.0.0_x64.deb ...
Installing EVO Device Manager...
EDM service config file was not found
EDMUpd service config file was not found
Unpacking edm (5.184.0.0) ...
Setting up edm (5.184.0.0) ...
Add EDMservice...
Created symlink /etc/systemd/system/multi-user.target.wants/edm.service → /etc/systemd/system/edm.service.
● edm.service - EDM service
Loaded: loaded (/etc/systemd/system/edm.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2023-02-13 10:37:40 -03; 12ms ago
Main PID: 32047 (EDMSrv)
Tasks: 1 (limit: 4584)
Memory: 1.0M
CPU: 6ms
CGroup: /system.slice/edm.service
└─32047 /usr/share/edm/EDMSrv
Feb 13 10:37:40 ubuntu systemd[1]: Started EDM service.
Created symlink /etc/systemd/system/multi-user.target.wants/edmupd.service → /etc/systemd/system/edmupd.service.
● edmupd.service - EDM service updater
Loaded: loaded (/etc/systemd/system/edmupd.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2023-02-13 10:37:40 -03; 16ms ago
Main PID: 32084 (EDMUpd)
Tasks: 1 (limit: 4584)
Memory: 1.1M
CPU: 10ms
CGroup: /system.slice/edmupd.service
└─32084 /usr/share/edm/EDMUpd
Feb 13 10:37:40 ubuntu systemd[1]: Started EDM service updater.
Feb 13 10:37:40 ubuntu EDMUpd[32084]: EDMUpdater Service STARTED...
Якщо після встановлення при перевірці статусу служби у вас виникають помилки які описані нижче їх можна проігнорувати, так як на роботу ДМ вони не впливають.
Нова версія бібліотеки підписання після старту ДМ шукає в системі .so файли для роботи з захищеними ключами на usb накопичувачах, так як їх немає помилка потрапляє в лог.
ДМ такі ключі не використовує, тому це ніяк і не впливає на роботу.
Mar 16 04:08:53 ubuntu OSIntermediate[3917]: dlopen failed to load libusb-0.1.so.4: libusb-0.1.so.4: cannot open shared object file: No such file or directory
Mar 16 04:08:53 ubuntu OSIntermediate[3917]: dlopen failed to load libusb.so: libusb.so: cannot open shared object file: No such file or directory
Щоб помилка зникла достатньо поставити libusb
sudo apt-get install libusb-0.1-4
Для оновлення на OS Android потрібно перейти в Play Market на сторінку додатку.
Та натиснути "Оновити" та дочекатись встановлення нової версії.
Після встановлення натискаєте "Відкрити" та можете продовжувати видавати чеки.
Версія додатку з Play Market рекомендується для встановлення на всі пристрої
Якщо на пристрої немає play market потрібно завантажити APK файл на сторінці завантаження
Даний інсталяційний файл орієнтований на пристрої з низькою версією android та x32 розрядні пристрої.
Після чого запустити APK файл, підтвердити оновлення та дочекатись завершення.
Оновлення з APK файлу не відбудеться якщо версія android нижче за мінімальну підтримувану, або Android 12 у якому була вирізана підтримка x32 версій та у випадку якщо попередня версія була встановлена з Play Market.
¶ Оновлення по API або через вебінтерфейс додатку
Даний спосіб оновлення аналогічний автооновленню. Можна використовувати його, проте рекомендується встановити автооновлення.
Windows/LinuxAndroid¶ Оновлення через вебінтерфейс
-
Для оновлення через вебінтерфейс переходимо на сторінку списку пристроїв http://localhost:3939/dm/vchasno-kasa/dashboard.html
Якщо поточна версія не є актуальною буде вказано "доступна нова версія". -
Натискаємо на кнопку "Перейти до оновлення".
Буде відкрито спливаюче вікно де вказано інформацію перед запуском автооновлення.
Можна переглянути які зміни були в новій версії натиснувши "Переглянути список змін"
-
Для запуску оновлення натискаємо
Оновити версію
Після натиснення потрібно дочекатись завантаження файлів оновлення. Залежно від швидкості інтернету це займе від 5 до 30 секунд.
Якщо файли оновлення було завантажено успішно буде відображено наступний текст:
-
Після вище проведених дій потрібно зачекати приблизно від 15 секунд до 1 хвилини, залежно від пристрою для того щоб служба оновлення завершила роботу та виконала перезапуск ДМ.
Для перевірки що версію оновлено успішно достатньо лише оновити сторінку.
Оновлення завершено.
¶ Оновлення за допомогою API
- Перевірити наявність оновлень додатку можна GET API методом.
/dm/vchasno-kasa/api/v1/svc_need_update
Даний запит не має body.
curl --location --request GET 'http://localhost:3939/dm/vchasno-kasa/api/v1/svc_need_update'
| Тег | Тип json даних | Зміст |
|---|---|---|
| need_update | number | Наявність оновлення: 1 - є оновлення для додатку. 2 - оновлення немає. 3 - сервісне значення, повертається лише у випадку автоматичного оновлення(не з інсталятора) з версії 5.193 на вищу. Означає що не оновленна служба автооновлення, але додаток оновлено. Оновлення служби виконається автоматично при наступному запуску додатку або в 03:00(для серверів). Після цього метод буде повертати значення 2. |
{
"need_update": 2
}
- Оновлення додатку запускається POST API методом
/dm/api/v1/app-update
Потрібно передати лише {}
curl --location --request POST 'http://localhost:3939/dm/api/v1/app-update' \
--header 'Content-Type: text/plain' \
--data-raw '{}'
Успішне завантаження файлів та старт оновлення.
{
"ver": 6,
"source": "",
"device": "",
"tag": "",
"type": 0,
"task": 0,
"dt": "20230213054949743",
"res": 0,
"res_action": 0,
"errortxt": "Файли оновлення завантажено. Оновлення буде виконано на протязі хвилини.",
"aq_errortxt": "",
"warnings": []
}
Оновлень немає.
{
"ver": 6,
"source": "",
"device": "",
"tag": "",
"type": 0,
"task": 0,
"dt": "20230213054949743",
"res": 2006,
"res_action": 1,
"errortxt": "Update not needed",
"aq_errortxt": "",
"warnings": []
}
Для Android даний функціонал недоступний.
Оновлення можна виконати через Play Market або з apk файлу
¶ Автооновлення додатку
Автооновлення можна налаштувати через вебінтерфейс або API методом. Після встановлення налаштування, ДМ буде протягом 15хв від вказаного часу пробувати виконати оновлення. Якщо файли нової версії наявні на сервері та доступи відкриті ДМ буде успішно оновлено.
Windows/LinuxAndroid¶ Налаштування через вебінтерфейс
- Налашутвання відбувається на сторінці
http://localhost:3939/dm/vchasno-kasa/settings.html
Можна перейти напряму за посиланням або через головну сторінкуhttp://localhost:3939/dm/vchasno-kasa/dashboard.html
Натиснувши на значок
з правого боку зверху. - Прогорніть донизу, переключіть слайдер в пункті "Автооновлення" та встановіть зручний для вас час. Бажано щоб в час автооновлення, що було виставлено, по касам не проводились чеки.
Якщо перемикач було включено, але не вказано час автооновлення, автооновлення не буде виконано!
¶ Налаштування за допомогою API
Автооновлення можна встановити через загальні налаштуваня додатку.
Для встановлення автооновлення в заданий час достатньо відправити POST запит з настпуними даними(приклад):
/dm/vchasno-kasa/api/v1/settings
| Тег | Тип json даних | Зміст | Обов'язковий |
|---|---|---|---|
| autoupdate | boolean | Статус автооновлення: true - увімкнено, false - вимкнено |
+ |
| autoupdatetime | string | Час запуску автооновлення в форматі HH:MM | + |
curl --location --request POST 'http://localhost:3940/dm/vchasno-kasa/api/v1/settings' \
--header 'Content-Type: application/json' \
--data-raw '{
"autoupdate": true,
"autoupdatetime": "20:50"
}'
| Тег | Тип json даних | Зміст |
|---|---|---|
| res | number | Код результату: 0 - ОК, > 0 - код помилки |
| errortxt | string | Текст помилки у разі неуспішного оновлення налаштувань. |
{
"res": 0,
"errortxt": ""
}
Якщо буде передано
"autoupdate": trueта порожнє значення дляautoupdatetimeавтооновлення не відбудеться. Час потрібно встановити обов'язково!
На OS Android автооновлення додатку відбудеться автоматично з Play Market якщо у маркеті увімкнено налаштування оновлювати додатки автоматично як тільки буде випущена нова версія додатку Device Mananger.
Вмикається в розділі "Налаштування/Налаштування мережі/Автоматичне оновлення додатків" або можна увімкнути даний функціонал лише для додатку device manager.
Для цього потрібно через пошу знайти додаток device manager, перейти на сторінку додатку, натиснути на значок у вигляді трьох крапок та ввімкнути пункт "Автооновлення", підтвердити увімкнення.