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

OpenAPI · Markdown

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

После того, как вы добавили груз, отслеживайте его состояние:

Получение статусов заказов. Позволяет получить список статусов заказов для указанных грузов
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"
}

Из нее вы можете получить ID перевозчика, взявшего груз.

Зная ID перевозчика, можно:

  1. получить информацию о фирме - название фирмы, профиль деятельности, количество звезд, рекомендаций, претензий и т.д.:
Получение краткой информации по фирме (по идентификатору)
get /v1.0/firms/summary/{atiId}
Параметры
Параметр Тип Расположение Описание
atiId обязательный string path
Идентификатор фирмы Пример: string
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.0/firms/summary/{atiId}' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
Ответ
200 Success
Модель
{...}
ati_id: string (nullable)

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

brand: string (nullable)

Брэнд фирмы

ownership: string (nullable)

Организационно-правовая форма фирмы

full_name: string (nullable)

Полное имя фирмы: Брэнд (Название фирмы, ОПФ)

firm_name: string (nullable)

Название фирмы

address: string (nullable)

Адрес фирмы

web_site: string (nullable)

Сайт фирмы

position_in_city: int32 (nullable)

Место в рэйтинге по городу

position_in_country: int32 (nullable)

Место в рэйтинге по стране

name_eng: string (nullable)

Интернациональное название фирмы

firm_type: string (nullable)

Профиль деятельности фирмы

firm_type_id_int: int32

Идентификатор профиля деятельности

firm_type_id: string (nullable)

(Устаревшее) Идентификатор профиля деятельности строкой

predicted_firm_type_id: int32 (nullable)

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

info_reference: string (nullable)

Ссылка на карточку фирмы

passport_reference: string (nullable)

Ссылка на паспорт фирмы

city: string (nullable)

Город, в котором расположена фирма

score: double

Количество звезд фирмы. Если число отрицательно, то это красные звезды

bad_partner_mentions_count: int32

Количество упоминаний на форуме недобросовестных партнеров

claims_count: int32

Количество претензий от фирм

language: string (nullable)

Язык фирмы

recommendations_count: int32

Количество рекомендаций от фирм

inn: string (nullable)

Инн

ogrn: string (nullable)

ОГРН

kpp: string (nullable)

Код причины постановки на учет фирмы

okpo: string (nullable)

Общероссийский классификатор предприятий и организаций

negative_points_sum: double

Сумма отрицательных баллов

tf_firm_color: string (nullable)

Цвет фирмы в светофоре

tf_account_color: string (nullable)

Цвет аккаунта в светофоре

tf_has_signals: boolean

Флаг о существовании любой информации о фирме в светофоре

registration_date: date-time

Дата регистрации на сайте, которая AddDate из firms.

contact_info_changed: date-time

Дата последних изменений в истории фирмы.

deletion_date: date-time (nullable)

Дата удаления фирмы.

last_month_active_days: int32

Число дней со входами на сайт за последние 30 дней.

verified_trucks: int32

Количеством зарегистрированных ТС

}
Пример
{...}
"ati_id":"string",
"brand":"string",
"ownership":"string",
"full_name":"string",
"firm_name":"string",
"location":{...},
"city_id":0,
"region_id":0,
"country_id":0,
"city_size":0,
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"attributes":0,
"city_name":"string",
"region_name":"string",
"country_name":"string",
"country_code_name":"string"
},
"address":"string",
"web_site":"string",
"position_in_city":0,
"position_in_country":0,
"name_eng":"string",
"firm_type":"string",
"firm_type_id_int":0,
"firm_type_id":"string",
"predicted_firm_type_id":0,
"info_reference":"string",
"passport_reference":"string",
"city":"string",
"score":0.5,
"bad_partner_mentions_count":0,
"claims_count":0,
"language":"string",
"recommendations_count":0,
"inn":"string",
"ogrn":"string",
"kpp":"string",
"okpo":"string",
"affiliated_firms":[...],
{...}
"firm_name":"string",
"inn":"string",
"tf_firm_color":"string",
"tf_has_signals":false
}
],
"negative_points_sum":0.5,
"tf_firm_color":"string",
"tf_account_color":"string",
"tf_has_signals":false,
"registration_date":"1970-01-01T00:00:00.000Z",
"contact_info_changed":"1970-01-01T00:00:00.000Z",
"deletion_date":"1970-01-01T00:00:00.000Z",
"last_month_active_days":0,
"firm_documents":[...],
{...}
"link":"string",
"description":"string",
"creation_date":"1970-01-01T00:00:00.000Z",
"name":"string",
"type_id":0
}
],
"verified_trucks":0
}
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"
}
  1. получить реквизиты фирмы:
Метод получения реквизитов фирмы
get /v1.0/firms/{atiId}/requisites
Параметры
Параметр Тип Расположение Описание
atiId обязательный string path
Код фирмы в ATI.SU Пример: string
withShortRequisite boolean query
С короткими реквизитами Пример: false
Запрос
Пример запроса 
curl 'https://api.ati.su/v1.0/firms/{atiId}/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"
}

Данные позволят вам сформировать представление о фирме и понять, хотите ли вы доверить ей свой груз или нет.

Если по какой-то причине вас не устроит предложение перевозчика или сам перевозчик, то вы можете отклонить его заявку на перевозку груза.

Отклонение заказа с выбором действия. Грузовладелец может отклонить заказ в согласовании, в том числе с созданными документами через АТИ-Доки. При отклонении заказа можно выбрать, что сделать с грузом: 1= выставить груз без торгов, 2 = перенести груз в Архив. 3 = сменить победителя, если в торгах были еще участники 4 = восстановить груз и перезапустить торги, если они были запущены
delete /v1.2/orders/{dealId}/decline
Параметры
Параметр Тип Расположение Описание
dealId обязательный string (guid) path
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
ONE-OF

(nullable)

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

(nullable)

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

Если вас все устроит, вы сможете оформить с перевозчиком Заказ. Заказ может быть оформлен следующими способами:

  1. С использованием сервиса “АТИ-Доки”. Документооборот будет вестись через ATI.SU. При этом Заказ на сайте ATI.SU будет переведен в исполнение только после того, как документ на перевозку будет одобрен второй стороной — перевозчиком. При необходимости документ может быть подписан с помощью электронной цифровой подписи.
Создание заказа с документом через АТИ-Доки. Позволяет создать заказ с документом через АТИ-Доки
post /v1.2/orders/{dealId}/accept
Параметры
Параметр Тип Расположение Описание
dealId обязательный string (guid) path
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
ONE-OF

(nullable)

Пример запроса 
curl 'https://api.ati.su/v1.2/orders/{dealId}/accept' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"template_id":"tmpl-123","document_type":"заказ","requisite_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","signer_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7","contract_number":"Д-2024/15","contract_start_date":"2024-01-01T00:00:00Z","point_ids":[{"deal_point_id":"2fb965f2-85e9-4213-90e7-f396e47219e7","organization_id":"7c9e6679-7425-40de-944b-e07fc1f90ae7","contact_person_id":"9c514669-b666-42ea-85e6-312093b93a50","address_id":"6ba7b810-9dad-11d1-80b4-00c04fd430c8"}]}'
Ответ
200 Параметры ссылки для открытия заказа в АТИ-Доках
Модель
{...}

Параметры ссылки для открытия заказа в АТИ-Доках.

id: string

Id документа.

url: string

Url документа.

is_signed: boolean

Подписан ли документ.

}
Пример
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"url":"https://docs.ati.su/example",
"is_signed":true
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

Пример
{...}
"reason":"Неизвестная ошибка",
"error":"unknown_server_error"
}
Создание заказа с документом через загрузку файла. Позволяет создать заказ с документом через загрузку файла, содержащего информацию о заказе (адреса, контакты, сроки, стоимость перевозки, условия и др.) Content-Type: multipart/form-data
post /v1.2/orders/{dealId}/accept_file
Параметры
Параметр Тип Расположение Описание
dealId обязательный string (guid) path
Id заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
{...}
document_type: string (nullable)
requisite_id: guid (nullable)
signer_id: guid (nullable)
contract_number: string (nullable)
contract_start_date: date-time (nullable)
attachment: binary (nullable)
}
Пример запроса 
curl 'https://api.ati.su/v1.2/orders/{dealId}/accept_file' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: multipart/form-data' \
  -F 'document_type={document_type}' \
  -F 'requisite_id={requisite_id}' \
  -F 'signer_id={signer_id}' \
  -F 'contract_number={contract_number}' \
  -F 'contract_start_date={contract_start_date}' \
  -F 'attachment=@{attachment}'
Ответ
200 Параметры ссылки для открытия заказа
Модель
{...}

Параметры ссылки для открытия заказа в АТИ-Доках.

id: string

Id документа.

url: string

Url документа.

is_signed: boolean

Подписан ли документ.

}
Пример
{...}
"id":"2fb965f2-85e9-4213-90e7-f396e47219e7",
"url":"https://docs.ati.su/example",
"is_signed":true
}
4XX Ошибка запроса. [Подробнее про ошибки API](https://ati.su/developers/documentation/errors/)
Модель
ONE-OF

(nullable)

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

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

  1. Без использования АТИ-Доков. Как только вы оформите Заказ, он будет переведен в исполнение.
Создание заказа без документов. Позволяет создать заказ без оформления документов через АТИ-Доки сразу после того, как перевозчик пришлет вам предложение на перевозку.
post /v1.2/orders/{dealId}/move_to_work
Параметры
Параметр Тип Расположение Описание
dealId обязательный string (guid) path
ID заказа Пример: 2fb965f2-85e9-4213-90e7-f396e47219e7
Запрос
Модель
ONE-OF

(nullable)

Пример запроса 
curl 'https://api.ati.su/v1.2/orders/{dealId}/move_to_work' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{"in_work_status_model":0}'
Ответ
200 Успешное создание заказа
Успешный ответ
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 Заказов.