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

Службове внесення/Службова видача

Запит

URI: /api/v2/check/service

Метод дозволяє реалізувати службове внесення або службову видачу.

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

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

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

Ім'яТипОбов'язковийОпис
api_tokenstringТакТокен авторизації, згенерований в особистому кабінеті
action_typestringТакТип дії:
SERVICE_INPUT - службове внесення
SERVICE_OUTPUT - службова видача
num_fiscalintegerТакФіскальний номер каси
typeintegerТакТип оплати
namestringТакНазва типу оплати
sumfloatТакСума внесення або видачі
open_shiftbooleanПрапор відкриття зміни
Якщо зміна закрита і передано значення True, тоді зміна буде відкрита
local_numberintegerЛокальний номер операції, який клієнт передає з кожним чеком
no_print_textbooleanНіВиключити текстове представлення чека з відповіді
no_pdfbooleanНіВиключити pdf представлення чека з відповіді

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

Запит: /api/v2/check/service
{
"api_token": "42b5eaccba739f08***e7fe157eba8bf",
"action_type": "SERVICE_INPUT",
"num_fiscal": 4000022469,
"type": 0,
"name": "ГОТІВКА",
"sum": 35,
"open_shift": true,
"local_number": 123,
"no_print_text": true,
"no_pdf": true
}

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

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

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

Внесення коштів/Інкасація test example

200 OK

Відповідь: /api/v2/check/service
{
"ORDERNUM": "iKZgRpY-AJA",
"ORDERDATE": "2021-01-26",
"ORDERTIME": "16:05:43",
"MAC": "ab8d3d75eaca553fd1c8ff7c936f533f146e44028ddbb092125d0af175e8fadc",
"is_offline": false,
"qr": null,
"link": null,
"pdf": null,
"text_print": null,
"uuid": "400fe211-c37b-4710-b19e-74a86f535f78",
"local_number": "123"
}

Внесення коштів/Інкасація

200 OK

Відповідь: /api/v2/check/service
{
"ORDERNUM": "V_zGRvPtK2g",
"ORDERDATE": "2020-12-16",
"ORDERTIME": "17:54:19",
"MAC": "36e8013db9c09bbb2b00de530ba3cd8cbf213c2ae3f638b4603671106e73eb40",
"is_offline": false,
"local_number": null,
"qr": null,
"pdf": "JVBERi0xLjcKMSAwIG9iago8PCAvVHlwZSA....",
"text_print": "ICAgICAgICAgINCi0JXQodCi0J7QktCY0Jkg0KfQldC....",
"link": "http://cashdesk.com/check/8758126e-207c-4e67-84de-54d301639a53/html"
}