Skip to content
Для ИИ NEW Мои токены Поддержка
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя
For LLMs and AI agents: canonical Markdown source of this documentation page (plain-text .md — fetch this URL to use the page content in tools and RAG). For LLMs and AI agents: developers documentation index in llms.txt format — ordered list of key documentation URLs for the developers section.

Как оформить Заказ

Когда вы берете груз (после Торгов, из поиска или после получения персонального приглашения) вам нужно заполнить следующую информацию в заявке на перевозку:

  • водитель, назначенный на Заказ (опционально, может быть указан позже или не указан вообще);
  • транспортное средство (ТС), закрепленное за Заказом (опционально, может быть указан позже или не указан вообще);
  • ваши реквизиты для оформления сделки.
Взятие груза / Редактирование заказа. Взятие груза возможно в том случае, если пользователь является победителем торгов (аукциона), получил приглашение от грузовладельца или состоит на площадке, где опубликован груз.
post /v1.2/orders/takeload/{loadId}
Параметры
Параметр Тип Расположение Описание
loadId обязательный string (guid) path
Id груза Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
ONE-OF

(nullable)

Пример запроса
curl 'https://api.ati.su/v1.2/orders/takeload/{loadId}' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"rate_type":0,"vat_percent":7,"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","truck_info_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","semitrailer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","trailer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","requisites_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","signer_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","is_drop_docs":false,"deal_kind":0,"taker_note":"Комментарий"}'
Ответ
200 Успешное взятие/редактирование
Модель
{...}

Заказ с копией груза.

load_copy:

Копия груза.
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать

ONE-OF
deal:

Заказ.

Основная информация о заказе

ONE-OF

(nullable)

}
Пример
{...}
"load_copy":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"load_meta":{...},
"load_meta_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"meta_data":{}
},
"auction_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"updated_at":"2024-06-15T10:30:00Z",
"added_at":"2024-06-14T09:00:00Z",
"archive_date":"2024-06-15T12:00:00Z",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"parent_id":"9c514669-b666-42ea-85e6-312093b93a50",
"is_unpublished":true,
"firm_id":12345,
"contact_id1":100,
"contact_id2":101,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"тентованный, рефрижератор",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"boards":[...],
{...}
"board_id":"ati",
"name":"АТИ",
"color":"#FF6600"
}
],
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"deal":{...}
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_copy_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"load_id":"9c514669-b666-42ea-85e6-312093b93a50",
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"cargo_owner_ati_id":67890,
"cargo_owner_persistent_user_id":2002,
"updated_at":"2024-06-15T10:30:00Z",
"end_of_reservation":"2024-06-16T18:00:00Z",
"auction_id":"6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"active":true,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"money_type":1
},
"pay_docs":{...},
"documents_copies":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original_track":{...},
"transport_company_id":100,
"tracking_url":"https://files.ati.su/example",
"tracking_number":"RD123456789RU",
"sending_date":"2024-06-15T10:30:00Z"
},
"payment":{...}
"checked":true,
"date":"2024-06-15T10:30:00Z"
}
},
"files":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"storage_file_id":"file-abc-123",
"access":0,
"add_date":"2024-06-15T10:30:00Z",
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"file_name":"Накладная.pdf",
"size":102400,
"link":"https://files.ati.su/example",
"file_id":"file-abc-123",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"ул. Ленина, 1",
"templates":[...]
{...}
"add_date":"2024-06-15T10:30:00Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_firm_id":12345,
"cargoes_ids_hash":0,
"contact_id":100,
"file_name":"Заявка.pdf",
"file_id":"file-abc-123",
"id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"size":102400,
"link":"https://files.ati.su/example"
}
]
}
],
"customer":{...},
"ati_id":12345,
"source":0,
"name":"ООО Ромашка",
"ownership_id":1,
"inn":7707083893,
"ogrn":1027700132195,
"requisite":{...},
"name":"Основной счёт",
"bank":"ПАО Сбербанк",
"ks":30101810400000000000,
"registration_number":1481,
"rs":40702810938000000000,
"bik":9611925
},
"gen_director":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567"
},
"contact":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567",
"phone":"+74951234567",
"messenger_phone":"+79007654321",
"fax":"+74957654321",
"was_modified":false,
"selected_number":{...},
"value":"+79001234567",
"country_code":"RU"
},
"is_confirmed":true
},
"address":[...],
{...}
"is_legal":true,
"post_index":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house":1,
"entrance":2,
"litera":"А",
"office_no":10,
"recipient_full_name":"Иван Иванов",
"comment":"Комментарий",
"region_id":1
}
],
"claims_count":3,
"recommendation_count":12,
"bad_partner_firms_count":2
},
"is_tracking":true,
"should_show_rate_to_driver":true,
"started_at":"2024-06-15T08:00:00Z",
"finished_at":"2024-06-20T18:00:00Z",
"denial_reason":"Грузовладелец отклонил заказ",
"taker_requisites":{...},
"requisite_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"requisite_firm_name":"ООО Ромашка",
"signer_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"own_ship_id":1,
"inn":7707083893,
"kpp":770701001,
"requisite_type_id":1
},
"driver":{...},
"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"first_name":"Иван",
"second_name":"Иванов",
"patronymic":"Иванович",
"phone_number":"+79001234567",
"driver_license_number":"77АА123456",
"driver_license_when_issued":"2018-04-12T00:00:00Z",
"passport_series":4510,
"passport_number":123456,
"passport_issued_by":"ОВД г. Москвы",
"passport_when_issued":"2015-06-15T00:00:00Z",
"registration":"г. Москва",
"is_attracted_driver":false,
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"description":"Опыт 10 лет",
"attracted_from":"ООО Ромашка",
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0,
"date_of_birth":"1985-03-20T00:00:00Z",
"department_code_in_passport":"770-001",
"driver_inn":7707083893,
"in_cargo_owner_black_list":false,
"external_id":"ext-driver-1",
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"old_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"editor":12345,
"url":"https://files.ati.su/example",
"old_url":"https://files.ati.su/example",
"name":"Заявка",
"is_signed":true,
"access":0
},
"additional_documents":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"url":"https://files.ati.su/example",
"name":"Акт.pdf",
"is_signed":true,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"in_work_status":0,
"in_work_date":"2024-06-15T10:30:00Z",
"ati_id":12345,
"contact_id":100,
"tracker_phone":79001234567
},
"deal_note":"Просим уточнить время загрузки",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"ordinal_id":1,
"point_type":0,
"city_id":1,
"lat":55.75,
"lon":37.62,
"address":"ул. Ленина, 1",
"participant_name":"ООО Ромашка",
"region_id":1,
"contact_name":"Иван Иванов",
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock":{...},
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"note":"Въезд со двора",
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_warehouse_id":1001
},
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"ООО Ромашка",
"phone":"+79001234567",
"contact_persons":[...]
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

Чтобы получить ID имеющихся у вас водителей и ТС, воспользуйтесь методами, описанными в разделе «Справочники пользователя. Автопарк и водители».

Получить ID ваших реквизитов вам поможет метод получения реквизитов своей фирмы:

Метод получения реквизитов фирмы
get /v1.0/firms/requisites
Параметры
Параметр Тип Расположение Описание
atiId string query
Код фирмы в ATI.SU Пример: string
withShortRequisite boolean query
С короткими реквизитами Пример: false
Запрос
Пример запроса
curl 'https://api.ati.su/v1.0/firms/requisites' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Success
Модель
[{...}]
requisite_id: uuid

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

ati_id: string (nullable)

Код в ATI.SU фирмы

requisite_type_id: int32

Тип реквизита

requisite_name: string (nullable)

Название реквизита

legal_name: string (nullable)

Юридическое именование фирмы

own_ship_id: int32

Идентификатор формы собственности

fio: string (nullable)

ФИО владельца

inn: string (nullable)

ИНН

ogrn: string (nullable)

ОГРН, для реквизитов в валюте (USD и EUR) в этом поле храниться VAT

phone: string (nullable)

Телефон

fax: string (nullable)

Факс

email: string (nullable)

Электронный адрес

kpp: string (nullable)

КПП

rs: string (nullable)

Расчетный счет

ks: string (nullable)

КС

bik: string (nullable)

БИК

bank: string (nullable)

Наименование банка

codes: string (nullable)

Коды

is_read_only: boolean

Реквизиты только для чтения

okpo: string (nullable)

ОКПО

is_vat_payer: boolean

Плательщик НДС

last_use_date: date-time (nullable)

Дата последнего использования в системе

is_active: boolean

Активный реквизит

is_visible: boolean

Будет ли виден реквизит пользователю в будущем
Нужен для одноразовых реквизитов, например, при создании счета с оплатой по банковской карте (там создается реквизит из пары полей)

legal_address_id: uuid

Идентификатор юридического адреса в системе

post_address_id: uuid

Идентификатор почтового адреса в системе

available_in_ati_docs: boolean

Доступно в АТИ Доках

read only
}]
Пример
[...]
{...}
"requisite_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ati_id":"string",
"requisite_type_id":0,
"requisite_name":"string",
"legal_name":"string",
"own_ship_id":0,
"fio":"string",
"inn":"string",
"ogrn":"string",
"phone":"string",
"fax":"string",
"email":"string",
"kpp":"string",
"rs":"string",
"ks":"string",
"bik":"string",
"bank":"string",
"codes":"string",
"is_read_only":false,
"okpo":"string",
"is_vat_payer":false,
"last_use_date":"1970-01-01T00:00:00.000Z",
"is_active":true,
"is_visible":true,
"legal_address":{...},
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ati_id":"string",
"country_id":0,
"region_id":0,
"city_id":0,
"city_name":"string",
"post_index":"string",
"street_type_id":0,
"street_name":"string",
"house_no":"string",
"part_no":"string",
"litera":"string",
"office_no":"string",
"post_contact":"string",
"add_date":"1970-01-01T00:00:00.000Z",
"attributes":0,
"send_type_id":0,
"note":"string",
"formatted_text":"string",
"is_post_address":false,
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"fias_level":0
},
"post_address":{...},
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ati_id":"string",
"country_id":0,
"region_id":0,
"city_id":0,
"city_name":"string",
"post_index":"string",
"street_type_id":0,
"street_name":"string",
"house_no":"string",
"part_no":"string",
"litera":"string",
"office_no":"string",
"post_contact":"string",
"add_date":"1970-01-01T00:00:00.000Z",
"attributes":0,
"send_type_id":0,
"note":"string",
"formatted_text":"string",
"is_post_address":false,
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"fias_level":0
},
"legal_address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"post_address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"signees":[...],
{...}
"signee_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"requisite_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"full_name":"string",
"position":"string",
"act_upon":"string",
"is_default":false,
"deletion_date":"1970-01-01T00:00:00.000Z",
"full_name_and_position":"string"
}
],
"person_passport":{...}
"series":"string",
"number":"string",
"date_of_issue":"1970-01-01T00:00:00.000Z",
"department_code":"string",
"issued_by":"string",
"registration":"string",
"scan_files":[...]
{...}
"link":"string",
"id":"string",
"size":0,
"name":"string"
}
]
}
}
]
400 Bad Request
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
401 Unauthorized
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
402 Client Error
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
403 Forbidden
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
404 Not Found
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
500 Server Error
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}
504 Server Error
Модель
{...}
error: string (nullable)
reason: string (nullable)
}
Пример
{...}
"error":"string",
"reason":"string"
}

После того, как вы заполните данные и возьмете груз, ваша заявка будет отправлена грузовладельцу на рассмотрение. Отследить статус Заказа можно с помощью метода получения статусов Заказа:

Получение статусов заказов. Позволяет получить список статусов заказов для указанных грузов
post /v1.2/orders/get_orders_statuses
Параметры
Параметров нет
Запрос
Модель
[guid]
Пример запроса
curl 'https://api.ati.su/v1.2/orders/get_orders_statuses' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '["3fa85f64-5717-4562-b3fc-2c963f66afa6"]'
Ответ
200 Возвращает объект _Id груза - список статусов связанных заказов_
Модель
{...}
}
Пример
{...}
"any-key":[...]
{...}
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"status":0,
"deal_kind":0,
"inwork_status":0,
"tracker_offer_status":0,
"status_change_date_time":"2024-06-15T10:30:00Z"
}
]
}

Для получения более детальной информации по Заказу, воспользуйтесь методом получения информации по Заказу:

Получение информации по заказу. Позволяет получить заказ, в котором пользователь принимает участие
get /v1.2/orders/{dealId}
Параметры
Параметр Тип Расположение Описание
dealId обязательный string (guid) path
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/{dealId}' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Возвращает информацию по заказу
Модель
{...}

Заказ с копией груза.

load_copy:

Копия груза.
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать

ONE-OF
deal:

Заказ.

Основная информация о заказе

ONE-OF

(nullable)

}
Пример
{...}
"load_copy":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"load_meta":{...},
"load_meta_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"meta_data":{}
},
"auction_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"updated_at":"2024-06-15T10:30:00Z",
"added_at":"2024-06-14T09:00:00Z",
"archive_date":"2024-06-15T12:00:00Z",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"parent_id":"9c514669-b666-42ea-85e6-312093b93a50",
"is_unpublished":true,
"firm_id":12345,
"contact_id1":100,
"contact_id2":101,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"тентованный, рефрижератор",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"boards":[...],
{...}
"board_id":"ati",
"name":"АТИ",
"color":"#FF6600"
}
],
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"deal":{...}
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_copy_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"load_id":"9c514669-b666-42ea-85e6-312093b93a50",
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"cargo_owner_ati_id":67890,
"cargo_owner_persistent_user_id":2002,
"updated_at":"2024-06-15T10:30:00Z",
"end_of_reservation":"2024-06-16T18:00:00Z",
"auction_id":"6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"active":true,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"money_type":1
},
"pay_docs":{...},
"documents_copies":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original_track":{...},
"transport_company_id":100,
"tracking_url":"https://files.ati.su/example",
"tracking_number":"RD123456789RU",
"sending_date":"2024-06-15T10:30:00Z"
},
"payment":{...}
"checked":true,
"date":"2024-06-15T10:30:00Z"
}
},
"files":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"storage_file_id":"file-abc-123",
"access":0,
"add_date":"2024-06-15T10:30:00Z",
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"file_name":"Накладная.pdf",
"size":102400,
"link":"https://files.ati.su/example",
"file_id":"file-abc-123",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"ул. Ленина, 1",
"templates":[...]
{...}
"add_date":"2024-06-15T10:30:00Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_firm_id":12345,
"cargoes_ids_hash":0,
"contact_id":100,
"file_name":"Заявка.pdf",
"file_id":"file-abc-123",
"id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"size":102400,
"link":"https://files.ati.su/example"
}
]
}
],
"customer":{...},
"ati_id":12345,
"source":0,
"name":"ООО Ромашка",
"ownership_id":1,
"inn":7707083893,
"ogrn":1027700132195,
"requisite":{...},
"name":"Основной счёт",
"bank":"ПАО Сбербанк",
"ks":30101810400000000000,
"registration_number":1481,
"rs":40702810938000000000,
"bik":9611925
},
"gen_director":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567"
},
"contact":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567",
"phone":"+74951234567",
"messenger_phone":"+79007654321",
"fax":"+74957654321",
"was_modified":false,
"selected_number":{...},
"value":"+79001234567",
"country_code":"RU"
},
"is_confirmed":true
},
"address":[...],
{...}
"is_legal":true,
"post_index":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house":1,
"entrance":2,
"litera":"А",
"office_no":10,
"recipient_full_name":"Иван Иванов",
"comment":"Комментарий",
"region_id":1
}
],
"claims_count":3,
"recommendation_count":12,
"bad_partner_firms_count":2
},
"is_tracking":true,
"should_show_rate_to_driver":true,
"started_at":"2024-06-15T08:00:00Z",
"finished_at":"2024-06-20T18:00:00Z",
"denial_reason":"Грузовладелец отклонил заказ",
"taker_requisites":{...},
"requisite_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"requisite_firm_name":"ООО Ромашка",
"signer_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"own_ship_id":1,
"inn":7707083893,
"kpp":770701001,
"requisite_type_id":1
},
"driver":{...},
"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"first_name":"Иван",
"second_name":"Иванов",
"patronymic":"Иванович",
"phone_number":"+79001234567",
"driver_license_number":"77АА123456",
"driver_license_when_issued":"2018-04-12T00:00:00Z",
"passport_series":4510,
"passport_number":123456,
"passport_issued_by":"ОВД г. Москвы",
"passport_when_issued":"2015-06-15T00:00:00Z",
"registration":"г. Москва",
"is_attracted_driver":false,
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"description":"Опыт 10 лет",
"attracted_from":"ООО Ромашка",
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0,
"date_of_birth":"1985-03-20T00:00:00Z",
"department_code_in_passport":"770-001",
"driver_inn":7707083893,
"in_cargo_owner_black_list":false,
"external_id":"ext-driver-1",
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"old_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"editor":12345,
"url":"https://files.ati.su/example",
"old_url":"https://files.ati.su/example",
"name":"Заявка",
"is_signed":true,
"access":0
},
"additional_documents":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"url":"https://files.ati.su/example",
"name":"Акт.pdf",
"is_signed":true,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"in_work_status":0,
"in_work_date":"2024-06-15T10:30:00Z",
"ati_id":12345,
"contact_id":100,
"tracker_phone":79001234567
},
"deal_note":"Просим уточнить время загрузки",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"ordinal_id":1,
"point_type":0,
"city_id":1,
"lat":55.75,
"lon":37.62,
"address":"ул. Ленина, 1",
"participant_name":"ООО Ромашка",
"region_id":1,
"contact_name":"Иван Иванов",
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock":{...},
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"note":"Въезд со двора",
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_warehouse_id":1001
},
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"ООО Ромашка",
"phone":"+79001234567",
"contact_persons":[...]
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

Если грузовладельца устроит ваше предложение, он сможет оформить сделку одним из указанных ниже способов:

  • с использованием сервиса «АТИ-Доки» - документооборот будет вестись через ATI.SU. Грузовладелец сформирует документ на перевозку и отправит его вам на согласование. Узнать ID полученного документа можно с помощью метода получения информации по Заказу - данная информация появится в структуре document. Для того, чтобы одобрить документ с вашей стороны, воспользуйтесь методом одобрения документа. После того, как вы одобрите документ, Заказ будет переведен в исполнение. При необходимости документ на перевозку может быть подписан с помощью электронной цифровой подписи.
Получение информации по заказу. Позволяет получить заказ, в котором пользователь принимает участие
get /v1.2/orders/{dealId}
Параметры
Параметр Тип Расположение Описание
dealId обязательный string (guid) path
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/{dealId}' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Возвращает информацию по заказу
Модель
{...}

Заказ с копией груза.

load_copy:

Копия груза.
При создании заказа груз копируется, копия не отображается в поиске и её невозможно отредактировать

ONE-OF
deal:

Заказ.

Основная информация о заказе

ONE-OF

(nullable)

}
Пример
{...}
"load_copy":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_number":"ATI00012345",
"load_meta":{...},
"load_meta_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"meta_data":{}
},
"auction_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"updated_at":"2024-06-15T10:30:00Z",
"added_at":"2024-06-14T09:00:00Z",
"archive_date":"2024-06-15T12:00:00Z",
"distance":720,
"distance_type":1,
"platon_roads_length":120,
"toll_roads_length":80,
"travel_time":"08:30:00",
"true_price":80000,
"true_currency_id":1,
"parent_id":"9c514669-b666-42ea-85e6-312093b93a50",
"is_unpublished":true,
"firm_id":12345,
"contact_id1":100,
"contact_id2":101,
"note":"Тент, боковая загрузка",
"first_date":"2024-06-16T00:00:00Z",
"last_date":"2024-06-18T00:00:00Z",
"date_type":0,
"periodicity_id":0,
"order_number":"ЗН-15",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"extra_points":[...],
{...}
"route_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"point_type":0,
"ordinal_id":1,
"distance":120,
"street":"ул. Ленина, 1",
"latitude":55.7558,
"longitude":37.6173,
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"loading_date_start":"2024-06-15T00:00:00Z",
"loading_date_end":"2024-06-15T00:00:00Z",
"loading_time_start":"08:00:00",
"loading_time_end":"18:00:00",
"is_round_the_clock":false,
"city_name":"Москва",
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":1,
"weight":20,
"volume":40,
"packaging_quantity":10,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
}
],
"unloading":{...},
"fias_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"city_id":1,
"latitude":55.7558,
"longitude":37.6173,
"street":"ул. Ленина, 1",
"organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"address_id":"9c514669-b666-42ea-85e6-312093b93a50",
"time_start":"2024-06-15T08:00:00Z",
"time_end":"2024-06-15T18:00:00Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":1,
"distance":15.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":1,
"name_id":59,
"name":"Щебень",
"packaging_type":1,
"packaging_quantity":10,
"weight":20,
"volume":40,
"sizes":{...},
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"коробки"
}
],
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"firm_id":12345,
"name":"ООО Ромашка",
"ownership":1,
"residency":0,
"inn":7707083893,
"phone":"+79001234567",
"extra_phone":123,
"docs_address":{...},
"postcode":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house_no":1,
"office_no":10
},
"stocks":[...],
{...}
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"address_latitude":55.7558,
"address_longitude":37.6173,
"note":"Въезд со двора",
"work_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"day_of_week":0,
"start_time":"09:00:00",
"end_time":"18:00:00"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":1001,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com",
"extra_phone":123
}
],
"ownership_name":"ООО"
}
},
"cargo":{...},
"weight":20,
"volume":40,
"adr":0,
"cargo_type_id":1,
"cargo_type":"Щебень",
"pack_type":1,
"pallet_count":11,
"belt_count":6,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":13.6,
"width":2.45,
"height":2.7,
"diameter":0,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":200,
"car_type_string":"тентованный, рефрижератор",
"loading_type":0,
"loading_logical_operator":"OR",
"unloading_type":0,
"unloading_logical_operator":"OR",
"trucks_quantity":1,
"temperature_from":-18,
"temperature_to":-10,
"truck_attribs":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"sanitation_logbook":false,
"is_tracking":true,
"required_capacity":20,
"team_driving":false
},
"boards":[...],
{...}
"board_id":"ati",
"name":"АТИ",
"color":"#FF6600"
}
],
"unload_first_date":"2024-06-17T00:00:00Z",
"unload_last_date":"2024-06-19T00:00:00Z"
},
"deal":{...}
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"load_copy_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"load_id":"9c514669-b666-42ea-85e6-312093b93a50",
"taker_ati_id":12345,
"taker_persistent_user_id":1001,
"taker_contact_id":100,
"cargo_owner_ati_id":67890,
"cargo_owner_persistent_user_id":2002,
"updated_at":"2024-06-15T10:30:00Z",
"end_of_reservation":"2024-06-16T18:00:00Z",
"auction_id":"6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":45000,
"rate_type":0,
"currency":1,
"active":true,
"vat_percent":22
}
],
"prepay_percent":30,
"prepay_percent_enabled":true,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":true,
"pay_days":5,
"fixed_rate":true,
"torg":false,
"direct_contract":true,
"money_type":1
},
"pay_docs":{...},
"documents_copies":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original":{...},
"checked":true,
"date":"2024-06-15T10:30:00Z"
},
"documents_original_track":{...},
"transport_company_id":100,
"tracking_url":"https://files.ati.su/example",
"tracking_number":"RD123456789RU",
"sending_date":"2024-06-15T10:30:00Z"
},
"payment":{...}
"checked":true,
"date":"2024-06-15T10:30:00Z"
}
},
"files":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"storage_file_id":"file-abc-123",
"access":0,
"add_date":"2024-06-15T10:30:00Z",
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"file_name":"Накладная.pdf",
"size":102400,
"link":"https://files.ati.su/example",
"file_id":"file-abc-123",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"ул. Ленина, 1",
"templates":[...]
{...}
"add_date":"2024-06-15T10:30:00Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_firm_id":12345,
"cargoes_ids_hash":0,
"contact_id":100,
"file_name":"Заявка.pdf",
"file_id":"file-abc-123",
"id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"size":102400,
"link":"https://files.ati.su/example"
}
]
}
],
"customer":{...},
"ati_id":12345,
"source":0,
"name":"ООО Ромашка",
"ownership_id":1,
"inn":7707083893,
"ogrn":1027700132195,
"requisite":{...},
"name":"Основной счёт",
"bank":"ПАО Сбербанк",
"ks":30101810400000000000,
"registration_number":1481,
"rs":40702810938000000000,
"bik":9611925
},
"gen_director":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567"
},
"contact":{...},
"name":"Иван",
"surname":"Иванов",
"patronymic":"Иванович",
"number_phone":"+79001234567",
"phone":"+74951234567",
"messenger_phone":"+79007654321",
"fax":"+74957654321",
"was_modified":false,
"selected_number":{...},
"value":"+79001234567",
"country_code":"RU"
},
"is_confirmed":true
},
"address":[...],
{...}
"is_legal":true,
"post_index":101000,
"city_id":1,
"street_name":"ул. Ленина",
"house":1,
"entrance":2,
"litera":"А",
"office_no":10,
"recipient_full_name":"Иван Иванов",
"comment":"Комментарий",
"region_id":1
}
],
"claims_count":3,
"recommendation_count":12,
"bad_partner_firms_count":2
},
"is_tracking":true,
"should_show_rate_to_driver":true,
"started_at":"2024-06-15T08:00:00Z",
"finished_at":"2024-06-20T18:00:00Z",
"denial_reason":"Грузовладелец отклонил заказ",
"taker_requisites":{...},
"requisite_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"requisite_firm_name":"ООО Ромашка",
"signer_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"own_ship_id":1,
"inn":7707083893,
"kpp":770701001,
"requisite_type_id":1
},
"driver":{...},
"driver_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"first_name":"Иван",
"second_name":"Иванов",
"patronymic":"Иванович",
"phone_number":"+79001234567",
"driver_license_number":"77АА123456",
"driver_license_when_issued":"2018-04-12T00:00:00Z",
"passport_series":4510,
"passport_number":123456,
"passport_issued_by":"ОВД г. Москвы",
"passport_when_issued":"2015-06-15T00:00:00Z",
"registration":"г. Москва",
"is_attracted_driver":false,
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"description":"Опыт 10 лет",
"attracted_from":"ООО Ромашка",
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0,
"date_of_birth":"1985-03-20T00:00:00Z",
"department_code_in_passport":"770-001",
"driver_inn":7707083893,
"in_cargo_owner_black_list":false,
"external_id":"ext-driver-1",
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"parent_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"last_deal_related_id":"9c514669-b666-42ea-85e6-312093b93a50",
"type":0,
"description":"Тент 82 м³",
"brand_id":1,
"model":"Actros",
"number":"А123ВС77",
"phone_number":"+79001234567",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":200,
"capacity":20,
"volume":82,
"length":13.6,
"width":2.45,
"height":2.7,
"manufacture_year":2020,
"vin":"WDB9340321L123456",
"vrc":"77АА123456",
"body_number":123456,
"dimension":40,
"truck_passport_number":"77ТТ123456",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"ООО Ромашка",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"external_id":"ext-truck-1",
"verified":true,
"modification_restricted":false,
"scans":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"owner_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name":"ПТС.pdf",
"file_id":"file-abc-123",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"old_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7",
"editor":12345,
"url":"https://files.ati.su/example",
"old_url":"https://files.ati.su/example",
"name":"Заявка",
"is_signed":true,
"access":0
},
"additional_documents":[...],
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"is_counterparty_file":false,
"url":"https://files.ati.su/example",
"name":"Акт.pdf",
"is_signed":true,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"in_work_status":0,
"in_work_date":"2024-06-15T10:30:00Z",
"ati_id":12345,
"contact_id":100,
"tracker_phone":79001234567
},
"deal_note":"Просим уточнить время загрузки",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"ordinal_id":1,
"point_type":0,
"city_id":1,
"lat":55.75,
"lon":37.62,
"address":"ул. Ленина, 1",
"participant_name":"ООО Ромашка",
"region_id":1,
"contact_name":"Иван Иванов",
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"stock":{...},
"stock_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"address":"ул. Ленина, 1",
"address_city_id":1,
"note":"Въезд со двора",
"contact_persons":[...],
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
],
"schedule_summary":"пн–пт 09:00–18:00",
"stock_type":0,
"timeslots_warehouse_id":1001
},
"organization":{...}
"organization_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"ООО Ромашка",
"phone":"+79001234567",
"contact_persons":[...]
{...}
"contact_person_id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"name":"Иван Иванов",
"phone":"+79001234567",
"email":"driver@example.com"
}
]
}
}
]
}
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}
Одобрить документ После одобрения документ перемещается в папку "Одобренные". Одобрить можно только документ, ожидающий решения.
put /documents/{doc_id}/approve/
Параметры
Параметр Тип Расположение Описание
doc_id обязательный string path
Идентификатор документа Пример: string
Запрос
Пример запроса
curl 'https://api.ati.su/documents/{doc_id}/approve/' \
-X 'PUT' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Результат запроса
Модель
{...}

Результат сохранения документа

ok: enum
[true]
result: string

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

}
Пример
{...}
"ok":true,
"result":"12345676554321"
}
400 Ошибка запроса, документ не может быть одобрен.
Модель
{...}

Сообщение об ошибке

error*: string (nullable)

Код ошибки

reason*: string

Описание ошибки и возможная причина

}
Пример
{...}
"error":"bad_request",
"reason":"Ошибка в запросе"
}

Полная документация API АТИ-Доков.

  • без использования «АТИ-Доков» - как только Заказ будет одобрен грузовладельцем, он будет переведен в исполнение.

После того, как водитель подтвердит получение Заказа в приложении, вы сможете отслеживать пройденный водителем маршрут и получать историю событий, произошедших в пути следования водителя.

Получение информации о пройденном маршруте АТИ Водителя. Возвращает информацию о маршруте, пройденном водителем с использованием приложения, а также о начальной, конечной и промежуточных точках маршрута. Ответ метода можно использовать, например, для отображения маршрута на карте.
get /v1.2/orders/carrier/map_route/by_deal
Параметры
Параметр Тип Расположение Описание
deal_id string (guid) query
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
south_west_lat number (double) query
Широта юго-запад Пример: 55.7558
south_west_lng number (double) query
Долгота юго-запад Пример: 37.6173
north_east_lat number (double) query
Широта северо-восток Пример: 55.8321
north_east_lng number (double) query
Долгота северо-восток Пример: 37.7356
zoom number (double) query
Коэффициент масштабирования Пример: 12
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/carrier/map_route/by_deal' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Информация для карты
Модель
[{...}]

Карта перевозки заказа.

}]
Пример
[...]
{...}
"goals":[...],
{...}
"longitude":37.6173,
"latitude":55.7558,
"events":[...],
{...}
"type":0,
"tag":"in_work",
"date":"2024-06-15T10:30:00Z",
"date_to":"2024-06-15T11:00:00Z",
"time":"10:30",
"time_to":"11:00",
"location_name":{...}
"country":"Россия",
"region":"Московская область",
"city":"Москва",
"address":"ул. Ленина, 1"
}
}
],
"ordinal_id":1,
"trace":true
}
],
"traces":[...]
{...}
"car":{...},
"driver_phone":"+79001234567",
"car_status":0
},
"first_action":"2024-06-15T10:00:00Z",
"last_action":"2024-06-15T18:00:00Z",
"points":[...]
{...}
"longitude":37.6173,
"latitude":55.7558,
"events":[...],
{...}
"type":0,
"tag":"in_work",
"date":"2024-06-15T10:30:00Z",
"date_to":"2024-06-15T11:00:00Z",
"time":"10:30",
"time_to":"11:00",
"location_name":{...}
"country":"Россия",
"region":"Московская область",
"city":"Москва",
"address":"ул. Ленина, 1"
}
}
],
"location_date":"2024-06-15T10:30:00Z",
"is_fake":false,
"is_disabled":false,
"is_no_data":false,
"is_power_saving":false,
"is_empty_run":false,
"is_parking":false
}
]
}
]
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}
Получение истории. Массив событий, произошедших в пути следования водителя. Например: поломка, ДТП.
get /v1.2/orders/carrier/map/history
Параметры
Параметр Тип Расположение Описание
deal_id string (guid) query
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/carrier/map/history' \
-X 'GET' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 История выполнения заказа водителем
Модель
[{...}]

История движения по карте.

}]
Пример
[...]
{...}
"events":[...]
{...}
"date":"2024-06-15T10:30:00Z",
"event":{...},
"type":0,
"tag":"in_work",
"date":"2024-06-15T10:30:00Z",
"date_to":"2024-06-15T11:00:00Z",
"time":"10:30",
"time_to":"11:00",
"location_name":{...}
"country":"Россия",
"region":"Московская область",
"city":"Москва",
"address":"ул. Ленина, 1"
}
},
"longitude":37.6173,
"latitude":55.7558,
"params":[...]
"string"
]
}
]
}
]
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

Подробнее о методах для работы с Заказами с участием приоложения «АТИ Водитель» описано тут.

Заказу, находящемуся в исполнении, могут быть присвоены различные статусы: едет на загрузку, ожидает загрузку, загружается и т. д. Для того, чтобы изменить статусы перевозки, воспользуйтесь методом смены статусов перевозки Заказа. Статусы можете менять как вы, так и грузовладелец.

Смена cтатуса перевозки заказа. Позволяет установить статус перевозки для заказа. Требуется DealState заказа `4`. Установить статус может как грузовладелец так и перевозчик.
post /v1.2/orders/{dealId}/inwork
Параметры
Параметр Тип Расположение Описание
dealId обязательный string (guid) path
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
ONE-OF

(nullable)

Пример запроса
curl 'https://api.ati.su/v1.2/orders/{dealId}/inwork' \
-X 'POST' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json' \
--data-raw '{"in_work_status":0}'
Ответ
200 Успешное изменение статуса
Успешный ответ
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

После того, как Заказ будет выполнен, его можно завершить.

Завершение перевозки. Завершает перевозку *Завершить перевозку можно в том случае, если DealState заказа `4`*
put /v1.2/orders/{dealId}/finish
Параметры
Параметр Тип Расположение Описание
dealId обязательный string (guid) path
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
waitPayment boolean query
При выставлении этого флага заказ переносится на вкладку "ДО и Оплата" Пример: false
Запрос
Пример запроса
curl 'https://api.ati.su/v1.2/orders/{dealId}/finish' \
-X 'PUT' \
-H 'Authorization: Bearer {authorizationToken}' \
-H 'Content-Type: application/json'
Ответ
200 Успешное завершение
Успешный ответ
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}

Полная документация API Заказов.