Skip to content
Мои токены Поддержка
Чат для вопросов по API Мгновенно ответим на ваши вопросы
api@ati.su Электронная почта техподдержки
Тикетная система Оставить заявку на отдел "Консультанты по интеграции (API)"
api.ati.su - заказы, торги, площадки Наш телеграм-канал
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
Отменить

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

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

Версия
Получение транспортных средств пользователя
get /v1.2/catalogs/trucks
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/catalogs/trucks' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Список транспортных средств
[{...}]
truck_info_id: guid

Id транспортного средства

related_id: guid (nullable)

Id связанного транспортного средства

is_attracted_truck: boolean

Привлеченное ТС. Устарело, используйте ownership_type

deprecated
ownership_type:

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
ONE-OF
prop0: enum
[0, 1, 2, 3, 4, 5]

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
type:

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
ONE-OF
prop0: enum
[1, 2, 4, 8]

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
car_type_id: int32

Тип кузова
Значение из словаря кузовов АТИ

description: string

Короткое описание

brand_id: int32 (nullable)

Марка
Значение из словаря

model: string

Модель
Значение из словаря

number: string

Госномер

capacity: decimal (nullable)

Грузоподъемность

volume: decimal (nullable)

Объем

length: decimal (nullable)

Длина

width: decimal (nullable)

Ширина

height: decimal (nullable)

Высота

last_deal_related_id: guid (nullable)

Id связанного во время последней сделки транспортного средства

manufacture_year: int32 (nullable)

Год выпуска

hidden_in_firm_info: boolean

Не отображать в карточке фирмы

vin: string

VIN

vrc: string

СТС

body_number: string

Номер кузова

dimension: int32 (nullable)

Размерность контейнера
Значение из словаря

truck_passport_number: string

Номер ПТС

can_refrigerator: boolean (nullable)

Способность возить реф-контейнеры

has_gen_set: boolean (nullable)

Есть GenSet

truck_owner_name: string

Имя владельца по СТС

can_carry_heavy_container: boolean (nullable)

Способность перевозить тяжелые контейнеры

can_carry_tall_container: boolean (nullable)

Способность перевозить высокие контейнеры

external_id: string

Идентификатор

}]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}
Версия
Создание транспортного средства
post /v1.2/catalogs/trucks
Запрос
Модель
{...}
type: enum
[1, 2, 4, 8]

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
car_type_id: int32

Тип кузова
Значение из словаря кузовов АТИ

brand_id: int32 (nullable)

Марка
Значение из словаря

model: string

Модель
Значение из словаря

number: string

Госномер

manufacture_year: int32 (nullable)

Год выпуска

ownership_type:

Тип владения ТС.\

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
ONE-OF

(nullable)

prop0: enum
[0, 1, 2, 3, 4, 5]

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
phone_number: string

Номер телефона

bind_phone: boolean (nullable)

Эксклюзивный доступ к приложению Ати-Водитель

capacity: decimal (nullable)

Грузоподъемность

volume: decimal (nullable)

Объем

length: decimal (nullable)

Длина

width: decimal (nullable)

Ширина

height: decimal (nullable)

Высота

hidden_in_firm_info: boolean

Не отображать в карточке фирмы.

vin: string

VIN

vrc: string

СТС

body_number: string

Номер кузова

can_refrigerator: boolean (nullable)

Способность возить реф-контейнеры

has_gen_set: boolean (nullable)

Есть GenSet

dimension: int32 (nullable)

Размерность контейнера
Значение из словаря

truck_owner_name: string

Имя владельца по СТС

can_carry_heavy_container: boolean (nullable)

Способность перевозить тяжелые контейнеры

can_carry_tall_container: boolean (nullable)

Способность перевозить высокие контейнеры

truck_passport_number: string

Номер ПТС

external_id: string

Идентификатор

}
Пример запроса 
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"}}]}'
Ответ
200 Созданное транспортное средство
{...}
truck_info_id: guid

Id транспортного средства

related_id: guid (nullable)

Id связанного транспортного средства

is_attracted_truck: boolean

Привлеченное ТС. Устарело, используйте ownership_type

deprecated
ownership_type:

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
ONE-OF
prop0: enum
[0, 1, 2, 3, 4, 5]

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
type:

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
ONE-OF
prop0: enum
[1, 2, 4, 8]

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
car_type_id: int32

Тип кузова
Значение из словаря кузовов АТИ

description: string

Короткое описание

brand_id: int32 (nullable)

Марка
Значение из словаря

model: string

Модель
Значение из словаря

number: string

Госномер

capacity: decimal (nullable)

Грузоподъемность

volume: decimal (nullable)

Объем

length: decimal (nullable)

Длина

width: decimal (nullable)

Ширина

height: decimal (nullable)

Высота

last_deal_related_id: guid (nullable)

Id связанного во время последней сделки транспортного средства

manufacture_year: int32 (nullable)

Год выпуска

hidden_in_firm_info: boolean

Не отображать в карточке фирмы

vin: string

VIN

vrc: string

СТС

body_number: string

Номер кузова

dimension: int32 (nullable)

Размерность контейнера
Значение из словаря

truck_passport_number: string

Номер ПТС

can_refrigerator: boolean (nullable)

Способность возить реф-контейнеры

has_gen_set: boolean (nullable)

Есть GenSet

truck_owner_name: string

Имя владельца по СТС

can_carry_heavy_container: boolean (nullable)

Способность перевозить тяжелые контейнеры

can_carry_tall_container: boolean (nullable)

Способность перевозить высокие контейнеры

external_id: string

Идентификатор

}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}
Версия
Получение транспортного средства пользователя
get /v1.2/catalogs/trucks/{truckId}
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/catalogs/trucks/{truckId}' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Транспортное средство
{...}
truck_info_id: guid

Id транспортного средства

related_id: guid (nullable)

Id связанного транспортного средства

is_attracted_truck: boolean

Привлеченное ТС. Устарело, используйте ownership_type

deprecated
ownership_type:

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
ONE-OF
prop0: enum
[0, 1, 2, 3, 4, 5]

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
type:

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
ONE-OF
prop0: enum
[1, 2, 4, 8]

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
car_type_id: int32

Тип кузова
Значение из словаря кузовов АТИ

description: string

Короткое описание

brand_id: int32 (nullable)

Марка
Значение из словаря

model: string

Модель
Значение из словаря

number: string

Госномер

capacity: decimal (nullable)

Грузоподъемность

volume: decimal (nullable)

Объем

length: decimal (nullable)

Длина

width: decimal (nullable)

Ширина

height: decimal (nullable)

Высота

last_deal_related_id: guid (nullable)

Id связанного во время последней сделки транспортного средства

manufacture_year: int32 (nullable)

Год выпуска

hidden_in_firm_info: boolean

Не отображать в карточке фирмы

vin: string

VIN

vrc: string

СТС

body_number: string

Номер кузова

dimension: int32 (nullable)

Размерность контейнера
Значение из словаря

truck_passport_number: string

Номер ПТС

can_refrigerator: boolean (nullable)

Способность возить реф-контейнеры

has_gen_set: boolean (nullable)

Есть GenSet

truck_owner_name: string

Имя владельца по СТС

can_carry_heavy_container: boolean (nullable)

Способность перевозить тяжелые контейнеры

can_carry_tall_container: boolean (nullable)

Способность перевозить высокие контейнеры

external_id: string

Идентификатор

}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}
Версия
Редактирование транспортного средства
put /v1.2/catalogs/trucks/{truckId}
Запрос
Модель
{...}
type: enum
[1, 2, 4, 8]

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
car_type_id: int32

Тип кузова
Значение из словаря кузовов АТИ

brand_id: int32 (nullable)

Марка
Значение из словаря

model: string

Модель
Значение из словаря

number: string

Госномер

manufacture_year: int32 (nullable)

Год выпуска

ownership_type:

Тип владения ТС.\

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
ONE-OF

(nullable)

prop0: enum
[0, 1, 2, 3, 4, 5]

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
phone_number: string

Номер телефона

bind_phone: boolean (nullable)

Эксклюзивный доступ к приложению Ати-Водитель

capacity: decimal (nullable)

Грузоподъемность

volume: decimal (nullable)

Объем

length: decimal (nullable)

Длина

width: decimal (nullable)

Ширина

height: decimal (nullable)

Высота

hidden_in_firm_info: boolean

Не отображать в карточке фирмы.

vin: string

VIN

vrc: string

СТС

body_number: string

Номер кузова

can_refrigerator: boolean (nullable)

Способность возить реф-контейнеры

has_gen_set: boolean (nullable)

Есть GenSet

dimension: int32 (nullable)

Размерность контейнера
Значение из словаря

truck_owner_name: string

Имя владельца по СТС

can_carry_heavy_container: boolean (nullable)

Способность перевозить тяжелые контейнеры

can_carry_tall_container: boolean (nullable)

Способность перевозить высокие контейнеры

truck_passport_number: string

Номер ПТС

external_id: string

Идентификатор

}
Пример запроса 
curl 'https://api.ati.su/v1.2/catalogs/trucks/{truckId}' \
  -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"}}]}'
Ответ
200 Отредактированное транспортное средство
{...}
truck_info_id: guid

Id транспортного средства

related_id: guid (nullable)

Id связанного транспортного средства

is_attracted_truck: boolean

Привлеченное ТС. Устарело, используйте ownership_type

deprecated
ownership_type:

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
ONE-OF
prop0: enum
[0, 1, 2, 3, 4, 5]

Тип владения ТС

  • 0 - Собственное
  • 1 - Привлеченное
  • 2 - Аренда
  • 3 - Лизинг
  • 4 - Совместная собственность супругов
  • 5 - Безвозмездное пользование
type:

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
ONE-OF
prop0: enum
[1, 2, 4, 8]

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

  • 1 — Грузовик
  • 2 — Тягач
  • 4 — Полуприцеп
  • 8 — Прицеп
car_type_id: int32

Тип кузова
Значение из словаря кузовов АТИ

description: string

Короткое описание

brand_id: int32 (nullable)

Марка
Значение из словаря

model: string

Модель
Значение из словаря

number: string

Госномер

capacity: decimal (nullable)

Грузоподъемность

volume: decimal (nullable)

Объем

length: decimal (nullable)

Длина

width: decimal (nullable)

Ширина

height: decimal (nullable)

Высота

last_deal_related_id: guid (nullable)

Id связанного во время последней сделки транспортного средства

manufacture_year: int32 (nullable)

Год выпуска

hidden_in_firm_info: boolean

Не отображать в карточке фирмы

vin: string

VIN

vrc: string

СТС

body_number: string

Номер кузова

dimension: int32 (nullable)

Размерность контейнера
Значение из словаря

truck_passport_number: string

Номер ПТС

can_refrigerator: boolean (nullable)

Способность возить реф-контейнеры

has_gen_set: boolean (nullable)

Есть GenSet

truck_owner_name: string

Имя владельца по СТС

can_carry_heavy_container: boolean (nullable)

Способность перевозить тяжелые контейнеры

can_carry_tall_container: boolean (nullable)

Способность перевозить высокие контейнеры

external_id: string

Идентификатор

}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}
Версия
Удаление транспортного средства
delete /v1.2/catalogs/trucks/{truckId}
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/catalogs/trucks/{truckId}' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Успешное удаление транспортного средства
boolean
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}

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

Версия
Получение водителей пользователя
get /v1.2/catalogs/drivers
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/catalogs/drivers' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Список водителей
[{...}]
driver_id: guid

Id водителя

first_name: string

Имя

second_name: string

Фамилия

patronymic: string

Отчество

phone:

Информация о номерe телефона водителя

ONE-OF
driver_license_number: string

Номер водительского удостоверения

driver_license_when_issued: date-time (nullable)

Когда выдано водительское удостоверение

passport_series: string

Серия паспорта

passport_number: string

Номер паспорта

passport_issued_by: string

Кем выдан

passport_when_issued: date-time

Когда выдан

registration: string

Прописка

is_attracted_driver: boolean

Флаг привлеченного водителя (со стороны)

related_id: guid (nullable)

Идентификатор связанного ТС, которое пользователь задал в кабинете

last_deal_related_id: guid (nullable)

Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки

description: string

Краткое описание водителя

attracted_from: string

Фирма от которой привлечен водитель.

date_of_birth: date-time (nullable)

Дата рождения

department_code_in_passport: string

Код подразделения

driver_inn: string

ИНН водителя

in_cargo_owner_black_list: boolean

Есть в Черном списке у запрашиваемого грузовладельца

external_id: string

Идентификатор

}]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}
Версия
Создание водителя
post /v1.2/catalogs/drivers
Запрос
Модель
{...}

Данные водителя

first_name: string

Имя

second_name: string

Фамилия

patronymic: string

Отчество

phone_number: string

Номер телефона

driver_license_number: string

Номер водительского удостоверения

driver_license_when_issued: date-time (nullable)

Когда выдано водительское удостоверение

passport_series: string

Серия паспорта

passport_number: string

Номер паспорта

passport_issued_by: string

Кем выдан паспорт

passport_when_issued: date-time

Когда выдан паспорт

registration: string

Адрес регистрации

is_attracted_driver: boolean

Флаг привлеченного водителя

attracted_from: string

Фирма, от которой привлечен водитель

date_of_birth: date-time (nullable)

Дата рождения

department_code_in_passport: string

Код подразделения

driver_inn: string

ИНН водителя

external_id: string

Идентификатор

}
Пример запроса 
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"}'
Ответ
200 Созданный водитель
{...}
driver_id: guid

Id водителя

first_name: string

Имя

second_name: string

Фамилия

patronymic: string

Отчество

phone:

Информация о номерe телефона водителя

ONE-OF
driver_license_number: string

Номер водительского удостоверения

driver_license_when_issued: date-time (nullable)

Когда выдано водительское удостоверение

passport_series: string

Серия паспорта

passport_number: string

Номер паспорта

passport_issued_by: string

Кем выдан

passport_when_issued: date-time

Когда выдан

registration: string

Прописка

is_attracted_driver: boolean

Флаг привлеченного водителя (со стороны)

related_id: guid (nullable)

Идентификатор связанного ТС, которое пользователь задал в кабинете

last_deal_related_id: guid (nullable)

Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки

description: string

Краткое описание водителя

attracted_from: string

Фирма от которой привлечен водитель.

date_of_birth: date-time (nullable)

Дата рождения

department_code_in_passport: string

Код подразделения

driver_inn: string

ИНН водителя

in_cargo_owner_black_list: boolean

Есть в Черном списке у запрашиваемого грузовладельца

external_id: string

Идентификатор

}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}
Версия
Получение водителя пользователя
get /v1.2/catalogs/drivers/{driverId}
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/catalogs/drivers/{driverId}' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Водитель
{...}
driver_id: guid

Id водителя

first_name: string

Имя

second_name: string

Фамилия

patronymic: string

Отчество

phone:

Информация о номерe телефона водителя

ONE-OF
driver_license_number: string

Номер водительского удостоверения

driver_license_when_issued: date-time (nullable)

Когда выдано водительское удостоверение

passport_series: string

Серия паспорта

passport_number: string

Номер паспорта

passport_issued_by: string

Кем выдан

passport_when_issued: date-time

Когда выдан

registration: string

Прописка

is_attracted_driver: boolean

Флаг привлеченного водителя (со стороны)

related_id: guid (nullable)

Идентификатор связанного ТС, которое пользователь задал в кабинете

last_deal_related_id: guid (nullable)

Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки

description: string

Краткое описание водителя

attracted_from: string

Фирма от которой привлечен водитель.

date_of_birth: date-time (nullable)

Дата рождения

department_code_in_passport: string

Код подразделения

driver_inn: string

ИНН водителя

in_cargo_owner_black_list: boolean

Есть в Черном списке у запрашиваемого грузовладельца

external_id: string

Идентификатор

}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}
Версия
Редактирование водителя
put /v1.2/catalogs/drivers/{driverId}
Запрос
Модель
{...}

Данные водителя

first_name: string

Имя

second_name: string

Фамилия

patronymic: string

Отчество

phone_number: string

Номер телефона

driver_license_number: string

Номер водительского удостоверения

driver_license_when_issued: date-time (nullable)

Когда выдано водительское удостоверение

passport_series: string

Серия паспорта

passport_number: string

Номер паспорта

passport_issued_by: string

Кем выдан паспорт

passport_when_issued: date-time

Когда выдан паспорт

registration: string

Адрес регистрации

is_attracted_driver: boolean

Флаг привлеченного водителя

attracted_from: string

Фирма, от которой привлечен водитель

date_of_birth: date-time (nullable)

Дата рождения

department_code_in_passport: string

Код подразделения

driver_inn: string

ИНН водителя

external_id: string

Идентификатор

}
Пример запроса 
curl 'https://api.ati.su/v1.2/catalogs/drivers/{driverId}' \
  -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"}'
Ответ
200 Отредактированный водитель
{...}
driver_id: guid

Id водителя

first_name: string

Имя

second_name: string

Фамилия

patronymic: string

Отчество

phone:

Информация о номерe телефона водителя

ONE-OF
driver_license_number: string

Номер водительского удостоверения

driver_license_when_issued: date-time (nullable)

Когда выдано водительское удостоверение

passport_series: string

Серия паспорта

passport_number: string

Номер паспорта

passport_issued_by: string

Кем выдан

passport_when_issued: date-time

Когда выдан

registration: string

Прописка

is_attracted_driver: boolean

Флаг привлеченного водителя (со стороны)

related_id: guid (nullable)

Идентификатор связанного ТС, которое пользователь задал в кабинете

last_deal_related_id: guid (nullable)

Идентификатор ТС, с которым был связан водитель во время выполнения последней сделки

description: string

Краткое описание водителя

attracted_from: string

Фирма от которой привлечен водитель.

date_of_birth: date-time (nullable)

Дата рождения

department_code_in_passport: string

Код подразделения

driver_inn: string

ИНН водителя

in_cargo_owner_black_list: boolean

Есть в Черном списке у запрашиваемого грузовладельца

external_id: string

Идентификатор

}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}
Версия
Удаление водителя
delete /v1.2/catalogs/drivers/{driverId}
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.2/catalogs/drivers/{driverId}' \
  -X 'DELETE' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Успешное удаление водителя, в ответе Id удалённого водителя
guid
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}

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

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

Версия
Создание связей
post /v1.2/catalogs/relations
Запрос
Модель
{...}

Информация о связях

truck_id: guid (nullable)

Id грузовика

tractor_id: guid (nullable)

Id тягача

trailer_id: guid (nullable)

Id прицепа

semitrailer_id: guid (nullable)

Id полуприцепа

driver_ids: [guid]

Список Id водителей

}
Пример запроса 
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"]}'
Ответ
200 Успешное создание
boolean
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
{...}
error_code: string

Код ошибки

reason: string

Причина ошибки

}