Перейти до основного вмісту

Відкрити/Закрити зміну (Z-звіт)

Запит

URI: /api/v2/shift

Метод дозволяє відкрити або закрити зміну та сформувати Z-звіт.

Запит виконується методом POST у json форматі з даними.

⚠️ Запит повинен містити заголовки Accept: application/json та Content-Type: application/json

Параметри запиту

Ім'яТипОбов'язковийОпис
api_tokenstringТакТокен авторизації, згенерований в особистому кабінеті
num_fiscalintegerТакФіскальний номер каси
action_typestringТакТип дії:
OPEN_SHIFT - Відкрити зміну
Z_REPORT - Закрити зміну (Z-звіт)

Приклад запиту

Запит: /api/v2/shift
{
"api_token": "42b5eaccba739f08***e7fe157eba8bf",
"num_fiscal": 4000022469,
"action_type": "OPEN_SHIFT"
}

Параметри відповіді

Ім'яТипОпис
ORDERNUMstringНомер чека зі Z-звітом
ORDERDATEstringДата формування чека зі Z-звітом
ORDERTIMEstringЧас формування чека зі Z-звітом
MACstringКод аутентифікації повідомлення чека
is_offlinebooleanОзнака офлайн чека
local_numberstringЛокальний номер операції, який клієнт передає з кожним чеком
qrstringQR код чека
pdfstringPDF представлення чека
text_printstringТекстове представлення чека
linkstringПосилання для перегляду чека на сайті

Приклади успішних відповідей

Закрити зміну та сформувати Z-звіт

200 OK

Відповідь: /api/v2/shift
{
"ORDERNUM": "p1ouE8yMJjc",
"ORDERDATE": "2020-12-16",
"ORDERTIME": "16:56:06",
"MAC": "2c99b1080924dd08e7671f48f0f800b3c01ff570083e5ee6fca6e65e36cb1964",
"is_offline": false,
"local_number": null,
"qr": null,
"pdf": "JVBERi0xLjcKMSAwIG9iago8PCAvVHlwZSAvQ2F0YW...",
"text_print": null,
"link": null
}

Відкрити зміну

200 OK

Відповідь: /api/v2/shift
{
"ORDERNUM": "lpiU0OluPKk",
"ORDERDATE": "2020-12-16",
"ORDERTIME": "16:55:41",
"MAC": "b485c4450d8fc6742c8a9ab5e0550d8c37ee40349942627af7d48e2c82f9a297",
"is_offline": false,
"local_number": null,
"qr": null,
"pdf": null,
"text_print": null,
"link": null
}

Приклад неуспішної відповіді

Зміна вже відкрита

400 Bad Request

Відповідь: 400 Bad Request
{
"message": "ДФС зміна вже відкрита"
}