Введение
Обзор
EPOS Mobile Local Fiscal API — HTTP API-мост между вашим приложением и фискальным модулем. Один вызов — полный процесс: от пробития чека до отправки данных в ОФД.
Базовый URL
http://localhost:8765
API работает локально на устройстве, где установлено приложение EPOS Mobile.
Как получить токен авторизации
- Откройте приложение EPOS Mobile
- Активируйте кассу
- Авторизуйтесь
- Перейдите в Профиль → Локальный сервер
На открывшемся экране вы увидите статус сервера, адрес и токен доступа.
Скопируйте токен и используйте его в заголовке X-API-Key каждого запроса:
X-API-Key: <ваш токен>
Важно: данные хранятся в БД EPOS Mobile. Нельзя удалять кэш и данные приложения — это приведёт к потере фискальных данных.
Заголовки подписки
Каждый ответ (кроме /status) содержит информацию о состоянии подписки:
X-Subscription-Expires-At: 2026-04-12T00:00:00Z
X-Subscription-Days-Left: 7
X-Subscription-State: active | expiring | expired
X-Subscription-Warning: true
| Состояние | Описание |
|---|---|
active |
Подписка активна |
expiring |
Подписка скоро истекает (содержит X-Subscription-Warning: true) |
expired |
Подписка истекла, запросы могут быть ограничены |
Суммы
Все суммы в тийинах (1 сум = 100 тийин).
Пример: 50 000 сум = 5000000 тийин.
Количество (amount)
amount = количество × 1000.
Примеры: 2 штуки = 2000, 0.5 кг = 500.
Полный процесс работы
1. GET /status → проверить готовность
2. POST /z-report/open → открыть смену
3. POST /receipts → пробить чек(и)
4. POST /z-report/close → закрыть смену
5. POST /receipts/send-unsent → если были ошибки ОФД
6. POST /z-report/send-unsent → если Z-отчёт не отправился