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

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"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

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"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

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"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

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

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

Код ошибки

reason: string

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"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

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"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

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"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

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"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

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"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
Пример
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
{...}
error_code: string

Код ошибки

reason: string

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

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

Код ошибки

reason: string

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

}
Пример
{...}
"error_code":"string",
"reason":"string"
}