{"info":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","description":"

API для інтеграції з кабінетом Вчасно.Каса та фіскалізації чеків.

Changelog

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Date	Changes
2026-02-17	Додано параметр `shift_id` у відповіді на task: 0,10,11,18
2025-08-18	Додано можливість задавати список загальних знижок (fiscal.receipt.discounts). Запит \"Статус пРРО\" перенесено до службових запитів.
2025-05-28	data.global_discounts у відповіді на json чеку
2025-05-06	info.lastcheck обʼєкт у відповіді при запиті на x/z-звіт
2025-04-28	Додано можливість вивантажити архів z-звітів
2025-03-03	Додано нові засоби оплат
2024-12-10	Додано нові параметри purchase_dt в обʼєкт fiscal.receipt.pays та purchase_receipt_dt в об'єкт fiscal.receipt.rows по программі \"Національний кешбек\"
2024-11-14	Додано параметр bank_name в об'єкт fiscal.receipt.pays Додано mac параметр у відповідь фіскалізації чеків
2024-09-23	Додано підтримку загальної знижки на чек. Параметри disc та disc_type в об'єкт fiscal.receipt
2024-09-03	Додано нові параметри purchase_receipt_fisn та purchase_rro_fisn в об'єкт fiscal.receipt для чеків повернення по программі \"Національний кешбек\"
2024-04-19	Додано чеки передплати, післясплати. Додано запити створення / вивантаження звітів
2024-02-23	Додано службові запити: Отримати зміни по касі, Отримати чеки по зміні
2024-02-15	Розширено формати поля userinfo: phone Запит на отримання JSON чеку повертає shop_type
2024-01-31	Оновлено документацію. Додано опис error_extra. Прибрано fiscal.receipt.pays.currency (параметр не оброблювався)
2023-09-18	Розширення виводу ЕПЗ даних
2023-07-18	Додано перегляд фіскалізованого JSON чеку
2023-03-16	Додано підтримку чеку видачі готівки (task 14)
2022-09-07	Внесено інформацію про автоматичне відкриття зміни разом із проведенням першого чеку (Запити на фіскалізацію -> Відкриття зміни)
2022-08-04	Initial version

Загальні вимоги

HOST - https://kasa.vchasno.ua

Для всіх методів очікується:

Content-Type: application/json
\n
Authorization: <токен_каси>
\n

Токен каси можна отримати у веб-кабінеті Вчасно.Каса (https://kasa.vchasno.ua/), перейшовши у Налаштування конкретної каси (Дії з касою -> Налаштування каси -> блок Токен)

\n $\"Де%20взяти%20токен%20каси\"$ \n\n

Для фіскалізації чеків необхідно додати ключ у сховище ключів.

Зробити це можна у веб-кабінеті, вкладка \"Ключі\" (https://kasa.vchasno.ua/app/storage-keys).

\n\n

Текстові поля мають містити лише наступні дозволені символи:

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz\nАБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдеёжзийклмнопрстуфхцчшщъыьэюя\nІіЇїҐґЄє !.,\"№;:?\\\\*()<>|/@#$%^-_+=~''&{}[]®©«»°±‘’“”–•—™„‰‹› 0123456789\n\n

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Changelog","slug":"changelog"},{"content":"Загальні вимоги","slug":"zagalni-vimogi"}],"owner":"26351974","collectionId":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","publishedId":"2s93shy9To","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"B05CC5"},"publishDate":"2025-04-10T09:07:17.000Z"},"item":[{"name":"Запити на фіскалізацію","item":[{"name":"Національний кешбек","item":[{"name":"Чек продажу","id":"60df06d9-3e36-4392-a330-096bc9c19874","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 1,\r\n \"cashier\": \"Постман\",\r\n \"receipt\": {\r\n \"sum\": 200.00,\r\n \"rows\": [\r\n {\r\n \"code\": \"00001\",\r\n \"code1\": \"73463253\",\r\n \"code2\": \"54321\",\r\n \"code_aa\": [\r\n \"XX11111111111\",\r\n \"XX11111111112\"\r\n ],\r\n \"disc\": 0,\r\n \"name\": \"Продукт 1\",\r\n \"cnt\": 1,\r\n \"price\": 200.00,\r\n \"taxgrp\": \"1\"\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"purchase_dt\": \"20241210135800\",\r\n \"type\": 2,\r\n \"sum\": 200.00,\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"oper_type\": \"Оплата\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"term_id\": \"term_id\",\r\n \"bank_name\": \"bank_name\",\r\n \"bank_id\": \"bank_id\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment\": \"Зразок! СЛАВА*УКРАЇНІ\",\r\n \"show_additional_info\": true\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Опис відповіді

Структуру відповіді можна подивитись у чеках без Національного кешбеку

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"37f6e707-ed79-46c4-9f12-7d042200d55e","name":"Чек продажу","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 1,\r\n \"cashier\": \"Постман\",\r\n \"receipt\": {\r\n \"sum\": 200.00,\r\n \"rows\": [\r\n {\r\n \"code\": \"00001\",\r\n \"code1\": \"73463253\",\r\n \"code2\": \"54321\",\r\n \"code_aa\": [\r\n \"XX11111111111\",\r\n \"XX11111111112\"\r\n ],\r\n \"disc\": 0,\r\n \"name\": \"Продукт 1\",\r\n \"cnt\": 1,\r\n \"price\": 200.00,\r\n \"taxgrp\": \"1\"\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"purchase_dt\": \"20241210135800\",\r\n \"type\": 2,\r\n \"sum\": 200.00,\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"oper_type\": \"Оплата\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"term_id\": \"term_id\",\r\n \"bank_name\": \"bank_name\",\r\n \"bank_id\": \"bank_id\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment\": \"Зразок! СЛАВА*УКРАЇНІ\",\r\n \"show_additional_info\": true\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 10 Dec 2024 11:57:39 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"754"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"980"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 1,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"POSTMAN\",\n \"device\": \"99997955555555\",\n \"tag\": \"7ad71ed9dfd812f73b4c39d6067cf864\",\n \"dt\": \"20241210135738\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 1,\n \"fisid\": \"99997955555555\",\n \"dataid\": 166,\n \"doccode\": \"TEST_Qbpv_J3WUwT_lQ\",\n \"dt\": \"20241210135738\",\n \"cashier\": \"Постман\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 0,\n \"shift_link\": 39,\n \"docno\": 4,\n \"cancelid\": \"TEST_Qbpv_J3WUwT_lQ\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_Qbpv_J3WUwT_lQ?id=TEST_Qbpv_J3WUwT_lQ&date=20241210&time=13:57:38&fn=99997955555555&sm=200.00&mac=53591fe4bce3b067a06253fc787c6a3e7e0e8b8d1460ceb550612321043db92f\",\n \"mac\": \"53591fe4bce3b067a06253fc787c6a3e7e0e8b8d1460ceb550612321043db92f\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"60df06d9-3e36-4392-a330-096bc9c19874"},{"name":"Чек повернення","id":"580a10b8-668b-4fea-8d38-b1e4aac76ba3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"{{token_vchasno}}"}],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 2,\r\n \"cashier\": \"Постман\",\r\n \"receipt\": {\r\n \"sum\": 200.00,\r\n \"rows\": [\r\n {\r\n \"purchase_receipt_fisn\": \"TEST_Qbpv_J3WUwT_lQ\",\r\n \"purchase_rro_fisn\": \"99997955555555\",\r\n \"purchase_receipt_dt\": \"20241210\",\r\n \"code\": \"00001\",\r\n \"code1\": \"73463253\",\r\n \"code2\": \"54321\",\r\n \"code_aa\": [\r\n \"XX11111111111\",\r\n \"XX11111111112\"\r\n ],\r\n \"name\": \"Продукт 1\",\r\n \"cnt\": 1,\r\n \"price\": 200.00,\r\n \"disc\": 0,\r\n \"taxgrp\": \"1\"\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 2,\r\n \"sum\": 200.00,\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"oper_type\": \"Оплата\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"term_id\": \"term_id\",\r\n \"bank_id\": \"bank_id\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment\": \"Зразок! СЛАВА*УКРАЇНІ\",\r\n \"show_additional_info\": true\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Опис відповіді

Структуру відповіді можна подивитись у чеках без Національного кешбеку

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"0e81ee1d-5e23-4757-81d3-05b205d3071c","name":"Чек повернення","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 2,\r\n \"cashier\": \"Постман\",\r\n \"receipt\": {\r\n \"sum\": 200.00,\r\n \"rows\": [\r\n {\r\n \"purchase_receipt_fisn\": \"TEST_Qbpv_J3WUwT_lQ\",\r\n \"purchase_rro_fisn\": \"99997955555555\",\r\n \"purchase_receipt_dt\": \"20241210\",\r\n \"code\": \"00001\",\r\n \"code1\": \"73463253\",\r\n \"code2\": \"54321\",\r\n \"code_aa\": [\r\n \"XX11111111111\",\r\n \"XX11111111112\"\r\n ],\r\n \"name\": \"Продукт 1\",\r\n \"cnt\": 1,\r\n \"price\": 200.00,\r\n \"disc\": 0,\r\n \"taxgrp\": \"1\"\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 2,\r\n \"sum\": 200.00,\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"oper_type\": \"Оплата\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"term_id\": \"term_id\",\r\n \"bank_id\": \"bank_id\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment\": \"Зразок! СЛАВА*УКРАЇНІ\",\r\n \"show_additional_info\": true\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 10 Dec 2024 11:59:37 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"754"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"374"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 2,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"POSTMAN\",\n \"device\": \"99997955555555\",\n \"tag\": \"9e079adf787629601a69148e3a997d4b\",\n \"dt\": \"20241210135937\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 2,\n \"fisid\": \"99997955555555\",\n \"dataid\": 167,\n \"doccode\": \"TEST_BLDVZH08aKpjrw\",\n \"dt\": \"20241210135937\",\n \"cashier\": \"Постман\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 0,\n \"shift_link\": 39,\n \"docno\": 1,\n \"cancelid\": \"TEST_BLDVZH08aKpjrw\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_BLDVZH08aKpjrw?id=TEST_BLDVZH08aKpjrw&date=20241210&time=13:59:37&fn=99997955555555&sm=200.00&mac=df6c67395c22429e58e1e29bb76a5997c464c5bad4388c9a4bd513448074687d\",\n \"mac\": \"df6c67395c22429e58e1e29bb76a5997c464c5bad4388c9a4bd513448074687d\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"580a10b8-668b-4fea-8d38-b1e4aac76ba3"}],"id":"c7e69ebf-2b4d-48ac-bc77-bfc707da8ca6","_postman_id":"c7e69ebf-2b4d-48ac-bc77-bfc707da8ca6","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}}},{"name":"Відкриття зміни","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"2f1920cd-00dd-421a-9ce1-e0d6e20437d1"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","id":"f78891da-2e4d-4eb6-a738-0b731aa2fdd8"}}],"id":"73faaa6f-7ec1-4734-b04a-f8b263992cea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"fiscal\": {\r\n \"task\": 0,\r\n \"cashier\": \"Постман\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Якщо зміну на ПРРО закрито, то при надсиланні першого чеку (task = 1,2,3,4,14,15,16) автоматично надсилається запит на відкриття зміни.

Опис відповіді

Структура об'єкту info для завдання відкриття зміни

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
task	integer	Тип завдання
dt	string	Дата та час проведення чеку в форматі YYYYMMDDHHMMSS
fisid	string	Фіскальний номер каси
doccode	string	Фіскальний номер чеку
dataid	integer	Номер сформованого пакету
shift_link	integer	Номер зміни каси
shift_id	string	ID зміни
cashier	string	Іноформація про касира
isoffline	bool	В якому режимі проведено чек true - в офлайні false - в онлайні
safe	float	Сума готівки в касі
dtype	integer	Тип девайсу 0 - тестовий 1 - фіскальний

Опис відповіді

Структура об'єкту info для завдань 1, 2, 3, 4, 14, 15, 16 (чек продажу та повернення, службове внесення\\видача, чек видачі готівки, чек переказу коштів, чек видачі коштів при переказі)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
task	integer	Тип завдання
dt	string	Дата та час проведення чеку в форматі YYYYMMDDHHMMSS
fisid	string	Фіскальний номер каси
doccode	string	Фіскальний номер чеку
dataid	integer	Номер сформованого пакету
shift_link	integer	Номер зміни каси
cashier	string	Іноформація про касира
isoffline	bool	В якому режимі проведено чек true - в офлайні false - в онлайні
safe	float	Сума готівки в касі
dtype	integer	Тип девайсу 0 - тестовий 1 - фіскальний
qr	string	Посилання на електронний фіскальний чек Вчасно.Каса
cancelid	string	Ідентифікатор для відміни операції
mac	string	Контрольне число послідовності чеків

","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"7bfcd4ae-a23a-48d3-be98-20a05505cd3a","name":"Чек продажу","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"userinfo\": {\r\n \"email\": \"test@vchasno.ua\",\r\n \"phone\": \"+38093*******\"\r\n },\r\n \"fiscal\": {\r\n \"task\": 1,\r\n \"cashier\": \"Постман\",\r\n \"receipt\": {\r\n \"sum\": 199.99,\r\n \"round\": 0.01,\r\n \"comment_up\": \"Зразок! Коментар шапки чеку\",\r\n \"comment_down\": \"Зразок! ДЯКУЄМО за покупку\",\r\n \"disc\": 10.00,\r\n \"disc_type\": 0,\r\n \"rows\": [\r\n {\r\n \"code\": \"00001\",\r\n \"code1\": \"73463253\",\r\n \"code2\": \"54321\",\r\n \"code_aa\": [\r\n \"XX11111111111\",\r\n \"XX11111111112\"\r\n ],\r\n \"name\": \"Продукт 1\",\r\n \"cnt\": 2,\r\n \"price\": 55.00,\r\n \"disc\": 10.00,\r\n \"taxgrp\": \"4\",\r\n \"comment\": \"Зразок! Коментар\"\r\n },\r\n {\r\n \"code\": \"00002\",\r\n \"code1\": \"73463254\",\r\n \"code2\": \"45667\",\r\n \"code_a\": \"XX11111111113\",\r\n \"name\": \"Продукт 2\",\r\n \"cnt\": 1,\r\n \"price\": 89.99,\r\n \"disc\": -10.00,\r\n \"taxgrp\": 3,\r\n \"comment\": \"Зразок! \\\"Have a good day\\\"\"\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 150.00,\r\n \"change\": 50.00,\r\n \"comment\": \"Зразок! Тест\"\r\n },\r\n {\r\n \"type\": 2,\r\n \"sum\": 40.00,\r\n \"commission\": 1.00,\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"oper_type\": \"Оплата\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"term_id\": \"term_id\",\r\n \"bank_name\": \"bank_name\",\r\n \"bank_id\": \"bank_id\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment\": \"Зразок! СЛАВА*УКРАЇНІ\",\r\n \"show_additional_info\": true\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 14 Nov 2024 10:14:30 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"756"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"818"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 1,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"POSTMAN\",\n \"device\": \"99997955555555\",\n \"tag\": \"ea1a404fcc8f48f3e1dea03fe1ad3cbd\",\n \"dt\": \"20241114121430\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 1,\n \"fisid\": \"99997955555555\",\n \"dataid\": 152,\n \"doccode\": \"TEST_7B_WSDzzmo9H7w\",\n \"dt\": \"20241114121430\",\n \"cashier\": \"Постман\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 150,\n \"shift_link\": 37,\n \"docno\": 1,\n \"cancelid\": \"TEST_7B_WSDzzmo9H7w\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_7B_WSDzzmo9H7w?id=TEST_7B_WSDzzmo9H7w&date=20241114&time=12:14:30&fn=99997955555555&sm=189.99&mac=e8acd9a470a6b4258ec4df473bb2a121094543d48f611084f1bfb08cb712f2e8\",\n \"mac\": \"e8acd9a470a6b4258ec4df473bb2a121094543d48f611084f1bfb08cb712f2e8\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"593a7e3b-390c-419b-9115-857e99e33781"},{"name":"Чек повернення","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"2327456b-96b6-4e1e-bd59-85012b37baf6"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","id":"93a8487d-499c-4372-857c-7462dd142b01"}}],"id":"938803b9-bfc6-476f-8259-b7a0054e4dfa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 2,\r\n \"cashier\": \"Постман\",\r\n \"receipt\": {\r\n \"sum\": 199.99,\r\n \"round\": 0.01,\r\n \"comment_up\": \"Зразок! Коментар шапки чеку\",\r\n \"comment_down\": \"Зразок! ДЯКУЄМО за повернення\",\r\n \"rows\": [\r\n {\r\n \"code\": \"00001\",\r\n \"code1\": \"73463253\",\r\n \"code2\": \"54321\",\r\n \"code_aa\": [\r\n \"XX11111111111\",\r\n \"XX11111111112\"\r\n ],\r\n \"name\": \"Продукт 1\",\r\n \"cnt\": 2,\r\n \"price\": 55.00,\r\n \"disc\": 10.00,\r\n \"taxgrp\": \"4\",\r\n \"comment\": \"Зразок! Коментар\"\r\n },\r\n {\r\n \"code\": \"00002\",\r\n \"code1\": \"73463254\",\r\n \"code2\": \"45667\",\r\n \"code_a\": \"XX11111111113\",\r\n \"name\": \"Продукт 2\",\r\n \"cnt\": 1,\r\n \"price\": 89.99,\r\n \"disc\": -10.00,\r\n \"taxgrp\": 3,\r\n \"comment\": \"Зразок! \\\"Have a good day\\\"\"\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 150.00,\r\n \"change\": 50.00,\r\n \"comment\": \"Зразок! Тест\"\r\n },\r\n {\r\n \"type\": 2,\r\n \"sum\": 50.00,\r\n \"commission\": 1.00,\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"oper_type\": \"Оплата\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"term_id\": \"term_id\",\r\n \"bank_id\": \"bank_id\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment\": \"Зразок! СЛАВА*УКРАЇНІ\",\r\n \"show_additional_info\": true\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Опис відповіді

Структура відповіді аналогічна чеку продажу (описано вище)

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"554a5007-de32-41f7-bee0-7f840dcbc740","name":"Чек повернення","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 2,\r\n \"cashier\": \"Постман\",\r\n \"receipt\": {\r\n \"sum\": 199.99,\r\n \"round\": 0.01,\r\n \"comment_up\": \"Зразок! Коментар шапки чеку\",\r\n \"comment_down\": \"Зразок! ДЯКУЄМО за повернення\",\r\n \"rows\": [\r\n {\r\n \"code\": \"00001\",\r\n \"code1\": \"73463253\",\r\n \"code2\": \"54321\",\r\n \"code_aa\": [\r\n \"XX11111111111\",\r\n \"XX11111111112\"\r\n ],\r\n \"name\": \"Продукт 1\",\r\n \"cnt\": 2,\r\n \"price\": 55.00,\r\n \"disc\": 10.00,\r\n \"taxgrp\": \"4\",\r\n \"comment\": \"Зразок! Коментар\"\r\n },\r\n {\r\n \"code\": \"00002\",\r\n \"code1\": \"73463254\",\r\n \"code2\": \"45667\",\r\n \"code_a\": \"XX11111111113\",\r\n \"name\": \"Продукт 2\",\r\n \"cnt\": 1,\r\n \"price\": 89.99,\r\n \"disc\": -10.00,\r\n \"taxgrp\": 3,\r\n \"comment\": \"Зразок! \\\"Have a good day\\\"\"\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 150.00,\r\n \"change\": 50.00,\r\n \"comment\": \"Зразок! Тест\"\r\n },\r\n {\r\n \"type\": 2,\r\n \"sum\": 50.00,\r\n \"commission\": 1.00,\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"oper_type\": \"Оплата\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"term_id\": \"term_id\",\r\n \"bank_id\": \"bank_id\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment\": \"Зразок! СЛАВА*УКРАЇНІ\",\r\n \"show_additional_info\": true\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 14 Nov 2024 10:15:09 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"754"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"624"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 2,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"POSTMAN\",\n \"device\": \"99997955555555\",\n \"tag\": \"6fd430b3685d1d445c8a611d61cdd54a\",\n \"dt\": \"20241114121508\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 2,\n \"fisid\": \"99997955555555\",\n \"dataid\": 153,\n \"doccode\": \"TEST_g8MjrMAN_X6lKA\",\n \"dt\": \"20241114121508\",\n \"cashier\": \"Постман\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 0,\n \"shift_link\": 37,\n \"docno\": 1,\n \"cancelid\": \"TEST_g8MjrMAN_X6lKA\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_g8MjrMAN_X6lKA?id=TEST_g8MjrMAN_X6lKA&date=20241114&time=12:15:08&fn=99997955555555&sm=199.99&mac=975e62f6827b43fc88bc9997a6a36c68d95fb0cc8fea82d8ac89e9b75ac3050f\",\n \"mac\": \"975e62f6827b43fc88bc9997a6a36c68d95fb0cc8fea82d8ac89e9b75ac3050f\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"938803b9-bfc6-476f-8259-b7a0054e4dfa"},{"name":"Чек передплати","id":"d47bb541-3f9a-4904-ba35-c1e2834f6eda","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"fiscal\": {\r\n \"task\": 1,\r\n \"subtask\": 1,\r\n \"receipt\": {\r\n \"sum\": 50.00,\r\n \"round\": 0,\r\n \"comment_down\": \"Передплата по товарах: Товар, 100.00 грн\",\r\n \"rows\": [\r\n {\r\n \"name\": \"Передплата\",\r\n \"cnt\": 0,\r\n \"price\": 50.00,\r\n \"disc\": 0,\r\n \"taxgrp\": \"1\"\r\n }\r\n ],\r\n \"rows_pre_payment\": [\r\n {\r\n \"name\": \"Товар\",\r\n \"cnt\": 1,\r\n \"price\": 100.00,\r\n \"disc\": 0,\r\n \"taxgrp\": \"1\",\r\n \"code_aa\": []\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 50.00,\r\n \"change\": 0\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Додаткові параметри для створення чеку передплати

У об'єкті rows параметр cnt має бути 0

У об'єкті fiscal параметр subtask=1 вказує що це чек передплати, обовʼязковий параметр, якщо його пропустити, не буде створено чек передплати

Об'єкт rows_pre_payment опційний. Вказуються всі товари по яким робиться чек передоплати, для кращої валідації чеку постоплати

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"d9cb514d-5c66-4e62-b256-a279ef80983a","name":"Чек передплати","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"fiscal\": {\r\n \"task\": 1,\r\n \"subtask\": 1,\r\n \"receipt\": {\r\n \"sum\": 50.00,\r\n \"round\": 0,\r\n \"comment_down\": \"Передплата по товарах: Товар, 100.00 грн\",\r\n \"rows\": [\r\n {\r\n \"name\": \"Передплата\",\r\n \"cnt\": 0,\r\n \"price\": 50.00,\r\n \"disc\": 0,\r\n \"taxgrp\": \"1\"\r\n }\r\n ],\r\n \"rows_pre_payment\": [\r\n {\r\n \"name\": \"Товар\",\r\n \"cnt\": 1,\r\n \"price\": 100.00,\r\n \"disc\": 0,\r\n \"taxgrp\": \"1\",\r\n \"code_aa\": []\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 50.00,\r\n \"change\": 0\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 14 Nov 2024 10:15:45 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"705"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"1104"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 1,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"\",\n \"device\": \"99997955555555\",\n \"tag\": \"95ecf2c0b92d7b12e6ac9ee1e77131d0\",\n \"dt\": \"20241114121544\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 1,\n \"fisid\": \"99997955555555\",\n \"dataid\": 154,\n \"doccode\": \"TEST_kD2wSQzTqMSMdA\",\n \"dt\": \"20241114121544\",\n \"cashier\": \"\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 50,\n \"shift_link\": 37,\n \"docno\": 2,\n \"cancelid\": \"TEST_kD2wSQzTqMSMdA\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_kD2wSQzTqMSMdA?id=TEST_kD2wSQzTqMSMdA&date=20241114&time=12:15:44&fn=99997955555555&sm=50.00&mac=9facb17a574dfcc29a03e48905fc88d3907b4cafc4777ac97fb5155eb5227d5d\",\n \"mac\": \"9facb17a574dfcc29a03e48905fc88d3907b4cafc4777ac97fb5155eb5227d5d\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"d47bb541-3f9a-4904-ba35-c1e2834f6eda"},{"name":"Чек післяплати","id":"e05f7f9a-adab-4840-9940-0953354d1aba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"post_payment_of_check_fn\": \"TEST_kD2wSQzTqMSMdA\",\r\n \"fiscal\": {\r\n \"task\": 1,\r\n \"subtask\": 2,\r\n \"receipt\": {\r\n \"sum\": 50.00,\r\n \"round\": 0,\r\n \"comment_down\": \"Післяплата по товарах: Товар, 100.00 грн. Чек передплати: TEST_kD2wSQzTqMSMdA\",\r\n \"rows\": [\r\n {\r\n \"name\": \"Товар \",\r\n \"cnt\": 1,\r\n \"price\": 100.00,\r\n \"disc\": 50.00,\r\n \"disc_apply_type\": 1,\r\n \"taxgrp\": \"1\",\r\n \"code_aa\": []\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 50.00,\r\n \"change\": 0\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Додаткові параметри для створення чеку післяплати

post_payment_of_check_fn: prepayment_check_fn вказується для прив'язки до чеку передплати

У об'єкті fiscal обов'язковий параметр subtask: 2 який вказує що це чек післяплати

У об'єкті rows обов'язковий параметр disc_apply_type: 1 для знижок у післяплати

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"295eab37-a1d8-4316-ac9a-ad17700df1d2","name":"Чек післяплати","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"post_payment_of_check_fn\": \"TEST_kD2wSQzTqMSMdA\",\r\n \"fiscal\": {\r\n \"task\": 1,\r\n \"subtask\": 2,\r\n \"receipt\": {\r\n \"sum\": 50.00,\r\n \"round\": 0,\r\n \"comment_down\": \"Післяплата по товарах: Товар, 100.00 грн. Чек передплати: TEST_kD2wSQzTqMSMdA\",\r\n \"rows\": [\r\n {\r\n \"name\": \"Товар \",\r\n \"cnt\": 1,\r\n \"price\": 100.00,\r\n \"disc\": 50.00,\r\n \"disc_apply_type\": 1,\r\n \"taxgrp\": \"1\",\r\n \"code_aa\": []\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 50.00,\r\n \"change\": 0\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 14 Nov 2024 10:16:43 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"706"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"442"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 1,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"\",\n \"device\": \"99997955555555\",\n \"tag\": \"a54aa166bcf17b33d9933fc5d7d109b2\",\n \"dt\": \"20241114121643\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 1,\n \"fisid\": \"99997955555555\",\n \"dataid\": 155,\n \"doccode\": \"TEST_K7_fVdv_44YxdA\",\n \"dt\": \"20241114121643\",\n \"cashier\": \"\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 100,\n \"shift_link\": 37,\n \"docno\": 3,\n \"cancelid\": \"TEST_K7_fVdv_44YxdA\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_K7_fVdv_44YxdA?id=TEST_K7_fVdv_44YxdA&date=20241114&time=12:16:43&fn=99997955555555&sm=50.00&mac=c15a64d915581ca9b9dc8f184fcb9ff0f594c04ab8ceefb4e8c70e82c9a9fd3f\",\n \"mac\": \"c15a64d915581ca9b9dc8f184fcb9ff0f594c04ab8ceefb4e8c70e82c9a9fd3f\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"e05f7f9a-adab-4840-9940-0953354d1aba"},{"name":"Чек видачі готівки","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"6d77af6f-f4de-4c78-aacb-834eb8752726"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","id":"6768248f-a5f2-4111-9833-7d3e6cd2ba97"}}],"id":"7549b103-7b95-4664-b246-0a7d8c3f6a1e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 14,\r\n \"cashier\": \"Постман\",\r\n \"cash\": {\r\n \"type\": 2,\r\n \"sum\": 100,\r\n \"commission\": 1.01,\r\n \"bank_id\": \"bank_id\",\r\n \"term_id\": \"terminal_id\",\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment_up\": \"Зразок! Верхній комент\",\r\n \"comment_down\": \"Зразок Нижній комент\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Опис відповіді

Структура відповіді аналогічна чеку продажу (описано вище)

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"a8da73a3-6f43-4cda-a07a-7140f43ce202","name":"Чек видачі готівки","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 14,\r\n \"cashier\": \"Постман\",\r\n \"cash\": {\r\n \"type\": 2,\r\n \"sum\": 100,\r\n \"commission\": 1.01,\r\n \"bank_id\": \"bank_id\",\r\n \"term_id\": \"terminal_id\",\r\n \"paysys\": \"paysys_test\",\r\n \"rrn\": \"rrn_test\",\r\n \"cardmask\": \"cardmask****test\",\r\n \"auth_code\": \"auth_code\",\r\n \"comment_up\": \"Зразок! Верхній комент\",\r\n \"comment_down\": \"Зразок Нижній комент\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 14 Nov 2024 10:18:11 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"756"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"420"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 14,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"POSTMAN\",\n \"device\": \"99997955555555\",\n \"tag\": \"9926384e47ac3bd369959bf2aa13bb13\",\n \"dt\": \"20241114121810\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 14,\n \"fisid\": \"99997955555555\",\n \"dataid\": 158,\n \"doccode\": \"TEST_muS2KtTYKboVbA\",\n \"dt\": \"20241114121810\",\n \"cashier\": \"Постман\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 0,\n \"shift_link\": 37,\n \"docno\": 1,\n \"cancelid\": \"TEST_muS2KtTYKboVbA\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_muS2KtTYKboVbA?id=TEST_muS2KtTYKboVbA&date=20241114&time=12:18:10&fn=99997955555555&sm=101.01&mac=b617916f2ab2b1eef8644321d29b4f44e60f8cca06de4964a82660c6eaeacfd9\",\n \"mac\": \"b617916f2ab2b1eef8644321d29b4f44e60f8cca06de4964a82660c6eaeacfd9\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"7549b103-7b95-4664-b246-0a7d8c3f6a1e"},{"name":"Чек переказу коштів","id":"aae1f463-e810-4a1d-ad07-eca5b123c87d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"fiscal\": {\r\n \"task\": 15,\r\n \"cashier\": \"Касир1\",\r\n \"receipt\": {\r\n \"sum\": 110.00,\r\n \"comment_up\": \"Зразок! Коментар шапки чеку\",\r\n \"comment_down\": \"Зразок! Дякуємо\",\r\n \"psp_id\": \"psp_id\",\r\n \"psp_code\": \"psp_code\",\r\n \"psp_name\": \"psp_name\",\r\n \"rows\": [\r\n {\r\n \"code\": \"1\",\r\n \"name\": \"Переказ коштів\",\r\n \"pop\": \"Оплата за послуги користування ПРРО\",\r\n \"recipient_name\": \"Вчасно Сервіс\",\r\n \"recipient_code\": \"recipient_code\",\r\n \"payer_name\": \"Кобилянська О. Ю.\",\r\n \"payer_code\": \"payer_code\",\r\n \"recipient_pan\": \"recipient_pan\",\r\n \"recipient_nban\": \"recipient_nban\",\r\n \"payer_pan\": \"payer_pan\",\r\n \"payer_pr\": \"payer_pr\",\r\n \"transfer_id\": \"transfer_id\",\r\n \"recipient_bankid\": \"recipient_bankid\",\r\n \"recipient_bankname\": \"recipient_bankname\",\r\n \"recipient_ban\": \"recipient_ban\",\r\n \"cnt\": 1,\r\n \"price\": 100.00,\r\n \"cost\": 100.00,\r\n \"taxgrp\": 2,\r\n \"comment\": \"Коментар\",\r\n \"disc\": 0\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 100.00,\r\n \"commission\": 10.00,\r\n \"bank_id\": \"EVOPAY\",\r\n \"rrn\": \"rrn1234\"\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Валідація:

Якщо хоча б в одному із обʼєктів заповнені payer_code та/або payer_name, інші об'єкти повинні мати ідентичні данні по цим полям

Якщо в одному із обʼєктів відсутнє значення payer_code і payer_name, заповнюємо з того обʼєкту де воно є автоматично

Заборонено використовувати форму оплати \"Інше\" для чеку переказу коштів

Додаткові поля об'єкту fiscal.receipt для чеку переказу коштів:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
psp_id	string	Номер ПТКС / номер відокремленого підрозділу надавача платіжних послуг За наявності
psp_name	string	Найменування надавача платіжних послуг За наявності
psp_code	string	Податковий номер надавача платіжних послуг За наявності

Додаткові поля об'єкту fiscal.receipt.rows для чеку переказу коштів:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
recipient_name	string	Назва одержувача За наявності
recipient_code	string	Ідентифікаційний код одержувача За наявності
payer_name	string	Найменування платника За наявності
payer_code	string	Ідентифікаційний код платника За наявності
recipient_pan	string	Реквізити платіжного засобу отримувача За наявності
recipient_nban	string	Номер рахунку отримувача відкритого у небанківського надавача платіжних послуг За наявності
payer_pan	string	Реквізити платіжного засобу платника За наявності
payer_pr	string	Підстава платежу платником За наявності
transfer_id	string	Ідентифікатор переказу За наявності
recipient_bankid	string	Код банку одержувача За наявності
recipient_bankname	string	Найменування банку одержувача За наявності
recipient_ban	string	Номер рахунку в банку одержувача За наявності
pop	string	Призначення платежу (одержувача) За наявності

Опис відповіді

Структура відповіді аналогічна чеку продажу (описано вище)

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"2f208731-6465-40e2-8c1d-b9a53c906d21","name":"Чек переказу коштів","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"fiscal\": {\r\n \"task\": 15,\r\n \"cashier\": \"Касир1\",\r\n \"receipt\": {\r\n \"sum\": 110.00,\r\n \"comment_up\": \"Зразок! Коментар шапки чеку\",\r\n \"comment_down\": \"Зразок! Дякуємо\",\r\n \"psp_id\": \"psp_id\",\r\n \"psp_code\": \"psp_code\",\r\n \"psp_name\": \"psp_name\",\r\n \"rows\": [\r\n {\r\n \"code\": \"1\",\r\n \"name\": \"Переказ коштів\",\r\n \"pop\": \"Оплата за послуги користування ПРРО\",\r\n \"recipient_name\": \"Вчасно Сервіс\",\r\n \"recipient_code\": \"recipient_code\",\r\n \"payer_name\": \"Кобилянська О. Ю.\",\r\n \"payer_code\": \"payer_code\",\r\n \"recipient_pan\": \"recipient_pan\",\r\n \"recipient_nban\": \"recipient_nban\",\r\n \"payer_pan\": \"payer_pan\",\r\n \"payer_pr\": \"payer_pr\",\r\n \"transfer_id\": \"transfer_id\",\r\n \"recipient_bankid\": \"recipient_bankid\",\r\n \"recipient_bankname\": \"recipient_bankname\",\r\n \"recipient_ban\": \"recipient_ban\",\r\n \"cnt\": 1,\r\n \"price\": 100.00,\r\n \"cost\": 100.00,\r\n \"taxgrp\": 2,\r\n \"comment\": \"Коментар\",\r\n \"disc\": 0\r\n }\r\n ],\r\n \"pays\": [\r\n {\r\n \"type\": 0,\r\n \"sum\": 100.00,\r\n \"commission\": 10.00,\r\n \"bank_id\": \"EVOPAY\",\r\n \"rrn\": \"rrn1234\"\r\n }\r\n ]\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 18 Mar 2025 08:13:37 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"677"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"197"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 15,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"\",\n \"device\": \"9999973304407430\",\n \"tag\": \"09cc6d20aa059b2e4dbd033f6068a23d\",\n \"dt\": \"20250318101337\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 15,\n \"fisid\": \"9999973304407430\",\n \"dataid\": 126,\n \"doccode\": \"TEST_BHWyKU8KbdGkIQ\",\n \"dt\": \"20250318101337\",\n \"cashier\": \"Касир1\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 940.5,\n \"shift_link\": 15,\n \"docno\": 4,\n \"cancelid\": \"TEST_BHWyKU8KbdGkIQ\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_BHWyKU8KbdGkIQ?id=TEST_BHWyKU8KbdGkIQ&sm=110.00&fn=9999973304407430&date=20250318&time=10:13:37\",\n \"mac\": \"7b1deb9bf40167ec765a17945dc7b88320da6429f6a0d4fda60478871cb0abc9\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"aae1f463-e810-4a1d-ad07-eca5b123c87d"},{"name":"Чек видачі коштів при переказі","id":"e3a5a8fb-99b7-4b19-bd6e-384ed06bd4e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"fiscal\": {\r\n \"task\": 16,\r\n \"cashier\": \"Касир1\",\r\n \"receipt\": {\r\n \"sum\": 50.00,\r\n \"comment_up\": \"Зразок! Коментар шапки чеку\",\r\n \"comment_down\": \"Зразок! Дякуємо\",\r\n \"rows\": [\r\n {\r\n \"code\": \"1\",\r\n \"name\": \"Переказ коштів\",\r\n \"pop\": \"Оплата за послуги користування ПРРО\",\r\n \"recipient_name\": \"Вчасно Сервіс\",\r\n \"recipient_code\": \"41231992\",\r\n \"payer_name\": \"Кобилянська О. Ю.\",\r\n \"payer_code\": \"774635422\",\r\n \"cnt\": 1,\r\n \"price\": 40.00,\r\n \"cost\": 40.00,\r\n \"commission\": 10.0,\r\n \"taxgrp\": 2,\r\n \"comment\": \"Коментар\",\r\n \"disc\": 0\r\n }\r\n ],\r\n \"pays\": []\r\n },\r\n \"cash\": {\r\n \"type\": 1,\r\n \"sum\": 40.00,\r\n \"commission\": 10.00,\r\n \"bank_id\": \"EVOPAY\",\r\n \"rrn\": \"rrn1234\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Додаткові поля об'єкту fiscal.receipt для чеку видачі коштів при переказі:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
psp_id	string	Номер ПТКС / номер відокремленого підрозділу надавача платіжних послуг За наявності
psp_name	string	Найменування надавача платіжних послуг За наявності
psp_code	string	Податковий номер надавача платіжних послуг За наявності

Додаткові поля об'єкту fiscal.receipt.rows для чеку видачі коштів при переказі:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
recipient_name	string	Назва одержувача За наявності
recipient_code	string	Ідентифікаційний код одержувача За наявності
payer_name	string	Найменування платника За наявності
payer_code	string	Ідентифікаційний код платника За наявності
recipient_pan	string	Реквізити платіжного засобу отримувача За наявності
recipient_nban	string	Номер рахунку отримувача відкритого у небанківського надавача платіжних послуг За наявності
payer_pan	string	Реквізити платіжного засобу платника За наявності
payer_pr	string	Підстава платежу платником За наявності
transfer_id	string	Ідентифікатор переказу За наявності
recipient_bankid	string	Код банку одержувача За наявності
recipient_bankname	string	Найменування банку одержувача За наявності
recipient_ban	string	Номер рахунку в банку одержувача За наявності
pop	string	Призначення платежу (одержувача) За наявності

Опис відповіді

Структура відповіді аналогічна чеку продажу (описано вище)

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"a3d450e3-f791-46a2-86c4-8e0cee3e02de","name":"Чек видачі коштів при переказі","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"fiscal\": {\r\n \"task\": 16,\r\n \"cashier\": \"Касир1\",\r\n \"receipt\": {\r\n \"sum\": 50.00,\r\n \"comment_up\": \"Зразок! Коментар шапки чеку\",\r\n \"comment_down\": \"Зразок! Дякуємо\",\r\n \"rows\": [\r\n {\r\n \"code\": \"1\",\r\n \"name\": \"Переказ коштів\",\r\n \"pop\": \"Оплата за послуги користування ПРРО\",\r\n \"recipient_name\": \"Вчасно Сервіс\",\r\n \"recipient_code\": \"41231992\",\r\n \"payer_name\": \"Кобилянська О. Ю.\",\r\n \"payer_code\": \"774635422\",\r\n \"cnt\": 1,\r\n \"price\": 40.00,\r\n \"cost\": 40.00,\r\n \"commission\": 10.0,\r\n \"taxgrp\": 2,\r\n \"comment\": \"Коментар\",\r\n \"disc\": 0\r\n }\r\n ],\r\n \"pays\": []\r\n },\r\n \"cash\": {\r\n \"type\": 0,\r\n \"sum\": 40.00,\r\n \"commission\": 10.00,\r\n \"bank_id\": \"EVOPAY\",\r\n \"rrn\": \"rrn1234\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 17 Mar 2025 10:42:18 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"676"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"178"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 16,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"\",\n \"device\": \"9999973304407430\",\n \"tag\": \"b216810fd02c37ddeaa37a39944a0971\",\n \"dt\": \"20250317124218\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 16,\n \"fisid\": \"9999973304407430\",\n \"dataid\": 104,\n \"doccode\": \"TEST_Mo173a74miyVDg\",\n \"dt\": \"20250317124218\",\n \"cashier\": \"Касир1\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 730,\n \"shift_link\": 14,\n \"docno\": 2,\n \"cancelid\": \"TEST_Mo173a74miyVDg\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_Mo173a74miyVDg?id=TEST_Mo173a74miyVDg&sm=50.00&fn=9999973304407430&date=20250317&time=12:42:18\",\n \"mac\": \"12dbf3fcca612d99ebb85983d73cc91c3cf0ba01205ecdbe90932cccda20eab8\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"e3a5a8fb-99b7-4b19-bd6e-384ed06bd4e8"},{"name":"Службове внесення","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"daccff93-ded9-420f-a381-ce37feb10357"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","id":"cebd9a2e-e956-4f48-9d8d-4fc33ba782e1"}}],"id":"4fa23975-cd81-440e-a571-0404876bd0d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 3,\r\n \"cashier\": \"Постман\",\r\n \"cash\": {\r\n \"type\": 0,\r\n \"comment_up\": \"Зразок! Тестове внесення готівка\",\r\n \"sum\": 500.50,\r\n \"comment_down\": \"Зразок! Внесення\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Опис відповіді

Структура відповіді аналогічна чеку продажу (описано вище).

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"43088a31-8c58-443d-92cc-fa2dafb5c50b","name":"Службове внесення","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 3,\r\n \"cashier\": \"Постман\",\r\n \"cash\": {\r\n \"type\": 0,\r\n \"comment_up\": \"Зразок! Тестове внесення готівка\",\r\n \"sum\": 500.50,\r\n \"comment_down\": \"Зразок! Внесення\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 14 Nov 2024 10:17:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"756"},{"key":"Connection","value":"keep-alive"},{"key":"server","value":"istio-envoy"},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-envoy-upstream-service-time","value":"365"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 3,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"POSTMAN\",\n \"device\": \"99997955555555\",\n \"tag\": \"49c8b16e0ee40a2c3337fd97e9d0f8e7\",\n \"dt\": \"20241114121717\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 3,\n \"fisid\": \"99997955555555\",\n \"dataid\": 156,\n \"doccode\": \"TEST_Kh3BQlxRKP0cUg\",\n \"dt\": \"20241114121717\",\n \"cashier\": \"Постман\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 600.5,\n \"shift_link\": 37,\n \"docno\": 1,\n \"cancelid\": \"TEST_Kh3BQlxRKP0cUg\",\n \"qr\": \"https://kasa.vchasno.ua/c/TEST_Kh3BQlxRKP0cUg?id=TEST_Kh3BQlxRKP0cUg&date=20241114&time=12:17:17&fn=99997955555555&sm=500.50&mac=ee8c01741c0b95cf28c6688e4e29b92fbb0c3fedf511482b8306ce0a7c75840e\",\n \"mac\": \"ee8c01741c0b95cf28c6688e4e29b92fbb0c3fedf511482b8306ce0a7c75840e\"\n },\n \"error_extra\": null\n}"}],"_postman_id":"4fa23975-cd81-440e-a571-0404876bd0d3"},{"name":"Службова видача","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"e4bc0aa7-f5f6-4d4b-b2ed-8020013d87af"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","id":"0359adcd-c5d4-4523-bbd7-ed574299a68d"}}],"id":"b7855a7e-7cc9-44c7-b561-dab75bf3c2f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 4,\r\n \"cashier\": \"Постман\",\r\n \"cash\": {\r\n \"type\": 0,\r\n \"comment_up\": \"Зразок! Тестова видача готівка\",\r\n \"sum\": 500.50,\r\n \"comment_down\": \"Зразок! Видача\"\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Опис відповіді

Структура відповіді аналогічна чеку продажу (описано вище)

Опис відповіді

Структура об'єкту info для завдань 10, 11 (X\\Z-звіт)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
task	integer	Тип завдання
dt	string	Дата та час проведення чеку в форматі YYYYMMDDHHMMSS
fisid	string	Фіскальний номер каси
doccode	string	Фіскальний номер чеку (для X-звіту повертається пусте значення)
docno	integer	Порядковий номер Z-звіту
dataid	integer	Номер сформованого пакету
shift_link	integer	Номер зміни каси
shift_id	string	ID зміни
cashier	string	Іноформація про касира
isoffline	bool	В якому режимі проведено чек true - в офлайні false - в онлайні
safe	float	Сума готівки в касі
dtype	integer	Тип девайсу 0 - тестовий 1 - фіскальний
taxes	massive of objects	Підсумки по податкам в розрізі податкових груп
pays	massive of objects	Підсумки по видам оплат
money	massive of objects	Підсумки по службовим внесенням\\видачам
cash	massive of objects	Підсумки по операціям видачі готівки
summary	object	Загальні підсумки по обороту, податкам, знижкам по продажам і поверненням за зміну
receipt	object	Підсумки по кількості чеків
lastcheck	object	Об'єкт із даними про останній фіскальний чек в зміні.

Структура об'єктів масиву info.taxes (підсумки по податкам)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
gr_code	integer	Код податкової групи
base_sum_p	float	База, обкладена податком і акцизом (сума) по продажам
base_sum_m	float	База, обкладена податком і акцизом (сума) по поверненням
tax_name	string	Назва податку
tax_fname	string	Назва податку (повна)
tax_lit	string	Буква, що позначає податок
tax_percent	float	Ставка податку
tax_sum_p	float	Сума податку по продажам
tax_sum_m	float	Сума податку по поверненням
ex_name	string	Назва акцизу
ex_percent	float	Ставка акцизу
ex_sum_p	float	Сума акцизу по продажам
ex_sum_m	float	Сума акцизу по поверненням

Структура об'єктів info.pays/money (підсумки по видам оплат, службовим внесенням/видачам)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
type	integer	Код виду оплати
name	string	Назва виду оплати
sum_p	float	Сума по виду оплати по продажам
sum_m	float	Сума по виду оплати по поверненням
round_pu	float	Сума округлень, прийнятих в більшу сторону
round_pd	float	Сума округлень прийнятих в меншу сторону
round_mu	float	Сума округлень виданих в меншу сторону
round_md	float	Сума округлень виданих в меншу сторону

Структура об'єктів info.сash (підсумки по операціям видачі готівки)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
type	integer	Код виду оплати
name	string	Назва виду оплати
sum_m	float	Сума виданої готівки
round_mu	float	Сума комісії

Структура об'єкту info.receipt (підсумки по кількості чеків)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
count_p	integer	Кількість чеків продажу
count_m	integer	Кількість чеків повернень
last_docno_p	integer	Останній локальний номер чеку продажу в зміні
last_docno_m	integer	Останній локальний номер чеку повернення в зміні
count_transfer	integer	Кількість чеків переказу коштів

Структура об'єкту info.summary (загальні підсумки)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
base_p	float	Загальний обіг по продажам (сума всіх податкових баз по продажам)
base_m	float	Загальний обіг по поверненням (сума всіх податкових баз по поверненням)
taxex_p	float	Загальна сума всіх податків і акцизів по продажам
taxex_m	float	Загальна сума всіх податків і акцизів по поверненням
disc_p	float	Загальна знижка по всім товарним позиціям всіх чеків
disc_m	float	Загальна націнка по всім товарним позиціям всіх чеків

Структура об'єкту info.money_transfer

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
type	integer	Код виду оплати
name	string	Назва
sum_p	float	Чек переказу (гроші прийшли до нас)
sum_m	float	Чек видачі коштів при переказі (кошти покидають нас)
commission_p	float	Комісія переказу
commission_m	float	Комісія видачі коштів

Структура об'єкту info.lastcheck (Об'єкт із даними про останній фіскальний чек в зміні)

У вибірку потрапляють чеки з task: 1, 2, 14, 15, 16.
Якщо у зміні немає чеків даного типу, відповідь info.lastcheck міститиме дефолтні значення для полів: integer=0, string=''.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
packnum	integer	Номер пакету чеку ( == info.data_id з відповіді при фіскалізації чеку)
docnum	integer	Номер чеку з зміні (локальний номер).
fisnum	string	Фіскальний номер чеку.
packtype	integer	Тип завдання чеку, відповідає task.

Опис відповіді

Структура відповіді аналогічна X-звіту (описано вище)

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","fiscal","execute"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"9cb23bc3-1ab6-426e-be5d-30f0e89c8473","name":"Z-звіт","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"{\r\n \"source\": \"POSTMAN\",\r\n \"fiscal\": {\r\n \"task\": 11,\r\n \"cashier\": \"Постман\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 31 Jan 2024 08:13:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"task\": 11,\n \"type\": 1,\n \"ver\": 6,\n \"source\": \"POSTMAN\",\n \"device\": \"99997655555555\",\n \"tag\": \"704e5fca77edf44d2ce8e379bdd68429\",\n \"dt\": \"20240131101319\",\n \"res\": 0,\n \"res_action\": 0,\n \"errortxt\": \"\",\n \"warnings\": [],\n \"info\": {\n \"task\": 11,\n \"fisid\": \"99997655555555\",\n \"dataid\": 202,\n \"doccode\": \"TEST_cTMHA3qiU6DDvA\",\n \"dt\": \"20240131101319\",\n \"cashier\": \"Постман\",\n \"dtype\": 0,\n \"isprint\": 0,\n \"isoffline\": false,\n \"safe\": 400.5,\n \"shift_link\": 46,\n \"shift_id\": \"6b72e68d-e596-4e11-a190-bedbded40cc2\",\n \"docno\": 46,\n \"receipt\": {\n \"count_p\": 1,\n \"count_m\": 1,\n \"count_14\": 1,\n \"count_transfer\": 0,\n \"last_docno_p\": 1,\n \"last_docno_m\": 1\n },\n \"summary\": {\n \"base_p\": 199.99,\n \"base_m\": 199.99,\n \"taxex_p\": 27.17,\n \"taxex_m\": 27.17,\n \"disc_p\": 0,\n \"disc_m\": 0\n },\n \"taxes\": [\n {\n \"gr_code\": 3,\n \"base_sum_p\": 99.99,\n \"base_sum_m\": 99.99,\n \"base_tax_sum_p\": 95.23,\n \"base_tax_sum_m\": 95.23,\n \"base_ex_sum_p\": 99.99,\n \"base_ex_sum_m\": 99.99,\n \"tax_name\": \"ПДВ_Г\",\n \"tax_fname\": \"ПДВ 20% + акциз 5%\",\n \"tax_lit\": \"ГД\",\n \"tax_percent\": 20,\n \"tax_sum_p\": 15.87,\n \"tax_sum_m\": 15.87,\n \"ex_name\": \"Акцизний податок 5% Д\",\n \"ex_percent\": 5,\n \"ex_sum_p\": 4.76,\n \"ex_sum_m\": 4.76\n },\n {\n \"gr_code\": 4,\n \"base_sum_p\": 100,\n \"base_sum_m\": 100,\n \"base_tax_sum_p\": 100,\n \"base_tax_sum_m\": 100,\n \"base_ex_sum_p\": 0,\n \"base_ex_sum_m\": 0,\n \"tax_name\": \"ПДВ_В\",\n \"tax_fname\": \"ПДВ 7%\",\n \"tax_lit\": \"В\",\n \"tax_percent\": 7,\n \"tax_sum_p\": 6.54,\n \"tax_sum_m\": 6.54,\n \"ex_name\": \"\",\n \"ex_percent\": 0,\n \"ex_sum_p\": 0,\n \"ex_sum_m\": 0\n }\n ],\n \"pays\": [\n {\n \"type\": 0,\n \"name\": \"Готівка\",\n \"sum_p\": 150,\n \"sum_m\": 150,\n \"round_pu\": 0.01,\n \"round_pd\": 0,\n \"round_mu\": 0.01,\n \"round_md\": 0\n },\n {\n \"type\": 2,\n \"name\": \"Картка\",\n \"sum_p\": 50,\n \"sum_m\": 50,\n \"round_pu\": 0,\n \"round_pd\": 0,\n \"round_mu\": 0,\n \"round_md\": 0\n }\n ],\n \"money\": [\n {\n \"type\": 0,\n \"name\": \"Готівка\",\n \"sum_p\": 1001,\n \"sum_m\": 500.5,\n \"round_pu\": 0,\n \"round_pd\": 0,\n \"round_mu\": 0,\n \"round_md\": 0\n }\n ],\n \"cash\": [\n {\n \"type\": 2,\n \"name\": \"Картка\",\n \"sum_p\": 0,\n \"sum_m\": 100,\n \"round_pu\": 0,\n \"round_pd\": 0,\n \"round_mu\": 1.01,\n \"round_md\": 0\n }\n ],\n \"money_transfer\": []\n },\n \"error_extra\": null\n}"}],"_postman_id":"b451ff12-7a03-47c2-82f2-d6059850e461"}],"id":"4fb31987-26f9-4c70-9972-c1cf4179aea0","description":"

Всі запити на фіскалізацію виконуються через URL POST /api/v3/fiscal/execute

Зазвичай час виконання запиту на фіскалізацію складає до 1 секунди.
При проблемах з АЦСК чи ДПС ми виконуємо додаткові заходи задля забезпечення безперебійної роботи, тому рекомендуємо виставити таймаут на запит у 25 секунд. Обовʼязково передавайте у запитах на фіскалізацію свій унікальний tag.

При виконанні запиту чеку (task: 1, 2, 3, 4, 14, 15, 16) на закритій зміні каси автоматично надсилається запит на відкриття зміни (task: 0).

Структура запиту

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
dt	string	Дата і час завдання в форматі YYYYMMDDHHMMSS. Використовується як дата і час для чеку Необов'язкове поле, якщо не передати - використається час серверу ВАЖЛИВО! Дата чеку, що проводиться, має бути >= дати попереднього проведеного чеку. В іншому випадку ДПС не прийме такий чек.
tag	string	Ідентифікатор запиту. Можна вказати довільний рядок. Використовується для ідентифікації повторних запитів на фіскалізацію. Для уникнення дублювання чеків, необхідно у кожному запиті вказувати власний унікальний ідентифікатор. Необов'язкове поле, якщо не передати чи передати пустим, сервером буде згенеровано uuid для цього поля.
source	string	Назва джерела завдання, може бути довільною. Слугує для кращої ідентифікації в логах Необов'язкове поле
fiscal	object	Об'єкт з реквізитами фіскального завдання
userinfo	object	Дані, куди надсилати посилання на чек (для завдань 1, 2, 3, 4, 14, 15, 16). Необов'язкове поле Об'єкт виду: { \"email\" : \"...\", \"phone\": \".+380XXXXXXXXX\" } Очікуємо формат +380XXXXXXXXX, та якщо ви вкажете додаткові розділові знаки у номері (наприклад +380ХХ-ХХХ-ХХ-ХХ), ми спробуємо конвертувати його у потрібний формат У випадку, якщо телефон чи емейл вказано невірно - повідомлення не буде відправлено, але на проведення чеку це ніяк не вплине (не буде валідаційної помилки).

Структура об'єкту fiscal (реквізити фіскального завдання)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
task	integer	Тип фіскального завдання: 0 - відкриття зміни, 1 - чек продажу, 2 - чек повернення, 3 - службове внесення, 4 - службова видача, 14 - чек видачі готівки, 15 - чек переказу коштів, 16 - чек видачі коштів при переказі, 10 - X-звіт, 11 - Z-звіт, 18 - статус пРРО.
subtask	integer	Маркування, тільки для чеків передплати та постоплати 1 - передплата 2 - постоплата
cashier	string	Інформація про касира Необов'язкове поле
receipt	object	Поля чеку (для завдань 1 і 2)
cash	object	Поля внесення/видачі, чеку видачі готівки і чеку видачі готівки при переказі (для завдань 3, 4, 14 і 16)

Структура об'єкту fiscal.receipt (поля чеку)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
sum	float	Сума чеку (2 знаки після коми) з урахуванням всіх знижок
round	float	Сума округлення (входить до суми чеку. На цю суму має відрізнятись сума чеку від сум по всіх видам оплати
comment_up	string	Коментар, який друкується перед списком товарів Необов'язкове поле
comment_down	string	Коментар, який друкується внизу чеку Необов'язкове поле
rows	Massive of objects	Рядки чеку
pays	Massive of objects	Оплати чеку (по видам)
purchase_receipt_fisn	string	Обов'язкове поле для чеків повернення (task2) по программі \"Національний кешбек\" Фіскальний номер чеку на продаж на основі якого здійснюється повернення
purchase_rro_fisn	string	Обов'язкове поле для чеків повернення (task2) по программі \"Національний кешбек\" Фіскальний номер РРО або ПРРО з якого було здійснено оригінальний продаж товару по чеку вказаного в purchase_receipt_fisn
purchase_receipt_dt	string	Обов'язкове поле для чеків повернення (task2) по программі \"Національний кешбек\" Дата фіскалізації чеку на продаж по якому здійснюється повернення в форматі YYYYMMDD.
disc	float	Сума або відсоток загальної знижки на чек. Необов'язкове поле
disc_type	integer	Визначає тип загальної знижки у fiscal.receipt.disc Значення: 0 - сумова, 1 - відсоткова знижка. Необов'язкове поле
discounts	Massive of objects	Список загальних знижок (якщо є потреба задати декілька). Необов'язкове поле

Структура об'єкту fiscal.receipt.rows (рядки чеку)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
code	string	Артикул товару в обліковій системі підприємства Необов'язкове поле
code1	string	ШК товару Необов'язкове поле
code2	string	Код УКТЗЕД Необов'язкове поле
code3	string	Код ДКПП Необов'язкове поле
code_a	string	Код акцизної марки товару Необов'язкове поле
code_aa	Massive	Масив акзизних марок товарів (для випадку, коли для одної позиції декілька марок) Необов'язкове поле
name	string	Назва товару
cnt	float	Кількість товару (не більше 3х знаків після коми)
price	float	Ціна товару (2 знаки після коми) Може бути пустим, тоді рахується автоматично шляхом поділу поля cost на cnt і математичним округленням
disc	float	Знижка на рядок чеку (2 знаки після коми)
cost	float	Сума по рядку до знижки Може бути пустим, тоді рахується автоматично шляхом множення поля cnt на price і математичним округленням
taxgrp	integer	Код податкової групи: 1 ПДВ 20% 2 Без ПДВ 3 ПДВ 20% + акциз 5% 4 ПДВ 7% 5 ПДВ 0% 6 Без ПДВ + акциз 5% 7 Не є об`єктом ПДВ 8 ПДВ 20% + ПФ 7.5% 9 ПДВ 14%
comment	string	Коментар на рядок Необов'язкове поле

Структура об'єкту fiscal.receipt.pays (Оплати чеку (по видам))

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
type	integer	Код виду оплати. Дефолтні коди: 0 Готівка 1 Безготівка 2 Картка 3 Передплата 4 Післясплата 5 Кредит 6 Сертифікат 8 Чек 11 Бонусні бали 12 Погашення кредиту 13 Переказ через QR-код 14 Переказ з картки 15 Переказ з поточного рахунку 16 Інтернет еквайринг 17 Платіж LiqPay 18 Платіж через сервіс переказу ROZETKA Pay 19 Платіж Portmone 20 Платіж NovaPay
sum	float	Сума оплати (2 знаки після коми)
comment	string	Коментар на рядок оплати Необов'язкове поле
change	float	Решта (для оплати готівкою) Для правильного внесення оплати з рештою необхідно - в поле sum внести суму, яка іде в залік, - в поле change - решту. Загальна сума, яка отримана від покупця, розраховується як sum+change
paysys	string	Назва платіжної системи (для оплати карткою) Необов'язкове поле
rrn	string	Код транзакції (для оплати карткою) Необов'язкове поле
cardmask	string	Замаскований номер картки (для оплати карткою) Необов'язкове поле
term_id	string	Ідентифікатор платіжного терміналу (для оплати карткою) Необов'язкове поле
bank_name	string	Назва банку еквайера (для оплати карткою). Вказується виключно як інформаційне поле для відображення в формі чеку назви банку еквайра. Не відображається у вьювері чеків без bank_id. Дані вказані в це поле не відправляються в ДПС. Необов'язкове поле
bank_id	string	Ідентифікатор банку (для оплати карткою) Необов'язкове поле
auth_code	string	Код авторизації (для оплати карткою) Необов'язкове поле
oper_type	string	Вид операції Необов'язкове поле
commission	float	Сума комісії Необов'язкове поле
purchase_dt	string	Обов'язкове поле для чеків продажу (task1) по программі \"Національний кешбек\" Дата та час авторизації оплати на терміналі в форматі YYYYMMDDHHMMSS. У візуалізації чеку даний час не відображається, лише передається в ДПС.

Структура об'єкту fiscal.receipt.discounts (Список загальних знижок)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
disc	float	Сума або відсоток загальної знижки на чек.
disc_type	integer	Тип загальної знижки. Значення: 0 - сумова, 1 - відсоткова знижка.
disc_name	string	Назва загальної знижки. За замовчуванням \"Знижка\". Необов'язкове поле

Структура об'єкту fiscal.cash (Поля внесення/видачі, чеку видачі готівки, чеку видачі коштів при переказі)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
type	integer	Код виду оплати. Дефолтні коди: 0 Готівка 1 Безготівка 2 Картка 3 Передплата 4 Післясплата 5 Кредит 6 Сертифікат 8 Чек 11 Бонусні бали 12 Погашення кредиту 13 Переказ через QR-код 14 Переказ з картки 15 Переказ з поточного рахунку 16 Інтернет еквайринг 17 Платіж LiqPay 18 Платіж через сервіс переказу ROZETKA Pay 19 Платіж Portmone 20 Платіж NovaPay
sum	float	Сума внесення\\видачі (2 знаки після коми)
comment_up	string	Коментар, який друкується перед сумою Необов'язкове поле
comment_down	string	Коментар, який друкується після суми Необов'язкове поле
paysys	string	Назва платіжної системи (лише для чеку видачі готівки та чеку видачі готівки при переказі)
rrn	string	Код транзакції Обовя'зкове поле для task 4, 16
cardmask	string	Замаскований номер картки (лише для чеку видачі готівки та чеку видачі готівки при переказі)
term_id	string	Ідентифікатор платіжного терміналу (лише для чеку видачі готівки та чеку видачі готівки при переказі)
bank_id	string	Ідентифікатор банку Обовя'зкове поле для task 4, 16
auth_code	string	Код авторизації (лише для чеку видачі готівки та чеку видачі готівки при переказі)
commission	float	Сума комісії (лише для чеку видачі готівки та чеку видачі готівки при переказі)

Структура відповіді

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
ver	integer	Версія схеми (службове поле)
source	string	Назва джерела завдання
device	string	Фіскальний номер каси
tag	string	Мітка завдання для ідентифікації відповіді
dt	string	Дата та час виконання в форматі YYYYMMDDHHMMSS
res	integer	Код результату 0 - ОК > 0 - код помилки
res_action	integer	Подальші рекомендовані дії для збереження транзакційної цілісності О - ОК, можна переходити до наступного завдання 1 - помилка, завдання не пройшло, необхідно повторити запит 2 - помилка + колізія. Виправлення колізії буде виконано при наступному запиті, тому необхідно виконати повтор для збереження транзакційності 3 - помилка, що потребує зупинки та ручного фіксу
errortxt	string	Текстова інформація про помилку
error_extra	object / null	Опційний обʼєкт, в якому повертаються деталі щодо помилки. Наприклад перелік полів, та причини, чому вони не пройшли валідацію
warnings	massive of objects	Масив об'єктів вигляду {code: 0, wtxt: \"...\"} з кодами та текстами попереджень, які потрібно донести до касира. Перелік кодів та текстів у розділі \"Опис помилок\"
task	integer	Тип завдання
info	Object	Вихідні дані Опис об'єкту info для конкретного типу завдання приведено у самих запитах нижче

","_postman_id":"4fb31987-26f9-4c70-9972-c1cf4179aea0","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}}},{"name":"Службові запити","item":[{"name":"Статус пРРО","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","id":"5a6a4588-9265-4e96-9f3d-a4501015bcaf"}},{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","id":"a4c103d2-cfde-4d9a-be4a-2b5fe3b7f2f5"}}],"id":"77ab5957-c92b-42f8-9d3b-03e34bc91521","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"fiscal\": {\r\n \"task\": 18\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/fiscal/execute","description":"

Хоч даний АПІ запит має шлях як у запитів фіскалізації чеків, при його обробці не виконуються запити до ДПС, лише повертається статус з сервісу Вчасно.Каса.

Опис відповіді

Структура об'єкту info для завдання 18 (статус пРРО)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
edrpou	string	ЄДРПОУ/ІПН
fisid	string	Фіскальний номер каси
isFis	integer	ПРРО є фіскальним 0 - не фіскальний (тестовий) 1 - фіскальний
shift_status	integer	Статус зміни: -1 - невідомо 0 - закрита 1 - відкрита
shift_dt	string	Дата та час відкриття активної зміни: \"\" - невідомо інакше - дата и та час відкриття в форматі YYYYMMDDHHMMSS
shift_id	string	ID зміни
online_status	integer	Статус зв'язку з ДФС: 0 - online 1 - offline
sign_status	integer	Статус ЕЦП: -1 - невідомо 0 - підпис не використовується 1 - підпис є і нема попереджень 2 - підпис є попередження 3 - підпису нема або помилка *зараз завжди повертається -1, інші статуси буде імплементовано пізніше
safe	float	Сума залишку готівки в касі

Запит на отримання JSON-у запиту фіскалізованого чеку. Повертає весь json body, по якому було створено чек

check_fisn - Фіскальний номер чеку

Опис відповіді

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
fiscal_number	string	Фіскальний номер чеку
task	object	boby чеку (опис вище)

Запит на отримання фіскалізованого чеку у форматі JSON. Цей роут не працює з сервісними чеками та Z-звітом.

fiscal_number - Фіскальний номер чеку

Типи даних:

кількість одиниць - decimal рядок
\n
вага - 3 знаки - '1.000'
\n
сума - decimal рядок
\n
відсотки - 2 знаки - '55.00'
\n

Опис полів:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
fiscal_number	Фіскальний номер чеку
company_name	Назва компанії
notification_company_name	Назва компанії для сповіщень
company_edrpou	ЄДРПОУ
company_tax_number	ПН
shop_name	Назва Торгової Точки
shop_type	Тип Торгової Точки
shop_address	Адреса ТТ
rro_fiscal_number	Фіскальний номер ПРРО
is_offline	Чи видано чек в офлайні
is_test	Чи це тестовий чек
date_created	Дата створення запису чеку
check_flow	0-продаж,1-повернення,2-службове внесення-винесення,4-переказ коштів,7-видача коштів при переказі,14-видача готівки
check_url	Посилання на чек в нашому кабінеті
qr_content	Сформований рядок для QR коду в чеці
target_url	Посилання на чек в ДПС
data	Обʼєкт з деталями по чеку

Об'єкт data

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
data:cash	Обʼєкт, опис окремо
data:check_type	1-продаж,2-повернення,3-сервісне внесення,4-сервісне винесення,14-видача готівки,15-переказ коштів,16-видача готівки при переказі
data:items	Список обʼєктів, опис окремо
data:close	Обʼєкт, опис окремо
data:pays	Список обʼєктів, опис окремо
data:taxes	Список обʼєктів, опис окремо
data:markups	Сума націнки
data:top_comment	Верхній коментар чеку. Список з рядків, розділених по довжині в N символів
data:last_comment	Верхній коментар чеку. Структура як у верхнього коментаря.
data:date	Дата з чеку
data:mac	Контрольне число чеку
data:rounding	Сума заокруглення
data:service_move_data	Обʼєкт, опис окремо
data:global_discounts	Список, опис окремо

Об'єкт data:cash - в чеці видачі готівки

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
cash_sum	Сума готівки
commission	Сума комісії
bank_id	Ідентифікатор єквайера торговця
term_id	Ідентифікатор платіжного пристрою
cardmask	Реквізити ЕПЗ
auth_code	Код авторизації
paysys	Назва платіжної системи
rrn	Ідентифікатор транзакції

Об'єкт data:items

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
name	Назва товару, послуги, або операції
tg_print	Позначення податку, яким обкладається товар
sum	Сума операції
cnt	Кількість
price	Ціна товару
code	Код товару в обліковій системі підприємства
code1	Штрихкод
code2	Код товарної підкатегорії згідно з УКТЗЕД
comment	Список рядків коментарів
excise_codes	Список з акцизних кодів
markup	Обʼєкт, націнка
discount	Обʼєкт, знижка

Об'єкт data:items::markup/discount

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
sum	Сума операції
tg_print	Позначення податку

Об'єкт data:close

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
sum	Сума чеку
to_pay	Сума до оплати

Об'єкт data:pays

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
name	Тип
pay_sum	Сума оплати
change	Решта
sum	Сума з урухуванням решти
comment	Коментар
bank_id	Ідентифікатор єквайера торговця
term_id	Ідентифікатор платіжного пристрою
operation	Тип операції(платіж/повернення/переказ тощо)
cardmask	Реквізити ЕПЗ
auth_code	Код авторизації
commission	Сума комісії
paysys	Назва платіжної системи
rrn	Ідентифікатор транзакції

Об'єкт data:taxes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
tax_caption	позначення податку
tax_percent	відсоток податку
tax_sum	сума податку
dt_caption	назва додаткового збору (акциз/в.збір)
dt_percent	відсоток додаткового збору
dt_sum	сума додаткового збору

Об'єкт data:service_move_data

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
tag	I-внесення, O-видача
name	назва оплати

Об'єкт data:global_discounts

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
sum	сума загальної знижки
name	назва загальної знижки

","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["c","{fiscal_number}.json"],"host":["https://kasa.vchasno.ua"],"query":[],"variable":[]}},"response":[{"id":"981b857e-24a3-4f5d-bb58-efa73a6d1ec0","name":"Отримати JSON чеку","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"url":"https://kasa.vchasno.ua/c/TEST_KkcD6uzuYeq08g.json"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 31 Jan 2024 08:15:34 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Strict-Transport-Security","value":"max-age=31536000; includeSubDomains"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"fiscal_number\": \"TEST_KkcD6uzuYeq08g\",\n \"company_name\": \"Приватне підприємство \\\"Тестер\\\"\",\n \"notification_company_name\": \"Приватне підприємство \\\"Тестер\\\"\",\n \"company_edrpou\": \"55555555\",\n \"company_tax_number\": \"\",\n \"shop_name\": \"Тестова торгова точка\",\n \"shop_type\": \"Тип Торгової Точки\",\n \"shop_address\": \"Україна, м.Київ, вул. Хрещатик, 999\",\n \"rro_fiscal_number\": \"99997655555555\",\n \"is_offline\": false,\n \"is_test\": true,\n \"date_created\": \"2024-01-31T10:05:55.798668+02:00\",\n \"check_flow\": 0,\n \"check_url\": \"https://kasa.vchasno.ua/c/TEST_KkcD6uzuYeq08g\",\n \"qr_content\": \"https://kasa.vchasno.ua/c/TEST_KkcD6uzuYeq08g?id=TEST_KkcD6uzuYeq08g&date=20240131&time=10:05:55&fn=99997655555555&sm=200.00&mac=160cf7bebc397274f765d73d6174b3dfc8b299786070227a31f0483a80c7d9b6\",\n \"target_url\": \"https://kasa.vchasno.ua/c/TEST_KkcD6uzuYeq08g?id=TEST_KkcD6uzuYeq08g&date=20240131&time=10:05:55&fn=99997655555555&sm=200.00&mac=160cf7bebc397274f765d73d6174b3dfc8b299786070227a31f0483a80c7d9b6\",\n \"data\": {\n \"cash\": null,\n \"check_type\": \"0\",\n \"items\": [\n {\n \"name\": \"Продукт 1\",\n \"tg_print\": \"В\",\n \"sum\": \"110.00\",\n \"cnt\": \"2.000\",\n \"price\": \"55.00\",\n \"code\": \"00001\",\n \"code1\": \"73463253\",\n \"code2\": \"54321\",\n \"comment\": [\n \"Зразок! Коментар\"\n ],\n \"excise_codes\": [\n \"XX11111111111\",\n \"XX11111111112\"\n ],\n \"discount\": {\n \"sum\": \"10.00\",\n \"tg_print\": \"В\"\n },\n \"markup\": null\n },\n {\n \"name\": \"Продукт 2\",\n \"tg_print\": \"ГД\",\n \"sum\": \"89.99\",\n \"cnt\": \"1.000\",\n \"price\": \"89.99\",\n \"code\": \"00002\",\n \"code1\": \"73463254\",\n \"code2\": \"45667\",\n \"comment\": [\n \"Зразок! \\\"Have a good day\\\"\"\n ],\n \"excise_codes\": [\n \"XX11111111113\"\n ],\n \"discount\": null,\n \"markup\": {\n \"sum\": \"10.00\",\n \"tg_print\": \"ГД\"\n }\n }\n ],\n \"close\": {\n \"sum\": \"199.99\",\n \"to_pay\": \"200.00\"\n },\n \"pays\": [\n {\n \"name\": \"Готівка\",\n \"pay_sum\": \"200.00\",\n \"change\": \"50.00\",\n \"sum\": \"150.00\",\n \"comment\": [\n \"Зразок! Тест\"\n ],\n \"bank_id\": \"\",\n \"term_id\": \"\",\n \"operation\": \"Оплата\",\n \"oper_type\": \"Оплата\",\n \"cardmask\": \"\",\n \"auth_code\": \"\",\n \"commission\": \"0.00\",\n \"paysys\": \"\",\n \"rrn\": \"\",\n \"show_additional_info\": true\n },\n {\n \"name\": \"Картка\",\n \"pay_sum\": \"50.00\",\n \"change\": \"0.00\",\n \"sum\": \"50.00\",\n \"comment\": [\n \"Зразок! СЛАВА*УКРАЇНІ\"\n ],\n \"bank_id\": \"bank_id\",\n \"term_id\": \"term_id\",\n \"operation\": \"Оплата\",\n \"oper_type\": \"Оплата\",\n \"cardmask\": \"cardmask****test\",\n \"auth_code\": \"auth_code\",\n \"commission\": \"1.00\",\n \"paysys\": \"paysys_test\",\n \"rrn\": \"rrn_test\",\n \"show_additional_info\": true\n }\n ],\n \"taxes\": [\n {\n \"tax_caption\": \"ПДВ_Г\",\n \"tax_percent\": \"20\",\n \"tax_sum\": \"15.87\",\n \"dt_caption\": \"Акцизний податок 5% Д\",\n \"dt_percent\": \"0.05\",\n \"dt_sum\": \"4.76\"\n },\n {\n \"tax_caption\": \"ПДВ_В\",\n \"tax_percent\": \"7\",\n \"tax_sum\": \"6.54\",\n \"dt_caption\": \"\",\n \"dt_percent\": \"0.00\",\n \"dt_sum\": \"0.00\"\n }\n ],\n \"markups\": \"10.00\",\n \"top_comment\": [\n \"Зразок! Коментар шапки чеку\"\n ],\n \"last_comment\": [\n \"Зразок! ДЯКУЄМО за покупку\"\n ],\n \"date\": \"2024-01-31T10:05:55+02:00\",\n \"mac\": \"b7c9d8cc246acaaace9d2ce1b2c375173a9262d87a34067d56a89351bd23087a\",\n \"rounding\": \"0.01\",\n \"service_move_data\": null\n }\n}"}],"_postman_id":"d6354cf7-e22a-41c4-945e-8f3ac0a04170"},{"name":"Отримати зміни по касі","id":"95c0754d-5998-42c7-829f-11919a06a831","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/shifts","description":"

Запит на отримання змін по касі, ідентифікатором каси служить токен каси.

За замовчуванням повертає відсортований по date_closed список об'єктів з лімітом 100

Додаткові параметри: пагінація page=n&limit=n (значення n не може бути менше 1)

Опис відповіді об'єкту items

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
id	Ідентифікатор зміни
date_started	Дата і час початку зміни
date_closed	Дата і час кінця зміни
cash_started	Залишок готівки на початку зміни
cash_current	Поточний залишок готівки
cash_closed	Залишок готівки при закритті зміни

Запит на отримання чеків по зміні, shift_id - ідентифікатор зміни

За замовчуванням повертає відсортований по date_created список об'єктів з лімітом 100

Додаткові параметри: пагінація page=n&limit=n (значення n не може бути менше 1)

Опис відповіді об'єкту items

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
id	Ідентифікатор чеку
shift_id	Ідентифікатор зміни
local_number	Локальний номер чеку відносно зміни
fiscal_number	Фіскальний номер чеку
type	Тип чеку: chk - чек z_report - З-звіт service - сервісний чек
status	Підтвердження фіскалізації чеку: 0 - Unknown, не визначений; 1 - OK, чек фіскалізовано, надано номер; -1 - ERROR_VEREFY, помилка перевірки підпису; -2 - ERROR_CHECK, помилка перевірки РРО; -3 - ERROR_SAVE, помилка запису; -4 - ERROR_UNKNOWN, загальна помилка; -5 - ERROR_TYPE, помилка типу посилки; -6 - ERROR_NOT_PREV_ZREPORT, нема Z-звіту за попередній день; -7 - ERROR_XML, невірний формат XML ( структура , фіскальний номер); -8 - ERROR_XML_DATE, невірний формат XML дата не відповідає Check.date; -9 - ERROR_XML_CHK, невірний формат XML чеку; -10 - ERROR_XML_ZREPORT, невірний формат Z-звіту; -11 - ERROR_OFFLINE_168, РРО заблокований, перевищено ліміт 168 годин офлайну; -12 - ERROR_BAD_HASH_PREV, невірний хеш попереднього чеку; -13 - ERROR_NOT_REGISTERED_RRO, не зареєстровано ПРРО; -14 - ERROR_NOT_REGISTERED_SIGNER, не зареєстрований підписант; -15 - ERROR_NOT_OPEN_SHIFT, не відкрита зміна; -16 - ERROR_OFFLINE_ID, невірний оффлайн ID
source	Ідентифікація джерела видачі чеку: 1 - device_manager, 2 - кабінет без офлайну або аварійне закриття, 3 - веб API, 4 - автозгенерований кабінетом, 5 - мобільний додаток, 6 - вебкабінет з офлайном
date_created	Дата створення
data_id	Загальний номер чеку відносно каси
check_hash	Хеш чеку, генерація SHA256 від xml чеку
flow	Який чек створено: 0 - Чек продажу 1 - Чек повернення 2 - Службовий чек внесення коштів 4 - Переказ коштів 7 - Чек видачі коштів при переказі 8 - Відкриття зміни 9 - Чек переходу в офлайн 10 - Чек виходу з офлайн 12 - Запит фіскальних номерів 14 - Видача готівки
safe_cash	Залишок готівки у касі
tag	Мітка завдання для ідентифікації
is_offline	Чи видано чек в офлайні

","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}},"urlObject":{"path":["api","v3","shift","checks"],"host":["https://kasa.vchasno.ua"],"query":[{"key":"shift_id","value":""}],"variable":[]}},"response":[{"id":"96de2224-f0eb-4958-92ba-d1b1b1fd5275","name":"Отримати чеки по зміні","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"VCHASNO_KASA_PRRO_TOKEN"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"https://kasa.vchasno.ua/api/v3/shift/checks?shift_id=0f878d90-1d33-94b3-52e1-4a1b522eb12b","host":["https://kasa.vchasno.ua"],"path":["api","v3","shift","checks"],"query":[{"key":"shift_id","value":"0f878d90-1d33-94b3-52e1-4a1b522eb12b"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"2535"},{"key":"Date","value":"Fri, 09 Feb 2024 14:40:21 GMT"},{"key":"Server","value":"Python/3.11 aiohttp/3.8.6"}],"cookie":[],"responseTime":null,"body":"{\n \"page_num\": 1,\n \"page_size\": 100,\n \"has_prev\": false,\n \"has_next\": false,\n \"items\": [\n {\n \"id\": \"0f878d94-cbb2-79a3-be3b-3afebe38aa12\",\n \"shift_id\": \"0f878d90-1d33-94b3-52e1-4a1b522eb12b\",\n \"local_number\": 6,\n \"fiscal_number\": \"TEST_BwA32_ONSQuY-g\",\n \"type\": \"z_report\",\n \"status\": 1,\n \"source\": 6,\n \"date_created\": \"2024-02-09T15:57:14.052979+02:00\",\n \"data_id\": 19,\n \"check_hash\": \"40a965329822e629305acc6d45092f785e581fe080b44a03a2e56c0aa921612f\",\n \"flow\": null,\n \"safe_cash\": 127700,\n \"tag\": \"78a513d91ed485c4d40c1494ce305a91\",\n \"is_offline\": false\n },\n {\n \"id\": \"0f878d93-8ac6-bae7-f2b8-5a6b45a339ca\",\n \"shift_id\": \"0f878d90-1d33-94b3-52e1-4a1b522eb12b\",\n \"local_number\": 2,\n \"fiscal_number\": \"TEST_p72E1ZvyYG7nWg\",\n \"type\": \"chk\",\n \"status\": 1,\n \"source\": 6,\n \"date_created\": \"2024-02-09T15:57:05.837365+02:00\",\n \"data_id\": 18,\n \"check_hash\": \"171c1fde6dd0e1c18fdeac1bc7853cf728bfb00fc06b15bad1d02d2902d912db\",\n \"flow\": 2,\n \"safe_cash\": null,\n \"tag\": \"8x2pdUWGzZAWrj6ECCiMm\",\n \"is_offline\": false\n },\n {\n \"id\": \"0f878d92-a070-d84a-4e38-70fc8e56bbbd\",\n \"shift_id\": \"0f878d90-1d33-94b3-52e1-4a1b522eb12b\",\n \"local_number\": 1,\n \"fiscal_number\": \"TEST_6dBu2HbHwwXlkg\",\n \"type\": \"chk\",\n \"status\": 1,\n \"source\": 6,\n \"date_created\": \"2024-02-09T15:56:59.838403+02:00\",\n \"data_id\": 17,\n \"check_hash\": \"2e71d9890a2f42732d276e42ff6f0f655245d08da88ba7f91177722f3b8dad0b\",\n \"flow\": 2,\n \"safe_cash\": null,\n \"tag\": \"OOFDZ1RQW2P9wPYE3WuTa\",\n \"is_offline\": false\n },\n {\n \"id\": \"0f878d91-94c8-71d1-2718-1fc6c2891dd0\",\n \"shift_id\": \"0f878d90-1d33-94b3-52e1-4a1b522eb12b\",\n \"local_number\": 2,\n \"fiscal_number\": \"TEST_3cN5dDgeeOOo4A\",\n \"type\": \"chk\",\n \"status\": 1,\n \"source\": 6,\n \"date_created\": \"2024-02-09T15:56:52.986339+02:00\",\n \"data_id\": 16,\n \"check_hash\": \"da41659c4044d14d89b7634a553c6c16981de58ab31189d5b76fd23fe6fa778c\",\n \"flow\": 0,\n \"safe_cash\": null,\n \"tag\": \"y5aLwUMX5OTenyBV0jM0w\",\n \"is_offline\": false\n },\n {\n \"id\": \"0f878d90-d072-605a-975f-5ef986d6e9b5\",\n \"shift_id\": \"0f878d90-1d33-94b3-52e1-4a1b522eb12b\",\n \"local_number\": 1,\n \"fiscal_number\": \"TEST_EixB0aXSylhhJw\",\n \"type\": \"chk\",\n \"status\": 1,\n \"source\": 6,\n \"date_created\": \"2024-02-09T15:56:47.960189+02:00\",\n \"data_id\": 15,\n \"check_hash\": \"f13025fe880c2c9c111540df49d8a8c074d13104d2630a593aaf9d437084fc18\",\n \"flow\": 0,\n \"safe_cash\": null,\n \"tag\": \"wX764EHfcV83mAcbuIVEr\",\n \"is_offline\": false\n },\n {\n \"id\": \"0f878d90-1d41-cef0-4f84-667b4f889154\",\n \"shift_id\": \"0f878d90-1d33-94b3-52e1-4a1b522eb12b\",\n \"local_number\": 0,\n \"fiscal_number\": \"TEST_nUgNU8xboXD9Jw\",\n \"type\": \"service\",\n \"status\": 1,\n \"source\": 6,\n \"date_created\": \"2024-02-09T15:56:43.371487+02:00\",\n \"data_id\": 14,\n \"check_hash\": \"67e9dd0df87c1353043fed0b679817ba0579493f4aa559d399c5b538a45ec0e1\",\n \"flow\": 8,\n \"safe_cash\": 10000,\n \"tag\": \"3627c284440d2b67a22ea580a75537bb\",\n \"is_offline\": false\n }\n ]\n}"}],"_postman_id":"1190b30e-6b1a-4768-9429-82f33e9ebcb5"},{"name":"Надіслати посилання чеку на email\\sms\\viber","event":[{"listen":"test","script":{"id":"d2ba1acb-3afb-4aa8-b1ec-5d45b3e9b266","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"0727b779-1594-461f-a940-60fb617a9f3f","exec":[""],"type":"text/javascript"}}],"id":"345b2641-383a-4b7f-8b1a-bffc9b682bb9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"recipient\": \"test@vchasno.ua\",\n \"channel\": \"email\",\n \"check\": \"TEST_oTzS71QVfYGwTw\"\n}","options":{"raw":{"language":"json"}}},"url":"https://kasa.vchasno.ua/api/v3/notifications/checks","description":"

Запит для надсилання посилання на чек користувачу через email, sms чи viber.

Структура запиту

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
recipient	string	email або номер телефону отримувача
channel	string	Канал відправки: - email - sms - viber - cascade (спробує надіслати через viber, якщо користувач не зареєстрований у viber - відправить sms)
check	string	Фіскальний номер чеку

Опис відповіді

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Type	Description
recipient	string	email або номер телефону отримувача
channel	string	Канал відправки: - email - sms - viber - cascade (спробує надіслати через viber, якщо користувач не зареєстрований у viber - відправить sms)
check_id	string	ID надісланого чеку

Приклади відправлених повідомлень

Текст sms:

Chek vid {COMPANY_NAME} za {CHECK_DATE}
https://kasa.vchasno.ua/c/{CHECK_FN}

Текст viber:

Ви отримали фіскальний чек від {COMPANY_NAME} https://kasa.vchasno.ua/c/

report_type приймає такі значення:

z_reports - З-звіти,
\n
- Фіскальні звітні чеки у вигляді таблиці (максимум 366 днів),
\n
z_reports_views - З-звіти (періодичні звіти),
\n
- Фіскальні звітні чеки (максимум 366 днів),
\n
z_reports_archive - Архів z-звітів.
\n
- Архів зі з-звітами (html) на кожну касу + \"zreports.csv\", що містить ФН каси, ФН звіту, дату звіту.
\n
checks - Звіт по продажах,
\n
- Всі продажі та повернення товарів (максимум 31 день, до 50 тис. чеків)
\n
checks_split_products - Звіт по чеках,
\n
- Чеки продажу та повернення (максимум 31 день, до 10 тис. чеків)
\n
checks_daily - Звіт про щоденні чеки
\n
- Чеки продажу та повернення згруповані по дням (максимум 31 день)
\n
checks_control_tape - Контрольна стрічка,
\n
- Основна інформація по чеках (максимум 31 день, до 300 тис. чеків)
\n
checks_archive - Контрольна стрічка + архів чеків,
\n
- Копії розрахункових документів (максимум 31 день, до 1 тис. чеків)
\n
z_reports_funds_circulation - Оборот компанії,
\n
- Сума всіх продажів компанії (максимум 366 днів)
\n
rros_offline_time - Лічильник offline
\n
- Кількість годин в режимі офлайн (максимум 366 днів)
\n

Повертає id сформованого звіту

id - ідентифікатор сформованого звіту

Опис відповіді

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Tag	Description
id	Ідентифікатор
status	Статус
type	Тип звіту
filename	Назва файлу
content	Дані у форматі base64

У відповіді на запит фіскалізації наявні поля, що відображають статус операції.

Поле res_action у якому система рекомендує наступні дії дотримання транзакційної цілісності. В першу чергу, слід звертати увагу на значення цього поля і в разі отримання значення 3 - дивитися додаткові поля з кодами/текстом помилок.
\n
Поле res - це код відповіді, що дорівнює 0 у разі успішного виконання запиту. У разі помилки поле містить код помилки.
\n
Поле errortxt містить текст помилки та може містити технічну інформацію, призначене більше для логування та подальших досліджень причин.
\n
Об'єкт error_extra: object | null - опційний обʼєкт, в якому повертаються деталі щодо помилки. Наприклад перелік полів, та причини, чому вони не пройшли валідацію.
\n

Приклад помилки при запиті на фіскалізацію (наведено виключно поля, що відповідають за помилку):

{\n    \"res\": 1001,\n    \"res_action\": 3,\n    \"errortxt\": \"Сума всіх позицій товару відрізняється від загальної суми чеку\",\n    \"error_extra\": {\n        \"sum\": 10050,\n        \"rows_sum\": 10000\n    }\n}\n\n

Перелік значень поля `res_action`

0 - ОК, можна переходити до наступного запиту
\n
1 - Помилка, запит не пройшов
Запит не виконано через “випадкові помилки” від податкової (ДПС). Рекомендується повторити запит, який не пройшов, але можна зробити й інший запит.
\n
2 - Помилка + колізія
Запит було надіслано до ДПС, але відповіді не було отримано. За будь-якого наступного звернення система спочатку намагатиметься виправити колізію. Тому настійно рекомендується робити повторення вихідного запиту до тих пір, поки колізію не буде вирішено.
\n
3 - Помилка, що вимагає зупинки та ручного втручання
Виникла помилка, яка може не виправитись шляхом повтору запиту.
Необхідно дослідити res, errortxt, error_extra, котрі містять деталі помилки.
\n

Повторні запити слід надсилати з параметром tag рівним початковому запиту/відповіді.

Перелік значень поля `res`

Код	Опис
1001	Помилка валідації вхідних даних
1006	Внутрішня помилка сервісу Вчасно.Каса
1011	Об'єкт не знайдено у базі
1013	Для вхідних даних не реалізовано функціонал (Not Implemented Error)
1014	Об'єкт вже існує у базі
1015	Каса зайнята попереднім запитом (Lock Error)
1016	Перевищено таймаут на обробку запиту
1017	Дію заборонено (Action not allowed error)
1019	Ключ ЕЦП не зареєстровано у ДПС
1020	Каса не активна (скасована) у ДПС
1029	Помилка повʼязана з підписами чи ключами ЕЦП
1062	Ключ ЕЦП скасовано у АЦСК
2000	Базова помилка. Може бути пов'язана з різними причинами (дивитися значення поля “errortxt”)
2001	Помилка зв'язку з ДПС
2002	Запит у ДПС перевищив допустимий таймаут
2003	Отримано код відповіді від ДПС, який вважається \"випадковою помилкою\"
2004	Отримано код критичної помилки під час роботи з ДПС, запит не може бути виконаний (точніший опис причини дивитись у полі “errortxt”)
2005	Каса (ПРРО) у стані колізії
2006	Помилка під час перевірки хешу чеку
2007	Необхідно відкрити зміну
2008	Необхідно закрити зміну
2009	ПРРО заблоковано
2011	Помилка при спробі змінити режим роботи каси
2012	Не можна виконати дію, оскільки останній чек було проведено з Девайс Менеджеру. Для проведення чеків з іншого джерела потрібно закрити зміну у Девайс Менеджері.

HTTP статус коди

АПІ запити на фіскалізацію (POST /api/v3/fiscal/execute) повертають 200 OK HTTP статус також при клієнтських помилках (деталі по помилці у тілі відповіді).

Виключення:

401 - Помилка при авторизації, потрібно перевірити авторизаційний токен каси
\n
5** - Непередбачена помилка на стороні сервісу, потрібно повторити запит пізніше.
\n

\n","_postman_id":"0501cdba-90c2-4cce-99e8-8910f7925b54","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]},"isInherited":true,"source":{"_postman_id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","id":"2a77b85d-8a4d-41ce-a984-a51d3f46d84b","name":"Вчасно.Каса Public Fiscal API","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"VCHASNO_KASA_PRRO_TOKEN"}]}},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"0bf2852d-a15e-47e4-abb5-2284f5f18cca"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"b1ebbc97-4739-4868-a1d6-57f976962b02"}}],"variable":[{"id":"9ca296ff-9f71-475d-8623-09a16ad925e4","key":"host","value":"https://kasa.vchasno.ua"},{"id":"d7a2b0f9-5303-4db8-a10d-c183f3855609","key":"prro_token","value":"VCHASNO_KASA_PRRO_TOKEN"}]}

Changelog

Загальні вимоги

Опис відповіді

Опис відповіді

Опис відповіді

Структура об'єкту info для завдання відкриття зміни

Опис відповіді

Опис відповіді

Додаткові параметри для створення чеку передплати

Додаткові параметри для створення чеку післяплати

Опис відповіді

Валідація:

Додаткові поля об'єкту fiscal.receipt для чеку переказу коштів:

Додаткові поля об'єкту fiscal.receipt.rows для чеку переказу коштів:

Опис відповіді

Додаткові поля об'єкту fiscal.receipt для чеку видачі коштів при переказі:

Додаткові поля об'єкту fiscal.receipt.rows для чеку видачі коштів при переказі:

Опис відповіді

Опис відповіді

Опис відповіді

Опис відповіді

Структура об'єкту info для завдань 10, 11 (X\\Z-звіт)

Структура об'єктів масиву info.taxes (підсумки по податкам)

Структура об'єктів info.pays/money (підсумки по видам оплат, службовим внесенням/видачам)

Структура об'єктів info.сash (підсумки по операціям видачі готівки)

Структура об'єкту info.receipt (підсумки по кількості чеків)

Структура об'єкту info.summary (загальні підсумки)

Структура об'єкту info.money_transfer

Структура об'єкту info.lastcheck (Об'єкт із даними про останній фіскальний чек в зміні)

Опис відповіді

Структура запиту

Структура об'єкту fiscal (реквізити фіскального завдання)

Структура об'єкту fiscal.receipt (поля чеку)

Структура об'єкту fiscal.receipt.rows (рядки чеку)

Структура об'єкту fiscal.receipt.pays (Оплати чеку (по видам))

Структура об'єкту fiscal.receipt.discounts (Список загальних знижок)

Структура об'єкту fiscal.cash (Поля внесення/видачі, чеку видачі готівки, чеку видачі коштів при переказі)

Структура відповіді

Опис відповіді

Структура об'єкту info для завдання 18 (статус пРРО)

Опис відповіді

Опис полів:

Об'єкт data

Об'єкт data:cash - в чеці видачі готівки

Об'єкт data:items

Об'єкт data:items::markup/discount

Об'єкт data:close

Об'єкт data:pays

Об'єкт data:taxes

Об'єкт data:service_move_data

Об'єкт data:global_discounts

Опис відповіді об'єкту items

Опис відповіді об'єкту items

Структура запиту

Опис відповіді

Приклади відправлених повідомлень

Опис відповіді

Перелік значень поля res_action

Перелік значень поля res

HTTP статус коди

Перелік значень поля `res_action`

Перелік значень поля `res`