ФЛК и ошибки
Перед отправкой результата модуль проверяет тело запроса по чек-листу спецификации (п. 2.3.2). При нарушениях сеть не вызывается.
Тело результата (InformResultRequest)
| Поле | Назначение |
|---|---|
taskId | Обязателен для пакетного метода |
isSmoId | UUID 36 символов с дефисами (если указан) |
resultCode | Код результата (А.7), значения "1"…"4" |
reactionCode | Код реакции (А.8), когда требуется |
communicationMethodCode | Способ связи (А.9) |
comment | Комментарий, не более 500 символов |
Для единичного POST идентификатор задачи передаётся в URL; поле
taskId в теле не отправляется.
Чек-лист локальной валидации
| Условие | Правило | message |
|---|---|---|
isSmoId |
Если непустое — UUID стандартного вида | INVALID_REQUEST_PARAMETER |
resultCode |
Всегда; значения "1"–"4" |
RESULT_REQUIRED / INVALID_REQUEST_PARAMETER |
comment |
Обязателен при resultCode = "2" или "3" |
COMMENT_REQUIRED |
communicationMethodCode |
Обязателен при результате "1", "2" или "3" |
COMMUNICATION_METHOD_CODE_REQUIRED |
reactionCode |
Обязателен, если результат "1" и способ связи "1" или "6" |
REACTION_CODE_REQUIRED |
reactionCode |
Не указывать, если условие выше не выполняется | REACTION_MUST_NOT_BE_FILLED_IN |
taskId |
Только для пакетного метода | INVALID_REQUEST_PARAMETER |
| Пакет | ≤ 25 результатов | EXCEEDED_LIMIT_OF_RECORDS_IN_REQUEST |
comment |
≤ 500 символов | MAX_LENGHT_EXCEED |
Уникальность
isSmoId и существование задачи проверяются только на стороне ГИС
(IS_SMO_ID_RESULT_EXISTS, TASK_NOT_FOUND).
Ответ пакетной отправки
- Непустой
resultsи пустойitems— успех всего пакета - Заполненный
items— отказ всего пакета (ничего не сохранено) - Решение принимается по содержимому тела ответа, а не только по HTTP-коду
Коды ошибок валидации (для отображения)
| message | localizedMessage |
|---|---|
INVALID_REQUEST_PARAMETER | Ошибка входных параметров запроса |
TASK_NOT_FOUND | Задача не найдена |
MAX_LENGHT_EXCEED | Превышено максимально количество символов (500) |
COMMUNICATION_METHOD_CODE_REQUIRED | Не указан обязательный Способ связи |
REACTION_CODE_REQUIRED | Не указан обязательный Код реакции |
COMMENT_REQUIRED | Не указан обязательный параметр Комментарий |
REACTION_MUST_NOT_BE_FILLED_IN | Реакцию не требуется указывать |
EXCEEDED_LIMIT_OF_RECORDS_IN_REQUEST | Превышен лимит записей |
RESULT_REQUIRED | Не заполнено обязательное поле Результат задачи |
IS_SMO_ID_RESULT_EXISTS | Результат с указанным isSmoId существует |
INTERNAL_ERROR | Внутренняя ошибка |
В ответах ГИС возможны варианты написания кодов. Модуль сохраняет
message строкой «как есть» — не жёсткий enum.