- Додаоно одноразову очистку сертифікатів ключів ЕЦП для вирішення проблеми роботи ПРРО де використовуються для підписання чеків ключі
КНЕДП ТОВ \"Центр сертифікації ключів \"Україна\"
та зміна схеми роботи з сертифікатами для більшої стабільності роботи ключів надалі.
- Виправлено помилку з роботою "Зворотної синхронізації".
- Виправлено помилку при спробі отримати список чеків по зміні по id зміни при роботі на SQLite.
- Заборонено створювати більше 10-ти касі при роботі на SQLite. Для того щоб була можливість створювати більшу кількість ПРРО в Device Manager необіхдно змінити базу даних для роботи на MS SQL або Postgresql.
- Додано додаткову звірку часу пристрою з часом на сервері Вчасно.Каса при відкритті зміни або при запуску додатку якщо зміна уже була відкрита. Допустима різниця в часі -10хв. від часу на сервері, інакше фіскалізація чеків буде заборонена до виправлення проблеми з часом на пристрої.
- Додано можливість підключати термінали під управлінням протоколу SSI JSON.
Доступні термінали:
- термінали Newland серії SP,
- термінали unattended для систем самообслуговання Newland U1000,
- Android термінали Verifone X990 всіх формфакторів,
- а також Андроїд терміналами інших виробників, з програмним забезпеченням SSI та протоколом SSI JSON на них.
Банки еквайри платіжні застосунки яких можуть бути налаштовані на перерахованих терміналах станом на 01.05.2024:
- Ощадбанк
- Райффайзен банк
- ПУМБ
- А-банк
- Monobank
- Таскомбанк
- КІБ
- Восток Банк
- Південний Банк
- МТБ
Додатково, протягом місяця виробником терміналів буде встановлена оновлена версія платіжних додатків банків Райффайзен банк Аваль
, ПУМБ
, Monobank
, Таскомбанк
, АБанк
, Укрексімбанк
з підтримкою інтеграційного протоколу SSI JSON. Частина з них з них вже підтримує і відповідно доступна для підключення та роботи в Device Manager.
Всі термінали що використовують протокол SSI JSON
можуть працювати в режимі 2в1, тобто термінал замінює і принтер фіскальних чеків (не тільки олачених карткою, але і готівкою також) і сам банківський термінал про проведення безготівкових розрахунків. Додатково налаштовувати принтер не потрібно, після підключення терміналу можна одразу друкувати чеки та приймати оплати.
- Додали обробку колізійних ситуацій коли термінал не отримує підтвердження отримання даних від ДМ для терміналів на протоколі BPOS1 (Ощадбанк, Укрсиббанк, Банк Південний, Банк Восток, Sense банк, А-Банк) для уникнення подальших розбіжностей. У таких випадка у відповідь якщо операцій на терміналі не пройшла буде повернуто помилку з кодом 7000 (
"res": 7000
).
- Можливість повторно отримати інформацію про виконану раніше операцію на терміналі по протоколу BPOS1 (Ощадбанк, Укрсиббанк, Банк Південний, Банк Восток, Sense банк, А-Банк).
Для цього використовується 17 завдання ("task":17
). В об'єкт "pay"
необхідно передати додатково номер мерчанту та номер операції на терміналі("cancelid"
).
Приклад запиту:
curl --location 'http://localhost:3939/dm/execute' \
--header 'Content-Type: application/json' \
--data '{
"ver": 6,
"source": "API",
"device": "Terminal",
"tag": "",
"type": 3,
"pay": {
"task": 17,
"cancelid": "27",
"merch": 1
}
}'
-
Додано можливість підключити термінал іншого банку якщо немає в списку доступних якщо відомий протокол роботи терміналу. Додатково потрібно буде вказати назву банку.
-
Виправлено деякі розбіжності в даних в json відповіді при фіскалізації чеків через /dm/execute
та фіскалізації аналогічного чеку через /dm/execute-prn
, /dm/execute-pkg
-
Можливість запису версії бази даних в конфігураційний файл. Потрібно для коректної роботи додатку з postgresql базоб даних, без можливості надати користувачу який підключається до БД superadmin
права.
в файл EDMSrv.ini в блок [Database]
додати наступні рядки:
DBVerInINI=1
DBVer=
Після чого перезавантажити службу EDMSrv
(windows), edm
(Linux).
- Виправлено проблему з можливим зависанням сервісу в процесі запису логів роботи.
- Додано інформацію про ідентифікатор зміни ("shift_id") у відповіді на завдання 18 (
"task": 18
).
Якщо зміна закрита - буде повенуто ідентифікатор попеоедньої зміни. Якщо зміна відкрита - ідентифікато поточної.
- Виправлено помилку з відображенням сум по чекам переказу коштів в періодичних звітах якщо цих чеків не було сформовано.
- Додано можливісто виконати X-звіт для терміналів по протоколу
SimPays ККМ
(Sense банк, Банк ТАС)
- Прибрано повторний запуск час затримки перед фіскалізацією офлайнових чеків, якщо уже в межах одного періоду роботи каси в режимі офлайн він був запущений.
- Виправлено помилку з пошуком чеків лише за останні 4 зміни замість всіх при виконанні завдання 23 (
"task":23
) по ПРРО.
- Випралвено помилку з сумами по операціям продажу, повернення та скасування без урахування копійок на виконання X та Z звітів по терміналам на BPOS1 протоколі (Ощадбанк, Укрсиббанк, Банк Південний, Банк Восток, Sense банк, А-Банк).
- Розширено текст попередження про можливі наслідки при видаленні чеків.
- Виправлено помилку з неможливістю коректно створити принтер чеків в додатку при роботі на деяких версіях MS SQL та postgresql.
- Виправлено помилку при запуску додатку після оновлення на застарілих версіях Windows.
- Виправлено проблему із записом логів роботи додатку що при великому навантаженні призводило до зависання сервісу і необхідності його ручного перезапуску.
- Виправлено помилку з форматом дати при виконанні періодичних звітів при використанні БД SQLite.
- Виправлено помилку при збереженні службових чеків при виконанні зворотної синхронізації.
- Виправлено помилку при відображенні підсумків по видам оплат(якщо їх кілька) по операціям видачі готівки держателям ЕПЗ у візуалізаціх X, Z та періодичних звітів.
- Виправлено помилку із запуском додатку на деяких системах linux після оновлення.
- Додано можливість фіскалізувати нові типи чеків: Чек переказу коштів(
"task": 15
) та чек видачі коштів при переказі("task": 16
).
У X, Z та в періодичних звітах додано блок "Операції переказу коштів та видачі коштів при переказі"
з підсумком по даним операціям по видам оплат.
- Змінено схему фіскалізації черги офлайн чеків після закінчення масових збоїв АЦСК та ДПС або в разі відсутності інтернету у разі роботи Device Manager як сервер ПРРО для розподілення та зменшення навантаження додатком на сервер допоки всі чеки не будуть фіскалізовані.
- Додано додаткові налаштування друку для принтерів:
-Режим встановлення кодової сторінки
- в разі друку в режимі тексту замість картинки, Альтернативний режим вирішує проблему на первних моделях принтерів з наявними зайвими символами "Iя" в першому рядку чеку при встановленні кодування тексту на принтері.
-Спосіб друку зображень
- в разі друку картинкою. Альтернативний
режим дозволяє налаштувати коректний друк на принтерах де картинка друкувалась некоректно(замість чеку друкувася набір символів). Перевірено на принтерах BTP
та HPRT
. Режим Для розфіскалізованих РРО
дозволяє друкувати чеки картинкою на розфіскалізованих РРО. Перевірено на моделі EP-700
(FP-700
)
- Додано можливість підключати терміналі
Банку ТАС
та Sense банку
по мережі по протоколу SimPays ККМ
за допомогогою TCP серверу. При створенні пристрою потрібно вказати порт серверу будь який доступний в системі і піля того повідомити банку налаштувати підключення до каси на ip адресу вашого пристрою(ноутбук чи комп'ютер) та вказаний в налаштуваннях порт. Після встановлення налаштувань банком можна працювати з терміналом.
- Виправлено помилку з сумою бази оподаткування 0 грн. для груп з 0% податку в значеннях
base_tax_sum_p
, base_tax_sum_m
, base_ex_sum_p
, base_ex_sum_m
в JSON відповіді при виконанні X, Z та періодичних звітів в масиві info.taxes
.
- Додано можливість фіскалізовувати чеки з нульовою сумою на наявними товарами при вказанні 100% знижки або знижки на всю суму товара чи чеку.
Для того щоб дозволити фіскалізацію таких чеків потрібно в об'єкт fiscal.receipt
в json запиті передати "allow_zero_sum": true
. В іншому випадку при спробі фіскалізувати чек з нульовою сумою буде повернуто помилку:
"res": 1133,
"res_action": 3,
"errortxt": "Фіскалізація чеків з наявними товарами та нульовою сумою заборонена. Для фіскалізації такого чеку необхідно передати \"allow_zero_sum\": true в об`єкт fiscal.receipt",
Передавати "allow_zero_sum": true
обов'язково тільки у випадках якщо загальна сума чеку після всіх знижок буде 0.
Фіскалізація "нульових" чеків без товарів та оплат працює без змін.
7) Виправлено помилку при увімкненні авторизації для доступу до вебінтерфейсу якщо до цього в попередніх версіях застосунку не було увімкнено дану авторизацію.
8) Блокування створення ПРРО на кількох пристроях (в кількох додатках) одночасно. У випадку якщо ПРРО уже було створено в одному із Device Manager спрооба створити в наступному буде неуспішна:
{
"res": 2022,
"errortxt": "ПРРО наразі використовується іншому на пристрої. Перед створенням каси видаліть її з попереднього пристрою після чого поверніться до створення. Якщо до попереднього пристрою більше немає доступу - зверніться до служби підтримки Вчасно.Каса для розблокування."
}
Для зняття блокування необхідно видалити ПРРО з попереднього додатку Device Manager або, якщо доступу до попереднього додатку немає - звернутись на техпідтримку сервісу Вчасно.Каса.
9) Можливість зміни розділювача для числових значеннь в друкованих формах. Стандартно розділювач ,
.
10) Можливість відключити перевірку готівки в касі("safe"
) при видачі решти("change"
) в чеках продажу/повернення та переказу коштів. Для цього в об'єкт fiscal.receipt
в json запиті необхідно передати "not_check_safe": true
. В такому разі перевірка доступного залишку при видачі решти не буде відбуватись.
11) Можливість виконати X, Z звіти по терміналу по протоколу BPOS1 для всіх мерчантів, при передачі в json запиті "merch": 0
.
12) Заборонено запускати Примусовий запуск реєстрації чеку переходу в онлайн
("task": 9
) в разі якщо уже виконується фіскалізація офлайн чеків.
13) Допрацювання фільтру по даті для періодичного звіту по датам ("task": 13
):
- Можливість вказувати повну дату та час в форматі YYYYMMDDHHMMSS, наприклад:
"dt_from": "20240408091021",
"dt_to": "20240408211021",
У разі вказання лише дати YYYYMMDD без часу, наприклад "dt_from": "20240401"
та "dt_to": "20240405"
буде вибрано всі звіти, дата закриття яких буде в проміжку між 01.04.2024 00:00:00 та 05.04.2024 23:59:59.
- у вибірку звітів потрапляють звіти, дата формування яких знаходиться в проміжку між
"dt_from"
та "dt_to"
.
- Допрацювання друкованих форм чеків та всіх звітів:
- Додано відображення номеру Z-звіту біля напису "Z-звіт";
- Додано блок
“Виручка“
з порахованою сумою доходу по видам оплат за результатом суми всіх чеків продажу - чеки повернення - видача готівки держателям ЕПЗ + операції переказу коштів - операції видачі коштів при переказі;
- Додано відображення залишоку готівки на початок зміни біля поточного залишку готівки в касі;
- Додано в періодичні звіти (
"task": 12
, "task": 13
) денний обіг з урахуванням округлення по продажам та додано обіг по чекам повернення.
- Додано блок з інформацією по зміні:
Дата та час відкриття зміни;
Дата та час закриття зміни;
Номер останнього чеку в зміні.
- Змінено назву звітів (
"task": 12
, "task": 13
) на "Періодичний звіт (повний)" та додано відображення номерів та дати першого та останнього звітів у вибірці.
- Приведено відображення будь яких дат та часу в чеках та звітах до єдиного формату:
dd.MM.yyyy hh:mm:ss
.
- Зміни в JSON відповіді:
- Додано при фіскалізації чеків продажу/повернення та переказу коштів суму товару після застосувань всіх знижок до даного товару(
"cost_after_disc"
) в масиві info.printinfo.goods
.
- Додано значення локального номеру ПРРО('"dfs_local_number"') у відповідях на всі завдання фіскалізації чеків та звітів в об'єкті
info.printinfo
.
- Додано масив об'єктів
income
в об'єкті info
з порахованою сумою "Виручки" за зміну по видам оплат для всіх звітів.
- Додано в об'єкті
info.summary
значення виручки загальної (income_p
) після обрахунку суми виручки по видам оплат для всіх звітів.
- Додано в масив об'єктів
info.reports
для періодичних звітів суму по чекам продажу з урахуванням округлення ("roundsum"
) та суму по чекам повернення ("returnsum"
).
- Додано в усі періодичні звіти номери звітів від(
"n_from"
) та до("n_to"
) що потрапили у вибірку в об'єкті info
, та дати першого("open_shift_dt"
) та останнього("close_shift_dt"
) звітів.
- Додаткові інфраструктурні допрацювання для більшої стабільності роботи додатку.
5.194.2 - patch від 14.02.2024
- У візуалізації чеків буде відображатись тип торгової точки додатково до її назви у рядку 2.
- У візуалізації чеків на внесення та винесення готівки вилучено відображення QR-коду.
- Додано перевірку поточної суми готівки у касі в разі оплати готівкою (
"type": 0
) та передачі суми решти ("change"
) > 0 для чеків на продаж. Якщо передана сума решти > ніж поточна сума готівки в сейфі (в касі) буде повернуто помилку при фіскалізації чеку:
"errortxt": "У касі недостатньо коштів для проведення даної операції"
5.194.1 - patch від 09.02.2024
- Виправлено помилку з блокуванням ПРРО з помилкою "Пристрій зайнятий" на всі наступні запити у разі якщо додаток отримав запит на ПРРО після запуску до завершення ініціалізації бібліотеки підписання.
Для таких випадків додаток у відповідь по API буде повертати натупний json з описом помилки:
{
"ver": 6,
"source": "",
"device": "postgres1",
"tag": "",
"task_status": 3,
"type": 1,
"task": 18,
"dt": "20240208165440361",
"res": 1016,
"res_action": 1,
"errortxt": "Internal error: Бібліотека ЕЦП ще не ініціалізована. Зачекайте та спробуйте ще раз.",
"aq_errortxt": "",
"warnings": []
}
- Додано очищення сформованих чеків та офлайн номерів по ПРРО в разі видалення ПРРО із застосунку.
- Виправлено помилку з відображенням назви для знижки якщо назву не передано в запиті при передачі знижок за допомогою масиву
"discounts"
.
- Допрацювання завдання 23 для пошуку/друку раніше фіскалізованого чеку по його фіскальному номеру.
Приклад запиту
curl --location 'http://localhost:3939/dm/execute-pkg' \
--header 'Content-Type: application/json' \
--data '{
"ver": 6,
"source": "DM_API",
"need_pf_img": 2,
"device": "postgres1",
"type": 1,
"fiscal": {
"task": 23,
"fiscal_number": "TEST_IMkWddWkHpi9tg"
}
}'
Можна використовувати при відправці запиту на ендпоінти для отримання інформація або додатково друку на принтері: /dm/execute
, /dm/execute-prn
, /dm/execute-pkg
Якщо чек, в даному випадку з фіскальним номером TEST_IMkWddWkHpi9tg не було знайдено буде отримано у відповідь помилку:
"errortxt": "Чек з фіскальним номером TEST_IMkWddWkHpi9tg не знайдено"
5.194 - release від 05.02.2024
-
Додано в підтримку нові банки та додаткові протоколи для існуючих банків при роботі з терміналами:
-А-Банк
- додано можливість підключати термінали за допомогою протоколу JSON
;
-Банк Південний
- додано можливість підключати термінали за допомогою протоколу BPOS Light
;
-Укрсиббанк
- додано можливість підключати термінали за допомогою протоколу BPOS Light
;
-Банк Восток
- додано можливість підключати термінали за допомогою протоколу BPOS Light
;
-Банк Sense
- додано можливість підключати термінали даного банку що використовують протоколиBPOS1
, POSAPI
та SimPays ККМ
;
-Банк ТАС
- додано можливість підключати термінали даного банку за допомогою протоколу SimPays ККМ
.
-
Додано можливість друкувати додаткову текстову інформацію та різного типу коди в формі чеків на продаж ("task": 1
) та на повернення ("task": 2
).
Підтримувані типи кодів:
-QR-код
-code128
-ean13
Для передачі даної інформації використовується масив об'єктів "lines"
(кожен код чи текст передається окремим об'єктом з параметрами в масиві) в об'єкті "fiscal"
в json запиту на фіскалізацію чеку (аналогічно функціоналу в завданні 5 ("task": 5
), але з додатковими параметрами розміщення в чеку та налаштуваннями).
Можливості налаштування:
-"qr_type"
- тип. 0 - текстова інформація, 1 - штрихкод (ean13), 2 - штрихкод (code128), 100 - QR-код.
-"t"
- текстова інформація. При "qr_type": 0
- просто текст для відображення в формі чеку, інні значення - інформація що буде поміщена у відповідний код.
-"position"
- позиція для відображення інформації. 1 - перед чеком, 2 - після "хедера" чеку, 3 - перед сумою чеку, 4 - перед "футером" чеку, 6 - після "футера чеку". Додаткові позиції будуть додаватись по запитам на техпідтримку.
-"qr_p"
- розмір коду у % до ширини стрічки (не використовується якщо "qr_type": 0
). 100 - вся ширина чеку, 75 - 75% ширини чеку для штрихкодів і так далі, для QR-кодів змінюється ширина та висота.
-"qr_height"
- висота штрихкоду (не використовується якщо "qr_type": 0
або "qr_type": 100
). 1 - висота 0.5см., 2 - висота 1.3см., 3 - висота 2см.
-"qr_print_txt"
- друк текстового представлення інформації в коді під самим кодом знизу (не використовується якщо -"qr_type": 0
) false - не друкується, true - друкується.
-"align"
- вирівнювання відносно чеку якщо "qr_p"
менше 100 (в поточній версії не використовується якщо "qr_type": 0
текст за замовчуванням - зліва). 1 - зліва, 2 - по центру, 3 - з правого боку.
Позиції:
Важливо! дана інформація буде відображатись лише в візуалізації чеків та на друкованих чеках з додатку(в тому числі друковані форми різного формату) та не передається в ДПС навідміну від коментарів в чеку.
- У відповіді на завдання відкриття зміни по ПРРО (
"task": 0
) повертається id зміни "shift_id"
у форматі uuid. Id зміни можна використати для перегляду інформації по чекам в зміні через ендпоінт /dm/vchasno-kasa/api/v1/shiftdocs?shift_id=
- Виправлено відображення знижок та податків у чеках та звітах що було сформовано на попередніх версіях застосунку.
- Виправлено відображення баз оподаткування(поле "Обіг") для податкових груп де включено податок та додатковий збір(наприклад Акциз) у візуалізаціях звітів (X, Z, періодичний звіт по номерам, періодичний звіт по датам).
- При помилці підключення до бази даних у разі проблем з доступністю бази чи проблем з самою БД додаток буде запускатись і пробувати повторно підключитись до бази даних 1 раз в 30 секунд.
В цей час у відповідь на всі API завдання додаток буде повертати інформацію про помилку яка не дає продовжити запуск додатку.
- Виправлено помилку зі збереженням лише останніх 2-ух файлів логів за день.
- Встановлено таймаут в 5 секунд на очікування відправки даних для друку на принтер, та виконано допрацювання для стабільності роботи.
При роботі через /dm/execute-prn
, /dm/execute-pkg
якщо за 5 секунд не вийде з'єднатись з принтером буде повернуто відповід на завдання по ПРРО, також в об'єкті "info"
значення "isprint"
буде рівне 0, тобто чек не було надруковано.
- Для терміналів банків, що мають кілька доступних протоколів додано можливість обрати при підключенні потрібний
- Додано інформаційне повідомлення у разі якщо протокол терміналу або сам термінал не повертає список мерчантів проте, термінал працює та може проводити оплати.
- Виправлено помилку у відповіді на завдання фіскалізації чеку коли знижка на чек в масиві
"disconuts"
сумувалась зі знижкою на весь чек переданою без масиву.
- Зроблено оновлення бібліотеки та встановлення налаштувань для стабілізації роботи з базою даних SQLite.
- Додано відображення коректної помилки для терміналів на протоколі BPOS1 якщо COM порт вказаний в налаштуваннях терміналу існує, проте це не термінал.
- Виправлено відображення розділювальних ліній у візуалізації чеків на продаж/повернення.
- Додано нові параметри згідно вимог НБУ для виконання p2p переказів(
"task": 4
) для терміналів Ощадбанку:
”rec_name”
: - ім'я отримувача латиницею.
”rec_surname”
: - прізвище отримувача латиницею.
”rec_pan”
: - PAN(номер картки) отримувача.
- Прибрано валідацію у вебінтерфейсі на введення числових значень на сторінці пакетного режиму в полі для введення номеру мерчанту.
- Додано підсказки у випадаючих списках з доступними в системі пристроями при підключенні принтерів по Bluetooth та COM та при підключення терміналів по COM.
- Додано коректну помилку у відповідь якщо для терміналів Приватбанку відключена можливість здійснювати певні операції із доступних в ДМ.
5.193.1 - hotfix від 13.12.2023
- Виправлено помилку з виконанням X/Z звіту після оновлення додатку при відкритій зміні по ПРРО.
- Виправлено помилку з розрахунком бази оподаткування в масиві
"taxes"
в тегах "base_tax_sum_p"
, "base_tax_sum_m"
, "base_ex_sum_p"
, та "base_ex_sum_m"
для податкових груп.
5.193 - release від 12.12.2023
-
Додано підтримку Arch linux.
-
Зменшено максимальний таймаут на очікування відповіді від кабінету Вчасно.Каса при фіскалізації чеків до 10 секунд (5 секунд встановлення з'єдання, 10 секунд очікування відповіді після з'єднання).
-
Додано функціонал перевірки ключа ЕЦП при додаванні ключа до ПРРО через вебінтерфейс.
Якщо ключ було зчитано успішно - одразу буде запущена автоматична перевірка реєстрації даного ключа в ДПС для підписання чеків. У разі якщо по результату відповіді від ДПС ключ не зареєстровано - буде запропоновано заповнити заявку на реєстрацію даного ключа для роботи ПРРО.
Для тестових ПРРО перевірка ключа не виконується.
У разі якщо ключ не зареєстровано, після його успішного зчитування в додатку буде відображено наступне повідомлення:
-
Додано можливість підключати термінали А-Банку та Банку Південний по протоколу BPOS1. Інші протоколи які підтримуються даними банками будуть доступні в наступній версії.
-
Додано можливість по API передавати масові знижки на чек чи на позицію. Кілька знижок передається за допомогою масиву об'єктів "discounts"
. Можна передавати знижки як ранінше, або передавати лише масивом, або комбінувати з передачею масивом, аналогчно як з акцизними марками "code_a"
та "code_aa"
.
Всі відсоткові знижки на позицію чи на весь чек нараховуються послідовно. Тобто якщо є 2 знижки, наприклад, 20% і 10% - сума по чеку чи по позиції після застосування першої знижки 20% буде використана як база для застосування знижки 10%.
Приклад запиту чеку з масивом знижок
{
"ver": 6,
"source": "API",
"device": "postgres1",
"need_pf_img": 2,
"type": "1",
"userinfo": {
"email": ""
},
"fiscal": {
"task": 1,
"cashier": "Касир 1",
"receipt": {
"sum": 17000.00,
"disc": 3000,
"disc_type": 0,
"disc_name": "Бонусна система",
"disc_apply_type": 3,
"discounts": [
{
"disc": 3000,
"disc_type": 0,
"disc_name": "Використання сертифікату №111 на 3000грн.",
"disc_apply_type": 1
},
{
"disc": 3000,
"disc_type": 0,
"disc_name": "Використання сертифікату №222 на 3000грн.",
"disc_apply_type": 1
}
],
"rows": [
{
"code": "100",
"code1": "79545322",
"code2": "45632",
"code_a": "S5556667w",
"name": "Продкут \"1\"",
"cnt": 1,
"price": 22000,
"cost": 22000,
"disc": 0,
"disc_type": 0,
"disc_name": "",
"disc_apply_type": 3,
"discounts": [
{
"disc": 3000,
"disc_type": 0,
"disc_name": "Бонуси",
"disc_apply_type": 3
},
{
"disc": 2000,
"disc_type": 0,
"disc_name": "Акція",
"disc_apply_type": 3
}
],
"taxgrp": 3,
"comment": "Коментар до продукту 1"
}
],
"pays": [
{
"type": 2,
"sum": 8000,
"paysys": "VISA",
"rrn": "1235567377",
"cardmask": "1223******1111",
"term_id": "SK014677",
"bank_id": "БАНК",
"auth_code": "AA12345678",
"comment": "коментар до оплати картою"
}
]
}
}
}
Приклад друкованої форми чеку
- Додано обмеження на видалення чеку з ДПС якщо останній чек уже було видалено до цього. Можна видалити лише один чек, після чого для видалення потрібно зареєструвати новий чек, інакше видалення буде заборонено.
- Виправлено помилку з аварійним завершенням роботи додатку при відправці запиту на термінал що використовують протокол POSAPI (Райффайзенбанк, ПУМБ) x32 розрядної версії на Windows.
- Виправлено помилку при передачі залишку готівки в касі в кабінет Вчасно.Каса якщо увімкнено передачу залишку та зміну було відкрито в офлайні.
- Виправлено помилку при спробі пошуку терміналу при його створенні в додатку на бд MS SQL.
- Виправлено помилку відправки суми на термінал на копійку менше актуальної суми оплати для протоколів BPOS1 та POSAPI.
- Виправлено помилку при оновленні додатку поверх з старої версії на нову через інсталяційний пакет на Windows.
- Додано перемикач "Очікування опрацювання терміналом попереднього запиту перед наступним" в налаштуваннях терміналів Приватбанку. Параметр встановлює очікування в 4 секунди перед кожним запитом на термінал.
Потрібно обов'язково увімкнути для роботи на терміналі Verifone VX520
від Приватбанку.
-
Виправлено помилку з відображенням коректного номеру мерчанту в разі якщо номер, встановлений банком, більше 10 знаків.
-
Можливість змінювати максимальну та мінімальну кількість офлайн номерів для роботи ПРРО в режимі офлайн.
Мінімальна кількість - кількість при досягненні якої буде виконано запит номерів в ДПС.
максимальна кількість - та кількість яка запитується в ДПС (наразі максимально можливо встановити 20000 номерів на один ПРРО).
Поточні налаштування будуть отримані з Кабінету Вчасно.Каса і відображатимуться в блоці "Інформація про ПРРО"
-
Додано перепідключення до postgresql бази у разі обриву з'єднання з боку БД при активній сесії.
-
Змінено текст помилки для терміналів що працюють по протоколу BPOS1 у разі якщо не вдалось обробити код помилки:
Повідомлення від банку: Операція неуспішна. Код відмови %s
%s - буде замінено на код відповідці процесингового центру банку отриманого від терміналу.
-
Додано параметр IgnoreConnError
в секцію [Database]
в конфігураційний файл для примусового запуску додатку в разі помилки підключення до бази даних. Можна використовувати у випадках коли база дани і додаток знаходяться на різних пристроях і при старті додатку не встигає запуститись база даних.
У разі встановлення IgnoreConnError=1
додаток після запуску 1 раз в 30 секунд буде виконувати спробу підключитись до бази даних та виконати всі необхідні запити для отримання даних із БД.
Якщо підключення до бази даних не було виконано у відповідь на всі API методи буде повернуто помилку, наприклад:
{
"ver": 6,
"source": "",
"device": "",
"tag": "",
"task_status": 3,
"type": -1,
"task": -1,
"dt": "20231211141310542",
"res": 1130,
"res_action": 3,
"errortxt": "Виникла помилка при підключенні до БД: Cannot connect to server on host 'localhost':\r\nПодключение не установлено, т.к. конечный компьютер отверг запрос на подключение.\r\nSocket Error Code: 10061($274D)",
"aq_errortxt": "",
"warnings": []
}
У разі якщо підключення буде виконано можна працювати з ПРРО та пристроями як зазвичай.
Параметр IgnoreConnError
не сумісний із ServiceName
. Дозволено використовувати лише один.
-
У json відповідь по API на викоання X/Z та періодичних звітів було додано окремі параметри в масив об'єктів "taxes"
в значенні яких будуть бази оподаткування для податкових груп із додатковим збором.
"base_tax_sum_p"
- база оподаткування по основному податку (наприклад ПДВ 20%) по чекам продажу.
"base_tax_sum_m"
- база оподаткування по основному податку (наприклад ПДВ 20%) по чекам повернення.
"base_ex_sum_p"
- база оподаткування по додатковому збору (наприклад Акциз 5%) по чекам продажу. Якщо податкова група не має додаткового збору - завжди 0.
"base_ex_sum_m"
- база оподаткування по додатковому збору (наприклад Акциз 5%. Якщо податкова група не має додаткового збору - завжди 0.
-
В фіскальних чеках QR-код тепер містить посилання на візуалізацію чеку в кабінеті ДПС (https://cabinet.tax.gov.ua/cashregs/check) з додатковими обов'язковими параметрами:
ФН чеку(id),
дата (date),
час (time),
фіскальний номер ПРРО (fn),
сума чеку (sm),
контрольне число (mac)
Приклад:
https://cabinet.tax.gov.ua/cashregs/check?id=TEST_OFN_WeBKHz774mvTOQ&date=20231207&time=10:51:36&fn=3&sm=8000&mac=c1d019bc8d1dce852e371e0149b8655627f247fcc7160deb6ab953c3522f4919
У тестових чеках QR-код містить посилання на кабінет Вчасно.Каса (https://kasa.vchasno.ua/) з додатковими реквізитами.
Приклад:
https://kasa.vchasno.ua/c/TEST_VbS7yd6TPtgdqw?MAC:c086300d35d95c67b0b47fba07bc91098a8c87b44f3c1c2aeecc1df4c40d7624;DT:20-12-2023T14:55:14;FR:TEST_VbS7yd6TPtgdEw;SUM:17000;FN:400000000
-
Встановлено налаштування підключення для більш стабільної роботи бази даних sqlite при раптових збоях в живленні комп'ютеру при фіскалізації чеку.
-
Додано очікування в 10 секунд перед запуском автоматичної очистки чеків при закритті зміни.
5.192.1 - hotfix від 06.11.2023
- Виправлено помилку із запуском бібліотеки підписання при старті застосунку на Linux.
- Виправлено помилку при відправленні запиту на оплату по терміналам Приватбанку.
5.192 - release від 06.11.2023
- Очистка чеків відбувається після закриття зміни та повернення відповіді по звіту по API, для отримання відповіді по z-звіту в межах стандартного таймауту на відповідь у POS системі, якщо очистка займає багато часу.
Звертаємо увагу що якщо у вас використовуєтсья стандартна база даних sqlite після запуску очистки, тобто після закриття зміни по конкретному ПРРО, можуть бути затримки у відповідях на наступні завдання поки не завершиться процес очистки.
-
Зміна процесу отримання сертифікатів ключів ЕЦП та процесу оновлення кореневого сертифікату для стабільної роботи ключів ЕЦП у разі оновлення сертифікатів з боку АЦСК.
-
Виправлено проблему при спробі відкрити зміну якщо по касі сталась помилка при отриманні офлайн номерів до відкриття зміни.
-
Виправлення оновлення налаштувань по касі та податкових груп і типів оплат з кабінету Вчасно.Каса при відкритті зміни по ПРРО якщо по ПРРО виконувались службові завдання до відкриття зміни.
-
Оновлено бібліотеку підписання iit до актуальної версії.
-
Виправлено відправку суми до оплати на термінал на 1 копійку менше ніж в запиті для терміналів Ощадбанку, Укрсиббанку, Банку Восток, Райффайзенбанку, Банку ПУМБ.
-
Виправлення роботи Зворотної синхронізації.
-
Виправлено помилку при спробі запросити документи за конкретну зміну (/dm/vchasno-kasa/api/v1/shiftdocs
) з параметром відображення сервірсних чеків (service=1).
-
Метод /dm/vchasno-kasa/api/v1/settings замінює лише ті налаштування що передані в запиті без скидання до стандартних налаштуваннь параметрів що не передані в запиті.
-
Додано інфоромацію про поточні ліміти часу роботи в офлайні для ПРРО.
-
Виправлено помилку з відсутністю кодування windows-1251 в XML чеку.
-
Виправлено проблему з отриманням відповіді від терміналів Приватбанку.
-
Для терміналів Приватбанку, за замовчуванням, відключено можливісь асинхронного запиту статусу поточної операції з терміналу. Для включення даної можливості потрібно перейти в налаштування терміналу та увімкнути перемикач
-
Виправлено помилку при обрахунку сум по документам за зміну на postgresql версіях 10+.
-
Виправлено помилку з екрануванням апострофа ('
) в назві ПРРО та пристроїв.
-
Виправлено розрахунок "sum"
для чеків продажу/повернення для методу /dm/vchasno-kasa/api/v1/shiftdocs
-
Додано розрахунок суми по продажам/поверненням та податкам для методу /dm/vchasno-kasa/api/v1/shifts
при відкритій зміні по ПРРО.
-
Виправлено помилку з відображенням в друкованій формі Z-звіту що звіт видано в режимі офлайн якщо перехід в офлайн відбувся на фіскалізаціх звіту в ДПС.
-
Розширено таймаут до 5 секунд на встановлення з'єдання з терміналами Приватбанку.
-
Авторизація, якщо увімкнена в налаштуваннях, тепер працює на всі методи що мають в ендпоінті:
/dm/api/v1/
/dm/api/v2/
/dm/api/v3/
-
Додано можливість вказувати назви для знижок на товар та весь чек для відображення назви в чеку за допомогою тегу "disc_name"
.
-
Додано можливість передавати тип застосування знижки для застосування знижки як фактично знижки на товар, або для застосування її як зменшення на суму передплати у випадку використання змішаної форми оплати (передплата/післясплата за товар) за допомогою тегу "disc_apply_type"
.
Приклад:
Знижка на товар
"disc": 50,
"disc_type": 1,
"disc_name": "Передплата",
"disc_apply_type": 1,
Знижка на весь чек
"disc": 50.00,
"disc_type": 1,
"disc_name": "Акція",
"disc_apply_type": 3,
Друкована форма:
Z-Звіт (розділ "Знижки")
5.191 - release від 29.09.2023
- Додано новий банк для підключення терміналів - Банк ПУМБ.
- Можливість встновити Device Manager для роботи на Arch Linux.
- Перезапит офлайн номерів у фоновому режимі. Додатково до отримання офлайн номерів при відкритті зміни та при виході з офлайну тепер помери будуть поповнуватись додатково якщо каса онлайн та номерів немає або менше як 1500. Періодичність запиту якщо номери не були отримані від ДПС - 1 раз в кожні 10хв. не залежно чи зміна відкрита чи закрита.
- Додано можливість отримати інформацію про останню проведену транзакцію по терміналу за допомогою ендпоінту
/dm/lasttransaction
. Інформації по останній транзакції буде повернута в JSON форматі. Структура аналогічна як і мала б бути у відповіді на оригінальний запит.
- Додано можливість асинхронно отримувати статус поточної активної операції від терміналу через енпоінт
/dm/transaction-status
. Якщо по терміналу є активна операція у відповідь на запит буде надано статус код від терміналу та текстовий опис статусу поточної операції для виводу на екран касиру чи клієнту будь то оплата чи інша операція.
- Можливість пошуку терміналу в мережі або через COM при створенні терміналу в додатку. Можливість знайти лише один термінал або кілька якщо вони підключені. Пошук за замовчуванням буде відбуватись у ті й же підмережі для якої підключений пристрій де встановлено ДМ.
- Розширено функціонал пакетного режиму:
- При підключеному терміналі можливість проводити повернення/скасування оплати по терміналу та чек повернення по ПРРО та виконувати x/z - звіти з терміналу і ПРРО одночасно.
- При підключеному принтері можливість друкувати всі документи і чеки що мають друковану форму.
- Можливість в налаштуваннях пакетного режиму при роботі з терміналом обрати при яких типах(кодах) оплати переданим в запиті буде відправлено запит на термінал. Можливість обрати кілька типів оплат замість стандартного типу 2 Картка.
- Збереження логів по роботі терміналів в окремій директорії.
- Відключення ПРРО у разі проблем в роботі та можливість відключити/включити ПРРО вручну. У разі якщо ПРРО повторно отримує помилки які не вирішуються без втручання(наприклад ПРРО скасовано в ДПС або змінено токен для ПРРО) ПРРО буле заблоковано для роботи і проведення подальших операцій до моменту вирішення проблеми.
Якщо відключити ПРРО вручну за допомогою кнопки "Заблокувати ПРРО" у вкладці "Інженерні функції" по ПРРО також буде заблоковано проведення чеків і інших операцій до моменту розблокування вручну.
- Додано новий тип операцій: P2P перекази для протоколу BPOS1(Ощадбанк, Укрсиббанк, Банк Восток).
- Виправлено помилки отримані від терміналу для протоколу BPOS1(Ощадбанк, Укрсиббанк, Банк Восток) при виконанні операції продажу з видачею готівки та P2P переказу.
- Включено автоматичну очистку чеків старших 40 днів при встановленні ДМ на новий пристрій.
- Відображення всіх даних по еквайрингу в чеку та коригування форми чеків під розміщення всіх реквізитів.
- Коригування друкованої форми чеку видачі готівки держатетелям ЕПЗ.
- Коргування роботи автооновлення на всіх версіях linux.
- x64 APK версія додатку для android.
- Додано перевірку на мінусову суму в типах оплат при фіскалізації чеків. При відправці чеку з мінусовою сумою буде видано помилку.
- Додано перемикач для автоматичного відкриття/не відкритя грошового ящику при роботі через /dm/execute-pkg і /dm/execute-prn
- В реєстр змін і документів додано суму по продажам і поверненням окремо.
- Виправлено помилку при підключенні терміналів Укрсиббанку через COM порт.
- Додано можливість видалити останній проведений чек з ДПС та з додатку у разі помилкової фіскалізації.
- Виправлено помилку коли чек не надходив на пошту/viber/смс якщо чек видано в режимі офлайн, при цьому передано дані клієнта.
- Виправлено помилку при розрахунку бази сум податків при застосуванні знижок у випадку якщо вартість товару > суми чеку.
- Виправлено помилку коли сума(sum) документу(чеку) повертається без урахування загальної знижки на чек в реєстрі чеків для чеків продажу і повернення.
- Виправлено автоматичний розрахунок вартості товару в чеку якщо не передано cost.
- Розширено перелік файлів при ручній очистці сертифікатів ключів.
- Виправлено помилку з некоректними значеннями type і task у відповідь на завдання оплати по терміналам.
- Виправлено помилку зі зникненням створеного пристрою в інтерфейсі на sqlite.
- Виправлення нумерації чеків при передачі даних в ДПС якщо було здійснено перехід в офлайн та видалення службового дубля.
- Виправлено повернення мінусового залишку при виконанні task:18 для кас по яким не було проведено чеків і змін.
- Виправлено формування неповного списку мерчантів для терміналів Приватбанку.
- Виправлено помилку при повторному пошуку чека по tag на postgresql.
- Виправлено повторний друк чеку при передачі в запиті copies > 1
5.190.2 - hotfix від 31.08.2023
- Виправлення помилки при формуванні вигрузки чеків в реєстрі чеків по зміні в форматі
csv
.
- Виправлено друк додаткових екземпрярів документів при роботі з принтерами та передачі
copies
> 1.
- Додано більш зрозумілі описи помилок у разі проблем з підключенням банківських терміналів.
5.190.1 - hotfix від 24.08.2023
- Виправлення помилки отримання інформації про нову версію при автоматичному оновленні додатку.
- Виправлення в json відповіді для завдань 1, 2 (чек на продаж/повернення) значення
type
при передачі в запиті тип оплати 0 (Готівка).
5.190.0 - release від 23.08.2023
- Новий процес підключення принтерів та терміналів через вебінтерфейс.
- Реалізація сумової і відсоткової знижки на весь чек та відсоткової знижки на позицію в чеку. Детальніше за посиланням.
- Можливість підключити принтери по USB до linux.
Якщо принтер в системі всього один в назві при створенні можна нічого не вказувати, якщо принтерів кілька треба в назву вказати шлях до принтера.
Перший принтер має шлях /dev/usb/lp0
Другий /dev/usb/lp1
Третій /dev/usb/lp2
і так далі...
- Можливість підключити bluetooth принтери для windows.
- Додано підтримку терміналів Банку Восток.
- Додано відображення загальної суми податків в реєстрі змін та чеків. По ендпоінтам
/dm/vchasno-kasa/api/v1/shifts
і /dm/vchasno-kasa/api/v1/shiftdocs
повертаються значення податку для чеків і звітів.
tax_all_p
- податок з чеків на продаж;
tax_all_m
- податок з чеків на повернення.
- Додано можливість друкувати чеки та звіти з реєстру чеків через вебінтерфейс.
Якщо в ДМ підключено один принтер - друк буде відбуватись саме на цей принтер;
Якщо в ДМ підключено 2 і більше принтерів, потрібно до каси підв'язати принтер, тобто додати його в налаштуваннях пакетного режиму. Тоді друк буде йти вибраний принтер в налаштуваннях пакетного режиму.
- Додано можливість переглянути введений пароль при зчитуванні ключа ЕЦП.
- Виправлено відображення помилок отриманих від банку для терміналів Ощадбанку, Укрсиббанк та Банку Восток.
- Зменшення максимального таймауту з'єднання з кабінетом Вчасно.Каса при фіскалізації чеку до 40сек.
- Додано можливість вигрузити логи по кнопці в інтерфейсі напряму через браузер. По натисненню з браузеру скачається архів з логами за вибраний період.
- Додано інформацію на сторінці ПРРО про кількість доступних офлайн номерів та кількість чеків виданих в офлайні (відображається лише якщо ПРРО зараз працює в режимі офлайн).
- Додано інформацію про АЦСК ключа ЕЦП на сторінці налаштувань ПРРО.
- Додано відображення букви податку при перегляді податкових груп на сторінці налаштування ПРРО.
- Виправлено помилку при підключенні терміналів Райффайзенбанку по USB/COM.
- Змінено умову для перевірки типу оплати для чеків видачі готівки держателям ЕПЗ. Тепер можна видати даний чек з будь якиим типом оплати окрім 0(
"Готівка"
).
- Зроблено виправлення для коректної роботи android терміналів Приватбанку.
- Виправлено відображення в друкованій формі чеку фіскального номеру чеку та контрольного числа без приведення до uppercase.
- Виправлено помилку при зчитування ключа ЕЦП на linux з паролем кирилицею.
- Можливість по ендпоінту
/dm/vchasno-kasa/api/v1/doc
отримати форму у вигляді команд на принтер для друку чеку на принтер що підключено в ДМ. В параметрах GET запиту вказати form=doc
.
- Виправлено поверення повної інформації в json відповіді у випадку фіскалізації чеків за допомогою ендпоінтів
/dm/execute-prn
і /dm/execute-pkg
.
- Виправлено помилку при створенні терміналів при роботі додатку на MS SQL або postgresql базі даних.
- Змінено текст помилки при редагування налаштувань пакетного режиму при відкритій зміні по ПРРО.
- Виправлено помилки при запуску зворотної синхронізації.
- Додано у відповідь для завдань 10 та 11 по ПРРО номер останнього фіскалізованого чеку в зміні. Додано в друковану форму додатково відображення номера даного фіскального чеку.
- Можливість вручну передати порт, якщо він відрізняється від порта за замовчуванням, при підключенні терміналів по ethernet.
- Виправлено некоректне значення task і type при помилка при роботі з завданнями по терміналам.
- Змінено схему очікування перед проведенням офлайнових чеків в ДПС при переходу в офлайн у разі проблем з боку серверу ДПС.
- Відображення таблиці зі списком мерчантів у вебінтерфейсі. Можливість отримати масив об'єктів типу мерчант в значенні параметру
merchList
по ендпоінту /dm/getmerchantlist
. Код мерчанта в таблиці використовується в запитах для ідентифікації по якому мерчанту буде проведено оплату.
Приклад з терміналу "Приватбанку"
- При перегляді візуалізації чекі в реєстрі використовується ширина виставлена в загальних налаштуваннях додатку замість стандартної.
- Додано значення статусу операції
task_status
при роботі з завданнями для ПРРО.
"task_status": 1
- чек було фіскалізовано в ДПС, або просто успішне виконання завдання якщо його виконання не передбачає відправку даних в ДПС.
"task_status": 2
- повертається якщо в запиті було передано значення tag
і чек з таким tag було знайдено в БД і повернуто повторну відповідь(без фіскалізації).
"task_status": 3
- помилка при пошуку в бд або при фіскалізації.
- Виправлено помилку при передачі некоректної назви каси в json запиті при роботі за допомогою
/dm/execute-prn
і /dm/execute-pkg
.
5.189.0 - release від 03.07.2023
- Можливість підключення та роботи з терміналами Райффайзенбанку через протокол POSAPI(windows/linux).
- Реалізація роботи по USB для протоколу ECS/POS для windows.
- Відключення функціоналу токену для інтеграції. Токен для пристроїв більше не встановлюється, та не редагується. Для авторизації запитів використовуєтсья лише назва ПРРО. При передачі токену в запиті, його значення буде проігноровано і якщо назва пристрою коректна, помилки не буде.
- Дані по еквайрингу в чеку(якщо такі передані) будуть відображатись в друкованій формі для всіх типів оплат окрім "Готівка".
- Допрацювання по процесу роботи з пакетним режимом(
/dm/execute-pkg
):
- Можливість роботи без помилок у випадку відсутності підключених пристроїв або якщо підключено лише принтер або термінал.
- Повідомлення в масиві об'єктів
warnings
у разі відсутності підключеного принтеру або терміналу.
- Перевірка коректності json даних отриманих в запиті перед відправкою запиту на термінал для уникнення помилок при фіскалізації після успішної оплати.
- Повертаємо назву банку(
"bankid"
) в json відповіді при роботі з терміналами Ощадбанку та Укрсиббанку.
- Коригування обробки та текстів помилок для терміналів Ощадбанку.
- Можливість відправки запиту на оплату по терміналу без вказання мерчанту. Якщо номер мерчанту не вказано він буде замінено на 1(окрім терміналів Райффайзенбанку).
- Зменшення висоти друкованого штрихкоду на 30% на чеку, а також відключення редагування його ширини при редагуванні розміру QR-коду в налаштуваннях принтеру.
- Можливість вказати назву для додатку через "Налаштування". Після збереження даних назва додатку буде відображатись на сторінці ПРРО та пристроїв.
Без назви:
Приклад налаштування:
Налаштувати можливо через вебінтерфейс через сторінку http://localhost:3939/dm/vchasno-kasa/settings.html або за допомогою API методу /dm/vchasno-kasa/api/v1/settings
змінивши значення для "server_alias"
Вигляд:
- Значення
"need_upd"
і "dfs_metr"
більше не повертаються в json відповіді від ДМ. Для отримання стабільності ДПС та наявності оновлень з версії 5.177 розроблено окремі методи.
- Відображення файлу завантаженого ключа через вебінтерфейс. Якщо обрано некоректний файл ключа буде відображено попередження та підсказка файл з яким розширенням потрібно вибрати.
- Виправлення по закритю зміни на банківському терміналі через вебінтерфейс.
- Виправлення по відображенню відповіді після перевірки зв'язку з банком та отримання списку мерчантів.
- При підключенні через USB можливість обрати принтер із підключених в системі. У випадку якщо ДМ не зміг отримати від системи список принтерів можливість вказати назву вручну.
- Виправлення проблеми з запуском додатку якщо при старті немає доступу для завантаження кореневого сертифікату та списку АЦСК.
- Виправлення проблеми з передачею некоректного залишку готівки по касі при переході в офлайн на відкритті зміни.
- Виправлення помилки з часом на чеку при фіскалізації чеку з автоматичним відкриттям зміни.
- Виправлення відображення податкового номеру та ІНН в друкованій формі чеку.
5.188.1 - hotfix від 06.06.2023
- Можливість не передавати масив оплат в чек(pays) при роботі в пакетному режимі(
/dm/execute-pkg
) для сумісності з інтеграціями на старих версіях додатку.
- Виправлення по відображенню податкових ставок з 0% податку(Без ПДВ, ПДВ 0%, Без ПДВ + акциз 5%, Не є об'єктом ПДВ) в X,Z та у періодичних звітах.
5.188.0 - release від 01.06.2023
- Зміна друкованих форм чеку:
- Зменшення розміру друкованого чеку на 20-30%
- Зміна шрифту чеку для більшої читабельності
- Зміна схеми відображенню обігу та суми податку по податковим групам в завданнях: X-звіт, Z-звіт, періодичний звіт по номерам звітів, періодичний звіт по датам.
Приклад друкованого чеку(зліва: 5.188, справа: в попередніх версіях):
Приклад вигляду друкованої форми(зліва: 5.188, справа: в попередніх версіях):
Нова смема відображення податків в звітах(приклад вигляду звіту з усіма податковими групами).
Податки відображаються таблицею: ГРУПА-ОБІГ-ПОДАТОК
- Допрацювання по пакетному режиму.
/dm/execute-pkg
- Якщо масив pays порожній, вся сума оплати по чеку піде на термінал(стандартний процес для сумісності з попередніми версіями)
- Можливість роботи з заокругленням і кількома типами оплат(на термінал буде відправлена лише сума з типом оплати "Карта").
- Запит не відправляється на термінал(тільки друк чеку) у випадку оплати чеку типом оплати відмінним від "Картка".
- Реалізація чеку продажу з видачею готівки для терміналів ощадбанку.
- Повернення до старого інтерфейсу додатку в android, для сумісності з пристроями без google services.
- Формування черги запитів для службових завдань по терміналам.
- Реалізація методу GetMaskList для протоколу PrivatBankJSON
- Реалізація x-звіту для терміналів Ощадбанку.
- Повертаємо суму банківських транзакцій для терміналів Ощадбанку при виконанні X,Z звітів.
- Прибрали зайві налаштування для терміналів.
- Збільшення часу таймауту на завантаження оновлення додатку з 1хв до 5хв.
- Відкриття грошового грошового ящику при роботі з готівкою:
- Відкривається для чеків: продаж(
"task":1
), повернення("task":2
), внесення/винесення("task":3/4
) готівки з типом оплати "готівка"("type":0
)
- Відкривається для чеків видачі готівки держателям ЕПЗ(
"task":14
)
- Для всіх інших завдань та типів оплат грошовий ящик відкриватись не буде.
- Можливість увімкнути автоматичне відкриття зміни з проведенням першого фіскального чеку.
- Виправлення по обнуленню залишку при знятті Z-звіту.
- Якщо увімкнено налаштування
Залишок не передається зі зміни в зміну. Обнулення залишку під час закриття зміни, тобто при знятті z-звіту.
при знятті z-звіту буде показана сума залишку, вона ж буде в звіті. Всі методи що повертають залишок по касі, після закриття зміни, будуть повертати 0.
- Виправлення по формуванню друкованої форми для друку чеків.
- Виправлення автоматичної очистки файлових логів на всіх платформах.
- Можливість підключити термінал Ощадбанку за допомогою COM(фізичний COM порт + USB через драйвер.)
- Оновлення бібліотеки для роботи з терміналами Ощадбанку, Укрсиббанку.
- Оновлення кореневого сертифікату АЦСК автоматично у випадках тривалої роботи додатку без перезапуску.
- Виправлення по кодам і текстам помилок зі статусом зміни:
- При спробі закрити зміну(
"task":11
), якщо зміна уже закрита, помилка наступна:
...
"res": 1006,
"res_action": 3,
"errortxt": "Зміна по даному ПРРО була закрита. Повторне закриття неможливе",
...
- При спробі провести будь який чек окрім відкриття зміни(
"task":0
) і закриття зміни("task":11
), якщо автовідкриття зміни вимкнено і зміна зараз закрита, помилка наступна:
...
"res": 1092,
"res_action": 3,
"errortxt": "Зміна по даному ПРРО закрита. Для фіскалізації чеків необхідно відкрити зміну.",
...
При спробі відкрити зміну("task":0
) якщо зміна відкрита, помилка наступна:
...
"res": 1096,
"res_action": 3,
"errortxt": "Зміна по даному ПРРО уже була відкрита. Повторне відкриття неможливе",
...
- Невеликі виправлення для стабільності роботи додатку.
- Розширення логу при отриманні інформації про існуючі принтера в системі.
- Невеликі виправлення в роботі зворотної синхронізації.
- Вирізали компонент для роботи з usb принтерами під linux для сумісності з linux без x11(+GTK3).
5.187.0 - release від 04.05.2023
- Блокування роботи з ПРРО після аварійної заміни ЕЦП якщо зміна відкрита.
У випадку якщо було замінено ключ ЕЦП при відкритій зміні ПРРО не зможе переходити до режиму оффлайн, буде дозволено лише закриття зміни. Після закриття можна продовжувати роботу.
При спробі фіскалізувати чек не закривши зміну буде повернуто помилку
Приклад:
...
"res": 1124,
"res_action": 3,
"errortxt": "Для ПРРО \"Kasa_1\" був виконаний метод аварійної заміни ЕЦП, дозволено тільки закриття зміни(11)
...
- Зміни деяких текстів помилок на більш зрозумілі. Зміни в вебінтерфейсі: зміна описів деяких параметрів та функціоналу, автоматично створювати ПРРО з можливістю переходу в оффлайн.
- Можливість обнуляти залишок готівки по ПРРО при закритті зміни(налаштовуєтсья через кабінет Вчасно.Каса).
- Реалізація протоколу Universal Print для роботи з принтерами які підключено до операційної системи (працює для windows/linux). На заміну протоколу Windows printer.
- Відновлення роботи методів /dm/vchasno-kasa/api/v1/ziplogs та /dm/logfilepart, і відповідно можливість через вебінтерфейс вигрузити логи та переглянути поточний лог.
- Виправлення по роботі сервісу на linux при проблемах з підписанням.
- Невеликі виправлення в системі логування.
- Виправлення по формуванню друкованої форми при роботі з принтерами.
- Виправлення по коректності значень 'task' і 'type' у відповідь на API завдання.
5.186.1 - hotfix від 04.04.2023
- Виправлення по зчитуванню ключів АЦСК Україна на linux.
- Виправлення по роботі з сертифікатами ключів на linux.
5.186.0 - release від 30.03.2023
- Додано можливість передавати унікальний id мерчанта(тег
"submerch"
) для проведення транзакцій по терміналам для протоколу PrivatBankJSON.
- Повертаємо у відповідь у тегах
info.merch
info.submerch
значення отримане від терміналу для протоколу PrivatBankJSON.
- Зміни в процесі роботи з бібліотекою підписання та ключами ЕЦП, що дало більш стабільну роботу з підписанням чеків та зчитуванням ключів.
- Встановлення очистки банківських транзакцій що зберігаються в БД довше 90 днів.
- Очистка зайвої інформації при запуску зворотньої синхронізації.
- Метод перевірки зв'язку з терміналом
/dm/bankping
для протоколу PrivatBankJSON.
- Зміна необхідних параметрів для роботи методів
/dm/getmerchantlist
і /dm/bankecho
.
- Виправлення по некоректному відображенню суми звітів у загальному списку змін в реєстрі.
- Невеликі коригування в роботі з банківськими терміналами для протоколу PrivatBankJSON.
- Реалізація можливості проведення додаткових транзакцій: Видача готівки(Cashback), Оплата частинами, Повернення по оплаті частинами для протоколу PrivatBankJSON.
5.185.1 - hotfix від 16.03.2023
- Оновлення бібліотеки підписання та встановлення таймауту запиту до АЦСК в 5 секунд(для windows/linux).
- Можливість редагувати розмір шрифту для друкованих форм(в даній версії тільки pdf) через вебінтерфейс.
5.185.0 - release від 13.03.2023
- Допрацювання зворотньої синхронізації, виправлення помилок при синхронізації та покращення механізму збереження чеків.
- Допрацювання роботи протоколу BPOS1 для роботи з терміналами Ощадбанку. Покращення обробки помилок від терміналу, допрацвання некоректностей у відповідях від ДМ.
- Можливість переопитувати статуси транзакцій по терміналам. Записуємо всі результати транзакцій по спілкуванню ДМ і терміналу в БД для подальшої синхронізації з фронт системою за допомогою тегів
transaction_id
та transaction_search
в API запиті.
- Коректне відображення помилки при відсутності коштів на балансі.
- Додали параметр розміру шрифту для друкованих форм чеку в метод /dm/vchasno-kasa/api/v1/settings
параметр pf_fontsize
В даній версії функціонал працює лише для pdf друкованої форми. img та друк на принтер зі зміненим розміром шрифту буде в наступних релізах.
- Відключення таймауту в 9 секунд запиту до АЦСК.
- Коригування розміру та шрифту в pdf друкованій формі.
- Виправлення процесу реєстрації чеку винесення готівки у разі переходу в оффлайн.
- Видаляємо зайві дані по чекам при запуску "Зворотної синхронізацї"
- Невеликі виправлення для стабільності роботи.
5.184.0 - release від 14.02.2023
- Можливість роботи з postgresql.
- Виправлення роботи автооновлення додатку на Windows.
- Реалізація автооновлення додатку для Linux(deb + rpm).
- Допрацювання інтерфейсу запуску автооновлення по кнопці.
- Метод
/dm/api/v1/sys_info
повертає інформацію яка субд використовується для роботи.
- Додано блок "Системна інформація", у вкладку "Налаштування", із загальними даними по системі на якій працює додаток.
- Можливість налаштування механізму очікування запуску серверу БД після запуску ДМ у разі використання MS SQL або postgresql.
- Повтор підключення до БД у разі невдалої спроби при використанні MS SQL або postgresql.
- Заміна оффлайнових номерів із переліку доступних у випадку помилки про невалідність фіскального номеру з боку ДПС.
- Замінено тексти помилок у відповідь по API на фіскальні завдання при відсутності оффлайнових номерів.
- Якщо по касі немає оффлайнових номерів, тобто ще не отримано номерів від ДПС:
"errortxt": "Відсутні оффлайн номери для роботи ПРРО в режимі оффлайн. Отримання номерів, від ДПС, буде здійснено автоматично, після успішного відкриття зміни в режимі онлайн."
- Якщо по касі є оффлайн номери, але всі були використані, тобто не зайнятих не залишилось:
"errortxt": "Закінчились оффлайнові номери для роботи ПРРО в режимі оффлайн. Було використано всі номери для чеків під час роботи в оффлайні. Отримання номерів буде здійснено автоматично після успішної реєстрації оффлайнових чеків та переходу до режиму онлайн."
- Виправлено помилку при збереженні налаштувань можливості переходу в оффлайн
- Виправлено механізм перевірки статусу ПРРО.
- Виправлено формування чеків однаковою датою при переході в оффлайн.
- Виправлено механізм отримання налаштуваннь по ПРРО для ініціалізації пристрою.
5.183.0 - release від 11.01.2023
- Реліз емулятора РРО та допрацювання можливості роботи по ethernet.
- Коригування механізму логування додатку для правильного створення файлів логу та вирішення проблеми зависання у випадку використання ДМ як серверного рішення.
- Виправлення відображення іконки документації у вебінтерфейсі.
- Зміна налаштувань підключення до бази даних для всіх платформ для стабілізації роботи та зменшення кількості збоїв БД.
- Змінено текст помилки у разі таймауту запиту до АЦСК на більш зрозумілий.
- Виправлення зависання ПРРО в режимі оффлайн у випадку збою автоматичного запуску механізму для проведення оффлайнових чеків.
5.182.0 - release від 24.11.2022
-
Встановили таймаут запиту до АЦСК в 9 секунд. Якщо АЦСК не відповідає або немає доступу, ПРРО перейде до режиму оффлайн(якщо ПРРО було дозволено перехід в оффлайн в налаштуваннях.
-
Змінили UI на Аndroid. Наразі функціонал у вебінтерфейсі на android аналогічний як і на windows/linux.
-
Версія Device Manager для linux red hat enterprise.
-
Додали відображення файлу логу за поточний день у вебінтерфейсі.
-
Змінили дані в QR-коді чеку згідно вимог ДПС. Посилання на чек у кабінеті Вчасно.Каса повертається у відповіді по API, параметр "qr" у QR-коді чеку знаходиться інформація яка міститься в полі "qr1".
-
Виправили пагінацію у реєстрі змін по ПРРО. Всі зміни та чеки тепер доступні для перегляду.
-
Покращили механізм перевірки даних при виході каси з оффлайн режиму, що значно зменшило кількість проблемних ситуацій при автоматичному виході з режиму оффлайн.
-
Виправили перевірку поточного статусу ПРРО при роботі в оффлайні.
-
Виправили відображення коректної суми готівки по чекам на повернення у періодичних звітах("task":12/13).
-
Виправлення по роботі з оффлайновими чеками при роботі з MS SQL.
-
Виправлення відображення візуалізації чеку при роботі з MS SQL.
-
Виправлення помилки при повторному запиту по tag чеку на якому було здійснено перехід до режиму оффлайн.
-
Автоматичне виправлення послідовності передачі чеків після збоїв ДПС на чеках відкриття/закриття зміни.
-
Додано текст "Звіт нульовано. Фіскальний звіт дійсний." до візуалвзації z-звіту.
-
Коректний розрахунок сейфу у разі якщо для ПРРО відключено тип оплати "готівка".
-
Виправлення помилки з вибіркою даних з БД ручним запитом.
-
Виправлення роботи мехізму вибору та запису оффлайнових номерів.
-
Прибрали перевірку "sign" для API методів роботи з пристроями(друк на принтери, термінали).
-
Виправили відображення помилок в роботі ПРРО з боку кабінету Вчасно.Каса.
5.181.2 - hotfix від 21.10.2022
- Дозволили змінювати максимальний часу роботи в оффлайні на місяць та за період.
- Виставили час очікування в оффлайні після переходу в 20хв на android.
- Виправили помилку при вигрузці чеків з реєстру на MS SQL
- Виправили відображення тексту в реєстрі змін при роботі на MS SQL на Linux.
5.181.1 - hotfix від 14.10.2022
- Оптимізували роботу з БД sqlite та роботу з індексами
5.181.0 - release від 06.10.2022
- Оптимізували роботу з базою даних що дало приріст по швидкості проведення чеків майже в 2 рази.
- Виправили помилку при видаленні дублю чеку при розриві зв'язку під час фіскалізації та переходу в оффлайн на Android.
- Виправили помилку формування першого оффлайнового чеку та чеку переходу в режим оффлайн однаковою датою при переході.
- Додали кнопку очистки сертифікатів ключів на Android та доробили функіонал перезапису сертифікатів.
- Встановили час очікування в 20хв після переходу до режиму оффлайн до початку фіскалізації оффлайнових чеків за рекомендаціями ДПС.
- Виправили помилку при роботі з мережевими принтерами на MS SQL.
- Розширили перелік помилок при роботі з ключами ЕЦП для точного розуміння причини помилки зчитування ключа. Детальніше в інструкції.
- Додали інформацію у вебінтерфейс про дату закінчення дії тарифу по ПРРО та інформацію по наявність коштів на рахунку для автоматичного продовження підписки.
В dashboard:
У блоці "Інформація про ПРРО"
- Поветаємо у відповіді по API інформацію по даті закінчення тарифу при проведенні чеку, під час відкриття/закриття зміни та у методах
/dm/vchasno-kasa/api/v1/dashboard
і /dm/vchasno-kasa/api/v1/prro?dev_id={{dev_id}}
.
Об'єкт "Billing"
"billing": {
"paid_date_to": "20221010030000000",
"enough_to_renew_subscription": 2
}
Опис значень "enough_to_renew_subscription"
enough_to_renew_subscription == 0 Не вдалось визначити, або ПРРО не підключено до системи автоматичного білінгу(якщо "paid_date_to": ""), або не вистачає коштів для активації усіх ПРРО в день деактивації по компанії. ПРРО може не активуватись автоматично якщо кошти будуть списані з балансу іншим ПРРО
enough_to_renew_subscription == 1 Кошти на рахунку в наявності, підписка на ПРРО продовжиться автоматично після закінчення терміну дії поточної.
enough_to_renew_subscription == 2 Відсутні, для того щоб каса продовжувала працювати після закінчення поточної підписки поповніть баланс в кабінеті Вчасно.Каса
- Оновили сертифікат для роботи з ключами ЕЦП на Android.
- Виправили некоректність відображення інформації в блоці "Інформація про ПРРО" на Android.
- Невеликі внутрішні виправлення в роботі додатку.
5.180.2 - hotfix від 14.09.2022
- Зміна налаштувань підключення до БД на linux.
- виправлення версії додатку на linux та Аndroid
5.180.1 - hotfix від 12.09.2022
- Виправлення роботи механізму автопроведення оффлайнових чеків.
- Виправили розрахунок суми з урахуванням округлень по готівці в періодичному звіті.
- Заблокували можливість відключити галку переходу в оффлайн якщо ПРРО в оффлайні.
5.180.0 - release від 05.09.2022
- Покрили всі виходи в мережу додатку через proxy, якщо увімкнено налаштування "Використовувати proxy-сервер".
- Перепрацювали механізм переходу в оффлайн згідно рекомендації податкової для стабільної роботи та виходу з режиму оффлайн.
- Виправили розрахунок параметру calc_p(«Всього» в розділі «Продажі» в періодичному звіті).
- Рішення для проблеми з зависанням каси в оффлайні після збоїв в податковій.
- Відображаємо помилку яка не дає касі перейти до режиму онлайн у разі зависання каси в оффлайні на тривалий час при відкритті зміни
"aq_errortxt"
у відповіді на відкриття зміни по ПРРО
- Виправлення у роботі web серверу.
5.179.0 - release від 11.08.2022
- Реалізували можливість роботи ПРРО через proxy в додатку на OS Windows. Налаштування можна встановити по API або через вебінтерфейс.
- Додали відображення версії додатку та стабільності ДПС у вебінтерфейсі якщо в додатку ше немає створених кас
- Додали механізм отримання оффлайнових номерів при відкритті зміни на новій касі згідно рекомендацій податкової.
- Виправлення не значних помилок при вибірці даних з БД.
5.178.0 - release від 25.07.2022
- Можливість увімкнути режим форсованого оффлайну в кабінеті Вчасно.Каса у вкаладці "Компанія" на всі каси ФОП чи організації.
- Повертаємо помилку друку у разі розриву зв'язку з мережевим принтером.
- Зміна налаштувань підключення до БД для виправлення помилки "Unable to open database file" на linux.
- Автоматичний вихід з режиму оффлайн на OC linux де спостарігались проблеми з зависанням каси в оффлайн режимі.
- Допрацювання функції "Зворотна синхронізація" яка дозволяє синхронізувати дані по останній зміні з кабінету Вчасно.Каса в додаток.
- Переносимо залишок по касі якщо зміна була закрита в режимі Оффлайн
- Успішний запуск додатку у разі збоїв в сервісі iit та при низькій швидкості інтернету.
- Виправлення помилки при автоматичному закритті зміни у разі якщо назва ПРРО містила спец символи.
- Додали перевірку часу на пристрої. У випадку якщо час на пристрої збився чеки не будуть проводитись задля уникнення помилок допоки не буде встановлено коректний час
- Виправили помилку яка не дозволяла у певних випадках касі перейти самостійно в режим онлайн після збоїв в ДПС.
5.177.0 - release від 06.06.2022
- Додали нові інженерні функції.
- Чек видачі готівки та друкована форма чеку даного чеку.
- Відображення чеку з користувацькою друкованою формою у візуалізації в додатку.
- Відображаємо залишок готівки на початок зміни у x та z звіті.
- Додали кнопку для очистки папки з сертифікатами ключів для їх перезапису.
- Виконання частини веб інтерфейсу в фоновому режимі для прискорення відображення інформації по ПРРО.
- Перенесення статусу в оффлайні при зміні місяця якщо ПРРО знаходиться в режимі оффлайн ще з минулого місяця.
- Нова функція Зворотня синхронізація дозволяє завантажити в додаток всі чеки по останній зміні з кабінету Вчасно.Каса.
- Невеликі виправлення помилок та покращення швидкості роботи додатку з базою даних.