PUT /defects/{defectId}

Метод позволяет отредактировать замечание.

Переменные

Название Тип Формат Обязательность Описание
defectId string Guid true Идентификатор замечания

Заголовки

Название Описание
Content-Type application/json
Authorization Заголовок авторизации

Тело запроса

В теле можно указать статус замечания, исполнителя, прикладываемые документы с описанием, дату устранения замечания. Указывать одновременно и статус, и исполнителя нельзя.

Название Тип Формат Обязательность Описание
form object Form false Прикладываемые документы с описанием
eliminationDate date [YYYY-MM-DD] false Дата устранения замечания
executorId string Guid false Идентификатор исполнителя. Исполнителем может быть подрядчик либо сотрудник застройщика
status string Status false Статус замечания

Status

Допустимые значения:

  • PROCESSING - в работе
  • VALIDATING - требует согласования
  • ACCEPTED - исправлено
  • REJECTED - ожидает повторного устранения. Для этого статуса в запросе необходимо передать eliminationDate

Статус CREATED можно получить при создании замечания по результатам встречи - автоматически, либо передать тело запроса с пустым полем executorId. Замечание переходит в статус APPOINTED автоматически, если в поле executorId передать идентификатор исполнителя.

Если при редактировании замечания не передать form и eliminationDate или передать их пустыми, то поля затрутся в замечании и станут пустыми.

Form

Название Тип Формат Обязательность Описание
text string ^\w{1,1000}$ true Комментарий
documents array Documents true Прикладываемые документы

Documents

Название Тип Формат Обязательность Описание
content object Content true Описание бинарных данных документа
text string ^\w{1,1000}$ false Комментарий к прикладываемому документу

Пример

Изменение замечания

  PUT /realty/web/inspection-api/v1/defects/ca157d46-d61d-11ee-b195-5d166c3e1389
  Authorization: ReestroAuth apiKey=1269f58a-3d40-42e1-91ad-a4251566419c&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c
  Content-Type: application/json
{
    "status": "ACCEPTED",
    "eliminationDate": "2023-04-08",
    "form": {
        "text": "Всё исправлено",
        "documents": []
    }
}

Ответы

200

Тело ответа

Замечание успешно изменено. В теле ответа содержится описание замечания defect.

Пример ответа

  HTTP 200
  Content-Type: Application/json
{
    "id": "ca157d46-d61d-11ee-b195-5d166c3e1389",
    "constructionId": "f2ffc5b8-d60e-11ee-9fbe-9543aebcb7ce",
    "roomId": "01015682-d52e-11ed-8818-b5068d25e3c2",
    "eliminationDate": {
        "scheduled": "2023-04-08",
        "actual": "2024-03-05"
    },
    "executor": {
        "id": "378e223c-4191-11ee-b89e-5d3f18f7983e",
        "type": "EMPLOYEE"
    },
    "status": "ACCEPTED",
    "form": {
        "text": "Всё исправлено",
        "documents": []
    }
}

400

Ошибки валидации запроса.

401

Ошибка авторизации: пользователь не авторизован.

403

Ошибка аутентификации: пользователь не имеет доступа к ресурсам организации, которая указана в заголовке авторизации.

404

Замечание с указанным идентификатором не найден.

415

В заголовке Content-Type указан тип контента, который не поддерживается для данного метода.