# Автопарк и водители

### Методы для работы с автопарком

<a id="get-v1.2-catalogs-trucks"></a>

**Версия: OAuth2.0 v1**

Получение транспортных средств пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/trucks' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "truck_info_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "ownership_type": {},
    "type": {},
    "car_type_id": 0,
    "description": "string",
    "brand_id": 0,
    "model": "string",
    "number": "string",
    "capacity": 0.5,
    "volume": 0.5,
    "length": 0.5,
    "width": 0.5,
    "height": 0.5,
    "last_deal_related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "manufacture_year": 0,
    "hidden_in_firm_info": false,
    "vin": "string",
    "vrc": "string",
    "body_number": "string",
    "dimension": 0,
    "truck_passport_number": "string",
    "can_refrigerator": false,
    "has_gen_set": false,
    "truck_owner_name": "string",
    "can_carry_heavy_container": false,
    "can_carry_tall_container": false,
    "external_id": "string",
    "scans": [
      {
        "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
        "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "scan_file_id": "string",
        "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
        "scan_name": "ВУ.pdf",
        "scan_type": 0
      }
    ],
    "photos": [
      {
        "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "file_id": "string",
        "path": "string",
        "name": "string"
      }
    ],
    "sensors": [
      {
        "sensor_id": 0,
        "sensor_name": "string",
        "provider_id": 0,
        "provider_sensor_id": "string",
        "is_active": false,
        "unactivate_date": "1970-01-01T00:00:00.000Z",
        "host": {
          "sensor_host_id": 0,
          "url": "string"
        }
      }
    ]
  }
]
```

**Описание полей ответа**
- `[].truck_info_id` — Id транспортного средства
- `[].related_id` — Id связанного транспортного средства
- `[].ownership_type` — Тип владения ТС * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `[].type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `[].car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `[].description` — Короткое описание
- `[].brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `[].model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `[].number` — Госномер
- `[].capacity` — Грузоподъемность
- `[].volume` — Объем
- `[].length` — Длина
- `[].width` — Ширина
- `[].height` — Высота
- `[].last_deal_related_id` — Id связанного во время последней сделки транспортного средства
- `[].manufacture_year` — Год выпуска
- `[].hidden_in_firm_info` — Не отображать в карточке фирмы
- `[].vin` — VIN
- `[].vrc` — СТС
- `[].body_number` — Номер кузова
- `[].dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `[].truck_passport_number` — Номер ПТС
- `[].can_refrigerator` — Способность возить реф-контейнеры
- `[].has_gen_set` — Есть GenSet
- `[].truck_owner_name` — Имя владельца по СТС
- `[].can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `[].can_carry_tall_container` — Способность перевозить высокие контейнеры
- `[].external_id` — Идентификатор
- `[].scans` — Сканы документов ТС
- `[].scans[].scan_id` — Id скана
- `[].scans[].scan_path` — Адрес расположения файла скана в хранилище
- `[].scans[].scan_name` — Имя файла скана
- `[].scans[].scan_type` — Тип документа * `3` — Скан ПТС * `4` — Скан пластикового ПТС * `6` — Скан договора аренеды * `7` — Скан свидетельства о браке * `8` — Скан договора безвозмездного пользования
- `[].photos` — Фото ТС
- `[].photos[].id` — Id фото
- `[].photos[].path` — Адрес расположения файла в хранилище
- `[].photos[].name` — Имя файла
- `[].sensors` — Датчики мониторинга транспорта
- `[].sensors[].sensor_id` — Идентификатор датчика
- `[].sensors[].sensor_name` — Наименование датчика
- `[].sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `[].sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `[].sensors[].is_active` — Статус активности датчика
- `[].sensors[].unactivate_date` — Дата окончания действия датчика
- `[].sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `[].sensors[].host.sensor_host_id` — Идентификатор сервера
- `[].sensors[].host.url` — Адрес сервера

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-trucks"></a>

**Версия: OAuth2.0 v2**

Получение транспортных средств пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/trucks' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "truck_info_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "ownership_type": {},
    "type": {},
    "car_type_id": 0,
    "description": "string",
    "brand_id": 0,
    "model": "string",
    "number": "string",
    "capacity": 0.5,
    "volume": 0.5,
    "length": 0.5,
    "width": 0.5,
    "height": 0.5,
    "last_deal_related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "manufacture_year": 0,
    "hidden_in_firm_info": false,
    "vin": "string",
    "vrc": "string",
    "body_number": "string",
    "dimension": 0,
    "truck_passport_number": "string",
    "can_refrigerator": false,
    "has_gen_set": false,
    "truck_owner_name": "string",
    "can_carry_heavy_container": false,
    "can_carry_tall_container": false,
    "external_id": "string",
    "scans": [
      {
        "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
        "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "scan_file_id": "string",
        "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
        "scan_name": "ВУ.pdf",
        "scan_type": 0
      }
    ],
    "photos": [
      {
        "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "file_id": "string",
        "path": "string",
        "name": "string"
      }
    ],
    "sensors": [
      {
        "sensor_id": 0,
        "sensor_name": "string",
        "provider_id": 0,
        "provider_sensor_id": "string",
        "is_active": false,
        "unactivate_date": "1970-01-01T00:00:00.000Z",
        "host": {
          "sensor_host_id": 0,
          "url": "string"
        }
      }
    ]
  }
]
```

**Описание полей ответа**
- `[].truck_info_id` — Id транспортного средства
- `[].related_id` — Id связанного транспортного средства
- `[].ownership_type` — Тип владения ТС * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `[].type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `[].car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `[].description` — Короткое описание
- `[].brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `[].model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `[].number` — Госномер
- `[].capacity` — Грузоподъемность
- `[].volume` — Объем
- `[].length` — Длина
- `[].width` — Ширина
- `[].height` — Высота
- `[].last_deal_related_id` — Id связанного во время последней сделки транспортного средства
- `[].manufacture_year` — Год выпуска
- `[].hidden_in_firm_info` — Не отображать в карточке фирмы
- `[].vin` — VIN
- `[].vrc` — СТС
- `[].body_number` — Номер кузова
- `[].dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `[].truck_passport_number` — Номер ПТС
- `[].can_refrigerator` — Способность возить реф-контейнеры
- `[].has_gen_set` — Есть GenSet
- `[].truck_owner_name` — Имя владельца по СТС
- `[].can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `[].can_carry_tall_container` — Способность перевозить высокие контейнеры
- `[].external_id` — Идентификатор
- `[].scans` — Сканы документов ТС
- `[].scans[].scan_id` — Id скана
- `[].scans[].scan_path` — Адрес расположения файла скана в хранилище
- `[].scans[].scan_name` — Имя файла скана
- `[].scans[].scan_type` — Тип документа * `3` — Скан ПТС * `4` — Скан пластикового ПТС * `6` — Скан договора аренеды * `7` — Скан свидетельства о браке * `8` — Скан договора безвозмездного пользования
- `[].photos` — Фото ТС
- `[].photos[].id` — Id фото
- `[].photos[].path` — Адрес расположения файла в хранилище
- `[].photos[].name` — Имя файла
- `[].sensors` — Датчики мониторинга транспорта
- `[].sensors[].sensor_id` — Идентификатор датчика
- `[].sensors[].sensor_name` — Наименование датчика
- `[].sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `[].sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `[].sensors[].is_active` — Статус активности датчика
- `[].sensors[].unactivate_date` — Дата окончания действия датчика
- `[].sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `[].sensors[].host.sensor_host_id` — Идентификатор сервера
- `[].sensors[].host.url` — Адрес сервера

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="post-v1.2-catalogs-trucks"></a>

**Версия: OAuth2.0 v1**

Создание транспортного средства

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/trucks' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "type": 0,
  "car_type_id": 0,
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "manufacture_year": 0,
  "ownership_type": {},
  "phone_number": "string",
  "bind_phone": false,
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "dimension": 0,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "truck_passport_number": "string",
  "external_id": "string",
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `manufacture_year` — Год выпуска
- `ownership_type` — Тип владения ТС.\ * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `phone_number` — Номер телефона
- `bind_phone` — Эксклюзивный доступ к приложению Ати-Водитель
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `hidden_in_firm_info` — Не отображать в карточке фирмы.
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `truck_passport_number` — Номер ПТС
- `external_id` — Идентификатор
- `sensors` — Датчики мониторинга
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (200)**

```json
{
  "truck_info_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ownership_type": {},
  "type": {},
  "car_type_id": 0,
  "description": "string",
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "last_deal_related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "manufacture_year": 0,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "dimension": 0,
  "truck_passport_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "external_id": "string",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "photos": [
    {
      "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "file_id": "string",
      "path": "string",
      "name": "string"
    }
  ],
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "is_active": false,
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}
```

**Описание полей ответа**
- `truck_info_id` — Id транспортного средства
- `related_id` — Id связанного транспортного средства
- `ownership_type` — Тип владения ТС * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `description` — Короткое описание
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `last_deal_related_id` — Id связанного во время последней сделки транспортного средства
- `manufacture_year` — Год выпуска
- `hidden_in_firm_info` — Не отображать в карточке фирмы
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_passport_number` — Номер ПТС
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `external_id` — Идентификатор
- `scans` — Сканы документов ТС
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `3` — Скан ПТС * `4` — Скан пластикового ПТС * `6` — Скан договора аренеды * `7` — Скан свидетельства о браке * `8` — Скан договора безвозмездного пользования
- `photos` — Фото ТС
- `photos[].id` — Id фото
- `photos[].path` — Адрес расположения файла в хранилище
- `photos[].name` — Имя файла
- `sensors` — Датчики мониторинга транспорта
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].is_active` — Статус активности датчика
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="post-catalogs-v1.2-trucks"></a>

**Версия: OAuth2.0 v2**

Создание транспортного средства

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/trucks' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "type": 0,
  "car_type_id": 0,
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "manufacture_year": 0,
  "ownership_type": {},
  "phone_number": "string",
  "bind_phone": false,
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "dimension": 0,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "truck_passport_number": "string",
  "external_id": "string",
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `manufacture_year` — Год выпуска
- `ownership_type` — Тип владения ТС.\ * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `phone_number` — Номер телефона
- `bind_phone` — Эксклюзивный доступ к приложению Ати-Водитель
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `hidden_in_firm_info` — Не отображать в карточке фирмы.
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `truck_passport_number` — Номер ПТС
- `external_id` — Идентификатор
- `sensors` — Датчики мониторинга
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (200)**

```json
{
  "truck_info_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ownership_type": {},
  "type": {},
  "car_type_id": 0,
  "description": "string",
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "last_deal_related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "manufacture_year": 0,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "dimension": 0,
  "truck_passport_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "external_id": "string",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "photos": [
    {
      "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "file_id": "string",
      "path": "string",
      "name": "string"
    }
  ],
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "is_active": false,
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}
```

**Описание полей ответа**
- `truck_info_id` — Id транспортного средства
- `related_id` — Id связанного транспортного средства
- `ownership_type` — Тип владения ТС * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `description` — Короткое описание
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `last_deal_related_id` — Id связанного во время последней сделки транспортного средства
- `manufacture_year` — Год выпуска
- `hidden_in_firm_info` — Не отображать в карточке фирмы
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_passport_number` — Номер ПТС
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `external_id` — Идентификатор
- `scans` — Сканы документов ТС
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `3` — Скан ПТС * `4` — Скан пластикового ПТС * `6` — Скан договора аренеды * `7` — Скан свидетельства о браке * `8` — Скан договора безвозмездного пользования
- `photos` — Фото ТС
- `photos[].id` — Id фото
- `photos[].path` — Адрес расположения файла в хранилище
- `photos[].name` — Имя файла
- `sensors` — Датчики мониторинга транспорта
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].is_active` — Статус активности датчика
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="get-v1.2-catalogs-trucks-{truckId}"></a>

**Версия: OAuth2.0 v1**

Получение транспортного средства пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/trucks/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
{
  "truck_info_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ownership_type": {},
  "type": {},
  "car_type_id": 0,
  "description": "string",
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "last_deal_related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "manufacture_year": 0,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "dimension": 0,
  "truck_passport_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "external_id": "string",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "photos": [
    {
      "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "file_id": "string",
      "path": "string",
      "name": "string"
    }
  ],
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "is_active": false,
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}
```

**Описание полей ответа**
- `truck_info_id` — Id транспортного средства
- `related_id` — Id связанного транспортного средства
- `ownership_type` — Тип владения ТС * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `description` — Короткое описание
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `last_deal_related_id` — Id связанного во время последней сделки транспортного средства
- `manufacture_year` — Год выпуска
- `hidden_in_firm_info` — Не отображать в карточке фирмы
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_passport_number` — Номер ПТС
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `external_id` — Идентификатор
- `scans` — Сканы документов ТС
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `3` — Скан ПТС * `4` — Скан пластикового ПТС * `6` — Скан договора аренеды * `7` — Скан свидетельства о браке * `8` — Скан договора безвозмездного пользования
- `photos` — Фото ТС
- `photos[].id` — Id фото
- `photos[].path` — Адрес расположения файла в хранилище
- `photos[].name` — Имя файла
- `sensors` — Датчики мониторинга транспорта
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].is_active` — Статус активности датчика
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-trucks-{truckId}"></a>

**Версия: OAuth2.0 v2**

Получение транспортного средства пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/trucks/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
{
  "truck_info_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ownership_type": {},
  "type": {},
  "car_type_id": 0,
  "description": "string",
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "last_deal_related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "manufacture_year": 0,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "dimension": 0,
  "truck_passport_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "external_id": "string",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "photos": [
    {
      "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "file_id": "string",
      "path": "string",
      "name": "string"
    }
  ],
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "is_active": false,
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}
```

**Описание полей ответа**
- `truck_info_id` — Id транспортного средства
- `related_id` — Id связанного транспортного средства
- `ownership_type` — Тип владения ТС * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `description` — Короткое описание
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `last_deal_related_id` — Id связанного во время последней сделки транспортного средства
- `manufacture_year` — Год выпуска
- `hidden_in_firm_info` — Не отображать в карточке фирмы
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_passport_number` — Номер ПТС
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `external_id` — Идентификатор
- `scans` — Сканы документов ТС
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `3` — Скан ПТС * `4` — Скан пластикового ПТС * `6` — Скан договора аренеды * `7` — Скан свидетельства о браке * `8` — Скан договора безвозмездного пользования
- `photos` — Фото ТС
- `photos[].id` — Id фото
- `photos[].path` — Адрес расположения файла в хранилище
- `photos[].name` — Имя файла
- `sensors` — Датчики мониторинга транспорта
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].is_active` — Статус активности датчика
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="put-v1.2-catalogs-trucks-{truckId}"></a>

**Версия: OAuth2.0 v1**

Редактирование транспортного средства

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/trucks/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "type": 0,
  "car_type_id": 0,
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "manufacture_year": 0,
  "ownership_type": {},
  "phone_number": "string",
  "bind_phone": false,
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "dimension": 0,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "truck_passport_number": "string",
  "external_id": "string",
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `manufacture_year` — Год выпуска
- `ownership_type` — Тип владения ТС.\ * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `phone_number` — Номер телефона
- `bind_phone` — Эксклюзивный доступ к приложению Ати-Водитель
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `hidden_in_firm_info` — Не отображать в карточке фирмы.
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `truck_passport_number` — Номер ПТС
- `external_id` — Идентификатор
- `sensors` — Датчики мониторинга
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (200)**

```json
{
  "truck_info_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ownership_type": {},
  "type": {},
  "car_type_id": 0,
  "description": "string",
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "last_deal_related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "manufacture_year": 0,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "dimension": 0,
  "truck_passport_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "external_id": "string",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "photos": [
    {
      "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "file_id": "string",
      "path": "string",
      "name": "string"
    }
  ],
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "is_active": false,
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}
```

**Описание полей ответа**
- `truck_info_id` — Id транспортного средства
- `related_id` — Id связанного транспортного средства
- `ownership_type` — Тип владения ТС * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `description` — Короткое описание
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `last_deal_related_id` — Id связанного во время последней сделки транспортного средства
- `manufacture_year` — Год выпуска
- `hidden_in_firm_info` — Не отображать в карточке фирмы
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_passport_number` — Номер ПТС
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `external_id` — Идентификатор
- `scans` — Сканы документов ТС
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `3` — Скан ПТС * `4` — Скан пластикового ПТС * `6` — Скан договора аренеды * `7` — Скан свидетельства о браке * `8` — Скан договора безвозмездного пользования
- `photos` — Фото ТС
- `photos[].id` — Id фото
- `photos[].path` — Адрес расположения файла в хранилище
- `photos[].name` — Имя файла
- `sensors` — Датчики мониторинга транспорта
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].is_active` — Статус активности датчика
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="put-catalogs-v1.2-trucks-{truckId}"></a>

**Версия: OAuth2.0 v2**

Редактирование транспортного средства

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/trucks/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "type": 0,
  "car_type_id": 0,
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "manufacture_year": 0,
  "ownership_type": {},
  "phone_number": "string",
  "bind_phone": false,
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "dimension": 0,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "truck_passport_number": "string",
  "external_id": "string",
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `manufacture_year` — Год выпуска
- `ownership_type` — Тип владения ТС.\ * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `phone_number` — Номер телефона
- `bind_phone` — Эксклюзивный доступ к приложению Ати-Водитель
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `hidden_in_firm_info` — Не отображать в карточке фирмы.
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `truck_passport_number` — Номер ПТС
- `external_id` — Идентификатор
- `sensors` — Датчики мониторинга
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (200)**

```json
{
  "truck_info_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ownership_type": {},
  "type": {},
  "car_type_id": 0,
  "description": "string",
  "brand_id": 0,
  "model": "string",
  "number": "string",
  "capacity": 0.5,
  "volume": 0.5,
  "length": 0.5,
  "width": 0.5,
  "height": 0.5,
  "last_deal_related_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "manufacture_year": 0,
  "hidden_in_firm_info": false,
  "vin": "string",
  "vrc": "string",
  "body_number": "string",
  "dimension": 0,
  "truck_passport_number": "string",
  "can_refrigerator": false,
  "has_gen_set": false,
  "truck_owner_name": "string",
  "can_carry_heavy_container": false,
  "can_carry_tall_container": false,
  "external_id": "string",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "photos": [
    {
      "owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "file_id": "string",
      "path": "string",
      "name": "string"
    }
  ],
  "sensors": [
    {
      "sensor_id": 0,
      "sensor_name": "string",
      "provider_id": 0,
      "provider_sensor_id": "string",
      "is_active": false,
      "unactivate_date": "1970-01-01T00:00:00.000Z",
      "host": {
        "sensor_host_id": 0,
        "url": "string"
      }
    }
  ]
}
```

**Описание полей ответа**
- `truck_info_id` — Id транспортного средства
- `related_id` — Id связанного транспортного средства
- `ownership_type` — Тип владения ТС * `0` - Собственное * `1` - Привлеченное * `2` - Аренда * `3` - Лизинг * `4` - Совместная собственность супругов * `5` - Безвозмездное пользование
- `type` — Тип транспортного средства * `1` — Грузовик * `2` — Тягач * `4` — Полуприцеп * `8` — Прицеп
- `car_type_id` — Тип кузова\ Значение из [словаря кузовов АТИ](https://ati.su/developers/api/dictionaries/cargoes/#get-v1.0-dictionaries-carTypes)
- `description` — Короткое описание
- `brand_id` — Марка\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckbrands)
- `model` — Модель\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-truckmodels)
- `number` — Госномер
- `capacity` — Грузоподъемность
- `volume` — Объем
- `length` — Длина
- `width` — Ширина
- `height` — Высота
- `last_deal_related_id` — Id связанного во время последней сделки транспортного средства
- `manufacture_year` — Год выпуска
- `hidden_in_firm_info` — Не отображать в карточке фирмы
- `vin` — VIN
- `vrc` — СТС
- `body_number` — Номер кузова
- `dimension` — Размерность контейнера\ Значение из [словаря](https://ati.su/developers/api/dictionaries/catalogs/#get-v1.2-catalogs-dictionaries-container_dimensions)
- `truck_passport_number` — Номер ПТС
- `can_refrigerator` — Способность возить реф-контейнеры
- `has_gen_set` — Есть GenSet
- `truck_owner_name` — Имя владельца по СТС
- `can_carry_heavy_container` — Способность перевозить тяжелые контейнеры
- `can_carry_tall_container` — Способность перевозить высокие контейнеры
- `external_id` — Идентификатор
- `scans` — Сканы документов ТС
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `3` — Скан ПТС * `4` — Скан пластикового ПТС * `6` — Скан договора аренеды * `7` — Скан свидетельства о браке * `8` — Скан договора безвозмездного пользования
- `photos` — Фото ТС
- `photos[].id` — Id фото
- `photos[].path` — Адрес расположения файла в хранилище
- `photos[].name` — Имя файла
- `sensors` — Датчики мониторинга транспорта
- `sensors[].sensor_id` — Идентификатор датчика
- `sensors[].sensor_name` — Наименование датчика
- `sensors[].provider_id` — Идентификатор поставщика датчиков мониторинга транспорта
- `sensors[].provider_sensor_id` — Идентификатор датчика из внешней системы мониторинга
- `sensors[].is_active` — Статус активности датчика
- `sensors[].unactivate_date` — Дата окончания действия датчика
- `sensors[].host` — Информация о сервере поставщика устройства мониторинга транспорта
- `sensors[].host.sensor_host_id` — Идентификатор сервера
- `sensors[].host.url` — Адрес сервера

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="delete-v1.2-catalogs-trucks-{truckId}"></a>

**Версия: OAuth2.0 v1**

Удаление транспортного средства

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/trucks/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
{}
```

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="delete-catalogs-v1.2-trucks-{truckId}"></a>

**Версия: OAuth2.0 v2**

Удаление транспортного средства

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/trucks/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
{}
```

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


### Методы для работы с водителями

<a id="get-v1.2-catalogs-drivers"></a>

**Версия: OAuth2.0 v1**

Получение водителей пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/drivers?cargoOwnerAtiId=string' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
    "first_name": "Иван",
    "second_name": "Иванов",
    "patronymic": "Иванович",
    "phone": {
      "phone": 0.5,
      "phone_string": "string",
      "presence": {
        "phone": 0.5,
        "initial_phone": "string",
        "last_active": "1970-01-01T00:00:00.000Z",
        "has_tracker": false,
        "sms_invite_status": {
          "invite_sent": false,
          "contact_name": "string",
          "firm_id": 0,
          "contact_id": 0,
          "sms_status": {},
          "when": "1970-01-01T00:00:00.000Z"
        }
      },
      "binding": {
        "status": {},
        "account_id": "string",
        "firm_name": "string",
        "owner_type": {}
      },
      "binding_type": {}
    },
    "driver_license_number": "77 77 123456",
    "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
    "passport_series": "4010",
    "passport_number": "123456",
    "passport_issued_by": "УФМС России",
    "passport_when_issued": "2018-01-01",
    "registration": "гор. Санкт-Петербург",
    "is_attracted_driver": false,
    "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
    "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
    "description": "Иванов Иван Иванович",
    "attracted_from": "ООО Название фирмы",
    "scans": [
      {
        "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
        "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "scan_file_id": "string",
        "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
        "scan_name": "ВУ.pdf",
        "scan_type": 0
      }
    ],
    "date_of_birth": "1970-01-01T00:00:00.000Z",
    "department_code_in_passport": "string",
    "driver_inn": "string",
    "in_cargo_owner_black_list": false,
    "external_id": "string"
  }
]
```

**Описание полей ответа**
- `[].driver_id` — Id водителя
- `[].first_name` — Имя
- `[].second_name` — Фамилия
- `[].patronymic` — Отчество
- `[].phone` — Информация о номерe телефона водителя
- `[].phone.phone` — Номер телефона
- `[].phone.phone_string` — Номер телефона, как указан пользователем
- `[].phone.presence` — Статус приложения АТИ Водитель
- `[].phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `[].phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `[].phone.presence.last_active` — Время последней активности в приложении
- `[].phone.presence.has_tracker` — Авторизация в приложении
- `[].phone.presence.sms_invite_status` — Статус приглашения в приложение
- `[].phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `[].phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `[].phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `[].phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `[].phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `[].phone.presence.sms_invite_status.when` — Время отправки SMS
- `[].phone.binding` — Информация об актуальной привязке
- `[].phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `[].phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `[].phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `[].phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `[].phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `[].driver_license_number` — Номер водительского удостоверения
- `[].driver_license_when_issued` — Когда выдано водительское удостоверение
- `[].passport_series` — Серия паспорта
- `[].passport_number` — Номер паспорта
- `[].passport_issued_by` — Кем выдан
- `[].passport_when_issued` — Когда выдан
- `[].registration` — Прописка
- `[].is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `[].related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `[].last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `[].description` — Краткое описание водителя
- `[].attracted_from` — Фирма от которой привлечен водитель.
- `[].scans` — Сканы документов водителя
- `[].scans[].scan_id` — Id скана
- `[].scans[].scan_path` — Адрес расположения файла скана в хранилище
- `[].scans[].scan_name` — Имя файла скана
- `[].scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `[].date_of_birth` — Дата рождения
- `[].department_code_in_passport` — Код подразделения
- `[].driver_inn` — ИНН водителя
- `[].in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `[].external_id` — Идентификатор

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-drivers"></a>

**Версия: OAuth2.0 v2**

Получение водителей пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/drivers?cargoOwnerAtiId=string' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
[
  {
    "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
    "first_name": "Иван",
    "second_name": "Иванов",
    "patronymic": "Иванович",
    "phone": {
      "phone": 0.5,
      "phone_string": "string",
      "presence": {
        "phone": 0.5,
        "initial_phone": "string",
        "last_active": "1970-01-01T00:00:00.000Z",
        "has_tracker": false,
        "sms_invite_status": {
          "invite_sent": false,
          "contact_name": "string",
          "firm_id": 0,
          "contact_id": 0,
          "sms_status": {},
          "when": "1970-01-01T00:00:00.000Z"
        }
      },
      "binding": {
        "status": {},
        "account_id": "string",
        "firm_name": "string",
        "owner_type": {}
      },
      "binding_type": {}
    },
    "driver_license_number": "77 77 123456",
    "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
    "passport_series": "4010",
    "passport_number": "123456",
    "passport_issued_by": "УФМС России",
    "passport_when_issued": "2018-01-01",
    "registration": "гор. Санкт-Петербург",
    "is_attracted_driver": false,
    "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
    "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
    "description": "Иванов Иван Иванович",
    "attracted_from": "ООО Название фирмы",
    "scans": [
      {
        "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
        "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "scan_file_id": "string",
        "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
        "scan_name": "ВУ.pdf",
        "scan_type": 0
      }
    ],
    "date_of_birth": "1970-01-01T00:00:00.000Z",
    "department_code_in_passport": "string",
    "driver_inn": "string",
    "in_cargo_owner_black_list": false,
    "external_id": "string"
  }
]
```

**Описание полей ответа**
- `[].driver_id` — Id водителя
- `[].first_name` — Имя
- `[].second_name` — Фамилия
- `[].patronymic` — Отчество
- `[].phone` — Информация о номерe телефона водителя
- `[].phone.phone` — Номер телефона
- `[].phone.phone_string` — Номер телефона, как указан пользователем
- `[].phone.presence` — Статус приложения АТИ Водитель
- `[].phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `[].phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `[].phone.presence.last_active` — Время последней активности в приложении
- `[].phone.presence.has_tracker` — Авторизация в приложении
- `[].phone.presence.sms_invite_status` — Статус приглашения в приложение
- `[].phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `[].phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `[].phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `[].phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `[].phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `[].phone.presence.sms_invite_status.when` — Время отправки SMS
- `[].phone.binding` — Информация об актуальной привязке
- `[].phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `[].phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `[].phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `[].phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `[].phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `[].driver_license_number` — Номер водительского удостоверения
- `[].driver_license_when_issued` — Когда выдано водительское удостоверение
- `[].passport_series` — Серия паспорта
- `[].passport_number` — Номер паспорта
- `[].passport_issued_by` — Кем выдан
- `[].passport_when_issued` — Когда выдан
- `[].registration` — Прописка
- `[].is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `[].related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `[].last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `[].description` — Краткое описание водителя
- `[].attracted_from` — Фирма от которой привлечен водитель.
- `[].scans` — Сканы документов водителя
- `[].scans[].scan_id` — Id скана
- `[].scans[].scan_path` — Адрес расположения файла скана в хранилище
- `[].scans[].scan_name` — Имя файла скана
- `[].scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `[].date_of_birth` — Дата рождения
- `[].department_code_in_passport` — Код подразделения
- `[].driver_inn` — ИНН водителя
- `[].in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `[].external_id` — Идентификатор

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="post-v1.2-catalogs-drivers"></a>

**Версия: OAuth2.0 v1**

Создание водителя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/drivers' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone_number": "+7(910)333-33-33",
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "2018-01-01",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "attracted_from": "ООО Название фирмы",
  "date_of_birth": "1985-01-01",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "external_id": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone_number` — Номер телефона
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан паспорт
- `passport_when_issued` — Когда выдан паспорт
- `registration` — Адрес регистрации
- `is_attracted_driver` — Флаг привлеченного водителя
- `attracted_from` — Фирма, от которой привлечен водитель
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `external_id` — Идентификатор

**Пример ответа (200)**

```json
{
  "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone": {
    "phone": 0.5,
    "phone_string": "string",
    "presence": {
      "phone": 0.5,
      "initial_phone": "string",
      "last_active": "1970-01-01T00:00:00.000Z",
      "has_tracker": false,
      "sms_invite_status": {
        "invite_sent": false,
        "contact_name": "string",
        "firm_id": 0,
        "contact_id": 0,
        "sms_status": {},
        "when": "1970-01-01T00:00:00.000Z"
      }
    },
    "binding": {
      "status": {},
      "account_id": "string",
      "firm_name": "string",
      "owner_type": {}
    },
    "binding_type": {}
  },
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "description": "Иванов Иван Иванович",
  "attracted_from": "ООО Название фирмы",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "date_of_birth": "1970-01-01T00:00:00.000Z",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "in_cargo_owner_black_list": false,
  "external_id": "string"
}
```

**Описание полей ответа**
- `driver_id` — Id водителя
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone` — Информация о номерe телефона водителя
- `phone.phone` — Номер телефона
- `phone.phone_string` — Номер телефона, как указан пользователем
- `phone.presence` — Статус приложения АТИ Водитель
- `phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `phone.presence.last_active` — Время последней активности в приложении
- `phone.presence.has_tracker` — Авторизация в приложении
- `phone.presence.sms_invite_status` — Статус приглашения в приложение
- `phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `phone.presence.sms_invite_status.when` — Время отправки SMS
- `phone.binding` — Информация об актуальной привязке
- `phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан
- `passport_when_issued` — Когда выдан
- `registration` — Прописка
- `is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `description` — Краткое описание водителя
- `attracted_from` — Фирма от которой привлечен водитель.
- `scans` — Сканы документов водителя
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `external_id` — Идентификатор

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="post-catalogs-v1.2-drivers"></a>

**Версия: OAuth2.0 v2**

Создание водителя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/drivers' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone_number": "+7(910)333-33-33",
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "2018-01-01",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "attracted_from": "ООО Название фирмы",
  "date_of_birth": "1985-01-01",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "external_id": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone_number` — Номер телефона
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан паспорт
- `passport_when_issued` — Когда выдан паспорт
- `registration` — Адрес регистрации
- `is_attracted_driver` — Флаг привлеченного водителя
- `attracted_from` — Фирма, от которой привлечен водитель
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `external_id` — Идентификатор

**Пример ответа (200)**

```json
{
  "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone": {
    "phone": 0.5,
    "phone_string": "string",
    "presence": {
      "phone": 0.5,
      "initial_phone": "string",
      "last_active": "1970-01-01T00:00:00.000Z",
      "has_tracker": false,
      "sms_invite_status": {
        "invite_sent": false,
        "contact_name": "string",
        "firm_id": 0,
        "contact_id": 0,
        "sms_status": {},
        "when": "1970-01-01T00:00:00.000Z"
      }
    },
    "binding": {
      "status": {},
      "account_id": "string",
      "firm_name": "string",
      "owner_type": {}
    },
    "binding_type": {}
  },
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "description": "Иванов Иван Иванович",
  "attracted_from": "ООО Название фирмы",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "date_of_birth": "1970-01-01T00:00:00.000Z",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "in_cargo_owner_black_list": false,
  "external_id": "string"
}
```

**Описание полей ответа**
- `driver_id` — Id водителя
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone` — Информация о номерe телефона водителя
- `phone.phone` — Номер телефона
- `phone.phone_string` — Номер телефона, как указан пользователем
- `phone.presence` — Статус приложения АТИ Водитель
- `phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `phone.presence.last_active` — Время последней активности в приложении
- `phone.presence.has_tracker` — Авторизация в приложении
- `phone.presence.sms_invite_status` — Статус приглашения в приложение
- `phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `phone.presence.sms_invite_status.when` — Время отправки SMS
- `phone.binding` — Информация об актуальной привязке
- `phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан
- `passport_when_issued` — Когда выдан
- `registration` — Прописка
- `is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `description` — Краткое описание водителя
- `attracted_from` — Фирма от которой привлечен водитель.
- `scans` — Сканы документов водителя
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `external_id` — Идентификатор

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="get-v1.2-catalogs-drivers-{driverId}"></a>

**Версия: OAuth2.0 v1**

Получение водителя пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/drivers/3fa85f64-5717-4562-b3fc-2c963f66afa6?cargoOwnerAtiId=string' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
{
  "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone": {
    "phone": 0.5,
    "phone_string": "string",
    "presence": {
      "phone": 0.5,
      "initial_phone": "string",
      "last_active": "1970-01-01T00:00:00.000Z",
      "has_tracker": false,
      "sms_invite_status": {
        "invite_sent": false,
        "contact_name": "string",
        "firm_id": 0,
        "contact_id": 0,
        "sms_status": {},
        "when": "1970-01-01T00:00:00.000Z"
      }
    },
    "binding": {
      "status": {},
      "account_id": "string",
      "firm_name": "string",
      "owner_type": {}
    },
    "binding_type": {}
  },
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "description": "Иванов Иван Иванович",
  "attracted_from": "ООО Название фирмы",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "date_of_birth": "1970-01-01T00:00:00.000Z",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "in_cargo_owner_black_list": false,
  "external_id": "string"
}
```

**Описание полей ответа**
- `driver_id` — Id водителя
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone` — Информация о номерe телефона водителя
- `phone.phone` — Номер телефона
- `phone.phone_string` — Номер телефона, как указан пользователем
- `phone.presence` — Статус приложения АТИ Водитель
- `phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `phone.presence.last_active` — Время последней активности в приложении
- `phone.presence.has_tracker` — Авторизация в приложении
- `phone.presence.sms_invite_status` — Статус приглашения в приложение
- `phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `phone.presence.sms_invite_status.when` — Время отправки SMS
- `phone.binding` — Информация об актуальной привязке
- `phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан
- `passport_when_issued` — Когда выдан
- `registration` — Прописка
- `is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `description` — Краткое описание водителя
- `attracted_from` — Фирма от которой привлечен водитель.
- `scans` — Сканы документов водителя
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `external_id` — Идентификатор

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="get-catalogs-v1.2-drivers-{driverId}"></a>

**Версия: OAuth2.0 v2**

Получение водителя пользователя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/drivers/3fa85f64-5717-4562-b3fc-2c963f66afa6?cargoOwnerAtiId=string' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
{
  "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone": {
    "phone": 0.5,
    "phone_string": "string",
    "presence": {
      "phone": 0.5,
      "initial_phone": "string",
      "last_active": "1970-01-01T00:00:00.000Z",
      "has_tracker": false,
      "sms_invite_status": {
        "invite_sent": false,
        "contact_name": "string",
        "firm_id": 0,
        "contact_id": 0,
        "sms_status": {},
        "when": "1970-01-01T00:00:00.000Z"
      }
    },
    "binding": {
      "status": {},
      "account_id": "string",
      "firm_name": "string",
      "owner_type": {}
    },
    "binding_type": {}
  },
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "description": "Иванов Иван Иванович",
  "attracted_from": "ООО Название фирмы",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "date_of_birth": "1970-01-01T00:00:00.000Z",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "in_cargo_owner_black_list": false,
  "external_id": "string"
}
```

**Описание полей ответа**
- `driver_id` — Id водителя
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone` — Информация о номерe телефона водителя
- `phone.phone` — Номер телефона
- `phone.phone_string` — Номер телефона, как указан пользователем
- `phone.presence` — Статус приложения АТИ Водитель
- `phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `phone.presence.last_active` — Время последней активности в приложении
- `phone.presence.has_tracker` — Авторизация в приложении
- `phone.presence.sms_invite_status` — Статус приглашения в приложение
- `phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `phone.presence.sms_invite_status.when` — Время отправки SMS
- `phone.binding` — Информация об актуальной привязке
- `phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан
- `passport_when_issued` — Когда выдан
- `registration` — Прописка
- `is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `description` — Краткое описание водителя
- `attracted_from` — Фирма от которой привлечен водитель.
- `scans` — Сканы документов водителя
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `external_id` — Идентификатор

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="put-v1.2-catalogs-drivers-{driverId}"></a>

**Версия: OAuth2.0 v1**

Редактирование водителя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/drivers/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone_number": "+7(910)333-33-33",
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "2018-01-01",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "attracted_from": "ООО Название фирмы",
  "date_of_birth": "1985-01-01",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "external_id": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone_number` — Номер телефона
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан паспорт
- `passport_when_issued` — Когда выдан паспорт
- `registration` — Адрес регистрации
- `is_attracted_driver` — Флаг привлеченного водителя
- `attracted_from` — Фирма, от которой привлечен водитель
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `external_id` — Идентификатор

**Пример ответа (200)**

```json
{
  "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone": {
    "phone": 0.5,
    "phone_string": "string",
    "presence": {
      "phone": 0.5,
      "initial_phone": "string",
      "last_active": "1970-01-01T00:00:00.000Z",
      "has_tracker": false,
      "sms_invite_status": {
        "invite_sent": false,
        "contact_name": "string",
        "firm_id": 0,
        "contact_id": 0,
        "sms_status": {},
        "when": "1970-01-01T00:00:00.000Z"
      }
    },
    "binding": {
      "status": {},
      "account_id": "string",
      "firm_name": "string",
      "owner_type": {}
    },
    "binding_type": {}
  },
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "description": "Иванов Иван Иванович",
  "attracted_from": "ООО Название фирмы",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "date_of_birth": "1970-01-01T00:00:00.000Z",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "in_cargo_owner_black_list": false,
  "external_id": "string"
}
```

**Описание полей ответа**
- `driver_id` — Id водителя
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone` — Информация о номерe телефона водителя
- `phone.phone` — Номер телефона
- `phone.phone_string` — Номер телефона, как указан пользователем
- `phone.presence` — Статус приложения АТИ Водитель
- `phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `phone.presence.last_active` — Время последней активности в приложении
- `phone.presence.has_tracker` — Авторизация в приложении
- `phone.presence.sms_invite_status` — Статус приглашения в приложение
- `phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `phone.presence.sms_invite_status.when` — Время отправки SMS
- `phone.binding` — Информация об актуальной привязке
- `phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан
- `passport_when_issued` — Когда выдан
- `registration` — Прописка
- `is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `description` — Краткое описание водителя
- `attracted_from` — Фирма от которой привлечен водитель.
- `scans` — Сканы документов водителя
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `external_id` — Идентификатор

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="put-catalogs-v1.2-drivers-{driverId}"></a>

**Версия: OAuth2.0 v2**

Редактирование водителя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/drivers/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone_number": "+7(910)333-33-33",
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "2018-01-01",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "attracted_from": "ООО Название фирмы",
  "date_of_birth": "1985-01-01",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "external_id": "string"
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone_number` — Номер телефона
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан паспорт
- `passport_when_issued` — Когда выдан паспорт
- `registration` — Адрес регистрации
- `is_attracted_driver` — Флаг привлеченного водителя
- `attracted_from` — Фирма, от которой привлечен водитель
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `external_id` — Идентификатор

**Пример ответа (200)**

```json
{
  "driver_id": "c063e1c5-a58f-4f6b-b805-62d0715f4fba",
  "first_name": "Иван",
  "second_name": "Иванов",
  "patronymic": "Иванович",
  "phone": {
    "phone": 0.5,
    "phone_string": "string",
    "presence": {
      "phone": 0.5,
      "initial_phone": "string",
      "last_active": "1970-01-01T00:00:00.000Z",
      "has_tracker": false,
      "sms_invite_status": {
        "invite_sent": false,
        "contact_name": "string",
        "firm_id": 0,
        "contact_id": 0,
        "sms_status": {},
        "when": "1970-01-01T00:00:00.000Z"
      }
    },
    "binding": {
      "status": {},
      "account_id": "string",
      "firm_name": "string",
      "owner_type": {}
    },
    "binding_type": {}
  },
  "driver_license_number": "77 77 123456",
  "driver_license_when_issued": "1970-01-01T00:00:00.000Z",
  "passport_series": "4010",
  "passport_number": "123456",
  "passport_issued_by": "УФМС России",
  "passport_when_issued": "2018-01-01",
  "registration": "гор. Санкт-Петербург",
  "is_attracted_driver": false,
  "related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "last_deal_related_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "description": "Иванов Иван Иванович",
  "attracted_from": "ООО Название фирмы",
  "scans": [
    {
      "scan_id": "1bb60c95-957b-473f-b664-4026533fa5a9",
      "scan_owner_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scan_file_id": "string",
      "scan_path": "https://d.ati.su/api/next/filestorage/cf91cb04-80a1-4b97-8ea2-2f0ad3a4d579",
      "scan_name": "ВУ.pdf",
      "scan_type": 0
    }
  ],
  "date_of_birth": "1970-01-01T00:00:00.000Z",
  "department_code_in_passport": "string",
  "driver_inn": "string",
  "in_cargo_owner_black_list": false,
  "external_id": "string"
}
```

**Описание полей ответа**
- `driver_id` — Id водителя
- `first_name` — Имя
- `second_name` — Фамилия
- `patronymic` — Отчество
- `phone` — Информация о номерe телефона водителя
- `phone.phone` — Номер телефона
- `phone.phone_string` — Номер телефона, как указан пользователем
- `phone.presence` — Статус приложения АТИ Водитель
- `phone.presence.phone` — Номер телефона, приведенный к числовому формату
- `phone.presence.initial_phone` — Номер телефона в том виде, в котором его указал пользователь
- `phone.presence.last_active` — Время последней активности в приложении
- `phone.presence.has_tracker` — Авторизация в приложении
- `phone.presence.sms_invite_status` — Статус приглашения в приложение
- `phone.presence.sms_invite_status.invite_sent` — Было ли отправлено приглашение
- `phone.presence.sms_invite_status.contact_name` — Имя пригласившего контакта
- `phone.presence.sms_invite_status.firm_id` — Id пригласившей фирмы
- `phone.presence.sms_invite_status.contact_id` — Id пригласившего контакт
- `phone.presence.sms_invite_status.sms_status` — Статус отправки СМС * `0` - Нет информации * `1` - Создано * `2` - Ошибка * `3` - Отправлено * `4` - Доставлено
- `phone.presence.sms_invite_status.when` — Время отправки SMS
- `phone.binding` — Информация об актуальной привязке
- `phone.binding.status` — Статус привязки * `0` - Эксклюзивный доступ * `1` - Запрос на эксклюзивный доступ * `2` - Запрос отклонен владельцем номера телефона * `3` - Фирма "уволила" владельца номера * `4` - Владелец номера "уволился" * `5` - Запрос удален
- `phone.binding.account_id` — Фирма, запрашивающая "Эксклюзивный доступ"
- `phone.binding.firm_name` — Название фирмы, запрашивающей "Эксклюзивный доступ"
- `phone.binding.owner_type` — Тип сущности, к которой привязан телефон * `0` — Водитель * `1` — ТС
- `phone.binding_type` — Тип привязки (Эксклюзивности) номера телефона * `0` - Номер не привязан * `1` - Номер привязан к водителю текущей фирмы * `2` - Номер привязан к ТС текущей фирмы * `3` - Номер привязан к водителю другой фирмы * `4` - Номер привязан к ТС другой фирмы
- `driver_license_number` — Номер водительского удостоверения
- `driver_license_when_issued` — Когда выдано водительское удостоверение
- `passport_series` — Серия паспорта
- `passport_number` — Номер паспорта
- `passport_issued_by` — Кем выдан
- `passport_when_issued` — Когда выдан
- `registration` — Прописка
- `is_attracted_driver` — Флаг привлеченного водителя (со стороны)
- `related_id` — Идентификатор связанного ТС, которое пользователь задал в кабинете
- `last_deal_related_id` — Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки
- `description` — Краткое описание водителя
- `attracted_from` — Фирма от которой привлечен водитель.
- `scans` — Сканы документов водителя
- `scans[].scan_id` — Id скана
- `scans[].scan_path` — Адрес расположения файла скана в хранилище
- `scans[].scan_name` — Имя файла скана
- `scans[].scan_type` — Тип документа * `1` — Скан водительского удостоверения * `2` — Скан гражданского паспорта
- `date_of_birth` — Дата рождения
- `department_code_in_passport` — Код подразделения
- `driver_inn` — ИНН водителя
- `in_cargo_owner_black_list` — Есть в Черном списке у запрашиваемого грузовладельца
- `external_id` — Идентификатор

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


<a id="delete-v1.2-catalogs-drivers-{driverId}"></a>

**Версия: OAuth2.0 v1**

Удаление водителя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/drivers/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
{}
```

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="delete-catalogs-v1.2-drivers-{driverId}"></a>

**Версия: OAuth2.0 v2**

Удаление водителя

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/drivers/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Пример ответа (200)**

```json
{}
```

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки


### Метод для работы со связями сущностей справочников

Данный метод позволяет установить связь между траспортными средствами и водителями. Если указанное в запросе траснспортное средство или водитель уже были ранее связаны с другими сущностями, то при создании новой связи старые связи разрываются. Возможно передавать Id одной сущности для отвязывания её.

<a id="post-v1.2-catalogs-relations"></a>

**Версия: OAuth2.0 v1**

Создание связей

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/catalogs/relations' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "truck_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "tractor_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "trailer_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "semitrailer_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "driver_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `truck_id` — Id грузовика
- `tractor_id` — Id тягача
- `trailer_id` — Id прицепа
- `semitrailer_id` — Id полуприцепа
- `driver_ids` — Список Id водителей

**Пример ответа (200)**

```json
{}
```

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки

<a id="post-catalogs-v1.2-relations"></a>

**Версия: OAuth2.0 v2**

Создание связей

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/gw/oauth2/catalogs/v1.2/relations' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "truck_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "tractor_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "trailer_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "semitrailer_id": "75fdfa06-287b-47ff-a6e7-1d9edfa5ac29",
  "driver_ids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/catalogs/autopark.openapi.json)

**Описание полей запроса**
- `truck_id` — Id грузовика
- `tractor_id` — Id тягача
- `trailer_id` — Id прицепа
- `semitrailer_id` — Id полуприцепа
- `driver_ids` — Список Id водителей

**Пример ответа (200)**

```json
{}
```

**Пример ответа (4XX)**

```json
{
  "error_code": "string",
  "reason": "string"
}
```

**Описание полей ответа**
- `error_code` — Код ошибки
- `reason` — Причина ошибки
---

## llms.txt

Индекс ключевых страниц документации для LLM и AI-агентов доступен в [основном llms.txt](https://ati.su/developers/llms.txt).