Ошибки
Каталог ошибок для создания заявки на досрочное расторжение договора
Общий формат ошибки REST
{
"errorCode": "VALIDATION_ERROR",
"message": "Некорректно заполнены параметры запроса.",
"correlationId": "3e4b5a27-8888-4e9a-9111-926b97e2d123",
"details": [
{
"field": "desiredTerminationDate",
"reason": "Date must not be earlier than current date"
}
]
}Поля ошибки
| Поле | Тип | Обязательность | Описание |
|---|---|---|---|
errorCode | string | Да | Код ошибки |
message | string | Да | Пользовательское или техническое описание ошибки |
correlationId | string UUID | Да | Идентификатор трассировки |
details | array | Нет | Детализация ошибки |
details.field | string | Нет | Поле, по которому возникла ошибка |
details.reason | string | Нет | Причина ошибки |
Каталог ошибок
| errorCode | HTTP status | Описание | Текст для пользователя |
|---|---|---|---|
VALIDATION_ERROR | 400 | Некорректный формат запроса | Проверьте корректность заполнения полей |
UNAUTHORIZED | 401 | Пользователь не авторизован | Для выполнения операции необходимо войти в систему |
ACCESS_DENIED | 403 | Договор не принадлежит пользователю | У вас нет доступа к выбранному договору |
CONTRACT_NOT_FOUND | 404 | Договор не найден | Договор не найден |
ACTIVE_REQUEST_ALREADY_EXISTS | 409 | По договору уже есть активная заявка | По договору уже создана активная заявка на расторжение |
CONTRACT_NOT_ACTIVE | 422 | Договор не активен | Расторжение доступно только для активных договоров |
INVALID_TERMINATION_DATE | 422 | Некорректная желаемая дата расторжения | Желаемая дата расторжения не может быть раньше текущей даты |
INVALID_BANK_DETAILS | 422 | Некорректные банковские реквизиты | Проверьте банковские реквизиты |
DOCUMENT_NOT_FOUND | 422 | Документ не найден | Один или несколько документов не найдены |
DOCUMENT_LIMIT_EXCEEDED | 422 | Превышен лимит документов | Можно приложить не более 10 документов |
DOCUMENT_SIZE_EXCEEDED | 422 | Превышен размер документа | Размер одного документа не должен превышать 10 МБ |
DOCUMENT_TYPE_NOT_ALLOWED | 422 | Недопустимый формат документа | Допустимые форматы документов: PDF, JPG, JPEG, PNG |
SERVICE_UNAVAILABLE | 503 | Backend-сервис недоступен | Сервис временно недоступен. Попробуйте позже |
INTERNAL_ERROR | 500 | Непредвиденная ошибка | Произошла ошибка. Попробуйте позже |
Правила отображения ошибок на Frontend
| Тип ошибки | Поведение UI |
|---|---|
| Ошибка поля | Подсветить поле и показать текст рядом с ним |
| Ошибка бизнес-правила | Показать alert над формой |
| Ошибка доступа | Показать экран или alert с запретом доступа |
| Ошибка недоступности сервиса | Показать toast/alert с предложением повторить позже |
| Внутренняя ошибка | Показать общий текст ошибки и correlationId |