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

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

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

 
Получение статусов Заказов
post
/v1.2/orders/get_orders_statuses
Развернуть все Свернуть все
[guid]
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Возвращает объект Id груза - список статусов связанных Заказов
Развернуть все Свернуть все
Пример Модель
{...}
"any-key":[...]
{...}
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status":0,
"deal_kind":0,
"inwork_status":0,
"tracker_offer_status":0,
"status_change_date_time":"1970-01-01T00:00:00.000Z"
}
]
}
{...}
}
Загрузка...
Развернуть все Свернуть все
Загрузка...

Когда груз будет забронирован/взят перевозчиком, вы сможете запросить подробную информацию по Заказу:

 
Получение информации по Заказу
get
/v1.2/orders/{dealId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Возвращает информацию по Заказу
Развернуть все Свернуть все
Пример Модель
{...}
"load_copy":{...},
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_number":"string",
"load_meta":{...},
"load_meta_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"meta_data":"string"
},
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"updated_at":"1970-01-01T00:00:00.000Z",
"added_at":"1970-01-01T00:00:00.000Z",
"archive_date":"1970-01-01T00:00:00.000Z",
"distance":0,
"distance_type":0,
"platon_roads_length":0,
"toll_roads_length":0,
"travel_time":"?",
"true_price":0,
"true_currency_id":0,
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_unpublished":false,
"firm_id":0,
"contact_id1":0,
"contact_id2":0,
"note":"string",
"first_date":"1970-01-01T00:00:00.000Z",
"last_date":"1970-01-01T00:00:00.000Z",
"date_type":0,
"periodicity_id":0,
"order_number":"string",
"krugoreis":false,
"zimnik":false,
"ferries":false,
"loading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"extra_points":[...],
{...}
"route_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"point_type":0,
"ordinal_id":0,
"distance":0,
"street":"string",
"latitude":0.5,
"longitude":0.5,
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"loading_date_start":"1970-01-01T00:00:00.000Z",
"loading_date_end":"1970-01-01T00:00:00.000Z",
"loading_time_start":null,
"loading_time_end":null,
"is_round_the_clock":false,
"city_name":"string",
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"unloading_cargos":[...],
{...}
"cargo_id":0,
"weight":0.5,
"volume":0.5,
"packaging_quantity":0,
"is_defined_by_ttn":false
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
}
],
"unloading":{...},
"fias_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"city_id":0,
"latitude":0.5,
"longitude":0.5,
"street":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"time_start":"1970-01-01T00:00:00.000Z",
"time_end":"1970-01-01T00:00:00.000Z",
"is_round_the_clock":false,
"large_cities":[...],
0
],
"large_cities_with_distance":[...],
{...}
"city_id":0,
"distance":0.5
}
],
"loading_cargos":[...],
{...}
"cargo_id":0,
"name_id":0,
"name":"string",
"packaging_type":0,
"packaging_quantity":0,
"weight":0.5,
"volume":0.5,
"sizes":{...},
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
},
"packaging_type_name":"string"
}
],
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"firm_id":0,
"name":"string",
"ownership":0,
"residency":0,
"inn":"string",
"phone":"string",
"extra_phone":0,
"docs_address":{...},
"postcode":"string",
"city_id":0,
"street_name":"string",
"house_no":"string",
"office_no":"string"
},
"stocks":[...],
{...}
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"address_latitude":0.5,
"address_longitude":0.5,
"note":"string",
"work_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"breaks_schedules":[...],
{...}
"stock_schedule_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"day_of_week":0,
"start_time":"?",
"end_time":"?"
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_binding":{...}
"warehouse_id":0,
"status":0
}
}
],
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"ownership_name":"string"
}
},
"cargo":{...},
"weight":0.5,
"volume":0.5,
"adr":0,
"cargo_type_id":0,
"cargo_type":"string",
"pack_type":0,
"pallet_count":0,
"belt_count":0,
"dogruz_type":0,
"sbor_gruz":false,
"size":{...}
"length":0.5,
"width":0.5,
"height":0.5,
"diameter":0.5,
"length_highlight":false,
"width_highlight":false,
"height_highlight":false
}
},
"transport":{...},
"car_type":0,
"car_type_string":"string",
"loading_type":0,
"loading_logical_operator":"string",
"unloading_type":0,
"unloading_logical_operator":"string",
"trucks_quantity":0,
"temperature_from":0,
"temperature_to":0,
"stsepka":false,
"pnevmohod":false,
"koniki":false,
"tir":false,
"cmr":false,
"t1":false,
"san_passport":false,
"is_tracking":false,
"required_capacity":0.5
},
"boards":[...],
{...}
"board_id":"string",
"name":"string",
"color":"string"
}
],
"unload_first_date":"1970-01-01T00:00:00.000Z",
"unload_last_date":"1970-01-01T00:00:00.000Z"
},
"deal":{...}
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_copy_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"load_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"taker_ati_id":"string",
"taker_persistent_user_id":0,
"taker_contact_id":0,
"cargo_owner_ati_id":"string",
"cargo_owner_persistent_user_id":0,
"updated_at":"1970-01-01T00:00:00.000Z",
"end_of_reservation":"1970-01-01T00:00:00.000Z",
"auction_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status":0,
"counterparty_status":0,
"payment":{...},
"rates":[...],
{...}
"rate":0.5,
"rate_type":0,
"currency":0,
"active":false
}
],
"prepay_percent":0,
"prepay_percent_enabled":false,
"on_unloading":false,
"in_fuel":false,
"pay_days_enabled":false,
"pay_days":0,
"fixed_rate":false,
"torg":false,
"direct_contract":false,
"money_type":0
},
"pay_docs":{...},
"documents_copies":{...},
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
},
"documents_original":{...},
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
},
"documents_original_track":{...},
"transport_company_id":0,
"tracking_url":"string",
"tracking_number":"string",
"sending_date":"1970-01-01T00:00:00.000Z"
},
"payment":{...}
"checked":false,
"date":"1970-01-01T00:00:00.000Z"
}
},
"files":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"storage_file_id":"string",
"access":0,
"add_date":"1970-01-01T00:00:00.000Z",
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"is_counterparty_file":false,
"file_name":"string",
"size":0,
"link":"string",
"source_type":0,
"source_file_type":0,
"file_type":0,
"timeslots_warehouse_ids":[...]
0
]
}
],
"document_templates":[...],
{...}
"organization_address":"string",
"templates":[...]
{...}
"add_date":"1970-01-01T00:00:00.000Z",
"access":0,
"timeslots_warehouse_ids":[...],
0
],
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"deal_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_firm_id":0,
"cargoes_ids_hash":0,
"contact_id":0,
"file_name":"string",
"file_id":"string",
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"size":0,
"link":"string"
}
]
}
],
"is_tracking":false,
"should_show_rate_to_driver":false,
"started_at":"1970-01-01T00:00:00.000Z",
"finished_at":"1970-01-01T00:00:00.000Z",
"denial_reason":"string",
"taker_requisites":{...},
"requisite_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"requisite_firm_name":"string",
"signer_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"own_ship_id":0,
"inn":"string",
"kpp":"string",
"requisite_type_id":0
},
"driver":{...},
"driver_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"first_name":"string",
"second_name":"string",
"patronymic":"string",
"phone_number":"string",
"driver_license_number":"string",
"passport_series":"string",
"passport_number":"string",
"passport_issued_by":"string",
"passport_when_issued":"1970-01-01T00:00:00.000Z",
"registration":"string",
"is_attracted_driver":false,
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"description":"string",
"attracted_from":"string",
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0,
"date_of_birth":"1970-01-01T00:00:00.000Z",
"department_code_in_passport":"string",
"driver_inn":"string",
"in_cargo_owner_black_list":false,
"black_list_reasons":[...]
"string"
]
},
"truck":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"trailer":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"semi_trailer":{...},
"truck_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"last_deal_related_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type":0,
"description":"string",
"brand_id":0,
"model":"string",
"number":"string",
"phone_number":"string",
"is_attracted_truck":false,
"ownership_type":0,
"car_type_id":0,
"capacity":0.5,
"volume":0.5,
"length":0.5,
"width":0.5,
"height":0.5,
"manufacture_year":0,
"vin":"string",
"vrc":"string",
"body_number":"string",
"dimension":0,
"truck_passport_number":"string",
"can_refrigerator":false,
"has_gen_set":false,
"truck_owner_name":"string",
"can_carry_heavy_container":false,
"can_carry_tall_container":false,
"verified":false,
"modification_restricted":false,
"scans":[...],
{...}
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"owner_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"path":"string",
"name":"string",
"type":0
}
],
"origin":0
},
"document":{...},
"id":"string",
"old_id":"string",
"editor":"string",
"url":"string",
"old_url":"string",
"name":"string",
"is_signed":false,
"access":0
},
"additional_documents":[...],
{...}
"id":"string",
"is_counterparty_file":false,
"url":"string",
"name":"string",
"is_signed":false,
"document_type":0,
"access":0
}
],
"in_work_status_model":0,
"in_work":{...},
"deal_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"in_work_status":0,
"in_work_date":"1970-01-01T00:00:00.000Z",
"ati_id":"string",
"contact_id":0,
"tracker_phone":0.5
},
"deal_note":"string",
"deal_kind":0,
"points":[...]
{...}
"deal_point_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ordinal_id":0,
"point_type":0,
"city_id":0,
"lat":0.5,
"lon":0.5,
"address":"string",
"participant_name":"string",
"region_id":0,
"contact_name":"string",
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stock":{...},
"stock_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"address":"string",
"address_city_id":0,
"note":"string",
"contact_persons":[...],
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
],
"schedule_summary":"string",
"stock_type":0,
"timeslots_warehouse_id":0
},
"organization":{...}
"organization_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"extra_phone":0,
"contact_persons":[...]
{...}
"contact_person_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name":"string",
"phone":"string",
"email":"string"
}
]
}
}
]
}
}
{...}
}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

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

  1. получить информацию о фирме - название фирмы, профиль деятельности, количество звезд, рекомендаций, претензий и т.д.:
 
Получение краткой информации по фирме (по идентификатору)
get
/v1.0/firms/summary/{atiId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Success
Развернуть все Свернуть все
Пример Модель
{...}
"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
}
{...}
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

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

}
400 Bad Request
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
401 Unauthorized
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
402 Client Error
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
403 Forbidden
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
404 Not Found
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
500 Server Error
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
504 Server Error
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
Загрузка...
Развернуть все Свернуть все
Загрузка...
  1. получить реквизиты фирмы:
 
Метод получения реквизитов фирмы
get
/v1.0/firms/{atiId}/requisites
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Success
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"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"
}
]
}
}
]
[{...}]
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
}]
400 Bad Request
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
401 Unauthorized
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
402 Client Error
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
403 Forbidden
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
404 Not Found
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
500 Server Error
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
504 Server Error
Развернуть все Свернуть все
Пример Модель
{...}
"error":"string",
"reason":"string"
}
{...}
error: string (nullable)
reason: string (nullable)
}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

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

 
Отклонение Заказа без документов
delete
/v1.2/orders/{dealId}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Успешное отклонение
Развернуть все Свернуть все
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

  1. С использованием сервиса “АТИ-Доки”. Документооборот будет вестись через ATI.SU. При этом Заказ на сайте ATI.SU будет переведен в исполнение только после того, как документ на перевозку будет одобрен второй стороной — перевозчиком. При необходимости документ может быть подписан с помощью электронной цифровой подписи.
 
Создание Заказа с документом через АТИ-Доки
post
/v1.2/orders/{dealId}/accept
Развернуть все Свернуть все
{...}

Данные грузовладельца для Заказа

template_id: string (nullable)

Id шаблона документа а АТИ Доках

document_type: string (nullable)

Тип документа ("заказ", "заказ (табличный вид)", "заявка (к договору)", "поручение экспедитору", "Заявка к договору (табличный вид)")

requisite_id: guid

Id реквизитов

signer_id: guid

Id подписанта

contract_number: string (nullable)

Номер договора произвольного формата не длинее 50 символов. Обязателен, если тип документа -- заявка или поручение экспедитору.

contract_start_date: date-time (nullable)

Дата начала договора. Обязателен, если тип документа -- заявка или поручение экспедитору.

}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Параметры ссылки для открытия Заказа в АТИ-Доках
Развернуть все Свернуть все
Пример Модель
{...}
"id":"string",
"url":"string",
"is_signed":false
}
{...}

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

id: string

Id документа

url: string

Url документа

is_signed: boolean

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

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...
 
Создание Заказа с документом через загрузку файла
post
/v1.2/orders/{dealId}/accept_file
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Параметры ссылки для открытия Заказа
Развернуть все Свернуть все
Пример Модель
{...}
"id":"string",
"url":"string",
"is_signed":false
}
{...}

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

id: string

Id документа

url: string

Url документа

is_signed: boolean

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

}
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

  1. Без использования АТИ-Доков. Как только вы оформите Заказ, он будет переведен в исполнение.
 
Создание Заказа без документов
post
/v1.2/orders/{dealId}/move_to_work
Развернуть все Свернуть все
{...}
in_work_status_model: enum
[0, 1, 2, 3]

Статусная модель перевозки

  • 0 — Простая перевозка
  • 1 — Первая миля
  • 2 — Последняя миля
  • 3 — Порожний контейнер
}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Успешное создание Заказа
Развернуть все Свернуть все
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

 
Смена cтатуса перевозки Заказа
post
/v1.2/orders/{dealId}/inwork
Развернуть все Свернуть все
{...}
in_work_status: enum
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20]

Статус перевозки

  • 0 — Нет статуса
  • 1 — Едет на загрузку
  • 2 — Ожидает загрузку
  • 3 — Загружается
  • 4 — Загрузился, едет на выгрузку
  • 5 — Ожидает выгрузку
  • 6 — Выгружается
  • 7 — Выгрузился
  • 8 — Поломка
  • 9 — ДТП
  • 10 — Арест ТС
  • 11 — Контейнер получен на погрузку
  • 12 — Контейнер на погрузке
  • 13 — Погрузка контейнера окончена
  • 14 — Контейнер сдан с погрузки
  • 15 — Контейнер получен на выгрузку
  • 16 — Контейнер на выгрузке
  • 17 — Выгрузка контейнера окончена
  • 18 — Контейнер сдан с выгрузки
  • 19 — Пустой контейнер получен
  • 20 — Пустой контейнер сдан
}
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Успешное изменение статуса
Развернуть все Свернуть все
Пример Модель
boolean
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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

 
Завершение перевозки
put
/v1.2/orders/{dealId}/finish
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Успешное завершение
Развернуть все Свернуть все
4XX Ошибка запроса. Подробнее про ошибки API
Развернуть все Свернуть все
Пример Модель
{...}
"reason":"string",
"error":"string"
}
{...}

Модель ошибки

reason: string

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

error: string

Ключ ошибки

}
Загрузка...
Развернуть все Свернуть все
Загрузка...

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