Коды ошибок
Справочник кодов ошибок API по категориям
Коды ошибок
Ошибки группируются по префиксу:
| Префикс | Категория | Описание |
|---|---|---|
E-xxx |
EPOS | Бизнес-логика, валидация |
F-xxx |
Fiscal | Фискальный модуль |
S-xxx |
Server | API-сервер |
T-xxx |
Transport | ОФД / сеть |
Формат ошибки
{
"success": false,
"error": {
"code": "F-002",
"message": "Z-отчёт не открыт. Откройте смену перед продажей"
}
}E — EPOS (бизнес-логика и валидация)
| Код | Правило | Описание |
|---|---|---|
E-001 |
CASHDESK_NOT_ACTIVATED |
Касса не активирована |
E-002 |
SUBSCRIPTION_EXPIRED |
Подписка истекла |
E-003 |
ITEM_CASH_FORBIDDEN_CASH_SALE_ZERO |
Оплата наличными запрещена для данного товара |
E-004 |
ITEM_LABELS_REQUIRED_FOR_LABELED |
Товар подлежит маркировке, коды маркировки не указаны |
E-005 |
RECEIPT_TYPE_INVALID |
Неверный тип чека. Допустимо: sale, refund, advance, credit |
E-006 |
RECEIPT_ITEMS_EMPTY |
Пустой список товаров |
E-007 |
RECEIPT_REFUND_INFO_REQUIRED |
refundInfo обязателен для чека возврата |
E-008 |
RECEIPT_SUM_NEGATIVE |
Сумма оплаты не может быть отрицательной |
E-009 |
RECEIPT_SUM_EXCEEDS_TOTAL |
Сумма оплаты превышает сумму по позициям |
E-010 |
RECEIPT_TOTAL_VAT_MISMATCH |
totalVAT не совпадает с суммой vat по позициям |
E-011 |
ITEM_NAME_EMPTY |
Наименование товара не может быть пустым |
E-012 |
ITEM_PRICE_INVALID |
Цена товара должна быть больше нуля |
E-013 |
ITEM_SPIC_NOT_IN_TASNIF |
Код ИКПУ не найден в справочнике Tasnif |
E-014 |
ITEM_PACKAGE_CODE_NOT_IN_TASNIF |
Код упаковки не найден в packages ИКПУ |
E-015 |
ITEM_VAT_PERCENT_INVALID |
Допустимые значения НДС: 0% или 12% |
E-016 |
ITEM_VAT_AMOUNT_INVALID |
Сумма НДС не соответствует расчёту (price × 12 / 112) |
E-017 |
ITEM_LABELS_COUNT_MISMATCH |
Количество маркировок не совпадает с количеством товара |
E-018 |
ITEM_AMOUNT_BELOW_MIN_FOR_LABELED |
Маркируемый товар: минимальное количество — 1 штука |
F — Fiscal (фискальный модуль)
| Код | Правило | Описание |
|---|---|---|
F-001 |
FM_NOT_INITIALIZED |
Фискальный модуль не инициализирован |
F-002 |
ZREPORT_NOT_OPEN |
Z-отчёт не открыт. Откройте смену |
F-003 |
RECEIPT_STORE_DAYS_LIMIT |
Превышен срок хранения чеков (48ч). Отправьте в ОФД |
F-005 |
FM_CONNECTION_ERROR |
Ошибка связи с фискальным модулем |
S — Server (API-сервер)
| Код | Правило | Описание |
|---|---|---|
S-001 |
INVALID_API_KEY |
Неверный API-ключ |
S-002 |
ENDPOINT_NOT_FOUND |
Endpoint не найден |
S-003 |
BODY_REQUIRED |
Тело запроса обязательно |
S-004 |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
T — Transport (ОФД / сеть)
| Код | Правило | Описание |
|---|---|---|
T-001 |
OFD_ALL_SERVERS_FAILED |
Все серверы ОФД недоступны |
T-003 |
OFD_TIMEOUT |
Таймаут соединения с ОФД |
Справочник эндпоинтов
| Метод | Endpoint | Описание |
|---|---|---|
GET |
/status |
Статус сервера и ФМ |
GET |
/fm/info |
Информация о фискальном модуле |
GET |
/business |
Данные бизнеса |
GET |
/branch |
Данные филиала |
POST |
/receipts |
Пробить чек (sale/refund/advance/credit) |
POST |
/receipts/send-unsent |
Отправить неотправленные чеки в ОФД |
GET |
/receipts/unsent-count |
Количество неотправленных чеков |
POST |
/z-report/open |
Открыть смену (Z-отчёт) |
POST |
/z-report/close |
Закрыть смену + отправить Z-отчёт |
GET |
/z-report/current |
Текущий Z-отчёт |
GET |
/z-report/stats |
Статистика Z-отчётов |
POST |
/z-report/send-unsent |
Отправить неотправленные Z-отчёты |