Заокруглення в CashDesk

Механізм заокруглення в CashDesk дозволяє контролювати правила округлення сум у чеку під час проведення операцій з готівкою (у кабінеті CashDesk та через API Реалізація / Повернення та Реалізація / Повернення (для аптек). Згідно Постанови НБУ №25 від 15 березня 2018 року та Постанови Правління НБУ №115 від 08.09.2025 операції готівкою мають бути заокруглені.

Для операцій з готівкою в кабінеті CashDesk є такі правила округлення:

На продуктивному середовищі заокруглення виконується до 10 копійок.
На тестовому середовищі заокруглення виконується до 50 копійок.

Важливо

З 1 жовтня 2025 року правило заокруглення на продуктивному середовищі також зміниться на 50 копійок, відповідно до Постанови Правління НБУ №115 від 08.09.2025

інформація

Округленню підлягає лише форма оплати готівкою

Опис налаштування API

У методі Реалізація / Повернення та Реалізація / Повернення (для аптек) додано новий параметр round_rule, який використовується для контролю правил округлення суми чека.

В запиті на операцію з готівкою із заокругленням також потрібно передавати параметри round_sum та round_rule:

round_sum — сума округлення. Вказується різниця в копійках між округленим і не округленим значенням (зі знаком -(знижка) або +(надбавка) відповідно)

round_rule — текстовий параметр, який визначає правило округлення.

інформація

Якщо параметр round_rule відсутній у запиті на операцію з готівкою, використовується за замовчуванням round_rule = 10

Важливо

При інтеграції з CashDesk через SmartConnect для підтримки параметру round_rule необхідно завантажити тестову версію 266 за посиланням (адреса звернення: http://localhost:8000/)

SmartConnect

В SmartConnect підтримка параметра round_rule додана починаючи з версії 266. Інсталятор доступний для автооновлення з тестового середовища та розміщений:

Правила заокруглення сум при готівкових розрахунках (з 1 жовтня 2025 року)

Значення	Опис правила округлення	Примітка
0	Округлення вимкнено	—
10	Округлення до 10 копійок	Приклад
50	Округлення до 50 копійок	Приклад
100	Округлення до 1 грн	Підтримується SmartConnect від `266` версії (наразі не підтримується еКасою)

Заокруглення до 10 копійок

Сума, що закінчується від 1 до 4 копійок, округлюється в бік зменшення до найближчої суми, яка закінчується на 0 копійок.
Сума, що закінчується від 5 до 9 копійок, округлюється в бік збільшення до найближчої суми, яка закінчується на 0 копійок.

Заокруглення до 50 копійок

Суми від 1 до 24 копійок заокруглюються в бік зменшення до найближчої суми, що закінчується на 00 копійок.
Суми від 25 до 49 копійок заокруглюються в бік збільшення до 50 копійок.
Суми від 51 до 74 копійок заокруглюються в бік зменшення до 50 копійок.
Суми від 75 до 99 копійок заокруглюються в бік збільшення до найближчої суми, що закінчується на 00 копійок.