1. v2
ECHECK
  • for clients
    • 1. Авторизация
      • 1.3 Інформація по ЕП
      • 1.2 Оновлення сесії ЕП
      • 1.1 Login
      • 1.1.1 Login with Virtual key
    • 3. Робота з касою, у межах зміни
      • 3.1 Відкриття та закриття зміни
        • - Відкриття зміни
        • - Відкриття зміни із вказанням початкової суми готівки
        • - Закриття зміни
      • 3.3 Чеки
        • 3.3.1 Чек продажу
          • - Створення чернетки
          • - Фіскалізація чеку
          • - Фіскалізація чернетки
        • 3.3.2 Чек відміни
          • - Повна відміна чеку
          • - Часткова відміна чеку
          • - Відміна чеку, який відсутній у Єчек
        • 3.3.3 Чернетки
          • - Збереження чернеток
          • - Перелік чернеток
          • - Видалення чернеток
        • 3.3.4 Інформація по чекам
          • - Відправка чеку на емейл
          • - Перелік чеків по зміні
          • - Отримання чеку по id
        • 3.3.5 ФКЧ-3
          • - Фіскалізація ФКЧ3 (трансфер)
      • 3.4 Звіти Х / Z / періодичний
        • - Отримати html i pdf З-звітy по id
        • - Згенерувати З-звіт
        • - Отримати З-звіт по id
        • - Згенерувати X-звіт
        • - Згенерувати періодичний-звіт
      • 3.5 Інформація про зміни
        • - Перелік змін по касі
        • - Статус зміни по касі
    • admin
      • - login для адміністратора
      • - Перелік змін по касі
      • - Перелік кас
      • Отримати довідник одиниць виміру
      • - групи платежів
      • - типи платежів
      • - перелік чеків по касі
      • - додаткова інформація по чекам
      • - детальна інформація по чекам
      • - статус по касі
      • - перелік касирів
      • - баланс та готівка по зміні
      • - змінити свій apikey для компанії
      • - перевірити чи є з'єднання АПІ із ДПС
      • відкриття посилки на термінал
    • registration
      • new user
    • public
      • company-payments-type
  • async-method
    • v2
      • - Статус асинхронної фіскалізації зміни
        GET
      • - Статус асинхронної фіскалізації сервісного чеку
        GET
      • - Статус асинхронної фіскалізації чеку
        GET
      • - Асинхронне внесення/винесення готівки
        PATCH
      • - Асинхронна фіскалізація чеку продажу
        POST
      • - Асинхронна фіскалізація чеку переказу коштів
        POST
      • - Асинхронна відміна або повернення чеку
        POST
      • - Асинхронне відкриття зміни
        POST
      • - Асинхронне закриття зміни
        POST
  1. v2

- Асинхронне внесення/винесення готівки

Develop Env
https://dev.e-check.com.ua
Develop Env
https://dev.e-check.com.ua
PATCH
/v2/open-api/cash-register/cash/async
Створює асинхронну операцію сервісного чеку по касі.
Типи операцій:
RECEIVING_FUNDS — внесення готівки у касу;
ISSUING_FUNDS — винесення готівки з каси.
Сценарій роботи:
1.
Викликати PATCH /v2/open-api/cash-register/cash/async.
2.
Отримати operationId.
3.
Перевіряти статус через GET /v2/open-api/cash-register/fiscalisation-operations/{operationId}.
4.
Коли status = COMPLETED, у result буде інформація по касі/зміні та serviceCheckId.
paymentSum передається у копійках. На бекенді перед фіскалізацією значення переводиться у гривні.

Повторне надсилання запиту#

Збережіть clientCheckId до першого надсилання. Якщо відповідь загубилася або з’єднання перервалося, повторіть той самий запит із тим самим ідентифікатором і незміненими даними. Для наявної операції PENDING, PROCESSING або COMPLETED повертається попередній operationId без повторної постановки в чергу. Після FAILED повторне надсилання може створити нову операцію з новим operationId; надалі перевіряйте новий ID. Перед повторенням після помилки перевірте її причину та стан чека/зміни: FAILED сам по собі не доводить відсутності вже виконаних фіскальних дій. Змінені дані з попереднім ключем не оновлюють наявну операцію. Без клієнтського ідентифікатора сервер генерує новий, тому повторні запити не мають стабільного клієнтського ключа. Передавайте additionalInfo.clientCheckId. Використовуйте унікальний ідентифікатор для кожної нової операції, зокрема між типами операцій і касами.

Відповідь запуску#

Успішна відповідь містить { success: true, data: { operationId }, errors: null }. Поле status у відповіді запуску не повертається. Отримання operationId не означає успішного завершення фіскалізації; перевіряйте операцію через відповідний endpoint. HTTP-помилка запуску та помилка виконання під час polling — різні етапи.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
Async operation was created
Bodyapplication/json

🟠400Bad Request
🟠403Forbidden
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://dev.e-check.com.ua/v2/open-api/cash-register/cash/async' \
--header 'apikey: {{apikey}}' \
--header 'Content-Type: application/json' \
--data '{
    "shiftId": "4458e38b-30c8-4cab-b4da-8eefc165e6bf",
    "serviceCheckType": "RECEIVING_FUNDS",
    "paymentSum": 0,
    "signTokenId": "79d80510-6275-4682-9593-50788b8e354c",
    "additionalInfo": {
        "clientCheckId": "string",
        "userComment": "string"
    }
}'
Response Response Example
200 - Success
{
    "success": true,
    "data": {
        "operationId": "f44c9d98-7e46-43b1-a19c-b8636a89eed0"
    },
    "errors": null
}
Modified at 2026-10-23 08:33:16
Previous
- Статус асинхронної фіскалізації чеку
Next
- Асинхронна фіскалізація чеку продажу
Built with