Общая информация
Примечание!
Для работы программы Онлайн-касса используются следующие базовые домены:
- https://api.fiscalv2.test.tech24.kz — для тестовой среды;
- https://fiscal2.kassa24.kz — для боевой среды.
В данной статье содержится информация о работе API программы Онлайн-касса.
Онлайн-касса — программа для учета расчетов и их контроля в магазине, контрольно-кассовая система и фискальный регистратор с функцией передачи данных в ОФД.
Программа Онлайн-касса предназначена для ведения бухгалтерского учета без использования стационарного кассового аппарата в режиме онлайн, автоматизации работы касс в соответствии с бизнес-процессами предприятия (ввод и хранение данных, сортировка информации, обработка путем редактирования, добавления и удаления, составление отчетов).
Алгоритм работы программы:
- Пользователь авторизуется по логину и паролю, используя эндпоинт авторизации и получает токен (токен действителен 24 часа; по истечении 24-х часов нужно авторизоваться заново).
- Пользователь получает информацию о кассе (кассах).
- Пользователь получает список секции выбранной кассы.
- Пользователь получает список видов деятельности.
- Пользователь открывает смену на выбранной кассе. При открытии смены в заголовке придет UID (см. Идемпотентность и последовательность запросов на создание чековых операций).
- Пользователь совершает кассовые операции: продажи, приходы, расходы, покупки и возврата товара. При совершении кассовых операций в заголовке нужно посылать UID.
- Пользователь дожидается ответа на запрос кассовой операции, в ответе получает фискальный признак, актуальный баланс кассы, фискальный чек в формате png Base64 и новый UID в заголовке ответа, который потребуется для совершения следующей фискальной операции.
- В конце рабочего дня пользователь закрывает смену посылая UID в заголовке, получает Z-отчет. Смена не может быть открыта более 24 часов.