Общая информация
Онлайн-касса состоит из двух частей:
– веб-интерфейс - для работы вручную через браузер;
– API - для интеграции с вашей системой.
Базовые адреса API
https://api.fiscalv3.tech24.kz— тестовая среда APIhttps://fiscal2.kassa24.kz— боевая среда API
Адреса веб-интерфейса
https://cabinet.fiscalv3.tech24.kz— тестовая среда, для ручной проверки и отладкиhttps://fiscal.kassa24.kz— боевая среда, основной интерфейс для работы кассира/оператора
⚠️ Важно:
Для запросов к API используйте только те адреса, что указаны в разделе “Базовые адреса API”,
иначе вы получите HTML-страницу вместо JSON-ответа.
Описание системы
Онлайн-касса — программа для учета расчетов и их контроля в магазине, контрольно-кассовая система и фискальный регистратор с функцией передачи данных в ОФД.
Программа Онлайн-касса предназначена для ведения бухгалтерского учета без использования стационарного кассового аппарата в режиме онлайн, автоматизации работы касс в соответствии с бизнес-процессами предприятия (ввод и хранение данных, сортировка информации, обработка путем редактирования, добавления и удаления, составление отчетов).
Алгоритм работы программы:
- Пользователь авторизуется по логину и паролю, используя эндпоинт авторизации и получает токен (токен действителен 24 часа; по истечении 24-х часов нужно авторизоваться заново).
- Пользователь получает информацию о кассе (кассах).
- Пользователь получает список секции выбранной кассы.
- Пользователь получает список видов деятельности.
- Пользователь открывает смену на выбранной кассе. При открытии смены в заголовке придет UID (см. Идемпотентность и последовательность запросов на создание чековых операций).
- Пользователь совершает кассовые операции: продажи, приходы, расходы, покупки, возврата продажи и возврата покупки. При совершении кассовых операций в заголовке нужно посылать UID.
- Пользователь дожидается ответа на запрос кассовой операции, в ответе получает фискальный признак, актуальный баланс кассы, фискальный чек в формате png Base64 и новый UID в заголовке ответа, который потребуется для совершения следующей фискальной операции.
- Пользователь запрашивает Х-отчет, чтобы получить текущие данные о кассовых операциях без закрытия смены.
- В конце рабочего дня пользователь закрывает смену посылая UID в заголовке, получает Z-отчет. Смена не может быть открыта более 24 часов.