Public
Documentation Settings

Вчасно.Каса Public Fiscal API

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

Changelog

DateVersionChangesAuthor
04.08.20221.0Initial versionАнтон Биковець
07.09.20221.1Внесено інформацію про автоматичне відкриття зміни разом із проведенням першого чеку (Запити на фіскалізацію -> Відкриття зміни)Антон Биковець
16.03.20231.2Додано підтримку чеку видачі готівки (task 14)Антон Биковець
18.07.20231.3Додано перегляд фіскалізованого JSON чекуЄвгеній Співак
18.09.20231.4Розширення виводу ЕПЗ данихЄвгеній Співак
31.01.20241.5Оновлено документацію. Додано опис error_extra. Прибрано fiscal.receipt.pays.currency (параметр не оброблювався)Євгеній Співак
15.02.20241.6Розширено формати поля userinfo: phone
Запит на отримання JSON чеку повертає
shop_type
Євгеній Співак
23.02.20241.7Додано службові запити: Отримати зміни по касі, Отримати чеки по змініЄвгеній Співак
19.04.20241.8Додано чеки передплати, післясплати.
Додано запити створення / вивантаження звітів
Євгеній Співак
03.09.20241.9Додано нові параметри purchase_receipt_fisn та purchase_rro_fisn в об'єкт fiscal.receipt для чеків повернення по программі "Національний кешбек"Євгеній Співак
23.09.20241.10Додано підтримку загальної знижки на чек. Параметри disc та disc_type в об'єкт fiscal.receiptЄвгеній Співак
14.11.20241.11Додано параметр bank_name в об'єкт fiscal.receipt.pays
Додано mac параметр у відповідь фіскалізації чеків
Євгеній Співак
10.12.20241.12Додано нові параметри purchase_dt в обʼєкт fiscal.receipt.pays та
purchase_receipt_dt в об'єкт fiscal.receipt.rows по программі "Національний кешбек"
Євгеній Співак
03.03.20251.13Додані нові види оплатЄвгеній Співак
20.03.20251.14Додано підтримку: чек переказу коштів task 15, чек видачі коштів при переказі task 16Євгеній Співак

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

HOST - kasa.vchasno.ua

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

  • Content-Type: application/json

  • Authorization: <токен_каси>

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

Для фіскалізації чеків необхідно додати ключ у сховище ключів. Зробити це можна у веб-кабінеті, вкладка "Ключі".

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

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