Ошибки контракта адаптеров
При ok: false поле result содержит ошибку адаптера. Её код — строка, в отличие от числовых кодов входящего API REGOS: VCR.
Структура result при ok=false
| Название | Тип данных | Обязательность | Описание |
|---|---|---|---|
| error | string | Обязательный | Код из таблицы ниже |
| description | string | Обязательный | Описание причины ошибки |
| retryable | boolean | Обязательный | Признак временной ошибки: запрос можно повторить после задержки |
| retry_after | int32 | Необязательный | От 1 до 300 секунд; только при retryable=true |
Пример ответа
{
"jsonrpc": "2.0",
"id": "request-005",
"ok": false,
"result": {
"error": "RETRY_LATER",
"description": "Источник временно недоступен. Повторите обмен позже.",
"retryable": true,
"retry_after": 30
}
}
| error | retryable | Действие клиента |
|---|---|---|
| UNAUTHORIZED | false | Проверить ключ и доступ подключения |
| UNSUPPORTED_VERSION | false | Проверить совместимость версий |
| METHOD_NOT_FOUND | false | Проверить имя метода и совместимость версий |
| INVALID_PARAMS | false | Исправить параметры запроса |
| CASH_REGISTER_NOT_FOUND | false | Проверить привязку внешней кассы |
| CURSOR_EXPIRED | false | Начать полную загрузку каталога без cursor |
| NOT_SUPPORTED | false | Метод поиска не поддерживается; перейти к ручному заполнению возврата |
| QUERY_TOO_BROAD | false | Уточнить поиск чека или заполнить возврат вручную |
| IDEMPOTENCY_CONFLICT | false | Восстановить первоначальное содержимое документа; не менять его ID |
| RETRY_LATER | true | Повторить тот же запрос после задержки |
| PERMANENT_ERROR | false | Устранить указанную причину и повторить запрос |
Ошибка или таймаут не подтверждают сохранение документа. Для Event.Accept повторяйте исходное событие с прежним ID и содержимым. Неизвестный код ошибки также не считается успехом.