Подготовка, отмена или обновление параметров автовизита

PUT /api/truck-visits/{id}

Назначение

Метод позволяет обновить параметры автовизита, включая:

• Плановый интервал прибытия

• Регистрационный номер грузовика

• Паспортные данные и контакты водителя

• Статус заявки

Параметры запроса

Пример запроса:

{
  "status": "CANCELED",
  "plannedVisitPeriod": {
    "start": "2025-07-16T10:18:25.748Z",
    "end": "2025-07-16T11:18:25.748Z"
  },
  "regNumber": "X123XX77",
  "driverInfo": {
    "fullName": "Иванов Иван Иванович",
    "passport": {
      "series": "1234",
      "number": "567890",
      "issued": "2018-04-15"
    },
    "phoneNumber": "+79998887766",
    "needSmsNotification": true
  }
}

Описание полей запроса

Успешный ответ

200 OK

{
  "id": 3456,
  "sessionId": 1234,
  "status": "CANCELED",
  "type": "INCOMING",
  "issuanceType": "LOCAL",
  "load": "FULL",
  "release": "REL-45678",
  "container": {
    "name": "MSCU1234567",
    "specification": {
      "id": 2,
      "code": "22G1",
      "description": "20 футов — универсальный"
    }
  },
  "timeslot": {
    "from": "2025-07-16T10:18:25.755Z",
    "to": "2025-07-16T11:18:25.755Z"
  }
}

Ошибки

400 Bad Request — Неверные входные данные

{
  "requestId": "abc123",
  "timestamp": "2025-07-16T10:18:25.756Z",
  "status": 400,
  "message": "Ошибка валидации",
  "url": "/api/truck-visits/3456",
  "fieldErrors": [
    "regNumber must be a valid vehicle plate",
    "passport.number is required"
  ]
}

Причины:

• Пропущены обязательные поля

• Неверный формат даты или номера паспорта

• Некорректный номер авто

404 Not Found — Заявка не найдена

{
  "requestId": "def456",
  "timestamp": "2025-07-16T10:18:25.756Z",
  "status": 404,
  "message": "Заявка с указанным ID не найдена",
  "url": "/api/truck-visits/9999",
  "fieldErrors": []
}