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

Запит

URI: /api/v2/shift

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

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

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

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

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

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

Запит: /api/v2/shift

{
    "api_token": "42b5eaccba739f08***e7fe157eba8bf",
    "num_fiscal": 4000022469,
    "action_type": "OPEN_SHIFT"
}

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

Ім'я	Тип	Опис
ORDERNUM	string	Номер чека зі Z-звітом
ORDERDATE	string	Дата формування чека зі Z-звітом
ORDERTIME	string	Час формування чека зі Z-звітом
MAC	string	Код аутентифікації повідомлення чека
is_offline	boolean	Ознака офлайн чека
local_number	string	Локальний номер операції, який клієнт передає з кожним чеком
qr	string	QR код чека
pdf	string	PDF представлення чека
text_print	string	Текстове представлення чека
link	string	Посилання для перегляду чека на сайті

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

Закрити зміну та сформувати 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": "ДФС зміна вже відкрита"
}

порада

Postman колекція (Відкрити/Закрити зміну (Z-звіт)): https://documenter.getpostman.com/view/12128952/TVRj5U1d#debd20ba-7025-4c6f-9297-b6e804075252