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
POST
/v2/open-api/shift/open/async
Створює асинхронну операцію відкриття зміни.
Сценарій роботи:
1.
Викликати POST /v2/open-api/shift/open/async.
2.
Отримати operationId.
3.
Перевіряти статус через GET /v2/open-api/shift/fiscalisation-operations/{operationId}.
4.
Коли status = COMPLETED, у result буде інформація по відкритій зміні.
Якщо signTokenId не передати, бекенд підставить signTokenId з авторизації.
При потребі перенести баланс із попередньої зміни, ви можете вказати початкову суму готівки, (ця операція внесення не буде формувати сервісний чек у ДПС)
Якщо Ваша попередня зміна була закрита із залишком коштів у касі, тобто ви не провели вилучення готівки, за допомогою цього метода, Ви можете перенести ці залишки коштів у поточну зміну.
💡
упевніться що сума яку ви вказуєте у цьому методі є справді такою.

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

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

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

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

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Created
application/json
Async operation was created
Bodyapplication/json

🟠400Bad Request
🟠403Forbidden
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://dev.e-check.com.ua/v2/open-api/shift/open/async' \
--header 'apikey: {{apikey}}' \
--header 'Content-Type: application/json' \
--data '{
    "signTokenId": "79d80510-6275-4682-9593-50788b8e354c",
    "paymentSum": 0,
    "clientCheckId": "string"
}'
Response Response Example
201 - Success
{
    "success": true,
    "data": {
        "operationId": "f44c9d98-7e46-43b1-a19c-b8636a89eed0"
    },
    "errors": null
}
Modified at 2026-10-23 08:33:16
Previous
- Асинхронна відміна або повернення чеку
Next
- Асинхронне закриття зміни
Built with