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/async
Створює асинхронну операцію фіскалізації чеку продажу.
Сценарій роботи:
1.
Викликати цей метод.
2.
Отримати operationId.
3.
Перевіряти статус через GET /v2/open-api/receipt/fiscalisation-operations/{operationId}.
4.
Коли статус COMPLETED, у result буде id, fiscalId, fiscalisationTime і, якщо можливо, urlTax.
Якщо checkId не передано, бекенд спочатку створить pre-check на основі products.

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

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

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

Успішна відповідь містить { 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 'https://dev.e-check.com.ua/v2/open-api/receipt/sell/async' \
--header 'apikey: {{apikey}}' \
--header 'Content-Type: application/json' \
--data '{
    "checkId": "string",
    "idDraft": "string",
    "clientCheckId": "string",
    "signTokenId": "79d80510-6275-4682-9593-50788b8e354c",
    "cash": 0,
    "shiftId": "4458e38b-30c8-4cab-b4da-8eefc165e6bf",
    "checkHeaderText": "string",
    "checkFooterText": "string",
    "endingComments": [
        "string"
    ],
    "internalComments": "string",
    "initialComments": [
        "string"
    ],
    "discountAllCheck": {
        "discountType": "BY_PERCENTAGE",
        "percentage": 0,
        "totalSum": 0
    },
    "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"
            }
        }
    ],
    "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"
        }
    ],
    "additionalInfo": {
        "withoutRounding": true,
        "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