- Збереження чернеток
Develop Env
https://dev.e-check.com.ua
Develop Env
https://dev.e-check.com.ua
POST
/v2/open-api/receipt/bulk-insert-drafts
Спільні параметри для чернеток:
| Назва поля | Тип | Обов’язкове | Опис |
|---|---|---|---|
| packId | uuid | Ні | Ідентифікатор пака чорнеток |
| items | Array() | Так | масив чернеток: |
| -type | Enum | Так | [SELLING_DRAFT, CANCEL_DRAFT, RETURNING_DRAFT] |
| -invoiceId | uuid | Ні | Ідентифікатор чорнетки |
| -shiftId | uuid | Ні | Ідентифікатор зміни |
| -title | string | Так | назва чернетки |
| -checkHeaderText | string | Ні | хедер чеку по замовчуванню беруться дані із налаштувань компанії-брендинг чеку |
| -checkFooterText | string | Ні | футер чеку по замовчуванню беруться дані із налаштувань компанії-брендинг чеку |
| -endingComments | string | Ні | нижній коментар чеку (після напису фіскальний чек) |
| -initialComments | string | Ні | верхній коментар (після ПІБ касиру) |
| -internalComments | string | Ні | внутрішній коментар, не відображається на пдф чека |
| -additionalInfo | string | Ні | додаткові поля клієнта |
Лише для Чеків продажу:
| Назва поля | Тип | Обов’язкове | Опис |
|---|---|---|---|
| totalSum | number | Так | загальна сума чеку |
| products | Array(ProductTypeInput) | Так | Перелік товарів |
ProductTypeInput
| Назва поля | Тип | Обов’язкове | Опис |
|---|---|---|---|
| name | string | Так | Назва товару |
| quantity | number | Так | Кількість товару |
| price | number | Так | Ціна у копійках за одиницю товару |
| tx | string | Так | Податковий ідентифікатор. Перелік типів податків |
| measurementId | number | Так | Ідентифікатор величини |
| discount | DiscountTypeInput | Ні | Знижка, дивсь на приклад у Body Params. -type: BY_SUM / BY_PERCENTAGE; value:number |
| id | string | Ні | якщо не вказано, продукту буде встановлено автоматичний ідентифікатор |
| uktzed | string | Ні | для вказування УКТЗЕД у товарі |
| exciseTaxStamp | Array(string) | Ні | для акцизних товарів |
| barCode | string | Ні | штрих код |
| productCode | string | Ні |
Лише для чеку відміни:
| Назва поля | Тип | Обов’язкове | Опис |
|---|---|---|---|
| parentCheckId | string | Так | id чеку який відміняємо |
Лише для чеку повернення :
| Назва поля | Тип | Обов’язкове | Опис |
|---|---|---|---|
| parentCheckId | string | Так | id чеку який відміняємо |
| returningGoods | Array(ReturningGoods) | Так | Перелік товарів, які повертаємо |
ReturningGoods
| Назва поля | Тип | Обов’язкове | Опис |
|---|---|---|---|
| productId | string | Так | id товару, який повертаємо |
| quantity | string | Так | кількість товару, яку відміняємо |
Request
Header Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://dev.e-check.com.ua/v2/open-api/receipt/bulk-insert-drafts' \
--header 'apikey: {{apikey}}' \
--header 'Content-Type: application/json' \
--data '{
"items": [
{
"id": "qweqwe-qweqweqwe",
"companyId": "362",
"shiftId": "26104717-cdb3-48a8-b78e-5252492596f3",
"workerId": "107",
"cashRegisterId": "37589",
"title": "selling3",
"totalSum": 370751,
"IdInvoiceExt": "4",
"products": [
{
"name": "Заготовка безперервнолита тестx0x0 С235 (Ст3кп) L=0,00",
"quantity": 1.500,
"price": 240501,
"tx": "1",
"measurementId": 17,
"id": "00950sdf00273_000010"
},
{
"name": "Автопослуги з перевезення вантажу вантажним автотранспортом",
"quantity": 5.000,
"price": 10000,
"tx": "1",
"measurementId": 1,
"id": "0095000273_000020"
}
],
"type": "SELLING_DRAFT",
"endingComments": "Фактура № 95000273-endingComments",
"initialComments": "Фактура № 95000273-initialComments",
"internalComments": "Фактура № 95000273-internalComments"
},
{
"signTokenId": "1fea799f-2750-4b37-b2a3-c08342fa405e",
"companyId": "362",
"workerId": "107",
"cashRegisterId": "37589",
"title": "cancel Оплата за фактурою ",
"IdInvoiceExt": "009500035220240520171404",
"parentCheckId": "d8403c43-208e-4f63-a133-99842777a7e8",
"type": "CANCEL_DRAFT",
"endingComments": "Фактура № 95000273-endingComments",
"initialComments": "Фактура № 95000273-initialComments",
"internalComments": "Фактура № 95000273-internalComments"
},
{
"companyId": "362",
"workerId": "107",
"cashRegisterId": "37589",
"title": "22",
"totalSum": 95660,
"IdInvoiceExt": "009500035220240520171404",
"parentCheckId": "94fc69b3-ecc1-41fa-b4f1-518eca19ecc3",
"returningGoods": [
{
"quantity": 1,
"productId": "3100512"
}
],
"type": "RETURNING_DRAFT",
"endingComments": "Фактура № 95000273-endingComments",
"initialComments": "Фактура № 95000273-initialComments",
"internalComments": "Фактура № 95000273-internalComments"
}
]
}'Response Response Example
200 - Success
{
"success": true,
"data": [
"e16aa577-1fd4-45b8-b968-30ebccd8dfc2",
"ceaccd56-ea66-436d-9d99-9d8c299d0253"
],
"errors": null
}Modified at 2026-03-16 17:24:37