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/receipt/sell/{checkId}/async-cancellation
Створює асинхронну операцію повної відміни або повернення товарів.
Логіка вибору типу операції:
якщо у body передано productsList з товарами — буде виконано RETURNING;
якщо productsList немає або він порожній — буде виконано CANCEL.
Після успішного виклику повертається operationId. Далі потрібно перевіряти статус через GET /v2/open-api/receipt/fiscalisation-operations/{operationId}.

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

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

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

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

Request

Path Params

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 'https://dev.e-check.com.ua/v2/open-api/receipt/sell/05fe9f96-3049-42c9-96e1-b48e301d9e25/async-cancellation' \
--header 'apikey: {{apikey}}' \
--header 'Content-Type: application/json' \
--data '{
    "shiftId": "4458e38b-30c8-4cab-b4da-8eefc165e6bf",
    "signTokenId": "79d80510-6275-4682-9593-50788b8e354c",
    "productsList": [
        {
            "id": "string",
            "quantity": 0
        }
    ],
    "withoutParentCheck": {
        "products": [
            {
                "id": "string",
                "name": "string",
                "quantity": 0,
                "price": 0,
                "tx": "string",
                "measurementId": 0,
                "discount": {
                    "type": "BY_SUM",
                    "value": 0
                },
                "exciseTaxStamp": [
                    "string"
                ],
                "uktzed": "string",
                "productCode": "string",
                "barCode": "string"
            }
        ],
        "paymentGroupsList": [
            {
                "paymentTypeId": 0,
                "paymentGroupId": 0,
                "paymentsList": {
                    "payerFullName": "string",
                    "payerCode": "string",
                    "payerPhone": "string",
                    "receiver": "string",
                    "edrpou": "string",
                    "receiverBank": "string",
                    "iban": "string"
                },
                "cardPayment": {
                    "cardType": "string",
                    "cardNumber": "string",
                    "terminalNumber": "string",
                    "cardNumberTerminal": "string",
                    "operationType": "string",
                    "bankName": "string",
                    "merchantAcquirerId": "string",
                    "paymentDeviceId": "string",
                    "paymentSystem": "string",
                    "authorizationCode": "string",
                    "transactionIdentifierRRN": "string",
                    "epzDetails": "string",
                    "invoiceNumber": 0,
                    "commissionSum": 0,
                    "deviceName": "string",
                    "cardSignText": "string"
                }
            }
        ],
        "withoutRounding": true,
        "checkNumberParent": 0
    },
    "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